@mentra/engine 0.1.0-dev.0 → 0.1.0-dev.1

package/src/services/asg/cameraRollExportLedger.ts

@@ -0,0 +1,122 @@
+import {storage} from "../../utils/storage"
+import {toPortableGalleryPath} from "./galleryPathMigration"
+import type {GalleryAssetReceipt} from "./galleryTransferLedger"
+
+export type CameraRollExportState =
+  | "NOT_REQUESTED"
+  | "LEGACY_UNKNOWN"
+  | "QUEUED"
+  | "RECONCILING"
+  | "EXPORTING"
+  | "EXPORTED"
+  | "BLOCKED_PERMISSION"
+  | "FAILED_RETRYABLE"
+  | "FAILED_PERMANENT"
+  | "MISSING_LOCAL"
+
+export type CameraRollExportPriority = "SOURCE_BARRIER" | "HISTORICAL_BACKFILL"
+
+export interface CameraRollExportEntry {
+  /** Stable identity for one local-file generation. */
+  id: string
+  mediaName: string
+  generation: string
+  filePath: string
+  size: number
+  modified: number
+  isVideo: boolean
+  captureId?: string
+  /** False while this generation is absent from the local index; exported receipts remain as hidden tombstones. */
+  localPresent?: boolean
+  /** True when an older client may already have exported this file without persisting a receipt. */
+  requiresFullLibraryReconciliation?: boolean
+  state: CameraRollExportState
+  priority: CameraRollExportPriority
+  receipt?: GalleryAssetReceipt
+  attempts: number
+  nextRetryAt?: number
+  lastError?: string
+  createdAt: number
+  updatedAt: number
+}
+
+const ENTRY_PREFIX = "asg_camera_roll_export_v1:"
+
+export function cameraRollGeneration(mediaName: string, size: number, modified: number): string {
+  return `${mediaName}:${size}:${modified}`
+}
+
+export function cameraRollEntryId(mediaName: string, size: number, modified: number): string {
+  return encodeURIComponent(cameraRollGeneration(mediaName, size, modified))
+}
+
+class CameraRollExportLedger {
+  private runtimeDocumentDirectory = ""
+
+  setDocumentDirectory(path: string): void {
+    this.runtimeDocumentDirectory = path
+  }
+
+  get(id: string): CameraRollExportEntry | undefined {
+    const result = storage.load<CameraRollExportEntry>(`${ENTRY_PREFIX}${id}`)
+    if (result.is_error()) return undefined
+    return this.toRuntimeEntry(result.value)
+  }
+
+  list(): CameraRollExportEntry[] {
+    return storage
+      .getAllKeys()
+      .filter((key) => key.startsWith(ENTRY_PREFIX))
+      .map((key) => {
+        const result = storage.load<CameraRollExportEntry>(key)
+        return result.is_error() ? undefined : this.toRuntimeEntry(result.value)
+      })
+      .filter((entry): entry is CameraRollExportEntry => !!entry)
+  }
+
+  put(entry: CameraRollExportEntry): CameraRollExportEntry {
+    const updated = {...entry, updatedAt: Date.now()}
+    const result = storage.save(`${ENTRY_PREFIX}${entry.id}`, this.toStoredEntry(updated))
+    if (result.is_error()) throw result.error
+    return updated
+  }
+
+  update(id: string, patch: Partial<CameraRollExportEntry>): CameraRollExportEntry {
+    const current = this.get(id)
+    if (!current) throw new Error(`Camera-roll export entry missing: ${id}`)
+    return this.put({...current, ...patch, id})
+  }
+
+  remove(id: string): void {
+    const result = storage.remove(`${ENTRY_PREFIX}${id}`)
+    if (result.is_error()) throw result.error
+  }
+
+  removeForMedia(mediaName: string): void {
+    for (const entry of this.list()) {
+      if (entry.mediaName === mediaName) this.remove(entry.id)
+    }
+  }
+
+  clear(): void {
+    const keys = storage.getAllKeys().filter((key) => key.startsWith(ENTRY_PREFIX))
+    if (keys.length === 0) return
+    const result = storage.removeMultiple(keys)
+    if (result.is_error()) throw result.error
+  }
+
+  private toStoredEntry(entry: CameraRollExportEntry): CameraRollExportEntry {
+    if (!this.runtimeDocumentDirectory) return entry
+    return {
+      ...entry,
+      filePath: toPortableGalleryPath(entry.filePath, this.runtimeDocumentDirectory) || entry.filePath,
+    }
+  }
+
+  private toRuntimeEntry(entry: CameraRollExportEntry): CameraRollExportEntry {
+    if (!this.runtimeDocumentDirectory || entry.filePath.startsWith("/")) return entry
+    return {...entry, filePath: `${this.runtimeDocumentDirectory}/${entry.filePath}`}
+  }
+}
+
+export const cameraRollExportLedger = new CameraRollExportLedger()

package/src/services/asg/galleryNotices.ts

@@ -12,6 +12,7 @@ export type GalleryNoticeCode =
   | "wifi_initializing"
   | "wifi_off"
   | "location_services_off"
+  | "camera_roll_permission_required"
   | "connect_to_glasses"
 
 export interface GalleryNotice {

package/src/services/asg/galleryPathMigration.ts

@@ -0,0 +1,22 @@
+/** Convert current or legacy app-container paths into a portable Documents-relative path. */
+export function toPortableGalleryPath(path: string, documentDirectoryPath: string): string | null {
+  if (!path) return null
+  const cleanPath = path.replace(/^file:\/\//, "")
+  const docPath = documentDirectoryPath.replace(/\/$/, "")
+  let candidate: string | null = null
+  if (cleanPath.startsWith(`${docPath}/`)) candidate = cleanPath.substring(docPath.length + 1)
+  else if (!cleanPath.startsWith("/")) candidate = cleanPath.replace(/^\/+/, "")
+
+  if (!candidate) {
+    const documentsMarker = "/Documents/"
+    const documentsIndex = cleanPath.indexOf(documentsMarker)
+    if (documentsIndex >= 0) candidate = cleanPath.substring(documentsIndex + documentsMarker.length)
+  }
+
+  if (!candidate || candidate.includes("\0")) return null
+  const segments = candidate.split("/")
+  if (segments[0] !== "MentraPhotos" || segments.some((segment) => !segment || segment === "." || segment === "..")) {
+    return null
+  }
+  return segments.join("/")
+}

package/src/services/asg/gallerySettingsService.ts

@@ -2,6 +2,7 @@ import {storage} from "../../utils/storage/storage"
 
 export interface GallerySettings {
   autoSaveToCameraRoll: boolean
+  autoSaveDisableWarningShown: boolean
   imageProcessingEnabled: boolean
 }
 
@@ -10,6 +11,7 @@ export class GallerySettingsService {
   private readonly SETTINGS_KEY = "gallery_settings"
   private readonly DEFAULT_SETTINGS: GallerySettings = {
     autoSaveToCameraRoll: true, // Default ON
+    autoSaveDisableWarningShown: false,
     imageProcessingEnabled: true, // Lens coefficients calibrated from chessboard photos
   }
 
@@ -39,6 +41,7 @@ export class GallerySettingsService {
     const res = await storage.save(this.SETTINGS_KEY, updated)
     if (res.is_error()) {
       console.error("[GallerySettings] Error saving settings:", res.error)
+      throw res.error
     }
     console.log("[GallerySettings] Settings updated:", updated)
   }