@unisim/sdk 0.123.4 → 0.124.0

package/ios/Sources/UnisimSuiteAuthPlugin/UnisimSuiteAuthPlugin.swift

@@ -1,6 +1,7 @@
 import Foundation
 import Capacitor
 import Security
+import UIKit
 
 /// Stores the Universal Suite session in the iOS Keychain, in a group shared by
 /// every suite app signed by the same team — so signing in on Universal Images
@@ -37,7 +38,9 @@ public class UnisimSuiteAuthPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "get", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "set", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "remove", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "status", returnType: CAPPluginReturnPromise)
+        CAPPluginMethod(name: "status", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "installedApps", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "openApp", returnType: CAPPluginReturnPromise)
     ]
 
     /// One service for the whole suite. The `key` the JS side passes (Supabase's
@@ -238,4 +241,63 @@ public class UnisimSuiteAuthPlugin: CAPPlugin, CAPBridgedPlugin {
             call.reject(Self.describe("delete", status), String(status))
         }
     }
+
+    // ──────────────────────────────────────────────────────────────────────
+    // Opening a sibling suite app
+    //
+    // Not auth, and it knows it. These live on the auth plugin because
+    // Capacitor resolves plugins through a `capacitor.plugins.json` that is
+    // generated by `npx cap sync` and committed in each app: a NEW plugin class
+    // would be missing from every app until each one re-synced, and missing
+    // presents as nothing at all — the switcher would just go on opening the
+    // website in the apps that had not caught up. This class is already in all
+    // thirteen files. See `src/suiteApps.ts`, which holds the app registry.
+    // ──────────────────────────────────────────────────────────────────────
+
+    /// The suite apps installed alongside this one, by the JS side's product id.
+    ///
+    /// ⚠️ **`canOpenURL` answers `false` for any scheme this app has not
+    /// declared in `LSApplicationQueriesSchemes`**, and says so only in a
+    /// console line nobody reads on a device. An app missing an entry does not
+    /// look broken — it looks like the sibling is not installed, which is a
+    /// perfectly ordinary thing to be. So the plists are GENERATED from the
+    /// registry by `scripts/sync-native-app-links.mjs`; do not hand-edit them.
+    @objc func installedApps(_ call: CAPPluginCall) {
+        let apps = call.getArray("apps", JSObject.self) ?? []
+
+        // canOpenURL is a UIApplication call and must be made on the main
+        // thread; the plugin call arrives on a background queue.
+        DispatchQueue.main.async {
+            var installed: [String] = []
+            for app in apps {
+                guard let id = app["id"] as? String,
+                      let scheme = app["scheme"] as? String,
+                      let url = URL(string: "\(scheme)://") else { continue }
+                if UIApplication.shared.canOpenURL(url) {
+                    installed.append(id)
+                }
+            }
+            call.resolve(["installed": installed])
+        }
+    }
+
+    /// Bring one suite app to the front.
+    ///
+    /// Resolves `{ opened: false }` rather than rejecting when iOS declines —
+    /// the app was removed since the probe, or its scheme is undeclared here.
+    /// The JS side falls back to the https link on false, so a refusal costs
+    /// the user a web page rather than a dead tap, and an error would have to
+    /// be unpicked at the call site to reach the same place.
+    @objc func openApp(_ call: CAPPluginCall) {
+        guard let scheme = call.getString("scheme"), let url = URL(string: "\(scheme)://") else {
+            call.reject("scheme is required")
+            return
+        }
+
+        DispatchQueue.main.async {
+            UIApplication.shared.open(url, options: [:]) { opened in
+                call.resolve(["opened": opened])
+            }
+        }
+    }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unisim/sdk",
-  "version": "0.123.4",
-  "description": "Shared React SDK for the Universal Suite \u2014 auth, entitlements, usage telemetry, changelog, org admin.",
+  "version": "0.124.0",
+  "description": "Shared React SDK for the Universal Suite — auth, entitlements, usage telemetry, changelog, org admin.",
   "license": "MIT",
   "author": "Universal Simulation Ltd",
   "keywords": [
@@ -31,6 +31,9 @@
   "capacitor": {
     "ios": {
       "src": "ios"
+    },
+    "android": {
+      "src": "android"
     }
   },
   "exports": {
@@ -45,6 +48,7 @@
   "files": [
     "dist",
     "electron",
+    "android",
     "ios/Sources",
     "Package.swift",
     "UnisimSdk.podspec",
@@ -55,6 +59,8 @@
     "dev": "tsc -p tsconfig.build.json --watch",
     "typecheck": "tsc --noEmit",
     "test:session-storage": "npm run build && node tests/session-storage.browser.mjs",
+    "test:shared-signout": "node tests/shared-signout.mjs",
+    "test:suite-apps": "npm run build && node tests/suite-apps.mjs",
     "prepublishOnly": "npm run typecheck && npm run build"
   },
   "dependencies": {