Swift 6 updates (#3)

- Swift 6.1 rework
- Brand new database driver implementation

Author: tib

.github/workflows/deployment.yml

@@ -0,0 +1,16 @@
+name: Deployment
+
+on:
+  push:
+    tags:
+      - 'v*'
+      - '[0-9]*'
+
+jobs:
+
+  create-docc-and-deploy:
+    uses: BinaryBirds/github-workflows/.github/workflows/docc_deploy.yml@main
+    permissions:
+      contents: read
+      pages: write
+      id-token: write

.github/workflows/testing.yml

@@ -0,0 +1,57 @@
+name: Testing
+
+on:
+  pull_request:
+    branches:
+    - main
+
+jobs:
+
+  swiftlang_checks:
+    name: Swiftlang Checks
+    uses: swiftlang/github-workflows/.github/workflows/soundness.yml@main
+    with:
+      license_header_check_project_name: "project"
+      format_check_enabled : true
+      broken_symlink_check_enabled : true
+      unacceptable_language_check_enabled : true
+      shell_check_enabled : true
+      docs_check_enabled : false
+      api_breakage_check_enabled : false
+      license_header_check_enabled : false
+      yamllint_check_enabled : false
+      python_lint_check_enabled : false
+
+  bb_checks:
+    name: BB Checks
+    uses: BinaryBirds/github-workflows/.github/workflows/extra_soundness.yml@main
+    with:
+      local_swift_dependencies_check_enabled : true
+      headers_check_enabled : true
+      docc_warnings_check_enabled : true
+
+  swiftlang_tests:
+    name: Swiftlang Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Generate certificates
+        run: make test-certs
+      - name: Start Postgres Docker Container
+        run: docker compose up -d --build
+      - name: Wait For Postgres Docker Container
+        run: |
+          for i in {1..30}; do
+            if docker compose exec -T postgres pg_isready -U postgres -d postgres; then
+              exit 0
+            fi
+            sleep 1
+          done
+          docker compose logs postgres
+          exit 1
+      - name: Run Tests
+        run: swift test --parallel
+      - name: Stop Postgres Docker Container
+        if: always()
+        run: docker compose down -v

.gitignore

@@ -5,4 +5,5 @@ Packages
 xcuserdata
 DerivedData
 .swiftpm
-*.xctestplan
+*.xctestplan
+docker/postgres/certificates

.swift-format

@@ -1,58 +1,64 @@
 {
-  "fileScopedDeclarationPrivacy" : {
-    "accessLevel" : "private"
+  "version": 1,
+  "lineLength": 80,
+  "maximumBlankLines": 1,
+  "fileScopedDeclarationPrivacy": {
+    "accessLevel": "private"
   },
-  "indentation" : {
-    "spaces" : 4
+  "tabWidth": 4,
+  "indentation": {
+    "spaces": 4
   },
-  "indentConditionalCompilationBlocks" : false,
-  "indentSwitchCaseLabels" : false,
-  "lineBreakAroundMultilineExpressionChainComponents" : true,
-  "lineBreakBeforeControlFlowKeywords" : true,
-  "lineBreakBeforeEachArgument" : true,
-  "lineBreakBeforeEachGenericRequirement" : true,
-  "lineLength" : 80,
-  "maximumBlankLines" : 1,
-  "prioritizeKeepingFunctionOutputTogether" : false,
-  "respectsExistingLineBreaks" : true,
-  "rules" : {
-    "AllPublicDeclarationsHaveDocumentation" : true,
-    "AlwaysUseLowerCamelCase" : false,
-    "AmbiguousTrailingClosureOverload" : true,
-    "BeginDocumentationCommentWithOneLineSummary" : false,
-    "DoNotUseSemicolons" : true,
-    "DontRepeatTypeInStaticProperties" : false,
-    "FileScopedDeclarationPrivacy" : true,
-    "FullyIndirectEnum" : true,
-    "GroupNumericLiterals" : true,
-    "IdentifiersMustBeASCII" : true,
-    "NeverForceUnwrap" : false,
-    "NeverUseForceTry" : false,
-    "NeverUseImplicitlyUnwrappedOptionals" : false,
-    "NoAccessLevelOnExtensionDeclaration" : false,
-    "NoAssignmentInExpressions" : true,
-    "NoBlockComments" : true,
-    "NoCasesWithOnlyFallthrough" : true,
-    "NoEmptyTrailingClosureParentheses" : true,
-    "NoLabelsInCasePatterns" : false,
-    "NoLeadingUnderscores" : false,
-    "NoParensAroundConditions" : true,
-    "NoVoidReturnOnFunctionSignature" : true,
-    "OneCasePerLine" : true,
-    "OneVariableDeclarationPerLine" : true,
-    "OnlyOneTrailingClosureArgument" : true,
-    "OrderedImports" : false,
-    "ReturnVoidInsteadOfEmptyTuple" : true,
-    "UseEarlyExits" : false,
-    "UseLetInEveryBoundCaseVariable" : false,
-    "UseShorthandTypeNames" : true,
-    "UseSingleLinePropertyGetter" : false,
-    "UseSynthesizedInitializer" : true,
-    "UseTripleSlashForDocumentationComments" : true,
-    "UseWhereClausesInForLoops" : false,
-    "ValidateDocumentationComments" : true
-  },
-  "spacesAroundRangeFormationOperators" : false,
-  "tabWidth" : 4,
-  "version" : 1
+  "indentConditionalCompilationBlocks": false,
+  "indentSwitchCaseLabels": false,
+  "lineBreakAroundMultilineExpressionChainComponents": true,
+  "lineBreakBeforeControlFlowKeywords": true,
+  "lineBreakBeforeEachArgument": true,
+  "lineBreakBeforeEachGenericRequirement": true,
+  "prioritizeKeepingFunctionOutputTogether": false,
+  "respectsExistingLineBreaks": true,
+  "spacesAroundRangeFormationOperators": false,
+  "multiElementCollectionTrailingCommas": true,
+  "rules": {
+    "AllPublicDeclarationsHaveDocumentation": false,
+    "AlwaysUseLiteralForEmptyCollectionInit": true,
+    "AlwaysUseLowerCamelCase": false,
+    "AmbiguousTrailingClosureOverload": true,
+    "BeginDocumentationCommentWithOneLineSummary": true,
+    "DoNotUseSemicolons": true,
+    "DontRepeatTypeInStaticProperties": true,
+    "FileScopedDeclarationPrivacy": true,
+    "FullyIndirectEnum": true,
+    "GroupNumericLiterals": true,
+    "IdentifiersMustBeASCII": true,
+    "NeverForceUnwrap": false,
+    "NeverUseForceTry": true,
+    "NeverUseImplicitlyUnwrappedOptionals": true,
+    "NoAccessLevelOnExtensionDeclaration": true,
+    "NoAssignmentInExpressions": true,
+    "NoBlockComments": true,
+    "NoCasesWithOnlyFallthrough": true,
+    "NoEmptyTrailingClosureParentheses": true,
+    "NoLabelsInCasePatterns": true,
+    "NoLeadingUnderscores": true,
+    "NoParensAroundConditions": true,
+    "NoPlaygroundLiterals": true,
+    "NoVoidReturnOnFunctionSignature": true,
+    "OmitExplicitReturns": true,
+    "OneCasePerLine": true,
+    "OneVariableDeclarationPerLine": true,
+    "OnlyOneTrailingClosureArgument": true,
+    "OrderedImports": true,
+    "ReplaceForEachWithForLoop": true,
+    "ReturnVoidInsteadOfEmptyTuple": true,
+    "TypeNamesShouldBeCapitalized": true,
+    "UseEarlyExits": true,
+    "UseLetInEveryBoundCaseVariable": true,
+    "UseShorthandTypeNames": true,
+    "UseSingleLinePropertyGetter": true,
+    "UseSynthesizedInitializer": true,
+    "UseTripleSlashForDocumentationComments": true,
+    "UseWhereClausesInForLoops": true,
+    "ValidateDocumentationComments": true
+  }
 }

.swiftformatignore

@@ -0,0 +1 @@
+Package.swift

.swiftheaderignore

@@ -0,0 +1,13 @@
+.github/**
+docker/**
+AGENTS.md
+.gitignore
+.swift-format
+.swiftformatignore
+.swiftheaderignore
+LICENSE
+Makefile
+Package.swift
+Package.resolved
+README.md
+docker-compose.yaml

AGENTS.md

@@ -0,0 +1,80 @@
+# Repository Guidelines
+
+This repository contains an project written with Swift 6. Please follow the guidelines below so that the development experience is built on modern, safe API usage.
+
+
+## Role
+
+You are a **Senior Swift Engineer**, specializing in server-side Swift development, and related frameworks (Vapor, Hummingbird). 
+
+
+## Core instructions
+
+- Swift 6.2 or later, using modern Swift concurrency.
+- Do not introduce third-party frameworks without asking first.
+- Avoid Foundation unless requested.
+- Build system: Swift Package Manager.
+- Testing framework: Swift Testing (`swift test`).
+
+
+## Swift instructions
+
+- Assume strict Swift concurrency rules are being applied.
+- Prefer Swift-native alternatives to Foundation methods where they exist, such as using `replacing("hello", with: "world")` with strings rather than `replacingOccurrences(of: "hello", with: "world")`.
+- Prefer modern Foundation API, if Foundation can not be avoided, for example `URL.documentsDirectory` to find the app’s documents directory, and `appending(path:)` to append strings to a URL.
+- Never use C-style number formatting such as `Text(String(format: "%.2f", abs(myNumber)))`; always use `Text(abs(change), format: .number.precision(.fractionLength(2)))` instead.
+- Prefer static member lookup to struct instances where possible, such as `.circle` rather than `Circle()`, and `.borderedProminent` rather than `BorderedProminentButtonStyle()`.
+- Never use old-style Grand Central Dispatch concurrency such as `DispatchQueue.main.async()`. If behavior like this is needed, always use modern Swift concurrency.
+- Avoid force unwraps and force `try` unless it is unrecoverable.
+- Never use `Task.sleep(nanoseconds:)`; always use `Task.sleep(for:)` instead.
+
+
+## Project structure
+
+- Use a consistent project structure.
+- Follow strict naming conventions for types, properties, methods, and data models.
+- Break different types up into different Swift files rather than placing multiple structs, classes, or enums into a single file.
+- Write unit tests for core application logic.
+- Add code comments and documentation comments as needed.
+- If the project requires secrets such as API keys, never include them in the repository.
+
+
+## Build, Test, and Development Commands
+
+- Preferred workflow: after any code change run `swift build` to rebuild the project, and run `swift test` when you actually need tests.
+
+
+## PR instructions
+
+- If installed, make sure the `make format` & `make check` commands returns no warnings or errors before committing.
+
+
+## Coding Style & Naming Conventions
+
+- Enforce formatting with the `make format` command.
+- Swift 6.2, prefer strict typing and small files (<500 LOC as a guardrail)
+- Naming: types UpperCamelCase; methods/properties lowerCamelCase; tests mirror subject names; avoid abbreviations except common GitHub/API terms.
+
+
+## Testing Guidelines
+
+- Framework: Swift Testing via `swift test`. Name suites `<Thing>Tests` and functions `behavior()`.
+- Cover new logic. Use deterministic fixtures/mocks for data.
+- Run `swift test` before pushing; prefer adding tests alongside bug fixes.
+
+
+## Commit & Pull Request Guidelines
+
+- Commit messages follow the existing short, imperative style; optional scoped prefixes. Keep them concise; present tense; no trailing period.
+- PRs: include a brief summary, linked issue ticket if any.
+
+
+## Security & Configuration Tips
+
+- Keep GitHub App secrets/private key out of the repo;
+- Do not log tokens or traffic stats responses; prefer redacted diagnostics.
+
+
+## Agent-Specific Notes
+
+- Reminder: ignore files you do not recognize   (just list them); multiple agents often work here.

LICENSE

@@ -1,7 +1,7 @@
 MIT License
 
 Copyright (c) 2018-2022 Tibor Bödecs
-Copyright (c) 2022-2024 Binary Birds Ltd.
+Copyright (c) 2022-2026 Binary Birds Kft.
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

Makefile

@@ -1,17 +1,44 @@
-build:
-	swift build
+SHELL=/bin/bash
 
-release:
-	swift build -c release
-	
-test:
-	swift test --parallel
+baseUrl = https://raw.githubusercontent.com/BinaryBirds/github-workflows/refs/heads/main/scripts
+
+check: symlinks language deps lint headers
+
+symlinks:
+	curl -s $(baseUrl)/check-broken-symlinks.sh | bash
 
-test-with-coverage:
-	swift test --parallel --enable-code-coverage
+language:
+	curl -s $(baseUrl)/check-unacceptable-language.sh | bash
 
-clean:
-	rm -rf .build
+deps:
+	curl -s $(baseUrl)/check-local-swift-dependencies.sh | bash
+
+lint:
+	curl -s $(baseUrl)/run-swift-format.sh | bash
 
 format:
-	swift-format -i -r ./Sources && swift-format -i -r ./Tests
+	curl -s $(baseUrl)/run-swift-format.sh | bash -s -- --fix
+
+docc-local:
+	curl -s $(baseUrl)/generate-docc.sh | bash -s -- --local
+
+run-docc:
+	curl -s $(baseUrl)/run-docc-docker.sh | bash
+
+docc-warnings:
+	curl -s $(baseUrl)/check-docc-warnings.sh | bash
+
+headers:
+	curl -s $(baseUrl)/check-swift-headers.sh | bash
+
+fix-headers:
+	curl -s $(baseUrl)/check-swift-headers.sh | bash -s -- --fix
+
+test-certs:
+	rm -rf docker/postgres/certificates && mkdir -p docker/postgres/certificates && cd docker/postgres/certificates && ../scripts/generate-certificates.sh
+
+test:
+	swift test --parallel
+
+docker-test:
+	docker build -t feather-postgres-database-tests . -f ./docker/tests/Dockerfile && docker run --rm feather-postgres-database-tests