@doorstepai/dropoff-sdk-capacitor 1.0.0

package/ios/Plugin/DoorstepAIDropoffSDKPlugin.m

@@ -0,0 +1,22 @@
+#import <Foundation/Foundation.h>
+#import <Capacitor/Capacitor.h>
+
+// Defines the plugin and its methods to the Capacitor runtime.
+// Method names here MUST match the @objc func names in
+// DoorstepAIDropoffSDKPlugin.swift, which in turn must match the keys used
+// from JS via Capacitor.Plugins.DoorstepAIDropoffSDK.<method>.
+CAP_PLUGIN(DoorstepAIDropoffSDKPlugin, "DoorstepAIDropoffSDK",
+    CAP_PLUGIN_METHOD(init, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(setApiKey, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(startDeliveryByPlaceID, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(startDeliveryByPlusCode, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(startDeliveryByAddress, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(startDeliveryByAddressType, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(startDeliveryByAddressString, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(startDeliveryByLatLng, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(markDropoff, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(newEvent, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(stopDelivery, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(checkPermissions, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(requestPermissions, CAPPluginReturnPromise);
+)

package/ios/Plugin/DoorstepAIDropoffSDKPlugin.swift

@@ -0,0 +1,313 @@
+import Foundation
+import Capacitor
+import UIKit
+import SwiftUI
+import CoreLocation
+import CoreMotion
+import DoorstepDropoffSDK
+
+@objc(DoorstepAIDropoffSDKPlugin)
+public class DoorstepAIDropoffSDKPlugin: CAPPlugin, CLLocationManagerDelegate {
+    private var hostingController: UIHostingController<DoorstepAIRoot>?
+
+    private lazy var clManager: CLLocationManager = {
+        let m = CLLocationManager()
+        m.delegate = self
+        return m
+    }()
+    private var pendingLocationContinuation: CheckedContinuation<Void, Never>?
+
+    /// Mounts `DoorstepAIRoot` as a 0pt invisible subview of the webview's
+    /// view controller, mirroring the Flutter wrapper's zero-height `UiKitView`.
+    /// The SDK relies on SwiftUI lifecycle (onAppear / @StateObject) to start
+    /// its background machinery, so the host must be in the view hierarchy.
+    ///
+    /// Idempotent. Safe to call from any thread; hops to main internally.
+    /// Called lazily on `setApiKey` (matches the Flutter widget's order:
+    /// init → setApiKey → host mounts).
+    private func ensureHiddenRootViewMounted() {
+        if Thread.isMainThread {
+            mountHiddenRootViewOnMain()
+        } else {
+            DispatchQueue.main.async { [weak self] in
+                self?.mountHiddenRootViewOnMain()
+            }
+        }
+    }
+
+    private func mountHiddenRootViewOnMain() {
+        guard hostingController == nil, let viewController = self.bridge?.viewController else { return }
+        viewController.loadViewIfNeeded()
+        let host = UIHostingController(rootView: DoorstepAIRoot())
+        host.view.frame = .zero
+        host.view.isHidden = true
+        host.view.isUserInteractionEnabled = false
+        viewController.view.addSubview(host.view)
+        hostingController = host
+    }
+
+    @objc func `init`(_ call: CAPPluginCall) {
+        // iOS no-op: the Android foreground-service init has no iOS analogue.
+        call.resolve()
+    }
+
+    @objc func setApiKey(_ call: CAPPluginCall) {
+        guard let key = call.getString("key") else {
+            return call.reject("INVALID_ARGUMENTS: key missing")
+        }
+        DoorstepAI.setApiKey(key: key)
+        ensureHiddenRootViewMounted()
+        call.resolve()
+    }
+
+    @objc func startDeliveryByPlaceID(_ call: CAPPluginCall) {
+        guard let placeID = call.getString("placeID"),
+              let deliveryId = call.getString("deliveryId") else {
+            return call.reject("INVALID_ARGUMENTS: placeID or deliveryId missing")
+        }
+        let timeout = call.getDouble("timeoutSeconds")
+        Task {
+            do {
+                try await DoorstepAI.startDeliveryByPlaceID(placeID: placeID, deliveryId: deliveryId, timeoutSeconds: timeout)
+                call.resolve()
+            } catch {
+                call.reject("Failed to start delivery by Place ID: \(error.localizedDescription)", "E_START_DELIVERY")
+            }
+        }
+    }
+
+    @objc func startDeliveryByPlusCode(_ call: CAPPluginCall) {
+        guard let plusCode = call.getString("plusCode"),
+              let deliveryId = call.getString("deliveryId") else {
+            return call.reject("INVALID_ARGUMENTS: plusCode or deliveryId missing")
+        }
+        let timeout = call.getDouble("timeoutSeconds")
+        Task {
+            do {
+                try await DoorstepAI.startDeliveryByPlusCode(plusCode: plusCode, deliveryId: deliveryId, timeoutSeconds: timeout)
+                call.resolve()
+            } catch {
+                call.reject("Failed to start delivery by Plus Code: \(error.localizedDescription)", "E_START_DELIVERY")
+            }
+        }
+    }
+
+    @objc func startDeliveryByAddress(_ call: CAPPluginCall) {
+        startDeliveryByAddressTypeImpl(call)
+    }
+
+    @objc func startDeliveryByAddressType(_ call: CAPPluginCall) {
+        startDeliveryByAddressTypeImpl(call)
+    }
+
+    private func startDeliveryByAddressTypeImpl(_ call: CAPPluginCall) {
+        guard let addr = call.getObject("address") as? [String: String],
+              let deliveryId = call.getString("deliveryId"),
+              let street = addr["streetNumber"],
+              let route = addr["route"],
+              let locality = addr["locality"],
+              let admin1 = addr["administrativeAreaLevel1"],
+              let postal = addr["postalCode"] else {
+            return call.reject("Missing or invalid fields in address dictionary or deliveryId missing", "E_INVALID_ADDRESS")
+        }
+        let timeout = call.getDouble("timeoutSeconds")
+        let coordinates = parseCoordinates(call.getObject("coordinates"))
+        Task {
+            do {
+                let address = AddressType(
+                    streetNumber: street,
+                    route: route,
+                    subPremise: addr["subPremise"] ?? "",
+                    locality: locality,
+                    administrativeAreaLevel1: admin1,
+                    postalCode: postal
+                )
+                try await DoorstepAI.startDeliveryByAddressType(
+                    address: address,
+                    deliveryId: deliveryId,
+                    coordinates: coordinates,
+                    timeoutSeconds: timeout
+                )
+                call.resolve()
+            } catch let error as DoorstepAIError {
+                call.reject("Failed to start delivery by address: \(error.localizedDescription)", "E_START_DELIVERY")
+            } catch {
+                call.reject("An unexpected error occurred: \(error.localizedDescription)", "E_UNKNOWN")
+            }
+        }
+    }
+
+    @objc func startDeliveryByAddressString(_ call: CAPPluginCall) {
+        guard let address = call.getString("address"),
+              let deliveryId = call.getString("deliveryId") else {
+            return call.reject("INVALID_ARGUMENTS: address or deliveryId missing")
+        }
+        let timeout = call.getDouble("timeoutSeconds")
+        let coordinates = parseCoordinates(call.getObject("coordinates"))
+        Task {
+            do {
+                try await DoorstepAI.startDeliveryByAddressString(
+                    address: address,
+                    deliveryId: deliveryId,
+                    coordinates: coordinates,
+                    timeoutSeconds: timeout
+                )
+                call.resolve()
+            } catch {
+                call.reject("Failed to start delivery by address string: \(error.localizedDescription)", "E_START_DELIVERY")
+            }
+        }
+    }
+
+    @objc func startDeliveryByLatLng(_ call: CAPPluginCall) {
+        guard let latitude = call.getDouble("latitude"),
+              let longitude = call.getDouble("longitude"),
+              let deliveryId = call.getString("deliveryId") else {
+            return call.reject("INVALID_ARGUMENTS: latitude, longitude or deliveryId missing")
+        }
+        let subUnit = call.getString("subUnit") ?? ""
+        let timeout = call.getDouble("timeoutSeconds")
+        Task {
+            do {
+                try await DoorstepAI.startDeliveryByLatLng(latitude: latitude, longitude: longitude, subUnit: subUnit, deliveryId: deliveryId, timeoutSeconds: timeout)
+                call.resolve()
+            } catch {
+                call.reject("Failed to start delivery by LatLng: \(error.localizedDescription)", "E_START_DELIVERY")
+            }
+        }
+    }
+
+    @objc func markDropoff(_ call: CAPPluginCall) {
+        guard let deliveryId = call.getString("deliveryId"),
+              let dropoffTypeStr = call.getString("dropoffType") else {
+            return call.reject("INVALID_ARGUMENTS: deliveryId or dropoffType missing")
+        }
+        let dropoffType: DropoffType = dropoffTypeStr == "pod" ? .pod : .non_pod
+        Task {
+            do {
+                try await DoorstepAI.markDropoff(deliveryId: deliveryId, dropoffType: dropoffType)
+                call.resolve()
+            } catch {
+                call.reject("Failed to mark dropoff: \(error.localizedDescription)", "E_MARK_DROPOFF")
+            }
+        }
+    }
+
+    @objc func newEvent(_ call: CAPPluginCall) {
+        guard let eventName = call.getString("eventName"),
+              let deliveryId = call.getString("deliveryId") else {
+            return call.reject("INVALID_ARGUMENTS: eventName or deliveryId missing")
+        }
+        Task {
+            do {
+                try await DoorstepAI.newEvent(eventName: eventName, deliveryId: deliveryId)
+                call.resolve()
+            } catch {
+                call.reject("Failed to send event: \(error.localizedDescription)", "E_NEW_EVENT")
+            }
+        }
+    }
+
+    @objc func stopDelivery(_ call: CAPPluginCall) {
+        guard let deliveryId = call.getString("deliveryId") else {
+            return call.reject("INVALID_ARGUMENTS: deliveryId missing")
+        }
+        Task {
+            await DoorstepAI.stopDelivery(deliveryId: deliveryId)
+            call.resolve()
+        }
+    }
+
+    // MARK: - Permissions
+
+    private static let allPermissionAliases = ["location", "activity"]
+
+    @objc override public func checkPermissions(_ call: CAPPluginCall) {
+        Task {
+            let status = await currentPermissionStatus()
+            call.resolve(status)
+        }
+    }
+
+    @objc override public func requestPermissions(_ call: CAPPluginCall) {
+        let requested = call.getArray("permissions", String.self) ?? Self.allPermissionAliases
+        Task {
+            for alias in requested {
+                await requestPermission(alias)
+            }
+            let status = await currentPermissionStatus()
+            call.resolve(status)
+        }
+    }
+
+    private func currentPermissionStatus() async -> [String: String] {
+        let location: String
+        switch clManager.authorizationStatus {
+        case .notDetermined: location = "prompt"
+        case .restricted, .denied: location = "denied"
+        case .authorizedWhenInUse, .authorizedAlways: location = "granted"
+        @unknown default: location = "denied"
+        }
+
+        let activity: String
+        switch CMMotionActivityManager.authorizationStatus() {
+        case .notDetermined: activity = "prompt"
+        case .restricted, .denied: activity = "denied"
+        case .authorized: activity = "granted"
+        @unknown default: activity = "denied"
+        }
+
+        return [
+            "location": location,
+            "activity": activity,
+        ]
+    }
+
+    private func requestPermission(_ alias: String) async {
+        switch alias {
+        case "location":
+            await requestLocationAuthorization()
+        case "activity":
+            await requestActivityAuthorization()
+        default:
+            break
+        }
+    }
+
+    private func requestLocationAuthorization() async {
+        guard clManager.authorizationStatus == .notDetermined else { return }
+        await withCheckedContinuation { (cont: CheckedContinuation<Void, Never>) in
+            DispatchQueue.main.async { [weak self] in
+                guard let self = self else { cont.resume(); return }
+                self.pendingLocationContinuation = cont
+                self.clManager.requestWhenInUseAuthorization()
+            }
+        }
+    }
+
+    public func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
+        let cont = pendingLocationContinuation
+        pendingLocationContinuation = nil
+        cont?.resume()
+    }
+
+    private func requestActivityAuthorization() async {
+        // CMMotionActivityManager prompts the user the first time data is
+        // queried. We trigger that with a no-op query.
+        await withCheckedContinuation { (cont: CheckedContinuation<Void, Never>) in
+            let mgr = CMMotionActivityManager()
+            mgr.queryActivityStarting(from: Date(timeIntervalSinceNow: -60), to: Date(), to: .main) { _, _ in
+                cont.resume()
+            }
+        }
+    }
+
+    private func parseCoordinates(_ raw: [AnyHashable: Any]?) -> LatLngObject? {
+        guard let coordinates = raw,
+              let lat = coordinates["lat"] as? Double,
+              let lng = coordinates["lng"] as? Double else {
+            return nil
+        }
+        return LatLngObject(lat: lat, lng: lng)
+    }
+}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@doorstepai/dropoff-sdk-capacitor",
+  "version": "1.0.0",
+  "description": "Capacitor plugin for DoorstepAI's Dropoff SDK",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Plugin/",
+    "ios/DoorstepDropoffSDK.xcframework/",
+    "DoorstepaiDropoffSdkCapacitor.podspec"
+  ],
+  "author": "Doing Doorstep Better, Inc.",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@gitlab.com/doorstepai/tracking/sdk/capacitor.git"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native",
+    "doorstep",
+    "dropoff",
+    "delivery"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\"",
+    "docgen": "docgen --api DoorstepAIDropoffSDKPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.js",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^7.0.0",
+    "@capacitor/core": "^7.0.0",
+    "@capacitor/docgen": "^0.3.0",
+    "@capacitor/ios": "^7.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "eslint": "^8.57.0",
+    "prettier": "~3.3.3",
+    "prettier-plugin-java": "~2.6.4",
+    "rimraf": "^5.0.5",
+    "rollup": "^4.18.0",
+    "swiftlint": "^2.0.0",
+    "typescript": "~5.4.5"
+  },
+  "peerDependencies": {
+    "@capacitor/core": "^7.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  }
+}