capacitor-apple-intelligence 1.0.0

package/ios/Sources/AppleIntelligencePlugin/AppleIntelligencePlugin.swift

@@ -0,0 +1,231 @@
+import Foundation
+import Capacitor
+
+/// Capacitor plugin class for Apple Intelligence
+/// Bridges JavaScript calls to the native AppleIntelligence implementation
+@objc(AppleIntelligencePlugin)
+public class AppleIntelligencePlugin: CAPPlugin, CAPBridgedPlugin {
+    
+    // MARK: - Plugin Configuration
+    
+    public let identifier = "AppleIntelligencePlugin"
+    public let jsName = "AppleIntelligence"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "generate", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "generateText", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "generateTextWithLanguage", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "checkAvailability", returnType: CAPPluginReturnPromise)
+    ]
+    
+    // MARK: - Implementation
+    
+    private let implementation = AppleIntelligence()
+    
+    // MARK: - Plugin Methods
+    
+    /// Generate structured JSON output using Apple Intelligence
+    /// - Parameter call: The plugin call containing messages and response_format
+    @objc func generate(_ call: CAPPluginCall) {
+        // Validate input
+        guard let messagesArray = call.getArray("messages") as? [[String: String]] else {
+            call.resolve([
+                "success": false,
+                "error": [
+                    "code": "NATIVE_ERROR",
+                    "message": "Invalid or missing 'messages' array. Expected array of { role: string, content: string }."
+                ]
+            ])
+            return
+        }
+        
+        guard let responseFormat = call.getObject("response_format") else {
+            call.resolve([
+                "success": false,
+                "error": [
+                    "code": "NATIVE_ERROR",
+                    "message": "Missing 'response_format' object."
+                ]
+            ])
+            return
+        }
+        
+        guard let formatType = responseFormat["type"] as? String, formatType == "json_schema" else {
+            call.resolve([
+                "success": false,
+                "error": [
+                    "code": "NATIVE_ERROR",
+                    "message": "response_format.type must be 'json_schema'."
+                ]
+            ])
+            return
+        }
+        
+        guard let schema = responseFormat["schema"] as? [String: Any] else {
+            call.resolve([
+                "success": false,
+                "error": [
+                    "code": "NATIVE_ERROR",
+                    "message": "Missing or invalid 'schema' in response_format."
+                ]
+            ])
+            return
+        }
+        
+        // Check availability
+        let availability = implementation.checkAvailability()
+        if !availability.available {
+            call.resolve([
+                "success": false,
+                "error": availability.error?.asDictionary ?? [
+                    "code": "UNAVAILABLE",
+                    "message": "Apple Intelligence is not available on this device."
+                ]
+            ])
+            return
+        }
+        
+        // Execute generation asynchronously
+        if #available(iOS 26, *) {
+            Task {
+                let result = await implementation.generateForBridge(
+                    messages: messagesArray,
+                    schema: schema
+                )
+                
+                // Resolve on main thread
+                await MainActor.run {
+                    call.resolve(result)
+                }
+            }
+        } else {
+            call.resolve([
+                "success": false,
+                "error": [
+                    "code": "UNAVAILABLE",
+                    "message": "Apple Intelligence requires iOS 26 or later."
+                ]
+            ])
+        }
+    }
+
+    /// Generate plain text output using Apple Intelligence
+    @objc func generateText(_ call: CAPPluginCall) {
+        guard let messagesArray = call.getArray("messages") as? [[String: String]] else {
+            call.resolve([
+                "success": false,
+                "error": [
+                    "code": "NATIVE_ERROR",
+                    "message": "Invalid or missing 'messages' array."
+                ]
+            ])
+            return
+        }
+
+        // Check availability
+        let availability = implementation.checkAvailability()
+        if !availability.available {
+            call.resolve([
+                "success": false,
+                "error": availability.error?.asDictionary ?? [
+                    "code": "UNAVAILABLE",
+                    "message": "Apple Intelligence is not available on this device."
+                ]
+            ])
+            return
+        }
+
+        if #available(iOS 26, *) {
+            Task {
+                let result = await implementation.generateTextForBridge(messages: messagesArray)
+                await MainActor.run {
+                    call.resolve(result)
+                }
+            }
+        } else {
+            call.resolve([
+                "success": false,
+                "error": [
+                    "code": "UNAVAILABLE",
+                    "message": "Apple Intelligence requires iOS 26 or later."
+                ]
+            ])
+        }
+    }
+
+    /// Generate plain text output with specific language
+    @objc func generateTextWithLanguage(_ call: CAPPluginCall) {
+        guard let messagesArray = call.getArray("messages") as? [[String: String]] else {
+            call.resolve([
+                "success": false,
+                "error": [
+                    "code": "NATIVE_ERROR",
+                    "message": "Invalid or missing 'messages' array."
+                ]
+            ])
+            return
+        }
+
+        guard let language = call.getString("language") else {
+            call.resolve([
+                "success": false,
+                "error": [
+                    "code": "NATIVE_ERROR",
+                    "message": "Missing 'language' string."
+                ]
+            ])
+            return
+        }
+
+        // Check availability
+        let availability = implementation.checkAvailability()
+        if !availability.available {
+            call.resolve([
+                "success": false,
+                "error": availability.error?.asDictionary ?? [
+                    "code": "UNAVAILABLE",
+                    "message": "Apple Intelligence is not available on this device."
+                ]
+            ])
+            return
+        }
+
+        if #available(iOS 26, *) {
+            Task {
+                let result = await implementation.generateTextWithLanguageForBridge(
+                    messages: messagesArray,
+                    language: language
+                )
+                await MainActor.run {
+                    call.resolve(result)
+                }
+            }
+        } else {
+            call.resolve([
+                "success": false,
+                "error": [
+                    "code": "UNAVAILABLE",
+                    "message": "Apple Intelligence requires iOS 26 or later."
+                ]
+            ])
+        }
+    }
+
+    /// Check if Apple Intelligence is available on this device
+    @objc func checkAvailability(_ call: CAPPluginCall) {
+        let availability = implementation.checkAvailability()
+        
+        if availability.available {
+            call.resolve([
+                "available": true
+            ])
+        } else {
+            call.resolve([
+                "available": false,
+                "error": availability.error?.asDictionary ?? [
+                    "code": "UNAVAILABLE",
+                    "message": "Apple Intelligence is not available on this device."
+                ]
+            ])
+        }
+    }
+}

package/ios/Tests/AppleIntelligencePluginTests/AppleIntelligencePluginTests.swift

@@ -0,0 +1,49 @@
+import XCTest
+@testable import AppleIntelligencePlugin
+
+class AppleIntelligencePluginTests: XCTestCase {
+    
+    var implementation: AppleIntelligence!
+    
+    override func setUp() {
+        super.setUp()
+        implementation = AppleIntelligence()
+    }
+    
+    override func tearDown() {
+        implementation = nil
+        super.tearDown()
+    }
+    
+    // MARK: - Availability Tests
+    
+    func testAvailabilityCheck() {
+        let result = implementation.checkAvailability()
+        // On devices < iOS 26, this should return unavailable
+        // This test will pass on both platforms, just with different results
+        XCTAssertNotNil(result)
+    }
+    
+    // MARK: - JSON Schema Validation Tests
+    // These use reflection to test private validation methods
+    
+    func testSchemaValidation_ValidObject() {
+        // Test that the implementation can be instantiated
+        XCTAssertNotNil(implementation)
+    }
+    
+    func testSchemaValidation_MissingRequired() {
+        // Test placeholder - actual validation tested through generate method
+        XCTAssertNotNil(implementation)
+    }
+    
+    func testSchemaValidation_ArrayItems() {
+        // Test placeholder - actual validation tested through generate method
+        XCTAssertNotNil(implementation)
+    }
+    
+    func testSchemaValidation_TypeMismatch() {
+        // Test placeholder - actual validation tested through generate method
+        XCTAssertNotNil(implementation)
+    }
+}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "capacitor-apple-intelligence",
+  "version": "1.0.0",
+  "description": "Capacitor v8 plugin for Apple Intelligence with schema-constrained JSON generation for structured AI responses",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "dist/",
+    "ios/",
+    "Package.swift",
+    "*.podspec"
+  ],
+  "author": "Farabi Abdelwahed",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/farabiabdelwahe/capacitor-apple-intelligence.git"
+  },
+  "bugs": {
+    "url": "https://github.com/farabiabdelwahe/capacitor-apple-intelligence/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native",
+    "ios",
+    "apple",
+    "intelligence",
+    "ai",
+    "llm",
+    "json",
+    "schema"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:web",
+    "verify:ios": "cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -quiet && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\"",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api AppleIntelligencePlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/docgen": "^0.2.2",
+    "@capacitor/ios": "^8.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^1.1.2",
+    "eslint": "^8.57.0",
+    "prettier": "~3.3.3",
+    "prettier-plugin-java": "~2.6.4",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.22.4",
+    "@rollup/plugin-node-resolve": "^15.3.0",
+    "swiftlint": "^1.0.2",
+    "typescript": "~5.5.4"
+  },
+  "peerDependencies": {
+    "@capacitor/core": "^8.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    }
+  }
+}