@mentra/miniapp 0.3.0-beta.0

package/dist/envelope.js

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Bridge envelope format.
+ *
+ * Every message between @mentra/miniapp and LocalMiniappRuntime is wrapped in
+ * this envelope for request/response correlation.
+ *
+ *   { payload: {...}, requestId?: string }
+ */
+/** Serialize an envelope for postMessage / WebSocket transport. */
+export function serializeEnvelope(envelope) {
+    return JSON.stringify(envelope);
+}
+/**
+ * Parse a serialized envelope. Returns null for any malformed input — never throws.
+ * Transports should pass raw strings in and silently drop nulls.
+ */
+export function parseEnvelope(raw) {
+    if (typeof raw !== "string")
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return null;
+    const obj = parsed;
+    if (typeof obj.payload !== "object" || obj.payload === null)
+        return null;
+    if (obj.requestId !== undefined && typeof obj.requestId !== "string")
+        return null;
+    return {
+        payload: obj.payload,
+        requestId: obj.requestId,
+    };
+}
+/** Generate a short random requestId. Browser-native (crypto.randomUUID). */
+export function makeRequestId() {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+        return crypto.randomUUID();
+    }
+    // Fallback for older engines: timestamp + random suffix. Not cryptographically secure.
+    return `req_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,QAAyB;IACzD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAExC,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC9D,MAAM,GAAG,GAAG,MAAiC,CAAA;IAE7C,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IACxE,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAEjF,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAkB;QAC/B,SAAS,EAAE,GAAG,CAAC,SAA+B;KAC/C,CAAA;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC7E,OAAO,MAAM,CAAC,UAAU,EAAE,CAAA;IAC5B,CAAC;IACD,uFAAuF;IACvF,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;AACpF,CAAC"}

package/dist/globals.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Shape of window.MentraOS, injected by the host MentraOS app
+ * before the miniapp's content loads. Miniapp authors generally won't read
+ * this directly — use the typed React hooks (useSafeArea, etc.) instead.
+ */
+export interface MiniappSafeAreaInsets {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+export interface MiniappCapsuleMenuRect {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    width: number;
+    height: number;
+}
+export type MiniappColorScheme = "light" | "dark";
+export interface MentraOSGlobals {
+    /** Package id the host assigned to this miniapp (e.g. "com.mentra.example"). */
+    packageName?: string;
+    /** "ios" | "android" | other. */
+    platform?: string;
+    /** Capabilities the host exposes to this miniapp (e.g. ["share", "open_url"]). */
+    capabilities?: string[];
+    /** True when this miniapp is running locally on-device (vs. hosted in the cloud). */
+    miniappLocal?: boolean;
+    /** True when the miniapp is running via the dev workflow (QR sideload). */
+    miniappDeveloperMode?: boolean;
+    /** Safe-area insets around the WebView content. Miniapps should pad accordingly. */
+    safeAreaInsets?: MiniappSafeAreaInsets;
+    /**
+     * Bounding rect (in CSS pixels) of the floating capsule menu the host draws
+     * over the WebView. The menu lives in the top-right and miniapps should
+     * avoid placing interactive elements beneath it.
+     */
+    capsuleMenu?: MiniappCapsuleMenuRect;
+    /**
+     * The host's current color scheme. Miniapps can follow this to match the
+     * phone's appearance. Updates at runtime arrive via the session's
+     * `colorScheme` event — see `useColorScheme()` in @mentra/miniapp/react.
+     */
+    colorScheme?: MiniappColorScheme;
+}
+declare global {
+    interface Window {
+        MentraOS?: MentraOSGlobals;
+    }
+}
+/** Reads window.MentraOS safely — returns an empty object if not set. */
+export declare function getMentraOSGlobals(): MentraOSGlobals;
+//# sourceMappingURL=globals.d.ts.map

package/dist/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,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;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,CAAA;AAEjD,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,qFAAqF;IACrF,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,oFAAoF;IACpF,cAAc,CAAC,EAAE,qBAAqB,CAAA;IACtC;;;;OAIG;IACH,WAAW,CAAC,EAAE,sBAAsB,CAAA;IACpC;;;;OAIG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAA;CACjC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,CAAC,EAAE,eAAe,CAAA;KAC3B;CACF;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,IAAI,eAAe,CAGpD"}

package/dist/globals.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Shape of window.MentraOS, injected by the host MentraOS app
+ * before the miniapp's content loads. Miniapp authors generally won't read
+ * this directly — use the typed React hooks (useSafeArea, etc.) instead.
+ */
+/** Reads window.MentraOS safely — returns an empty object if not set. */
+export function getMentraOSGlobals() {
+    if (typeof window === "undefined")
+        return {};
+    return window.MentraOS ?? {};
+}
+//# sourceMappingURL=globals.js.map

package/dist/globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.js","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqDH,yEAAyE;AACzE,MAAM,UAAU,kBAAkB;IAChC,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,EAAE,CAAA;IAC5C,OAAO,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAA;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @mentra/miniapp — SDK for building MentraOS local miniapps.
+ *
+ * Public entry point. Consumers do:
+ *
+ *   import {MiniappSession} from "@mentra/miniapp"            // background JSContext
+ *   import {useColorScheme} from "@mentra/miniapp/react"      // UI WebView hooks
+ *   import {MiniappRequestType} from "@mentra/miniapp/protocol"
+ */
+export { MiniappSession, NotConnectedError } from "./session";
+export type { AuthUpdatePayload, ConnectAckPayload, DisplayCapabilities, GlassesCapabilities, MiniappAuthState, MiniappRequestError, MiniappSessionOptions, MiniappVisibility, } from "./session";
+export type { AuthFetchOptions, AuthModule } from "./modules/auth";
+export { makeRequestId, parseEnvelope, serializeEnvelope } from "./envelope";
+export type { MiniappEnvelope } from "./envelope";
+export { getMentraOSGlobals } from "./globals";
+export type { MentraOSGlobals, MiniappCapsuleMenuRect, MiniappColorScheme, MiniappSafeAreaInsets } from "./globals";
+export { MiniappErrorCode, MiniappRequestType, MiniappResponseType, MiniappStreamType } from "./protocol";
+export { CLOUD_STATUS_STREAM } from "./modules/cloud";
+export type { CloudClientAudioTransport, CloudClientConnectionStatus, CloudClientStatus } from "./modules/cloud";
+export { HardwareType, HardwareRequirementLevel } from "@mentra/types";
+export type { HardwareRequirement } from "@mentra/types";
+export { createTransport } from "./transport/auto";
+export type { CreateTransportOptions } from "./transport/auto";
+export { PostMessageTransport } from "./transport/postmessage";
+export { LocalSocketTransport } from "./transport/local-socket";
+export type { LocalSocketTransportOptions } from "./transport/local-socket";
+export { MockTransport, isMockExplicitlyRequested } from "./transport/mock";
+export type { MockTransportOptions } from "./transport/mock";
+export type { Transport, TransportDisconnectHandler, TransportMessageHandler } from "./transport/types";
+export type { DisplayBreakMode, RenderBox, RenderElement, RenderOptions, RenderRectStyle, RenderResult, RenderTextStyle, ViewType, } from "./modules/display";
+export type { AccelData, AudioChunkData, BatteryData, ButtonPressData, ConnectionData, HeadingData, HeadPositionData, LocationData, NotificationDismissedData, PhoneNotificationData, TouchData, TranscriptionData, TranslationData, UnsubscribeFn, VadData, WifiData, } from "./modules/events";
+export type { CalendarEvent, CalendarListOptions, CalendarListResult } from "./modules/phone";
+export type { PlayAudioOptions, SpeakOptions, SpeakResult, SpeakerState, SpeakerStateEvent, SpeakerStreamOptions, SpeakerStreamSampleRate, SpeakerStreamWriteResult, } from "./modules/speaker";
+export { SpeakerStreamWriter, SPEAKER_STREAM_MAX_BUFFERED_MS, SPEAKER_WRITE_CHUNK_BYTES } from "./modules/speaker";
+export type { CameraFovPreset, CameraFovRequest, CameraFovResult, CameraRoiPosition, PhotoTaken, SetCameraFovOptions, StartVideoRecordingOptions, StopVideoRecordingOptions, TakePhotoOptions, VideoRecordingStarted, } from "./modules/camera";
+export type { DashboardMode } from "./modules/dashboard";
+export type { CloudModule } from "./modules/cloud";
+export type { LedColor, LedControlOptions } from "./modules/led";
+export type { RestreamDestination, StartStreamOptions, StreamAudioConfig, StreamResolvedConfig, StreamResult, StreamStatus, StreamVideoConfig, } from "./modules/stream";
+export type { ShareOptions, ShareResult, DownloadOptions, DownloadResult } from "./modules/system";
+export type { MiniappInfo, MiniappActionInfo, MiniappCompatibility, ListMiniappsOptions } from "./modules/miniapps";
+export type { ActionContext, ActionHandler, InvokeOptions } from "./modules/actions";
+export type { DisplayManager } from "./modules/display";
+export type { MiniappsModule } from "./modules/miniapps";
+export type { ActionsModule } from "./modules/actions";
+export type { GlassesModule } from "./modules/glasses";
+export type { HeadingModule } from "./modules/heading";
+export type { ImuModule } from "./modules/imu";
+export type { InputModule } from "./modules/input";
+export type { LocationModule } from "./modules/location";
+export type { MicModule } from "./modules/mic";
+export type { ComputedRoute, ComputedRouteStep, ComputeRouteOptions, ComputeRouteResult, LatLng, NavArrived, NavError, NavigationModule, NavManeuver, NavOffRoute, NavPermissionResult, NavPlaceDetails, NavPlaceSuggestion, NavRerouting, NavRoute, NavState, NavStep, NavUpdate, Pivot, PivotEvent, PivotOptions, RouteAvoidances, StartNavigationOptions, TravelMode, } from "./modules/navigation";
+export type { PermissionsModule, PermissionErrorEvent } from "./modules/permissions";
+export type { PhoneModule, PhoneNotificationsModule, PhoneCalendarModule } from "./modules/phone";
+export type { TranscriptionModule, TranscriptionConfig, TranscriptionOptions } from "./modules/transcription";
+export type { TranslationModule } from "./modules/translation";
+export type { SpeakerModule } from "./modules/speaker";
+export type { PermissionType, PermissionRecord } from "./session";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * @mentra/miniapp — SDK for building MentraOS local miniapps.
+ *
+ * Public entry point. Consumers do:
+ *
+ *   import {MiniappSession} from "@mentra/miniapp"            // background JSContext
+ *   import {useColorScheme} from "@mentra/miniapp/react"      // UI WebView hooks
+ *   import {MiniappRequestType} from "@mentra/miniapp/protocol"
+ */
+import { installDevReloadListenerIfDevMode } from "./dev-reload";
+// Auto-install the dev-reload listener on module import so authors get live
+// reload for free in dev builds. No-op in production (gated on
+// window.MentraOS.miniappDeveloperMode).
+installDevReloadListenerIfDevMode();
+export { MiniappSession, NotConnectedError } from "./session";
+export { makeRequestId, parseEnvelope, serializeEnvelope } from "./envelope";
+export { getMentraOSGlobals } from "./globals";
+export { MiniappErrorCode, MiniappRequestType, MiniappResponseType, MiniappStreamType } from "./protocol";
+export { CLOUD_STATUS_STREAM } from "./modules/cloud";
+// Hardware requirement types — re-exported from @mentra/types so miniapp
+// authors can type their miniapp.json manifest without pulling in the types
+// package directly. Keep explicit exports (enums as value, interfaces as
+// type) per @mentra/types' Bun-compat convention.
+export { HardwareType, HardwareRequirementLevel } from "@mentra/types";
+// Transports — exported for advanced uses (forced transport injection, tests)
+export { createTransport } from "./transport/auto";
+export { PostMessageTransport } from "./transport/postmessage";
+export { LocalSocketTransport } from "./transport/local-socket";
+export { MockTransport, isMockExplicitlyRequested } from "./transport/mock";
+export { SpeakerStreamWriter, SPEAKER_STREAM_MAX_BUFFERED_MS, SPEAKER_WRITE_CHUNK_BYTES } from "./modules/speaker";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAC,iCAAiC,EAAC,MAAM,cAAc,CAAA;AAE9D,4EAA4E;AAC5E,+DAA+D;AAC/D,yCAAyC;AACzC,iCAAiC,EAAE,CAAA;AAEnC,OAAO,EAAC,cAAc,EAAE,iBAAiB,EAAC,MAAM,WAAW,CAAA;AAa3D,OAAO,EAAC,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAC,MAAM,YAAY,CAAA;AAG1E,OAAO,EAAC,kBAAkB,EAAC,MAAM,WAAW,CAAA;AAG5C,OAAO,EAAC,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAC,MAAM,YAAY,CAAA;AACvG,OAAO,EAAC,mBAAmB,EAAC,MAAM,iBAAiB,CAAA;AAGnD,yEAAyE;AACzE,4EAA4E;AAC5E,yEAAyE;AACzE,kDAAkD;AAClD,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAC,MAAM,eAAe,CAAA;AAGpE,8EAA8E;AAC9E,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAA;AAEhD,OAAO,EAAC,oBAAoB,EAAC,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAC,oBAAoB,EAAC,MAAM,0BAA0B,CAAA;AAE7D,OAAO,EAAC,aAAa,EAAE,yBAAyB,EAAC,MAAM,kBAAkB,CAAA;AA4CzE,OAAO,EAAC,mBAAmB,EAAE,8BAA8B,EAAE,yBAAyB,EAAC,MAAM,mBAAmB,CAAA"}

package/dist/modules/actions.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview ActionsModule — `session.actions`.
+ *
+ * The MCP-shaped capability layer, both directions:
+ *   - `invoke(pkg, actionId, params)` — call another miniapp's declared action.
+ *     SYSTEM-only; headless-wakes the target if it's stopped.
+ *   - `handle(actionId, fn)` — expose one of your own actions. Open to all
+ *     miniapps. Mirrors `session.ui.handle` (one handler per id, throws on
+ *     double-register, errors propagate to the caller).
+ *
+ * `invoke` ↔ `handle` are the two ends of one wire (keyed by `actionId`), which
+ * is why they share this namespace rather than being split across
+ * `session.miniapps`.
+ */
+import { MiniappSession } from "../session";
+/** Context handed to an action handler. `callerPackageName` is host-stamped. */
+export interface ActionContext {
+    /** The package that invoked this action (trustworthy — set by the host). */
+    callerPackageName: string;
+}
+export type ActionHandler = (params: Record<string, unknown>, ctx: ActionContext) => unknown | Promise<unknown>;
+export interface InvokeOptions {
+    /** Overall timeout in ms (default 30s, max 120s — host-enforced). */
+    timeoutMs?: number;
+}
+export declare class ActionsModule {
+    private readonly session;
+    private readonly handlers;
+    /** Inbound calls buffered until their handler registers, keyed by actionId. */
+    private readonly buffered;
+    constructor(session: MiniappSession);
+    /**
+     * Invoke a declared action on another miniapp. Resolves with the handler's
+     * return value, rejects with a MiniappRequestError (NOT_PERMITTED,
+     * APP_NOT_FOUND, ACTION_NOT_FOUND, WAKE_FAILED, NO_ACTION_HANDLER,
+     * ACTION_TIMEOUT, PAYLOAD_TOO_LARGE, or the handler's own error). SYSTEM-only.
+     */
+    invoke<TResult = unknown>(packageName: string, actionId: string, params?: Record<string, unknown>, opts?: InvokeOptions): Promise<TResult>;
+    /**
+     * Register a handler for one of this miniapp's declared actions. One handler
+     * per actionId — throws synchronously on double-register. The returned
+     * function unregisters. Declare the action in `miniapp.json` for it to be
+     * invokable; an undeclared id still registers but the host never routes to it.
+     */
+    handle(actionId: string, handler: ActionHandler): () => void;
+    /**
+     * @internal — called by MiniappSession.handleIncoming on an ACTION_CALL.
+     * Routes to the registered handler, or buffers briefly for one to appear.
+     */
+    _deliver(callId: string, actionId: string, params: Record<string, unknown>, ctx: ActionContext): void;
+    private dispatch;
+    private sendResult;
+}
+//# sourceMappingURL=actions.d.ts.map

package/dist/modules/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/modules/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AAEzC,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAE/G,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAiBD,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;gBAEhC,OAAO,EAAE,cAAc;IAEpD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,GAAG,OAAO,EACtB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,OAAO,CAAC;IAUnB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI;IAqB5D;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI;YAuBvF,QAAQ;IAmBtB,OAAO,CAAC,UAAU;CAQnB"}

package/dist/modules/actions.js

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview ActionsModule — `session.actions`.
+ *
+ * The MCP-shaped capability layer, both directions:
+ *   - `invoke(pkg, actionId, params)` — call another miniapp's declared action.
+ *     SYSTEM-only; headless-wakes the target if it's stopped.
+ *   - `handle(actionId, fn)` — expose one of your own actions. Open to all
+ *     miniapps. Mirrors `session.ui.handle` (one handler per id, throws on
+ *     double-register, errors propagate to the caller).
+ *
+ * `invoke` ↔ `handle` are the two ends of one wire (keyed by `actionId`), which
+ * is why they share this namespace rather than being split across
+ * `session.miniapps`.
+ */
+import { MiniappErrorCode, MiniappRequestType } from "../protocol";
+/**
+ * How long the SDK holds an inbound ACTION_CALL waiting for its handler to
+ * register (a just-woken miniapp registers handlers a beat after CONNECT).
+ * If no handler appears in this window the call is failed with
+ * NO_ACTION_HANDLER. Mirrors the UI bus's pre-handler buffering.
+ */
+const HANDLER_WAIT_MS = 5000;
+export class ActionsModule {
+    constructor(session) {
+        this.session = session;
+        this.handlers = new Map();
+        /** Inbound calls buffered until their handler registers, keyed by actionId. */
+        this.buffered = new Map();
+    }
+    /**
+     * Invoke a declared action on another miniapp. Resolves with the handler's
+     * return value, rejects with a MiniappRequestError (NOT_PERMITTED,
+     * APP_NOT_FOUND, ACTION_NOT_FOUND, WAKE_FAILED, NO_ACTION_HANDLER,
+     * ACTION_TIMEOUT, PAYLOAD_TOO_LARGE, or the handler's own error). SYSTEM-only.
+     */
+    invoke(packageName, actionId, params, opts) {
+        return this.session.sendRequest({
+            type: MiniappRequestType.ACTION_INVOKE,
+            targetPackageName: packageName,
+            actionId,
+            params: params ?? {},
+            ...(opts?.timeoutMs != null ? { timeoutMs: opts.timeoutMs } : {}),
+        });
+    }
+    /**
+     * Register a handler for one of this miniapp's declared actions. One handler
+     * per actionId — throws synchronously on double-register. The returned
+     * function unregisters. Declare the action in `miniapp.json` for it to be
+     * invokable; an undeclared id still registers but the host never routes to it.
+     */
+    handle(actionId, handler) {
+        if (this.handlers.has(actionId)) {
+            throw new Error(`session.actions.handle: a handler is already registered for "${actionId}"`);
+        }
+        this.handlers.set(actionId, handler);
+        // Flush any calls that arrived before this handler registered.
+        const waiting = this.buffered.get(actionId);
+        if (waiting) {
+            this.buffered.delete(actionId);
+            for (const call of waiting) {
+                clearTimeout(call.timer);
+                void this.dispatch(call.callId, actionId, call.params, call.ctx);
+            }
+        }
+        return () => {
+            if (this.handlers.get(actionId) === handler)
+                this.handlers.delete(actionId);
+        };
+    }
+    /**
+     * @internal — called by MiniappSession.handleIncoming on an ACTION_CALL.
+     * Routes to the registered handler, or buffers briefly for one to appear.
+     */
+    _deliver(callId, actionId, params, ctx) {
+        if (this.handlers.has(actionId)) {
+            void this.dispatch(callId, actionId, params, ctx);
+            return;
+        }
+        // No handler yet — buffer, and fail with NO_ACTION_HANDLER if none registers.
+        const timer = setTimeout(() => {
+            const arr = this.buffered.get(actionId);
+            if (arr) {
+                const idx = arr.findIndex((c) => c.callId === callId);
+                if (idx >= 0)
+                    arr.splice(idx, 1);
+                if (arr.length === 0)
+                    this.buffered.delete(actionId);
+            }
+            this.sendResult(callId, false, undefined, {
+                code: MiniappErrorCode.NO_ACTION_HANDLER,
+                message: `No handler registered for action "${actionId}"`,
+            });
+        }, HANDLER_WAIT_MS);
+        const arr = this.buffered.get(actionId) ?? [];
+        arr.push({ callId, params, ctx, timer });
+        this.buffered.set(actionId, arr);
+    }
+    async dispatch(callId, actionId, params, ctx) {
+        const handler = this.handlers.get(actionId);
+        if (!handler)
+            return;
+        try {
+            const result = await handler(params, ctx);
+            this.sendResult(callId, true, result ?? null);
+        }
+        catch (e) {
+            this.sendResult(callId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: e?.message ?? "action handler threw",
+            });
+        }
+    }
+    sendResult(callId, ok, result, error) {
+        this.session.sendOneShot({
+            type: MiniappRequestType.ACTION_RESULT,
+            callId,
+            ok,
+            ...(ok ? { result } : { error }),
+        });
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/modules/actions.js.map

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

package/dist/modules/auth.d.ts

@@ -0,0 +1,25 @@
+import type { MiniappSession, MiniappAuthState } from "../session";
+export interface AuthFetchOptions extends RequestInit {
+    /**
+     * Minimum remaining token lifetime before using the current token. Defaults to
+     * 30 seconds. If the token is absent or too close to expiry, the call waits
+     * for the host's next auth update.
+     */
+    minTtlMs?: number;
+}
+export declare class AuthModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    get current(): MiniappAuthState | null;
+    get mentraUserId(): string | null;
+    get oemId(): string | null;
+    getToken(options?: {
+        minTtlMs?: number;
+    }): Promise<string>;
+    getAuthHeader(options?: {
+        minTtlMs?: number;
+    }): Promise<string>;
+    fetch(input: RequestInfo | URL, init?: AuthFetchOptions): Promise<Response>;
+    onUpdate(handler: (auth: MiniappAuthState) => void): () => void;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/modules/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/modules/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAE,gBAAgB,EAAC,MAAM,YAAY,CAAA;AAEhE,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAID,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,IAAI,OAAO,IAAI,gBAAgB,GAAG,IAAI,CAErC;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAEK,QAAQ,CAAC,OAAO,GAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5D,aAAa,CAAC,OAAO,GAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjE,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOrF,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;CAGhE"}

package/dist/modules/auth.js

@@ -0,0 +1,52 @@
+const DEFAULT_MIN_TTL_MS = 30000;
+export class AuthModule {
+    constructor(session) {
+        this.session = session;
+    }
+    get current() {
+        return this.session._getAuth();
+    }
+    get mentraUserId() {
+        return this.current?.mentraUserId ?? null;
+    }
+    get oemId() {
+        return this.current?.oemId ?? null;
+    }
+    async getToken(options = {}) {
+        const auth = await this.session._waitForAuth(options.minTtlMs ?? DEFAULT_MIN_TTL_MS);
+        return auth.token;
+    }
+    async getAuthHeader(options = {}) {
+        return `Bearer ${await this.getToken(options)}`;
+    }
+    async fetch(input, init = {}) {
+        const { minTtlMs, ...requestInit } = init;
+        const token = await this.getToken({ minTtlMs });
+        const headers = mergeHeaders(requestInit.headers, { Authorization: `Bearer ${token}` });
+        return fetch(input, { ...requestInit, headers });
+    }
+    onUpdate(handler) {
+        return this.session.on("auth", handler);
+    }
+}
+function mergeHeaders(base, next) {
+    const headers = {};
+    if (Array.isArray(base)) {
+        for (const [key, value] of base) {
+            headers[key] = value;
+        }
+    }
+    else if (typeof Headers !== "undefined" && base instanceof Headers) {
+        base.forEach((value, key) => {
+            headers[key] = value;
+        });
+    }
+    else if (base && typeof base === "object") {
+        for (const [key, value] of Object.entries(base)) {
+            if (typeof value === "string")
+                headers[key] = value;
+        }
+    }
+    return { ...headers, ...next };
+}
+//# sourceMappingURL=auth.js.map

package/dist/modules/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/modules/auth.ts"],"names":[],"mappings":"AAWA,MAAM,kBAAkB,GAAG,KAAM,CAAA;AAEjC,MAAM,OAAO,UAAU;IACrB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;IAChC,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,EAAE,YAAY,IAAI,IAAI,CAAA;IAC3C,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAA+B,EAAE;QAC9C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,IAAI,kBAAkB,CAAC,CAAA;QACpF,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,UAA+B,EAAE;QACnD,OAAO,UAAU,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAA;IACjD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAwB,EAAE,OAAyB,EAAE;QAC/D,MAAM,EAAC,QAAQ,EAAE,GAAG,WAAW,EAAC,GAAG,IAAI,CAAA;QACvC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAC,QAAQ,EAAC,CAAC,CAAA;QAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,EAAC,aAAa,EAAE,UAAU,KAAK,EAAE,EAAC,CAAC,CAAA;QACrF,OAAO,KAAK,CAAC,KAAK,EAAE,EAAC,GAAG,WAAW,EAAE,OAAO,EAAC,CAAC,CAAA;IAChD,CAAC;IAED,QAAQ,CAAC,OAAyC;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC;CACF;AAED,SAAS,YAAY,CAAC,IAA6B,EAAE,IAA4B;IAC/E,MAAM,OAAO,GAA2B,EAAE,CAAA;IAE1C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACtB,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,IAAI,YAAY,OAAO,EAAE,CAAC;QACrE,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACtB,CAAC,CAAC,CAAA;IACJ,CAAC;SAAM,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACrD,CAAC;IACH,CAAC;IAED,OAAO,EAAC,GAAG,OAAO,EAAE,GAAG,IAAI,EAAC,CAAA;AAC9B,CAAC"}

package/dist/modules/base64.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Dependency-free base64 codec for the miniapp background runtime.
+ *
+ * The background bundle runs in a per-miniapp JS engine (JavaScriptCore on iOS,
+ * QuickJS on Android) where `Buffer`, `btoa`/`atob`, and Node APIs are NOT
+ * guaranteed to exist. `session.blob` round-trips binary as base64 strings over
+ * the JSON bridge, so it needs an encoder/decoder that works with nothing but
+ * the language. This is that — standard RFC 4648 base64, no padding tricks.
+ */
+/** Coerce a Uint8Array / ArrayBuffer / ArrayBufferView into a Uint8Array view (no copy when possible). */
+export declare function toUint8Array(input: Uint8Array | ArrayBuffer | ArrayBufferView): Uint8Array;
+/** Encode bytes to a base64 string. */
+export declare function bytesToBase64(input: Uint8Array | ArrayBuffer): string;
+/** Decode a base64 string to bytes. Ignores whitespace; tolerant of missing padding. */
+export declare function base64ToBytes(b64: string): Uint8Array;
+//# sourceMappingURL=base64.d.ts.map

package/dist/modules/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/modules/base64.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,0GAA0G;AAC1G,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,eAAe,GAAG,UAAU,CAI1F;AAED,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,CAkBrE;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAqCrD"}

package/dist/modules/base64.js

@@ -0,0 +1,92 @@
+/**
+ * @fileoverview Dependency-free base64 codec for the miniapp background runtime.
+ *
+ * The background bundle runs in a per-miniapp JS engine (JavaScriptCore on iOS,
+ * QuickJS on Android) where `Buffer`, `btoa`/`atob`, and Node APIs are NOT
+ * guaranteed to exist. `session.blob` round-trips binary as base64 strings over
+ * the JSON bridge, so it needs an encoder/decoder that works with nothing but
+ * the language. This is that — standard RFC 4648 base64, no padding tricks.
+ */
+const ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+/** Reverse lookup table: char code → 6-bit value (or -1). Built once. */
+const LOOKUP = (() => {
+    const t = new Int16Array(256).fill(-1);
+    for (let i = 0; i < ALPHABET.length; i++)
+        t[ALPHABET.charCodeAt(i)] = i;
+    t["=".charCodeAt(0)] = 0;
+    return t;
+})();
+/** Coerce a Uint8Array / ArrayBuffer / ArrayBufferView into a Uint8Array view (no copy when possible). */
+export function toUint8Array(input) {
+    if (input instanceof Uint8Array)
+        return input;
+    if (input instanceof ArrayBuffer)
+        return new Uint8Array(input);
+    return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
+}
+/** Encode bytes to a base64 string. */
+export function bytesToBase64(input) {
+    const bytes = input instanceof Uint8Array ? input : new Uint8Array(input);
+    const len = bytes.length;
+    let out = "";
+    let i = 0;
+    for (; i + 2 < len; i += 3) {
+        const n = (bytes[i] << 16) | (bytes[i + 1] << 8) | bytes[i + 2];
+        out += ALPHABET[(n >> 18) & 63] + ALPHABET[(n >> 12) & 63] + ALPHABET[(n >> 6) & 63] + ALPHABET[n & 63];
+    }
+    const rem = len - i;
+    if (rem === 1) {
+        const n = bytes[i] << 16;
+        out += ALPHABET[(n >> 18) & 63] + ALPHABET[(n >> 12) & 63] + "==";
+    }
+    else if (rem === 2) {
+        const n = (bytes[i] << 16) | (bytes[i + 1] << 8);
+        out += ALPHABET[(n >> 18) & 63] + ALPHABET[(n >> 12) & 63] + ALPHABET[(n >> 6) & 63] + "=";
+    }
+    return out;
+}
+/** Decode a base64 string to bytes. Ignores whitespace; tolerant of missing padding. */
+export function base64ToBytes(b64) {
+    // Count valid (non-whitespace) chars and trailing '=' to size the output exactly.
+    let validChars = 0;
+    let pad = 0;
+    for (let i = 0; i < b64.length; i++) {
+        const c = b64.charCodeAt(i);
+        if (c === 0x3d) {
+            pad++;
+            validChars++;
+        }
+        else if (LOOKUP[c] !== -1) {
+            validChars++;
+        }
+    }
+    const fullGroups = Math.floor(validChars / 4);
+    const remChars = validChars - fullGroups * 4;
+    let outLen = fullGroups * 3 - (pad > 0 && remChars === 0 ? pad : 0);
+    if (remChars === 2)
+        outLen += 1;
+    else if (remChars === 3)
+        outLen += 2;
+    if (outLen < 0)
+        outLen = 0;
+    const out = new Uint8Array(outLen);
+    let acc = 0;
+    let bits = 0;
+    let o = 0;
+    for (let i = 0; i < b64.length && o < outLen; i++) {
+        const c = b64.charCodeAt(i);
+        if (c === 0x3d)
+            break; // '=' — end of data
+        const v = LOOKUP[c];
+        if (v === -1)
+            continue; // skip whitespace / stray chars
+        acc = (acc << 6) | v;
+        bits += 6;
+        if (bits >= 8) {
+            bits -= 8;
+            out[o++] = (acc >> bits) & 0xff;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=base64.js.map

package/dist/modules/base64.js.map

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