@bridgething/extension 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joey Eamigh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @bridgething/extension
+
+The client a [bridgething](https://github.com/JoeyEamigh/bridgething) extension
+uses to talk to its host. An extension is a Deno process the bridgething
+desktop app runs beside a webapp.
+
+```sh
+bun add @bridgething/extension
+```
+
+```ts
+import { asJson, defineExtension, json } from '@bridgething/extension';
+
+defineExtension({
+  start(ctx) {
+    ctx.on('device', e => ctx.log.info(e.type, e.device.name));
+    ctx.on('message', (device, message) =>
+      device.send(json({ echo: asJson(message) })),
+    );
+  },
+});
+```
+
+Register listeners synchronously in `start`; the host replays connected devices
+as soon as `start` runs. The host protocol owns stdin and stdout, so
+`console.log` corrupts it. Log with `ctx.log`.
+
+Scaffold a webapp with an extension:
+
+```sh
+bun create bridgething my-app --extension
+```
+
+- Docs: <https://bridgething.com/docs/extensions>
+- Source: <https://github.com/JoeyEamigh/bridgething>

package/dist/context.d.ts

@@ -0,0 +1,100 @@
+import type { ForwardMessage, SendableMessage } from './message.js';
+import type { ExtensionWebapp, LogLevel } from './protocol.js';
+/** Drops a listener registered with `ctx.on`. Safe to call more than once. */
+export type Unsubscribe = () => void;
+export type DeviceRef = string | {
+    id: string;
+};
+/**
+ * One Car Thing the host has announced to this extension. A handle stays valid for the life of the process.
+ * A disconnected device keeps its last known `name` and `config`, with `connected` false.
+ */
+export interface Device {
+    /** The device serial. Stable across reconnects and across host restarts. */
+    readonly id: string;
+    readonly name: string;
+    /** True while this extension's webapp is the active webapp on this device. */
+    readonly active: boolean;
+    readonly connected: boolean;
+    /** The webapp's settings for this device, keyed by config key from `manifest.json`. */
+    readonly config: Readonly<Record<string, string>>;
+    /**
+     * Sends a message to this device's webapp. The host delivers it while the webapp is active,
+     * and drops it otherwise.
+     */
+    send(message: SendableMessage): void;
+}
+/** Connect, disconnect, and active-webapp changes, in one stream. */
+export type DeviceEvent = {
+    type: 'connected' | 'disconnected' | 'active';
+    device: Device;
+};
+export type DeviceListener = (event: DeviceEvent) => void;
+export type MessageListener = (device: Device, message: ForwardMessage) => void;
+/** `value` is null when the settings page clears the key, which removes it from `device.config`. */
+export type ConfigListener = (device: Device, key: string, value: string | null) => void;
+/**
+ * Persistent JSON store for this extension, held in a file under `ctx.dataDir`.
+ * Every method rejects once shutdown starts, so write as state changes.
+ */
+export interface KvStore {
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(): Promise<string[]>;
+}
+export interface AuthBridge {
+    /**
+     * Opens `url` in the user's browser. Resolves with the callback URL the host captured,
+     * including its query string. Rejects if the user cancels.
+     */
+    authorize(url: string): Promise<string>;
+}
+/** Writes to the desktop app's log, prefixed with the webapp name. */
+export interface ExtensionLog {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    log(level: LogLevel, ...args: unknown[]): void;
+}
+/** Everything an extension can reach. `start` receives it. */
+export interface ExtensionContext {
+    /** The host protocol revision. */
+    readonly api: number;
+    readonly webapp: ExtensionWebapp;
+    /** Directory this extension may write to. The kv store file lives here. */
+    readonly dataDir: string;
+    /** The connected devices, recomputed on every read. */
+    readonly devices: readonly Device[];
+    /** Returns a handle for any device id, connected or not. */
+    device(id: string): Device;
+    /** Sends a message to every connected device where this webapp is active. */
+    broadcast(message: SendableMessage): void;
+    /** Returns the settings for a device. An id the host has not announced returns an empty object. */
+    config(device: DeviceRef): Readonly<Record<string, string>>;
+    /**
+     * Registers a listener. Call `on` synchronously at the top of `start`. The host replays
+     * connected devices right after `start` begins, so a listener registered after an `await`
+     * can miss them.
+     */
+    on(event: 'device', listener: DeviceListener): Unsubscribe;
+    on(event: 'message', listener: MessageListener): Unsubscribe;
+    on(event: 'config', listener: ConfigListener): Unsubscribe;
+    readonly kv: KvStore;
+    readonly auth: AuthBridge;
+    readonly log: ExtensionLog;
+}
+export type ExtensionSpec = {
+    /**
+     * Runs once, after the host connects. Register listeners synchronously, then do the rest of
+     * your setup. The desktop app shows this extension as starting until the returned promise settles.
+     */
+    start(ctx: ExtensionContext): void | Promise<void>;
+    /**
+     * Runs before the process exits, on host shutdown or disconnect. Release timers, sockets, and
+     * child processes here. `ctx.kv` and `ctx.auth` reject from this hook, so persist state as it changes.
+     */
+    stop?(): void | Promise<void>;
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

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

package/dist/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":""}

package/dist/deno.d.ts

@@ -0,0 +1,4 @@
+import { type ExtensionHost } from './host.js';
+/** The host protocol over `Deno.stdin` and `Deno.stdout`. `defineExtension` uses this transport by default. */
+export declare function denoHost(): ExtensionHost;
+//# sourceMappingURL=deno.d.ts.map

package/dist/deno.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deno.d.ts","sourceRoot":"","sources":["../src/deno.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAQ/D,+GAA+G;AAC/G,wBAAgB,QAAQ,IAAI,aAAa,CAUxC"}

package/dist/deno.js

@@ -0,0 +1,14 @@
+import { ExtensionError } from './host.js';
+/** The host protocol over `Deno.stdin` and `Deno.stdout`. `defineExtension` uses this transport by default. */
+export function denoHost() {
+    const runtime = globalThis.Deno;
+    if (!runtime) {
+        throw new ExtensionError('extensions run under deno; no Deno global in this process', 'no-runtime');
+    }
+    return {
+        readable: runtime.stdin.readable,
+        writable: runtime.stdout.writable,
+        exit: code => runtime.exit(code),
+    };
+}
+//# sourceMappingURL=deno.js.map

package/dist/deno.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deno.js","sourceRoot":"","sources":["../src/deno.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAsB,MAAM,WAAW,CAAC;AAQ/D,+GAA+G;AAC/G,MAAM,UAAU,QAAQ;IACtB,MAAM,OAAO,GAAI,UAAgD,CAAC,IAAI,CAAC;IACvE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,cAAc,CAAC,2DAA2D,EAAE,YAAY,CAAC,CAAC;IACtG,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ;QAChC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;QACjC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/host.d.ts

@@ -0,0 +1,25 @@
+import type { ExtensionMessage } from './protocol.js';
+/**
+ * The transport an extension runs over. The two byte streams carry the newline-delimited host
+ * protocol, and `exit` ends the process. Pass in-memory streams to drive a runtime from a test.
+ */
+export type ExtensionHost = {
+    readable: ReadableStream<Uint8Array>;
+    writable: WritableStream<Uint8Array>;
+    exit(code: number): void;
+};
+/** Every failure this package raises. Branch on `kind`. */
+export declare class ExtensionError extends Error {
+    readonly kind: 'host-error' | 'disconnected' | 'write-failed' | 'no-runtime';
+    constructor(message: string, kind: 'host-error' | 'disconnected' | 'write-failed' | 'no-runtime');
+}
+export declare function readLines(reader: ReadableStreamDefaultReader<Uint8Array>): AsyncGenerator<string>;
+export declare class LineWriter {
+    private readonly writer;
+    private readonly encoder;
+    private tail;
+    constructor(writable: WritableStream<Uint8Array>);
+    write(message: ExtensionMessage): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACrC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,2DAA2D;AAC3D,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY;gBADnF,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY;CAKtF;AAED,wBAAuB,SAAS,CAAC,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAmBxG;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,IAAI,CAAoC;gBAEpC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC;IAIhD,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}

package/dist/host.js

@@ -0,0 +1,57 @@
+/** Every failure this package raises. Branch on `kind`. */
+export class ExtensionError extends Error {
+    kind;
+    constructor(message, kind) {
+        super(message);
+        this.kind = kind;
+        this.name = 'ExtensionError';
+    }
+}
+export async function* readLines(reader) {
+    const decoder = new TextDecoder();
+    let buffered = '';
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffered += decoder.decode(value, { stream: true });
+            for (let cut = buffered.indexOf('\n'); cut >= 0; cut = buffered.indexOf('\n')) {
+                const line = buffered.slice(0, cut);
+                buffered = buffered.slice(cut + 1);
+                if (line.trim().length > 0)
+                    yield line;
+            }
+        }
+        buffered += decoder.decode();
+        if (buffered.trim().length > 0)
+            yield buffered;
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+export class LineWriter {
+    writer;
+    encoder = new TextEncoder();
+    tail = Promise.resolve();
+    constructor(writable) {
+        this.writer = writable.getWriter();
+    }
+    write(message) {
+        const chunk = this.encoder.encode(`${JSON.stringify(message)}\n`);
+        const written = this.tail.then(() => this.writer.write(chunk));
+        this.tail = written.catch(() => undefined);
+        return written;
+    }
+    async close() {
+        await this.tail;
+        try {
+            await this.writer.close();
+        }
+        catch {
+            this.writer.releaseLock();
+        }
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAYA,2DAA2D;AAC3D,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB;IAFlB,YACE,OAAe,EACC,IAAmE;QAEnF,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAA+D;QAGnF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,SAAS,CAAC,MAA+C;IAC9E,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,KAAK,IAAI,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9E,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBACpC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;gBACnC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;oBAAE,MAAM,IAAI,CAAC;YACzC,CAAC;QACH,CAAC;QACD,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAC7B,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,QAAQ,CAAC;IACjD,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,UAAU;IACJ,MAAM,CAA0C;IAChD,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IACrC,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEhD,YAAY,QAAoC;QAC9C,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAyB;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,IAAI,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import type { ExtensionSpec } from './context.js';
+import type { ExtensionHost } from './host.js';
+export type { AuthBridge, ConfigListener, Device, DeviceEvent, DeviceListener, DeviceRef, ExtensionContext, ExtensionLog, ExtensionSpec, KvStore, MessageListener, Unsubscribe, } from './context.js';
+export { denoHost } from './deno.js';
+export { ExtensionError, type ExtensionHost } from './host.js';
+export { asBinary, asJson, asText, binary, json, text, type ForwardMessage, type SendableMessage } from './message.js';
+export { EXTENSION_API_VERSION, type ExtensionMessage, type ExtensionWebapp, type HostMessage, type LogLevel, type WireForwardMessage, } from './protocol.js';
+/**
+ * Runs an extension. Call it once at the top level of the entry module.
+ *
+ * The host protocol owns stdin and stdout, so `console.log` corrupts it. Log with `ctx.log`.
+ *
+ * ```ts
+ * defineExtension({
+ *   start(ctx) {
+ *     ctx.on('message', (device, message) => device.send(asJson(message) ?? 'pong'));
+ *   },
+ * });
+ * ```
+ *
+ * The returned promise settles after `stop()` runs, once the host sends `stop` or closes stdin.
+ * Pass `host` to run the same runtime over streams you own.
+ */
+export declare function defineExtension(spec: ExtensionSpec, host?: ExtensionHost): 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":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,YAAY,EACV,UAAU,EACV,cAAc,EACd,MAAM,EACN,WAAW,EACX,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,OAAO,EACP,eAAe,EACf,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACvH,OAAO,EACL,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,GAAE,aAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpG"}

package/dist/index.js

@@ -0,0 +1,26 @@
+import { denoHost } from './deno.js';
+import { ExtensionRuntime } from './runtime.js';
+export { denoHost } from './deno.js';
+export { ExtensionError } from './host.js';
+export { asBinary, asJson, asText, binary, json, text } from './message.js';
+export { EXTENSION_API_VERSION, } from './protocol.js';
+/**
+ * Runs an extension. Call it once at the top level of the entry module.
+ *
+ * The host protocol owns stdin and stdout, so `console.log` corrupts it. Log with `ctx.log`.
+ *
+ * ```ts
+ * defineExtension({
+ *   start(ctx) {
+ *     ctx.on('message', (device, message) => device.send(asJson(message) ?? 'pong'));
+ *   },
+ * });
+ * ```
+ *
+ * The returned promise settles after `stop()` runs, once the host sends `stop` or closes stdin.
+ * Pass `host` to run the same runtime over streams you own.
+ */
+export function defineExtension(spec, host = denoHost()) {
+    return new ExtensionRuntime(spec, host).run();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAgBhD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAsB,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAA6C,MAAM,cAAc,CAAC;AACvH,OAAO,EACL,qBAAqB,GAMtB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,IAAmB,EAAE,OAAsB,QAAQ,EAAE;IACnF,OAAO,IAAI,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;AAChD,CAAC"}

package/dist/message.d.ts

@@ -0,0 +1,23 @@
+import type { ForwardMessage } from '@bridgething/lib/shared';
+import type { WireForwardMessage } from './protocol.js';
+export type { ForwardMessage };
+/**
+ * Anything `send` and `broadcast` accept. The runtime sends a string as `text` and a `Uint8Array`
+ * as `binary`. Wrap any other value with {@link json}.
+ */
+export type SendableMessage = ForwardMessage | string | Uint8Array;
+/** Builds a `text` forward message. */
+export declare function text(data: string): ForwardMessage;
+/** Builds a `json` forward message from a JSON-serializable value. */
+export declare function json(data: unknown): ForwardMessage;
+/** Builds a `binary` forward message. */
+export declare function binary(data: Uint8Array): ForwardMessage;
+/** The payload if this message is `text`, otherwise `undefined`. */
+export declare function asText(message: ForwardMessage): string | undefined;
+/** The payload if this message is `json`, otherwise `undefined`. `T` is an unchecked cast. */
+export declare function asJson<T = unknown>(message: ForwardMessage): T | undefined;
+/** The payload if this message is `binary`, otherwise `undefined`. */
+export declare function asBinary(message: ForwardMessage): Uint8Array | undefined;
+export declare function intoWire(message: SendableMessage): WireForwardMessage;
+export declare function fromWire(message: WireForwardMessage): ForwardMessage;
+//# sourceMappingURL=message.d.ts.map

package/dist/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnE,uCAAuC;AACvC,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAEjD;AAED,sEAAsE;AACtE,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAElD;AAED,yCAAyC;AACzC,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAEvD;AAED,oEAAoE;AACpE,wBAAgB,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,8FAA8F;AAC9F,wBAAgB,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,CAAC,GAAG,SAAS,CAE1E;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,GAAG,SAAS,CAExE;AAmBD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,kBAAkB,CAKrE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,cAAc,CAGpE"}

package/dist/message.js

@@ -0,0 +1,54 @@
+/** Builds a `text` forward message. */
+export function text(data) {
+    return { encoding: 'text', data };
+}
+/** Builds a `json` forward message from a JSON-serializable value. */
+export function json(data) {
+    return { encoding: 'json', data };
+}
+/** Builds a `binary` forward message. */
+export function binary(data) {
+    return { encoding: 'binary', data };
+}
+/** The payload if this message is `text`, otherwise `undefined`. */
+export function asText(message) {
+    return message.encoding === 'text' ? message.data : undefined;
+}
+/** The payload if this message is `json`, otherwise `undefined`. `T` is an unchecked cast. */
+export function asJson(message) {
+    return message.encoding === 'json' ? message.data : undefined;
+}
+/** The payload if this message is `binary`, otherwise `undefined`. */
+export function asBinary(message) {
+    return message.encoding === 'binary' ? message.data : undefined;
+}
+const CHUNK = 0x8000;
+function toBase64(bytes) {
+    let latin1 = '';
+    for (let i = 0; i < bytes.length; i += CHUNK) {
+        latin1 += String.fromCharCode(...bytes.subarray(i, i + CHUNK));
+    }
+    return btoa(latin1);
+}
+function fromBase64(data) {
+    const latin1 = atob(data);
+    const bytes = new Uint8Array(latin1.length);
+    for (let i = 0; i < latin1.length; i++)
+        bytes[i] = latin1.charCodeAt(i);
+    return bytes;
+}
+export function intoWire(message) {
+    if (typeof message === 'string')
+        return { encoding: 'text', data: message };
+    if (message instanceof Uint8Array)
+        return { encoding: 'binary', data: toBase64(message) };
+    if (message.encoding === 'binary')
+        return { encoding: 'binary', data: toBase64(message.data) };
+    return message;
+}
+export function fromWire(message) {
+    if (message.encoding === 'binary')
+        return { encoding: 'binary', data: fromBase64(message.data) };
+    return message;
+}
+//# sourceMappingURL=message.js.map

package/dist/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAWA,uCAAuC;AACvC,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,IAAI,CAAC,IAAa;IAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,MAAM,CAAC,IAAgB;IACrC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,MAAM,CAAC,OAAuB;IAC5C,OAAO,OAAO,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAChE,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,MAAM,CAAc,OAAuB;IACzD,OAAO,OAAO,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAE,OAAO,CAAC,IAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,OAAuB;IAC9C,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED,MAAM,KAAK,GAAG,MAAM,CAAC;AAErB,SAAS,QAAQ,CAAC,KAAiB;IACjC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAC7C,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAwB;IAC/C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC5E,IAAI,OAAO,YAAY,UAAU;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1F,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/F,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAA2B;IAClD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACjG,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,115 @@
+/** Host protocol revision this package speaks. The host refuses a mismatch. */
+export declare const EXTENSION_API_VERSION = 1;
+/** Severity accepted by `ctx.log`. */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/** Identity of the webapp this extension ships inside, as the host reports it. */
+export type ExtensionWebapp = {
+    id: string;
+    name: string;
+    version: string;
+};
+/**
+ * `ForwardMessage` as it appears on stdio. The transport is JSON lines, so `binary` payloads
+ * are base64.
+ */
+export type WireForwardMessage = {
+    encoding: 'text';
+    data: string;
+} | {
+    encoding: 'json';
+    data: unknown;
+} | {
+    encoding: 'binary';
+    data: string;
+};
+type NoFields = Record<never, never>;
+/** Every `t` the host writes. `HostMessage` derives its arms from this list. */
+export declare const HOST_MESSAGE_TYPES: readonly ["hello", "device.connected", "device.disconnected", "device.active", "device.message", "config.changed", "reply", "stop"];
+export type HostMessageType = (typeof HOST_MESSAGE_TYPES)[number];
+type HostPayloads = {
+    hello: {
+        api: number;
+        webapp: ExtensionWebapp;
+        dataDir: string;
+    };
+    'device.connected': {
+        device: string;
+        name: string;
+        config: Record<string, string>;
+        active: boolean;
+    };
+    'device.disconnected': {
+        device: string;
+    };
+    'device.active': {
+        device: string;
+        active: boolean;
+    };
+    'device.message': {
+        device: string;
+        message: WireForwardMessage;
+    };
+    'config.changed': {
+        device: string;
+        key: string;
+        value: string | null;
+    };
+    reply: {
+        id: string;
+        ok: true;
+        value?: unknown;
+    } | {
+        id: string;
+        ok: false;
+        error: string;
+    };
+    stop: NoFields;
+};
+/** A line the host writes to the extension's stdin. */
+export type HostMessage = {
+    [K in HostMessageType]: {
+        t: K;
+    } & HostPayloads[K];
+}[HostMessageType];
+/** Every `t` the extension writes. `ExtensionMessage` derives its arms from this list. */
+export declare const EXTENSION_MESSAGE_TYPES: readonly ["device.send", "kv.get", "kv.set", "kv.delete", "kv.list", "auth.authorize", "log", "ready"];
+export type ExtensionMessageType = (typeof EXTENSION_MESSAGE_TYPES)[number];
+type ExtensionPayloads = {
+    'device.send': {
+        device?: string;
+        message: WireForwardMessage;
+    };
+    'kv.get': {
+        id: string;
+        key: string;
+    };
+    'kv.set': {
+        id: string;
+        key: string;
+        value: unknown;
+    };
+    'kv.delete': {
+        id: string;
+        key: string;
+    };
+    'kv.list': {
+        id: string;
+    };
+    'auth.authorize': {
+        id: string;
+        url: string;
+    };
+    log: {
+        level: LogLevel;
+        message: string;
+    };
+    ready: NoFields;
+};
+/** A line the extension writes to its stdout. */
+export type ExtensionMessage = {
+    [K in ExtensionMessageType]: {
+        t: K;
+    } & ExtensionPayloads[K];
+}[ExtensionMessageType];
+export {};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,25 @@
+/** Host protocol revision this package speaks. The host refuses a mismatch. */
+export const EXTENSION_API_VERSION = 1;
+/** Every `t` the host writes. `HostMessage` derives its arms from this list. */
+export const HOST_MESSAGE_TYPES = [
+    'hello',
+    'device.connected',
+    'device.disconnected',
+    'device.active',
+    'device.message',
+    'config.changed',
+    'reply',
+    'stop',
+];
+/** Every `t` the extension writes. `ExtensionMessage` derives its arms from this list. */
+export const EXTENSION_MESSAGE_TYPES = [
+    'device.send',
+    'kv.get',
+    'kv.set',
+    'kv.delete',
+    'kv.list',
+    'auth.authorize',
+    'log',
+    'ready',
+];
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAuBvC,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,kBAAkB;IAClB,qBAAqB;IACrB,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,OAAO;IACP,MAAM;CACE,CAAC;AAkBX,0FAA0F;AAC1F,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,aAAa;IACb,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,SAAS;IACT,gBAAgB;IAChB,KAAK;IACL,OAAO;CACC,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,50 @@
+import type { AuthBridge, ConfigListener, Device, DeviceListener, DeviceRef, ExtensionContext, ExtensionLog, ExtensionSpec, KvStore, MessageListener, Unsubscribe } from './context.js';
+import { type ExtensionHost } from './host.js';
+import { type SendableMessage } from './message.js';
+import { type ExtensionWebapp } from './protocol.js';
+export declare class ExtensionRuntime implements ExtensionContext {
+    private readonly spec;
+    private readonly host;
+    private readonly writer;
+    private readonly devices_;
+    private readonly pending;
+    private readonly onDevice;
+    private readonly onMessage;
+    private readonly onConfig;
+    private nextRequestId;
+    private started;
+    private finishing;
+    private settled;
+    private helloApi;
+    private helloWebapp;
+    private helloDataDir;
+    private reader;
+    constructor(spec: ExtensionSpec, host: ExtensionHost);
+    get api(): number;
+    get webapp(): ExtensionWebapp;
+    get dataDir(): string;
+    get devices(): readonly Device[];
+    device(id: string): Device;
+    broadcast(message: SendableMessage): void;
+    config(device: DeviceRef): Readonly<Record<string, string>>;
+    on(event: 'device', listener: DeviceListener): Unsubscribe;
+    on(event: 'message', listener: MessageListener): Unsubscribe;
+    on(event: 'config', listener: ConfigListener): Unsubscribe;
+    readonly kv: KvStore;
+    readonly auth: AuthBridge;
+    readonly log: ExtensionLog;
+    forward(device: string | undefined, message: SendableMessage): void;
+    run(): Promise<void>;
+    private ensure;
+    private parse;
+    private dispatch;
+    private begin;
+    private abortStart;
+    private announce;
+    private guard;
+    private emit;
+    private request;
+    private finish;
+    private shutdown;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,MAAM,EAEN,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,OAAO,EACP,eAAe,EACf,WAAW,EACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACtF,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAGL,KAAK,eAAe,EAGrB,MAAM,eAAe,CAAC;AAiCvB,qBAAa,gBAAiB,YAAW,gBAAgB;IAiBrD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAjBvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,WAAW,CAAsD;IACzE,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,MAAM,CAAsD;gBAGjD,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,aAAa;IAKtC,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,OAAO,IAAI,SAAS,MAAM,EAAE,CAE/B;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAI1B,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIzC,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAK3D,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,GAAG,WAAW;IAC1D,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,WAAW;IAC5D,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,GAAG,WAAW;IAiB1D,QAAQ,CAAC,EAAE,EAAE,OAAO,CAOlB;IAEF,QAAQ,CAAC,IAAI,EAAE,UAAU,CAGvB;IAEF,QAAQ,CAAC,GAAG,EAAE,YAAY,CAQxB;IAEF,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAK7D,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB1B,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,QAAQ;IA6DhB,OAAO,CAAC,KAAK;IAgBb,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,MAAM;YAKA,QAAQ;CAoBvB"}

package/dist/runtime.js

@@ -0,0 +1,291 @@
+import { ExtensionError, LineWriter, readLines } from './host.js';
+import { fromWire, intoWire } from './message.js';
+import { EXTENSION_API_VERSION, } from './protocol.js';
+function describe(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value instanceof Error)
+        return value.stack ?? `${value.name}: ${value.message}`;
+    try {
+        return JSON.stringify(value) ?? String(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+class DeviceImpl {
+    id;
+    runtime;
+    name = '';
+    active = false;
+    connected = false;
+    config = {};
+    constructor(id, runtime) {
+        this.id = id;
+        this.runtime = runtime;
+    }
+    send(message) {
+        this.runtime.forward(this.id, message);
+    }
+}
+export class ExtensionRuntime {
+    spec;
+    host;
+    writer;
+    devices_ = new Map();
+    pending = new Map();
+    onDevice = new Set();
+    onMessage = new Set();
+    onConfig = new Set();
+    nextRequestId = 1;
+    started = false;
+    finishing;
+    settled;
+    helloApi = EXTENSION_API_VERSION;
+    helloWebapp = { id: '', name: '', version: '' };
+    helloDataDir = '';
+    reader;
+    constructor(spec, host) {
+        this.spec = spec;
+        this.host = host;
+        this.writer = new LineWriter(host.writable);
+    }
+    get api() {
+        return this.helloApi;
+    }
+    get webapp() {
+        return this.helloWebapp;
+    }
+    get dataDir() {
+        return this.helloDataDir;
+    }
+    get devices() {
+        return [...this.devices_.values()].filter(device => device.connected);
+    }
+    device(id) {
+        return this.ensure(id);
+    }
+    broadcast(message) {
+        this.forward(undefined, message);
+    }
+    config(device) {
+        const id = typeof device === 'string' ? device : device.id;
+        return this.devices_.get(id)?.config ?? {};
+    }
+    on(event, listener) {
+        if (event === 'device') {
+            const fn = listener;
+            this.onDevice.add(fn);
+            return () => this.onDevice.delete(fn);
+        }
+        if (event === 'message') {
+            const fn = listener;
+            this.onMessage.add(fn);
+            return () => this.onMessage.delete(fn);
+        }
+        const fn = listener;
+        this.onConfig.add(fn);
+        return () => this.onConfig.delete(fn);
+    }
+    kv = {
+        get: (key) => this.request(id => ({ t: 'kv.get', id, key })).then(value => (value === null ? undefined : value)),
+        set: (key, value) => this.request(id => ({ t: 'kv.set', id, key, value })).then(() => undefined),
+        delete: (key) => this.request(id => ({ t: 'kv.delete', id, key })).then(() => undefined),
+        list: () => this.request(id => ({ t: 'kv.list', id })).then(value => (value ?? [])),
+    };
+    auth = {
+        authorize: (url) => this.request(id => ({ t: 'auth.authorize', id, url })).then(value => String(value)),
+    };
+    log = {
+        debug: (...args) => this.log.log('debug', ...args),
+        info: (...args) => this.log.log('info', ...args),
+        warn: (...args) => this.log.log('warn', ...args),
+        error: (...args) => this.log.log('error', ...args),
+        log: (level, ...args) => {
+            this.emit({ t: 'log', level, message: args.map(describe).join(' ') });
+        },
+    };
+    forward(device, message) {
+        const wire = intoWire(message);
+        this.emit(device === undefined ? { t: 'device.send', message: wire } : { t: 'device.send', device, message: wire });
+    }
+    async run() {
+        this.reader = this.host.readable.getReader();
+        try {
+            for await (const line of readLines(this.reader)) {
+                const message = this.parse(line);
+                if (!message)
+                    continue;
+                if (message.t === 'stop') {
+                    await this.finish(0);
+                    return;
+                }
+                this.dispatch(message);
+            }
+        }
+        catch (err) {
+            await this.finish(1, new ExtensionError(`stdin read failed: ${describe(err)}`, 'disconnected'));
+            return;
+        }
+        await this.finish(0);
+    }
+    ensure(id) {
+        const existing = this.devices_.get(id);
+        if (existing)
+            return existing;
+        const fresh = new DeviceImpl(id, this);
+        this.devices_.set(id, fresh);
+        return fresh;
+    }
+    parse(line) {
+        try {
+            return JSON.parse(line);
+        }
+        catch (err) {
+            this.log.error(`unparseable line from host: ${describe(err)}`);
+            return undefined;
+        }
+    }
+    dispatch(message) {
+        switch (message.t) {
+            case 'hello': {
+                this.helloApi = message.api;
+                this.helloWebapp = message.webapp;
+                this.helloDataDir = message.dataDir;
+                this.begin();
+                return;
+            }
+            case 'device.connected': {
+                const device = this.ensure(message.device);
+                device.name = message.name;
+                device.config = { ...message.config };
+                device.active = message.active;
+                device.connected = true;
+                this.announce({ type: 'connected', device });
+                return;
+            }
+            case 'device.disconnected': {
+                const device = this.devices_.get(message.device);
+                if (!device)
+                    return;
+                device.connected = false;
+                device.active = false;
+                this.announce({ type: 'disconnected', device });
+                return;
+            }
+            case 'device.active': {
+                const device = this.ensure(message.device);
+                device.active = message.active;
+                this.announce({ type: 'active', device });
+                return;
+            }
+            case 'device.message': {
+                const device = this.ensure(message.device);
+                const forwarded = this.guard(() => fromWire(message.message));
+                if (!forwarded)
+                    return;
+                for (const listener of [...this.onMessage])
+                    this.guard(() => listener(device, forwarded));
+                return;
+            }
+            case 'config.changed': {
+                const device = this.ensure(message.device);
+                const next = { ...device.config };
+                if (message.value === null)
+                    delete next[message.key];
+                else
+                    next[message.key] = message.value;
+                device.config = next;
+                for (const listener of [...this.onConfig]) {
+                    this.guard(() => listener(device, message.key, message.value));
+                }
+                return;
+            }
+            case 'reply': {
+                const waiting = this.pending.get(message.id);
+                if (!waiting)
+                    return;
+                this.pending.delete(message.id);
+                if (message.ok)
+                    waiting.resolve(message.value);
+                else
+                    waiting.reject(new ExtensionError(message.error, 'host-error'));
+                return;
+            }
+        }
+    }
+    begin() {
+        if (this.started)
+            return;
+        this.started = true;
+        let starting;
+        try {
+            starting = this.spec.start(this);
+        }
+        catch (err) {
+            this.abortStart(err);
+            return;
+        }
+        void Promise.resolve(starting).then(() => this.emit({ t: 'ready' }), (err) => this.abortStart(err));
+    }
+    abortStart(err) {
+        this.log.error(`start failed: ${describe(err)}`);
+        void this.finish(1, new ExtensionError(describe(err), 'host-error'));
+    }
+    announce(event) {
+        for (const listener of [...this.onDevice])
+            this.guard(() => listener(event));
+    }
+    guard(run) {
+        try {
+            return run();
+        }
+        catch (err) {
+            this.log.error(describe(err));
+            return undefined;
+        }
+    }
+    emit(message) {
+        this.writer.write(message).catch((err) => {
+            void this.finish(1, new ExtensionError(`stdout write failed: ${describe(err)}`, 'write-failed'));
+        });
+    }
+    request(build) {
+        if (this.settled) {
+            const advice = 'kv and auth cannot be reached once shutdown has begun, so persist eagerly rather than from stop';
+            return Promise.reject(new ExtensionError(`${this.settled.message}; ${advice}`, this.settled.kind));
+        }
+        const id = String(this.nextRequestId++);
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            this.writer.write(build(id)).catch((err) => {
+                if (!this.pending.delete(id))
+                    return;
+                reject(new ExtensionError(`stdout write failed: ${describe(err)}`, 'write-failed'));
+            });
+        });
+    }
+    finish(code, reason) {
+        this.finishing ??= this.shutdown(code, reason);
+        return this.finishing;
+    }
+    async shutdown(code, reason) {
+        const failure = reason ?? new ExtensionError('the host closed the connection', 'disconnected');
+        this.settled = failure;
+        await this.reader?.cancel().catch(() => undefined);
+        for (const waiting of [...this.pending.values()])
+            waiting.reject(failure);
+        this.pending.clear();
+        try {
+            await this.spec.stop?.();
+        }
+        catch (err) {
+            await this.writer
+                .write({ t: 'log', level: 'error', message: `stop failed: ${describe(err)}` })
+                .catch(() => undefined);
+        }
+        await this.writer.close();
+        this.host.exit(code);
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@bridgething/extension",
+  "version": "0.0.1",
+  "description": "The client a bridgething extension uses to reach Car Things, settings, storage, and the user's browser from its Deno process.",
+  "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/extension-ts"
+  },
+  "bugs": {
+    "url": "https://github.com/JoeyEamigh/bridgething/issues"
+  },
+  "keywords": ["bridgething", "spotify", "car-thing", "superbird", "extension", "deno"],
+  "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"],
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit && deno check --no-config --sloppy-imports --import-map=import_map.json src/index.ts",
+    "test": "bun test",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@bridgething/lib": "0.11.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.0"
+  },
+  "peerDependencies": {
+    "typescript": "^6.0.3"
+  }
+}