@ateam-ai-mobile/expo 0.1.4 → 0.1.7

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/haptics.ts","../src/bundleStorage.ts","../src/attachmentCache.ts"],"sourcesContent":["/**\n * @ateam-ai-mobile/expo — Expo-backed providers for the ADAS SDK.\n *\n * Bare-RN hosts skip this package entirely (core + plugin-runtime have safe\n * defaults); Expo hosts call setupExpoProviders() once at startup to light\n * up haptics, persistent bundle caching, attachment previews, and the\n * expo modules remote bundles may require.\n */\nimport * as ExpoWebBrowser from 'expo-web-browser';\nimport * as ExpoLinking from 'expo-linking';\nimport * as ExpoClipboard from 'expo-clipboard';\nimport AsyncStorage from '@react-native-async-storage/async-storage';\nimport { setAcsCacheStorage } from '@ateam-ai-mobile/core';\nimport {\n  setHapticsProvider,\n  setBundleStorage,\n  registerBundleModules,\n} from '@ateam-ai-mobile/plugin-runtime';\nimport { setClipboardProvider } from '@ateam-ai-mobile/ui';\n\nimport { expoHaptics } from './haptics';\nimport { ExpoBundleStorage } from './bundleStorage';\nimport { ExpoAttachmentCache } from './attachmentCache';\n\nexport { expoHaptics } from './haptics';\nexport { ExpoBundleStorage } from './bundleStorage';\nexport { ExpoAttachmentCache } from './attachmentCache';\n// NOTE: createBridge (device capabilities bridge) is intentionally NOT\n// exported here — it statically imports the optional expo modules\n// (calendar/contacts/location/…), which would break Metro builds in hosts\n// that don't install them. Install those modules and import it from the\n// subpath: `import { createBridge } from '@ateam-ai-mobile/expo/bridge'`.\n\n/**\n * Wire all Expo providers in one call. Runs before initAdas() is fine —\n * these registries are independent of the core config.\n *\n * Returns the attachment cache so the host can pass it to initAdas():\n *   const { attachmentCache } = setupExpoProviders();\n *   initAdas({ ..., attachmentCache });\n */\nexport function setupExpoProviders(opts?: {\n  /** Extra modules remote bundles may require(), e.g. react-native-webview.\n   *  Static imports must live in the HOST (it owns the native build). */\n  bundleModules?: Record<string, any>;\n  /** AsyncStorage key overrides — pass your pre-SDK keys when migrating an\n   *  existing app so users keep their attachment previews / bundle cache. */\n  attachmentIndexKey?: string;\n  bundleIndexKey?: string;\n}): { attachmentCache: ExpoAttachmentCache } {\n  setHapticsProvider(expoHaptics);\n  setBundleStorage(new ExpoBundleStorage({ indexKey: opts?.bundleIndexKey }));\n  setClipboardProvider({\n    setString: (text: string) => ExpoClipboard.setStringAsync(text).then(() => {}),\n  });\n  registerBundleModules({\n    'expo-web-browser': ExpoWebBrowser,\n    'expo-linking': ExpoLinking,\n    ...(opts?.bundleModules || {}),\n  });\n  // Persist the ACS home-actions feed across cold starts.\n  setAcsCacheStorage({\n    getItem: (k: string) => AsyncStorage.getItem(k),\n    setItem: (k: string, v: string) => AsyncStorage.setItem(k, v),\n  });\n  return { attachmentCache: new ExpoAttachmentCache({ indexKey: opts?.attachmentIndexKey }) };\n}\n","/**\n * expo-haptics implementation of the plugin HapticsAPI.\n */\nimport * as Haptics from 'expo-haptics';\nimport type { HapticsAPI } from '@ateam-ai-mobile/plugin-runtime';\n\nexport const expoHaptics: HapticsAPI = {\n  impact(style) {\n    const map = {\n      light: Haptics.ImpactFeedbackStyle.Light,\n      medium: Haptics.ImpactFeedbackStyle.Medium,\n      heavy: Haptics.ImpactFeedbackStyle.Heavy,\n    } as const;\n    Haptics.impactAsync(map[style]).catch(() => {});\n  },\n  notification(type) {\n    const map = {\n      success: Haptics.NotificationFeedbackType.Success,\n      warning: Haptics.NotificationFeedbackType.Warning,\n      error: Haptics.NotificationFeedbackType.Error,\n    } as const;\n    Haptics.notificationAsync(map[type]).catch(() => {});\n  },\n  selection() {\n    Haptics.selectionAsync().catch(() => {});\n  },\n};\n","/**\n * Disk-backed BundleStorage: bundle files in the Expo cache directory,\n * index in AsyncStorage. Mirrors the reference app's cache semantics\n * (index version key, files under plugin-bundles/).\n */\nimport * as FileSystem from 'expo-file-system/legacy';\nimport AsyncStorage from '@react-native-async-storage/async-storage';\nimport type { BundleStorage, BundleCacheEntry } from '@ateam-ai-mobile/plugin-runtime';\n\nconst CACHE_DIR = `${FileSystem.cacheDirectory}plugin-bundles/`;\nconst DEFAULT_CACHE_INDEX_KEY = 'adas-plugin-bundles-index-v1';\n\nexport class ExpoBundleStorage implements BundleStorage {\n  private dirReady = false;\n  private indexKey: string;\n\n  /** Pass `indexKey` when migrating from an app that already persisted a\n   *  bundle index under a different key — keeps the existing cache warm. */\n  constructor(opts?: { indexKey?: string }) {\n    this.indexKey = opts?.indexKey || DEFAULT_CACHE_INDEX_KEY;\n  }\n\n  private async ensureDir(): Promise<void> {\n    if (this.dirReady) return;\n    try {\n      const info = await FileSystem.getInfoAsync(CACHE_DIR);\n      if (!info.exists) {\n        await FileSystem.makeDirectoryAsync(CACHE_DIR, { intermediates: true });\n      }\n    } catch (err) {\n      console.warn('[ExpoBundleStorage] cache dir error:', err);\n    }\n    this.dirReady = true;\n  }\n\n  async loadIndex(): Promise<Record<string, BundleCacheEntry>> {\n    try {\n      const raw = await AsyncStorage.getItem(this.indexKey);\n      return raw ? JSON.parse(raw) : {};\n    } catch {\n      return {};\n    }\n  }\n\n  async saveIndex(index: Record<string, BundleCacheEntry>): Promise<void> {\n    try {\n      await AsyncStorage.setItem(this.indexKey, JSON.stringify(index));\n    } catch (err) {\n      console.warn('[ExpoBundleStorage] index save error:', err);\n    }\n  }\n\n  async readBundle(localPath: string): Promise<string | null> {\n    try {\n      const info = await FileSystem.getInfoAsync(localPath);\n      if (!info.exists) return null;\n      return await FileSystem.readAsStringAsync(localPath);\n    } catch {\n      return null; // file gone — caller re-downloads\n    }\n  }\n\n  async writeBundle(key: string, content: string): Promise<string> {\n    await this.ensureDir();\n    const localPath = `${CACHE_DIR}${key}`;\n    await FileSystem.writeAsStringAsync(localPath, content);\n    return localPath;\n  }\n\n  async deleteBundle(localPath: string): Promise<void> {\n    await FileSystem.deleteAsync(localPath, { idempotent: true }).catch(() => {});\n  }\n\n  async clearAll(): Promise<void> {\n    await FileSystem.deleteAsync(CACHE_DIR, { idempotent: true }).catch(() => {});\n    await AsyncStorage.removeItem(this.indexKey).catch(() => {});\n    this.dirReady = false;\n  }\n}\n","/**\n * Expo implementation of @ateam-ai-mobile/core's AttachmentCache: attachment bytes on\n * disk, index in AsyncStorage. Mirrors the reference app's chat attachment\n * cache (last-100 retention).\n */\nimport * as FileSystem from 'expo-file-system/legacy';\nimport AsyncStorage from '@react-native-async-storage/async-storage';\nimport type { AttachmentCache, AttachmentPreview, OutgoingAttachment } from '@ateam-ai-mobile/core';\n\nconst DEFAULT_INDEX_KEY = 'adas-chat-attachment-index-v1';\nconst DIR = `${FileSystem.documentDirectory}chat-attachments/`;\nconst MAX_JOBS = 100;\n\ninterface CachedAttachment { mimeType: string; name: string; filePath: string }\n\nexport class ExpoAttachmentCache implements AttachmentCache {\n  private index: Record<string, CachedAttachment[]> = {};\n  private loaded: Promise<void>;\n  private indexKey: string;\n\n  /** Pass `indexKey` when migrating from an app that already persisted an\n   *  index under a different AsyncStorage key — otherwise existing users\n   *  lose every cached preview on upgrade. */\n  constructor(opts?: { indexKey?: string }) {\n    const indexKey = opts?.indexKey || DEFAULT_INDEX_KEY;\n    this.indexKey = indexKey;\n    this.loaded = (async () => {\n      try {\n        const info = await FileSystem.getInfoAsync(DIR);\n        if (!info.exists) await FileSystem.makeDirectoryAsync(DIR, { intermediates: true });\n        const raw = await AsyncStorage.getItem(indexKey);\n        if (raw) this.index = JSON.parse(raw);\n      } catch {}\n    })();\n  }\n\n  async ready(): Promise<void> {\n    await this.loaded;\n  }\n\n  async save(jobId: string, attachments: OutgoingAttachment[]): Promise<void> {\n    await this.loaded;\n    const entries: CachedAttachment[] = [];\n    for (let i = 0; i < attachments.length; i++) {\n      const att = attachments[i];\n      const ext = att.mimeType.startsWith('image/') ? att.mimeType.split('/')[1] || 'jpg' : 'bin';\n      const filePath = `${DIR}${jobId}_${i}.${ext}`;\n      try {\n        await FileSystem.writeAsStringAsync(filePath, att.data, { encoding: FileSystem.EncodingType.Base64 });\n        entries.push({ mimeType: att.mimeType, name: att.name, filePath });\n      } catch (err) {\n        console.warn('[ExpoAttachmentCache] write failed:', err);\n      }\n    }\n    if (entries.length === 0) return;\n\n    this.index[jobId] = entries;\n    // Keep only the most recent MAX_JOBS jobs; delete evicted files.\n    const keys = Object.keys(this.index);\n    if (keys.length > MAX_JOBS) {\n      for (const k of keys.slice(0, keys.length - MAX_JOBS)) {\n        const old = this.index[k];\n        if (old) for (const o of old) FileSystem.deleteAsync(o.filePath, { idempotent: true }).catch(() => {});\n        delete this.index[k];\n      }\n    }\n    try {\n      await AsyncStorage.setItem(this.indexKey, JSON.stringify(this.index));\n    } catch {}\n  }\n\n  get(jobId: string): AttachmentPreview[] | undefined {\n    const entries = this.index[jobId];\n    if (!entries || entries.length === 0) return undefined;\n    return entries.map(e => ({\n      mimeType: e.mimeType,\n      name: e.name,\n      previewUri: e.filePath,\n    }));\n  }\n}\n"],"mappings":"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","names":["AsyncStorage","FileSystem","AsyncStorage","AsyncStorage"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/oauth/expoOAuth.d.mts

@@ -0,0 +1,18 @@
+import { OAuthProvider } from '@ateam-ai-mobile/ui';
+
+interface ExpoOAuthConfig {
+    /**
+     * The host's bundled Google client ids, used by the join / open-join screens
+     * that carry no tenant config (they pass no cfg to signInWithGoogle). The
+     * login screen passes the tenant's configured ids and overrides these.
+     */
+    googleWebClientId?: string;
+    googleIosClientId?: string;
+}
+/**
+ * Build the native OAuth provider. Wire it once at startup:
+ *   setOAuthProvider(createExpoOAuthProvider({ googleWebClientId, googleIosClientId }));
+ */
+declare function createExpoOAuthProvider(host?: ExpoOAuthConfig): OAuthProvider;
+
+export { type ExpoOAuthConfig, createExpoOAuthProvider };

package/dist/oauth/expoOAuth.d.ts

@@ -0,0 +1,18 @@
+import { OAuthProvider } from '@ateam-ai-mobile/ui';
+
+interface ExpoOAuthConfig {
+    /**
+     * The host's bundled Google client ids, used by the join / open-join screens
+     * that carry no tenant config (they pass no cfg to signInWithGoogle). The
+     * login screen passes the tenant's configured ids and overrides these.
+     */
+    googleWebClientId?: string;
+    googleIosClientId?: string;
+}
+/**
+ * Build the native OAuth provider. Wire it once at startup:
+ *   setOAuthProvider(createExpoOAuthProvider({ googleWebClientId, googleIosClientId }));
+ */
+declare function createExpoOAuthProvider(host?: ExpoOAuthConfig): OAuthProvider;
+
+export { type ExpoOAuthConfig, createExpoOAuthProvider };

package/dist/oauth/expoOAuth.js

@@ -0,0 +1,102 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/oauth/expoOAuth.tsx
+var expoOAuth_exports = {};
+__export(expoOAuth_exports, {
+  createExpoOAuthProvider: () => createExpoOAuthProvider
+});
+module.exports = __toCommonJS(expoOAuth_exports);
+var import_react_native = require("react-native");
+var import_google_signin = require("@react-native-google-signin/google-signin");
+var AppleAuthentication = __toESM(require("expo-apple-authentication"));
+var import_jsx_runtime = require("react/jsx-runtime");
+var NOOP = () => {
+};
+function createExpoOAuthProvider(host = {}) {
+  return {
+    async signInWithGoogle(cfg) {
+      const webClientId = cfg?.webClientId || host.googleWebClientId || "";
+      const iosClientId = cfg?.iosClientId || host.googleIosClientId || "";
+      const params = { webClientId };
+      if (iosClientId) params.iosClientId = iosClientId;
+      import_google_signin.GoogleSignin.configure(params);
+      try {
+        await import_google_signin.GoogleSignin.hasPlayServices({ showPlayServicesUpdateDialog: true });
+        const result = await import_google_signin.GoogleSignin.signIn();
+        return result?.data?.idToken || result?.idToken || null;
+      } catch (err) {
+        const code = err?.code;
+        if (code === import_google_signin.statusCodes.SIGN_IN_CANCELLED || code === import_google_signin.statusCodes.IN_PROGRESS) {
+          return null;
+        }
+        throw err;
+      }
+    },
+    async signInWithApple() {
+      try {
+        const credential = await AppleAuthentication.signInAsync({
+          requestedScopes: [
+            AppleAuthentication.AppleAuthenticationScope.FULL_NAME,
+            AppleAuthentication.AppleAuthenticationScope.EMAIL
+          ]
+        });
+        return credential.identityToken || null;
+      } catch (err) {
+        if (err?.code === "ERR_REQUEST_CANCELED") return null;
+        throw err;
+      }
+    },
+    async isAppleAvailable() {
+      if (import_react_native.Platform.OS !== "ios") return false;
+      try {
+        return await AppleAuthentication.isAvailableAsync();
+      } catch {
+        return false;
+      }
+    },
+    renderAppleButton({ onPress, disabled, style }) {
+      return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        AppleAuthentication.AppleAuthenticationButton,
+        {
+          buttonType: AppleAuthentication.AppleAuthenticationButtonType.CONTINUE,
+          buttonStyle: AppleAuthentication.AppleAuthenticationButtonStyle.BLACK,
+          cornerRadius: 999,
+          style,
+          onPress: disabled ? NOOP : onPress
+        }
+      );
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createExpoOAuthProvider
+});
+//# sourceMappingURL=expoOAuth.js.map

package/dist/oauth/expoOAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/oauth/expoOAuth.tsx"],"sourcesContent":["/**\n * @ateam-ai-mobile/expo/oauth — the native OAuth provider for the relocated\n * auth screens (LoginScreen / JoinScreen / OpenJoinScreen in @ateam-ai-mobile/ui).\n *\n * This is the ONLY place @react-native-google-signin + expo-apple-authentication\n * are imported. The `ui` package stays native-free: its screens call\n * getOAuthProvider() for the id_token acquisition + the real Apple HIG button.\n *\n * Deliberately a SUBPATH (`@ateam-ai-mobile/expo/oauth`), not part of the main\n * entry — same rule as `/bridge` and `/device`: a host that doesn't install\n * these native modules must still be able to build @ateam-ai-mobile/expo.\n *\n * Behaviour is ported verbatim from the app's old login.tsx so the iPhone\n * parity gate sees no change:\n *   - Google: configure({ webClientId, iosClientId }) → hasPlayServices →\n *     signIn → normalize the v15-vs-older id_token shape. A missing iosClientId\n *     silently falls back to a web flow (unchanged); the caller gates on\n *     webClientId, so we never reach here without one for the login path.\n *   - a user-cancel (SIGN_IN_CANCELLED / IN_PROGRESS / ERR_REQUEST_CANCELED)\n *     resolves to null — the screen treats null as \"no error\", never a red flash.\n */\nimport React from 'react';\nimport { Platform } from 'react-native';\nimport {\n  GoogleSignin,\n  statusCodes,\n  type ConfigureParams,\n} from '@react-native-google-signin/google-signin';\nimport * as AppleAuthentication from 'expo-apple-authentication';\nimport type { OAuthProvider, OAuthGoogleConfig } from '@ateam-ai-mobile/ui';\n\nconst NOOP = () => {};\n\nexport interface ExpoOAuthConfig {\n  /**\n   * The host's bundled Google client ids, used by the join / open-join screens\n   * that carry no tenant config (they pass no cfg to signInWithGoogle). The\n   * login screen passes the tenant's configured ids and overrides these.\n   */\n  googleWebClientId?: string;\n  googleIosClientId?: string;\n}\n\n/**\n * Build the native OAuth provider. Wire it once at startup:\n *   setOAuthProvider(createExpoOAuthProvider({ googleWebClientId, googleIosClientId }));\n */\nexport function createExpoOAuthProvider(host: ExpoOAuthConfig = {}): OAuthProvider {\n  return {\n    async signInWithGoogle(cfg?: OAuthGoogleConfig): Promise<string | null> {\n      const webClientId = cfg?.webClientId || host.googleWebClientId || '';\n      const iosClientId = cfg?.iosClientId || host.googleIosClientId || '';\n      // configure is idempotent + cheap; do it at sign-in time so the tenant's\n      // ids are always current (replaces login.tsx's configure effect).\n      const params: ConfigureParams = { webClientId };\n      if (iosClientId) (params as any).iosClientId = iosClientId;\n      GoogleSignin.configure(params);\n      try {\n        // android-only; no-op on iOS. Called defensively, as before.\n        await GoogleSignin.hasPlayServices({ showPlayServicesUpdateDialog: true });\n        const result: any = await GoogleSignin.signIn();\n        // v15+ returns { data: { idToken } }; older returns { idToken }.\n        return result?.data?.idToken || result?.idToken || null;\n      } catch (err: any) {\n        const code = err?.code;\n        if (code === statusCodes.SIGN_IN_CANCELLED || code === statusCodes.IN_PROGRESS) {\n          return null;\n        }\n        throw err;\n      }\n    },\n\n    async signInWithApple(): Promise<string | null> {\n      try {\n        const credential = await AppleAuthentication.signInAsync({\n          requestedScopes: [\n            AppleAuthentication.AppleAuthenticationScope.FULL_NAME,\n            AppleAuthentication.AppleAuthenticationScope.EMAIL,\n          ],\n        });\n        return credential.identityToken || null;\n      } catch (err: any) {\n        // ERR_REQUEST_CANCELED = the user dismissed the sheet.\n        if (err?.code === 'ERR_REQUEST_CANCELED') return null;\n        throw err;\n      }\n    },\n\n    async isAppleAvailable(): Promise<boolean> {\n      if (Platform.OS !== 'ios') return false;\n      try {\n        return await AppleAuthentication.isAvailableAsync();\n      } catch {\n        return false;\n      }\n    },\n\n    renderAppleButton({ onPress, disabled, style }): React.ReactNode {\n      // Apple's HIG requires their own styled button when Apple Sign-In sits\n      // alongside other providers. Same chrome the app shipped: CONTINUE /\n      // BLACK / fully-rounded. Layout (width/height) comes from the screen.\n      return (\n        <AppleAuthentication.AppleAuthenticationButton\n          buttonType={AppleAuthentication.AppleAuthenticationButtonType.CONTINUE}\n          buttonStyle={AppleAuthentication.AppleAuthenticationButtonStyle.BLACK}\n          cornerRadius={999}\n          style={style as any}\n          onPress={disabled ? NOOP : onPress}\n        />\n      );\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBA,0BAAyB;AACzB,2BAIO;AACP,0BAAqC;AA0E7B;AAvER,IAAM,OAAO,MAAM;AAAC;AAgBb,SAAS,wBAAwB,OAAwB,CAAC,GAAkB;AACjF,SAAO;AAAA,IACL,MAAM,iBAAiB,KAAiD;AACtE,YAAM,cAAc,KAAK,eAAe,KAAK,qBAAqB;AAClE,YAAM,cAAc,KAAK,eAAe,KAAK,qBAAqB;AAGlE,YAAM,SAA0B,EAAE,YAAY;AAC9C,UAAI,YAAa,CAAC,OAAe,cAAc;AAC/C,wCAAa,UAAU,MAAM;AAC7B,UAAI;AAEF,cAAM,kCAAa,gBAAgB,EAAE,8BAA8B,KAAK,CAAC;AACzE,cAAM,SAAc,MAAM,kCAAa,OAAO;AAE9C,eAAO,QAAQ,MAAM,WAAW,QAAQ,WAAW;AAAA,MACrD,SAAS,KAAU;AACjB,cAAM,OAAO,KAAK;AAClB,YAAI,SAAS,iCAAY,qBAAqB,SAAS,iCAAY,aAAa;AAC9E,iBAAO;AAAA,QACT;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAAA,IAEA,MAAM,kBAA0C;AAC9C,UAAI;AACF,cAAM,aAAa,MAA0B,gCAAY;AAAA,UACvD,iBAAiB;AAAA,YACK,6CAAyB;AAAA,YACzB,6CAAyB;AAAA,UAC/C;AAAA,QACF,CAAC;AACD,eAAO,WAAW,iBAAiB;AAAA,MACrC,SAAS,KAAU;AAEjB,YAAI,KAAK,SAAS,uBAAwB,QAAO;AACjD,cAAM;AAAA,MACR;AAAA,IACF;AAAA,IAEA,MAAM,mBAAqC;AACzC,UAAI,6BAAS,OAAO,MAAO,QAAO;AAClC,UAAI;AACF,eAAO,MAA0B,qCAAiB;AAAA,MACpD,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IAEA,kBAAkB,EAAE,SAAS,UAAU,MAAM,GAAoB;AAI/D,aACE;AAAA,QAAqB;AAAA,QAApB;AAAA,UACC,YAAgC,kDAA8B;AAAA,UAC9D,aAAiC,mDAA+B;AAAA,UAChE,cAAc;AAAA,UACd;AAAA,UACA,SAAS,WAAW,OAAO;AAAA;AAAA,MAC7B;AAAA,IAEJ;AAAA,EACF;AACF;","names":[]}

package/dist/oauth/expoOAuth.mjs

@@ -0,0 +1,8 @@
+import {
+  createExpoOAuthProvider
+} from "../chunk-L4V7OCJ3.mjs";
+import "../chunk-WMJKH4XE.mjs";
+export {
+  createExpoOAuthProvider
+};
+//# sourceMappingURL=expoOAuth.mjs.map

package/dist/oauth/expoOAuth.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types-BRanJYTn.d.mts

@@ -0,0 +1,138 @@
+interface DeviceBridgeConfig {
+    /** Cloud relay base URL (e.g., https://relay.example.com) */
+    relayUrl: string;
+    /** Unique device identifier */
+    deviceId: string;
+    /** Tenant ID — required by relay for data isolation */
+    tenant: string;
+    /** Actor/user ID — scopes device data per user in relay */
+    actorId?: string;
+    /** API key for relay authentication (reserved for future use) */
+    apiKey?: string;
+    /** Sync intervals per domain in milliseconds */
+    syncIntervals?: Partial<Record<string, number>>;
+    /** Enable background sync (requires expo-task-manager) */
+    backgroundSync?: boolean;
+    /** Callback for sync status changes */
+    onStatusChange?: (status: BridgeStatus) => void;
+    /** Callback for errors */
+    onError?: (error: BridgeError) => void;
+}
+type PermissionState = 'not_requested' | 'granted' | 'denied' | 'not_needed';
+interface Capability {
+    /** Unique ID (e.g., 'calendar', 'contacts', 'whatsapp') */
+    id: string;
+    /** Human-readable name for UI */
+    name: string;
+    /** One-line description of what this capability does */
+    description: string;
+    /** Why the app needs this — shown to user BEFORE the OS dialog */
+    reason: string;
+    /** Does this capability require OS permission? */
+    requiresPermission: boolean;
+    /** Current permission state */
+    permissionState: PermissionState;
+    /** Request permission from the OS. Returns true if granted. */
+    requestPermission: () => Promise<boolean>;
+    /** Check current permission without prompting. */
+    checkPermission: () => Promise<boolean>;
+    /** Collect data for this capability. Returns domain data. */
+    collect: () => Promise<unknown>;
+    /** Default sync interval in ms */
+    defaultInterval: number;
+    /** Optional icon name (for host app UI) */
+    icon?: string;
+    /**
+     * Optional OS-event subscription. When provided, the bridge wires this up
+     * during startSync and the callback triggers an immediate sync of this
+     * capability — useful for sources that change unpredictably (battery
+     * level/state) where polling on a fixed interval misses changes while the
+     * app is backgrounded. Return an unsubscribe function.
+     */
+    subscribe?: (notify: () => void) => () => void;
+}
+type SyncState = 'idle' | 'syncing' | 'error' | 'stopped';
+interface DomainSyncStatus {
+    domain: string;
+    lastSync: string | null;
+    state: SyncState;
+    error?: string;
+    itemCount?: number;
+}
+interface BridgeStatus {
+    running: boolean;
+    capabilities: CapabilityStatus[];
+    lastFullSync: string | null;
+    pendingActions: number;
+}
+interface CapabilityStatus {
+    id: string;
+    name: string;
+    permission: PermissionState;
+    sync: DomainSyncStatus;
+}
+interface BridgeError {
+    domain: string;
+    message: string;
+    code: string;
+    timestamp: string;
+}
+interface LocationData {
+    ok: true;
+    timestamp: string;
+    location: {
+        place: string;
+        address: string;
+        lat: number;
+        lng: number;
+        type: string;
+    };
+}
+interface HealthDayMetrics {
+    /** ISO date in local time, e.g. "2026-05-03" */
+    date: string;
+    /**
+     * False when HealthKit is unavailable or the user denied access.
+     *
+     * The metrics below are then null, NOT zero. A zero here used to be
+     * indistinguishable from a real sedentary day, so a denied permission was
+     * reported to the user as "you have taken 0 steps today" — and a coaching
+     * skill would act on it.
+     */
+    available: boolean;
+    /** Total step count for the day. null when unavailable. */
+    steps: number | null;
+    /** Flights of stairs climbed. null when unavailable. */
+    floors: number | null;
+    /** Active energy burned, kcal. null when unavailable. */
+    active_energy_kcal: number | null;
+    /** Walking + running distance, kilometers. null when unavailable. */
+    distance_km: number | null;
+}
+interface DeviceDataBundle {
+    deviceId: string;
+    timestamp: string;
+    domains: Record<string, unknown>;
+}
+type ActionType = 'messaging.send' | 'calendar.create' | 'calendar.reschedule' | 'calendar.cancel' | 'dnd.set' | 'navigation.start' | 'health.today' | 'health.history';
+interface PendingAction {
+    id: string;
+    type: ActionType;
+    params: Record<string, unknown>;
+    created_at: string;
+    status: 'pending' | 'executing' | 'completed' | 'failed';
+}
+interface ActionResult {
+    id: string;
+    ok: boolean;
+    result?: Record<string, unknown>;
+    error?: string;
+    executed_at: string;
+}
+interface RelayResponse<T> {
+    ok: boolean;
+    data?: T;
+    error?: string;
+}
+
+export type { ActionResult as A, BridgeStatus as B, Capability as C, DeviceDataBundle as D, HealthDayMetrics as H, LocationData as L, PendingAction as P, RelayResponse as R, DeviceBridgeConfig as a, CapabilityStatus as b, PermissionState as c, BridgeError as d, DomainSyncStatus as e };

package/dist/types-BRanJYTn.d.ts

@@ -0,0 +1,138 @@
+interface DeviceBridgeConfig {
+    /** Cloud relay base URL (e.g., https://relay.example.com) */
+    relayUrl: string;
+    /** Unique device identifier */
+    deviceId: string;
+    /** Tenant ID — required by relay for data isolation */
+    tenant: string;
+    /** Actor/user ID — scopes device data per user in relay */
+    actorId?: string;
+    /** API key for relay authentication (reserved for future use) */
+    apiKey?: string;
+    /** Sync intervals per domain in milliseconds */
+    syncIntervals?: Partial<Record<string, number>>;
+    /** Enable background sync (requires expo-task-manager) */
+    backgroundSync?: boolean;
+    /** Callback for sync status changes */
+    onStatusChange?: (status: BridgeStatus) => void;
+    /** Callback for errors */
+    onError?: (error: BridgeError) => void;
+}
+type PermissionState = 'not_requested' | 'granted' | 'denied' | 'not_needed';
+interface Capability {
+    /** Unique ID (e.g., 'calendar', 'contacts', 'whatsapp') */
+    id: string;
+    /** Human-readable name for UI */
+    name: string;
+    /** One-line description of what this capability does */
+    description: string;
+    /** Why the app needs this — shown to user BEFORE the OS dialog */
+    reason: string;
+    /** Does this capability require OS permission? */
+    requiresPermission: boolean;
+    /** Current permission state */
+    permissionState: PermissionState;
+    /** Request permission from the OS. Returns true if granted. */
+    requestPermission: () => Promise<boolean>;
+    /** Check current permission without prompting. */
+    checkPermission: () => Promise<boolean>;
+    /** Collect data for this capability. Returns domain data. */
+    collect: () => Promise<unknown>;
+    /** Default sync interval in ms */
+    defaultInterval: number;
+    /** Optional icon name (for host app UI) */
+    icon?: string;
+    /**
+     * Optional OS-event subscription. When provided, the bridge wires this up
+     * during startSync and the callback triggers an immediate sync of this
+     * capability — useful for sources that change unpredictably (battery
+     * level/state) where polling on a fixed interval misses changes while the
+     * app is backgrounded. Return an unsubscribe function.
+     */
+    subscribe?: (notify: () => void) => () => void;
+}
+type SyncState = 'idle' | 'syncing' | 'error' | 'stopped';
+interface DomainSyncStatus {
+    domain: string;
+    lastSync: string | null;
+    state: SyncState;
+    error?: string;
+    itemCount?: number;
+}
+interface BridgeStatus {
+    running: boolean;
+    capabilities: CapabilityStatus[];
+    lastFullSync: string | null;
+    pendingActions: number;
+}
+interface CapabilityStatus {
+    id: string;
+    name: string;
+    permission: PermissionState;
+    sync: DomainSyncStatus;
+}
+interface BridgeError {
+    domain: string;
+    message: string;
+    code: string;
+    timestamp: string;
+}
+interface LocationData {
+    ok: true;
+    timestamp: string;
+    location: {
+        place: string;
+        address: string;
+        lat: number;
+        lng: number;
+        type: string;
+    };
+}
+interface HealthDayMetrics {
+    /** ISO date in local time, e.g. "2026-05-03" */
+    date: string;
+    /**
+     * False when HealthKit is unavailable or the user denied access.
+     *
+     * The metrics below are then null, NOT zero. A zero here used to be
+     * indistinguishable from a real sedentary day, so a denied permission was
+     * reported to the user as "you have taken 0 steps today" — and a coaching
+     * skill would act on it.
+     */
+    available: boolean;
+    /** Total step count for the day. null when unavailable. */
+    steps: number | null;
+    /** Flights of stairs climbed. null when unavailable. */
+    floors: number | null;
+    /** Active energy burned, kcal. null when unavailable. */
+    active_energy_kcal: number | null;
+    /** Walking + running distance, kilometers. null when unavailable. */
+    distance_km: number | null;
+}
+interface DeviceDataBundle {
+    deviceId: string;
+    timestamp: string;
+    domains: Record<string, unknown>;
+}
+type ActionType = 'messaging.send' | 'calendar.create' | 'calendar.reschedule' | 'calendar.cancel' | 'dnd.set' | 'navigation.start' | 'health.today' | 'health.history';
+interface PendingAction {
+    id: string;
+    type: ActionType;
+    params: Record<string, unknown>;
+    created_at: string;
+    status: 'pending' | 'executing' | 'completed' | 'failed';
+}
+interface ActionResult {
+    id: string;
+    ok: boolean;
+    result?: Record<string, unknown>;
+    error?: string;
+    executed_at: string;
+}
+interface RelayResponse<T> {
+    ok: boolean;
+    data?: T;
+    error?: string;
+}
+
+export type { ActionResult as A, BridgeStatus as B, Capability as C, DeviceDataBundle as D, HealthDayMetrics as H, LocationData as L, PendingAction as P, RelayResponse as R, DeviceBridgeConfig as a, CapabilityStatus as b, PermissionState as c, BridgeError as d, DomainSyncStatus as e };

package/dist/vision/index.d.mts

@@ -0,0 +1,81 @@
+import { ComponentType } from 'react';
+
+/** TEST-ONLY live preview bound to the same headless session (so a tester can
+ *  aim). The real Guide runs headless and never mounts this. Null on a binary
+ *  without the native view, so importing this module never crashes. */
+declare const CameraPreview: ComponentType<any> | null;
+interface RawFrameQuality {
+    blur: 'sharp' | 'slight' | 'severe' | 'unknown';
+    exposure: 'good' | 'dark' | 'bright' | 'unknown';
+    /** true = lens covered; false = clearly not; null = not assessed. */
+    obstructed: boolean | null;
+}
+interface Subscription {
+    remove(): void;
+}
+/** A published timeline frame from the vision session (metadata only — never
+ *  pixels; the buffer stays in the native ring, resolved by id). */
+interface VisionFrame {
+    id: string;
+    ts: number;
+    expiresAt: number;
+    blur: RawFrameQuality['blur'];
+    exposure: RawFrameQuality['exposure'];
+    obstructed: RawFrameQuality['obstructed'];
+}
+/** One OCR result on a frame — matches the SDK's VisionText. */
+interface VisionText {
+    text: string;
+    /** 0..1 recogniser confidence (never a 1.0 filler). */
+    confidence: number | null;
+    /** Normalised 0..1 box, origin TOP-left. */
+    box?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/** One classifier label — a vocabulary term, NOT prose. Matches VisionLabel. */
+interface VisionLabel {
+    label: string;
+    confidence: number | null;
+}
+/** One detected object — a located item with a box, from the bundled detector. */
+interface VisionObject {
+    /** Open-Images class name (e.g. "Car", "Traffic light", "Building", "Person"). */
+    label: string;
+    /** 0..1 detector confidence. */
+    confidence: number | null;
+    /** Normalised 0..1 box, origin TOP-left. */
+    box?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/** Is the native vision module present in this binary? */
+declare function isSupported(): boolean;
+/** One-shot: measure a frame's quality from its LOCAL file. Throws if it cannot look. */
+declare function assessQuality(uri: string): Promise<RawFrameQuality>;
+/** Start the vision session — publishes a timeline frame every `intervalMs`. */
+declare function startVision(intervalMs?: number): Promise<void>;
+/** Stop the vision session and release the camera. */
+declare function stopVision(): void;
+/** Subscribe to published timeline frames (id + quality + expiry; no pixels). */
+declare function onVisionFrame(cb: (f: VisionFrame) => void): Subscription;
+/** How far back the native ring can still resolve a frame id (ms). */
+declare function visionRetentionMs(): number;
+/** Resolve a published frame id → its measured quality (null if evicted). */
+declare function qualityById(id: string): RawFrameQuality | null;
+/** On-device OCR on a published frame. [] = looked, no text; throws = couldn't look. */
+declare function readText(id: string, languages?: string[]): Promise<VisionText[]>;
+/** On-device image classification → labels (not prose). [] = nothing recognised. */
+declare function describe(id: string, maxLabels?: number): Promise<VisionLabel[]>;
+/** On-device object detection (bundled YOLOv8n, Open-Images vocabulary) → located
+ *  items with boxes. [] = looked, found nothing above `minConfidence`; throws =
+ *  couldn't look (id aged out, or the model isn't in this build). */
+declare function detectObjects(id: string, maxItems?: number, minConfidence?: number): Promise<VisionObject[]>;
+
+export { CameraPreview, type RawFrameQuality, type VisionFrame, type VisionLabel, type VisionObject, type VisionText, assessQuality, describe, detectObjects, isSupported, onVisionFrame, qualityById, readText, startVision, stopVision, visionRetentionMs };

package/dist/vision/index.d.ts

@@ -0,0 +1,81 @@
+import { ComponentType } from 'react';
+
+/** TEST-ONLY live preview bound to the same headless session (so a tester can
+ *  aim). The real Guide runs headless and never mounts this. Null on a binary
+ *  without the native view, so importing this module never crashes. */
+declare const CameraPreview: ComponentType<any> | null;
+interface RawFrameQuality {
+    blur: 'sharp' | 'slight' | 'severe' | 'unknown';
+    exposure: 'good' | 'dark' | 'bright' | 'unknown';
+    /** true = lens covered; false = clearly not; null = not assessed. */
+    obstructed: boolean | null;
+}
+interface Subscription {
+    remove(): void;
+}
+/** A published timeline frame from the vision session (metadata only — never
+ *  pixels; the buffer stays in the native ring, resolved by id). */
+interface VisionFrame {
+    id: string;
+    ts: number;
+    expiresAt: number;
+    blur: RawFrameQuality['blur'];
+    exposure: RawFrameQuality['exposure'];
+    obstructed: RawFrameQuality['obstructed'];
+}
+/** One OCR result on a frame — matches the SDK's VisionText. */
+interface VisionText {
+    text: string;
+    /** 0..1 recogniser confidence (never a 1.0 filler). */
+    confidence: number | null;
+    /** Normalised 0..1 box, origin TOP-left. */
+    box?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/** One classifier label — a vocabulary term, NOT prose. Matches VisionLabel. */
+interface VisionLabel {
+    label: string;
+    confidence: number | null;
+}
+/** One detected object — a located item with a box, from the bundled detector. */
+interface VisionObject {
+    /** Open-Images class name (e.g. "Car", "Traffic light", "Building", "Person"). */
+    label: string;
+    /** 0..1 detector confidence. */
+    confidence: number | null;
+    /** Normalised 0..1 box, origin TOP-left. */
+    box?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/** Is the native vision module present in this binary? */
+declare function isSupported(): boolean;
+/** One-shot: measure a frame's quality from its LOCAL file. Throws if it cannot look. */
+declare function assessQuality(uri: string): Promise<RawFrameQuality>;
+/** Start the vision session — publishes a timeline frame every `intervalMs`. */
+declare function startVision(intervalMs?: number): Promise<void>;
+/** Stop the vision session and release the camera. */
+declare function stopVision(): void;
+/** Subscribe to published timeline frames (id + quality + expiry; no pixels). */
+declare function onVisionFrame(cb: (f: VisionFrame) => void): Subscription;
+/** How far back the native ring can still resolve a frame id (ms). */
+declare function visionRetentionMs(): number;
+/** Resolve a published frame id → its measured quality (null if evicted). */
+declare function qualityById(id: string): RawFrameQuality | null;
+/** On-device OCR on a published frame. [] = looked, no text; throws = couldn't look. */
+declare function readText(id: string, languages?: string[]): Promise<VisionText[]>;
+/** On-device image classification → labels (not prose). [] = nothing recognised. */
+declare function describe(id: string, maxLabels?: number): Promise<VisionLabel[]>;
+/** On-device object detection (bundled YOLOv8n, Open-Images vocabulary) → located
+ *  items with boxes. [] = looked, found nothing above `minConfidence`; throws =
+ *  couldn't look (id aged out, or the model isn't in this build). */
+declare function detectObjects(id: string, maxItems?: number, minConfidence?: number): Promise<VisionObject[]>;
+
+export { CameraPreview, type RawFrameQuality, type VisionFrame, type VisionLabel, type VisionObject, type VisionText, assessQuality, describe, detectObjects, isSupported, onVisionFrame, qualityById, readText, startVision, stopVision, visionRetentionMs };