@flighthq/host-capacitor 0.1.0

package/dist/capacitorShare.js

@@ -0,0 +1,66 @@
+// Maps Flight's ShareBackend onto Capacitor's `@capacitor/share`. `share`/`shareWithResult` are async
+// and map directly; a user cancel rejects, resolving false / a dismissed ShareResult rather than
+// throwing. Capacitor's `canShare` is async while the ShareBackend availability probes (isAvailable,
+// canShare) are synchronous, so the adapter prefetches the availability boolean once at construction and
+// the sync probes read it — reporting false until that first probe resolves. Portable ShareFile
+// descriptors carry data URLs, which Capacitor's file-URI `files` field cannot accept, so only
+// title/text/url cross; a content that is only files reports canShare false.
+export function createCapacitorShareBackend(capacitor) {
+    const share = capacitor.share;
+    // Sync availability probes over async Capacitor: prefetch canShare once and cache the boolean.
+    let cachedAvailable = false;
+    share
+        .canShare()
+        .then((result) => {
+        cachedAvailable = result.value;
+    })
+        .catch(() => {
+        /* leave false */
+    });
+    return {
+        isAvailable() {
+            return cachedAvailable;
+        },
+        canShare(content) {
+            return cachedAvailable && hasShareableText(content);
+        },
+        async share(content, options) {
+            if (!hasShareableText(content))
+                return false;
+            try {
+                await share.share({
+                    title: content.title,
+                    text: content.text,
+                    url: content.url,
+                    dialogTitle: options?.chooserTitle,
+                });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async shareWithResult(content, options) {
+            if (!hasShareableText(content))
+                return { completed: false, activityType: null, dismissed: false };
+            try {
+                const result = await share.share({
+                    title: content.title,
+                    text: content.text,
+                    url: content.url,
+                    dialogTitle: options?.chooserTitle,
+                });
+                return { completed: true, activityType: result.activityType ?? null, dismissed: false };
+            }
+            catch {
+                // A rejected share is a user dismissal, not a programmer error.
+                return { completed: false, activityType: null, dismissed: true };
+            }
+        },
+    };
+}
+// Capacitor's share sheet needs at least one of title/text/url; data-URL files are not expressible.
+function hasShareableText(content) {
+    return content.title !== undefined || content.text !== undefined || content.url !== undefined;
+}
+//# sourceMappingURL=capacitorShare.js.map

package/dist/capacitorShare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitorShare.js","sourceRoot":"","sources":["../src/capacitorShare.ts"],"names":[],"mappings":"AAIA,sGAAsG;AACtG,iGAAiG;AACjG,qGAAqG;AACrG,yGAAyG;AACzG,gGAAgG;AAChG,+FAA+F;AAC/F,6EAA6E;AAC7E,MAAM,UAAU,2BAA2B,CAAC,SAAuB;IACjE,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;IAC9B,+FAA+F;IAC/F,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,KAAK;SACF,QAAQ,EAAE;SACV,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACf,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC;IACjC,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,iBAAiB;IACnB,CAAC,CAAC,CAAC;IACL,OAAO;QACL,WAAW;YACT,OAAO,eAAe,CAAC;QACzB,CAAC;QACD,QAAQ,CAAC,OAAO;YACd,OAAO,eAAe,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO;YAC1B,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,KAAK,CAAC;oBAChB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,WAAW,EAAE,OAAO,EAAE,YAAY;iBACnC,CAAC,CAAC;gBACH,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO;YACpC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;gBAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YAClG,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC;oBAC/B,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,WAAW,EAAE,OAAO,EAAE,YAAY;iBACnC,CAAC,CAAC;gBACH,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YAC1F,CAAC;YAAC,MAAM,CAAC;gBACP,gEAAgE;gBAChE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACnE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,oGAAoG;AACpG,SAAS,gBAAgB,CAAC,OAA+B;IACvD,OAAO,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC;AAChG,CAAC"}

package/dist/capacitorStatusBar.d.ts

@@ -0,0 +1,4 @@
+import type { StatusBarBackend } from '@flighthq/types';
+import type { CapacitorApi } from './capacitorModule';
+export declare function createCapacitorStatusBarBackend(capacitor: CapacitorApi): StatusBarBackend;
+//# sourceMappingURL=capacitorStatusBar.d.ts.map

package/dist/capacitorStatusBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitorStatusBar.d.ts","sourceRoot":"","sources":["../src/capacitorStatusBar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAiC,MAAM,iBAAiB,CAAC;AAEvF,OAAO,KAAK,EAAE,YAAY,EAAgC,MAAM,mBAAmB,CAAC;AAQpF,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,YAAY,GAAG,gBAAgB,CAyCzF"}

package/dist/capacitorStatusBar.js

@@ -0,0 +1,80 @@
+// Maps Flight's StatusBarBackend onto Capacitor's `@capacitor/status-bar`. The setters are async and fire
+// fire-and-forget: setStyle, setBackgroundColor (a packed RGBA int → a `#RRGGBB` hex string, dropping
+// alpha the plugin ignores), setVisible (→ show/hide), and setOverlaysContent (→ setOverlaysWebView).
+// getInfo is a synchronous snapshot while Capacitor's getInfo is async, so it is served from a value
+// prefetched once at construction (default until it resolves). Capacitor emits no status-bar change
+// event, so subscribe is inert.
+export function createCapacitorStatusBarBackend(capacitor) {
+    const statusBar = capacitor.statusBar;
+    // Sync getInfo over async Capacitor: prefetch the snapshot once and cache it.
+    let cachedInfo = null;
+    statusBar
+        .getInfo()
+        .then((info) => {
+        cachedInfo = info;
+    })
+        .catch(() => {
+        /* leave null → defaults */
+    });
+    return {
+        getInfo(out) {
+            const info = cachedInfo;
+            out.color = info?.color !== undefined ? hexToRgba(info.color) : 0;
+            // Capacitor does not report a status-bar height; -1 sentinel per the contract.
+            out.height = -1;
+            out.overlaysContent = info?.overlays ?? false;
+            out.style = info !== null ? toStatusBarStyle(info.style) : 'default';
+            out.visible = info?.visible ?? true;
+            return out;
+        },
+        setBackgroundColor(color) {
+            statusBar.setBackgroundColor({ color: rgbaToHex(color) }).catch(() => { });
+        },
+        setOverlaysContent(overlay) {
+            statusBar.setOverlaysWebView({ overlay }).catch(() => { });
+        },
+        setStyle(style) {
+            statusBar.setStyle({ style: toCapacitorStyle(style) }).catch(() => { });
+        },
+        setVisible(visible) {
+            if (visible)
+                statusBar.show().catch(() => { });
+            else
+                statusBar.hide().catch(() => { });
+        },
+        subscribe() {
+            // Capacitor emits no status-bar change event; inert unsubscribe.
+            return () => { };
+        },
+    };
+}
+// Flight status-bar style ('light' | 'dark' | 'default') → Capacitor Style ('Light' | 'Dark' | 'Default').
+function toCapacitorStyle(style) {
+    if (style === 'light')
+        return 'Light';
+    if (style === 'dark')
+        return 'Dark';
+    return 'Default';
+}
+function toStatusBarStyle(style) {
+    if (style === 'Light')
+        return 'light';
+    if (style === 'Dark')
+        return 'dark';
+    return 'default';
+}
+// A packed RGBA integer (0xRRGGBBAA) → a `#RRGGBB` hex string; Capacitor's color takes no alpha channel.
+function rgbaToHex(color) {
+    const rgb = (color >>> 8) & 0xffffff;
+    return `#${rgb.toString(16).padStart(6, '0')}`;
+}
+// A `#RRGGBB` (or `#RRGGBBAA`) hex string → a packed RGBA integer (0xRRGGBBAA), opaque when no alpha.
+function hexToRgba(hex) {
+    const digits = hex.replace(/^#/, '');
+    if (digits.length === 8)
+        return Number.parseInt(digits, 16) >>> 0;
+    if (digits.length === 6)
+        return ((Number.parseInt(digits, 16) << 8) | 0xff) >>> 0;
+    return 0;
+}
+//# sourceMappingURL=capacitorStatusBar.js.map

package/dist/capacitorStatusBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitorStatusBar.js","sourceRoot":"","sources":["../src/capacitorStatusBar.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from './capacitorApp';
+export * from './capacitorClipboard';
+export * from './capacitorConnectivity';
+export * from './capacitorDevice';
+export * from './capacitorDialog';
+export * from './capacitorFileSystem';
+export * from './capacitorGeolocation';
+export * from './capacitorHaptics';
+export * from './capacitorKeyboard';
+export * from './capacitorModule';
+export * from './capacitorNotification';
+export * from './capacitorRegister';
+export * from './capacitorShare';
+export * from './capacitorStatusBar';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export * from './capacitorApp';
+export * from './capacitorClipboard';
+export * from './capacitorConnectivity';
+export * from './capacitorDevice';
+export * from './capacitorDialog';
+export * from './capacitorFileSystem';
+export * from './capacitorGeolocation';
+export * from './capacitorHaptics';
+export * from './capacitorKeyboard';
+export * from './capacitorModule';
+export * from './capacitorNotification';
+export * from './capacitorRegister';
+export * from './capacitorShare';
+export * from './capacitorStatusBar';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@flighthq/host-capacitor",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/app": "0.1.0",
+    "@flighthq/clipboard": "0.1.0",
+    "@flighthq/connectivity": "0.1.0",
+    "@flighthq/device": "0.1.0",
+    "@flighthq/dialog": "0.1.0",
+    "@flighthq/filesystem": "0.1.0",
+    "@flighthq/geolocation": "0.1.0",
+    "@flighthq/haptics": "0.1.0",
+    "@flighthq/keyboard": "0.1.0",
+    "@flighthq/notification": "0.1.0",
+    "@flighthq/share": "0.1.0",
+    "@flighthq/statusbar": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Capacitor (mobile) host backend: registers Capacitor plugin implementations of Flight's app/clipboard/dialog/notification/share/filesystem/geolocation/haptics/connectivity/device/statusbar/keyboard seams over an injected CapacitorApi",
+  "sideEffects": false
+}

package/src/capacitorApp.test.ts

@@ -0,0 +1,81 @@
+import { createCapacitorAppBackend } from './capacitorApp';
+import type { CapacitorApi } from './capacitorModule';
+
+const flush = async () => {
+  await Promise.resolve();
+  await Promise.resolve();
+};
+
+function fakeCapacitor() {
+  const calls: string[] = [];
+  const listeners = new Map<string, (payload: unknown) => void>();
+  const capacitor = {
+    app: {
+      async getInfo() {
+        return { name: 'FlightApp', id: 'com.flight.app', build: '42', version: '2.3.4' };
+      },
+      async exitApp() {
+        calls.push('exitApp');
+      },
+      async minimizeApp() {
+        calls.push('minimizeApp');
+      },
+      async addListener(eventName: string, listener: (payload: unknown) => void) {
+        listeners.set(eventName, listener);
+        return {
+          async remove() {
+            calls.push(`remove:${eventName}`);
+          },
+        };
+      },
+    },
+  } as unknown as CapacitorApi;
+  return { capacitor, calls, listeners };
+}
+
+describe('createCapacitorAppBackend', () => {
+  it('serves name and version from the prefetch cache once it resolves', async () => {
+    const backend = createCapacitorAppBackend(fakeCapacitor().capacitor);
+    // The sync getters read '' until the construction-time prefetch settles.
+    expect(backend.getName()).toBe('');
+    await flush();
+    expect(backend.getName()).toBe('FlightApp');
+    expect(backend.getVersion()).toBe('2.3.4');
+  });
+
+  it('fires the process/app control methods', () => {
+    const { capacitor, calls } = fakeCapacitor();
+    const backend = createCapacitorAppBackend(capacitor);
+    backend.quit();
+    expect(backend.hideApp()).toBe(true);
+    expect(calls).toContain('exitApp');
+    expect(calls).toContain('minimizeApp');
+  });
+
+  it('routes activate and open-file through app listeners', async () => {
+    const { capacitor, listeners } = fakeCapacitor();
+    const backend = createCapacitorAppBackend(capacitor);
+    let activated = 0;
+    let openedUrl = '';
+    backend.subscribeActivate(() => activated++);
+    backend.subscribeOpenFile((url) => (openedUrl = url));
+    await flush();
+    listeners.get('appStateChange')?.({ isActive: false });
+    expect(activated).toBe(0);
+    listeners.get('appStateChange')?.({ isActive: true });
+    expect(activated).toBe(1);
+    listeners.get('appUrlOpen')?.({ url: 'flight://open' });
+    expect(openedUrl).toBe('flight://open');
+  });
+
+  it('reports sentinels for the desktop-only surface', () => {
+    const backend = createCapacitorAppBackend(fakeCapacitor().capacitor);
+    expect(backend.bounceDock()).toBe(-1);
+    expect(backend.setBadgeCount(3)).toBe(false);
+    expect(backend.setName('X')).toBe(false);
+    expect(backend.showApp()).toBe(false);
+    expect(backend.getLocale()).toBe('');
+    expect(backend.getCommandLine()).toEqual([]);
+    expect(typeof backend.subscribeReady(() => {})).toBe('function');
+  });
+});

package/src/capacitorClipboard.test.ts

@@ -0,0 +1,71 @@
+import { createCapacitorClipboardBackend } from './capacitorClipboard';
+import type { CapacitorApi } from './capacitorModule';
+
+function fakeCapacitor() {
+  const store = { value: '', type: 'text/plain' };
+  const calls: string[] = [];
+  const capacitor = {
+    clipboard: {
+      async read() {
+        calls.push('read');
+        return { value: store.value, type: store.type };
+      },
+      async write(options: { string?: string; image?: string }) {
+        calls.push('write');
+        if (options.image !== undefined) {
+          store.value = options.image;
+          store.type = 'image/png';
+        } else {
+          store.value = options.string ?? '';
+          store.type = 'text/plain';
+        }
+      },
+    },
+  } as unknown as CapacitorApi;
+  return { capacitor, store, calls };
+}
+
+describe('createCapacitorClipboardBackend', () => {
+  it('round-trips text through the Capacitor clipboard', async () => {
+    const { capacitor, calls } = fakeCapacitor();
+    const backend = createCapacitorClipboardBackend(capacitor);
+    expect(await backend.writeText('hi')).toBe(true);
+    expect(await backend.readText()).toBe('hi');
+    expect(await backend.hasText()).toBe(true);
+    expect(calls).toContain('write');
+    expect(calls).toContain('read');
+  });
+
+  it('round-trips a data-URL image', async () => {
+    const backend = createCapacitorClipboardBackend(fakeCapacitor().capacitor);
+    expect(await backend.writeImage('data:image/png;base64,AAAA')).toBe(true);
+    expect(await backend.readImage()).toBe('data:image/png;base64,AAAA');
+    expect(await backend.hasImage()).toBe(true);
+    // An image on the clipboard is not text.
+    expect(await backend.readText()).toBe('');
+    expect(await backend.hasText()).toBe(false);
+  });
+
+  it('reports sentinels for unsupported flavors', async () => {
+    const backend = createCapacitorClipboardBackend(fakeCapacitor().capacitor);
+    expect(await backend.readHtml()).toBe('');
+    expect(await backend.writeHtml('<b/>')).toBe(false);
+    expect(await backend.readBookmark()).toBeNull();
+    expect(await backend.getFormats()).toEqual([]);
+    expect(await backend.readFiles()).toEqual([]);
+    expect(backend.getChangeCount()).toBe(-1);
+  });
+
+  it('resolves sentinels when the clipboard read throws', async () => {
+    const capacitor = {
+      clipboard: {
+        async read() {
+          throw new Error('denied');
+        },
+      },
+    } as unknown as CapacitorApi;
+    const backend = createCapacitorClipboardBackend(capacitor);
+    expect(await backend.readText()).toBe('');
+    expect(await backend.hasText()).toBe(false);
+  });
+});

package/src/capacitorConnectivity.test.ts

@@ -0,0 +1,64 @@
+import type { ConnectivityStatus } from '@flighthq/types';
+
+import { createCapacitorConnectivityBackend } from './capacitorConnectivity';
+import type { CapacitorApi, CapacitorConnectionStatus } from './capacitorModule';
+
+const flush = async () => {
+  await Promise.resolve();
+  await Promise.resolve();
+};
+
+function emptyStatus(): ConnectivityStatus {
+  return {
+    online: false,
+    type: 'unknown',
+    downlink: 0,
+    downlinkMax: 0,
+    effectiveType: 'x',
+    rtt: 0,
+    saveData: true,
+    metered: false,
+  };
+}
+
+function fakeCapacitor(initial: CapacitorConnectionStatus = { connected: true, connectionType: 'wifi' }) {
+  const listeners: Array<(status: CapacitorConnectionStatus) => void> = [];
+  const capacitor = {
+    network: {
+      async getStatus() {
+        return initial;
+      },
+      async addListener(_eventName: string, listener: (status: CapacitorConnectionStatus) => void) {
+        listeners.push(listener);
+        return { async remove() {} };
+      },
+    },
+  } as unknown as CapacitorApi;
+  return { capacitor, fire: (status: CapacitorConnectionStatus) => listeners.forEach((l) => l(status)) };
+}
+
+describe('createCapacitorConnectivityBackend', () => {
+  it('fills the out snapshot from the prefetched status', async () => {
+    const backend = createCapacitorConnectivityBackend(fakeCapacitor().capacitor);
+    await flush();
+    const status = backend.getStatus(emptyStatus());
+    expect(status.online).toBe(true);
+    expect(status.type).toBe('wifi');
+    expect(status.downlink).toBe(-1);
+    expect(status.metered).toBe(false);
+  });
+
+  it('reflects a networkStatusChange in the mirror and to subscribers', async () => {
+    const { capacitor, fire } = fakeCapacitor();
+    const backend = createCapacitorConnectivityBackend(capacitor);
+    await flush();
+    let changes = 0;
+    backend.subscribe(() => changes++);
+    await flush();
+    fire({ connected: true, connectionType: 'cellular' });
+    expect(changes).toBe(1);
+    const status = backend.getStatus(emptyStatus());
+    expect(status.type).toBe('cellular');
+    expect(status.metered).toBe(true);
+  });
+});

package/src/capacitorDevice.test.ts

@@ -0,0 +1,99 @@
+import type { DeviceCapabilities, DeviceDisplayMetrics, DeviceInfo, SafeAreaInsets } from '@flighthq/types';
+
+import { createCapacitorDeviceBackend } from './capacitorDevice';
+import type { CapacitorApi } from './capacitorModule';
+
+const flush = async () => {
+  await Promise.resolve();
+  await Promise.resolve();
+};
+
+function fakeCapacitor() {
+  const capacitor = {
+    device: {
+      async getInfo() {
+        return {
+          model: 'iPhone15,2',
+          platform: 'ios',
+          operatingSystem: 'ios',
+          osVersion: '17.0',
+          manufacturer: 'Apple',
+          isVirtual: false,
+          webViewVersion: '17.0',
+          name: "Joe's iPhone",
+        };
+      },
+      async getId() {
+        return { identifier: 'device-uuid' };
+      },
+    },
+  } as unknown as CapacitorApi;
+  return { capacitor };
+}
+
+function blankInfo(): DeviceInfo {
+  return {
+    arch: 'z',
+    availableMemory: 1,
+    boardName: 'z',
+    colorGamut: 'z',
+    cpuCores: 1,
+    fontScale: 1,
+    formFactor: 'z',
+    gpuRenderer: 'z',
+    gpuVendor: 'z',
+    isHdr: true,
+    isJailbroken: true,
+    isLowEndDevice: true,
+    isRooted: true,
+    isVirtual: true,
+    manufacturer: 'z',
+    marketingName: 'z',
+    model: 'z',
+    osBuild: 'z',
+    osName: 'z',
+    osVersion: 'z',
+    platformString: 'z',
+    productName: 'z',
+    supportedAbis: ['z'],
+    totalMemory: 1,
+    webViewVersion: 'z',
+  };
+}
+
+describe('createCapacitorDeviceBackend', () => {
+  it('fills DeviceInfo from the prefetched Capacitor info once it resolves', async () => {
+    const backend = createCapacitorDeviceBackend(fakeCapacitor().capacitor);
+    // Sentinels until the construction-time prefetch settles.
+    expect(backend.getInfo(blankInfo()).model).toBe('');
+    await flush();
+    const info = backend.getInfo(blankInfo());
+    expect(info.model).toBe('iPhone15,2');
+    expect(info.manufacturer).toBe('Apple');
+    expect(info.osName).toBe('ios');
+    expect(info.marketingName).toBe("Joe's iPhone");
+    expect(info.formFactor).toBe('Phone');
+    // Unreported fields fall back to sentinels.
+    expect(info.arch).toBe('');
+    expect(info.totalMemory).toBe(-1);
+    expect(backend.getId()).toBe('device-uuid');
+  });
+
+  it('reports sentinels for metrics, capabilities, and safe-area insets', () => {
+    const backend = createCapacitorDeviceBackend(fakeCapacitor().capacitor);
+    const metrics: DeviceDisplayMetrics = {
+      colorDepth: 1,
+      densityDpi: 1,
+      logicalHeight: 1,
+      logicalWidth: 1,
+      physicalHeight: 1,
+      physicalWidth: 1,
+      pixelRatio: 1,
+    };
+    expect(backend.getDisplayMetrics(metrics).pixelRatio).toBe(-1);
+    const caps: DeviceCapabilities = { hasKeyboard: true, hasMouse: true, hasStylus: true };
+    expect(backend.getCapabilities(caps)).toEqual({ hasKeyboard: false, hasMouse: false, hasStylus: false });
+    const insets: SafeAreaInsets = { top: 9, right: 9, bottom: 9, left: 9 };
+    expect(backend.getSafeAreaInsets(insets)).toEqual({ top: 0, right: 0, bottom: 0, left: 0 });
+  });
+});

package/src/capacitorDialog.test.ts

@@ -0,0 +1,50 @@
+import { createCapacitorDialogBackend } from './capacitorDialog';
+import type { CapacitorApi } from './capacitorModule';
+
+function fakeCapacitor(promptResult = { value: 'typed', cancelled: false }) {
+  const calls: string[] = [];
+  const capacitor = {
+    dialog: {
+      async alert() {
+        calls.push('alert');
+      },
+      async confirm() {
+        calls.push('confirm');
+        return { value: true };
+      },
+      async prompt() {
+        calls.push('prompt');
+        return promptResult;
+      },
+    },
+  } as unknown as CapacitorApi;
+  return { capacitor, calls };
+}
+
+describe('createCapacitorDialogBackend', () => {
+  it('maps message onto a single-button alert', async () => {
+    const { capacitor, calls } = fakeCapacitor();
+    const backend = createCapacitorDialogBackend(capacitor);
+    const result = await backend.message({ message: 'hello' });
+    expect(result).toEqual({ buttonIndex: 0, cancelled: false, checkboxChecked: false });
+    expect(calls).toContain('alert');
+  });
+
+  it('maps confirm and prompt', async () => {
+    const backend = createCapacitorDialogBackend(fakeCapacitor().capacitor);
+    expect(await backend.confirm({ message: 'ok?' })).toBe(true);
+    expect(await backend.prompt({ message: 'name?' })).toBe('typed');
+  });
+
+  it('resolves the null sentinel for a cancelled prompt', async () => {
+    const backend = createCapacitorDialogBackend(fakeCapacitor({ value: '', cancelled: true }).capacitor);
+    expect(await backend.prompt({ message: 'name?' })).toBeNull();
+  });
+
+  it('reports empty results for the absent file picker', async () => {
+    const backend = createCapacitorDialogBackend(fakeCapacitor().capacitor);
+    expect(await backend.openFile({})).toEqual([]);
+    expect(await backend.openDirectory({})).toEqual([]);
+    expect(await backend.saveFile({})).toBeNull();
+  });
+});