@mentra/engine 0.1.0-dev.0

package/build/services/AutomaticReportResult.js

@@ -0,0 +1,29 @@
+export function toAutomaticReportSubmissionStatus(result) {
+    if (result.status === "submitted") {
+        return { status: "filed", reportId: result.reportId };
+    }
+    if (result.status === "skipped") {
+        return { status: "skipped", reason: result.reason };
+    }
+    return { status: "failed", error: result.error };
+}
+export function automaticReportErrorStatus(error) {
+    return { status: "failed", error: error instanceof Error ? error.message : String(error) };
+}
+export function logAutomaticReportSubmissionStatus(logTag, result, ...throttleDetails) {
+    if (result.status === "filed") {
+        console.log(`[${logTag}] Report filed:`, result.reportId);
+        return;
+    }
+    if (result.status === "skipped") {
+        console.log(`[${logTag}] Skipping automatic report within throttle window:`, ...(throttleDetails.length > 0 ? throttleDetails : [result.reason]));
+        return;
+    }
+    console.error(`[${logTag}] submit failed:`, result.error);
+}
+export function logUnexpectedAutomaticReportError(logTag, error) {
+    const result = automaticReportErrorStatus(error);
+    console.error(`[${logTag}] Unexpected error:`, error);
+    return result;
+}
+//# sourceMappingURL=AutomaticReportResult.js.map

package/build/services/AutomaticReportResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutomaticReportResult.js","sourceRoot":"","sources":["../../src/services/AutomaticReportResult.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,iCAAiC,CAAC,MAA0B;IAC1E,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,EAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAC,CAAA;IACrD,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,EAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAC,CAAA;IACnD,CAAC;IACD,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAC,CAAA;AAC1F,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,MAAc,EACd,MAAuC,EACvC,GAAG,eAA0B;IAE7B,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,iBAAiB,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;QACzD,OAAM;IACR,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CACT,IAAI,MAAM,qDAAqD,EAC/D,GAAG,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CACpE,CAAA;QACD,OAAM;IACR,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,kBAAkB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,MAAc,EACd,KAAc;IAEd,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAA;IAChD,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,qBAAqB,EAAE,KAAK,CAAC,CAAA;IACrD,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import type {ReportSubmitResult} from \"../facades/reports\"\n\nexport type AutomaticReportSubmissionStatus =\n  | {status: \"filed\"; reportId: string}\n  | {status: \"skipped\"; reason: string}\n  | {status: \"failed\"; error: string}\n\nexport function toAutomaticReportSubmissionStatus(result: ReportSubmitResult): AutomaticReportSubmissionStatus {\n  if (result.status === \"submitted\") {\n    return {status: \"filed\", reportId: result.reportId}\n  }\n  if (result.status === \"skipped\") {\n    return {status: \"skipped\", reason: result.reason}\n  }\n  return {status: \"failed\", error: result.error}\n}\n\nexport function automaticReportErrorStatus(error: unknown): Extract<AutomaticReportSubmissionStatus, {status: \"failed\"}> {\n  return {status: \"failed\", error: error instanceof Error ? error.message : String(error)}\n}\n\nexport function logAutomaticReportSubmissionStatus(\n  logTag: string,\n  result: AutomaticReportSubmissionStatus,\n  ...throttleDetails: unknown[]\n): void {\n  if (result.status === \"filed\") {\n    console.log(`[${logTag}] Report filed:`, result.reportId)\n    return\n  }\n  if (result.status === \"skipped\") {\n    console.log(\n      `[${logTag}] Skipping automatic report within throttle window:`,\n      ...(throttleDetails.length > 0 ? throttleDetails : [result.reason]),\n    )\n    return\n  }\n  console.error(`[${logTag}] submit failed:`, result.error)\n}\n\nexport function logUnexpectedAutomaticReportError(\n  logTag: string,\n  error: unknown,\n): Extract<AutomaticReportSubmissionStatus, {status: \"failed\"}> {\n  const result = automaticReportErrorStatus(error)\n  console.error(`[${logTag}] Unexpected error:`, error)\n  return result\n}\n"]}

package/build/services/BlobStore.d.ts

@@ -0,0 +1,91 @@
+/**
+ * BlobStore
+ *
+ * Host-side implementation of `session.blob` — persistent, per-(userId,
+ * packageName) BINARY storage for local miniapps, keyed like SimpleStorage (its
+ * small-string sibling). Extracted from LocalMiniappRuntime the same way
+ * NavigationHandlers is, to keep the runtime file small.
+ *
+ * Generic byte store — it knows nothing about any specific format. Highlights:
+ *   - chunked write/read (BLOB_CREATE/WRITE/COMMIT, BLOB_OPEN_READ/READ) so no
+ *     single bridge message is large;
+ *   - `setFromUrl` downloads a URL straight to disk (File.downloadFileAsync) and
+ *     `importFile` runs the OS picker (File.pickFileAsync) — both keep bytes
+ *     entirely host-side;
+ *   - `share` hands a stored file to the OS share sheet.
+ *
+ * Layout (mirrors SimpleStorage's scoping):
+ *   bytes:    Paths.document/mentra_blobs/{userId}/{packageName}/{fileName}
+ *   metadata: MMKV key  mentraos_blobmeta_{userId}_{packageName}_{key}  → StoredBlobMeta JSON
+ *
+ * The on-disk file name is a generated id plus a mime-derived extension (iOS
+ * AVPlayer keys a local file's format off the path extension, so blobs played
+ * via `session.speaker.play` must carry one); the logical `key` (caller-chosen)
+ * is the MMKV key. This decouples the filesystem from arbitrary caller keys.
+ *
+ * expo-file-system's new API is synchronous (create/writeBytes/md5/size), so
+ * streaming chunk writes do no async work.
+ */
+import { MiniappErrorCode } from "@mentra/miniapp";
+/** Per-app blob quota: 1 GB. */
+export declare const BLOB_QUOTA_BYTES: number;
+type SendResult = (packageName: string, requestId: string | undefined, ok: boolean, result?: unknown, error?: {
+    code: MiniappErrorCode;
+    message: string;
+}) => void;
+export interface BlobStoreHooks {
+    sendResult: SendResult;
+    /** Resolve the current user id (same source SimpleStorage uses). */
+    getUserId: () => string;
+}
+export declare class BlobStore {
+    private readonly hooks;
+    private readonly uploads;
+    private readonly readers;
+    /** packageName → committed usage bytes, cached; invalidated on commit/delete/clear. */
+    private readonly usageCache;
+    constructor(hooks: BlobStoreHooks);
+    private dirFor;
+    private metaPrefix;
+    private metaKey;
+    private uploadKey;
+    private readMeta;
+    private writeMeta;
+    private allMeta;
+    private fileFor;
+    /** Public API shape: stored meta + derived file:// uri. */
+    private toBlobMeta;
+    private committedUsage;
+    private bumpUsage;
+    private safeMd5;
+    private makeId;
+    /** Would storing `incoming` bytes under `key` exceed the per-app quota? */
+    private overQuota;
+    /** Publish a file already sitting at `fileName` as the blob for `key`; returns its public meta. */
+    private commitFile;
+    handleCreate(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
+    handleWrite(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
+    handleCommit(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
+    handleAbort(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
+    handleSetFromUrl(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
+    handleImport(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
+    handleGet(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
+    handleList(packageName: string, _payload: Record<string, unknown>, requestId?: string): void;
+    handleUsage(packageName: string, _payload: Record<string, unknown>, requestId?: string): void;
+    handleDelete(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
+    handleClear(packageName: string, _payload: Record<string, unknown>, requestId?: string): void;
+    handleOpenRead(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
+    handleRead(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
+    handleCloseRead(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
+    handleShare(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
+    /** Called from LocalMiniappRuntime.unregisterApp — drop this app's in-flight state. */
+    onAppGone(packageName: string): void;
+    /** Abort in-flight uploads + close open read handles for an app (no-op if none). */
+    private closeAppHandles;
+    private discardUpload;
+    private dropMeta;
+    private deleteFileQuiet;
+    private fail;
+}
+export {};
+//# sourceMappingURL=BlobStore.d.ts.map

package/build/services/BlobStore.d.ts.map

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