@swiftbrowser/native 0.17.6 → 0.17.8

package/dist/hostRequests.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The host requests `@swiftbrowser/react` sends to the browser environment
+ * (`ShareLink`, `fileImporter`, the clipboard, a color chooser: the web
+ * renderer's `performHostRequest` with its `browserEnvironment`), answered by
+ * the native app instead: the bridge's `hostRequest(id, kind, json)` performs
+ * one with UIKit (a share sheet, the photo or document picker, the
+ * pasteboard, the color picker, `ASWebAuthenticationSession`), answering
+ * `__sbHostResponse(id, { value } | { error })`. `installHostEnvironment`
+ * fills the environment's gaps with these, leaving what the page has (the
+ * round trip runs in a browser with a share sheet of its own).
+ *
+ * `webAuthenticate` is the sign-in window apps open for OAuth: the system's
+ * sheet, resolving with the callback URL.
+ */
+import type { NativeBridge } from './bridge';
+export type HostRequestBridge = Required<Pick<NativeBridge, 'hostRequest'>>;
+/** A file as it crosses the bridge: its name, MIME type and bytes (base64). */
+export interface BridgedFile {
+    name: string;
+    type: string;
+    data: string;
+}
+export interface WebAuthenticateOptions {
+    /** The scheme of the callback URL the sign-in ends with (`myapp` for `myapp://auth`); universal links need none. */
+    callbackScheme?: string;
+    /** Whether the session shares no cookies with the system browser. */
+    ephemeral?: boolean;
+}
+/** Points the requests at the bridge (the runtime, once per install). */
+export declare function installHostRequests(native: HostRequestBridge): void;
+/** The bridge's `__sbHostResponse(id, result)`. */
+export declare function receiveHostResponse(id: number, result: string | {
+    value?: unknown;
+    error?: string;
+}): void;
+/** Performs one request of `kind` with `params`; resolves with the host's value. */
+export declare function hostRequest<T = unknown>(kind: string, params: Record<string, unknown>): Promise<T>;
+/** Forgets the bridge and the waiting requests, for tests. */
+export declare function resetHostRequests(): void;
+/**
+ * Opens the system's sign-in sheet at `url` and resolves with the callback
+ * URL it ends with; rejects with an `AbortError` when the viewer closes it.
+ */
+export declare function webAuthenticate(url: string, options?: WebAuthenticateOptions): Promise<string>;
+/** The environment fields the host answers, shaped as the web renderer's `HostRequestEnvironment`. */
+export declare function nativeHostEnvironment(): Record<string, unknown>;
+/** Fills what `environment` lacks with the host's answers; what the page has stays. */
+export declare function installHostEnvironment(environment: Record<string, unknown>): void;
+//# sourceMappingURL=hostRequests.d.ts.map

package/dist/hostRequests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostRequests.d.ts","sourceRoot":"","sources":["../src/hostRequests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;AAE5E,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,oHAAoH;IACpH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAEnE;AAED,mDAAmD;AACnD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB1G;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUlG;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAWD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxG;AAED,sGAAsG;AACtG,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+B/D;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKjF"}

package/dist/hostRequests.js

@@ -0,0 +1,134 @@
+/**
+ * The host requests `@swiftbrowser/react` sends to the browser environment
+ * (`ShareLink`, `fileImporter`, the clipboard, a color chooser: the web
+ * renderer's `performHostRequest` with its `browserEnvironment`), answered by
+ * the native app instead: the bridge's `hostRequest(id, kind, json)` performs
+ * one with UIKit (a share sheet, the photo or document picker, the
+ * pasteboard, the color picker, `ASWebAuthenticationSession`), answering
+ * `__sbHostResponse(id, { value } | { error })`. `installHostEnvironment`
+ * fills the environment's gaps with these, leaving what the page has (the
+ * round trip runs in a browser with a share sheet of its own).
+ *
+ * `webAuthenticate` is the sign-in window apps open for OAuth: the system's
+ * sheet, resolving with the callback URL.
+ */
+import { objectURL, SimpleBlob, SimpleFile } from './blob';
+import { base64Decode, base64Encode } from './encoding';
+let bridge = null;
+let nextId = 1;
+const pending = new Map();
+/** Points the requests at the bridge (the runtime, once per install). */
+export function installHostRequests(native) {
+    bridge = native;
+}
+/** The bridge's `__sbHostResponse(id, result)`. */
+export function receiveHostResponse(id, result) {
+    const waiting = pending.get(id);
+    if (!waiting)
+        return;
+    pending.delete(id);
+    let parsed;
+    try {
+        parsed = typeof result === 'string' ? JSON.parse(result) : result;
+    }
+    catch {
+        waiting.reject(new Error('host: malformed response'));
+        return;
+    }
+    if (typeof parsed.error === 'string') {
+        const error = new Error(parsed.error);
+        if (parsed.error.startsWith('cancelled'))
+            error.name = 'AbortError';
+        waiting.reject(error);
+    }
+    else {
+        waiting.resolve(parsed.value);
+    }
+}
+/** Performs one request of `kind` with `params`; resolves with the host's value. */
+export function hostRequest(kind, params) {
+    return new Promise((resolve, reject) => {
+        if (!bridge) {
+            reject(new Error(`unsupported: no native host for ${kind}`));
+            return;
+        }
+        const id = nextId++;
+        pending.set(id, { resolve: resolve, reject });
+        bridge.hostRequest(id, kind, JSON.stringify(params));
+    });
+}
+/** Forgets the bridge and the waiting requests, for tests. */
+export function resetHostRequests() {
+    bridge = null;
+    pending.clear();
+    nextId = 1;
+}
+async function bridgedFile(file) {
+    return { name: file.name ?? 'file', type: file.type, data: base64Encode(file.bytes()) };
+}
+function filesOf(value) {
+    const files = value?.files ?? [];
+    return files.map((file) => new SimpleFile([base64Decode(file.data)], file.name, { type: file.type }));
+}
+/**
+ * Opens the system's sign-in sheet at `url` and resolves with the callback
+ * URL it ends with; rejects with an `AbortError` when the viewer closes it.
+ */
+export async function webAuthenticate(url, options = {}) {
+    const params = { action: 'start', url };
+    if (options.callbackScheme)
+        params['callbackScheme'] = options.callbackScheme;
+    if (options.ephemeral !== undefined)
+        params['ephemeral'] = options.ephemeral;
+    const result = await hostRequest('webAuth', params);
+    if (typeof result?.url !== 'string')
+        throw new Error('webAuth: the sign-in ended without a URL');
+    return result.url;
+}
+/** The environment fields the host answers, shaped as the web renderer's `HostRequestEnvironment`. */
+export function nativeHostEnvironment() {
+    return {
+        share: async (data) => {
+            const params = {};
+            if (data.title)
+                params['title'] = data.title;
+            if (data.text)
+                params['text'] = data.text;
+            if (data.url)
+                params['url'] = data.url;
+            if (data.files?.length)
+                params['files'] = await Promise.all(data.files.map(bridgedFile));
+            const result = await hostRequest('share', params);
+            if (result?.outcome === 'cancelled') {
+                const error = new Error('cancelled: the viewer closed the share sheet');
+                error.name = 'AbortError';
+                throw error;
+            }
+        },
+        canShare: () => true,
+        download: (blob, filename) => {
+            void hostRequest('share', { files: [{ name: filename, type: blob.type, data: base64Encode(blob.bytes()) }] }).catch(() => undefined);
+        },
+        pickFiles: async (options) => filesOf(await hostRequest('pickFiles', { accept: options.accept, multiple: options.multiple })),
+        objectURL: (file) => objectURL(file),
+        clipboard: {
+            writeText: (text) => hostRequest('clipboard', { action: 'write', text }).then(() => undefined),
+            writeImage: async (png) => {
+                const file = await png;
+                await hostRequest('clipboard', { action: 'write', files: [{ name: 'image.png', type: file.type || 'image/png', data: base64Encode(file.bytes()) }] });
+            },
+            readText: async () => (await hostRequest('clipboard', { action: 'readText' }))?.text ?? '',
+        },
+        pickColor: async (color) => (await hostRequest('pickColor', { color }))?.color ?? null,
+    };
+}
+/** Fills what `environment` lacks with the host's answers; what the page has stays. */
+export function installHostEnvironment(environment) {
+    if (!bridge)
+        return;
+    for (const [key, value] of Object.entries(nativeHostEnvironment())) {
+        if (environment[key] === undefined)
+            environment[key] = value;
+    }
+}
+//# sourceMappingURL=hostRequests.js.map

package/dist/hostRequests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostRequests.js","sourceRoot":"","sources":["../src/hostRequests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAkBxD,IAAI,MAAM,GAA6B,IAAI,CAAC;AAC5C,IAAI,MAAM,GAAG,CAAC,CAAC;AACf,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiF,CAAC;AAEzG,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,MAAyB;IAC3D,MAAM,GAAG,MAAM,CAAC;AAClB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,mBAAmB,CAAC,EAAU,EAAE,MAAoD;IAClG,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnB,IAAI,MAA2C,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAyC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC;QACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAc,IAAY,EAAE,MAA+B;IACpF,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAmC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,IAAI,CAAC;IACd,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,MAAM,GAAG,CAAC,CAAC;AACb,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAoC;IAC7D,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;AAC1F,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,MAAM,KAAK,GAAI,KAA+C,EAAE,KAAK,IAAI,EAAE,CAAC;IAC5E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACxG,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,UAAkC,EAAE;IACrF,MAAM,MAAM,GAA4B,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IACjE,IAAI,OAAO,CAAC,cAAc;QAAE,MAAM,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAC9E,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,MAAM,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAC7E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAmB,SAAS,EAAE,MAAM,CAAC,CAAC;IACtE,IAAI,OAAO,MAAM,EAAE,GAAG,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACjG,OAAO,MAAM,CAAC,GAAG,CAAC;AACpB,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,KAAK,EAAE,KAAK,EAAE,IAA2E,EAAiB,EAAE;YAC1G,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YAC7C,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;YAC1C,IAAI,IAAI,CAAC,GAAG;gBAAE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;YACvC,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM;gBAAE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;YACzF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAuB,OAAO,EAAE,MAAM,CAAC,CAAC;YACxE,IAAI,MAAM,EAAE,OAAO,KAAK,WAAW,EAAE,CAAC;gBACpC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;gBACxE,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC;gBAC1B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;QACpB,QAAQ,EAAE,CAAC,IAAgB,EAAE,QAAgB,EAAQ,EAAE;YACrD,KAAK,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACvI,CAAC;QACD,SAAS,EAAE,KAAK,EAAE,OAA8C,EAAyB,EAAE,CAAC,OAAO,CAAC,MAAM,WAAW,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3L,SAAS,EAAE,CAAC,IAAgB,EAAU,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;QACxD,SAAS,EAAE;YACT,SAAS,EAAE,CAAC,IAAY,EAAiB,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;YACrH,UAAU,EAAE,KAAK,EAAE,GAAwB,EAAiB,EAAE;gBAC5D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC;gBACvB,MAAM,WAAW,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,WAAW,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACxJ,CAAC;YACD,QAAQ,EAAE,KAAK,IAAqB,EAAE,CAAC,CAAC,MAAM,WAAW,CAAoB,WAAW,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE;SAC/H;QACD,SAAS,EAAE,KAAK,EAAE,KAAa,EAA0B,EAAE,CAAC,CAAC,MAAM,WAAW,CAAqB,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI;KAC3I,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,sBAAsB,CAAC,WAAoC;IACzE,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,EAAE,CAAC;QACnE,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -16,7 +16,15 @@ export { installRuntime, type InstallOptions } from './runtime';
 export { nativeBridge, launchArguments, type NativeBridge, type NativeFetchRequest, type NativeFetchResult, type WorkerEngine } from './bridge';
 export { SimpleHeaders, SimpleRequest, SimpleResponse, SimpleAbortController, SimpleAbortSignal, createFetch } from './fetch';
 export { SimpleURL, SimpleURLSearchParams } from './url';
+export { SimpleBlob, SimpleFile, SimpleFormData, encodeMultipart, objectURL } from './blob';
+export { NativeWebSocket, type NativeWebSocketEvent } from './webSocket';
+export { createSubtleCrypto } from './subtle';
+export { matchMedia, updateMediaEnvironment, type MediaEnvironment } from './matchMedia';
+export { hostRequest, webAuthenticate, nativeHostEnvironment, installHostEnvironment, type WebAuthenticateOptions, type BridgedFile } from './hostRequests';
+export { secureStorage, createSecureStorage, type SecureStorage } from './secureStorage';
 export { SimpleTextEncoder, SimpleTextDecoder, base64Encode, base64Decode, utf8Encode, utf8Decode } from './encoding';
 export { createWorker, NativeWorker, encodeMessage, decodeMessage, workerName, type NativeWorkerOptions, type WorkerLike, type WorkerMessageEvent, type WorkerErrorEvent } from './worker';
 export { onOpenURL } from './openURL';
+export { onNotification, registerForPush, type NotificationEvent, type NativeNotificationOptions, type RegisterForPushOptions } from './notifications';
+export { createMediaSession, NativeMediaMetadata, type NativeMediaSession, type MediaMetadataInit, type MediaActionDetails, type MediaActionHandler, type MediaPositionState } from './mediaSession';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAChJ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3L,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAChJ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5J,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3L,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,yBAAyB,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACvJ,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -16,7 +16,15 @@ export { installRuntime } from './runtime';
 export { nativeBridge, launchArguments } from './bridge';
 export { SimpleHeaders, SimpleRequest, SimpleResponse, SimpleAbortController, SimpleAbortSignal, createFetch } from './fetch';
 export { SimpleURL, SimpleURLSearchParams } from './url';
+export { SimpleBlob, SimpleFile, SimpleFormData, encodeMultipart, objectURL } from './blob';
+export { NativeWebSocket } from './webSocket';
+export { createSubtleCrypto } from './subtle';
+export { matchMedia, updateMediaEnvironment } from './matchMedia';
+export { hostRequest, webAuthenticate, nativeHostEnvironment, installHostEnvironment } from './hostRequests';
+export { secureStorage, createSecureStorage } from './secureStorage';
 export { SimpleTextEncoder, SimpleTextDecoder, base64Encode, base64Decode, utf8Encode, utf8Decode } from './encoding';
 export { createWorker, NativeWorker, encodeMessage, decodeMessage, workerName } from './worker';
 export { onOpenURL } from './openURL';
+export { onNotification, registerForPush } from './notifications';
+export { createMediaSession, NativeMediaMetadata } from './mediaSession';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAiC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAuB,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAyF,MAAM,UAAU,CAAC;AAChJ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAA6F,MAAM,UAAU,CAAC;AAC3L,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAiC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAuB,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAyF,MAAM,UAAU,CAAC;AAChJ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC5F,OAAO,EAAE,eAAe,EAA6B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAyB,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,qBAAqB,EAAE,sBAAsB,EAAiD,MAAM,gBAAgB,CAAC;AAC5J,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAsB,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAA6F,MAAM,UAAU,CAAC;AAC3L,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAuF,MAAM,iBAAiB,CAAC;AACvJ,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAA8H,MAAM,gBAAgB,CAAC"}

package/dist/matchMedia.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `matchMedia` for the native app: `(prefers-color-scheme: dark)` and
+ * `light` follow the color scheme the host sends with the environment
+ * (run.ts hands it over), `(prefers-reduced-motion: reduce)` the host's
+ * accessibility setting when it sends one; every other query matches
+ * nothing. Listeners hear a change when the environment does.
+ */
+export interface MediaQueryListLike {
+    readonly media: string;
+    readonly matches: boolean;
+    onchange: ((event: {
+        matches: boolean;
+        media: string;
+    }) => void) | null;
+    addEventListener(type: 'change', listener: (event: {
+        matches: boolean;
+        media: string;
+    }) => void): void;
+    removeEventListener(type: 'change', listener: (event: {
+        matches: boolean;
+        media: string;
+    }) => void): void;
+    /** The older names. */
+    addListener(listener: (event: {
+        matches: boolean;
+        media: string;
+    }) => void): void;
+    removeListener(listener: (event: {
+        matches: boolean;
+        media: string;
+    }) => void): void;
+}
+export interface MediaEnvironment {
+    colorScheme?: 'light' | 'dark';
+    reducedMotion?: boolean;
+}
+/** The runtime's `matchMedia(query)`. */
+export declare function matchMedia(query: string): MediaQueryListLike;
+/** What the host sent with the environment; lists whose answer changed tell their listeners. */
+export declare function updateMediaEnvironment(next: MediaEnvironment): void;
+/** Forgets the environment and the lists, for tests. */
+export declare function resetMediaEnvironment(): void;
+//# sourceMappingURL=matchMedia.d.ts.map

package/dist/matchMedia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchMedia.d.ts","sourceRoot":"","sources":["../src/matchMedia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACxE,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACvG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1G,uBAAuB;IACvB,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAClF,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CACtF;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAgBD,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAoB5D;AAED,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAUnE;AAED,wDAAwD;AACxD,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C"}

package/dist/matchMedia.js

@@ -0,0 +1,63 @@
+/**
+ * `matchMedia` for the native app: `(prefers-color-scheme: dark)` and
+ * `light` follow the color scheme the host sends with the environment
+ * (run.ts hands it over), `(prefers-reduced-motion: reduce)` the host's
+ * accessibility setting when it sends one; every other query matches
+ * nothing. Listeners hear a change when the environment does.
+ */
+let environment = {};
+const lists = new Set();
+function evaluate(query) {
+    const normalized = query.trim().toLowerCase().replace(/\s+/g, '');
+    if (normalized === '(prefers-color-scheme:dark)')
+        return environment.colorScheme === 'dark';
+    if (normalized === '(prefers-color-scheme:light)')
+        return environment.colorScheme !== 'dark';
+    if (normalized === '(prefers-reduced-motion:reduce)')
+        return environment.reducedMotion === true;
+    if (normalized === '(prefers-reduced-motion:no-preference)')
+        return environment.reducedMotion !== true;
+    return false;
+}
+/** The runtime's `matchMedia(query)`. */
+export function matchMedia(query) {
+    const media = String(query);
+    const state = { media, matches: evaluate(media), listeners: new Set(), onchange: null };
+    lists.add(state);
+    return {
+        media,
+        get matches() {
+            return state.matches;
+        },
+        get onchange() {
+            return state.onchange;
+        },
+        set onchange(listener) {
+            state.onchange = listener;
+        },
+        addEventListener: (_type, listener) => void state.listeners.add(listener),
+        removeEventListener: (_type, listener) => void state.listeners.delete(listener),
+        addListener: (listener) => void state.listeners.add(listener),
+        removeListener: (listener) => void state.listeners.delete(listener),
+    };
+}
+/** What the host sent with the environment; lists whose answer changed tell their listeners. */
+export function updateMediaEnvironment(next) {
+    environment = { ...environment, ...next };
+    for (const state of lists) {
+        const matches = evaluate(state.media);
+        if (matches === state.matches)
+            continue;
+        state.matches = matches;
+        const event = { matches, media: state.media };
+        state.onchange?.(event);
+        for (const listener of state.listeners)
+            listener(event);
+    }
+}
+/** Forgets the environment and the lists, for tests. */
+export function resetMediaEnvironment() {
+    environment = {};
+    lists.clear();
+}
+//# sourceMappingURL=matchMedia.js.map

package/dist/matchMedia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchMedia.js","sourceRoot":"","sources":["../src/matchMedia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,IAAI,WAAW,GAAqB,EAAE,CAAC;AACvC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4F,CAAC;AAElH,SAAS,QAAQ,CAAC,KAAa;IAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClE,IAAI,UAAU,KAAK,6BAA6B;QAAE,OAAO,WAAW,CAAC,WAAW,KAAK,MAAM,CAAC;IAC5F,IAAI,UAAU,KAAK,8BAA8B;QAAE,OAAO,WAAW,CAAC,WAAW,KAAK,MAAM,CAAC;IAC7F,IAAI,UAAU,KAAK,iCAAiC;QAAE,OAAO,WAAW,CAAC,aAAa,KAAK,IAAI,CAAC;IAChG,IAAI,UAAU,KAAK,wCAAwC;QAAE,OAAO,WAAW,CAAC,aAAa,KAAK,IAAI,CAAC;IACvG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,GAAG,EAAY,EAAE,QAAQ,EAAE,IAAuB,EAAE,CAAC;IACrH,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO;QACL,KAAK;QACL,IAAI,OAAO;YACT,OAAO,KAAK,CAAC,OAAO,CAAC;QACvB,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ;YACnB,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC5B,CAAC;QACD,gBAAgB,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzE,mBAAmB,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC/E,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC7D,cAAc,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,sBAAsB,CAAC,IAAsB;IAC3D,WAAW,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,KAAK,CAAC,OAAO;YAAE,SAAS;QACxC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;QACxB,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9C,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,qBAAqB;IACnC,WAAW,GAAG,EAAE,CAAC;IACjB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/mediaSession.d.ts

@@ -0,0 +1,59 @@
+/**
+ * `navigator.mediaSession` and `MediaMetadata` for the native app: what an
+ * audio app tells the browser about what plays (the lock screen, the media
+ * keys) reaches the host's `mediaSession(update)` instead, which sets
+ * `MPNowPlayingInfoCenter` and `MPRemoteCommandCenter` (HostBridge.swift,
+ * NowPlayingBridge.swift); the commands the viewer gives come back to
+ * `__sbMediaSessionCommand(json)` and run the handlers `setActionHandler`
+ * registered, with the details the browser would give (`seekTime`,
+ * `seekOffset`). The update is the one the web renderer's `mediaSession`
+ * request carries (docs/ops-protocol.md, "Now playing"), so an app writes
+ * the same code for the page and the native app. In the page (the round
+ * trip) the page's own `navigator.mediaSession` is there already and
+ * nothing is installed over it.
+ */
+import type { NativeBridge } from './bridge';
+type Action = 'play' | 'pause' | 'stop' | 'nexttrack' | 'previoustrack' | 'seekto' | 'seekforward' | 'seekbackward' | 'skipad' | 'togglemicrophone' | 'togglecamera' | 'hangup';
+export interface MediaImage {
+    src: string;
+    sizes?: string;
+    type?: string;
+}
+export interface MediaMetadataInit {
+    title?: string;
+    artist?: string;
+    album?: string;
+    artwork?: MediaImage[];
+}
+/** The browser's `MediaMetadata`. */
+export declare class NativeMediaMetadata {
+    title: string;
+    artist: string;
+    album: string;
+    artwork: MediaImage[];
+    constructor(init?: MediaMetadataInit);
+}
+export interface MediaPositionState {
+    duration?: number;
+    playbackRate?: number;
+    position?: number;
+}
+export interface MediaActionDetails {
+    action: Action;
+    seekTime?: number;
+    seekOffset?: number;
+}
+export type MediaActionHandler = (details: MediaActionDetails) => void;
+/** The browser's `navigator.mediaSession`, as far as audio apps use it. */
+export interface NativeMediaSession {
+    metadata: NativeMediaMetadata | null;
+    playbackState: 'none' | 'playing' | 'paused';
+    setPositionState(state?: MediaPositionState): void;
+    setActionHandler(action: Action, handler: MediaActionHandler | null): void;
+}
+export declare function createMediaSession(native: Pick<NativeBridge, 'mediaSession'>): {
+    session: NativeMediaSession;
+    receive: (json: string) => void;
+};
+export {};
+//# sourceMappingURL=mediaSession.d.ts.map

package/dist/mediaSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaSession.d.ts","sourceRoot":"","sources":["../src/mediaSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,KAAK,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,QAAQ,GAAG,aAAa,GAAG,cAAc,GAAG,QAAQ,GAAG,kBAAkB,GAAG,cAAc,GAAG,QAAQ,CAAC;AAchL,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,qCAAqC;AACrC,qBAAa,mBAAmB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;gBAEV,IAAI,GAAE,iBAAsB;CAMzC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAEvE,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC7C,gBAAgB,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnD,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAC;CAC5E;AASD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,GAAG;IAAE,OAAO,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,CA0E/I"}

package/dist/mediaSession.js

@@ -0,0 +1,119 @@
+/**
+ * `navigator.mediaSession` and `MediaMetadata` for the native app: what an
+ * audio app tells the browser about what plays (the lock screen, the media
+ * keys) reaches the host's `mediaSession(update)` instead, which sets
+ * `MPNowPlayingInfoCenter` and `MPRemoteCommandCenter` (HostBridge.swift,
+ * NowPlayingBridge.swift); the commands the viewer gives come back to
+ * `__sbMediaSessionCommand(json)` and run the handlers `setActionHandler`
+ * registered, with the details the browser would give (`seekTime`,
+ * `seekOffset`). The update is the one the web renderer's `mediaSession`
+ * request carries (docs/ops-protocol.md, "Now playing"), so an app writes
+ * the same code for the page and the native app. In the page (the round
+ * trip) the page's own `navigator.mediaSession` is there already and
+ * nothing is installed over it.
+ */
+/** The protocol's command each Media Session action is; the rest get no button. */
+const COMMANDS = {
+    play: 'play',
+    pause: 'pause',
+    stop: 'stop',
+    nexttrack: 'nextTrack',
+    previoustrack: 'previousTrack',
+    seekto: 'seekTo',
+    seekforward: 'skipForward',
+    seekbackward: 'skipBackward',
+};
+/** The browser's `MediaMetadata`. */
+export class NativeMediaMetadata {
+    title;
+    artist;
+    album;
+    artwork;
+    constructor(init = {}) {
+        this.title = init.title ?? '';
+        this.artist = init.artist ?? '';
+        this.album = init.album ?? '';
+        this.artwork = (init.artwork ?? []).map((image) => ({ ...image }));
+    }
+}
+export function createMediaSession(native) {
+    let metadata = null;
+    let playbackState = 'none';
+    let position = null;
+    const handlers = new Map();
+    // The whole state each time: the host keeps what it has and changes what differs.
+    const sync = () => {
+        const commands = [...handlers.keys()].map((action) => COMMANDS[action]).filter((command) => command !== undefined);
+        native.mediaSession?.(JSON.stringify({
+            metadata: metadata === null ? null : { title: metadata.title, artist: metadata.artist, album: metadata.album, artwork: metadata.artwork[0]?.src },
+            playbackState,
+            position: position === null
+                ? null
+                : { duration: Number.isFinite(position.duration) ? position.duration : 0, position: position.position ?? 0, rate: position.playbackRate ?? 1 },
+            commands,
+        }));
+    };
+    const session = {
+        get metadata() {
+            return metadata;
+        },
+        set metadata(value) {
+            metadata = value === null || value === undefined ? null : value instanceof NativeMediaMetadata ? value : new NativeMediaMetadata(value);
+            sync();
+        },
+        get playbackState() {
+            return playbackState;
+        },
+        set playbackState(value) {
+            if (value !== 'none' && value !== 'playing' && value !== 'paused')
+                throw new TypeError(`${String(value)} is not a valid MediaSessionPlaybackState`);
+            playbackState = value;
+            sync();
+        },
+        setPositionState(state) {
+            if (state === undefined || state.duration === undefined) {
+                position = null;
+            }
+            else {
+                if (!(state.duration >= 0))
+                    throw new TypeError('the duration must be a non-negative number');
+                if (state.position !== undefined && (state.position < 0 || state.position > state.duration))
+                    throw new TypeError('the position must be within the duration');
+                position = { ...state };
+            }
+            sync();
+        },
+        setActionHandler(action, handler) {
+            if (!(action in COMMANDS) && !['skipad', 'togglemicrophone', 'togglecamera', 'hangup'].includes(action))
+                throw new TypeError(`${String(action)} is not a valid MediaSessionAction`);
+            if (handler)
+                handlers.set(action, handler);
+            else
+                handlers.delete(action);
+            sync();
+        },
+    };
+    const receive = (json) => {
+        let received;
+        try {
+            received = JSON.parse(json);
+        }
+        catch {
+            return;
+        }
+        const action = Object.keys(COMMANDS).find((name) => COMMANDS[name] === received.command);
+        if (!action)
+            return;
+        const handler = handlers.get(action);
+        if (!handler)
+            return;
+        const details = { action };
+        if (action === 'seekto' && typeof received.position === 'number')
+            details.seekTime = received.position;
+        if ((action === 'seekforward' || action === 'seekbackward') && typeof received.interval === 'number')
+            details.seekOffset = received.interval;
+        handler(details);
+    };
+    return { session, receive };
+}
+//# sourceMappingURL=mediaSession.js.map

package/dist/mediaSession.js.map

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