@mentra/engine 0.1.0-beta.0

package/build/utils/display/wrapper/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/utils/display/wrapper/types.ts"],"names":[],"mappings":"AA4FA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwE;IACvG,SAAS,EAAE,qBAAqB;IAChC,UAAU,EAAE,GAAG;IACf,oBAAoB,EAAE,CAAC;IACvB,SAAS,EAAE,IAAI;IACf,gBAAgB,EAAE,IAAI;CACvB,CAAC","sourcesContent":["/**\n * Options for text wrapping.\n */\nexport interface WrapOptions {\n  /** Maximum width in pixels (defaults to profile's displayWidthPx) */\n  maxWidthPx?: number;\n\n  /** Maximum number of lines (defaults to profile's maxLines) */\n  maxLines?: number;\n\n  /** Maximum total bytes (defaults to profile's maxPayloadBytes) */\n  maxBytes?: number;\n\n  /**\n   * Break mode:\n   * - 'character': Break mid-word with hyphen for 100% utilization\n   * - 'word': Break at word boundaries, hyphenate only if word > line\n   * - 'strict-word': Break at word boundaries only, truncate long words\n   */\n  breakMode?: BreakMode;\n\n  /** Character to use for hyphenation (default: '-') */\n  hyphenChar?: string;\n\n  /** Minimum characters before allowing hyphen break (default: 3) */\n  minCharsBeforeHyphen?: number;\n\n  /** Whether to trim whitespace from line ends (default: true) */\n  trimLines?: boolean;\n\n  /** Whether to preserve explicit newlines in input (default: true) */\n  preserveNewlines?: boolean;\n}\n\n/**\n * Break mode for text wrapping.\n * - 'character': Break mid-word with hyphen for 100% utilization\n * - 'character-no-hyphen': Break mid-word without hyphen (clean break)\n * - 'word': Break at word boundaries, hyphenate only if word > line\n * - 'strict-word': Break at word boundaries only, truncate long words\n */\nexport type BreakMode = \"character\" | \"character-no-hyphen\" | \"word\" | \"strict-word\";\n\n/**\n * Result of wrapping operation.\n */\nexport interface WrapResult {\n  /** Wrapped lines */\n  lines: string[];\n\n  /** Whether content was truncated to fit constraints */\n  truncated: boolean;\n\n  /** Total pixel width of widest line */\n  maxLineWidthPx: number;\n\n  /** Total byte size of all lines */\n  totalBytes: number;\n\n  /** Per-line metadata */\n  lineMetrics: LineMetrics[];\n\n  /** Original input text */\n  originalText: string;\n\n  /** Break mode used */\n  breakMode: BreakMode;\n}\n\n/**\n * Per-line metrics from wrapping.\n */\nexport interface LineMetrics {\n  /** The line text */\n  text: string;\n\n  /** Width in pixels */\n  widthPx: number;\n\n  /** Byte size of this line */\n  bytes: number;\n\n  /** Utilization percentage (widthPx / maxWidthPx * 100) */\n  utilizationPercent: number;\n\n  /** Whether this line ends with a hyphen from breaking */\n  endsWithHyphen: boolean;\n\n  /** Whether this line was created from an explicit newline */\n  fromExplicitNewline: boolean;\n}\n\n/**\n * Default wrap options.\n */\nexport const DEFAULT_WRAP_OPTIONS: Required<Omit<WrapOptions, \"maxWidthPx\" | \"maxLines\" | \"maxBytes\">> = {\n  breakMode: \"character-no-hyphen\",\n  hyphenChar: \"-\",\n  minCharsBeforeHyphen: 3,\n  trimLines: true,\n  preserveNewlines: true,\n};\n"]}

package/build/utils/e2eMetrics.d.ts

@@ -0,0 +1,6 @@
+export type E2EMetricPayload = Record<string, unknown>;
+export declare function e2eMetricsEnabled(): boolean;
+export declare function buildE2EMetric(event: string, payload?: E2EMetricPayload): E2EMetricPayload;
+export declare function logE2EMetricPayload(metric: E2EMetricPayload, failureLabel?: string): void;
+export declare function logE2EMetric(event: string, payload?: E2EMetricPayload): void;
+//# sourceMappingURL=e2eMetrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"e2eMetrics.d.ts","sourceRoot":"","sources":["../../src/utils/e2eMetrics.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEtD,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,gBAAgB,CAQ9F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,SAAY,GAAG,IAAI,CAO5F;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAEhF"}

package/build/utils/e2eMetrics.js

@@ -0,0 +1,27 @@
+const E2E_METRIC_PREFIX = "E2E_METRIC";
+export function e2eMetricsEnabled() {
+    return process.env.EXPO_PUBLIC_ENABLE_E2E_METRICS === "true";
+}
+export function buildE2EMetric(event, payload = {}) {
+    // Payload first: the system-set `event` and `ts_ms` fields always win, so a
+    // caller-supplied collision can't mislabel or re-timestamp the metric.
+    return {
+        ...payload,
+        event,
+        ts_ms: Date.now(),
+    };
+}
+export function logE2EMetricPayload(metric, failureLabel = "payload") {
+    if (!e2eMetricsEnabled())
+        return;
+    try {
+        console.log(`${E2E_METRIC_PREFIX} ${JSON.stringify(metric)}`);
+    }
+    catch (error) {
+        console.warn(`E2E_METRIC: failed to serialize ${failureLabel}`, error);
+    }
+}
+export function logE2EMetric(event, payload = {}) {
+    logE2EMetricPayload(buildE2EMetric(event, payload), event);
+}
+//# sourceMappingURL=e2eMetrics.js.map

package/build/utils/e2eMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2eMetrics.js","sourceRoot":"","sources":["../../src/utils/e2eMetrics.ts"],"names":[],"mappings":"AAAA,MAAM,iBAAiB,GAAG,YAAY,CAAA;AAItC,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,MAAM,CAAA;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,UAA4B,EAAE;IAC1E,4EAA4E;IAC5E,uEAAuE;IACvE,OAAO;QACL,GAAG,OAAO;QACV,KAAK;QACL,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;KAClB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAwB,EAAE,YAAY,GAAG,SAAS;IACpF,IAAI,CAAC,iBAAiB,EAAE;QAAE,OAAM;IAChC,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,GAAG,iBAAiB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,mCAAmC,YAAY,EAAE,EAAE,KAAK,CAAC,CAAA;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAA4B,EAAE;IACxE,mBAAmB,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAA;AAC5D,CAAC","sourcesContent":["const E2E_METRIC_PREFIX = \"E2E_METRIC\"\n\nexport type E2EMetricPayload = Record<string, unknown>\n\nexport function e2eMetricsEnabled(): boolean {\n  return process.env.EXPO_PUBLIC_ENABLE_E2E_METRICS === \"true\"\n}\n\nexport function buildE2EMetric(event: string, payload: E2EMetricPayload = {}): E2EMetricPayload {\n  // Payload first: the system-set `event` and `ts_ms` fields always win, so a\n  // caller-supplied collision can't mislabel or re-timestamp the metric.\n  return {\n    ...payload,\n    event,\n    ts_ms: Date.now(),\n  }\n}\n\nexport function logE2EMetricPayload(metric: E2EMetricPayload, failureLabel = \"payload\"): void {\n  if (!e2eMetricsEnabled()) return\n  try {\n    console.log(`${E2E_METRIC_PREFIX} ${JSON.stringify(metric)}`)\n  } catch (error) {\n    console.warn(`E2E_METRIC: failed to serialize ${failureLabel}`, error)\n  }\n}\n\nexport function logE2EMetric(event: string, payload: E2EMetricPayload = {}): void {\n  logE2EMetricPayload(buildE2EMetric(event, payload), event)\n}\n"]}

package/build/utils/hardware/hardware.d.ts

@@ -0,0 +1,42 @@
+import { Capabilities, HardwareRequirement } from "../../types";
+/**
+ * Result of a hardware compatibility check
+ */
+export interface CompatibilityResult {
+    isCompatible: boolean;
+    missingRequired: HardwareRequirement[];
+    missingOptional: HardwareRequirement[];
+    warnings: string[];
+}
+/**
+ * Service for checking hardware compatibility between apps and glasses
+ */
+export declare class HardwareCompatibility {
+    /**
+     * Check if app is compatible with given device capabilities
+     * @param app The app to check
+     * @param capabilities The device capabilities (null if no device connected)
+     * @returns Detailed compatibility result
+     */
+    static checkCompatibility(hardwareRequirements: HardwareRequirement[], capabilities: Capabilities | null): CompatibilityResult;
+    /**
+     * Check if specific hardware is available in capabilities
+     * @param hardwareType The type of hardware to check
+     * @param capabilities The device capabilities
+     * @returns true if hardware is available
+     */
+    private static checkHardwareAvailable;
+    /**
+     * Get human-readable compatibility message
+     * @param result The compatibility check result
+     * @returns User-friendly message about compatibility
+     */
+    static getCompatibilityMessage(result: CompatibilityResult): string;
+    /**
+     * Get detailed compatibility messages including descriptions
+     * @param result The compatibility check result
+     * @returns Array of detailed messages
+     */
+    static getDetailedMessages(result: CompatibilityResult): string[];
+}
+//# sourceMappingURL=hardware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hardware.d.ts","sourceRoot":"","sources":["../../../src/utils/hardware/hardware.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,mBAAmB,EAIpB,MAAM,aAAa,CAAA;AAGpB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,mBAAmB,EAAE,CAAA;IACtC,eAAe,EAAE,mBAAmB,EAAE,CAAA;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CACvB,oBAAoB,EAAE,mBAAmB,EAAE,EAC3C,YAAY,EAAE,YAAY,GAAG,IAAI,GAChC,mBAAmB;IAkCtB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAuCrC;;;;OAIG;IACH,MAAM,CAAC,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM;IAkBnE;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,EAAE;CA0BlE"}

package/build/utils/hardware/hardware.js

@@ -0,0 +1,127 @@
+import { HardwareType, HardwareRequirementLevel, DeviceTypes, } from "../../types";
+import { simulatedGlasses } from "../../types";
+/**
+ * Service for checking hardware compatibility between apps and glasses
+ */
+export class HardwareCompatibility {
+    /**
+     * Check if app is compatible with given device capabilities
+     * @param app The app to check
+     * @param capabilities The device capabilities (null if no device connected)
+     * @returns Detailed compatibility result
+     */
+    static checkCompatibility(hardwareRequirements, capabilities) {
+        const result = {
+            isCompatible: true,
+            missingRequired: [],
+            missingOptional: [],
+            warnings: [],
+        };
+        // If no hardware requirements specified, app is compatible with any hardware
+        if (hardwareRequirements.length === 0) {
+            return result;
+        }
+        // If no capabilities available assume simulated glasses:
+        if (!capabilities) {
+            capabilities = simulatedGlasses;
+        }
+        // Check each hardware requirement
+        for (const requirement of hardwareRequirements) {
+            const hasHardware = this.checkHardwareAvailable(requirement.type, capabilities);
+            if (!hasHardware) {
+                if (requirement.level === HardwareRequirementLevel.REQUIRED) {
+                    result.missingRequired.push(requirement);
+                    result.isCompatible = false;
+                }
+                else {
+                    result.missingOptional.push(requirement);
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Check if specific hardware is available in capabilities
+     * @param hardwareType The type of hardware to check
+     * @param capabilities The device capabilities
+     * @returns true if hardware is available
+     */
+    static checkHardwareAvailable(hardwareType, capabilities) {
+        if (hardwareType === HardwareType.EXIST) {
+            if (capabilities.modelName === DeviceTypes.NONE) {
+                return false;
+            }
+            return true;
+        }
+        switch (hardwareType) {
+            case HardwareType.CAMERA:
+                return capabilities.hasCamera;
+            case HardwareType.DISPLAY:
+                return capabilities.hasDisplay;
+            case HardwareType.MICROPHONE:
+                return capabilities.hasMicrophone;
+            case HardwareType.SPEAKER:
+                return capabilities.hasSpeaker;
+            case HardwareType.IMU:
+                return capabilities.hasIMU;
+            case HardwareType.BUTTON:
+                return capabilities.hasButton;
+            case HardwareType.LIGHT:
+                return capabilities.hasLight;
+            case HardwareType.WIFI:
+                return capabilities.hasWifi;
+            default:
+                // Unknown hardware type - assume not available
+                return false;
+        }
+    }
+    /**
+     * Get human-readable compatibility message
+     * @param result The compatibility check result
+     * @returns User-friendly message about compatibility
+     */
+    static getCompatibilityMessage(result) {
+        if (result.isCompatible) {
+            if (result.missingOptional.length > 0) {
+                const optionalHardware = result.missingOptional.map((req) => req.type.toLowerCase()).join(", ");
+                return `This app works with your glasses but has optional features that require: ${optionalHardware}`;
+            }
+            return "This app is fully compatible with your glasses";
+        }
+        const requiredHardware = result.missingRequired.map((req) => req.type.toLowerCase()).join(", ");
+        if (result.missingRequired.length === 1) {
+            return `This app requires a ${requiredHardware} which is not available on your connected glasses`;
+        }
+        else {
+            return `This app requires the following hardware which is not available on your connected glasses: ${requiredHardware}`;
+        }
+    }
+    /**
+     * Get detailed compatibility messages including descriptions
+     * @param result The compatibility check result
+     * @returns Array of detailed messages
+     */
+    static getDetailedMessages(result) {
+        const messages = [];
+        // Add warnings first
+        messages.push(...result.warnings);
+        // Add missing required hardware
+        for (const req of result.missingRequired) {
+            let message = `❌ Missing required ${req.type.toLowerCase()}`;
+            if (req.description) {
+                message += `: ${req.description}`;
+            }
+            messages.push(message);
+        }
+        // Add missing optional hardware
+        for (const req of result.missingOptional) {
+            let message = `⚠️ Missing optional ${req.type.toLowerCase()}`;
+            if (req.description) {
+                message += `: ${req.description}`;
+            }
+            messages.push(message);
+        }
+        return messages;
+    }
+}
+//# sourceMappingURL=hardware.js.map

package/build/utils/hardware/hardware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware.js","sourceRoot":"","sources":["../../../src/utils/hardware/hardware.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Capabilities,\n  HardwareRequirement,\n  HardwareType,\n  HardwareRequirementLevel,\n  DeviceTypes,\n} from \"../../types\"\nimport {simulatedGlasses} from \"../../types\"\n\n/**\n * Result of a hardware compatibility check\n */\nexport interface CompatibilityResult {\n  isCompatible: boolean\n  missingRequired: HardwareRequirement[]\n  missingOptional: HardwareRequirement[]\n  warnings: string[]\n}\n\n/**\n * Service for checking hardware compatibility between apps and glasses\n */\nexport class HardwareCompatibility {\n  /**\n   * Check if app is compatible with given device capabilities\n   * @param app The app to check\n   * @param capabilities The device capabilities (null if no device connected)\n   * @returns Detailed compatibility result\n   */\n  static checkCompatibility(\n    hardwareRequirements: HardwareRequirement[],\n    capabilities: Capabilities | null,\n  ): CompatibilityResult {\n    const result: CompatibilityResult = {\n      isCompatible: true,\n      missingRequired: [],\n      missingOptional: [],\n      warnings: [],\n    }\n\n    // If no hardware requirements specified, app is compatible with any hardware\n    if (hardwareRequirements.length === 0) {\n      return result\n    }\n\n    // If no capabilities available assume simulated glasses:\n    if (!capabilities) {\n      capabilities = simulatedGlasses\n    }\n\n    // Check each hardware requirement\n    for (const requirement of hardwareRequirements) {\n      const hasHardware = this.checkHardwareAvailable(requirement.type, capabilities!)\n      if (!hasHardware) {\n        if (requirement.level === HardwareRequirementLevel.REQUIRED) {\n          result.missingRequired.push(requirement)\n          result.isCompatible = false\n        } else {\n          result.missingOptional.push(requirement)\n        }\n      }\n    }\n\n    return result\n  }\n\n  /**\n   * Check if specific hardware is available in capabilities\n   * @param hardwareType The type of hardware to check\n   * @param capabilities The device capabilities\n   * @returns true if hardware is available\n   */\n  private static checkHardwareAvailable(hardwareType: HardwareType, capabilities: Capabilities): boolean {\n    if (hardwareType === HardwareType.EXIST) {\n      if (capabilities.modelName === DeviceTypes.NONE) {\n        return false\n      }\n      return true\n    }\n\n    switch (hardwareType) {\n      case HardwareType.CAMERA:\n        return capabilities.hasCamera\n\n      case HardwareType.DISPLAY:\n        return capabilities.hasDisplay\n\n      case HardwareType.MICROPHONE:\n        return capabilities.hasMicrophone\n\n      case HardwareType.SPEAKER:\n        return capabilities.hasSpeaker\n\n      case HardwareType.IMU:\n        return capabilities.hasIMU\n\n      case HardwareType.BUTTON:\n        return capabilities.hasButton\n\n      case HardwareType.LIGHT:\n        return capabilities.hasLight\n\n      case HardwareType.WIFI:\n        return capabilities.hasWifi\n\n      default:\n        // Unknown hardware type - assume not available\n        return false\n    }\n  }\n\n  /**\n   * Get human-readable compatibility message\n   * @param result The compatibility check result\n   * @returns User-friendly message about compatibility\n   */\n  static getCompatibilityMessage(result: CompatibilityResult): string {\n    if (result.isCompatible) {\n      if (result.missingOptional.length > 0) {\n        const optionalHardware = result.missingOptional.map((req) => req.type.toLowerCase()).join(\", \")\n        return `This app works with your glasses but has optional features that require: ${optionalHardware}`\n      }\n      return \"This app is fully compatible with your glasses\"\n    }\n\n    const requiredHardware = result.missingRequired.map((req) => req.type.toLowerCase()).join(\", \")\n\n    if (result.missingRequired.length === 1) {\n      return `This app requires a ${requiredHardware} which is not available on your connected glasses`\n    } else {\n      return `This app requires the following hardware which is not available on your connected glasses: ${requiredHardware}`\n    }\n  }\n\n  /**\n   * Get detailed compatibility messages including descriptions\n   * @param result The compatibility check result\n   * @returns Array of detailed messages\n   */\n  static getDetailedMessages(result: CompatibilityResult): string[] {\n    const messages: string[] = []\n\n    // Add warnings first\n    messages.push(...result.warnings)\n\n    // Add missing required hardware\n    for (const req of result.missingRequired) {\n      let message = `❌ Missing required ${req.type.toLowerCase()}`\n      if (req.description) {\n        message += `: ${req.description}`\n      }\n      messages.push(message)\n    }\n\n    // Add missing optional hardware\n    for (const req of result.missingOptional) {\n      let message = `⚠️ Missing optional ${req.type.toLowerCase()}`\n      if (req.description) {\n        message += `: ${req.description}`\n      }\n      messages.push(message)\n    }\n\n    return messages\n  }\n}\n"]}

package/build/utils/hardware/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./hardware";
+//# sourceMappingURL=index.d.ts.map

package/build/utils/hardware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/hardware/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA"}

package/build/utils/hardware/index.js

@@ -0,0 +1,2 @@
+export * from "./hardware";
+//# sourceMappingURL=index.js.map

package/build/utils/hardware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/hardware/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA","sourcesContent":["export * from \"./hardware\"\n"]}

package/build/utils/miniappGlobals.d.ts

@@ -0,0 +1,60 @@
+/**
+ * miniappGlobals — shared builder for the window.MentraOS globals injected
+ * into every miniapp WebView (both cloud and local).
+ *
+ * Authors should be able to use one API in their miniapp code regardless of
+ * whether it's hosted in the cloud or on-device. So both injection paths
+ * (webview.tsx for cloud miniapps, MiniappHost.tsx for local miniapps) funnel
+ * through this util.
+ */
+export interface MiniappSafeArea {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+export interface CapsuleMenuRect {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    width: number;
+    height: number;
+}
+/**
+ * @param topInsetOffset  extra top offset to add when the WebView container does
+ *   NOT already pad by the safe-area inset (i.e. WebView fills edge-to-edge under
+ *   the status bar). Pass `insets.top` in that case, or 0 when the container
+ *   already applies top padding.
+ */
+export declare function getCapsuleMenuRect(topInsetOffset?: number): CapsuleMenuRect;
+export type MiniappColorScheme = "light" | "dark";
+export interface BuildMiniappGlobalsOptions {
+    packageName?: string;
+    capabilities?: string[];
+    miniappLocal?: boolean;
+    miniappDeveloperMode?: boolean;
+    safeAreaInsets: MiniappSafeArea;
+    /**
+     * True when the WebView container renders edge-to-edge (no top padding for
+     * the status bar). In that case the capsule menu rect needs to shift down by
+     * the top inset so its coords match where it's actually drawn on screen.
+     */
+    webviewFillsStatusBar?: boolean;
+    /** Current host color scheme. Miniapps may follow this to match the phone. */
+    colorScheme?: MiniappColorScheme;
+}
+/**
+ * Returns the JS string to inject into a miniapp WebView before its content
+ * loads. Sets window.MentraOS with the standard fields miniapps read:
+ *
+ *   window.MentraOS = {
+ *     platform, packageName?, capabilities, safeAreaInsets, capsuleMenu,
+ *     miniappLocal?, miniappDeveloperMode?
+ *   }
+ *
+ * Also defines a stub window.receiveNativeMessage so the miniapp can safely
+ * assign to it before the native bridge wires in.
+ */
+export declare function buildMiniappGlobalsScript(opts: BuildMiniappGlobalsOptions): string;
+//# sourceMappingURL=miniappGlobals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"miniappGlobals.d.ts","sourceRoot":"","sources":["../../src/utils/miniappGlobals.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAaD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,SAAI,GAAG,eAAe,CAWtE;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,CAAA;AAEjD,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,cAAc,EAAE,eAAe,CAAA;IAC/B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,kBAAkB,CAAA;CACjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,0BAA0B,GAAG,MAAM,CA2KlF"}

package/build/utils/miniappGlobals.js

@@ -0,0 +1,224 @@
+/**
+ * miniappGlobals — shared builder for the window.MentraOS globals injected
+ * into every miniapp WebView (both cloud and local).
+ *
+ * Authors should be able to use one API in their miniapp code regardless of
+ * whether it's hosted in the cloud or on-device. So both injection paths
+ * (webview.tsx for cloud miniapps, MiniappHost.tsx for local miniapps) funnel
+ * through this util.
+ */
+import { Dimensions, Platform } from "react-native";
+/**
+ * The capsule menu bounding rect in the WebView's own coordinate space.
+ *
+ * Keep in sync with CapsuleMenu.tsx:
+ *   - CapsuleButton height ≈ h-7.5 (30px), width ≈ 73px
+ *   - Positioned at right-2 (8px), top = theme.spacing.s2 (8px) below insets.top
+ */
+const CAPSULE_MENU_HEIGHT = 30;
+const CAPSULE_MENU_WIDTH = 73;
+const CAPSULE_MENU_PADDING = 8;
+/**
+ * @param topInsetOffset  extra top offset to add when the WebView container does
+ *   NOT already pad by the safe-area inset (i.e. WebView fills edge-to-edge under
+ *   the status bar). Pass `insets.top` in that case, or 0 when the container
+ *   already applies top padding.
+ */
+export function getCapsuleMenuRect(topInsetOffset = 0) {
+    const screenWidth = Dimensions.get("window").width;
+    const top = topInsetOffset + CAPSULE_MENU_PADDING;
+    return {
+        top,
+        right: CAPSULE_MENU_PADDING,
+        bottom: top + CAPSULE_MENU_HEIGHT,
+        left: screenWidth - CAPSULE_MENU_PADDING - CAPSULE_MENU_WIDTH,
+        width: CAPSULE_MENU_WIDTH,
+        height: CAPSULE_MENU_HEIGHT,
+    };
+}
+/**
+ * Returns the JS string to inject into a miniapp WebView before its content
+ * loads. Sets window.MentraOS with the standard fields miniapps read:
+ *
+ *   window.MentraOS = {
+ *     platform, packageName?, capabilities, safeAreaInsets, capsuleMenu,
+ *     miniappLocal?, miniappDeveloperMode?
+ *   }
+ *
+ * Also defines a stub window.receiveNativeMessage so the miniapp can safely
+ * assign to it before the native bridge wires in.
+ */
+export function buildMiniappGlobalsScript(opts) {
+    const capsuleTopOffset = opts.webviewFillsStatusBar ? opts.safeAreaInsets.top : 0;
+    const globals = {
+        platform: Platform.OS,
+        capabilities: opts.capabilities ?? ["share", "open_url", "copy_clipboard", "download"],
+        safeAreaInsets: opts.safeAreaInsets,
+        capsuleMenu: getCapsuleMenuRect(capsuleTopOffset),
+    };
+    if (opts.packageName)
+        globals.packageName = opts.packageName;
+    if (opts.miniappLocal)
+        globals.miniappLocal = true;
+    if (opts.miniappDeveloperMode)
+        globals.miniappDeveloperMode = true;
+    if (opts.colorScheme)
+        globals.colorScheme = opts.colorScheme;
+    // CSS custom properties that mirror the capsule menu / safe-area data.
+    // Miniapp CSS (or Tailwind arbitrary values) can read these without
+    // touching JS: e.g. `style="margin-top: var(--mentra-capsule-top)"`.
+    const capsule = globals.capsuleMenu;
+    const insets = opts.safeAreaInsets;
+    const capsuleCenter = capsule.top + capsule.height / 2;
+    const cssVars = {
+        "--mentra-safe-top": `${insets.top}px`,
+        "--mentra-safe-bottom": `${insets.bottom}px`,
+        "--mentra-safe-left": `${insets.left}px`,
+        "--mentra-safe-right": `${insets.right}px`,
+        "--mentra-capsule-top": `${capsule.top}px`,
+        "--mentra-capsule-bottom": `${capsule.bottom}px`,
+        "--mentra-capsule-left": `${capsule.left}px`,
+        "--mentra-capsule-right": `${capsule.right}px`,
+        "--mentra-capsule-width": `${capsule.width}px`,
+        "--mentra-capsule-height": `${capsule.height}px`,
+        "--mentra-capsule-center-y": `${capsuleCenter}px`,
+        // Right-side gutter to reserve so content doesn't slide under the
+        // capsule: capsule width + 16px breathing room.
+        "--mentra-capsule-gutter": `${capsule.width + 16}px`,
+    };
+    const cssVarsBlock = Object.entries(cssVars)
+        .map(([k, v]) => `${k}: ${v};`)
+        .join(" ");
+    // Console-tap shim: wrap console.log/warn/error/info/debug so each call
+    // also forwards a `dev_log` envelope back to the phone via
+    // ReactNativeWebView.postMessage. Dev mode forwards to the laptop's
+    // `mentra-miniapp dev` terminal; non-dev mode falls back to the React
+    // Native log stream (Metro / Xcode console / adb logcat) so installed-
+    // miniapp errors are still inspectable when there's no laptop sidecar.
+    //
+    // Also tap window.onerror and window.onunhandledrejection so synchronous
+    // throws and unhandled promise rejections surface even when the bundle
+    // never gets a chance to call console.error itself.
+    const consoleTapBlock = `
+    (function() {
+      try {
+        var levels = ["log", "warn", "error", "info", "debug"];
+        var seen = new WeakSet();
+        function safeSerialize(arg) {
+          if (arg instanceof Error) return {__error: true, message: arg.message, stack: arg.stack};
+          if (arg === null || typeof arg !== "object") return arg;
+          try {
+            return JSON.parse(JSON.stringify(arg, function(k, v) {
+              if (v !== null && typeof v === "object") {
+                if (seen.has(v)) return "[Circular]";
+                seen.add(v);
+              }
+              return v;
+            }));
+          } catch (e) {
+            try { return String(arg); } catch (_) { return "[unserializable]"; }
+          }
+        }
+        levels.forEach(function(level) {
+          var original = console[level];
+          if (typeof original !== "function") return;
+          console[level] = function() {
+            try { original.apply(console, arguments); } catch (_) {}
+            try {
+              var args = Array.prototype.slice.call(arguments).map(safeSerialize);
+              if (window.ReactNativeWebView && typeof window.ReactNativeWebView.postMessage === "function") {
+                window.ReactNativeWebView.postMessage(JSON.stringify({
+                  payload: {
+                    type: "dev_log",
+                    level: level,
+                    args: args,
+                    packageName: (window.MentraOS && window.MentraOS.packageName) || null,
+                    timestamp: Date.now()
+                  }
+                }));
+              }
+            } catch (_) { /* swallow */ }
+          };
+        });
+      } catch (_) { /* ignore */ }
+
+      // Surface synchronous errors and unhandled promise rejections via the
+      // same dev_log channel — many bundle-startup crashes never get to call
+      // console.error themselves.
+      try {
+        window.addEventListener("error", function(e) {
+          try {
+            if (window.ReactNativeWebView && typeof window.ReactNativeWebView.postMessage === "function") {
+              window.ReactNativeWebView.postMessage(JSON.stringify({
+                payload: {
+                  type: "dev_log",
+                  level: "error",
+                  args: ["[window.error] " + (e.message || "unknown"), {filename: e.filename, lineno: e.lineno, colno: e.colno, stack: e.error && e.error.stack}],
+                  packageName: (window.MentraOS && window.MentraOS.packageName) || null,
+                  timestamp: Date.now()
+                }
+              }));
+            }
+          } catch (_) {}
+        });
+        window.addEventListener("unhandledrejection", function(e) {
+          try {
+            if (window.ReactNativeWebView && typeof window.ReactNativeWebView.postMessage === "function") {
+              var reason = e.reason;
+              var serialized = reason instanceof Error
+                ? {__error: true, message: reason.message, stack: reason.stack}
+                : (typeof reason === "object" ? JSON.stringify(reason) : String(reason));
+              window.ReactNativeWebView.postMessage(JSON.stringify({
+                payload: {
+                  type: "dev_log",
+                  level: "error",
+                  args: ["[unhandledrejection]", serialized],
+                  packageName: (window.MentraOS && window.MentraOS.packageName) || null,
+                  timestamp: Date.now()
+                }
+              }));
+            }
+          } catch (_) {}
+        });
+      } catch (_) {}
+    })();
+  `;
+    // Lock zoom so miniapps feel like apps, not pages: force a non-scalable
+    // viewport meta (overriding whatever the miniapp shipped) and disable
+    // double-tap-zoom via CSS. Re-applies on DOMContentLoaded in case the
+    // miniapp re-writes <head> during boot.
+    return `
+    window.MentraOS = ${JSON.stringify(globals)};
+    window.receiveNativeMessage = window.receiveNativeMessage || function() {};
+    (function() {
+      try {
+        var styleEl = document.createElement("style");
+        styleEl.setAttribute("data-mentra-injected", "1");
+        styleEl.textContent =
+          ":root { ${cssVarsBlock} }" +
+          "html, body { touch-action: manipulation; -ms-content-zooming: none; }";
+        (document.head || document.documentElement).appendChild(styleEl);
+      } catch (e) { /* ignore */ }
+
+      function lockViewport() {
+        try {
+          var content = "width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no, viewport-fit=cover";
+          var existing = document.querySelector('meta[name="viewport"]');
+          if (existing) {
+            existing.setAttribute("content", content);
+          } else {
+            var meta = document.createElement("meta");
+            meta.setAttribute("name", "viewport");
+            meta.setAttribute("content", content);
+            (document.head || document.documentElement).appendChild(meta);
+          }
+        } catch (e) { /* ignore */ }
+      }
+      lockViewport();
+      document.addEventListener("DOMContentLoaded", lockViewport);
+    })();
+    ${consoleTapBlock}
+    true;
+  `;
+}
+//# sourceMappingURL=miniappGlobals.js.map

package/build/utils/miniappGlobals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miniappGlobals.js","sourceRoot":"","sources":["../../src/utils/miniappGlobals.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * miniappGlobals — shared builder for the window.MentraOS globals injected\n * into every miniapp WebView (both cloud and local).\n *\n * Authors should be able to use one API in their miniapp code regardless of\n * whether it's hosted in the cloud or on-device. So both injection paths\n * (webview.tsx for cloud miniapps, MiniappHost.tsx for local miniapps) funnel\n * through this util.\n */\n\nimport {Dimensions, Platform} from \"react-native\"\n\nexport interface MiniappSafeArea {\n  top: number\n  bottom: number\n  left: number\n  right: number\n}\n\nexport interface CapsuleMenuRect {\n  top: number\n  right: number\n  bottom: number\n  left: number\n  width: number\n  height: number\n}\n\n/**\n * The capsule menu bounding rect in the WebView's own coordinate space.\n *\n * Keep in sync with CapsuleMenu.tsx:\n *   - CapsuleButton height ≈ h-7.5 (30px), width ≈ 73px\n *   - Positioned at right-2 (8px), top = theme.spacing.s2 (8px) below insets.top\n */\nconst CAPSULE_MENU_HEIGHT = 30\nconst CAPSULE_MENU_WIDTH = 73\nconst CAPSULE_MENU_PADDING = 8\n\n/**\n * @param topInsetOffset  extra top offset to add when the WebView container does\n *   NOT already pad by the safe-area inset (i.e. WebView fills edge-to-edge under\n *   the status bar). Pass `insets.top` in that case, or 0 when the container\n *   already applies top padding.\n */\nexport function getCapsuleMenuRect(topInsetOffset = 0): CapsuleMenuRect {\n  const screenWidth = Dimensions.get(\"window\").width\n  const top = topInsetOffset + CAPSULE_MENU_PADDING\n  return {\n    top,\n    right: CAPSULE_MENU_PADDING,\n    bottom: top + CAPSULE_MENU_HEIGHT,\n    left: screenWidth - CAPSULE_MENU_PADDING - CAPSULE_MENU_WIDTH,\n    width: CAPSULE_MENU_WIDTH,\n    height: CAPSULE_MENU_HEIGHT,\n  }\n}\n\nexport type MiniappColorScheme = \"light\" | \"dark\"\n\nexport interface BuildMiniappGlobalsOptions {\n  packageName?: string\n  capabilities?: string[]\n  miniappLocal?: boolean\n  miniappDeveloperMode?: boolean\n  safeAreaInsets: MiniappSafeArea\n  /**\n   * True when the WebView container renders edge-to-edge (no top padding for\n   * the status bar). In that case the capsule menu rect needs to shift down by\n   * the top inset so its coords match where it's actually drawn on screen.\n   */\n  webviewFillsStatusBar?: boolean\n  /** Current host color scheme. Miniapps may follow this to match the phone. */\n  colorScheme?: MiniappColorScheme\n}\n\n/**\n * Returns the JS string to inject into a miniapp WebView before its content\n * loads. Sets window.MentraOS with the standard fields miniapps read:\n *\n *   window.MentraOS = {\n *     platform, packageName?, capabilities, safeAreaInsets, capsuleMenu,\n *     miniappLocal?, miniappDeveloperMode?\n *   }\n *\n * Also defines a stub window.receiveNativeMessage so the miniapp can safely\n * assign to it before the native bridge wires in.\n */\nexport function buildMiniappGlobalsScript(opts: BuildMiniappGlobalsOptions): string {\n  const capsuleTopOffset = opts.webviewFillsStatusBar ? opts.safeAreaInsets.top : 0\n  const globals: Record<string, unknown> = {\n    platform: Platform.OS,\n    capabilities: opts.capabilities ?? [\"share\", \"open_url\", \"copy_clipboard\", \"download\"],\n    safeAreaInsets: opts.safeAreaInsets,\n    capsuleMenu: getCapsuleMenuRect(capsuleTopOffset),\n  }\n  if (opts.packageName) globals.packageName = opts.packageName\n  if (opts.miniappLocal) globals.miniappLocal = true\n  if (opts.miniappDeveloperMode) globals.miniappDeveloperMode = true\n  if (opts.colorScheme) globals.colorScheme = opts.colorScheme\n\n  // CSS custom properties that mirror the capsule menu / safe-area data.\n  // Miniapp CSS (or Tailwind arbitrary values) can read these without\n  // touching JS: e.g. `style=\"margin-top: var(--mentra-capsule-top)\"`.\n  const capsule = globals.capsuleMenu as CapsuleMenuRect\n  const insets = opts.safeAreaInsets\n  const capsuleCenter = capsule.top + capsule.height / 2\n  const cssVars: Record<string, string> = {\n    \"--mentra-safe-top\": `${insets.top}px`,\n    \"--mentra-safe-bottom\": `${insets.bottom}px`,\n    \"--mentra-safe-left\": `${insets.left}px`,\n    \"--mentra-safe-right\": `${insets.right}px`,\n    \"--mentra-capsule-top\": `${capsule.top}px`,\n    \"--mentra-capsule-bottom\": `${capsule.bottom}px`,\n    \"--mentra-capsule-left\": `${capsule.left}px`,\n    \"--mentra-capsule-right\": `${capsule.right}px`,\n    \"--mentra-capsule-width\": `${capsule.width}px`,\n    \"--mentra-capsule-height\": `${capsule.height}px`,\n    \"--mentra-capsule-center-y\": `${capsuleCenter}px`,\n    // Right-side gutter to reserve so content doesn't slide under the\n    // capsule: capsule width + 16px breathing room.\n    \"--mentra-capsule-gutter\": `${capsule.width + 16}px`,\n  }\n  const cssVarsBlock = Object.entries(cssVars)\n    .map(([k, v]) => `${k}: ${v};`)\n    .join(\" \")\n\n  // Console-tap shim: wrap console.log/warn/error/info/debug so each call\n  // also forwards a `dev_log` envelope back to the phone via\n  // ReactNativeWebView.postMessage. Dev mode forwards to the laptop's\n  // `mentra-miniapp dev` terminal; non-dev mode falls back to the React\n  // Native log stream (Metro / Xcode console / adb logcat) so installed-\n  // miniapp errors are still inspectable when there's no laptop sidecar.\n  //\n  // Also tap window.onerror and window.onunhandledrejection so synchronous\n  // throws and unhandled promise rejections surface even when the bundle\n  // never gets a chance to call console.error itself.\n  const consoleTapBlock = `\n    (function() {\n      try {\n        var levels = [\"log\", \"warn\", \"error\", \"info\", \"debug\"];\n        var seen = new WeakSet();\n        function safeSerialize(arg) {\n          if (arg instanceof Error) return {__error: true, message: arg.message, stack: arg.stack};\n          if (arg === null || typeof arg !== \"object\") return arg;\n          try {\n            return JSON.parse(JSON.stringify(arg, function(k, v) {\n              if (v !== null && typeof v === \"object\") {\n                if (seen.has(v)) return \"[Circular]\";\n                seen.add(v);\n              }\n              return v;\n            }));\n          } catch (e) {\n            try { return String(arg); } catch (_) { return \"[unserializable]\"; }\n          }\n        }\n        levels.forEach(function(level) {\n          var original = console[level];\n          if (typeof original !== \"function\") return;\n          console[level] = function() {\n            try { original.apply(console, arguments); } catch (_) {}\n            try {\n              var args = Array.prototype.slice.call(arguments).map(safeSerialize);\n              if (window.ReactNativeWebView && typeof window.ReactNativeWebView.postMessage === \"function\") {\n                window.ReactNativeWebView.postMessage(JSON.stringify({\n                  payload: {\n                    type: \"dev_log\",\n                    level: level,\n                    args: args,\n                    packageName: (window.MentraOS && window.MentraOS.packageName) || null,\n                    timestamp: Date.now()\n                  }\n                }));\n              }\n            } catch (_) { /* swallow */ }\n          };\n        });\n      } catch (_) { /* ignore */ }\n\n      // Surface synchronous errors and unhandled promise rejections via the\n      // same dev_log channel — many bundle-startup crashes never get to call\n      // console.error themselves.\n      try {\n        window.addEventListener(\"error\", function(e) {\n          try {\n            if (window.ReactNativeWebView && typeof window.ReactNativeWebView.postMessage === \"function\") {\n              window.ReactNativeWebView.postMessage(JSON.stringify({\n                payload: {\n                  type: \"dev_log\",\n                  level: \"error\",\n                  args: [\"[window.error] \" + (e.message || \"unknown\"), {filename: e.filename, lineno: e.lineno, colno: e.colno, stack: e.error && e.error.stack}],\n                  packageName: (window.MentraOS && window.MentraOS.packageName) || null,\n                  timestamp: Date.now()\n                }\n              }));\n            }\n          } catch (_) {}\n        });\n        window.addEventListener(\"unhandledrejection\", function(e) {\n          try {\n            if (window.ReactNativeWebView && typeof window.ReactNativeWebView.postMessage === \"function\") {\n              var reason = e.reason;\n              var serialized = reason instanceof Error\n                ? {__error: true, message: reason.message, stack: reason.stack}\n                : (typeof reason === \"object\" ? JSON.stringify(reason) : String(reason));\n              window.ReactNativeWebView.postMessage(JSON.stringify({\n                payload: {\n                  type: \"dev_log\",\n                  level: \"error\",\n                  args: [\"[unhandledrejection]\", serialized],\n                  packageName: (window.MentraOS && window.MentraOS.packageName) || null,\n                  timestamp: Date.now()\n                }\n              }));\n            }\n          } catch (_) {}\n        });\n      } catch (_) {}\n    })();\n  `\n\n  // Lock zoom so miniapps feel like apps, not pages: force a non-scalable\n  // viewport meta (overriding whatever the miniapp shipped) and disable\n  // double-tap-zoom via CSS. Re-applies on DOMContentLoaded in case the\n  // miniapp re-writes <head> during boot.\n  return `\n    window.MentraOS = ${JSON.stringify(globals)};\n    window.receiveNativeMessage = window.receiveNativeMessage || function() {};\n    (function() {\n      try {\n        var styleEl = document.createElement(\"style\");\n        styleEl.setAttribute(\"data-mentra-injected\", \"1\");\n        styleEl.textContent =\n          \":root { ${cssVarsBlock} }\" +\n          \"html, body { touch-action: manipulation; -ms-content-zooming: none; }\";\n        (document.head || document.documentElement).appendChild(styleEl);\n      } catch (e) { /* ignore */ }\n\n      function lockViewport() {\n        try {\n          var content = \"width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no, viewport-fit=cover\";\n          var existing = document.querySelector('meta[name=\"viewport\"]');\n          if (existing) {\n            existing.setAttribute(\"content\", content);\n          } else {\n            var meta = document.createElement(\"meta\");\n            meta.setAttribute(\"name\", \"viewport\");\n            meta.setAttribute(\"content\", content);\n            (document.head || document.documentElement).appendChild(meta);\n          }\n        } catch (e) { /* ignore */ }\n      }\n      lockViewport();\n      document.addEventListener(\"DOMContentLoaded\", lockViewport);\n    })();\n    ${consoleTapBlock}\n    true;\n  `\n}\n"]}

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

@@ -0,0 +1,45 @@
+export interface MediaLibrarySaveReceipt {
+    success: boolean;
+    platform: "ios" | "android" | "unknown";
+    uri?: string;
+    identifier?: string;
+    error?: string;
+}
+/**
+ * MediaLibraryPermissions - Handles save-only permissions for camera roll
+ *
+ * Platform behavior:
+ * - iOS: Uses PHOTO_LIBRARY (read-write) so we can manage the MentraOS album
+ * - Android 10+ (API 29+): No permission needed to save your own files to MediaStore
+ * - 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
+     */
+    static checkPermission(): Promise<boolean>;
+    /**
+     * Request permission to save to the camera roll
+     * Note: On Android 10+, this always returns true since no permission is needed
+     */
+    static requestPermission(): Promise<boolean>;
+    /**
+     * Save a file to the photo library in a glasses-specific location (MentraOS album on iOS;
+     * Pictures/MentraOS or Movies/MentraOS on Android 10+).
+     * On Android 10+, this works without any permission.
+     *
+     * IMPORTANT: This method sets the DATE_TAKEN (Android) or creation date (iOS)
+     * metadata to the original capture time, so gallery apps show the correct date.
+     * Also saves files in chronological order for proper "date added" ordering.
+     *
+     * @param filePath - Path to the file to save
+     * @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

@@ -0,0 +1 @@
+{"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"}