@mentra/engine 0.1.0-dev.0 → 3.1.0-dev.10

package/build/utils/miniappDiagnostics.d.ts

@@ -0,0 +1,64 @@
+import type { ClientApp } from "../types/applet";
+export interface MiniappManifestSnapshot {
+    packageName: string;
+    name?: string;
+    version?: string;
+    sdkVersion?: string;
+    minHostVersion?: string;
+    type?: string;
+    entry?: {
+        background?: string;
+        ui?: string;
+    };
+    permissions: Array<{
+        type: string;
+        required?: boolean;
+    }>;
+    hardwareRequirements: Array<{
+        type: string;
+        level: string;
+    }>;
+    actionIds: string[];
+}
+export interface MiniappRuntimeAppSnapshot {
+    packageName: string;
+    handshakeComplete: boolean;
+    subscriptions: string[];
+    lastMessageAgeMs: number;
+    requestedLocationRate: string | null;
+    hasActiveSpeakerStream: boolean;
+    manifest?: MiniappManifestSnapshot;
+}
+export interface MiniappRuntimeDiagnosticSnapshot {
+    connectedApps: MiniappRuntimeAppSnapshot[];
+    subscriptionsByStream: Record<string, string[]>;
+    resources: {
+        display: Record<string, unknown>;
+        camera: Record<string, unknown>;
+        video: Record<string, unknown>;
+        stream: Record<string, unknown>;
+        cameraFov: Record<string, unknown>;
+    };
+}
+type ManifestFallback = {
+    packageName: string;
+    name?: string;
+    version?: string;
+    type?: string;
+};
+/**
+ * Keep the routing/build fields from miniapp.json while excluding arbitrary
+ * free-form manifest content from reports. Descriptions, URLs, and unknown
+ * extension fields are intentionally omitted.
+ */
+export declare function buildMiniappManifestSnapshot(raw: unknown, fallback: ManifestFallback): MiniappManifestSnapshot;
+export declare function buildMiniappDiagnosticContext(input: {
+    apps: ClientApp[];
+    foregroundedPackage: string | null;
+    runtime: MiniappRuntimeDiagnosticSnapshot;
+    getLastOpenedAtMs: (app: ClientApp) => number;
+    getManifest: (app: ClientApp) => unknown;
+    getReleaseIdentity: (app: ClientApp) => unknown;
+}): Record<string, unknown>;
+export {};
+//# sourceMappingURL=miniappDiagnostics.d.ts.map

package/build/utils/miniappDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miniappDiagnostics.d.ts","sourceRoot":"","sources":["../../src/utils/miniappDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAA;AAM9C,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,EAAE,CAAC,EAAE,MAAM,CAAA;KACZ,CAAA;IACD,WAAW,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,CAAA;IACtD,oBAAoB,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;IAC1D,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,sBAAsB,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,EAAE,uBAAuB,CAAA;CACnC;AAED,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,yBAAyB,EAAE,CAAA;IAC1C,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/C,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,CAAA;CACF;AAED,KAAK,gBAAgB,GAAG;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAsDD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,GAAG,uBAAuB,CAsB9G;AAoBD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,IAAI,EAAE,SAAS,EAAE,CAAA;IACjB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE,gCAAgC,CAAA;IACzC,iBAAiB,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,MAAM,CAAA;IAC7C,WAAW,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAA;IACxC,kBAAkB,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAA;CAChD,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoE1B"}

package/build/utils/miniappDiagnostics.js

@@ -0,0 +1,173 @@
+const MAX_DIAGNOSTIC_STRING_LENGTH = 512;
+const MAX_DIAGNOSTIC_LIST_ITEMS = 100;
+const MAX_RECENT_MINIAPPS = 20;
+function boundedString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed.slice(0, MAX_DIAGNOSTIC_STRING_LENGTH);
+}
+function recordValue(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function diagnosticPermissions(value) {
+    if (!Array.isArray(value))
+        return [];
+    const permissions = [];
+    for (const raw of value) {
+        if (typeof raw === "string") {
+            const type = boundedString(raw);
+            if (type)
+                permissions.push({ type });
+            continue;
+        }
+        const permission = recordValue(raw);
+        const type = boundedString(permission?.type);
+        if (!type)
+            continue;
+        permissions.push({
+            type,
+            ...(typeof permission?.required === "boolean" ? { required: permission.required } : {}),
+        });
+    }
+    return permissions.slice(0, MAX_DIAGNOSTIC_LIST_ITEMS);
+}
+function diagnosticHardwareRequirements(value) {
+    if (!Array.isArray(value))
+        return [];
+    const requirements = [];
+    for (const raw of value) {
+        const requirement = recordValue(raw);
+        const type = boundedString(requirement?.type);
+        const level = boundedString(requirement?.level);
+        if (type && level)
+            requirements.push({ type, level });
+    }
+    return requirements.slice(0, MAX_DIAGNOSTIC_LIST_ITEMS);
+}
+function diagnosticActionIds(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .map((raw) => boundedString(typeof raw === "string" ? raw : recordValue(raw)?.id))
+        .filter((id) => id !== undefined)
+        .sort()
+        .slice(0, MAX_DIAGNOSTIC_LIST_ITEMS);
+}
+/**
+ * Keep the routing/build fields from miniapp.json while excluding arbitrary
+ * free-form manifest content from reports. Descriptions, URLs, and unknown
+ * extension fields are intentionally omitted.
+ */
+export function buildMiniappManifestSnapshot(raw, fallback) {
+    const manifest = recordValue(raw);
+    const entry = recordValue(manifest?.entry);
+    const packageName = boundedString(manifest?.packageName) ?? boundedString(fallback.packageName) ?? "unknown";
+    const name = boundedString(manifest?.name) ?? boundedString(fallback.name);
+    const version = boundedString(manifest?.version) ?? boundedString(fallback.version);
+    const type = boundedString(manifest?.type) ?? boundedString(fallback.type);
+    const background = boundedString(entry?.background);
+    const ui = boundedString(entry?.ui);
+    return {
+        packageName,
+        ...(name ? { name } : {}),
+        ...(version ? { version } : {}),
+        ...(boundedString(manifest?.sdkVersion) ? { sdkVersion: boundedString(manifest?.sdkVersion) } : {}),
+        ...(boundedString(manifest?.minHostVersion) ? { minHostVersion: boundedString(manifest?.minHostVersion) } : {}),
+        ...(type ? { type } : {}),
+        ...(background || ui ? { entry: { ...(background ? { background } : {}), ...(ui ? { ui } : {}) } } : {}),
+        permissions: diagnosticPermissions(manifest?.permissions),
+        hardwareRequirements: diagnosticHardwareRequirements(manifest?.hardwareRequirements),
+        actionIds: diagnosticActionIds(manifest?.actions ?? manifest?.actionIds),
+    };
+}
+function executionMode(app) {
+    if (app.offline)
+        return "built_in";
+    if (app.isMiniappDev && app.devUrl && !app.version)
+        return "dev_server";
+    if (app.isMiniappDev)
+        return "dev_snapshot";
+    return "installed_bundle";
+}
+function safeReleaseIdentity(value) {
+    const identity = recordValue(value);
+    if (!identity)
+        return undefined;
+    const out = {};
+    for (const key of ["source", "releaseId", "bundleSha256", "channel"]) {
+        const field = boundedString(identity[key]);
+        if (field)
+            out[key] = field;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+export function buildMiniappDiagnosticContext(input) {
+    const runtimeByPackage = new Map(input.runtime.connectedApps.map((app) => [app.packageName, app]));
+    const appSnapshots = input.apps.map((app) => {
+        const lastOpenedAtMs = input.getLastOpenedAtMs(app);
+        const packageName = boundedString(app.packageName) ?? "unknown";
+        return {
+            packageName,
+            name: boundedString(app.name) ?? packageName,
+            version: boundedString(app.version) ?? null,
+            executionMode: executionMode(app),
+            running: app.running,
+            foregrounded: app.packageName === input.foregroundedPackage,
+            loading: app.loading,
+            healthy: app.healthy,
+            hidden: app.hidden,
+            type: app.type,
+            offline: app.offline,
+            local: app.local,
+            lastOpenedAtMs: Number.isFinite(lastOpenedAtMs) ? lastOpenedAtMs : 0,
+        };
+    });
+    const recentlyInteracted = [...appSnapshots]
+        .filter((app) => app.lastOpenedAtMs > 0)
+        .sort((a, b) => b.lastOpenedAtMs - a.lastOpenedAtMs)
+        .slice(0, MAX_RECENT_MINIAPPS)
+        .map((app) => ({ packageName: app.packageName, lastOpenedAtMs: app.lastOpenedAtMs }));
+    const runningMiniapps = input.apps
+        .filter((app) => app.running)
+        .map((app) => {
+        const runtime = runtimeByPackage.get(app.packageName);
+        const releaseIdentity = safeReleaseIdentity(input.getReleaseIdentity(app));
+        const packageName = boundedString(app.packageName) ?? "unknown";
+        const manifest = buildMiniappManifestSnapshot(input.getManifest(app) ?? runtime?.manifest, {
+            packageName,
+            name: app.name,
+            version: app.version,
+            type: app.type,
+        });
+        return {
+            packageName,
+            version: boundedString(app.version) ?? manifest.version ?? null,
+            executionMode: executionMode(app),
+            foregrounded: app.packageName === input.foregroundedPackage,
+            manifest,
+            ...(releaseIdentity ? { releaseIdentity } : {}),
+            runtime: runtime
+                ? {
+                    handshakeComplete: runtime.handshakeComplete,
+                    subscriptions: runtime.subscriptions,
+                    lastMessageAgeMs: runtime.lastMessageAgeMs,
+                    requestedLocationRate: runtime.requestedLocationRate,
+                    hasActiveSpeakerStream: runtime.hasActiveSpeakerStream,
+                }
+                : null,
+        };
+    });
+    return {
+        apps: appSnapshots,
+        installed: appSnapshots.map((app) => app.packageName),
+        running: runningMiniapps.map((app) => app.packageName),
+        foregroundedPackage: boundedString(input.foregroundedPackage) ?? null,
+        mostRecentlyInteractedPackage: recentlyInteracted[0]?.packageName ?? null,
+        recentlyInteracted,
+        runningMiniapps,
+    };
+}
+//# sourceMappingURL=miniappDiagnostics.js.map

package/build/utils/miniappDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miniappDiagnostics.js","sourceRoot":"","sources":["../../src/utils/miniappDiagnostics.ts"],"names":[],"mappings":"AAEA,MAAM,4BAA4B,GAAG,GAAG,CAAA;AACxC,MAAM,yBAAyB,GAAG,GAAG,CAAA;AACrC,MAAM,mBAAmB,GAAG,EAAE,CAAA;AA+C9B,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAA;AACvD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,IAAI,CAAA;AAChH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACpC,MAAM,WAAW,GAA8C,EAAE,CAAA;IACjE,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;YAC/B,IAAI,IAAI;gBAAE,WAAW,CAAC,IAAI,CAAC,EAAC,IAAI,EAAC,CAAC,CAAA;YAClC,SAAQ;QACV,CAAC;QACD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;QACnC,MAAM,IAAI,GAAG,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,IAAI;YAAE,SAAQ;QACnB,WAAW,CAAC,IAAI,CAAC;YACf,IAAI;YACJ,GAAG,CAAC,OAAO,UAAU,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACtF,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAA;AACxD,CAAC;AAED,SAAS,8BAA8B,CAAC,KAAc;IACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACpC,MAAM,YAAY,GAAyC,EAAE,CAAA;IAC7D,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;QACpC,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;QAC7C,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;QAC/C,IAAI,IAAI,IAAI,KAAK;YAAE,YAAY,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,KAAK,EAAC,CAAC,CAAA;IACrD,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAA;AACzD,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACpC,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;SACjF,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC;SAC9C,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAA;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,GAAY,EAAE,QAA0B;IACnF,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC1C,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,SAAS,CAAA;IAC5G,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC1E,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IACnF,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC1E,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IACnD,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAEnC,OAAO;QACL,WAAW;QACX,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAC,IAAI,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAC,OAAO,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAC,UAAU,EAAE,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjG,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAC,cAAc,EAAE,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7G,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAC,IAAI,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,EAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAC,UAAU,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,EAAE,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAC,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,WAAW,EAAE,qBAAqB,CAAC,QAAQ,EAAE,WAAW,CAAC;QACzD,oBAAoB,EAAE,8BAA8B,CAAC,QAAQ,EAAE,oBAAoB,CAAC;QACpF,SAAS,EAAE,mBAAmB,CAAC,QAAQ,EAAE,OAAO,IAAI,QAAQ,EAAE,SAAS,CAAC;KACzE,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAAc;IACnC,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,UAAU,CAAA;IAClC,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO,YAAY,CAAA;IACvE,IAAI,GAAG,CAAC,YAAY;QAAE,OAAO,cAAc,CAAA;IAC3C,OAAO,kBAAkB,CAAA;AAC3B,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;IACnC,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC/B,MAAM,GAAG,GAA2B,EAAE,CAAA;IACtC,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,CAAU,EAAE,CAAC;QAC9E,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;QAC1C,IAAI,KAAK;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAO7C;IACC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IAClG,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1C,MAAM,cAAc,GAAG,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAA;QACnD,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,SAAS,CAAA;QAC/D,OAAO;YACL,WAAW;YACX,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW;YAC5C,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI;YAC3C,aAAa,EAAE,aAAa,CAAC,GAAG,CAAC;YACjC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,YAAY,EAAE,GAAG,CAAC,WAAW,KAAK,KAAK,CAAC,mBAAmB;YAC3D,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;SACrE,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,kBAAkB,GAAG,CAAC,GAAG,YAAY,CAAC;SACzC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC;SACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC;SACnD,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC;SAC7B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAC,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,EAAC,CAAC,CAAC,CAAA;IAErF,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI;SAC/B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;SAC5B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACrD,MAAM,eAAe,GAAG,mBAAmB,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAA;QAC1E,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,SAAS,CAAA;QAC/D,MAAM,QAAQ,GAAG,4BAA4B,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,QAAQ,EAAE;YACzF,WAAW;YACX,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC,CAAA;QACF,OAAO;YACL,WAAW;YACX,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI;YAC/D,aAAa,EAAE,aAAa,CAAC,GAAG,CAAC;YACjC,YAAY,EAAE,GAAG,CAAC,WAAW,KAAK,KAAK,CAAC,mBAAmB;YAC3D,QAAQ;YACR,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAC,eAAe,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC;oBACE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;oBAC5C,aAAa,EAAE,OAAO,CAAC,aAAa;oBACpC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;oBAC1C,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;oBACpD,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;iBACvD;gBACH,CAAC,CAAC,IAAI;SACT,CAAA;IACH,CAAC,CAAC,CAAA;IAEJ,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC;QACrD,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC;QACtD,mBAAmB,EAAE,aAAa,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,IAAI;QACrE,6BAA6B,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,IAAI;QACzE,kBAAkB;QAClB,eAAe;KAChB,CAAA;AACH,CAAC","sourcesContent":["import type {ClientApp} from \"../types/applet\"\n\nconst MAX_DIAGNOSTIC_STRING_LENGTH = 512\nconst MAX_DIAGNOSTIC_LIST_ITEMS = 100\nconst MAX_RECENT_MINIAPPS = 20\n\nexport interface MiniappManifestSnapshot {\n  packageName: string\n  name?: string\n  version?: string\n  sdkVersion?: string\n  minHostVersion?: string\n  type?: string\n  entry?: {\n    background?: string\n    ui?: string\n  }\n  permissions: Array<{type: string; required?: boolean}>\n  hardwareRequirements: Array<{type: string; level: string}>\n  actionIds: string[]\n}\n\nexport interface MiniappRuntimeAppSnapshot {\n  packageName: string\n  handshakeComplete: boolean\n  subscriptions: string[]\n  lastMessageAgeMs: number\n  requestedLocationRate: string | null\n  hasActiveSpeakerStream: boolean\n  manifest?: MiniappManifestSnapshot\n}\n\nexport interface MiniappRuntimeDiagnosticSnapshot {\n  connectedApps: MiniappRuntimeAppSnapshot[]\n  subscriptionsByStream: Record<string, string[]>\n  resources: {\n    display: Record<string, unknown>\n    camera: Record<string, unknown>\n    video: Record<string, unknown>\n    stream: Record<string, unknown>\n    cameraFov: Record<string, unknown>\n  }\n}\n\ntype ManifestFallback = {\n  packageName: string\n  name?: string\n  version?: string\n  type?: string\n}\n\nfunction boundedString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined\n  const trimmed = value.trim()\n  if (!trimmed) return undefined\n  return trimmed.slice(0, MAX_DIAGNOSTIC_STRING_LENGTH)\n}\n\nfunction recordValue(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === \"object\" && !Array.isArray(value) ? (value as Record<string, unknown>) : null\n}\n\nfunction diagnosticPermissions(value: unknown): Array<{type: string; required?: boolean}> {\n  if (!Array.isArray(value)) return []\n  const permissions: Array<{type: string; required?: boolean}> = []\n  for (const raw of value) {\n    if (typeof raw === \"string\") {\n      const type = boundedString(raw)\n      if (type) permissions.push({type})\n      continue\n    }\n    const permission = recordValue(raw)\n    const type = boundedString(permission?.type)\n    if (!type) continue\n    permissions.push({\n      type,\n      ...(typeof permission?.required === \"boolean\" ? {required: permission.required} : {}),\n    })\n  }\n  return permissions.slice(0, MAX_DIAGNOSTIC_LIST_ITEMS)\n}\n\nfunction diagnosticHardwareRequirements(value: unknown): Array<{type: string; level: string}> {\n  if (!Array.isArray(value)) return []\n  const requirements: Array<{type: string; level: string}> = []\n  for (const raw of value) {\n    const requirement = recordValue(raw)\n    const type = boundedString(requirement?.type)\n    const level = boundedString(requirement?.level)\n    if (type && level) requirements.push({type, level})\n  }\n  return requirements.slice(0, MAX_DIAGNOSTIC_LIST_ITEMS)\n}\n\nfunction diagnosticActionIds(value: unknown): string[] {\n  if (!Array.isArray(value)) return []\n  return value\n    .map((raw) => boundedString(typeof raw === \"string\" ? raw : recordValue(raw)?.id))\n    .filter((id): id is string => id !== undefined)\n    .sort()\n    .slice(0, MAX_DIAGNOSTIC_LIST_ITEMS)\n}\n\n/**\n * Keep the routing/build fields from miniapp.json while excluding arbitrary\n * free-form manifest content from reports. Descriptions, URLs, and unknown\n * extension fields are intentionally omitted.\n */\nexport function buildMiniappManifestSnapshot(raw: unknown, fallback: ManifestFallback): MiniappManifestSnapshot {\n  const manifest = recordValue(raw)\n  const entry = recordValue(manifest?.entry)\n  const packageName = boundedString(manifest?.packageName) ?? boundedString(fallback.packageName) ?? \"unknown\"\n  const name = boundedString(manifest?.name) ?? boundedString(fallback.name)\n  const version = boundedString(manifest?.version) ?? boundedString(fallback.version)\n  const type = boundedString(manifest?.type) ?? boundedString(fallback.type)\n  const background = boundedString(entry?.background)\n  const ui = boundedString(entry?.ui)\n\n  return {\n    packageName,\n    ...(name ? {name} : {}),\n    ...(version ? {version} : {}),\n    ...(boundedString(manifest?.sdkVersion) ? {sdkVersion: boundedString(manifest?.sdkVersion)} : {}),\n    ...(boundedString(manifest?.minHostVersion) ? {minHostVersion: boundedString(manifest?.minHostVersion)} : {}),\n    ...(type ? {type} : {}),\n    ...(background || ui ? {entry: {...(background ? {background} : {}), ...(ui ? {ui} : {})}} : {}),\n    permissions: diagnosticPermissions(manifest?.permissions),\n    hardwareRequirements: diagnosticHardwareRequirements(manifest?.hardwareRequirements),\n    actionIds: diagnosticActionIds(manifest?.actions ?? manifest?.actionIds),\n  }\n}\n\nfunction executionMode(app: ClientApp): \"built_in\" | \"dev_server\" | \"dev_snapshot\" | \"installed_bundle\" {\n  if (app.offline) return \"built_in\"\n  if (app.isMiniappDev && app.devUrl && !app.version) return \"dev_server\"\n  if (app.isMiniappDev) return \"dev_snapshot\"\n  return \"installed_bundle\"\n}\n\nfunction safeReleaseIdentity(value: unknown): Record<string, string> | undefined {\n  const identity = recordValue(value)\n  if (!identity) return undefined\n  const out: Record<string, string> = {}\n  for (const key of [\"source\", \"releaseId\", \"bundleSha256\", \"channel\"] as const) {\n    const field = boundedString(identity[key])\n    if (field) out[key] = field\n  }\n  return Object.keys(out).length > 0 ? out : undefined\n}\n\nexport function buildMiniappDiagnosticContext(input: {\n  apps: ClientApp[]\n  foregroundedPackage: string | null\n  runtime: MiniappRuntimeDiagnosticSnapshot\n  getLastOpenedAtMs: (app: ClientApp) => number\n  getManifest: (app: ClientApp) => unknown\n  getReleaseIdentity: (app: ClientApp) => unknown\n}): Record<string, unknown> {\n  const runtimeByPackage = new Map(input.runtime.connectedApps.map((app) => [app.packageName, app]))\n  const appSnapshots = input.apps.map((app) => {\n    const lastOpenedAtMs = input.getLastOpenedAtMs(app)\n    const packageName = boundedString(app.packageName) ?? \"unknown\"\n    return {\n      packageName,\n      name: boundedString(app.name) ?? packageName,\n      version: boundedString(app.version) ?? null,\n      executionMode: executionMode(app),\n      running: app.running,\n      foregrounded: app.packageName === input.foregroundedPackage,\n      loading: app.loading,\n      healthy: app.healthy,\n      hidden: app.hidden,\n      type: app.type,\n      offline: app.offline,\n      local: app.local,\n      lastOpenedAtMs: Number.isFinite(lastOpenedAtMs) ? lastOpenedAtMs : 0,\n    }\n  })\n\n  const recentlyInteracted = [...appSnapshots]\n    .filter((app) => app.lastOpenedAtMs > 0)\n    .sort((a, b) => b.lastOpenedAtMs - a.lastOpenedAtMs)\n    .slice(0, MAX_RECENT_MINIAPPS)\n    .map((app) => ({packageName: app.packageName, lastOpenedAtMs: app.lastOpenedAtMs}))\n\n  const runningMiniapps = input.apps\n    .filter((app) => app.running)\n    .map((app) => {\n      const runtime = runtimeByPackage.get(app.packageName)\n      const releaseIdentity = safeReleaseIdentity(input.getReleaseIdentity(app))\n      const packageName = boundedString(app.packageName) ?? \"unknown\"\n      const manifest = buildMiniappManifestSnapshot(input.getManifest(app) ?? runtime?.manifest, {\n        packageName,\n        name: app.name,\n        version: app.version,\n        type: app.type,\n      })\n      return {\n        packageName,\n        version: boundedString(app.version) ?? manifest.version ?? null,\n        executionMode: executionMode(app),\n        foregrounded: app.packageName === input.foregroundedPackage,\n        manifest,\n        ...(releaseIdentity ? {releaseIdentity} : {}),\n        runtime: runtime\n          ? {\n              handshakeComplete: runtime.handshakeComplete,\n              subscriptions: runtime.subscriptions,\n              lastMessageAgeMs: runtime.lastMessageAgeMs,\n              requestedLocationRate: runtime.requestedLocationRate,\n              hasActiveSpeakerStream: runtime.hasActiveSpeakerStream,\n            }\n          : null,\n      }\n    })\n\n  return {\n    apps: appSnapshots,\n    installed: appSnapshots.map((app) => app.packageName),\n    running: runningMiniapps.map((app) => app.packageName),\n    foregroundedPackage: boundedString(input.foregroundedPackage) ?? null,\n    mostRecentlyInteractedPackage: recentlyInteracted[0]?.packageName ?? null,\n    recentlyInteracted,\n    runningMiniapps,\n  }\n}\n"]}

package/build/utils/permissions/MediaLibraryPermissions.d.ts

@@ -1,3 +1,10 @@
+export interface MediaLibrarySaveReceipt {
+    success: boolean;
+    platform: "ios" | "android" | "unknown";
+    uri?: string;
+    identifier?: string;
+    error?: string;
+}
 /**
  * MediaLibraryPermissions - Handles save-only permissions for camera roll
  *
@@ -7,6 +14,8 @@
  * - Android 9-: Uses WRITE_EXTERNAL_STORAGE (legacy)
  */
 export declare class MediaLibraryPermissions {
+    /** Limited iOS access cannot see historical, unselected assets for duplicate reconciliation. */
+    static hasLimitedAccess(): Promise<boolean>;
     /**
      * Check if we have permission to save to the camera roll
      * Note: On Android 10+, this always returns true since no permission is needed
@@ -30,5 +39,7 @@ export declare class MediaLibraryPermissions {
      * @param creationTime - Optional creation/capture time in milliseconds (Unix timestamp)
      */
     static saveToLibrary(filePath: string, creationTime?: number): Promise<boolean>;
+    /** Save and return the durable MediaStore/PhotoKit identifier used as the export receipt. */
+    static saveToLibraryWithReceipt(filePath: string, creationTime?: number): Promise<MediaLibrarySaveReceipt>;
 }
 //# sourceMappingURL=MediaLibraryPermissions.d.ts.map

package/build/utils/permissions/MediaLibraryPermissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MediaLibraryPermissions.d.ts","sourceRoot":"","sources":["../../../src/utils/permissions/MediaLibraryPermissions.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAClC;;;OAGG;WACU,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAyBhD;;;OAGG;WACU,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAyBlD;;;;;;;;;;;OAWG;WACU,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CA2CtF"}
+{"version":3,"file":"MediaLibraryPermissions.d.ts","sourceRoot":"","sources":["../../../src/utils/permissions/MediaLibraryPermissions.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,CAAA;IACvC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAClC,gGAAgG;WACnF,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAWjD;;;OAGG;WACU,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAyBhD;;;OAGG;WACU,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAyBlD;;;;;;;;;;;OAWG;WACU,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrF,6FAA6F;WAChF,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAiDjH"}

package/build/utils/permissions/MediaLibraryPermissions.js

@@ -11,6 +11,19 @@ import { deriveGalleryDisplayName } from "./galleryDisplayName";
  * - Android 9-: Uses WRITE_EXTERNAL_STORAGE (legacy)
  */
 export class MediaLibraryPermissions {
+    /** Limited iOS access cannot see historical, unselected assets for duplicate reconciliation. */
+    static async hasLimitedAccess() {
+        if (Platform.OS !== "ios")
+            return false;
+        try {
+            return (await check(PERMISSIONS.IOS.PHOTO_LIBRARY)) === RESULTS.LIMITED;
+        }
+        catch (error) {
+            console.error("[MediaLibrary] Error checking limited-library access:", error);
+            // Conservatively block legacy reconciliation when the scope cannot be verified.
+            return true;
+        }
+    }
     /**
      * Check if we have permission to save to the camera roll
      * Note: On Android 10+, this always returns true since no permission is needed
@@ -78,6 +91,11 @@ export class MediaLibraryPermissions {
      * @param creationTime - Optional creation/capture time in milliseconds (Unix timestamp)
      */
     static async saveToLibrary(filePath, creationTime) {
+        return (await this.saveToLibraryWithReceipt(filePath, creationTime)).success;
+    }
+    /** Save and return the durable MediaStore/PhotoKit identifier used as the export receipt. */
+    static async saveToLibraryWithReceipt(filePath, creationTime) {
+        const platform = Platform.OS === "ios" || Platform.OS === "android" ? Platform.OS : "unknown";
         try {
             // On Android 10+, we can save without permission
             // On iOS and older Android, check permission first
@@ -88,7 +106,7 @@ export class MediaLibraryPermissions {
                     const granted = await this.requestPermission();
                     if (!granted) {
                         console.warn("[MediaLibrary] No permission to save to library - photos saved to app storage only");
-                        return false;
+                        return { success: false, platform, error: "permission denied" };
                     }
                 }
             }
@@ -106,16 +124,21 @@ export class MediaLibraryPermissions {
                 else {
                     console.log(`[MediaLibrary] Saved to camera roll: ${cleanPath}`);
                 }
-                return true;
+                return {
+                    success: true,
+                    platform,
+                    uri: result.uri,
+                    identifier: result.identifier,
+                };
             }
             else {
                 console.error(`[MediaLibrary] Failed to save to library: ${result.error}`);
-                return false;
+                return { success: false, platform, error: result.error || "native export failed" };
             }
         }
         catch (error) {
             console.error("[MediaLibrary] Error saving to library:", error);
-            return false;
+            return { success: false, platform, error: error instanceof Error ? error.message : String(error) };
         }
     }
 }

package/build/utils/permissions/MediaLibraryPermissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"MediaLibraryPermissions.js","sourceRoot":"","sources":["../../../src/utils/permissions/MediaLibraryPermissions.ts"],"names":[],"mappings":"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","sourcesContent":["import {Platform} from \"react-native\"\nimport {check, request, PERMISSIONS, RESULTS} from \"react-native-permissions\"\n\nimport CrustModule from \"@mentra/crust\"\n\nimport {deriveGalleryDisplayName} from \"./galleryDisplayName\"\n\n/**\n * MediaLibraryPermissions - Handles save-only permissions for camera roll\n *\n * Platform behavior:\n * - iOS: Uses PHOTO_LIBRARY (read-write) so we can manage the MentraOS album\n * - Android 10+ (API 29+): No permission needed to save your own files to MediaStore\n * - Android 9-: Uses WRITE_EXTERNAL_STORAGE (legacy)\n */\nexport class MediaLibraryPermissions {\n  /**\n   * Check if we have permission to save to the camera roll\n   * Note: On Android 10+, this always returns true since no permission is needed\n   */\n  static async checkPermission(): Promise<boolean> {\n    try {\n      if (Platform.OS === \"ios\") {\n        const status = await check(PERMISSIONS.IOS.PHOTO_LIBRARY)\n        return status === RESULTS.GRANTED || status === RESULTS.LIMITED\n      }\n\n      if (Platform.OS === \"android\") {\n        // Android 10+ (API 29+): No permission needed to save your own files\n        if (Platform.Version >= 29) {\n          return true\n        }\n        // Android 9 and below: Check legacy write permission\n        const status = await check(PERMISSIONS.ANDROID.WRITE_EXTERNAL_STORAGE)\n        return status === RESULTS.GRANTED\n      }\n\n      return false\n    } catch (error) {\n      console.error(\"[MediaLibrary] Error checking permission:\", error)\n      // On error, assume we can try (Android 10+ doesn't need permission anyway)\n      return Platform.OS === \"android\" && Platform.Version >= 29\n    }\n  }\n\n  /**\n   * Request permission to save to the camera roll\n   * Note: On Android 10+, this always returns true since no permission is needed\n   */\n  static async requestPermission(): Promise<boolean> {\n    try {\n      if (Platform.OS === \"ios\") {\n        const status = await request(PERMISSIONS.IOS.PHOTO_LIBRARY)\n        return status === RESULTS.GRANTED || status === RESULTS.LIMITED\n      }\n\n      if (Platform.OS === \"android\") {\n        // Android 10+ (API 29+): No permission needed to save your own files\n        if (Platform.Version >= 29) {\n          return true\n        }\n        // Android 9 and below: Request legacy write permission\n        const status = await request(PERMISSIONS.ANDROID.WRITE_EXTERNAL_STORAGE)\n        return status === RESULTS.GRANTED\n      }\n\n      return false\n    } catch (error) {\n      console.error(\"[MediaLibrary] Error requesting permission:\", error)\n      // On error, assume we can try (Android 10+ doesn't need permission anyway)\n      return Platform.OS === \"android\" && Platform.Version >= 29\n    }\n  }\n\n  /**\n   * Save a file to the photo library in a glasses-specific location (MentraOS album on iOS;\n   * Pictures/MentraOS or Movies/MentraOS on Android 10+).\n   * On Android 10+, this works without any permission.\n   *\n   * IMPORTANT: This method sets the DATE_TAKEN (Android) or creation date (iOS)\n   * metadata to the original capture time, so gallery apps show the correct date.\n   * Also saves files in chronological order for proper \"date added\" ordering.\n   *\n   * @param filePath - Path to the file to save\n   * @param creationTime - Optional creation/capture time in milliseconds (Unix timestamp)\n   */\n  static async saveToLibrary(filePath: string, creationTime?: number): Promise<boolean> {\n    try {\n      // On Android 10+, we can save without permission\n      // On iOS and older Android, check permission first\n      if (!(Platform.OS === \"android\" && Platform.Version >= 29)) {\n        const hasPermission = await this.checkPermission()\n        if (!hasPermission) {\n          // Try requesting permission one more time\n          const granted = await this.requestPermission()\n          if (!granted) {\n            console.warn(\"[MediaLibrary] No permission to save to library - photos saved to app storage only\")\n            return false\n          }\n        }\n      }\n\n      // Remove file:// prefix if present\n      const cleanPath = filePath.replace(\"file://\", \"\")\n      const displayName = deriveGalleryDisplayName(cleanPath)\n\n      // Use native module to save with proper DATE_TAKEN / creation date metadata\n      // This ensures gallery apps show the correct capture date, not the sync date\n      const result = await CrustModule.saveToGalleryWithDate(cleanPath, creationTime, displayName)\n\n      if (result.success) {\n        if (creationTime) {\n          const captureDate = new Date(creationTime)\n          console.log(\n            `[MediaLibrary] Saved to camera roll with DATE_TAKEN: ${cleanPath} (captured: ${captureDate.toISOString()})`,\n          )\n        } else {\n          console.log(`[MediaLibrary] Saved to camera roll: ${cleanPath}`)\n        }\n        return true\n      } else {\n        console.error(`[MediaLibrary] Failed to save to library: ${result.error}`)\n        return false\n      }\n    } catch (error) {\n      console.error(\"[MediaLibrary] Error saving to library:\", error)\n      return false\n    }\n  }\n}\n"]}
+{"version":3,"file":"MediaLibraryPermissions.js","sourceRoot":"","sources":["../../../src/utils/permissions/MediaLibraryPermissions.ts"],"names":[],"mappings":"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","sourcesContent":["import {Platform} from \"react-native\"\nimport {check, request, PERMISSIONS, RESULTS} from \"react-native-permissions\"\n\nimport CrustModule from \"@mentra/crust\"\n\nimport {deriveGalleryDisplayName} from \"./galleryDisplayName\"\n\nexport interface MediaLibrarySaveReceipt {\n  success: boolean\n  platform: \"ios\" | \"android\" | \"unknown\"\n  uri?: string\n  identifier?: string\n  error?: string\n}\n\n/**\n * MediaLibraryPermissions - Handles save-only permissions for camera roll\n *\n * Platform behavior:\n * - iOS: Uses PHOTO_LIBRARY (read-write) so we can manage the MentraOS album\n * - Android 10+ (API 29+): No permission needed to save your own files to MediaStore\n * - Android 9-: Uses WRITE_EXTERNAL_STORAGE (legacy)\n */\nexport class MediaLibraryPermissions {\n  /** Limited iOS access cannot see historical, unselected assets for duplicate reconciliation. */\n  static async hasLimitedAccess(): Promise<boolean> {\n    if (Platform.OS !== \"ios\") return false\n    try {\n      return (await check(PERMISSIONS.IOS.PHOTO_LIBRARY)) === RESULTS.LIMITED\n    } catch (error) {\n      console.error(\"[MediaLibrary] Error checking limited-library access:\", error)\n      // Conservatively block legacy reconciliation when the scope cannot be verified.\n      return true\n    }\n  }\n\n  /**\n   * Check if we have permission to save to the camera roll\n   * Note: On Android 10+, this always returns true since no permission is needed\n   */\n  static async checkPermission(): Promise<boolean> {\n    try {\n      if (Platform.OS === \"ios\") {\n        const status = await check(PERMISSIONS.IOS.PHOTO_LIBRARY)\n        return status === RESULTS.GRANTED || status === RESULTS.LIMITED\n      }\n\n      if (Platform.OS === \"android\") {\n        // Android 10+ (API 29+): No permission needed to save your own files\n        if (Platform.Version >= 29) {\n          return true\n        }\n        // Android 9 and below: Check legacy write permission\n        const status = await check(PERMISSIONS.ANDROID.WRITE_EXTERNAL_STORAGE)\n        return status === RESULTS.GRANTED\n      }\n\n      return false\n    } catch (error) {\n      console.error(\"[MediaLibrary] Error checking permission:\", error)\n      // On error, assume we can try (Android 10+ doesn't need permission anyway)\n      return Platform.OS === \"android\" && Platform.Version >= 29\n    }\n  }\n\n  /**\n   * Request permission to save to the camera roll\n   * Note: On Android 10+, this always returns true since no permission is needed\n   */\n  static async requestPermission(): Promise<boolean> {\n    try {\n      if (Platform.OS === \"ios\") {\n        const status = await request(PERMISSIONS.IOS.PHOTO_LIBRARY)\n        return status === RESULTS.GRANTED || status === RESULTS.LIMITED\n      }\n\n      if (Platform.OS === \"android\") {\n        // Android 10+ (API 29+): No permission needed to save your own files\n        if (Platform.Version >= 29) {\n          return true\n        }\n        // Android 9 and below: Request legacy write permission\n        const status = await request(PERMISSIONS.ANDROID.WRITE_EXTERNAL_STORAGE)\n        return status === RESULTS.GRANTED\n      }\n\n      return false\n    } catch (error) {\n      console.error(\"[MediaLibrary] Error requesting permission:\", error)\n      // On error, assume we can try (Android 10+ doesn't need permission anyway)\n      return Platform.OS === \"android\" && Platform.Version >= 29\n    }\n  }\n\n  /**\n   * Save a file to the photo library in a glasses-specific location (MentraOS album on iOS;\n   * Pictures/MentraOS or Movies/MentraOS on Android 10+).\n   * On Android 10+, this works without any permission.\n   *\n   * IMPORTANT: This method sets the DATE_TAKEN (Android) or creation date (iOS)\n   * metadata to the original capture time, so gallery apps show the correct date.\n   * Also saves files in chronological order for proper \"date added\" ordering.\n   *\n   * @param filePath - Path to the file to save\n   * @param creationTime - Optional creation/capture time in milliseconds (Unix timestamp)\n   */\n  static async saveToLibrary(filePath: string, creationTime?: number): Promise<boolean> {\n    return (await this.saveToLibraryWithReceipt(filePath, creationTime)).success\n  }\n\n  /** Save and return the durable MediaStore/PhotoKit identifier used as the export receipt. */\n  static async saveToLibraryWithReceipt(filePath: string, creationTime?: number): Promise<MediaLibrarySaveReceipt> {\n    const platform = Platform.OS === \"ios\" || Platform.OS === \"android\" ? Platform.OS : \"unknown\"\n    try {\n      // On Android 10+, we can save without permission\n      // On iOS and older Android, check permission first\n      if (!(Platform.OS === \"android\" && Platform.Version >= 29)) {\n        const hasPermission = await this.checkPermission()\n        if (!hasPermission) {\n          // Try requesting permission one more time\n          const granted = await this.requestPermission()\n          if (!granted) {\n            console.warn(\"[MediaLibrary] No permission to save to library - photos saved to app storage only\")\n            return {success: false, platform, error: \"permission denied\"}\n          }\n        }\n      }\n\n      // Remove file:// prefix if present\n      const cleanPath = filePath.replace(\"file://\", \"\")\n      const displayName = deriveGalleryDisplayName(cleanPath)\n\n      // Use native module to save with proper DATE_TAKEN / creation date metadata\n      // This ensures gallery apps show the correct capture date, not the sync date\n      const result = await CrustModule.saveToGalleryWithDate(cleanPath, creationTime, displayName)\n\n      if (result.success) {\n        if (creationTime) {\n          const captureDate = new Date(creationTime)\n          console.log(\n            `[MediaLibrary] Saved to camera roll with DATE_TAKEN: ${cleanPath} (captured: ${captureDate.toISOString()})`,\n          )\n        } else {\n          console.log(`[MediaLibrary] Saved to camera roll: ${cleanPath}`)\n        }\n        return {\n          success: true,\n          platform,\n          uri: result.uri,\n          identifier: result.identifier,\n        }\n      } else {\n        console.error(`[MediaLibrary] Failed to save to library: ${result.error}`)\n        return {success: false, platform, error: result.error || \"native export failed\"}\n      }\n    } catch (error) {\n      console.error(\"[MediaLibrary] Error saving to library:\", error)\n      return {success: false, platform, error: error instanceof Error ? error.message : String(error)}\n    }\n  }\n}\n"]}

package/build/utils/timers/timers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"AAoFA,qBAAa,OAAO;IAClB,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO/D,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO9C,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO9D,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAM7C;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAU/G;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAY/G"}
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"AAwHA,qBAAa,OAAO;IAClB,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO/D,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO9C,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO9D,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAM7C;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAU/G;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAY/G"}

package/build/utils/timers/timers.js

@@ -1,27 +1,63 @@
-// until https://github.com/tconns/react-native-nitro-bg-timer/issues/2 is resolved, we need to use this class to disable this package on iOS:
-import { Platform } from "react-native";
+// BgTimer — background-safe timers for the engine.
+//
+// Everything timing-critical in the engine runs through this class: the
+// miniapp liveness watchdog, display durationMs expiries, boot windows,
+// auth-token refresh. On Android, React Native PAUSES plain JS timers while
+// the app is backgrounded, so those features only keep working in the
+// background when the native implementation (react-native-nitro-bg-timer)
+// is active.
+//
+// Who actually gets native timers:
+//   - Android, dev AND release: always attempted — dev must match production
+//     background behavior. There is no opt-in/opt-out env var. If the native
+//     module is unavailable (a dev client whose binary predates it, or a
+//     broken release binary), the failure is LOUD: a console.error with the
+//     remediation, plus a blocking dev alert. The JS-timer fallback still
+//     engages so foreground behavior keeps working, but backgrounded
+//     behavior is broken until the native rebuild — the error says exactly
+//     that. (A silent dev fallback previously cost a full debugging day of
+//     phantom "zombie miniapp" bugs; see OS-1790.)
+//   - iOS: never, dev or prod — the package is disabled pending
+//     https://github.com/tconns/react-native-nitro-bg-timer/issues/2. iOS
+//     suspends the whole process in background anyway, so background timing
+//     there is handled by native per-device queues, not JS timers.
+import { Alert, Platform } from "react-native";
 let nitroTimer;
 let nitroDisabled = false;
-let warnedUnavailable = false;
-function warnUnavailable(reason) {
-    if (warnedUnavailable) {
+let failedLoud = false;
+/**
+ * The native background timer is unavailable — say so ONCE, loudly, with the
+ * remediation. The JS-timer fallback keeps foreground behavior working, but
+ * everything timing-driven freezes while the app is backgrounded, which
+ * presents as phantom miniapp bugs (frozen captions, missed wake words,
+ * watchdog kills on resume). A quiet warning here has already cost a full
+ * debugging day; never downgrade this to console.warn.
+ */
+function failUnavailable(reason) {
+    if (failedLoud) {
         return;
     }
-    warnedUnavailable = true;
-    console.warn(`BgTimer: ${reason}, using JS timers`);
+    failedLoud = true;
+    const message = `BgTimer: native background timer unavailable (${reason}). ` +
+        "Backgrounded behavior IS BROKEN until you rebuild the Android app: run `bun android`. " +
+        "Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded.";
+    console.error(message);
+    if (__DEV__) {
+        // A stale dev client may ALSO show the library's own require-time red box
+        // (bridgeless LogBox surfaces it even though we catch below) — this alert
+        // is the actionable one: it names the fix.
+        try {
+            Alert.alert("Background timers unavailable", message);
+        }
+        catch {
+            /* Alert not available (tests / headless) — the console.error stands. */
+        }
+    }
 }
 function getNitroTimer() {
     if (nitroDisabled || Platform.OS !== "android") {
         return null;
     }
-    // react-native-nitro-bg-timer calls createHybridObject() at require() time. On dev
-    // builds with a stale native binary that throws NPE, React Native still surfaces a
-    // red LogBox error even when the exception is caught. Skip nitro in __DEV__ unless
-    // explicitly enabled after a native rebuild (bun android).
-    if (__DEV__ && process.env.EXPO_PUBLIC_USE_NITRO_BG_TIMER !== "true") {
-        warnUnavailable("nitro bg-timer disabled in dev (set EXPO_PUBLIC_USE_NITRO_BG_TIMER=true after native rebuild)");
-        return null;
-    }
     if (nitroTimer !== undefined) {
         return nitroTimer;
     }
@@ -29,7 +65,7 @@ function getNitroTimer() {
         const { isRuntimeAlive } = require("react-native-nitro-modules");
         if (typeof isRuntimeAlive === "function" && !isRuntimeAlive()) {
             nitroTimer = null;
-            warnUnavailable("nitro runtime is not alive");
+            failUnavailable("nitro runtime is not alive");
             return nitroTimer;
         }
         const { BackgroundTimer } = require("react-native-nitro-bg-timer");
@@ -47,7 +83,7 @@ function getNitroTimer() {
         nitroDisabled = true;
     }
     if (!nitroTimer) {
-        warnUnavailable("react-native-nitro-bg-timer unavailable");
+        failUnavailable("react-native-nitro-bg-timer failed to load");
     }
     return nitroTimer;
 }
@@ -62,7 +98,8 @@ function withNitro(run, fallback) {
     catch (error) {
         nitroDisabled = true;
         nitroTimer = null;
-        console.warn("BgTimer: nitro timer failed, using JS timers", error);
+        failedLoud = false; // a mid-session failure is new information — re-announce
+        failUnavailable(`nitro timer call threw: ${String(error)}`);
         return fallback();
     }
 }

package/build/utils/timers/timers.js.map

@@ -1 +1 @@
-{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"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","sourcesContent":["// until https://github.com/tconns/react-native-nitro-bg-timer/issues/2 is resolved, we need to use this class to disable this package on iOS:\n\nimport {Platform} from \"react-native\"\n\ntype NitroTimerApi = {\n  setInterval: (callback: () => void, delay: number) => number\n  clearInterval: (intervalId: number) => void\n  setTimeout: (callback: () => void, delay: number) => number\n  clearTimeout: (timeoutId: number) => void\n}\n\nlet nitroTimer: NitroTimerApi | null | undefined\nlet nitroDisabled = false\nlet warnedUnavailable = false\n\nfunction warnUnavailable(reason: string) {\n  if (warnedUnavailable) {\n    return\n  }\n  warnedUnavailable = true\n  console.warn(`BgTimer: ${reason}, using JS timers`)\n}\n\nfunction getNitroTimer(): NitroTimerApi | null {\n  if (nitroDisabled || Platform.OS !== \"android\") {\n    return null\n  }\n\n  // react-native-nitro-bg-timer calls createHybridObject() at require() time. On dev\n  // builds with a stale native binary that throws NPE, React Native still surfaces a\n  // red LogBox error even when the exception is caught. Skip nitro in __DEV__ unless\n  // explicitly enabled after a native rebuild (bun android).\n  if (__DEV__ && process.env.EXPO_PUBLIC_USE_NITRO_BG_TIMER !== \"true\") {\n    warnUnavailable(\"nitro bg-timer disabled in dev (set EXPO_PUBLIC_USE_NITRO_BG_TIMER=true after native rebuild)\")\n    return null\n  }\n\n  if (nitroTimer !== undefined) {\n    return nitroTimer\n  }\n\n  try {\n    const {isRuntimeAlive} = require(\"react-native-nitro-modules\") as {isRuntimeAlive?: () => boolean}\n    if (typeof isRuntimeAlive === \"function\" && !isRuntimeAlive()) {\n      nitroTimer = null\n      warnUnavailable(\"nitro runtime is not alive\")\n      return nitroTimer\n    }\n\n    const {BackgroundTimer} = require(\"react-native-nitro-bg-timer\") as {BackgroundTimer?: NitroTimerApi}\n    nitroTimer =\n      BackgroundTimer &&\n      typeof BackgroundTimer.setTimeout === \"function\" &&\n      typeof BackgroundTimer.setInterval === \"function\" &&\n      typeof BackgroundTimer.clearTimeout === \"function\" &&\n      typeof BackgroundTimer.clearInterval === \"function\"\n        ? BackgroundTimer\n        : null\n  } catch {\n    nitroTimer = null\n    nitroDisabled = true\n  }\n\n  if (!nitroTimer) {\n    warnUnavailable(\"react-native-nitro-bg-timer unavailable\")\n  }\n  return nitroTimer\n}\n\nfunction withNitro<T>(run: (api: NitroTimerApi) => T, fallback: () => T): T {\n  const api = getNitroTimer()\n  if (!api) {\n    return fallback()\n  }\n  try {\n    return run(api)\n  } catch (error) {\n    nitroDisabled = true\n    nitroTimer = null\n    console.warn(\"BgTimer: nitro timer failed, using JS timers\", error)\n    return fallback()\n  }\n}\n\nexport class BgTimer {\n  static setInterval(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setInterval(callback, delay),\n      () => setInterval(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearInterval(intervalId: number): void {\n    withNitro(\n      (api) => api.clearInterval(intervalId),\n      () => clearInterval(intervalId),\n    )\n  }\n\n  static setTimeout(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setTimeout(callback, delay),\n      () => setTimeout(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearTimeout(timeoutId: number): void {\n    withNitro(\n      (api) => api.clearTimeout(timeoutId),\n      () => clearTimeout(timeoutId),\n    )\n  }\n}\n\nexport function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let lastCalled = 0\n\n  return (...args: Parameters<T>) => {\n    const now = Date.now()\n    if (now - lastCalled >= ms) {\n      lastCalled = now\n      fn(...args)\n    }\n  }\n}\n\nexport function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let timeoutId: number | null = null\n\n  return (...args: Parameters<T>) => {\n    if (timeoutId) {\n      BgTimer.clearTimeout(timeoutId)\n    }\n    timeoutId = BgTimer.setTimeout(() => {\n      fn(...args)\n      timeoutId = null\n    }, ms)\n  }\n}\n"]}
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"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","sourcesContent":["// BgTimer — background-safe timers for the engine.\n//\n// Everything timing-critical in the engine runs through this class: the\n// miniapp liveness watchdog, display durationMs expiries, boot windows,\n// auth-token refresh. On Android, React Native PAUSES plain JS timers while\n// the app is backgrounded, so those features only keep working in the\n// background when the native implementation (react-native-nitro-bg-timer)\n// is active.\n//\n// Who actually gets native timers:\n//   - Android, dev AND release: always attempted — dev must match production\n//     background behavior. There is no opt-in/opt-out env var. If the native\n//     module is unavailable (a dev client whose binary predates it, or a\n//     broken release binary), the failure is LOUD: a console.error with the\n//     remediation, plus a blocking dev alert. The JS-timer fallback still\n//     engages so foreground behavior keeps working, but backgrounded\n//     behavior is broken until the native rebuild — the error says exactly\n//     that. (A silent dev fallback previously cost a full debugging day of\n//     phantom \"zombie miniapp\" bugs; see OS-1790.)\n//   - iOS: never, dev or prod — the package is disabled pending\n//     https://github.com/tconns/react-native-nitro-bg-timer/issues/2. iOS\n//     suspends the whole process in background anyway, so background timing\n//     there is handled by native per-device queues, not JS timers.\n\nimport {Alert, Platform} from \"react-native\"\n\ntype NitroTimerApi = {\n  setInterval: (callback: () => void, delay: number) => number\n  clearInterval: (intervalId: number) => void\n  setTimeout: (callback: () => void, delay: number) => number\n  clearTimeout: (timeoutId: number) => void\n}\n\nlet nitroTimer: NitroTimerApi | null | undefined\nlet nitroDisabled = false\nlet failedLoud = false\n\n/**\n * The native background timer is unavailable — say so ONCE, loudly, with the\n * remediation. The JS-timer fallback keeps foreground behavior working, but\n * everything timing-driven freezes while the app is backgrounded, which\n * presents as phantom miniapp bugs (frozen captions, missed wake words,\n * watchdog kills on resume). A quiet warning here has already cost a full\n * debugging day; never downgrade this to console.warn.\n */\nfunction failUnavailable(reason: string) {\n  if (failedLoud) {\n    return\n  }\n  failedLoud = true\n  const message =\n    `BgTimer: native background timer unavailable (${reason}). ` +\n    \"Backgrounded behavior IS BROKEN until you rebuild the Android app: run `bun android`. \" +\n    \"Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded.\"\n  console.error(message)\n  if (__DEV__) {\n    // A stale dev client may ALSO show the library's own require-time red box\n    // (bridgeless LogBox surfaces it even though we catch below) — this alert\n    // is the actionable one: it names the fix.\n    try {\n      Alert.alert(\"Background timers unavailable\", message)\n    } catch {\n      /* Alert not available (tests / headless) — the console.error stands. */\n    }\n  }\n}\n\nfunction getNitroTimer(): NitroTimerApi | null {\n  if (nitroDisabled || Platform.OS !== \"android\") {\n    return null\n  }\n\n  if (nitroTimer !== undefined) {\n    return nitroTimer\n  }\n\n  try {\n    const {isRuntimeAlive} = require(\"react-native-nitro-modules\") as {isRuntimeAlive?: () => boolean}\n    if (typeof isRuntimeAlive === \"function\" && !isRuntimeAlive()) {\n      nitroTimer = null\n      failUnavailable(\"nitro runtime is not alive\")\n      return nitroTimer\n    }\n\n    const {BackgroundTimer} = require(\"react-native-nitro-bg-timer\") as {BackgroundTimer?: NitroTimerApi}\n    nitroTimer =\n      BackgroundTimer &&\n      typeof BackgroundTimer.setTimeout === \"function\" &&\n      typeof BackgroundTimer.setInterval === \"function\" &&\n      typeof BackgroundTimer.clearTimeout === \"function\" &&\n      typeof BackgroundTimer.clearInterval === \"function\"\n        ? BackgroundTimer\n        : null\n  } catch {\n    nitroTimer = null\n    nitroDisabled = true\n  }\n\n  if (!nitroTimer) {\n    failUnavailable(\"react-native-nitro-bg-timer failed to load\")\n  }\n  return nitroTimer\n}\n\nfunction withNitro<T>(run: (api: NitroTimerApi) => T, fallback: () => T): T {\n  const api = getNitroTimer()\n  if (!api) {\n    return fallback()\n  }\n  try {\n    return run(api)\n  } catch (error) {\n    nitroDisabled = true\n    nitroTimer = null\n    failedLoud = false // a mid-session failure is new information — re-announce\n    failUnavailable(`nitro timer call threw: ${String(error)}`)\n    return fallback()\n  }\n}\n\nexport class BgTimer {\n  static setInterval(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setInterval(callback, delay),\n      () => setInterval(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearInterval(intervalId: number): void {\n    withNitro(\n      (api) => api.clearInterval(intervalId),\n      () => clearInterval(intervalId),\n    )\n  }\n\n  static setTimeout(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setTimeout(callback, delay),\n      () => setTimeout(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearTimeout(timeoutId: number): void {\n    withNitro(\n      (api) => api.clearTimeout(timeoutId),\n      () => clearTimeout(timeoutId),\n    )\n  }\n}\n\nexport function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let lastCalled = 0\n\n  return (...args: Parameters<T>) => {\n    const now = Date.now()\n    if (now - lastCalled >= ms) {\n      lastCalled = now\n      fn(...args)\n    }\n  }\n}\n\nexport function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let timeoutId: number | null = null\n\n  return (...args: Parameters<T>) => {\n    if (timeoutId) {\n      BgTimer.clearTimeout(timeoutId)\n    }\n    timeoutId = BgTimer.setTimeout(() => {\n      fn(...args)\n      timeoutId = null\n    }, ms)\n  }\n}\n"]}