@mentra/engine 0.1.0-beta.0

package/build/internal.d.ts

@@ -0,0 +1,67 @@
+/**
+ * `@mentra/engine/internal` — the migration-era runtime surface.
+ *
+ * Raw zustand stores and service singletons that the Mentra app's host-side
+ * services (and the `@/stores/*` / `@/utils/*` shims) still reach into while
+ * the typed `engine` facades grow. Everything here either mutates runtime
+ * state or exposes a store/service directly, so none of it belongs on the
+ * OEM-facing `@mentra/engine` main entry: new host code should read/act
+ * through `engine.*` instead.
+ *
+ * Every `/internal` import in mobile/src is counted (report-only) by
+ * scripts/check-mobile-runtime-boundary.sh; the burn-down plan is
+ * cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.
+ * Types that only describe these internal surfaces live here with them;
+ * types host UI renders with stay on the main entry.
+ */
+export { default as webviewBridge } from "./services/WebviewBridge";
+export { default as appRegistry, normalizeManifestPermissions, normalizeManifestActions, buildHardwareRequirements, saveLocalAppRunningState, registerDevApp, unregisterDevApp, getDevAppRecords, getDevAppSourcePackage, getDevAppAttestation, DEV_APP_PACKAGE_NAME, type DevAppRecord, } from "./services/AppRegistry";
+export { default as displayProcessor } from "./services/DisplayProcessor";
+export { default as localDisplayManager, type DisplayPayload } from "./services/LocalDisplayManager";
+export { default as localMiniappRuntime, type InstalledMiniappManifest } from "./services/LocalMiniappRuntime";
+export { miniappLauncher, type LaunchHints, type LaunchResult, type ResolvedBundle } from "./services/MiniappLauncher";
+export { MentraJSRouter, type MentraJSCrustBinding, type OutboundMessagePayload as MentraJSOutboundMessage, type RouterLogger as MentraJSRouterLogger, } from "./services/MentraJSRouter";
+export { buildMentraUiShim, type MentraUiShimOptions } from "./services/mentraUiShim";
+export { MentraUIRouter, type MentraUICrustBinding } from "./services/MentraUIRouter";
+export { MentraJSCrashController, type CrashState, type CrashOutcome, type CrashControllerOptions, } from "./services/MentraJSCrashController";
+export { ensureMiniappEngine, getMiniappEngine, type MiniappEngine } from "./services/MiniappEngine";
+export { redactSecrets, MentraJSLogThrottle, MentraJSLogRingBuffer, type ThrottleOptions, } from "./services/MentraJSLogPipeline";
+export { buildMiniappGlobalsScript, getCapsuleMenuRect, type BuildMiniappGlobalsOptions, type CapsuleMenuRect, type MiniappColorScheme, type MiniappSafeArea, } from "./utils/miniappGlobals";
+export { default as localSttFallbackCoordinator } from "./services/LocalSttFallbackCoordinator";
+export { default as micStateCoordinator } from "./services/MicStateCoordinator";
+export { default as audioPlaybackService } from "./services/AudioPlaybackService";
+export { default as sttModelManager, STTModelManager, type LanguageInfo as SttLanguageInfo, type LanguageConfig as SttLanguageConfig, type DownloadProgress as SttDownloadProgress, type ExtractionProgress as SttExtractionProgress, } from "./services/STTModelManager";
+export { default as ttsModelManager, TTSModelManager } from "./services/TTSModelManager";
+export { default as offlineSpeechModelService, type DownloadStatus as OfflineModelDownloadStatus, type DownloadStage as OfflineModelDownloadStage, } from "./services/OfflineSpeechModelService";
+export { default as navigationService } from "./services/NavigationService";
+export { phoneLocationService, stopPhoneLocation } from "./services/PhoneLocationService";
+export { fixGlassesClockIfSkewed, maybeFixGlassesClockFromVersionInfo } from "./services/glassesClockSync";
+export { getAsgOtaVersionUrl } from "./services/asgOtaVersionUrl";
+export { fetchVersionInfo, checkVersionUpdateAvailable, getLatestVersionInfo, findMatchingMtkPatch, checkBesUpdate, checkForOtaUpdate, checkCurrentGlassesForUpdate, } from "./services/OtaUpdateCheckService";
+export { detectClockSkew, isSyncManifestEmpty, CLOCK_SKEW_TOLERANCE_MS } from "./services/gallerySyncClock";
+export { gallerySyncService } from "./services/asg/gallerySyncService";
+export { asgCameraApi } from "./services/asg/asgCameraApi";
+export { localStorageService } from "./services/asg/localStorageService";
+export { mediaProcessingQueue } from "./services/asg/mediaProcessingQueue";
+export { gallerySettingsService } from "./services/asg/gallerySettingsService";
+export { cameraRollExportCoordinator, type CameraRollExportSummary } from "./services/asg/cameraRollExportCoordinator";
+export { INVALID_DOWNLOADED_MEDIA, validateCaptureMetadataForDownload, validateDownloadedMediaFile, } from "./services/asg/galleryMediaValidation";
+export { emitGalleryNotice, onGalleryNotice } from "./services/asg/galleryNotices";
+export { phonePhotoCoordinator } from "./services/PhonePhotoCoordinator";
+export { phoneStreamCoordinator } from "./services/PhoneStreamCoordinator";
+export { useDisplayStore, flushDisplayCoalesceForTests } from "./stores/display";
+export { useCoreStore } from "./stores/core";
+export { useConnectionStore } from "./stores/connection";
+export { useCloudClientStatusStore } from "./stores/cloudClientStatus";
+export type { RuntimeAudioTransport, RuntimeSnapshot, RuntimeStatus } from "./stores/cloudClientStatus";
+export { SETTINGS, OFFLINE_APPLETS, useSettingsStore, useSetting } from "./stores/settings";
+export { MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice } from "./stores/bluetoothSettingKeys";
+export { useAppStatusStore, installAppStoreHooks, type AppStoreHooks } from "./stores/apps";
+export { cloudSecureStore } from "./utils/cloudClient/cloudSecureStore";
+export { cloudClientService } from "./services/CloudClientService";
+export { createCloudUdpSocket } from "./utils/cloudClient/RnUdpAdapter";
+export { logBuffer, type LogEntry } from "./utils/devLogging";
+export { default as BluetoothSdk } from "@mentra/bluetooth-sdk/internal";
+export { storage, printDirectory } from "./utils/storage";
+export { default as GlobalEventEmitter } from "./utils/GlobalEventEmitter";
+//# sourceMappingURL=internal.d.ts.map

package/build/internal.d.ts.map

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

package/build/internal.js

@@ -0,0 +1,90 @@
+/**
+ * `@mentra/engine/internal` — the migration-era runtime surface.
+ *
+ * Raw zustand stores and service singletons that the Mentra app's host-side
+ * services (and the `@/stores/*` / `@/utils/*` shims) still reach into while
+ * the typed `engine` facades grow. Everything here either mutates runtime
+ * state or exposes a store/service directly, so none of it belongs on the
+ * OEM-facing `@mentra/engine` main entry: new host code should read/act
+ * through `engine.*` instead.
+ *
+ * Every `/internal` import in mobile/src is counted (report-only) by
+ * scripts/check-mobile-runtime-boundary.sh; the burn-down plan is
+ * cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.
+ * Types that only describe these internal surfaces live here with them;
+ * types host UI renders with stay on the main entry.
+ */
+// Miniapp runtime plumbing: WebView bridge, registry, launcher, engine.
+export { default as webviewBridge } from "./services/WebviewBridge";
+export { default as appRegistry, normalizeManifestPermissions, normalizeManifestActions, buildHardwareRequirements, saveLocalAppRunningState, registerDevApp, unregisterDevApp, getDevAppRecords, getDevAppSourcePackage, getDevAppAttestation, DEV_APP_PACKAGE_NAME, } from "./services/AppRegistry";
+export { default as displayProcessor } from "./services/DisplayProcessor";
+export { default as localDisplayManager } from "./services/LocalDisplayManager";
+export { default as localMiniappRuntime } from "./services/LocalMiniappRuntime";
+export { miniappLauncher } from "./services/MiniappLauncher";
+export { MentraJSRouter, } from "./services/MentraJSRouter";
+export { buildMentraUiShim } from "./services/mentraUiShim";
+export { MentraUIRouter } from "./services/MentraUIRouter";
+export { MentraJSCrashController, } from "./services/MentraJSCrashController";
+export { ensureMiniappEngine, getMiniappEngine } from "./services/MiniappEngine";
+export { redactSecrets, MentraJSLogThrottle, MentraJSLogRingBuffer, } from "./services/MentraJSLogPipeline";
+// WebView-injection script builders (miniapp globals + mentra-ui shim).
+export { buildMiniappGlobalsScript, getCapsuleMenuRect, } from "./utils/miniappGlobals";
+// Speech/audio coordinators and model managers.
+export { default as localSttFallbackCoordinator } from "./services/LocalSttFallbackCoordinator";
+export { default as micStateCoordinator } from "./services/MicStateCoordinator";
+export { default as audioPlaybackService } from "./services/AudioPlaybackService";
+export { default as sttModelManager, STTModelManager, } from "./services/STTModelManager";
+export { default as ttsModelManager, TTSModelManager } from "./services/TTSModelManager";
+export { default as offlineSpeechModelService, } from "./services/OfflineSpeechModelService";
+export { default as navigationService } from "./services/NavigationService";
+// Phone GPS — the background location task + tier control. Importing this
+// module registers the background task, so the entry that MantleManager loads
+// must keep re-exporting it (was: the main barrel).
+export { phoneLocationService, stopPhoneLocation } from "./services/PhoneLocationService";
+// Clock-skew fix commands (BLE writes) used by OTA + gallery sync.
+export { fixGlassesClockIfSkewed, maybeFixGlassesClockFromVersionInfo } from "./services/glassesClockSync";
+// OTA manifest-URL resolution (dev-override/legacy-build/env/prod).
+export { getAsgOtaVersionUrl } from "./services/asgOtaVersionUrl";
+// Flat OTA check helpers (network + BLE state). Host usage is a tracked
+// burn-down surface (§F); the sanctioned path is engine.ota.checkForUpdates().
+export { fetchVersionInfo, checkVersionUpdateAvailable, getLatestVersionInfo, findMatchingMtkPatch, checkBesUpdate, checkForOtaUpdate, checkCurrentGlassesForUpdate, } from "./services/OtaUpdateCheckService";
+// Gallery cluster — sync orchestrator, glasses-camera HTTP API, media/storage,
+// settings, validation and the service-to-service notice bus. Host gallery UI
+// renders engine.gallery; these are the underlying services.
+export { detectClockSkew, isSyncManifestEmpty, CLOCK_SKEW_TOLERANCE_MS } from "./services/gallerySyncClock";
+export { gallerySyncService } from "./services/asg/gallerySyncService";
+export { asgCameraApi } from "./services/asg/asgCameraApi";
+export { localStorageService } from "./services/asg/localStorageService";
+export { mediaProcessingQueue } from "./services/asg/mediaProcessingQueue";
+export { gallerySettingsService } from "./services/asg/gallerySettingsService";
+export { cameraRollExportCoordinator } from "./services/asg/cameraRollExportCoordinator";
+export { INVALID_DOWNLOADED_MEDIA, validateCaptureMetadataForDownload, validateDownloadedMediaFile, } from "./services/asg/galleryMediaValidation";
+export { emitGalleryNotice, onGalleryNotice } from "./services/asg/galleryNotices";
+// Phone-side capture coordinators.
+export { phonePhotoCoordinator } from "./services/PhonePhotoCoordinator";
+export { phoneStreamCoordinator } from "./services/PhoneStreamCoordinator";
+// Raw runtime stores (re-exported via the host @/stores/* shims). Read models
+// live on the engine facades; these are the migration escape hatch.
+export { useDisplayStore, flushDisplayCoalesceForTests } from "./stores/display";
+export { useCoreStore } from "./stores/core";
+export { useConnectionStore } from "./stores/connection";
+export { useCloudClientStatusStore } from "./stores/cloudClientStatus";
+export { SETTINGS, OFFLINE_APPLETS, useSettingsStore, useSetting } from "./stores/settings";
+export { MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice } from "./stores/bluetoothSettingKeys";
+export { useAppStatusStore, installAppStoreHooks } from "./stores/apps";
+// Cloud client + credentials + v1 comms.
+export { cloudSecureStore } from "./utils/cloudClient/cloudSecureStore";
+export { cloudClientService } from "./services/CloudClientService";
+export { createCloudUdpSocket } from "./utils/cloudClient/RnUdpAdapter";
+// Log ring buffer + console interception (bug-report attachments).
+export { logBuffer } from "./utils/devLogging";
+// Bluetooth SDK internal compatibility passthrough. Prefer an engine facade
+// when one exists; this remains an escape hatch for app-only compatibility
+// needs (its event TYPES stay on the main entry).
+export { default as BluetoothSdk } from "@mentra/bluetooth-sdk/internal";
+// Engine-owned MMKV instance + debug helper.
+export { storage, printDirectory } from "./utils/storage";
+// Process-wide event bus — one shared instance for engine services + host
+// (re-exported via the @/utils/GlobalEventEmitter shim).
+export { default as GlobalEventEmitter } from "./utils/GlobalEventEmitter";
+//# sourceMappingURL=internal.js.map

package/build/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `@mentra/engine/internal` — the migration-era runtime surface.\n *\n * Raw zustand stores and service singletons that the Mentra app's host-side\n * services (and the `@/stores/*` / `@/utils/*` shims) still reach into while\n * the typed `engine` facades grow. Everything here either mutates runtime\n * state or exposes a store/service directly, so none of it belongs on the\n * OEM-facing `@mentra/engine` main entry: new host code should read/act\n * through `engine.*` instead.\n *\n * Every `/internal` import in mobile/src is counted (report-only) by\n * scripts/check-mobile-runtime-boundary.sh; the burn-down plan is\n * cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.\n * Types that only describe these internal surfaces live here with them;\n * types host UI renders with stay on the main entry.\n */\n\n// Miniapp runtime plumbing: WebView bridge, registry, launcher, engine.\nexport {default as webviewBridge} from \"./services/WebviewBridge\"\nexport {\n  default as appRegistry,\n  normalizeManifestPermissions,\n  normalizeManifestActions,\n  buildHardwareRequirements,\n  saveLocalAppRunningState,\n  registerDevApp,\n  unregisterDevApp,\n  getDevAppRecords,\n  getDevAppSourcePackage,\n  getDevAppAttestation,\n  DEV_APP_PACKAGE_NAME,\n  type DevAppRecord,\n} from \"./services/AppRegistry\"\nexport {default as displayProcessor} from \"./services/DisplayProcessor\"\nexport {default as localDisplayManager, type DisplayPayload} from \"./services/LocalDisplayManager\"\nexport {default as localMiniappRuntime, type InstalledMiniappManifest} from \"./services/LocalMiniappRuntime\"\nexport {miniappLauncher, type LaunchHints, type LaunchResult, type ResolvedBundle} from \"./services/MiniappLauncher\"\nexport {\n  MentraJSRouter,\n  type MentraJSCrustBinding,\n  type OutboundMessagePayload as MentraJSOutboundMessage,\n  type RouterLogger as MentraJSRouterLogger,\n} from \"./services/MentraJSRouter\"\nexport {buildMentraUiShim, type MentraUiShimOptions} from \"./services/mentraUiShim\"\nexport {MentraUIRouter, type MentraUICrustBinding} from \"./services/MentraUIRouter\"\nexport {\n  MentraJSCrashController,\n  type CrashState,\n  type CrashOutcome,\n  type CrashControllerOptions,\n} from \"./services/MentraJSCrashController\"\nexport {ensureMiniappEngine, getMiniappEngine, type MiniappEngine} from \"./services/MiniappEngine\"\nexport {\n  redactSecrets,\n  MentraJSLogThrottle,\n  MentraJSLogRingBuffer,\n  type ThrottleOptions,\n} from \"./services/MentraJSLogPipeline\"\n// WebView-injection script builders (miniapp globals + mentra-ui shim).\nexport {\n  buildMiniappGlobalsScript,\n  getCapsuleMenuRect,\n  type BuildMiniappGlobalsOptions,\n  type CapsuleMenuRect,\n  type MiniappColorScheme,\n  type MiniappSafeArea,\n} from \"./utils/miniappGlobals\"\n\n// Speech/audio coordinators and model managers.\nexport {default as localSttFallbackCoordinator} from \"./services/LocalSttFallbackCoordinator\"\nexport {default as micStateCoordinator} from \"./services/MicStateCoordinator\"\nexport {default as audioPlaybackService} from \"./services/AudioPlaybackService\"\nexport {\n  default as sttModelManager,\n  STTModelManager,\n  type LanguageInfo as SttLanguageInfo,\n  type LanguageConfig as SttLanguageConfig,\n  type DownloadProgress as SttDownloadProgress,\n  type ExtractionProgress as SttExtractionProgress,\n} from \"./services/STTModelManager\"\nexport {default as ttsModelManager, TTSModelManager} from \"./services/TTSModelManager\"\nexport {\n  default as offlineSpeechModelService,\n  type DownloadStatus as OfflineModelDownloadStatus,\n  type DownloadStage as OfflineModelDownloadStage,\n} from \"./services/OfflineSpeechModelService\"\n\nexport {default as navigationService} from \"./services/NavigationService\"\n// Phone GPS — the background location task + tier control. Importing this\n// module registers the background task, so the entry that MantleManager loads\n// must keep re-exporting it (was: the main barrel).\nexport {phoneLocationService, stopPhoneLocation} from \"./services/PhoneLocationService\"\n// Clock-skew fix commands (BLE writes) used by OTA + gallery sync.\nexport {fixGlassesClockIfSkewed, maybeFixGlassesClockFromVersionInfo} from \"./services/glassesClockSync\"\n// OTA manifest-URL resolution (dev-override/legacy-build/env/prod).\nexport {getAsgOtaVersionUrl} from \"./services/asgOtaVersionUrl\"\n// Flat OTA check helpers (network + BLE state). Host usage is a tracked\n// burn-down surface (§F); the sanctioned path is engine.ota.checkForUpdates().\nexport {\n  fetchVersionInfo,\n  checkVersionUpdateAvailable,\n  getLatestVersionInfo,\n  findMatchingMtkPatch,\n  checkBesUpdate,\n  checkForOtaUpdate,\n  checkCurrentGlassesForUpdate,\n} from \"./services/OtaUpdateCheckService\"\n\n// Gallery cluster — sync orchestrator, glasses-camera HTTP API, media/storage,\n// settings, validation and the service-to-service notice bus. Host gallery UI\n// renders engine.gallery; these are the underlying services.\nexport {detectClockSkew, isSyncManifestEmpty, CLOCK_SKEW_TOLERANCE_MS} from \"./services/gallerySyncClock\"\nexport {gallerySyncService} from \"./services/asg/gallerySyncService\"\nexport {asgCameraApi} from \"./services/asg/asgCameraApi\"\nexport {localStorageService} from \"./services/asg/localStorageService\"\nexport {mediaProcessingQueue} from \"./services/asg/mediaProcessingQueue\"\nexport {gallerySettingsService} from \"./services/asg/gallerySettingsService\"\nexport {cameraRollExportCoordinator, type CameraRollExportSummary} from \"./services/asg/cameraRollExportCoordinator\"\nexport {\n  INVALID_DOWNLOADED_MEDIA,\n  validateCaptureMetadataForDownload,\n  validateDownloadedMediaFile,\n} from \"./services/asg/galleryMediaValidation\"\nexport {emitGalleryNotice, onGalleryNotice} from \"./services/asg/galleryNotices\"\n\n// Phone-side capture coordinators.\nexport {phonePhotoCoordinator} from \"./services/PhonePhotoCoordinator\"\nexport {phoneStreamCoordinator} from \"./services/PhoneStreamCoordinator\"\n\n// Raw runtime stores (re-exported via the host @/stores/* shims). Read models\n// live on the engine facades; these are the migration escape hatch.\nexport {useDisplayStore, flushDisplayCoalesceForTests} from \"./stores/display\"\nexport {useCoreStore} from \"./stores/core\"\nexport {useConnectionStore} from \"./stores/connection\"\nexport {useCloudClientStatusStore} from \"./stores/cloudClientStatus\"\nexport type {RuntimeAudioTransport, RuntimeSnapshot, RuntimeStatus} from \"./stores/cloudClientStatus\"\nexport {SETTINGS, OFFLINE_APPLETS, useSettingsStore, useSetting} from \"./stores/settings\"\nexport {MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice} from \"./stores/bluetoothSettingKeys\"\nexport {useAppStatusStore, installAppStoreHooks, type AppStoreHooks} from \"./stores/apps\"\n\n// Cloud client + credentials + v1 comms.\nexport {cloudSecureStore} from \"./utils/cloudClient/cloudSecureStore\"\nexport {cloudClientService} from \"./services/CloudClientService\"\nexport {createCloudUdpSocket} from \"./utils/cloudClient/RnUdpAdapter\"\n\n// Log ring buffer + console interception (bug-report attachments).\nexport {logBuffer, type LogEntry} from \"./utils/devLogging\"\n\n// Bluetooth SDK internal compatibility passthrough. Prefer an engine facade\n// when one exists; this remains an escape hatch for app-only compatibility\n// needs (its event TYPES stay on the main entry).\nexport {default as BluetoothSdk} from \"@mentra/bluetooth-sdk/internal\"\n\n\n// Engine-owned MMKV instance + debug helper.\nexport {storage, printDirectory} from \"./utils/storage\"\n// Process-wide event bus — one shared instance for engine services + host\n// (re-exported via the @/utils/GlobalEventEmitter shim).\nexport {default as GlobalEventEmitter} from \"./utils/GlobalEventEmitter\"\n"]}

package/build/runtime/bootstrap.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Bootstrap — the engine's single front door (`engine.configure` / `start` / `stop`).
+ *
+ * The host hands engine auth + config + analytics in one call; engine owns the
+ * runtime construction behind `start()`. Internal services read this holder
+ * directly instead of exposing host-facing adapter bags.
+ */
+export type SubjectTokenType = "supabase" | "authing" | (string & {});
+export interface IslandAuth {
+    /** Returns the host's current (auto-refreshed) subject token for the backend. */
+    getSubjectToken: () => Promise<{
+        token: string;
+        type: SubjectTokenType;
+    }>;
+    /**
+     * Optional auth-session listener. Hosts that can emit auth changes should
+     * wire this so engine can reconnect backend sessions after restored login
+     * state lands post-boot.
+     */
+    onStateChange?: (callback: (event: string, session: {
+        token?: string | null;
+    } | null) => void) => unknown;
+}
+export interface IslandConfigValues {
+    /** cloud-v2 core service base URL (defaults resolved by the cloud client). */
+    coreUrl?: string;
+    /** cloud-v2 runtime service base URL. */
+    runtimeUrl?: string;
+    /** OEM identifier (Mentra is OEM #0); reserved for OEM auth/telemetry. */
+    oemId?: string;
+    /**
+     * LC3 frame size (bytes) the phone's mic encoder emits — announced to the
+     * cloud on connect (20 for G1, 40 for G2, …). Defaults to 20 if unset.
+     */
+    audioFrameSizeBytes?: number;
+    /**
+     * Dev-only live Metro/LAN host used to repair persisted local-miniapp dev URLs
+     * after the laptop changes networks. Omitted in production/OEM builds.
+     */
+    devServerHost?: () => string | undefined;
+}
+export type IslandAnalytics = (event: string, props?: Record<string, unknown>) => void;
+/**
+ * Named host-UI seams: engine dispatches the runtime request, the host owns the
+ * screen/navigation/branding. Keep each entry a single narrow purpose — this is
+ * a contract of specific UI capabilities, not a generic runtime-hook bag.
+ */
+export interface IslandUiSeams {
+    /**
+     * `session.glasses.requestWifiSetup` — open the host's glasses Wi-Fi setup
+     * flow. Absent ⇒ miniapps get NOT_IMPLEMENTED for the request.
+     */
+    requestWifiSetup?: (reason?: string) => Promise<void> | void;
+}
+export interface IslandConfigureOptions {
+    /** REQUIRED — the only must-have seam. The host owns login; engine owns the rest. */
+    auth: IslandAuth;
+    config?: IslandConfigValues;
+    analytics?: IslandAnalytics;
+    ui?: IslandUiSeams;
+}
+/**
+ * Hand engine its auth + config + analytics. Call once, before `start()`.
+ *
+ * Reconfiguring a RUNNING runtime is not supported: services capture pieces of
+ * this config as they build (e.g. the cloud client's endpoints), so swapping the
+ * options mid-run would split-brain the runtime (`getAuth()`/`getConfigValues()`
+ * report values the running services never consumed). Ignored with a warning
+ * while started; after `stop()`, `configure()` + `start()` begin a fresh cycle.
+ */
+export declare function configure(opts: IslandConfigureOptions): void;
+/** Mark the runtime started. Idempotent. */
+export declare function start(): Promise<void>;
+/** Tear down. Idempotent. */
+export declare function stop(): Promise<void>;
+export declare function isStarted(): boolean;
+/** The host-supplied auth provider, or null if not configured yet. */
+export declare function getAuth(): IslandAuth | null;
+export declare function getConfigValues(): IslandConfigValues;
+export declare function getAnalytics(): IslandAnalytics | null;
+/** The host-supplied UI seams ({} until configure() provides them). */
+export declare function getUiSeams(): IslandUiSeams;
+//# sourceMappingURL=bootstrap.d.ts.map

package/build/runtime/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/runtime/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAErE,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,eAAe,EAAE,MAAM,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAC,CAAC,CAAA;IACvE;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,GAAG,IAAI,KAAK,IAAI,KAAK,OAAO,CAAA;CACxG;AAED,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;CACzC;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;AAEtF;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC7D;AAED,MAAM,WAAW,sBAAsB;IACrC,qFAAqF;IACrF,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,EAAE,CAAC,EAAE,aAAa,CAAA;CACnB;AAKD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAM5D;AAED,4CAA4C;AAC5C,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3C;AAED,6BAA6B;AAC7B,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1C;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,sEAAsE;AACtE,wBAAgB,OAAO,IAAI,UAAU,GAAG,IAAI,CAE3C;AAED,wBAAgB,eAAe,IAAI,kBAAkB,CAEpD;AAED,wBAAgB,YAAY,IAAI,eAAe,GAAG,IAAI,CAErD;AAED,uEAAuE;AACvE,wBAAgB,UAAU,IAAI,aAAa,CAE1C"}

package/build/runtime/bootstrap.js

@@ -0,0 +1,56 @@
+/**
+ * Bootstrap — the engine's single front door (`engine.configure` / `start` / `stop`).
+ *
+ * The host hands engine auth + config + analytics in one call; engine owns the
+ * runtime construction behind `start()`. Internal services read this holder
+ * directly instead of exposing host-facing adapter bags.
+ */
+let options = null;
+let started = false;
+/**
+ * Hand engine its auth + config + analytics. Call once, before `start()`.
+ *
+ * Reconfiguring a RUNNING runtime is not supported: services capture pieces of
+ * this config as they build (e.g. the cloud client's endpoints), so swapping the
+ * options mid-run would split-brain the runtime (`getAuth()`/`getConfigValues()`
+ * report values the running services never consumed). Ignored with a warning
+ * while started; after `stop()`, `configure()` + `start()` begin a fresh cycle.
+ */
+export function configure(opts) {
+    if (started) {
+        console.warn("engine.configure() called after engine.start(); ignored — stop() the runtime before reconfiguring");
+        return;
+    }
+    options = opts;
+}
+/** Mark the runtime started. Idempotent. */
+export async function start() {
+    if (started)
+        return;
+    if (!options) {
+        throw new Error("engine.start() called before engine.configure()");
+    }
+    started = true;
+}
+/** Tear down. Idempotent. */
+export async function stop() {
+    started = false;
+}
+export function isStarted() {
+    return started;
+}
+/** The host-supplied auth provider, or null if not configured yet. */
+export function getAuth() {
+    return options?.auth ?? null;
+}
+export function getConfigValues() {
+    return options?.config ?? {};
+}
+export function getAnalytics() {
+    return options?.analytics ?? null;
+}
+/** The host-supplied UI seams ({} until configure() provides them). */
+export function getUiSeams() {
+    return options?.ui ?? {};
+}
+//# sourceMappingURL=bootstrap.js.map

package/build/runtime/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/runtime/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyDH,IAAI,OAAO,GAAkC,IAAI,CAAA;AACjD,IAAI,OAAO,GAAG,KAAK,CAAA;AAEnB;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,IAA4B;IACpD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,mGAAmG,CAAC,CAAA;QACjH,OAAM;IACR,CAAC;IACD,OAAO,GAAG,IAAI,CAAA;AAChB,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,IAAI,OAAO;QAAE,OAAM;IACnB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,GAAG,IAAI,CAAA;AAChB,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,OAAO,GAAG,KAAK,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,OAAO;IACrB,OAAO,OAAO,EAAE,IAAI,IAAI,IAAI,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,EAAE,MAAM,IAAI,EAAE,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,EAAE,SAAS,IAAI,IAAI,CAAA;AACnC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,EAAE,EAAE,IAAI,EAAE,CAAA;AAC1B,CAAC","sourcesContent":["/**\n * Bootstrap — the engine's single front door (`engine.configure` / `start` / `stop`).\n *\n * The host hands engine auth + config + analytics in one call; engine owns the\n * runtime construction behind `start()`. Internal services read this holder\n * directly instead of exposing host-facing adapter bags.\n */\n\nexport type SubjectTokenType = \"supabase\" | \"authing\" | (string & {})\n\nexport interface IslandAuth {\n  /** Returns the host's current (auto-refreshed) subject token for the backend. */\n  getSubjectToken: () => Promise<{token: string; type: SubjectTokenType}>\n  /**\n   * Optional auth-session listener. Hosts that can emit auth changes should\n   * wire this so engine can reconnect backend sessions after restored login\n   * state lands post-boot.\n   */\n  onStateChange?: (callback: (event: string, session: {token?: string | null} | null) => void) => unknown\n}\n\nexport interface IslandConfigValues {\n  /** cloud-v2 core service base URL (defaults resolved by the cloud client). */\n  coreUrl?: string\n  /** cloud-v2 runtime service base URL. */\n  runtimeUrl?: string\n  /** OEM identifier (Mentra is OEM #0); reserved for OEM auth/telemetry. */\n  oemId?: string\n  /**\n   * LC3 frame size (bytes) the phone's mic encoder emits — announced to the\n   * cloud on connect (20 for G1, 40 for G2, …). Defaults to 20 if unset.\n   */\n  audioFrameSizeBytes?: number\n  /**\n   * Dev-only live Metro/LAN host used to repair persisted local-miniapp dev URLs\n   * after the laptop changes networks. Omitted in production/OEM builds.\n   */\n  devServerHost?: () => string | undefined\n}\n\nexport type IslandAnalytics = (event: string, props?: Record<string, unknown>) => void\n\n/**\n * Named host-UI seams: engine dispatches the runtime request, the host owns the\n * screen/navigation/branding. Keep each entry a single narrow purpose — this is\n * a contract of specific UI capabilities, not a generic runtime-hook bag.\n */\nexport interface IslandUiSeams {\n  /**\n   * `session.glasses.requestWifiSetup` — open the host's glasses Wi-Fi setup\n   * flow. Absent ⇒ miniapps get NOT_IMPLEMENTED for the request.\n   */\n  requestWifiSetup?: (reason?: string) => Promise<void> | void\n}\n\nexport interface IslandConfigureOptions {\n  /** REQUIRED — the only must-have seam. The host owns login; engine owns the rest. */\n  auth: IslandAuth\n  config?: IslandConfigValues\n  analytics?: IslandAnalytics\n  ui?: IslandUiSeams\n}\n\nlet options: IslandConfigureOptions | null = null\nlet started = false\n\n/**\n * Hand engine its auth + config + analytics. Call once, before `start()`.\n *\n * Reconfiguring a RUNNING runtime is not supported: services capture pieces of\n * this config as they build (e.g. the cloud client's endpoints), so swapping the\n * options mid-run would split-brain the runtime (`getAuth()`/`getConfigValues()`\n * report values the running services never consumed). Ignored with a warning\n * while started; after `stop()`, `configure()` + `start()` begin a fresh cycle.\n */\nexport function configure(opts: IslandConfigureOptions): void {\n  if (started) {\n    console.warn(\"engine.configure() called after engine.start(); ignored — stop() the runtime before reconfiguring\")\n    return\n  }\n  options = opts\n}\n\n/** Mark the runtime started. Idempotent. */\nexport async function start(): Promise<void> {\n  if (started) return\n  if (!options) {\n    throw new Error(\"engine.start() called before engine.configure()\")\n  }\n  started = true\n}\n\n/** Tear down. Idempotent. */\nexport async function stop(): Promise<void> {\n  started = false\n}\n\nexport function isStarted(): boolean {\n  return started\n}\n\n/** The host-supplied auth provider, or null if not configured yet. */\nexport function getAuth(): IslandAuth | null {\n  return options?.auth ?? null\n}\n\nexport function getConfigValues(): IslandConfigValues {\n  return options?.config ?? {}\n}\n\nexport function getAnalytics(): IslandAnalytics | null {\n  return options?.analytics ?? null\n}\n\n/** The host-supplied UI seams ({} until configure() provides them). */\nexport function getUiSeams(): IslandUiSeams {\n  return options?.ui ?? {}\n}\n"]}

package/build/runtime/config.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Runtime-shared constants and DTOs.
+ *
+ * The old host-injected runtime adapter surface has moved behind engine-owned
+ * services and `engine.configure({auth, config, analytics})`. Keep this file
+ * limited to stable types that are shared across those services.
+ */
+export type CloudClientConnectionStatus = "connected" | "connecting" | "reconnecting" | "disconnected";
+export type CloudClientAudioTransport = "udp" | "ws" | "offline" | "none";
+export interface CloudClientStatusSnapshot {
+    status: CloudClientConnectionStatus;
+    audioTransport: CloudClientAudioTransport;
+}
+export interface MiniappAuthToken {
+    mentraUserId: string;
+    tenantId?: string;
+    token: string;
+    expiresAt: number;
+}
+/**
+ * Result of an offline TTS synthesis. The engine's TTSModelManager produces
+ * this directly; the type is kept exported for hosts that wrap it.
+ */
+export interface TtsSynthesisResult {
+    audioUrl: string;
+    cleanup?: () => Promise<void> | void;
+}
+/**
+ * Stable settings keys read by engine services. Hosts must wire their own
+ * settings store keys to these names. Mobile already uses these strings.
+ */
+export declare const ISLAND_SETTINGS_KEYS: {
+    readonly localSttFallbackActive: "local_stt_fallback_active";
+    readonly defaultWearable: "default_wearable";
+    readonly coreToken: "core_token";
+    readonly cameraFov: "camera_fov";
+};
+/**
+ * Navigation event payloads. Mirror the host's NavigationService types but are
+ * duplicated here so the engine module does not import host types.
+ */
+export type NavManeuverEvent = {
+    kind: "maneuver";
+    maneuverType: string;
+    distanceMeters: number;
+    fromRoad?: string | null;
+    toRoad?: string | null;
+    nextStepRoad?: string | null;
+    distanceToDestinationMeters?: number;
+    timeToDestinationSeconds?: number;
+    currentSpeedMps?: number | null;
+    speedLimitMps?: number | null;
+    routeHeadingDeg?: number | null;
+};
+export type NavOffRouteEvent = {
+    kind: "off_route";
+    offRouteDistanceMeters: number;
+};
+export type NavReroutingEvent = {
+    kind: "rerouting";
+};
+export type NavArrivedEvent = {
+    kind: "arrived";
+};
+export type NavErrorEvent = {
+    kind: "error";
+    message: string;
+};
+export type NavUpdate = NavManeuverEvent | NavOffRouteEvent | NavReroutingEvent | NavArrivedEvent | NavErrorEvent;
+export type NavLocation = {
+    lat: number;
+    lng: number;
+    accuracy: number | null;
+    timestamp: number;
+};
+export type NavRouteStep = {
+    lat: number;
+    lng: number;
+    routeIndex: number;
+    road: string | null;
+    maneuver: string;
+    distanceMeters: number;
+};
+export type NavRoute = {
+    points: Array<{
+        lat: number;
+        lng: number;
+    }>;
+    steps?: NavRouteStep[];
+};
+export type NavTripSnapshot = {
+    active: boolean;
+    mode?: string;
+    stops?: Array<{
+        lat: number;
+        lng: number;
+    }>;
+    currentStopIndex?: number;
+    route?: NavRoute;
+    maneuver?: NavManeuverEvent;
+    distanceToDestinationMeters?: number;
+    timeToDestinationSeconds?: number;
+    currentSpeedMps?: number | null;
+    speedLimitMps?: number | null;
+};
+export interface StreamVideoConfig {
+    width?: number;
+    height?: number;
+    bitrate?: number;
+    fps?: number;
+}
+export interface StreamAudioConfig {
+    bitrate?: number;
+    sampleRate?: number;
+    echoCancellation?: boolean;
+    noiseSuppression?: boolean;
+}
+export type CameraRoiPosition = "center" | "bottom" | "top";
+export type CameraFovPreset = "narrow" | "standard" | "wide";
+export type CameraFovRequest = {
+    fov: number;
+    roiPosition?: CameraRoiPosition;
+} | {
+    preset: CameraFovPreset;
+};
+export interface CameraFovResult {
+    requestId: string;
+    fov: number;
+    roiPosition: CameraRoiPosition;
+    timestamp: number;
+}
+/** One audited inter-miniapp call. */
+export interface InteropAuditEvent {
+    /** The system app that made the call. */
+    caller: string;
+    op: "list" | "start" | "stop" | "invoke";
+    /** Target miniapp (start/stop/invoke). */
+    target?: string;
+    /** Action id (invoke only). */
+    actionId?: string;
+    /** True if the call was permitted and accepted; false on denial / pre-flight failure. */
+    ok: boolean;
+    /** MiniappErrorCode when ok is false. */
+    errorCode?: string;
+}
+//# sourceMappingURL=config.d.ts.map

package/build/runtime/config.d.ts.map

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

package/build/runtime/config.js

@@ -0,0 +1,18 @@
+/**
+ * Runtime-shared constants and DTOs.
+ *
+ * The old host-injected runtime adapter surface has moved behind engine-owned
+ * services and `engine.configure({auth, config, analytics})`. Keep this file
+ * limited to stable types that are shared across those services.
+ */
+/**
+ * Stable settings keys read by engine services. Hosts must wire their own
+ * settings store keys to these names. Mobile already uses these strings.
+ */
+export const ISLAND_SETTINGS_KEYS = {
+    localSttFallbackActive: "local_stt_fallback_active",
+    defaultWearable: "default_wearable",
+    coreToken: "core_token",
+    cameraFov: "camera_fov",
+};
+//# sourceMappingURL=config.js.map

package/build/runtime/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/runtime/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0BH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,sBAAsB,EAAE,2BAA2B;IACnD,eAAe,EAAE,kBAAkB;IACnC,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,YAAY;CACf,CAAA","sourcesContent":["/**\n * Runtime-shared constants and DTOs.\n *\n * The old host-injected runtime adapter surface has moved behind engine-owned\n * services and `engine.configure({auth, config, analytics})`. Keep this file\n * limited to stable types that are shared across those services.\n */\n\nexport type CloudClientConnectionStatus = \"connected\" | \"connecting\" | \"reconnecting\" | \"disconnected\"\nexport type CloudClientAudioTransport = \"udp\" | \"ws\" | \"offline\" | \"none\"\n\nexport interface CloudClientStatusSnapshot {\n  status: CloudClientConnectionStatus\n  audioTransport: CloudClientAudioTransport\n}\n\nexport interface MiniappAuthToken {\n  mentraUserId: string\n  tenantId?: string\n  token: string\n  expiresAt: number\n}\n\n/**\n * Result of an offline TTS synthesis. The engine's TTSModelManager produces\n * this directly; the type is kept exported for hosts that wrap it.\n */\nexport interface TtsSynthesisResult {\n  audioUrl: string\n  cleanup?: () => Promise<void> | void\n}\n\n/**\n * Stable settings keys read by engine services. Hosts must wire their own\n * settings store keys to these names. Mobile already uses these strings.\n */\nexport const ISLAND_SETTINGS_KEYS = {\n  localSttFallbackActive: \"local_stt_fallback_active\",\n  defaultWearable: \"default_wearable\",\n  coreToken: \"core_token\",\n  cameraFov: \"camera_fov\",\n} as const\n\n/**\n * Navigation event payloads. Mirror the host's NavigationService types but are\n * duplicated here so the engine module does not import host types.\n */\nexport type NavManeuverEvent = {\n  kind: \"maneuver\"\n  maneuverType: string\n  distanceMeters: number\n  fromRoad?: string | null\n  toRoad?: string | null\n  nextStepRoad?: string | null\n  distanceToDestinationMeters?: number\n  timeToDestinationSeconds?: number\n  currentSpeedMps?: number | null\n  speedLimitMps?: number | null\n  routeHeadingDeg?: number | null\n}\nexport type NavOffRouteEvent = {kind: \"off_route\"; offRouteDistanceMeters: number}\nexport type NavReroutingEvent = {kind: \"rerouting\"}\nexport type NavArrivedEvent = {kind: \"arrived\"}\nexport type NavErrorEvent = {kind: \"error\"; message: string}\nexport type NavUpdate = NavManeuverEvent | NavOffRouteEvent | NavReroutingEvent | NavArrivedEvent | NavErrorEvent\n\nexport type NavLocation = {\n  lat: number\n  lng: number\n  accuracy: number | null\n  timestamp: number\n}\n\nexport type NavRouteStep = {\n  lat: number\n  lng: number\n  routeIndex: number\n  road: string | null\n  maneuver: string\n  distanceMeters: number\n}\nexport type NavRoute = {\n  points: Array<{lat: number; lng: number}>\n  steps?: NavRouteStep[]\n}\n\nexport type NavTripSnapshot = {\n  active: boolean\n  mode?: string\n  stops?: Array<{lat: number; lng: number}>\n  currentStopIndex?: number\n  route?: NavRoute\n  maneuver?: NavManeuverEvent\n  distanceToDestinationMeters?: number\n  timeToDestinationSeconds?: number\n  currentSpeedMps?: number | null\n  speedLimitMps?: number | null\n}\n\nexport interface StreamVideoConfig {\n  width?: number\n  height?: number\n  bitrate?: number\n  fps?: number\n}\n\nexport interface StreamAudioConfig {\n  bitrate?: number\n  sampleRate?: number\n  echoCancellation?: boolean\n  noiseSuppression?: boolean\n}\n\nexport type CameraRoiPosition = \"center\" | \"bottom\" | \"top\"\nexport type CameraFovPreset = \"narrow\" | \"standard\" | \"wide\"\n\nexport type CameraFovRequest =\n  | {\n      fov: number\n      roiPosition?: CameraRoiPosition\n    }\n  | {\n      preset: CameraFovPreset\n    }\n\nexport interface CameraFovResult {\n  requestId: string\n  fov: number\n  roiPosition: CameraRoiPosition\n  timestamp: number\n}\n\n/** One audited inter-miniapp call. */\nexport interface InteropAuditEvent {\n  /** The system app that made the call. */\n  caller: string\n  op: \"list\" | \"start\" | \"stop\" | \"invoke\"\n  /** Target miniapp (start/stop/invoke). */\n  target?: string\n  /** Action id (invoke only). */\n  actionId?: string\n  /** True if the call was permitted and accepted; false on denial / pre-flight failure. */\n  ok: boolean\n  /** MiniappErrorCode when ok is false. */\n  errorCode?: string\n}\n\n"]}

package/build/runtime/streamConfig.d.ts

@@ -0,0 +1,4 @@
+import type { StreamAudioConfig, StreamVideoConfig } from "./config";
+export declare const normalizeStreamVideoConfig: (value: unknown) => StreamVideoConfig | undefined;
+export declare const normalizeStreamAudioConfig: (value: unknown) => StreamAudioConfig | undefined;
+//# sourceMappingURL=streamConfig.d.ts.map

package/build/runtime/streamConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamConfig.d.ts","sourceRoot":"","sources":["../../src/runtime/streamConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,UAAU,CAAA;AAQlE,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,iBAAiB,GAAG,SAa/E,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,iBAAiB,GAAG,SAU/E,CAAA"}

package/build/runtime/streamConfig.js

@@ -0,0 +1,38 @@
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const finiteNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+export const normalizeStreamVideoConfig = (value) => {
+    if (!isRecord(value))
+        return undefined;
+    const config = {};
+    const width = finiteNumber(value.width);
+    const height = finiteNumber(value.height);
+    const bitrate = finiteNumber(value.bitrate);
+    const frameRate = finiteNumber(value.frameRate);
+    const fps = frameRate ?? finiteNumber(value.fps);
+    if (width !== undefined)
+        config.width = width;
+    if (height !== undefined)
+        config.height = height;
+    if (bitrate !== undefined)
+        config.bitrate = bitrate;
+    if (fps !== undefined)
+        config.fps = fps;
+    return Object.keys(config).length > 0 ? config : undefined;
+};
+export const normalizeStreamAudioConfig = (value) => {
+    if (!isRecord(value))
+        return undefined;
+    const config = {};
+    const bitrate = finiteNumber(value.bitrate);
+    const sampleRate = finiteNumber(value.sampleRate);
+    if (bitrate !== undefined)
+        config.bitrate = bitrate;
+    if (sampleRate !== undefined)
+        config.sampleRate = sampleRate;
+    if (typeof value.echoCancellation === "boolean")
+        config.echoCancellation = value.echoCancellation;
+    if (typeof value.noiseSuppression === "boolean")
+        config.noiseSuppression = value.noiseSuppression;
+    return Object.keys(config).length > 0 ? config : undefined;
+};
+//# sourceMappingURL=streamConfig.js.map

package/build/runtime/streamConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamConfig.js","sourceRoot":"","sources":["../../src/runtime/streamConfig.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAEtE,MAAM,YAAY,GAAG,CAAC,KAAc,EAAsB,EAAE,CAC1D,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAEzE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,KAAc,EAAiC,EAAE;IAC1F,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACtC,MAAM,MAAM,GAAsB,EAAE,CAAA;IACpC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACvC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACzC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC3C,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAC/C,MAAM,GAAG,GAAG,SAAS,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChD,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;IAC7C,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;IAChD,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;IACnD,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,GAAG,GAAG,CAAA;IACvC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AAC5D,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,KAAc,EAAiC,EAAE;IAC1F,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACtC,MAAM,MAAM,GAAsB,EAAE,CAAA;IACpC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC3C,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IACjD,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;IACnD,IAAI,UAAU,KAAK,SAAS;QAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAA;IAC5D,IAAI,OAAO,KAAK,CAAC,gBAAgB,KAAK,SAAS;QAAE,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAA;IACjG,IAAI,OAAO,KAAK,CAAC,gBAAgB,KAAK,SAAS;QAAE,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAA;IACjG,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AAC5D,CAAC,CAAA","sourcesContent":["import type {StreamAudioConfig, StreamVideoConfig} from \"./config\"\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value)\n\nconst finiteNumber = (value: unknown): number | undefined =>\n  typeof value === \"number\" && Number.isFinite(value) ? value : undefined\n\nexport const normalizeStreamVideoConfig = (value: unknown): StreamVideoConfig | undefined => {\n  if (!isRecord(value)) return undefined\n  const config: StreamVideoConfig = {}\n  const width = finiteNumber(value.width)\n  const height = finiteNumber(value.height)\n  const bitrate = finiteNumber(value.bitrate)\n  const frameRate = finiteNumber(value.frameRate)\n  const fps = frameRate ?? finiteNumber(value.fps)\n  if (width !== undefined) config.width = width\n  if (height !== undefined) config.height = height\n  if (bitrate !== undefined) config.bitrate = bitrate\n  if (fps !== undefined) config.fps = fps\n  return Object.keys(config).length > 0 ? config : undefined\n}\n\nexport const normalizeStreamAudioConfig = (value: unknown): StreamAudioConfig | undefined => {\n  if (!isRecord(value)) return undefined\n  const config: StreamAudioConfig = {}\n  const bitrate = finiteNumber(value.bitrate)\n  const sampleRate = finiteNumber(value.sampleRate)\n  if (bitrate !== undefined) config.bitrate = bitrate\n  if (sampleRate !== undefined) config.sampleRate = sampleRate\n  if (typeof value.echoCancellation === \"boolean\") config.echoCancellation = value.echoCancellation\n  if (typeof value.noiseSuppression === \"boolean\") config.noiseSuppression = value.noiseSuppression\n  return Object.keys(config).length > 0 ? config : undefined\n}\n"]}