Add Swift Package Manager integration

Author: Gioee

.gitignore

@@ -5,4 +5,5 @@
 *.plist
 /build
 /dist
-*.sqlite
+*.sqlite
+.build

Package.swift

@@ -0,0 +1,33 @@
+// swift-tools-version: 6.1
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "js",
+    platforms: [.macOS(.v11), .iOS(.v11)],
+    products: [
+        // Products can be used to vend plugins, making them visible to other packages.
+        .plugin(
+            name: "jsPlugin",
+            targets: ["jsPlugin"]),
+        .library(
+            name: "js",
+            targets: ["js"])
+    ],
+    targets: [
+        // Build tool plugin that invokes the Makefile
+        .plugin(
+            name: "jsPlugin",
+            capability: .buildTool(),
+            path: "packages/swift/plugin"
+        ),
+        // js library target
+        .target(
+            name: "js",
+            dependencies: [],
+            path: "packages/swift/extension",
+            plugins: ["jsPlugin"]
+        ),
+    ]
+)

README.md

@@ -30,6 +30,29 @@ Download the appropriate pre-built binary for your platform from the official [R
 - Android
 - iOS
 
+### Swift Package
+
+You can [add this repository as a package dependency to your Swift project](https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app#Add-a-package-dependency). After adding the package, you'll need to set up SQLite with extension loading by following steps 4 and 5 of [this guide](https://github.com/sqliteai/sqlite-extensions-guide/blob/main/platforms/ios.md#4-set-up-sqlite-with-extension-loading).
+
+Here's an example of how to use the package:
+```swift
+import js
+
+...
+
+var db: OpaquePointer?
+sqlite3_open(":memory:", &db)
+sqlite3_enable_load_extension(db, 1)
+var errMsg: UnsafeMutablePointer<Int8>? = nil
+sqlite3_load_extension(db, js.path, nil, &errMsg)
+var stmt: OpaquePointer?
+sqlite3_prepare_v2(db, "SELECT js_version()", -1, &stmt, nil)
+defer { sqlite3_finalize(stmt) }
+sqlite3_step(stmt)
+log("js_version(): \(String(cString: sqlite3_column_text(stmt, 0)))")
+sqlite3_close(db)
+```
+
 ### Loading the Extension
 
 ```sql

packages/swift/extension/js.swift

@@ -0,0 +1,19 @@
+// js.swift
+// This file serves as a placeholder for the js target.
+// The actual SQLite extension is built using the Makefile through the build plugin.
+
+import Foundation
+
+/// Placeholder structure for js
+public struct js {
+    /// Returns the path to the built js dylib inside the XCFramework
+    public static var path: String {
+        #if os(macOS)
+        return "js.xcframework/macos-arm64_x86_64/js.framework/js"
+        #elseif targetEnvironment(simulator)
+        return "js.xcframework/ios-arm64_x86_64-simulator/js.framework/js"
+        #else
+        return "js.xcframework/ios-arm64/js.framework/js"
+        #endif
+    }
+}

packages/swift/plugin/js.swift

@@ -0,0 +1,60 @@
+import PackagePlugin
+import Foundation
+
+@main
+struct js: BuildToolPlugin {
+    /// Entry point for creating build commands for targets in Swift packages.
+    func createBuildCommands(context: PluginContext, target: Target) async throws -> [Command] {
+        let packageDirectory = context.package.directoryURL
+        let outputDirectory = context.pluginWorkDirectoryURL
+        return createjsBuildCommands(packageDirectory: packageDirectory, outputDirectory: outputDirectory)
+    }
+}
+
+#if canImport(XcodeProjectPlugin)
+import XcodeProjectPlugin
+
+extension js: XcodeBuildToolPlugin {
+    // Entry point for creating build commands for targets in Xcode projects.
+    func createBuildCommands(context: XcodePluginContext, target: XcodeTarget) throws -> [Command] {
+        let outputDirectory = context.pluginWorkDirectoryURL
+        return createjsBuildCommands(packageDirectory: nil, outputDirectory: outputDirectory)
+    }
+}
+
+#endif
+
+/// Shared function to create js build commands
+func createjsBuildCommands(packageDirectory: URL?, outputDirectory: URL) -> [Command] {
+
+    // For Xcode projects, use current directory; for Swift packages, use provided packageDirectory
+    let workingDirectory = packageDirectory?.path ?? "$(pwd)"
+    let packageDirInfo = packageDirectory != nil ? "Package directory: \(packageDirectory!.path)" : "Working directory: $(pwd)"
+
+    return [
+        .prebuildCommand(
+            displayName: "Building js XCFramework",
+            executable: URL(fileURLWithPath: "/bin/bash"),
+            arguments: [
+                "-c",
+                """
+                set -e
+                echo "Starting js XCFramework prebuild..."
+                echo "\(packageDirInfo)"
+                
+                # Clean and create output directory
+                rm -rf "\(outputDirectory.path)"
+                mkdir -p "\(outputDirectory.path)"
+                
+                # Build directly from source directory with custom output paths
+                cd "\(workingDirectory)" && \
+                echo "Building XCFramework..." && \
+                make xcframework DIST_DIR="\(outputDirectory.path)" BUILD_DIR="\(outputDirectory.path)/build" && \
+                rm -rf "\(outputDirectory.path)/build" && \
+                echo "XCFramework build completed successfully!"
+                """
+            ],
+            outputFilesDirectory: outputDirectory
+        )
+    ]
+}