@tavora/sdk 0.0.0-stage → 0.2.2

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+What changed in `@tavora/sdk` and the bridge protocol it speaks, newest first. Before Tavora 1.0 the SDK may still change in ways that break modules; each such change raises the minor version (0.2 → 0.3) and is marked **Breaking** here. Anything else raises the patch version. To make sure players have a Tavora that knows what your module uses, set [`minTavora`](https://docs.mytavora.app/reference/manifest) in its manifest.
+
+## 0.2.2
+
+- `MIN_TAVORA`: the oldest Tavora that has everything this SDK version offers, for `minTavora` in your manifest.
+- Panel types: a manifest may list `panels`, named tools such as Inventory and Build planner that players add, dock and copy on their own, all sharing the module's saved content and permissions. `panel.type` says which one a page runs as; the handshake carries it as `panel.type` (Tavora 0.17.12). Set `minTavora` to `0.17.12` or newer when you use them: an older Tavora refuses the `panels` field.
+
+## 0.2.1
+
+- `ui.showMenu(request)`: a menu Tavora draws above every panel, so it is never cut off at the panel's edge. Items with an optional colour dot, check or radio mark, hint and danger style; separators; headings; one level of submenus. Only right after a click, right-click or key press in the panel; resolves with the chosen id or null (Tavora 0.17.9).
+
+## 0.2.0
+
+Needs Tavora 0.17.8 or newer for `minTavora`; everything else works from the Tavora version named next to it.
+
+- `minTavora` in the manifest: the oldest Tavora a module works with. An older Tavora refuses to install or load it and says why (Tavora 0.17.8).
+- `connectors.discord`: the Discord app on the player's PC through Tavora's Discord sign-in: `state()`, `connect()`, `allowControl()`, `command()` for a fixed list of RPC commands, `subscribe()` and `onEvent()` for voice events, and `image()` for avatars and server icons. Needs `"discord"` in `permissions.connectors` and the player's consent (Tavora 0.16.11).
+- `connectors.aiUsage`: the usage of the player's Claude and Codex accounts, without ever seeing a login. Needs `"ai-usage"` in `permissions.connectors` (Tavora 0.16.10).
+- `storage.app`: small settings shared by every game, next to `storage` for the current game (Tavora 0.16.10).
+- `network.fetch`: web requests to the hosts in `permissions.network`, after the player allowed them; HTTPS only, no cookies (Tavora 0.16.8).
+- `clipboard.writeImage(png)`: puts a PNG on the clipboard right after a click or key press in the panel (Tavora 0.14.1).
+- `blobs`: pictures a module keeps for a game, served from the module's own address (Tavora 0.12.0).
+- `links.open(url)`: opens a web address in the game's Browser panel, right after a click or key press (Tavora 0.11.0).
+- `ui.getLanguage()` and `ui.onLanguageChange()`: the language Tavora shows its texts in (Tavora 0.5.9).
+
+## 0.1.0
+
+The first version: `connect()`, the current game, `storage`, `documents` with revisions and change events, panel state, the panel's size, the theme and its changes, and the suspend, resume and dispose lifecycle. Bridge protocol v1.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wellbrained
+
+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

@@ -1,3 +1,68 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @tavora/sdk
+
+Typed client for [Tavora](https://mytavora.app) modules. A module is a web page that runs in a sandboxed panel inside Tavora Desktop; this package is how it talks to the host.
+
+**Status:** bridge protocol v1, still before 1.0: a minor version can change things, and the [changelog](./CHANGELOG.md) says what and which Tavora a version needs.
+
+Start a new module with `npm create @tavora/module` (or `pnpm create @tavora/module`), or add the SDK to your own project with `npm install @tavora/sdk`.
+
+```ts
+import { connect, TavoraError } from "@tavora/sdk";
+
+const tavora = await connect();
+const game = await tavora.game.getCurrent(); // { id: "poe2", displayName: "Path of Exile 2" }
+
+// Small settings, private to this module in this game.
+const count = (await tavora.storage.get<number>("count")) ?? 0;
+await tavora.storage.set("count", count + 1);
+
+// Documents are shared by all panels of this module in this game.
+const plan = await tavora.documents.get<{ steps: string[] }>("plan");
+try {
+  await tavora.documents.put({ id: "plan", title: "Plan", data: { steps: ["Act 1"] }, ifRevision: plan?.revision ?? 0 });
+} catch (error) {
+  if (error instanceof TavoraError && error.code === "CONFLICT") {
+    // Another panel saved first: reload instead of overwriting.
+  }
+}
+tavora.documents.onChange(({ id }) => console.log(`${id} changed in another panel`));
+
+// State for this one panel (open tab, scroll position). Removed when the panel closes.
+await tavora.panel.setState({ tab: "gear" });
+
+tavora.workspace.onResize(({ width, height }) => {});
+tavora.ui.onThemeChange((theme) => {});
+tavora.lifecycle.onSuspend(() => {}); // hidden: pause timers and animations
+tavora.lifecycle.onResume(() => {});
+```
+
+`connect()` can be called any number of times and always returns the same connection. It rejects with a `TavoraError` when the page runs outside Tavora (`HOST_UNAVAILABLE`) or the host speaks another protocol version (`INCOMPATIBLE`).
+
+Every failed call rejects with a `TavoraError`. Check `error.code`, not the message. The codes, limits and the wire format are in the [bridge protocol reference](https://docs.mytavora.app/reference/protocol); the manifest every module needs is in the [manifest reference](https://docs.mytavora.app/reference/manifest).
+
+Values you store must be JSON. Type parameters such as `get<number>()` are not checked at runtime.
+
+## More from the host
+
+| API | What it does |
+| --- | --- |
+| `tavora.storage.app` | The same small settings, shared by every game: for choices the player expects to stay the same from game to game. |
+| `tavora.ui.getLanguage()`, `onLanguageChange` | The language of Tavora's own texts (`"en"`, `"de"`). Show your module in it, or in English when you have no translation. |
+| `tavora.blobs` | Pictures too big for a document: up to 50 MB each and 500 MB per module and game. `put` a file, show it with `url(id)`. See [Files](https://docs.mytavora.app/reference/protocol#files-blobs). |
+| `tavora.clipboard.writeImage(png)` | Puts a PNG on the system clipboard. Call it from the click or key press that asked for it. See [Clipboard](https://docs.mytavora.app/reference/protocol#clipboard). |
+| `tavora.links.open(url)` | Opens a web address in the game's Browser panel, from a click or key press. |
+| `tavora.network.fetch(url, init)` | A web request to a host listed in `permissions.network`, once the player granted it. See [Network](https://docs.mytavora.app/reference/protocol#network). |
+| `tavora.connectors.aiUsage` | The usage of the player's Claude and Codex accounts, with the `ai-usage` connector. |
+| `tavora.connectors.discord` | The Discord app on this PC through Tavora's Discord sign-in, with the `discord` connector: voice channels, mute and deafen, voice events. |
+
+What needs the player's permission (`permissions.network` and `permissions.connectors` in the [manifest](https://docs.mytavora.app/reference/manifest)) works only once the player has granted it: they are asked when they add the module and can take it back in Settings > Integrations. Until then the call fails with `PERMISSION_DENIED`; `tavora.host.capabilities` lists what was granted when the module connected. See [Capabilities](https://docs.mytavora.app/reference/protocol#capabilities) and [Connectors](https://docs.mytavora.app/reference/protocol#connectors).
+
+## Examples
+
+The same small module built three ways: [vanilla TypeScript](https://github.com/wellbrained/tavora/tree/main/examples/vanilla-module), [React](https://github.com/wellbrained/tavora/tree/main/examples/react-module) and [Vue](https://github.com/wellbrained/tavora/tree/main/examples/vue-module).
+
+## Building a module
+
+- Bundle everything. A module's page has no network access, so no CDN scripts, web fonts or remote images. To reach a web API, list its host in `permissions.network` and use `tavora.network.fetch` once the player has granted it.
+- Use relative asset paths (Vite: `base: "./"`). The page is served from `tavora-module://<module-id>/`.
+- Point the manifest's `entry` at the built HTML file.

package/dist/index.d.ts

@@ -0,0 +1,173 @@
+import { type AiUsageAccountInfo, type AiUsageReading, type BlobInfo, type BlobUsage, type Capability, type DiscordCommand, type DiscordCommands, type DiscordEvent, type DiscordEventName, type DiscordResult, type DiscordState, type DocumentChange, type DocumentSummary, type ErrorCode, type ErrorPayload, type HandshakeResult, type JsonValue, type MenuRequest, type NetworkRequest, type NetworkResponse, type PutDocumentParams, type TavoraDocument, type TavoraGame, type TavoraTheme, type TavoraViewport } from "./protocol.js";
+export type { AiUsageAccountInfo, AiUsageReading, BlobInfo, BlobType, BlobUsage, Capability, DiscordCommand, DiscordCommands, DiscordEvent, DiscordEventName, DiscordResult, DiscordState, DocumentChange, DocumentSummary, ErrorCode, HandshakeResult, JsonValue, MenuEntry, MenuRequest, NetworkRequest, NetworkResponse, PutDocumentParams, TavoraDocument, TavoraGame, TavoraTheme, TavoraViewport, ThemeToken, } from "./protocol.js";
+export { BLOB_ID, BLOB_TYPES, DISCORD_COMMANDS, DISCORD_EVENTS, LIMITS, PROTOCOL_VERSION, THEME_TOKENS } from "./protocol.js";
+/** Version of this SDK package, sent to the host during the handshake. */
+export declare const SDK_VERSION = "0.2.2";
+/**
+ * The oldest Tavora that has everything this SDK version offers. Put it in your manifest as
+ * `minTavora`, so an older Tavora says it needs an update instead of loading a module it cannot run
+ * (the starter, `npm create @tavora/module`, does). The changelog names it for every version.
+ */
+export declare const MIN_TAVORA = "0.17.12";
+export declare class TavoraError extends Error {
+    readonly code: ErrorCode;
+    /** Set for PERMISSION_DENIED. */
+    readonly capability: Capability | undefined;
+    /** Set for CONFLICT: the document's current revision. */
+    readonly revision: number | undefined;
+    constructor(payload: ErrorPayload);
+}
+type Unsubscribe = () => void;
+/** Small key/value settings: at most 5 MB of keys and values together, values plain JSON. */
+export interface KeyValueStore {
+    /** T is not checked at runtime; the host only guarantees the value is JSON. */
+    get<T = JsonValue>(key: string): Promise<T | null>;
+    set(key: string, value: JsonValue): Promise<void>;
+    delete(key: string): Promise<void>;
+    keys(): Promise<string[]>;
+}
+export interface TavoraSDK {
+    /** What the host reported when this module connected. */
+    readonly host: HandshakeResult;
+    game: {
+        getCurrent(): Promise<TavoraGame>;
+    };
+    /** Small key/value settings, private to this module in the current game. */
+    storage: KeyValueStore & {
+        /** The same, shared by every game: settings that should not change from game to game. */
+        app: KeyValueStore;
+    };
+    /**
+     * Named documents (builds, plans, checklists), private to this module in
+     * the current game and shared by all of its panels.
+     */
+    documents: {
+        list(): Promise<DocumentSummary[]>;
+        get<T = JsonValue>(id: string): Promise<(TavoraDocument & {
+            data: T;
+        }) | null>;
+        /** Creates or replaces a document. Pass ifRevision to avoid overwriting another panel's change. */
+        put(document: PutDocumentParams): Promise<DocumentSummary>;
+        delete(id: string, options?: {
+            ifRevision?: number;
+        }): Promise<void>;
+        /** Fires when another panel of this module changes a document. */
+        onChange(fn: (change: DocumentChange) => void): Unsubscribe;
+    };
+    /** UI state for this one panel (selection, scroll, open tab). Cleared when the panel is closed. */
+    panel: {
+        /** Which of the manifest's `panels` this panel is, by id; null for a module without panel types (or an older Tavora). */
+        readonly type: string | null;
+        getState<T = JsonValue>(): Promise<T | null>;
+        setState(value: JsonValue | null): Promise<void>;
+    };
+    workspace: {
+        getViewport(): Promise<TavoraViewport>;
+        onResize(fn: (viewport: TavoraViewport) => void): Unsubscribe;
+    };
+    ui: {
+        getTheme(): Promise<TavoraTheme>;
+        onThemeChange(fn: (theme: TavoraTheme) => void): Unsubscribe;
+        /** The language Tavora shows its own texts in, as a code such as "en" or "de". Show yours in it, or in English when you have no translation. */
+        getLanguage(): Promise<string>;
+        /** Fires when the player changes the language. */
+        onLanguageChange(fn: (language: string) => void): Unsubscribe;
+        /**
+         * Shows a menu that Tavora draws above every panel, so it is never cut off at the panel's edge. Call it from
+         * the click, right-click or key press that asked for it: the host refuses it otherwise (PERMISSION_DENIED).
+         * Resolves with the chosen item's id, or null when the player closed the menu without choosing.
+         */
+        showMenu(request: MenuRequest): Promise<string | null>;
+    };
+    /**
+     * Files (pictures) this module keeps in the current game, shared by all of its panels. They live
+     * in a folder Tavora manages, not in a document, so they can be large: up to 50 MB each and
+     * 500 MB together. Only PNG, JPEG, GIF and WebP are accepted, judged by the file itself.
+     */
+    blobs: {
+        /** Stores a file and returns its id. Rejects with QUOTA_EXCEEDED, or INVALID_PARAMS for another kind of file. */
+        put(file: Blob): Promise<BlobInfo>;
+        /** The address to show a stored file from, for example as an image source. */
+        url(id: string): string;
+        list(): Promise<BlobInfo[]>;
+        usage(): Promise<BlobUsage>;
+        /** Deletes a file; nothing happens when it does not exist. */
+        delete(id: string): Promise<void>;
+    };
+    clipboard: {
+        /**
+         * Puts a picture on the system clipboard, so the player can paste it anywhere. Call it from the click or key
+         * press that asked for it: the host refuses it otherwise (PERMISSION_DENIED), and one press copies one
+         * picture. PNG only, a complete one, at most 20 MB and 16384 pixels on a side (INVALID_PARAMS, QUOTA_EXCEEDED).
+         */
+        writeImage(png: Blob): Promise<void>;
+    };
+    links: {
+        /**
+         * Opens a web address (http or https) in a Browser panel of this game, as a new tab or in a new
+         * panel. Call it from the click or key press that asked for it: the host refuses it otherwise
+         * (PERMISSION_DENIED). The module learns nothing about the page.
+         */
+        open(url: string): Promise<void>;
+    };
+    network: {
+        /**
+         * Makes a web request through Tavora, to a host listed in `permissions.network` that the player
+         * granted (PERMISSION_DENIED otherwise). HTTPS only, no cookies, at most 5 MB back and 15 seconds.
+         * Error statuses such as 404 are answers, not errors; NETWORK_ERROR means no answer came.
+         */
+        fetch(url: string, init?: Omit<NetworkRequest, "url">): Promise<NetworkResponse>;
+    };
+    /** Parts of Tavora that hold a sign-in, used without seeing it. Each needs its connector in `permissions.connectors` and the player's grant (PERMISSION_DENIED otherwise). */
+    connectors: {
+        /** `ai-usage`: the usage of the Claude and Codex accounts the player set up in Settings > Integrations > AI usage. */
+        aiUsage: {
+            accounts(): Promise<AiUsageAccountInfo[]>;
+            /** Reads one account. Tavora reads each account at most once a minute; asking sooner gives the last reading. */
+            read(accountId: string): Promise<AiUsageReading>;
+            /** Fires when the player adds, renames or removes an account. */
+            onAccountsChange(fn: () => void): Unsubscribe;
+        };
+        /**
+         * `discord`: the Discord app on this PC, through Tavora's Discord sign-in. The connection runs while a
+         * panel has asked for state(); Tavora keeps the sign-in and sends only the commands in DISCORD_COMMANDS.
+         */
+        discord: {
+            /** The connection now. The first call starts it for this panel. */
+            state(): Promise<DiscordState>;
+            onStateChange(fn: (state: DiscordState) => void): Unsubscribe;
+            /** Signs in, asking for approval in Discord the first time. Call it from a click or key press handler. */
+            connect(): Promise<void>;
+            /** Asks Discord to approve muting and deafening, for a sign-in that can't yet (canControl false). From a click or key press. */
+            allowControl(): Promise<void>;
+            /** Sends one command; resolves with Discord's answer as it came, or why there is none. SELECT_VOICE_CHANNEL and SET_VOICE_SETTINGS only from a click or key press. */
+            command<C extends DiscordCommand>(command: C, args: DiscordCommands[C]): Promise<DiscordResult>;
+            /** Starts sending an event to this panel (VOICE_CHANNEL_SELECT without a channel, the others for one voice channel). Kept across reconnects. */
+            subscribe(event: DiscordEventName, channelId?: string): Promise<void>;
+            unsubscribe(event: DiscordEventName, channelId?: string): Promise<void>;
+            onEvent(fn: (event: DiscordEvent) => void): Unsubscribe;
+            /** A picture from cdn.discordapp.com (an avatar or server icon address) as a small PNG data address, or null. */
+            image(url: string): Promise<string | null>;
+        };
+    };
+    lifecycle: {
+        /** The panel is hidden; pause timers and animations. Called immediately if already suspended. */
+        onSuspend(fn: () => void): Unsubscribe;
+        onResume(fn: () => void): Unsubscribe;
+        /** Best effort only: autosave must not depend on this firing. */
+        onDispose(fn: () => void): Unsubscribe;
+    };
+}
+export interface ConnectOptions {
+    /** How long to wait for the host to hand over a port. Default 5000 ms. */
+    connectTimeoutMs?: number;
+    /** How long to wait for each request. Default 10000 ms. */
+    requestTimeoutMs?: number;
+}
+/**
+ * Connects to the Tavora host. Safe to call more than once: every call
+ * returns the same connection for this window. Rejects with a TavoraError
+ * (HOST_UNAVAILABLE, INCOMPATIBLE) if the module cannot run here.
+ */
+export declare function connect(options?: ConnectOptions): Promise<TavoraSDK>;
+//# 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,267 @@
+// @tavora/sdk: thin typed client for modules running inside Tavora Desktop.
+// The host enforces every check; this package only marshals typed calls.
+// Protocol reference: apps/docs/reference/protocol.md.
+import { BLOB_PATH, CLIPBOARD_PATH, HELLO_MESSAGE, LIMITS, PORT_MESSAGE, PROTOCOL_VERSION, } from "./protocol.js";
+export { BLOB_ID, BLOB_TYPES, DISCORD_COMMANDS, DISCORD_EVENTS, LIMITS, PROTOCOL_VERSION, THEME_TOKENS } from "./protocol.js";
+/** How long a menu may stay open; the host closes it itself when its panel goes. */
+const MENU_TIMEOUT_MS = 60 * 60_000;
+/** Version of this SDK package, sent to the host during the handshake. */
+export const SDK_VERSION = "0.2.2";
+/**
+ * The oldest Tavora that has everything this SDK version offers. Put it in your manifest as
+ * `minTavora`, so an older Tavora says it needs an update instead of loading a module it cannot run
+ * (the starter, `npm create @tavora/module`, does). The changelog names it for every version.
+ */
+export const MIN_TAVORA = "0.17.12";
+export class TavoraError extends Error {
+    code;
+    /** Set for PERMISSION_DENIED. */
+    capability;
+    /** Set for CONFLICT: the document's current revision. */
+    revision;
+    constructor(payload) {
+        super(payload.message);
+        this.name = "TavoraError";
+        this.code = payload.code;
+        this.capability = payload.capability;
+        this.revision = payload.revision;
+    }
+}
+let connection;
+/**
+ * Connects to the Tavora host. Safe to call more than once: every call
+ * returns the same connection for this window. Rejects with a TavoraError
+ * (HOST_UNAVAILABLE, INCOMPATIBLE) if the module cannot run here.
+ */
+export function connect(options = {}) {
+    connection ??= openPort(options.connectTimeoutMs ?? 5000)
+        .then((port) => createClient(port, options.requestTimeoutMs ?? 10_000))
+        .catch((error) => {
+        connection = undefined;
+        throw error;
+    });
+    return connection;
+}
+function openPort(timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            window.removeEventListener("message", onMessage);
+            reject(new TavoraError({
+                code: "HOST_UNAVAILABLE",
+                message: "Tavora host did not respond. Is this module running inside Tavora?",
+            }));
+        }, timeoutMs);
+        function onMessage(event) {
+            if (event.source !== window || event.data?.type !== PORT_MESSAGE || !event.ports[0])
+                return;
+            clearTimeout(timer);
+            window.removeEventListener("message", onMessage);
+            resolve(event.ports[0]);
+        }
+        window.addEventListener("message", onMessage);
+        window.postMessage({ type: HELLO_MESSAGE, v: PROTOCOL_VERSION }, window.location.origin);
+    });
+}
+async function createClient(port, requestTimeoutMs) {
+    let nextId = 1;
+    const pending = new Map();
+    const listeners = new Map();
+    let suspended = false;
+    port.onmessage = (event) => {
+        const message = event.data;
+        if (typeof message !== "object" || message === null || message.v !== PROTOCOL_VERSION)
+            return;
+        if ("event" in message) {
+            if (message.event === "lifecycle.suspend")
+                suspended = true;
+            if (message.event === "lifecycle.resume")
+                suspended = false;
+            for (const fn of listeners.get(message.event) ?? []) {
+                try {
+                    fn(message.data);
+                }
+                catch (error) {
+                    console.error(`[tavora] ${message.event} listener failed`, error);
+                }
+            }
+            return;
+        }
+        const entry = pending.get(message.id);
+        if (!entry)
+            return;
+        pending.delete(message.id);
+        clearTimeout(entry.timer);
+        if (message.ok)
+            entry.resolve(message.result);
+        else
+            entry.reject(new TavoraError(message.error));
+    };
+    port.start();
+    function call(method, params, timeoutMs = requestTimeoutMs) {
+        const id = nextId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                pending.delete(id);
+                reject(new TavoraError({ code: "TIMEOUT", message: `${method} timed out` }));
+            }, Math.max(timeoutMs, requestTimeoutMs));
+            pending.set(id, { resolve: resolve, reject, timer });
+            port.postMessage({ v: PROTOCOL_VERSION, id, method, params });
+        });
+    }
+    function on(event, fn) {
+        let set = listeners.get(event);
+        if (!set)
+            listeners.set(event, (set = new Set()));
+        const listener = fn;
+        set.add(listener);
+        // Initial suspension can arrive before connect() callers register listeners.
+        if (event === "lifecycle.suspend" && suspended) {
+            try {
+                listener(null);
+            }
+            catch (error) {
+                console.error(`[tavora] ${event} listener failed`, error);
+            }
+        }
+        return () => set.delete(listener);
+    }
+    const host = await call("bridge.handshake", { protocol: PROTOCOL_VERSION, sdkVersion: SDK_VERSION });
+    return {
+        host,
+        game: {
+            getCurrent: () => call("game.getCurrent"),
+        },
+        storage: {
+            get: (key) => call("storage.get", { key }),
+            set: async (key, value) => {
+                await call("storage.set", { key, value });
+            },
+            delete: async (key) => {
+                await call("storage.delete", { key });
+            },
+            keys: () => call("storage.keys"),
+            app: {
+                get: (key) => call("storage.app.get", { key }),
+                set: async (key, value) => {
+                    await call("storage.app.set", { key, value });
+                },
+                delete: async (key) => {
+                    await call("storage.app.delete", { key });
+                },
+                keys: () => call("storage.app.keys"),
+            },
+        },
+        documents: {
+            list: () => call("documents.list"),
+            get: (id) => call("documents.get", { id }),
+            put: (document) => call("documents.put", document),
+            delete: async (id, options = {}) => {
+                await call("documents.delete", { id, ...options });
+            },
+            onChange: (fn) => on("documents.changed", fn),
+        },
+        panel: {
+            type: host.panel?.type ?? null,
+            getState: () => call("panel.getState"),
+            setState: async (value) => {
+                await call("panel.setState", { value });
+            },
+        },
+        workspace: {
+            getViewport: () => call("workspace.getViewport"),
+            onResize: (fn) => on("workspace.resize", fn),
+        },
+        ui: {
+            getTheme: () => call("ui.getTheme"),
+            onThemeChange: (fn) => on("ui.theme", fn),
+            getLanguage: () => call("ui.getLanguage"),
+            onLanguageChange: (fn) => on("ui.language", fn),
+            // The player may take their time choosing.
+            showMenu: (request) => call("ui.showMenu", request, MENU_TIMEOUT_MS),
+        },
+        blobs: {
+            put: async (file) => {
+                let response;
+                try {
+                    response = await fetch(new URL(BLOB_PATH, window.location.href), {
+                        method: "POST",
+                        body: file,
+                        headers: { "Content-Type": file.type || "application/octet-stream" },
+                    });
+                }
+                catch {
+                    throw new TavoraError({ code: "INTERNAL", message: "could not store the file" });
+                }
+                const body = (await response.json().catch(() => null));
+                if (!response.ok || !body || body.error) {
+                    throw new TavoraError(body?.error ?? { code: "INTERNAL", message: `could not store the file (${response.status})` });
+                }
+                return body;
+            },
+            url: (id) => new URL(`${BLOB_PATH}${encodeURIComponent(id)}`, window.location.href).href,
+            list: () => call("blobs.list"),
+            usage: () => call("blobs.usage"),
+            delete: async (id) => {
+                await call("blobs.delete", { id });
+            },
+        },
+        clipboard: {
+            writeImage: async (png) => {
+                if (png.type !== "image/png")
+                    throw new TavoraError({ code: "INVALID_PARAMS", message: "only a PNG picture can be copied" });
+                let response;
+                try {
+                    response = await fetch(new URL(CLIPBOARD_PATH, window.location.href), { method: "POST", body: png, headers: { "Content-Type": "image/png" } });
+                }
+                catch {
+                    throw new TavoraError({ code: "INTERNAL", message: "could not copy the picture" });
+                }
+                if (response.ok)
+                    return;
+                const body = (await response.json().catch(() => null));
+                throw new TavoraError(body?.error ?? { code: "INTERNAL", message: `could not copy the picture (${response.status})` });
+            },
+        },
+        links: {
+            open: async (url) => {
+                await call("links.open", { url });
+            },
+        },
+        network: {
+            // The host gives up after its own limit; this waits a little longer so its answer arrives first.
+            fetch: (url, init = {}) => call("network.fetch", { ...init, url }, LIMITS.networkTimeoutMs + 5000),
+        },
+        connectors: {
+            aiUsage: {
+                accounts: () => call("aiUsage.accounts"),
+                read: (accountId) => call("aiUsage.read", { accountId }, LIMITS.aiUsageTimeoutMs + 5000),
+                onAccountsChange: (fn) => on("aiUsage.accountsChanged", () => fn()),
+            },
+            discord: {
+                state: () => call("discord.state"),
+                onStateChange: (fn) => on("discord.state", fn),
+                connect: async () => {
+                    await call("discord.connect");
+                },
+                allowControl: async () => {
+                    await call("discord.allowControl");
+                },
+                command: (command, args) => call("discord.command", { command, args }, LIMITS.discordTimeoutMs + 5000),
+                subscribe: async (event, channelId) => {
+                    await call("discord.subscribe", channelId === undefined ? { event } : { event, channelId });
+                },
+                unsubscribe: async (event, channelId) => {
+                    await call("discord.unsubscribe", channelId === undefined ? { event } : { event, channelId });
+                },
+                onEvent: (fn) => on("discord.event", fn),
+                image: (url) => call("discord.image", { url }),
+            },
+        },
+        lifecycle: {
+            onSuspend: (fn) => on("lifecycle.suspend", fn),
+            onResume: (fn) => on("lifecycle.resume", fn),
+            onDispose: (fn) => on("lifecycle.dispose", fn),
+        },
+    };
+}
+//# 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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"}