@glassly/engine 0.1.0-dev.0

package/build/facades/displayMirror.js

@@ -0,0 +1,29 @@
+/**
+ * glasses display mirror — the typed read facade over the (now engine-owned)
+ * display store, for a phone-side preview of the glasses screen
+ * (`engine.display.mirror`). The store is fed by the display paths
+ * (LocalDisplayManager + the cloud path) via `setDisplayEvent`; this facade is the
+ * read side: `current()` (snapshot) + `onMirror(cb)` (subscribe). The raw store is
+ * also exposed as `engine.displayStore` (the Glassly-app escape hatch).
+ */
+import { useDisplayStore } from "../stores/display";
+export const displayMirror = {
+    /** The display event currently shown on the previewed view (snapshot). */
+    current() {
+        // Copy: the snapshot must not hand callers a mutable reference into the store.
+        return { ...useDisplayStore.getState().currentEvent };
+    },
+    /** Subscribe to changes of the previewed display event; returns an unsubscribe. */
+    onMirror(cb) {
+        return useDisplayStore.subscribe((s) => s.currentEvent, cb);
+    },
+    /** Which view is previewed — the main screen or the dashboard. */
+    view() {
+        return useDisplayStore.getState().view;
+    },
+    /** Switch the previewed view between `"main"` and `"dashboard"`. */
+    setView(view) {
+        useDisplayStore.getState().setView(view);
+    },
+};
+//# sourceMappingURL=displayMirror.js.map

package/build/facades/displayMirror.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayMirror.js","sourceRoot":"","sources":["../../src/facades/displayMirror.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AAIjD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,0EAA0E;IAC1E,OAAO;QACL,+EAA+E;QAC/E,OAAO,EAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAC,CAAA;IACrD,CAAC;IAED,mFAAmF;IACnF,QAAQ,CAAC,EAAuC;QAC9C,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,kEAAkE;IAClE,IAAI;QACF,OAAO,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAA;IACxC,CAAC;IACD,oEAAoE;IACpE,OAAO,CAAC,IAA0B;QAChC,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,CAAC;CACF,CAAA","sourcesContent":["/**\n * glasses display mirror — the typed read facade over the (now engine-owned)\n * display store, for a phone-side preview of the glasses screen\n * (`engine.display.mirror`). The store is fed by the display paths\n * (LocalDisplayManager + the cloud path) via `setDisplayEvent`; this facade is the\n * read side: `current()` (snapshot) + `onMirror(cb)` (subscribe). The raw store is\n * also exposed as `engine.displayStore` (the Glassly-app escape hatch).\n */\nimport {useDisplayStore} from \"../stores/display\"\n\nexport type DisplayMirrorEvent = Record<string, unknown> & {view?: string; layout?: any}\n\nexport const displayMirror = {\n  /** The display event currently shown on the previewed view (snapshot). */\n  current(): DisplayMirrorEvent {\n    // Copy: the snapshot must not hand callers a mutable reference into the store.\n    return {...useDisplayStore.getState().currentEvent}\n  },\n\n  /** Subscribe to changes of the previewed display event; returns an unsubscribe. */\n  onMirror(cb: (event: DisplayMirrorEvent) => void): () => void {\n    return useDisplayStore.subscribe((s) => s.currentEvent, cb)\n  },\n\n  /** Which view is previewed — the main screen or the dashboard. */\n  view(): string {\n    return useDisplayStore.getState().view\n  },\n  /** Switch the previewed view between `\"main\"` and `\"dashboard\"`. */\n  setView(view: \"main\" | \"dashboard\"): void {\n    useDisplayStore.getState().setView(view)\n  },\n}\n"]}

package/build/facades/gallery.d.ts

@@ -0,0 +1,62 @@
+import { type GalleryNotice } from "../services/asg/galleryNotices";
+declare function projectStatus(): {
+    processingFiles: string[];
+    processedFiles: number;
+    isSyncing: boolean;
+    isStarting: boolean;
+    glassesGallery: {
+        photos: number;
+        videos: number;
+        total: number;
+        hasContent: boolean;
+    };
+    queue: {
+        name: string;
+        url: string;
+        download: string;
+        size: number;
+        modified: string | number;
+        mime_type?: string;
+        is_video?: boolean;
+        thumbnail_data?: string;
+        downloaded_at?: number;
+        duration?: number;
+        filePath?: string;
+        thumbnailPath?: string;
+        glassesModel?: string;
+    }[];
+    queueLength: number;
+    queueIndex: number;
+    syncState: import("../stores/gallerySync").SyncState;
+    currentFile: string | null;
+    currentFileProgress: number;
+    completedFiles: number;
+    totalFiles: number;
+    failedFiles: string[];
+};
+export type GallerySyncStatus = ReturnType<typeof projectStatus>;
+export declare const gallery: {
+    /** Snapshot of the current sync state + progress. */
+    status: () => GallerySyncStatus;
+    /** Subscribe to sync-state changes; returns an unsubscribe. Deduped on the projected
+     * status (the gallerySync store mutates many unrelated fields during a sync), so the
+     * host only re-renders when the projection actually changes — matches the other
+     * read-model facades. */
+    onStatus: (cb: (status: GallerySyncStatus) => void) => (() => void);
+    /** Subscribe to user-actionable notices (host renders alerts / settings deep-links). */
+    onNotice: (cb: (notice: GalleryNotice) => void) => (() => void);
+    /** Start a gallery sync (the host gates connectivity/permissions first). */
+    sync: () => Promise<void>;
+    /** Cancel an in-progress sync. */
+    cancel: () => Promise<void>;
+    /** Ask glasses to refresh their gallery summary counts. */
+    refreshStatus: () => Promise<void>;
+    /** Remove local files from the current gallery queue after host-owned deletion UI completes. */
+    removeFilesFromQueue: (fileNames: string[]) => void;
+    /** Clear the current gallery sync queue after host-owned bulk deletion completes. */
+    clearQueue: () => void;
+    /** Clear the cached glasses gallery summary when product UI observes disconnect. */
+    clearGlassesGalleryStatus: () => void;
+};
+export {};
+//# sourceMappingURL=gallery.d.ts.map

package/build/facades/gallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gallery.d.ts","sourceRoot":"","sources":["../../src/facades/gallery.ts"],"names":[],"mappings":"AAcA,OAAO,EAAkB,KAAK,aAAa,EAAC,MAAM,gCAAgC,CAAA;AAElF,iBAAS,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBrB;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;AAEhE,eAAO,MAAM,OAAO;IAClB,qDAAqD;kBACzC,iBAAiB;IAC7B;;;6BAGyB;mBACV,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAUjE,wFAAwF;mBACzE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAE7D,4EAA4E;gBAClE,OAAO,CAAC,IAAI,CAAC;IACvB,kCAAkC;kBACtB,OAAO,CAAC,IAAI,CAAC;IACzB,2DAA2D;yBACxC,OAAO,CAAC,IAAI,CAAC;IAChC,gGAAgG;sCAC9D,MAAM,EAAE,KAAG,IAAI;IACjD,qFAAqF;sBACrE,IAAI;IACpB,oFAAoF;qCACrD,IAAI;CACpC,CAAA"}

package/build/facades/gallery.js

@@ -0,0 +1,61 @@
+/**
+ * gallery facade — `engine.gallery`: the OEM-facing gallery-sync surface. Engine's
+ * gallerySyncService orchestrates the sync (hotspot → wifi → HTTP fetch → process →
+ * store); this facade exposes the projected status + the structured notices the host
+ * renders its own UI from, plus the sync/cancel actions. No host-injected UI — the host
+ * owns all alerts/navigation/i18n (it renders them off `onNotice`).
+ */
+import { useGallerySyncStore, selectSyncProgress, selectIssyncing, selectGlassesGalleryStatus, } from "../stores/gallerySync";
+import { gallerySyncService } from "../services/asg/gallerySyncService";
+import { onGalleryNotice } from "../services/asg/galleryNotices";
+function projectStatus() {
+    const s = useGallerySyncStore.getState();
+    const progress = selectSyncProgress(s);
+    return {
+        ...progress,
+        processingFiles: Array.from(progress.processingFiles),
+        processedFiles: s.processedFiles,
+        isSyncing: selectIssyncing(s),
+        isStarting: s.syncStarting,
+        glassesGallery: selectGlassesGalleryStatus(s),
+        // Copy: the snapshot must not hand callers a mutable reference into the store
+        // (each queue item is copied too — callers must not mutate them in place).
+        queue: s.queue.map((item) => ({ ...item })),
+        queueLength: s.queue.length,
+        queueIndex: s.queueIndex,
+    };
+}
+export const gallery = {
+    /** Snapshot of the current sync state + progress. */
+    status: () => projectStatus(),
+    /** Subscribe to sync-state changes; returns an unsubscribe. Deduped on the projected
+     * status (the gallerySync store mutates many unrelated fields during a sync), so the
+     * host only re-renders when the projection actually changes — matches the other
+     * read-model facades. */
+    onStatus: (cb) => {
+        let last = JSON.stringify(projectStatus());
+        return useGallerySyncStore.subscribe(() => {
+            const status = projectStatus();
+            const serialized = JSON.stringify(status);
+            if (serialized === last)
+                return;
+            last = serialized;
+            cb(status);
+        });
+    },
+    /** Subscribe to user-actionable notices (host renders alerts / settings deep-links). */
+    onNotice: (cb) => onGalleryNotice(cb),
+    /** Start a gallery sync (the host gates connectivity/permissions first). */
+    sync: () => gallerySyncService.startSync(),
+    /** Cancel an in-progress sync. */
+    cancel: () => gallerySyncService.cancelSync(),
+    /** Ask glasses to refresh their gallery summary counts. */
+    refreshStatus: () => gallerySyncService.queryGlassesGalleryStatus(),
+    /** Remove local files from the current gallery queue after host-owned deletion UI completes. */
+    removeFilesFromQueue: (fileNames) => useGallerySyncStore.getState().removeFilesFromQueue(fileNames),
+    /** Clear the current gallery sync queue after host-owned bulk deletion completes. */
+    clearQueue: () => useGallerySyncStore.getState().clearQueue(),
+    /** Clear the cached glasses gallery summary when product UI observes disconnect. */
+    clearGlassesGalleryStatus: () => useGallerySyncStore.getState().clearGlassesGalleryStatus(),
+};
+//# sourceMappingURL=gallery.js.map

package/build/facades/gallery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gallery.js","sourceRoot":"","sources":["../../src/facades/gallery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,0BAA0B,GAC3B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAC,kBAAkB,EAAC,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAC,eAAe,EAAqB,MAAM,gCAAgC,CAAA;AAElF,SAAS,aAAa;IACpB,MAAM,CAAC,GAAG,mBAAmB,CAAC,QAAQ,EAAE,CAAA;IACxC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;IACtC,OAAO;QACL,GAAG,QAAQ;QACX,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;QACrD,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;QAC7B,UAAU,EAAE,CAAC,CAAC,YAAY;QAC1B,cAAc,EAAE,0BAA0B,CAAC,CAAC,CAAC;QAC7C,8EAA8E;QAC9E,2EAA2E;QAC3E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAC,GAAG,IAAI,EAAC,CAAC,CAAC;QACzC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;QAC3B,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAA;AACH,CAAC;AAID,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,qDAAqD;IACrD,MAAM,EAAE,GAAsB,EAAE,CAAC,aAAa,EAAE;IAChD;;;6BAGyB;IACzB,QAAQ,EAAE,CAAC,EAAuC,EAAgB,EAAE;QAClE,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAA;QAC1C,OAAO,mBAAmB,CAAC,SAAS,CAAC,GAAG,EAAE;YACxC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;YAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;YACzC,IAAI,UAAU,KAAK,IAAI;gBAAE,OAAM;YAC/B,IAAI,GAAG,UAAU,CAAA;YACjB,EAAE,CAAC,MAAM,CAAC,CAAA;QACZ,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,wFAAwF;IACxF,QAAQ,EAAE,CAAC,EAAmC,EAAgB,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;IAEpF,4EAA4E;IAC5E,IAAI,EAAE,GAAkB,EAAE,CAAC,kBAAkB,CAAC,SAAS,EAAE;IACzD,kCAAkC;IAClC,MAAM,EAAE,GAAkB,EAAE,CAAC,kBAAkB,CAAC,UAAU,EAAE;IAC5D,2DAA2D;IAC3D,aAAa,EAAE,GAAkB,EAAE,CAAC,kBAAkB,CAAC,yBAAyB,EAAE;IAClF,gGAAgG;IAChG,oBAAoB,EAAE,CAAC,SAAmB,EAAQ,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,oBAAoB,CAAC,SAAS,CAAC;IACnH,qFAAqF;IACrF,UAAU,EAAE,GAAS,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE;IACnE,oFAAoF;IACpF,yBAAyB,EAAE,GAAS,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,yBAAyB,EAAE;CAClG,CAAA","sourcesContent":["/**\n * gallery facade — `engine.gallery`: the OEM-facing gallery-sync surface. Engine's\n * gallerySyncService orchestrates the sync (hotspot → wifi → HTTP fetch → process →\n * store); this facade exposes the projected status + the structured notices the host\n * renders its own UI from, plus the sync/cancel actions. No host-injected UI — the host\n * owns all alerts/navigation/i18n (it renders them off `onNotice`).\n */\nimport {\n  useGallerySyncStore,\n  selectSyncProgress,\n  selectIssyncing,\n  selectGlassesGalleryStatus,\n} from \"../stores/gallerySync\"\nimport {gallerySyncService} from \"../services/asg/gallerySyncService\"\nimport {onGalleryNotice, type GalleryNotice} from \"../services/asg/galleryNotices\"\n\nfunction projectStatus() {\n  const s = useGallerySyncStore.getState()\n  const progress = selectSyncProgress(s)\n  return {\n    ...progress,\n    processingFiles: Array.from(progress.processingFiles),\n    processedFiles: s.processedFiles,\n    isSyncing: selectIssyncing(s),\n    isStarting: s.syncStarting,\n    glassesGallery: selectGlassesGalleryStatus(s),\n    // Copy: the snapshot must not hand callers a mutable reference into the store\n    // (each queue item is copied too — callers must not mutate them in place).\n    queue: s.queue.map((item) => ({...item})),\n    queueLength: s.queue.length,\n    queueIndex: s.queueIndex,\n  }\n}\n\nexport type GallerySyncStatus = ReturnType<typeof projectStatus>\n\nexport const gallery = {\n  /** Snapshot of the current sync state + progress. */\n  status: (): GallerySyncStatus => projectStatus(),\n  /** Subscribe to sync-state changes; returns an unsubscribe. Deduped on the projected\n   * status (the gallerySync store mutates many unrelated fields during a sync), so the\n   * host only re-renders when the projection actually changes — matches the other\n   * read-model facades. */\n  onStatus: (cb: (status: GallerySyncStatus) => void): (() => void) => {\n    let last = JSON.stringify(projectStatus())\n    return useGallerySyncStore.subscribe(() => {\n      const status = projectStatus()\n      const serialized = JSON.stringify(status)\n      if (serialized === last) return\n      last = serialized\n      cb(status)\n    })\n  },\n  /** Subscribe to user-actionable notices (host renders alerts / settings deep-links). */\n  onNotice: (cb: (notice: GalleryNotice) => void): (() => void) => onGalleryNotice(cb),\n\n  /** Start a gallery sync (the host gates connectivity/permissions first). */\n  sync: (): Promise<void> => gallerySyncService.startSync(),\n  /** Cancel an in-progress sync. */\n  cancel: (): Promise<void> => gallerySyncService.cancelSync(),\n  /** Ask glasses to refresh their gallery summary counts. */\n  refreshStatus: (): Promise<void> => gallerySyncService.queryGlassesGalleryStatus(),\n  /** Remove local files from the current gallery queue after host-owned deletion UI completes. */\n  removeFilesFromQueue: (fileNames: string[]): void => useGallerySyncStore.getState().removeFilesFromQueue(fileNames),\n  /** Clear the current gallery sync queue after host-owned bulk deletion completes. */\n  clearQueue: (): void => useGallerySyncStore.getState().clearQueue(),\n  /** Clear the cached glasses gallery summary when product UI observes disconnect. */\n  clearGlassesGalleryStatus: (): void => useGallerySyncStore.getState().clearGlassesGalleryStatus(),\n}\n"]}

package/build/facades/glasses.d.ts

@@ -0,0 +1,142 @@
+/**
+ * glasses facade — the core `engine.glasses.*` surface: connection actions (over
+ * the bluetooth-sdk passthrough), a curated status/info read-model (projected from
+ * the engine-owned glasses store), capabilities (from the model table), and the
+ * discrete input events. The `wifi` sub-facade is nested here.
+ *
+ * Read-models project the raw glasses store into the stable shape OEM UIs consume,
+ * so the device store's field layout doesn't leak into every screen.
+ */
+import BluetoothSdk from "@glassly/bluetooth-sdk/internal";
+import type { ButtonPressEvent, TouchEvent } from "@glassly/bluetooth-sdk/internal";
+declare function projectStatus(): {
+    state: "connecting" | "connected" | "disconnected" | "scanning" | "bonding";
+    fullyBooted: boolean;
+    battery: number;
+    charging: boolean;
+    case: {
+        battery: number;
+        charging: boolean;
+        open: boolean;
+        removed: boolean;
+    };
+    signal: number;
+    micEnabled: boolean;
+    vadEnabled: boolean;
+    btClassic: boolean;
+};
+declare function projectControllerStatus(): {
+    connected: boolean;
+    fullyBooted: boolean;
+    battery: number;
+    signal: number;
+};
+declare function projectInfo(): {
+    model: string;
+    style: string;
+    color: string;
+    bluetoothName: string;
+    firmwareVersion: string;
+    mtkFirmware: string;
+    besFirmware: string;
+    appVersion: string;
+    androidVersion: string;
+    serialNumber: string;
+    buildNumber: string;
+    btMac: string;
+    wifiMac: string;
+    leftMac: string;
+    rightMac: string;
+    wifi: {
+        state: "disconnected";
+    } | {
+        state: "connected";
+        ssid: string;
+        localIp?: string;
+    };
+};
+export type GlassesStatusSnapshot = ReturnType<typeof projectStatus>;
+export type ControllerStatusSnapshot = ReturnType<typeof projectControllerStatus>;
+export type GlassesInfoSnapshot = ReturnType<typeof projectInfo>;
+export declare const glasses: {
+    /**
+     * Reconnect the default wearable. Seeds the phone's current device settings to
+     * native first, so they're primed before the connect handshake replays them to
+     * the glasses (this used to be a host-side step before `connectDefault`).
+     */
+    connectDefault: () => Promise<void>;
+    disconnect: () => Promise<void>;
+    forget: () => Promise<void>;
+    /** Connect to a specific (discovered) device. */
+    connect: (device: import("@glassly/bluetooth-sdk").Device, options?: import("@glassly/bluetooth-sdk").ConnectOptions | undefined) => Promise<void>;
+    /** Connect the built-in simulated glasses (dev/testing). */
+    connectSimulated: () => Promise<void>;
+    /** Set a device as the `connectDefault()` target. */
+    setDefault: (device: import("@glassly/bluetooth-sdk").Device | null) => Promise<void>;
+    /**
+     * Reconnect to the saved default glasses. Resolves `false` when there's nothing to
+     * reconnect to (no default paired) or the connect attempt fails (e.g. BLE powered
+     * off), `true` when already connected or after kicking off the connect. Never
+     * rejects — the boolean contract holds. The host gates connectivity/permissions
+     * (its UI) before calling.
+     */
+    reconnect: () => Promise<boolean>;
+    /** True when no glasses has ever been paired NOR selected (the pairing-identity
+     * lifecycle is in its `none` state) — e.g. to route a first-run host into the
+     * pairing/onboarding flow. A pending selection is not "first" — the host should
+     * offer finish-pairing (see `engine.pairing.identity()`). */
+    isFirstPairing: () => boolean;
+    /**
+     * True when the SDK has an actual default DEVICE to reconnect to. Distinct from
+     * `default_wearable` (a model string that a pending or orphaned selection can
+     * hold without any paired device): connectDefault() throws without a device, so
+     * hosts should route to the pairing flow when this is false.
+     *
+     * Hydration-aware: awaits the device-store seed internally, so a cold-start
+     * read can't see a false "absent" for genuinely-paired users. Rejects if
+     * hydration failed — callers guarding destructive or routing decisions must
+     * fail open (treat as "has a device").
+     */
+    hasDefaultDevice: () => Promise<boolean>;
+    status: () => GlassesStatusSnapshot;
+    onStatus: (cb: (status: GlassesStatusSnapshot) => void) => (() => void);
+    info: () => GlassesInfoSnapshot;
+    onInfo: (cb: (info: GlassesInfoSnapshot) => void) => (() => void);
+    capabilities: () => import("..").Capabilities;
+    /** Ask the glasses to report fresh firmware/version info (updates the store). */
+    requestVersionInfo: () => Promise<import("@glassly/bluetooth-sdk").VersionInfoResult>;
+    onButtonPress: (cb: (event: ButtonPressEvent) => void) => (() => void);
+    onTouchGesture: (cb: (event: TouchEvent) => void) => (() => void);
+    controller: {
+        connectDefault: () => Promise<void>;
+        disconnect: () => Promise<void>;
+        forget: () => Promise<void>;
+        status: () => ControllerStatusSnapshot;
+        onStatus: (cb: (status: ControllerStatusSnapshot) => void) => (() => void);
+    };
+    audio: {
+        /** Read the glasses' current media volume. */
+        getMediaVolume: () => Promise<import("@glassly/bluetooth-sdk").GlassesMediaVolumeGetResult>;
+        /** Set the glasses' media volume. */
+        setMediaVolume: (level: number) => Promise<import("@glassly/bluetooth-sdk").GlassesMediaVolumeSetResult>;
+        /** Tell native whether THIS app is currently playing audio (for ducking). */
+        setOwnAppPlaying: (playing: boolean) => Promise<void>;
+    };
+    wifi: {
+        scan(): Promise<import("@glassly/bluetooth-sdk").WifiSearchResult[]>;
+        onScanResult(cb: (networks: import("@glassly/bluetooth-sdk").WifiSearchResult[]) => void): () => void;
+        connect(ssid: string, password: string): Promise<void>;
+        forget(ssid: string): Promise<void>;
+        status(): import("@glassly/bluetooth-sdk").WifiStatus;
+        onStatus(cb: (status: import("@glassly/bluetooth-sdk").WifiStatus, previous: import("@glassly/bluetooth-sdk").WifiStatus) => void): () => void;
+    };
+    settings: {
+        get: <T = unknown>(key: string) => T | undefined;
+        set: <T = unknown>(key: string, value: T) => import("typesafe-ts").AsyncResult<void, Error>;
+        onChanged: <T = unknown>(key: string, cb: (value: T | undefined) => void) => (() => void);
+        descriptor: (key: string) => import("../stores/settings").Setting;
+        available: () => string[];
+    };
+};
+export {};
+//# sourceMappingURL=glasses.d.ts.map

package/build/facades/glasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glasses.d.ts","sourceRoot":"","sources":["../../src/facades/glasses.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,YAAY,MAAM,iCAAiC,CAAA;AAC1D,OAAO,KAAK,EAAC,gBAAgB,EAAE,UAAU,EAAC,MAAM,iCAAiC,CAAA;AAYjF,iBAAS,aAAa;;;;;;;;;;;;;;;EAarB;AAED,iBAAS,uBAAuB;;;;;EAQ/B;AAED,iBAAS,WAAW;;;;;;;;;;;;;;;;;;;;;;;EAqBnB;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;AACpE,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;AACjF,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;AAEhE,eAAO,MAAM,OAAO;IAElB;;;;OAIG;0BACuB,OAAO,CAAC,IAAI,CAAC;sBASvB,OAAO,CAAC,IAAI,CAAC;kBACjB,OAAO,CAAC,IAAI,CAAC;IACzB,iDAAiD;yIACkB,OAAO,CAAC,IAAI,CAAC;IAShF,4DAA4D;4BACtC,OAAO,CAAC,IAAI,CAAC;IACnC,qDAAqD;;IAErD;;;;;;OAMG;qBACkB,OAAO,CAAC,OAAO,CAAC;IAcrC;;;iEAG6D;0BACzC,OAAO;IAC3B;;;;;;;;;;OAUG;4BACmB,OAAO,CAAC,OAAO,CAAC;kBAG1B,qBAAqB;mBAClB,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;gBAY3D,mBAAmB;iBAChB,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;IAW/D,iFAAiF;;wBAI7D,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;yBAI/C,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;8BAOzC,OAAO,CAAC,IAAI,CAAC;0BACjB,OAAO,CAAC,IAAI,CAAC;sBACjB,OAAO,CAAC,IAAI,CAAC;sBACb,wBAAwB;uBACrB,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;;QAcxE,8CAA8C;;QAE9C,qCAAqC;gCACb,MAAM;QAC9B,6EAA6E;oCACjD,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;CAMtD,CAAA"}

package/build/facades/glasses.js

@@ -0,0 +1,214 @@
+/**
+ * glasses facade — the core `engine.glasses.*` surface: connection actions (over
+ * the bluetooth-sdk passthrough), a curated status/info read-model (projected from
+ * the engine-owned glasses store), capabilities (from the model table), and the
+ * discrete input events. The `wifi` sub-facade is nested here.
+ *
+ * Read-models project the raw glasses store into the stable shape OEM UIs consume,
+ * so the device store's field layout doesn't leak into every screen.
+ */
+// Internal btsdk surface — connectSimulated/reconnect/controller live on the full
+// surface, not the public entry. Relative path (the alias doesn't resolve in engine's
+// standalone build); jest moduleNameMapper + tsconfig both resolve it.
+import BluetoothSdk from "@glassly/bluetooth-sdk/internal";
+import { useGlassesStore } from "../stores/glasses";
+import { useSettingsStore, SETTINGS } from "../stores/settings";
+import { hasDefaultDevice } from "../services/DeviceStoreHydration";
+import { projectPairingIdentity } from "../services/PairingIdentity";
+import { isGlassesConnected, isGlassesReady } from "../services/GlassesReadiness";
+import { pushAllBluetoothSettings } from "../services/GlassesSettingsSync";
+import { recordSupportProfileConnectionFailure } from "../services/SupportProfileSync";
+import { getModelCapabilities } from "../types";
+import { glassesWifi } from "./glassesWifi";
+import { glassesSettings } from "./glassesSettings";
+function projectStatus() {
+    const s = useGlassesStore.getState();
+    return {
+        state: s.connection.state,
+        fullyBooted: isGlassesReady(s.connection),
+        battery: s.batteryLevel,
+        charging: s.charging,
+        case: { battery: s.caseBatteryLevel, charging: s.caseCharging, open: s.caseOpen, removed: s.caseRemoved },
+        signal: s.signalStrength,
+        micEnabled: s.micEnabled,
+        vadEnabled: s.voiceActivityDetectionEnabled,
+        btClassic: s.bluetoothClassicConnected,
+    };
+}
+function projectControllerStatus() {
+    const s = useGlassesStore.getState();
+    return {
+        connected: s.controllerConnected,
+        fullyBooted: s.controllerFullyBooted,
+        battery: s.controllerBatteryLevel,
+        signal: s.controllerSignalStrength,
+    };
+}
+function projectInfo() {
+    const s = useGlassesStore.getState();
+    return {
+        model: s.deviceModel,
+        style: s.style,
+        color: s.color,
+        bluetoothName: s.bluetoothName,
+        firmwareVersion: s.firmwareVersion,
+        mtkFirmware: s.mtkFirmwareVersion,
+        besFirmware: s.besFirmwareVersion,
+        appVersion: s.appVersion,
+        androidVersion: s.androidVersion,
+        serialNumber: s.serialNumber,
+        buildNumber: s.buildNumber,
+        btMac: s.bluetoothMacAddress,
+        wifiMac: s.wifiMacAddress,
+        leftMac: s.leftMacAddress,
+        rightMac: s.rightMacAddress,
+        // Copy: the snapshot must not hand callers a mutable reference into the store.
+        wifi: { ...s.wifi },
+    };
+}
+export const glasses = {
+    // --- connection (bluetooth-sdk passthrough) ---
+    /**
+     * Reconnect the default wearable. Seeds the phone's current device settings to
+     * native first, so they're primed before the connect handshake replays them to
+     * the glasses (this used to be a host-side step before `connectDefault`).
+     */
+    connectDefault: async () => {
+        try {
+            await pushAllBluetoothSettings();
+            await BluetoothSdk.connectDefault();
+        }
+        catch (error) {
+            recordSupportProfileConnectionFailure(error, "connect_default");
+            throw error;
+        }
+    },
+    disconnect: () => BluetoothSdk.disconnect(),
+    forget: () => BluetoothSdk.forget(),
+    /** Connect to a specific (discovered) device. */
+    connect: async (...args) => {
+        try {
+            await pushAllBluetoothSettings();
+            await BluetoothSdk.connect(...args);
+        }
+        catch (error) {
+            recordSupportProfileConnectionFailure(error, "connect");
+            throw error;
+        }
+    },
+    /** Connect the built-in simulated glasses (dev/testing). */
+    connectSimulated: () => BluetoothSdk.connectSimulated(),
+    /** Set a device as the `connectDefault()` target. */
+    setDefault: (...args) => BluetoothSdk.setDefaultDevice(...args),
+    /**
+     * Reconnect to the saved default glasses. Resolves `false` when there's nothing to
+     * reconnect to (no default paired) or the connect attempt fails (e.g. BLE powered
+     * off), `true` when already connected or after kicking off the connect. Never
+     * rejects — the boolean contract holds. The host gates connectivity/permissions
+     * (its UI) before calling.
+     */
+    reconnect: async () => {
+        const defaultWearable = useSettingsStore.getState().getSetting(SETTINGS.default_wearable.key);
+        if (!defaultWearable)
+            return false;
+        if (isGlassesConnected(useGlassesStore.getState().connection))
+            return true;
+        try {
+            await pushAllBluetoothSettings();
+            await BluetoothSdk.connectDefault();
+        }
+        catch (error) {
+            recordSupportProfileConnectionFailure(error, "reconnect");
+            console.warn("engine.glasses.reconnect failed:", error);
+            return false;
+        }
+        return true;
+    },
+    /** True when no glasses has ever been paired NOR selected (the pairing-identity
+     * lifecycle is in its `none` state) — e.g. to route a first-run host into the
+     * pairing/onboarding flow. A pending selection is not "first" — the host should
+     * offer finish-pairing (see `engine.pairing.identity()`). */
+    isFirstPairing: () => projectPairingIdentity().kind === "none",
+    /**
+     * True when the SDK has an actual default DEVICE to reconnect to. Distinct from
+     * `default_wearable` (a model string that a pending or orphaned selection can
+     * hold without any paired device): connectDefault() throws without a device, so
+     * hosts should route to the pairing flow when this is false.
+     *
+     * Hydration-aware: awaits the device-store seed internally, so a cold-start
+     * read can't see a false "absent" for genuinely-paired users. Rejects if
+     * hydration failed — callers guarding destructive or routing decisions must
+     * fail open (treat as "has a device").
+     */
+    hasDefaultDevice: () => hasDefaultDevice(),
+    // --- read-model (projected from the engine-owned glasses store) ---
+    status: () => projectStatus(),
+    onStatus: (cb) => {
+        // Dedupe: the glasses store updates on many fields; only fire when the
+        // projected status snapshot actually changes.
+        let last = JSON.stringify(projectStatus());
+        return useGlassesStore.subscribe(() => {
+            const snap = projectStatus();
+            const key = JSON.stringify(snap);
+            if (key === last)
+                return;
+            last = key;
+            cb(snap);
+        });
+    },
+    info: () => projectInfo(),
+    onInfo: (cb) => {
+        let last = JSON.stringify(projectInfo());
+        return useGlassesStore.subscribe(() => {
+            const snap = projectInfo();
+            const key = JSON.stringify(snap);
+            if (key === last)
+                return;
+            last = key;
+            cb(snap);
+        });
+    },
+    capabilities: () => getModelCapabilities(useGlassesStore.getState().deviceModel),
+    /** Ask the glasses to report fresh firmware/version info (updates the store). */
+    requestVersionInfo: () => BluetoothSdk.requestVersionInfo(),
+    // --- discrete input events (passthrough listeners) ---
+    onButtonPress: (cb) => {
+        const sub = BluetoothSdk.addListener("button_press", cb);
+        return () => sub.remove();
+    },
+    onTouchGesture: (cb) => {
+        const sub = BluetoothSdk.addListener("touch_event", cb);
+        return () => sub.remove();
+    },
+    // --- ring controller (optional input device) ---
+    controller: {
+        connectDefault: () => BluetoothSdk.connectDefaultController(),
+        disconnect: () => BluetoothSdk.disconnectController(),
+        forget: () => BluetoothSdk.forgetController(),
+        status: () => projectControllerStatus(),
+        onStatus: (cb) => {
+            let last = JSON.stringify(projectControllerStatus());
+            return useGlassesStore.subscribe(() => {
+                const snap = projectControllerStatus();
+                const key = JSON.stringify(snap);
+                if (key === last)
+                    return;
+                last = key;
+                cb(snap);
+            });
+        },
+    },
+    // --- audio (glasses media-volume + own-app playback hint) ---
+    audio: {
+        /** Read the glasses' current media volume. */
+        getMediaVolume: () => BluetoothSdk.getGlassesMediaVolume(),
+        /** Set the glasses' media volume. */
+        setMediaVolume: (level) => BluetoothSdk.setGlassesMediaVolume(level),
+        /** Tell native whether THIS app is currently playing audio (for ducking). */
+        setOwnAppPlaying: (playing) => BluetoothSdk.setOwnAppAudioPlaying(playing),
+    },
+    // --- sub-facades ---
+    wifi: glassesWifi,
+    settings: glassesSettings,
+};
+//# sourceMappingURL=glasses.js.map

package/build/facades/glasses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glasses.js","sourceRoot":"","sources":["../../src/facades/glasses.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * glasses facade — the core `engine.glasses.*` surface: connection actions (over\n * the bluetooth-sdk passthrough), a curated status/info read-model (projected from\n * the engine-owned glasses store), capabilities (from the model table), and the\n * discrete input events. The `wifi` sub-facade is nested here.\n *\n * Read-models project the raw glasses store into the stable shape OEM UIs consume,\n * so the device store's field layout doesn't leak into every screen.\n */\n// Internal btsdk surface — connectSimulated/reconnect/controller live on the full\n// surface, not the public entry. Relative path (the alias doesn't resolve in engine's\n// standalone build); jest moduleNameMapper + tsconfig both resolve it.\nimport BluetoothSdk from \"@glassly/bluetooth-sdk/internal\"\nimport type {ButtonPressEvent, TouchEvent} from \"@glassly/bluetooth-sdk/internal\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {useSettingsStore, SETTINGS} from \"../stores/settings\"\nimport {hasDefaultDevice} from \"../services/DeviceStoreHydration\"\nimport {projectPairingIdentity} from \"../services/PairingIdentity\"\nimport {isGlassesConnected, isGlassesReady} from \"../services/GlassesReadiness\"\nimport {pushAllBluetoothSettings} from \"../services/GlassesSettingsSync\"\nimport {recordSupportProfileConnectionFailure} from \"../services/SupportProfileSync\"\nimport {getModelCapabilities, type DeviceTypes} from \"../types\"\nimport {glassesWifi} from \"./glassesWifi\"\nimport {glassesSettings} from \"./glassesSettings\"\n\nfunction projectStatus() {\n  const s = useGlassesStore.getState()\n  return {\n    state: s.connection.state,\n    fullyBooted: isGlassesReady(s.connection),\n    battery: s.batteryLevel,\n    charging: s.charging,\n    case: {battery: s.caseBatteryLevel, charging: s.caseCharging, open: s.caseOpen, removed: s.caseRemoved},\n    signal: s.signalStrength,\n    micEnabled: s.micEnabled,\n    vadEnabled: s.voiceActivityDetectionEnabled,\n    btClassic: s.bluetoothClassicConnected,\n  }\n}\n\nfunction projectControllerStatus() {\n  const s = useGlassesStore.getState()\n  return {\n    connected: s.controllerConnected,\n    fullyBooted: s.controllerFullyBooted,\n    battery: s.controllerBatteryLevel,\n    signal: s.controllerSignalStrength,\n  }\n}\n\nfunction projectInfo() {\n  const s = useGlassesStore.getState()\n  return {\n    model: s.deviceModel,\n    style: s.style,\n    color: s.color,\n    bluetoothName: s.bluetoothName,\n    firmwareVersion: s.firmwareVersion,\n    mtkFirmware: s.mtkFirmwareVersion,\n    besFirmware: s.besFirmwareVersion,\n    appVersion: s.appVersion,\n    androidVersion: s.androidVersion,\n    serialNumber: s.serialNumber,\n    buildNumber: s.buildNumber,\n    btMac: s.bluetoothMacAddress,\n    wifiMac: s.wifiMacAddress,\n    leftMac: s.leftMacAddress,\n    rightMac: s.rightMacAddress,\n    // Copy: the snapshot must not hand callers a mutable reference into the store.\n    wifi: {...s.wifi},\n  }\n}\n\nexport type GlassesStatusSnapshot = ReturnType<typeof projectStatus>\nexport type ControllerStatusSnapshot = ReturnType<typeof projectControllerStatus>\nexport type GlassesInfoSnapshot = ReturnType<typeof projectInfo>\n\nexport const glasses = {\n  // --- connection (bluetooth-sdk passthrough) ---\n  /**\n   * Reconnect the default wearable. Seeds the phone's current device settings to\n   * native first, so they're primed before the connect handshake replays them to\n   * the glasses (this used to be a host-side step before `connectDefault`).\n   */\n  connectDefault: async (): Promise<void> => {\n    try {\n      await pushAllBluetoothSettings()\n      await BluetoothSdk.connectDefault()\n    } catch (error) {\n      recordSupportProfileConnectionFailure(error, \"connect_default\")\n      throw error\n    }\n  },\n  disconnect: (): Promise<void> => BluetoothSdk.disconnect(),\n  forget: (): Promise<void> => BluetoothSdk.forget(),\n  /** Connect to a specific (discovered) device. */\n  connect: async (...args: Parameters<typeof BluetoothSdk.connect>): Promise<void> => {\n    try {\n      await pushAllBluetoothSettings()\n      await BluetoothSdk.connect(...args)\n    } catch (error) {\n      recordSupportProfileConnectionFailure(error, \"connect\")\n      throw error\n    }\n  },\n  /** Connect the built-in simulated glasses (dev/testing). */\n  connectSimulated: (): Promise<void> => BluetoothSdk.connectSimulated(),\n  /** Set a device as the `connectDefault()` target. */\n  setDefault: (...args: Parameters<typeof BluetoothSdk.setDefaultDevice>) => BluetoothSdk.setDefaultDevice(...args),\n  /**\n   * Reconnect to the saved default glasses. Resolves `false` when there's nothing to\n   * reconnect to (no default paired) or the connect attempt fails (e.g. BLE powered\n   * off), `true` when already connected or after kicking off the connect. Never\n   * rejects — the boolean contract holds. The host gates connectivity/permissions\n   * (its UI) before calling.\n   */\n  reconnect: async (): Promise<boolean> => {\n    const defaultWearable = useSettingsStore.getState().getSetting(SETTINGS.default_wearable.key)\n    if (!defaultWearable) return false\n    if (isGlassesConnected(useGlassesStore.getState().connection)) return true\n    try {\n      await pushAllBluetoothSettings()\n      await BluetoothSdk.connectDefault()\n    } catch (error) {\n      recordSupportProfileConnectionFailure(error, \"reconnect\")\n      console.warn(\"engine.glasses.reconnect failed:\", error)\n      return false\n    }\n    return true\n  },\n  /** True when no glasses has ever been paired NOR selected (the pairing-identity\n   * lifecycle is in its `none` state) — e.g. to route a first-run host into the\n   * pairing/onboarding flow. A pending selection is not \"first\" — the host should\n   * offer finish-pairing (see `engine.pairing.identity()`). */\n  isFirstPairing: (): boolean => projectPairingIdentity().kind === \"none\",\n  /**\n   * True when the SDK has an actual default DEVICE to reconnect to. Distinct from\n   * `default_wearable` (a model string that a pending or orphaned selection can\n   * hold without any paired device): connectDefault() throws without a device, so\n   * hosts should route to the pairing flow when this is false.\n   *\n   * Hydration-aware: awaits the device-store seed internally, so a cold-start\n   * read can't see a false \"absent\" for genuinely-paired users. Rejects if\n   * hydration failed — callers guarding destructive or routing decisions must\n   * fail open (treat as \"has a device\").\n   */\n  hasDefaultDevice: (): Promise<boolean> => hasDefaultDevice(),\n\n  // --- read-model (projected from the engine-owned glasses store) ---\n  status: (): GlassesStatusSnapshot => projectStatus(),\n  onStatus: (cb: (status: GlassesStatusSnapshot) => void): (() => void) => {\n    // Dedupe: the glasses store updates on many fields; only fire when the\n    // projected status snapshot actually changes.\n    let last = JSON.stringify(projectStatus())\n    return useGlassesStore.subscribe(() => {\n      const snap = projectStatus()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    })\n  },\n  info: (): GlassesInfoSnapshot => projectInfo(),\n  onInfo: (cb: (info: GlassesInfoSnapshot) => void): (() => void) => {\n    let last = JSON.stringify(projectInfo())\n    return useGlassesStore.subscribe(() => {\n      const snap = projectInfo()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    })\n  },\n  capabilities: () => getModelCapabilities(useGlassesStore.getState().deviceModel as DeviceTypes),\n  /** Ask the glasses to report fresh firmware/version info (updates the store). */\n  requestVersionInfo: () => BluetoothSdk.requestVersionInfo(),\n\n  // --- discrete input events (passthrough listeners) ---\n  onButtonPress: (cb: (event: ButtonPressEvent) => void): (() => void) => {\n    const sub = BluetoothSdk.addListener(\"button_press\", cb)\n    return () => sub.remove()\n  },\n  onTouchGesture: (cb: (event: TouchEvent) => void): (() => void) => {\n    const sub = BluetoothSdk.addListener(\"touch_event\", cb)\n    return () => sub.remove()\n  },\n\n  // --- ring controller (optional input device) ---\n  controller: {\n    connectDefault: (): Promise<void> => BluetoothSdk.connectDefaultController(),\n    disconnect: (): Promise<void> => BluetoothSdk.disconnectController(),\n    forget: (): Promise<void> => BluetoothSdk.forgetController(),\n    status: (): ControllerStatusSnapshot => projectControllerStatus(),\n    onStatus: (cb: (status: ControllerStatusSnapshot) => void): (() => void) => {\n      let last = JSON.stringify(projectControllerStatus())\n      return useGlassesStore.subscribe(() => {\n        const snap = projectControllerStatus()\n        const key = JSON.stringify(snap)\n        if (key === last) return\n        last = key\n        cb(snap)\n      })\n    },\n  },\n\n  // --- audio (glasses media-volume + own-app playback hint) ---\n  audio: {\n    /** Read the glasses' current media volume. */\n    getMediaVolume: () => BluetoothSdk.getGlassesMediaVolume(),\n    /** Set the glasses' media volume. */\n    setMediaVolume: (level: number) => BluetoothSdk.setGlassesMediaVolume(level),\n    /** Tell native whether THIS app is currently playing audio (for ducking). */\n    setOwnAppPlaying: (playing: boolean): Promise<void> => BluetoothSdk.setOwnAppAudioPlaying(playing),\n  },\n\n  // --- sub-facades ---\n  wifi: glassesWifi,\n  settings: glassesSettings,\n}\n"]}

package/build/facades/glassesSettings.d.ts

@@ -0,0 +1,13 @@
+export declare const glassesSettings: {
+    /** Read a device setting by key (object/array values are shallow copies). */
+    get: <T = unknown>(key: string) => T | undefined;
+    /** Write a device setting — persists and auto-syncs to the connected glasses. */
+    set: <T = unknown>(key: string, value: T) => import("typesafe-ts").AsyncResult<void, Error>;
+    /** Subscribe to changes for one device-setting key; returns an unsubscribe. */
+    onChanged: <T = unknown>(key: string, cb: (value: T | undefined) => void) => (() => void);
+    /** The schema descriptor for a key (type, default, options…), or undefined. */
+    descriptor: (key: string) => import("../stores/settings").Setting;
+    /** The device-setting keys synced to the glasses (excludes internal sync keys). */
+    available: () => string[];
+};
+//# sourceMappingURL=glassesSettings.d.ts.map

package/build/facades/glassesSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glassesSettings.d.ts","sourceRoot":"","sources":["../../src/facades/glassesSettings.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,eAAe;IAC1B,6EAA6E;UACvE,CAAC,iBAAiB,MAAM,KAAG,CAAC,GAAG,SAAS;IAE9C,iFAAiF;UAC3E,CAAC,iBAAiB,MAAM,SAAS,CAAC;IACxC,+EAA+E;gBACnE,CAAC,iBAAiB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAEvF,+EAA+E;sBAC7D,MAAM;IACxB,mFAAmF;qBAEpE,MAAM,EAAE;CACxB,CAAA"}

package/build/facades/glassesSettings.js

@@ -0,0 +1,55 @@
+/**
+ * glasses.settings facade — `engine.glasses.settings`: the keyed DEVICE-settings
+ * surface (brightness, head-up angle, dashboard, camera/button, sensing, …). These
+ * are the settings the engine store auto-syncs to the glasses over the bluetooth-sdk
+ * (`BLUETOOTH_SETTING_KEYS`), so `set()` both persists and pushes to the device.
+ *
+ * Distinct from `engine.settings` (user/app prefs): this is scoped to the
+ * hardware-facing keys, minus the internal sync keys (auth/token) that aren't
+ * user-tunable device settings.
+ */
+import { useSettingsStore, SETTINGS, BLUETOOTH_SETTING_KEYS } from "../stores/settings";
+// Keys carried on BLUETOOTH_SETTING_KEYS for the device handshake that are NOT
+// user-tunable settings — auth, device/controller IDENTITY (set by pairing), and
+// internal RUNTIME flags. Kept out of the OEM-facing `available()` surface.
+const INTERNAL_KEYS = new Set([
+    // auth
+    SETTINGS.core_token.key,
+    SETTINGS.auth_email.key,
+    // glasses + controller identity (managed by pairing, not the user)
+    SETTINGS.pending_wearable.key,
+    SETTINGS.default_wearable.key,
+    SETTINGS.device_name.key,
+    SETTINGS.device_address.key,
+    SETTINGS.project_name.key,
+    SETTINGS.pending_controller.key,
+    SETTINGS.default_controller.key,
+    SETTINGS.controller_device_name.key,
+    SETTINGS.controller_address.key,
+    // internal runtime flags
+    SETTINGS.local_stt_fallback_active.key,
+]);
+const DEVICE_KEYS = BLUETOOTH_SETTING_KEYS.filter((k) => !INTERNAL_KEYS.has(k));
+// Copy: object/array-valued settings must not hand callers a mutable reference
+// into the store (mutations would bypass persistence + Bluetooth sync).
+function copySettingValue(value) {
+    if (Array.isArray(value))
+        return [...value];
+    if (value && typeof value === "object")
+        return { ...value };
+    return value;
+}
+export const glassesSettings = {
+    /** Read a device setting by key (object/array values are shallow copies). */
+    get: (key) => copySettingValue(useSettingsStore.getState().getSetting(key)),
+    /** Write a device setting — persists and auto-syncs to the connected glasses. */
+    set: (key, value) => useSettingsStore.getState().setSetting(key, value),
+    /** Subscribe to changes for one device-setting key; returns an unsubscribe. */
+    onChanged: (key, cb) => useSettingsStore.subscribe((s) => s.getSetting(key), cb),
+    /** The schema descriptor for a key (type, default, options…), or undefined. */
+    descriptor: (key) => SETTINGS[key],
+    /** The device-setting keys synced to the glasses (excludes internal sync keys). */
+    // Copy: callers must not be able to mutate the module-level key list.
+    available: () => [...DEVICE_KEYS],
+};
+//# sourceMappingURL=glassesSettings.js.map