@bridgething/browser 0.4.0

package/README.md

@@ -0,0 +1,50 @@
+# @bridgething/browser
+
+Drive a [bridgething](https://github.com/JoeyEamigh/bridgething) Spotify Car Thing
+from a web page: install and switch webapps, push daemon and image updates, rename
+the device.
+
+```sh
+bun add @bridgething/browser
+```
+
+## Connecting
+
+```ts
+import { Device } from '@bridgething/browser';
+
+// over the usb-c cable, via the daemon's network gateway
+const device = await Device.overNetwork('bridgething.local');
+
+// or over an already-paired bluetooth peer, via Web Serial
+const device = await Device.overSerial();
+```
+
+`overSerial()` resolves null when the user dismisses the chooser. Use
+`serialAvailable()` to decide whether to offer it at all; iOS Safari and Firefox
+have no Web Serial.
+
+## Driving a device
+
+```ts
+const meta = await device.meta();
+const webapps = await device.webapps();
+
+await device.switchWebapp(webapps[0].id);
+await device.installWebapp(
+  new Uint8Array(await bundle.arrayBuffer()),
+  catalogUrl,
+);
+await device.setNickname('the dashboard');
+```
+
+Updates are a push plus a feed:
+
+```ts
+const phase = await device.push('daemon', binary);
+if (phase.kind === 'failed') console.error(phase.reason);
+```
+
+Manifest helpers - `fetchManifest`, `compositeVersion`, `otaArtifactUrls` - read
+the same discover manifest the device does, so a page can work out what a device
+should be running.

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import type { BridgeThingMeta, WebappInfo } from '@bridgething/lib';
+import type { DeviceNicknameReply, WebappActive, WebappSlot, WebappSlots } from '@bridgething/lib/gateway';
+import type { ArtifactUrls, CompositeVersion, InstalledWebapp, OtaDiscoverManifest, OtaUpdateKind, Phase, UpdateEvent } from '../wasm/core-wasm.js';
+import { type SerialPort } from './web-serial.js';
+export type { ArtifactDigest, ArtifactUrls, CompositeVersion, InstalledWebapp, OtaDiscoverManifest, OtaManifestChannel, OtaManifestRelease, OtaPatchDigest, OtaReleaseArtifacts, OtaUpdateKind, Phase, PhaseKind, PlanStep, UpdateEvent, } from '../wasm/core-wasm.js';
+export { permittedSerialPorts, requestSerialPort, serialAvailable } from './web-serial.js';
+export type { SerialPort } from './web-serial.js';
+export declare const DEFAULT_HOST = "bridgething.local";
+export declare function ready(): Promise<unknown>;
+export declare function gatewayUrl(host: string): string;
+export declare function fetchManifest(rootUrl: string): Promise<OtaDiscoverManifest>;
+export declare function compositeVersion(raw: string): Promise<CompositeVersion | null>;
+export declare function otaArtifactUrls(opts: {
+    rootUrl: string;
+    channel: string;
+    daemonVersion: string;
+    imageVersion: string;
+    imageVariant: string;
+}): Promise<ArtifactUrls>;
+export declare class Device {
+    private readonly session;
+    private readonly detach;
+    private constructor();
+    static overNetwork(host?: string): Promise<Device>;
+    static overSerial(port?: SerialPort): Promise<Device | null>;
+    get id(): string;
+    meta(): Promise<BridgeThingMeta | null>;
+    webapps(): Promise<WebappInfo[]>;
+    activeWebapp(): Promise<WebappActive>;
+    webappSlots(): Promise<WebappSlots>;
+    switchWebapp(id: string): Promise<WebappActive>;
+    uninstallWebapp(id: string): Promise<WebappActive>;
+    setWebappSlot(slot: WebappSlot, id: string | null): Promise<WebappSlots>;
+    setNickname(nickname: string): Promise<DeviceNicknameReply>;
+    installWebapp(bundle: Uint8Array, provenance?: string): Promise<InstalledWebapp>;
+    push(kind: Exclude<OtaUpdateKind, 'image'>, artifact: Uint8Array, label?: string): Promise<Phase>;
+    pushImage(swu: Uint8Array, zcks: Map<string, Uint8Array>, updateUrlBase?: string): Promise<Phase>;
+    nextEvent(): Promise<UpdateEvent>;
+    closed(): Promise<void>;
+    close(): Promise<void>;
+}
+//# 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,100 @@
+import { BRIDGETHING_DEFAULT_HOST, BRIDGETHING_NETWORK_GATEWAY_PORT } from '@bridgething/lib';
+import initWasm, { ByteLink, DeliverySession, artifactUrls, discoverManifest, parseCompositeVersion, } from '../wasm/core-wasm.js';
+import { pumpSerialPort, requestSerialPort } from './web-serial.js';
+export { permittedSerialPorts, requestSerialPort, serialAvailable } from './web-serial.js';
+export const DEFAULT_HOST = BRIDGETHING_DEFAULT_HOST;
+let started = null;
+export function ready() {
+    started ??= initWasm();
+    return started;
+}
+export function gatewayUrl(host) {
+    const trimmed = host
+        .trim()
+        .replace(/^wss?:\/\//, '')
+        .replace(/\/+$/, '');
+    return `ws://${trimmed.includes(':') ? trimmed : `${trimmed}:${BRIDGETHING_NETWORK_GATEWAY_PORT}`}/`;
+}
+export async function fetchManifest(rootUrl) {
+    await ready();
+    return discoverManifest(rootUrl);
+}
+export async function compositeVersion(raw) {
+    await ready();
+    return parseCompositeVersion(raw);
+}
+export async function otaArtifactUrls(opts) {
+    await ready();
+    return artifactUrls(opts.rootUrl, opts.channel, opts.daemonVersion, opts.imageVersion, opts.imageVariant);
+}
+export class Device {
+    session;
+    detach;
+    constructor(session, detach) {
+        this.session = session;
+        this.detach = detach;
+    }
+    static async overNetwork(host = DEFAULT_HOST) {
+        await ready();
+        const session = await DeliverySession.connect(gatewayUrl(host), undefined);
+        return new Device(session, async () => { });
+    }
+    static async overSerial(port) {
+        const opened = port ?? (await requestSerialPort());
+        if (!opened)
+            return null;
+        await ready();
+        let write = () => Promise.resolve();
+        const link = new ByteLink(chunk => write(chunk));
+        const pump = pumpSerialPort(opened, chunk => link.push(chunk), () => link.close());
+        write = chunk => pump.write(chunk);
+        const session = await DeliverySession.attach(link, undefined);
+        return new Device(session, () => pump.close());
+    }
+    get id() {
+        return this.session.deviceId;
+    }
+    meta() {
+        return this.session.meta();
+    }
+    webapps() {
+        return this.session.webapps();
+    }
+    activeWebapp() {
+        return this.session.activeWebapp();
+    }
+    webappSlots() {
+        return this.session.webappSlots();
+    }
+    switchWebapp(id) {
+        return this.session.switchWebapp(id);
+    }
+    uninstallWebapp(id) {
+        return this.session.uninstallWebapp(id);
+    }
+    setWebappSlot(slot, id) {
+        return this.session.setWebappSlot(slot, id ?? undefined);
+    }
+    setNickname(nickname) {
+        return this.session.setNickname(nickname);
+    }
+    installWebapp(bundle, provenance) {
+        return this.session.installWebapp(bundle, provenance);
+    }
+    push(kind, artifact, label) {
+        return this.session.push(kind, artifact, label);
+    }
+    pushImage(swu, zcks, updateUrlBase) {
+        return this.session.pushImage(swu, zcks, updateUrlBase);
+    }
+    nextEvent() {
+        return this.session.nextEvent();
+    }
+    closed() {
+        return this.session.closed();
+    }
+    close() {
+        return this.detach();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/web-serial.d.ts

@@ -0,0 +1,42 @@
+declare global {
+    interface Navigator {
+        readonly serial?: SerialAPI;
+    }
+}
+type SerialAPI = {
+    requestPort(options?: SerialPortRequestOptions): Promise<SerialPort>;
+    getPorts(): Promise<SerialPort[]>;
+};
+type SerialPortRequestOptions = {
+    filters?: SerialPortFilter[];
+    allowedBluetoothServiceClassIds?: string[];
+};
+type SerialPortFilter = {
+    bluetoothServiceClassId?: string;
+};
+type SerialPortInfo = {
+    bluetoothServiceClassId?: string;
+    usbVendorId?: number;
+    usbProductId?: number;
+};
+export type SerialPort = {
+    open(options: {
+        baudRate: number;
+    }): Promise<void>;
+    close(): Promise<void>;
+    getInfo(): SerialPortInfo;
+    readonly readable: ReadableStream<Uint8Array> | null;
+    readonly writable: WritableStream<Uint8Array> | null;
+    addEventListener(event: 'disconnect', listener: () => void): void;
+    removeEventListener(event: 'disconnect', listener: () => void): void;
+};
+export declare function serialAvailable(): boolean;
+export declare function requestSerialPort(serviceUuid?: string): Promise<SerialPort | null>;
+export declare function permittedSerialPorts(serviceUuid?: string): Promise<SerialPort[]>;
+export type SerialPump = {
+    write(chunk: Uint8Array): Promise<void>;
+    close(): Promise<void>;
+};
+export declare function pumpSerialPort(port: SerialPort, onBytes: (chunk: Uint8Array) => void, onClosed: () => void): SerialPump;
+export {};
+//# sourceMappingURL=web-serial.d.ts.map

package/dist/web-serial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-serial.d.ts","sourceRoot":"","sources":["../src/web-serial.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,SAAS;QACjB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;KAC7B;CACF;AAED,KAAK,SAAS,GAAG;IACf,WAAW,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrE,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CACnC,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,+BAA+B,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5C,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,cAAc,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACrD,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAClE,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACtE,CAAC;AAIF,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,wBAAsB,iBAAiB,CAAC,WAAW,GAAE,MAAiC,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAiBlH;AAED,wBAAsB,oBAAoB,CAAC,WAAW,GAAE,MAAiC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAKhH;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,EACpC,QAAQ,EAAE,MAAM,IAAI,GACnB,UAAU,CAwCZ"}

package/dist/web-serial.js

@@ -0,0 +1,74 @@
+import { BRIDGETHING_PROFILE_UUID } from '@bridgething/lib';
+const SERIAL_BAUD_RATE = 9600;
+export function serialAvailable() {
+    return typeof navigator !== 'undefined' && 'serial' in navigator;
+}
+export async function requestSerialPort(serviceUuid = BRIDGETHING_PROFILE_UUID) {
+    const serial = navigator.serial;
+    if (!serial) {
+        throw new Error('navigator.serial is unavailable - Web Serial is Chromium-only (Chrome 117+ desktop, Chrome 138+ Android). Use the companion app on iOS Safari.');
+    }
+    let port;
+    try {
+        port = await serial.requestPort({ allowedBluetoothServiceClassIds: [serviceUuid] });
+    }
+    catch (err) {
+        if (err instanceof DOMException && err.name === 'NotFoundError')
+            return null;
+        throw err;
+    }
+    await port.open({ baudRate: SERIAL_BAUD_RATE });
+    return port;
+}
+export async function permittedSerialPorts(serviceUuid = BRIDGETHING_PROFILE_UUID) {
+    const serial = navigator.serial;
+    if (!serial)
+        return [];
+    const ports = await serial.getPorts();
+    return ports.filter(port => port.getInfo().bluetoothServiceClassId?.toLowerCase() === serviceUuid.toLowerCase());
+}
+export function pumpSerialPort(port, onBytes, onClosed) {
+    const reader = port.readable?.getReader();
+    const writer = port.writable?.getWriter();
+    if (!reader || !writer)
+        throw new Error('web-serial: port has no readable/writable stream');
+    let done = false;
+    const finish = () => {
+        if (done)
+            return;
+        done = true;
+        port.removeEventListener('disconnect', finish);
+        onClosed();
+    };
+    port.addEventListener('disconnect', finish);
+    const reading = (async () => {
+        try {
+            for (;;) {
+                const { value, done: eof } = await reader.read();
+                if (eof)
+                    break;
+                if (value && value.byteLength > 0)
+                    onBytes(value);
+            }
+        }
+        catch (err) {
+            if (err instanceof Error && err.name !== 'AbortError') {
+                console.error('[bridgething] web-serial read loop error', err);
+            }
+        }
+        finally {
+            finish();
+        }
+    })();
+    return {
+        write: chunk => writer.write(chunk),
+        async close() {
+            finish();
+            await reader.cancel().catch(() => { });
+            await writer.close().catch(() => { });
+            await reading;
+            await port.close().catch(() => { });
+        },
+    };
+}
+//# sourceMappingURL=web-serial.js.map

package/dist/web-serial.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@bridgething/browser",
+  "version": "0.4.0",
+  "description": "Drive a Spotify Car Thing from the browser: the bridgething delivery core compiled to wasm, plus the Web Serial and network transports.",
+  "license": "MIT",
+  "author": "Joey Eamigh <55670930+JoeyEamigh@users.noreply.github.com> (https://github.com/JoeyEamigh)",
+  "homepage": "https://bridgething.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JoeyEamigh/bridgething.git",
+    "directory": "packages/browser"
+  },
+  "bugs": {
+    "url": "https://github.com/JoeyEamigh/bridgething/issues"
+  },
+  "keywords": [
+    "bridgething",
+    "spotify",
+    "car-thing",
+    "superbird",
+    "web-serial",
+    "wasm"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "wasm"
+  ],
+  "scripts": {
+    "prebuild": "rm -rf dist && bun run wasm",
+    "wasm": "wasm-pack build ../../crates/delivery/wasm --target web --out-dir ../../../packages/browser/wasm --out-name core-wasm && rm -f wasm/package.json wasm/.gitignore",
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@bridgething/lib": "0.4.0"
+  },
+  "peerDependencies": {
+    "typescript": "^6.0.3"
+  }
+}

package/wasm/core-wasm.d.ts

@@ -0,0 +1,223 @@
+/* tslint:disable */
+/* eslint-disable */
+
+export type OtaUpdateKind = "image" | "daemon" | "builtinWebapp" | "installedWebapp" | "wakewordModel";
+
+export type PhaseKind = "idle" | "downloading" | "streaming" | "applying" | "staged" | "completed" | "failed";
+
+export interface Phase {
+    kind: PhaseKind;
+    asset?: string;
+    received?: number;
+    sent?: number;
+    total?: number;
+    ratePerSec?: number;
+    etaSeconds?: number;
+    writePercent?: number;
+    reason?: string;
+}
+
+export interface PlanStep {
+    id: number;
+    kind: "download" | "stream" | "apply" | "reboot";
+    label: string;
+    bytes: number;
+}
+
+export type UpdateEventKind =
+| "manifestPolled"
+| "manifestPollFailed"
+| "updateAvailable"
+| "planned"
+| "progress"
+| "updated"
+| "failed"
+| "lagged";
+
+export interface UpdateEvent {
+    kind: UpdateEventKind;
+    deviceId?: string;
+    updateKind?: OtaUpdateKind;
+    release?: string;
+    daemonVersion?: string;
+    imageVersion?: string;
+    channel?: string;
+    rootUrl?: string;
+    version?: string;
+    updatedAt?: string;
+    reason?: string;
+    stepId?: number;
+    steps?: PlanStep[];
+    phase?: Phase;
+}
+
+export interface InstalledWebapp {
+    id: string;
+    name: string;
+    version: string;
+    provenance?: string;
+}
+
+export interface CompositeVersion {
+    daemon: string;
+    image: string;
+}
+
+export interface ArtifactUrls {
+    imageSwu: string;
+    imageZck: string;
+    imageBootZck: string;
+    daemonBinary: string;
+    daemonBinaryZst: string;
+}
+
+export interface ArtifactDigest {
+    size: number;
+    sha256: string;
+}
+
+export interface OtaPatchDigest {
+    size: number;
+    sha256: string;
+    sourceSha256: string | null;
+}
+
+export interface OtaReleaseArtifacts {
+    daemon: ArtifactDigest | null;
+    daemonZst: ArtifactDigest | null;
+    imageSwu: ArtifactDigest | null;
+    imageZck: ArtifactDigest | null;
+    imageBootZck: ArtifactDigest | null;
+    webapps: Record<string, ArtifactDigest>;
+    daemonPatches: Record<string, OtaPatchDigest>;
+}
+
+export interface OtaManifestChannel {
+    name: string;
+    stability: string;
+    isDefault: boolean;
+    latest: string;
+    releases: string[];
+}
+
+export interface OtaManifestRelease {
+    version: string;
+    channel: string;
+    yanked: string | null;
+    deprecated: boolean;
+    builtinWebapps: Record<string, string>;
+    artifacts: OtaReleaseArtifacts | null;
+}
+
+export interface OtaDiscoverManifest {
+    manifestVersion: number;
+    updatedAt: string;
+    channels: Record<string, OtaManifestChannel>;
+    releases: Record<string, OtaManifestRelease>;
+}
+
+
+
+export class ByteLink {
+    free(): void;
+    [Symbol.dispose](): void;
+    close(): void;
+    constructor(write: (chunk: Uint8Array) => Promise<void>);
+    push(chunk: Uint8Array): void;
+}
+
+export class DeliverySession {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    activeWebapp(): Promise<any>;
+    static attach(link: ByteLink, device_id?: string | null): Promise<DeliverySession>;
+    closed(): Promise<void>;
+    static connect(url: string, device_id?: string | null): Promise<DeliverySession>;
+    installWebapp(bundle: Uint8Array, provenance?: string | null): Promise<InstalledWebapp>;
+    meta(): Promise<any>;
+    nextEvent(): Promise<UpdateEvent>;
+    push(kind: OtaUpdateKind, artifact: Uint8Array, label?: string | null): Promise<Phase>;
+    pushImage(swu: Uint8Array, zcks: Map<string, Uint8Array>, update_url_base?: string | null): Promise<Phase>;
+    setNickname(nickname: string): Promise<any>;
+    setWebappSlot(slot: "launcher" | "overlay", id?: string | null): Promise<any>;
+    switchWebapp(id: string): Promise<any>;
+    uninstallWebapp(id: string): Promise<any>;
+    webappSlots(): Promise<any>;
+    webapps(): Promise<any>;
+    readonly deviceId: string;
+}
+
+export function artifactUrls(root_url: string, channel: string, daemon_version: string, image_version: string, image_variant: string): ArtifactUrls;
+
+export function discoverManifest(root_url: string): Promise<OtaDiscoverManifest>;
+
+export function init(): void;
+
+export function parseCompositeVersion(raw: string): CompositeVersion | null;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_bytelink_free: (a: number, b: number) => void;
+    readonly __wbg_deliverysession_free: (a: number, b: number) => void;
+    readonly artifactUrls: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
+    readonly bytelink_close: (a: number) => void;
+    readonly bytelink_new: (a: number) => number;
+    readonly bytelink_push: (a: number, b: number, c: number) => void;
+    readonly deliverysession_activeWebapp: (a: number) => number;
+    readonly deliverysession_attach: (a: number, b: number, c: number) => number;
+    readonly deliverysession_closed: (a: number) => number;
+    readonly deliverysession_connect: (a: number, b: number, c: number, d: number) => number;
+    readonly deliverysession_deviceId: (a: number, b: number) => void;
+    readonly deliverysession_installWebapp: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly deliverysession_meta: (a: number) => number;
+    readonly deliverysession_nextEvent: (a: number) => number;
+    readonly deliverysession_push: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+    readonly deliverysession_pushImage: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+    readonly deliverysession_setNickname: (a: number, b: number, c: number) => number;
+    readonly deliverysession_setWebappSlot: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly deliverysession_switchWebapp: (a: number, b: number, c: number) => number;
+    readonly deliverysession_uninstallWebapp: (a: number, b: number, c: number) => number;
+    readonly deliverysession_webappSlots: (a: number) => number;
+    readonly deliverysession_webapps: (a: number) => number;
+    readonly discoverManifest: (a: number, b: number) => number;
+    readonly init: () => void;
+    readonly parseCompositeVersion: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_5999: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_5982: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_4227: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_4227_2: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_4227_3: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_4543: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_5026: (a: number, b: number) => void;
+    readonly __wbindgen_export: (a: number, b: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export3: (a: number) => void;
+    readonly __wbindgen_export4: (a: number, b: number, c: number) => void;
+    readonly __wbindgen_export5: (a: number, b: number) => void;
+    readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;