@skillcdn/console 0.4.1 → 0.4.3

package/dist/plugin/testing.js

@@ -0,0 +1,420 @@
+import { MAX_PLUGIN_RECORD_BYTES, MAX_PLUGIN_RECORD_VERSIONS, MAX_PLUGIN_RECORDS, PLUGIN_LIST_LIMIT, } from "./limits.js";
+import { PluginRefusal } from "./refusals.js";
+const DEFAULT_CALLER = {
+    kind: "person",
+    person: { id: "person-1", login: "tester", name: "Tester", language: "en", admin: false },
+    agent: null,
+    roles: [],
+    run: null,
+    project: null,
+};
+function forbidden(what, give) {
+    throw new PluginRefusal("plugin.forbidden", `${what}: the test context was given no ${give} to answer it`);
+}
+function scalarOf(value) {
+    return typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean" ||
+        value === null
+        ? value
+        : undefined;
+}
+function compare(a, b) {
+    if (a === b) {
+        return 0;
+    }
+    if (a === undefined || a === null) {
+        return -1;
+    }
+    if (b === undefined || b === null) {
+        return 1;
+    }
+    if (typeof a === "number" && typeof b === "number") {
+        return a - b;
+    }
+    return String(a) < String(b) ? -1 : 1;
+}
+function fieldOf(record, field) {
+    if (field === "owner" || field === "project" || field === "id") {
+        return record[field];
+    }
+    return scalarOf(record.data[field]);
+}
+function matches(record, where) {
+    return Object.entries(where).every(([field, condition]) => {
+        const value = fieldOf(record, field);
+        return conditionHolds(value, condition);
+    });
+}
+function conditionHolds(value, condition) {
+    if (condition === null || typeof condition !== "object") {
+        return value === condition;
+    }
+    if ("in" in condition && Array.isArray(condition.in)) {
+        return condition.in.includes(value);
+    }
+    if ("exists" in condition && typeof condition.exists === "boolean") {
+        return (value !== undefined && value !== null) === condition.exists;
+    }
+    const bounds = condition;
+    if (value === undefined || value === null) {
+        return false;
+    }
+    if (bounds.gte !== undefined && compare(value, bounds.gte) < 0) {
+        return false;
+    }
+    if (bounds.gt !== undefined && compare(value, bounds.gt) <= 0) {
+        return false;
+    }
+    if (bounds.lte !== undefined && compare(value, bounds.lte) > 0) {
+        return false;
+    }
+    if (bounds.lt !== undefined && compare(value, bounds.lt) >= 0) {
+        return false;
+    }
+    return true;
+}
+async function validated(collection, name, data) {
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+        throw new PluginRefusal("plugin.invalid_args", `${name}: a record's data is an object`);
+    }
+    if (JSON.stringify(data).length > MAX_PLUGIN_RECORD_BYTES) {
+        throw new PluginRefusal("plugin.invalid_args", `${name}: a record is ${MAX_PLUGIN_RECORD_BYTES} bytes at most`);
+    }
+    if (collection === undefined) {
+        return data;
+    }
+    const result = await collection.schema["~standard"].validate(data);
+    if (result.issues !== undefined) {
+        const first = result.issues[0];
+        const path = (first?.path ?? [])
+            .map((segment) => (typeof segment === "object" ? String(segment.key) : String(segment)))
+            .join(".");
+        throw new PluginRefusal("plugin.invalid_args", `${name}: ${path.length > 0 ? `${path}: ` : ""}${first?.message ?? "does not fit the schema"}`);
+    }
+    return result.value;
+}
+function memoryRecords(store, name, collection, caller, now) {
+    const kept = () => {
+        let found = store.collections.get(name);
+        if (found === undefined) {
+            found = new Map();
+            store.collections.set(name, found);
+        }
+        return found;
+    };
+    const by = caller.kind === "person" ? caller.person.id : null;
+    const indexed = (field) => {
+        if (collection !== undefined &&
+            !collection.indexes.includes(field) &&
+            !["owner", "project", "id"].includes(field)) {
+            throw new PluginRefusal("plugin.invalid_args", `${name}: ${field} is not an indexed field of the collection`);
+        }
+    };
+    const one = (id) => {
+        const found = kept().get(id);
+        if (found === undefined) {
+            throw new PluginRefusal("plugin.not_found", `${name}: no record ${id}`);
+        }
+        return found;
+    };
+    const page = (records, query) => {
+        const limit = Math.min(Math.max(query.limit ?? PLUGIN_LIST_LIMIT, 1), PLUGIN_LIST_LIMIT);
+        const field = query.order?.field;
+        if (field !== undefined) {
+            indexed(field);
+        }
+        const sorted = [...records].sort((a, b) => {
+            const order = field === undefined ? 0 : compare(fieldOf(a, field), fieldOf(b, field));
+            const signed = query.order?.descending === true ? -order : order;
+            return signed !== 0 ? signed : a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+        });
+        const start = query.after === undefined ? 0 : sorted.findIndex((record) => record.id === query.after) + 1;
+        const items = sorted.slice(start, start + limit);
+        const last = items.at(-1);
+        return { items, after: start + limit < sorted.length && last !== undefined ? last.id : null };
+    };
+    const visible = (query) => [...kept().values()]
+        .map((entry) => entry.record)
+        .filter((record) => (query.archived === true ? true : record.archivedAt === null))
+        .filter((record) => (query.project === undefined ? true : record.project === query.project))
+        .filter((record) => {
+        for (const field of Object.keys(query.where ?? {})) {
+            indexed(field);
+        }
+        return query.where === undefined ? true : matches(record, query.where);
+    });
+    const files = (id) => ({
+        attach: async (handle, options) => {
+            const entry = one(id);
+            const given = typeof handle === "string"
+                ? { handle, name: "file", type: "application/octet-stream", bytes: 0 }
+                : handle;
+            const file = {
+                id: `${entry.record.id}-file-${entry.files.length + 1}`,
+                name: options?.name ?? given.name,
+                type: options?.type ?? given.type,
+                bytes: given.bytes,
+                sha256: "",
+                createdAt: now().toISOString(),
+            };
+            entry.files.push(file);
+            return file;
+        },
+        list: async () => [...one(id).files],
+        remove: async (fileId) => {
+            const entry = one(id);
+            entry.files = entry.files.filter((file) => file.id !== fileId);
+        },
+    });
+    return {
+        async create(data, options) {
+            const records = kept();
+            if (records.size >= MAX_PLUGIN_RECORDS) {
+                throw new PluginRefusal("plugin.too_many", `${name}: ${MAX_PLUGIN_RECORDS} records at most`);
+            }
+            if (collection?.project === "required" && options?.project === undefined) {
+                throw new PluginRefusal("plugin.invalid_args", `${name}: a record of this collection is linked to a project`);
+            }
+            const checked = await validated(collection, name, data);
+            store.counter += 1;
+            const at = now().toISOString();
+            const owner = options?.owner ??
+                (collection?.owner !== null && collection?.owner !== undefined
+                    ? scalarOf(checked[collection.owner])
+                    : null);
+            const record = {
+                id: `${name}-${String(store.counter).padStart(6, "0")}`,
+                collection: name,
+                project: options?.project ?? null,
+                owner: typeof owner === "string" ? owner : null,
+                data: checked,
+                version: 1,
+                createdAt: at,
+                updatedAt: at,
+                createdBy: by,
+                updatedBy: by,
+                archivedAt: null,
+            };
+            records.set(record.id, { record, versions: [], links: [], files: [] });
+            return record;
+        },
+        async get(id) {
+            return kept().get(id)?.record ?? null;
+        },
+        async update(id, patch, options) {
+            const entry = one(id);
+            if (options?.baseVersion !== undefined && options.baseVersion !== entry.record.version) {
+                throw new PluginRefusal("plugin.conflict", `${name}: the record ${id} is at version ${entry.record.version}, not ${options.baseVersion}`);
+            }
+            const checked = await validated(collection, name, { ...entry.record.data, ...patch });
+            if (collection?.history !== false) {
+                entry.versions.push({
+                    version: entry.record.version,
+                    data: entry.record.data,
+                    at: entry.record.updatedAt,
+                    by: entry.record.updatedBy,
+                });
+                if (entry.versions.length > MAX_PLUGIN_RECORD_VERSIONS) {
+                    entry.versions.shift();
+                }
+            }
+            entry.record = {
+                ...entry.record,
+                data: checked,
+                version: entry.record.version + 1,
+                updatedAt: now().toISOString(),
+                updatedBy: by,
+            };
+            return entry.record;
+        },
+        async archive(id) {
+            const entry = one(id);
+            entry.record = { ...entry.record, archivedAt: now().toISOString() };
+        },
+        async restore(id) {
+            const entry = one(id);
+            entry.record = { ...entry.record, archivedAt: null };
+        },
+        async list(query = {}) {
+            return page(visible(query), query);
+        },
+        async search(words, options = {}) {
+            const needles = words
+                .toLowerCase()
+                .split(/\s+/)
+                .filter((word) => word.length > 0);
+            const fields = collection?.search ?? [];
+            const found = visible({ where: options.where, project: options.project }).filter((record) => {
+                const text = (fields.length > 0 ? fields : Object.keys(record.data))
+                    .map((field) => String(record.data[field] ?? ""))
+                    .join(" ")
+                    .toLowerCase();
+                return needles.every((needle) => text.includes(needle));
+            });
+            return page(found, { limit: options.limit });
+        },
+        async aggregate(aggregation) {
+            const groupBy = aggregation.groupBy ?? [];
+            if (groupBy.length > 2) {
+                throw new PluginRefusal("plugin.invalid_args", `${name}: aggregate groups by two fields at most`);
+            }
+            for (const field of groupBy) {
+                indexed(field);
+            }
+            const groups = new Map();
+            for (const record of visible({ where: aggregation.where })) {
+                const group = Object.fromEntries(groupBy.map((field) => [field, fieldOf(record, field) ?? null]));
+                const key = JSON.stringify(group);
+                let row = groups.get(key);
+                if (row === undefined) {
+                    row = { group, count: 0, sum: {}, min: {}, max: {} };
+                    groups.set(key, row);
+                }
+                row.count += 1;
+                for (const field of aggregation.sum ?? []) {
+                    const value = fieldOf(record, field);
+                    row.sum[field] = (row.sum[field] ?? 0) + (typeof value === "number" ? value : 0);
+                }
+                for (const field of aggregation.min ?? []) {
+                    const value = fieldOf(record, field);
+                    if (value !== undefined &&
+                        value !== null &&
+                        (row.min[field] === undefined || compare(value, row.min[field]) < 0)) {
+                        row.min[field] = value;
+                    }
+                }
+                for (const field of aggregation.max ?? []) {
+                    const value = fieldOf(record, field);
+                    if (value !== undefined &&
+                        value !== null &&
+                        (row.max[field] === undefined || compare(value, row.max[field]) > 0)) {
+                        row.max[field] = value;
+                    }
+                }
+            }
+            return [...groups.values()].map((row) => shape(row, aggregation));
+        },
+        async versions(id) {
+            return [...one(id).versions];
+        },
+        async link(id, target) {
+            const entry = one(id);
+            if (!entry.links.some((link) => JSON.stringify(link) === JSON.stringify(target))) {
+                entry.links.push(target);
+            }
+        },
+        async unlink(id, target) {
+            const entry = one(id);
+            entry.links = entry.links.filter((link) => JSON.stringify(link) !== JSON.stringify(target));
+        },
+        async links(id) {
+            return [...one(id).links];
+        },
+        files,
+    };
+}
+function shape(row, aggregation) {
+    return {
+        group: row.group,
+        ...(aggregation.count === true ? { count: row.count } : {}),
+        ...((aggregation.sum ?? []).length > 0 ? { sum: row.sum } : {}),
+        ...((aggregation.min ?? []).length > 0 ? { min: row.min } : {}),
+        ...((aggregation.max ?? []).length > 0 ? { max: row.max } : {}),
+    };
+}
+async function hmacSha256(secret, payload) {
+    const encoder = new TextEncoder();
+    const key = await crypto.subtle.importKey("raw", encoder.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const bytes = typeof payload === "string" ? encoder.encode(payload) : payload;
+    const signature = await crypto.subtle.sign("HMAC", key, bytes);
+    return [...new Uint8Array(signature)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function refusingConsole(given) {
+    const refuse = (group, call) => async () => forbidden(`console.${group}.${call}`, `console.${group}.${call}`);
+    const fill = (group, names, own) => Object.fromEntries(names.map((name) => [name, own?.[name] ?? refuse(group, name)]));
+    return {
+        workspace: given?.workspace ?? (async () => forbidden("console.workspace", "console.workspace")),
+        people: fill("people", ["list", "get"], given?.people),
+        projects: fill("projects", ["list", "get", "members"], given?.projects),
+        tasks: fill("tasks", ["list", "get", "create", "update", "comment"], given?.tasks),
+        decisions: fill("decisions", ["list", "get", "ask"], given?.decisions),
+        documents: fill("documents", ["list", "read", "write"], given?.documents),
+        runs: fill("runs", ["list", "get"], given?.runs),
+    };
+}
+function build(store, options, caller) {
+    const now = options.now ?? (() => new Date());
+    const collections = new Map((options.collections ?? []).map((collection) => [collection.name, collection]));
+    const plugin = {
+        key: "test",
+        version: "0.0.0",
+        dataVersion: 1,
+        settings: {},
+        board: null,
+        projects: "all",
+        ...options.plugin,
+    };
+    const secrets = options.secrets ?? {};
+    const records = ((collection) => {
+        const name = typeof collection === "string" ? collection : collection.name;
+        const definition = typeof collection === "string" ? collections.get(collection) : collection;
+        return memoryRecords(store, name, definition, caller, now);
+    });
+    const log = (level) => (message, fields) => {
+        store.logged.push({ level, message, fields });
+    };
+    return {
+        plugin,
+        caller,
+        records,
+        sql: options.sql ?? {
+            query: async () => forbidden("sql.query", "sql"),
+            transaction: async () => forbidden("sql.transaction", "sql"),
+        },
+        console: refusingConsole(options.console),
+        events: {
+            async emit(kind, data) {
+                store.emitted.push({ kind, data });
+            },
+        },
+        fetch: options.fetch ?? (async () => forbidden("fetch", "fetch")),
+        secrets: {
+            has: async (name) => name in secrets,
+            sign: async (name, payload) => {
+                const secret = secrets[name];
+                if (secret === undefined) {
+                    throw new PluginRefusal("plugin.forbidden", `the secret ${name} is not set`);
+                }
+                return hmacSha256(secret, payload);
+            },
+            verify: async (name, payload, signature) => {
+                const secret = secrets[name];
+                return (secret !== undefined && (await hmacSha256(secret, payload)) === signature.toLowerCase());
+            },
+        },
+        plugins: {
+            async get(key) {
+                const other = options.plugins?.[key];
+                if (other === undefined) {
+                    forbidden(`plugins.get(${key})`, `plugins.${key}`);
+                }
+                return other;
+            },
+        },
+        log: { info: log("info"), warn: log("warn"), error: log("error") },
+        now,
+        language: options.language ?? (caller.kind === "person" ? caller.person.language : "en"),
+        signal: new AbortController().signal,
+        emitted: store.emitted,
+        logged: store.logged,
+        all: (collection) => [...(store.collections.get(collection)?.values() ?? [])].map((entry) => entry.record),
+        as: (other) => build(store, options, other),
+    };
+}
+/** A context for a plugin's tests: records in memory, the console refusing what is not given. */
+export function createTestContext(options = {}) {
+    const store = { collections: new Map(), emitted: [], logged: [], counter: 0 };
+    return build(store, options, options.caller ?? DEFAULT_CALLER);
+}
+//# sourceMappingURL=testing.js.map

package/dist/plugin/testing.js.map

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

package/dist/plugin/web-react.d.ts

@@ -0,0 +1,11 @@
+import { type ConnectOptions, type PluginFrame } from "./web.js";
+/** The one connection of this document, made with `connect()` on first call. */
+export declare function sharedConnection(options?: ConnectOptions): Promise<PluginFrame>;
+export interface UsePlugin {
+    /** The connection once the console answered; `null` before, and when it failed. */
+    readonly frame: PluginFrame | null;
+    readonly error: Error | null;
+}
+/** Connects to the console's page once, and answers the connection when it is there. */
+export declare function usePlugin(options?: ConnectOptions): UsePlugin;
+//# sourceMappingURL=web-react.d.ts.map

package/dist/plugin/web-react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-react.d.ts","sourceRoot":"","sources":["../../src/plugin/web-react.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAAW,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAI1E,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAG/E;AAED,MAAM,WAAW,SAAS;IACxB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAwB7D"}

package/dist/plugin/web-react.js

@@ -0,0 +1,34 @@
+// For a plugin that chooses React: the connection as a hook. One connection per document, made
+// on first use and shared; the component renders nothing of the console's until `frame` is there.
+import { useEffect, useState } from "react";
+import { connect } from "./web.js";
+let shared;
+/** The one connection of this document, made with `connect()` on first call. */
+export function sharedConnection(options) {
+    shared ??= connect(options);
+    return shared;
+}
+/** Connects to the console's page once, and answers the connection when it is there. */
+export function usePlugin(options) {
+    const [state, setState] = useState({ frame: null, error: null });
+    useEffect(() => {
+        let live = true;
+        sharedConnection(options).then((frame) => {
+            if (live) {
+                setState({ frame, error: null });
+            }
+        }, (error) => {
+            if (live) {
+                setState({
+                    frame: null,
+                    error: error instanceof Error ? error : new Error(String(error)),
+                });
+            }
+        });
+        return () => {
+            live = false;
+        };
+    }, [options]);
+    return state;
+}
+//# sourceMappingURL=web-react.js.map

package/dist/plugin/web-react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-react.js","sourceRoot":"","sources":["../../src/plugin/web-react.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,kGAAkG;AAClG,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAuB,OAAO,EAAoB,MAAM,UAAU,CAAC;AAE1E,IAAI,MAAwC,CAAC;AAE7C,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAQD,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAC,OAAwB;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAY,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,gBAAgB,CAAC,OAAO,CAAC,CAAC,IAAI,CAC5B,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,IAAI,EAAE,CAAC;gBACT,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,IAAI,EAAE,CAAC;gBACT,QAAQ,CAAC;oBACP,KAAK,EAAE,IAAI;oBACX,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;iBACjE,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CACF,CAAC;QACF,OAAO,GAAG,EAAE;YACV,IAAI,GAAG,KAAK,CAAC;QACf,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACd,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/plugin/web.d.ts

@@ -0,0 +1,95 @@
+import { type BridgeCommandResult, type BridgeError, type BridgeEventKind, type BridgeFile, type BridgeInit, type BridgeMethod } from "./bridge.js";
+import type { PluginRecord, RecordPage, RecordVersion } from "./context.js";
+/** What the console told the frame: who looks, at what, in which words. */
+export type PluginFrameContext = Omit<BridgeInit, "v" | "t">;
+/** A refusal from the console, with its stable code, as the page relayed it. */
+export declare class PluginBridgeError extends Error {
+    readonly code: string;
+    readonly data: unknown;
+    constructor(error: BridgeError);
+}
+export interface FrameMessageEvent {
+    readonly data: unknown;
+    readonly origin: string;
+    readonly source: unknown;
+}
+/** As much of `window` as the bridge uses; a test hands one of its own. */
+export interface FrameWindow {
+    readonly parent: {
+        postMessage(message: unknown, targetOrigin: string, transfer?: Transferable[]): void;
+    };
+    addEventListener(type: "message", listener: (event: FrameMessageEvent) => void): void;
+    removeEventListener(type: "message", listener: (event: FrameMessageEvent) => void): void;
+}
+/** As much of `document` as the bridge uses. */
+export interface FrameDocument {
+    readonly documentElement: {
+        readonly dataset: Readonly<Record<string, string | undefined>>;
+        readonly style: {
+            setProperty(name: string, value: string): void;
+        };
+        lang: string;
+    };
+    readonly body: {
+        readonly scrollHeight: number;
+    } | null;
+    title: string;
+}
+export interface ConnectOptions {
+    readonly window?: FrameWindow;
+    readonly document?: FrameDocument;
+    /** How long to wait for the console's `init`; ten seconds unless said. */
+    readonly timeoutMs?: number;
+    /** Whether the frame says its height as it changes; on unless said otherwise. */
+    readonly resize?: boolean;
+}
+export interface FrameRecordsQuery {
+    readonly where?: Readonly<Record<string, unknown>>;
+    /** A field of the collection's indexes, `-` before it for descending. */
+    readonly order?: string;
+    readonly limit?: number;
+    readonly after?: string;
+    readonly q?: string;
+    readonly project?: string;
+}
+/** The frame's connection to the console's page. */
+export interface PluginFrame {
+    readonly context: PluginFrameContext;
+    /** A call as the bridge carries one; the typed methods below are the usual way. */
+    call(method: BridgeMethod, params: Readonly<Record<string, unknown>>): Promise<unknown>;
+    command(name: string, args?: Readonly<Record<string, unknown>>): Promise<BridgeCommandResult>;
+    query(name: string, args?: Readonly<Record<string, unknown>>): Promise<unknown>;
+    readonly records: {
+        list<T = Record<string, unknown>>(collection: string, query?: FrameRecordsQuery): Promise<RecordPage<T>>;
+        get<T = Record<string, unknown>>(collection: string, id: string, version?: number): Promise<PluginRecord<T>>;
+        versions<T = Record<string, unknown>>(collection: string, id: string): Promise<readonly RecordVersion<T>[]>;
+    };
+    readonly files: {
+        get(id: string): Promise<BridgeFile>;
+        /** Uploads bytes for a command; answers the handle, good for an hour. */
+        put(bytes: ArrayBuffer | Uint8Array, name: string, type: string): Promise<{
+            readonly handle: string;
+        }>;
+    };
+    /** The console's page follows a path of the console's in place; a URL is refused. */
+    navigate(path: string): void;
+    /** The console's page downloads a file of this plugin. */
+    download(id: string): void;
+    setTitle(text: string): void;
+    /** Something of this plugin changed; subscribes to the kinds named. The function returned stops listening. */
+    onEvent(kinds: readonly BridgeEventKind[], handler: (kind: BridgeEventKind, data: unknown) => void): () => void;
+    /** The console's look changed; the tokens are applied before the handler runs. */
+    onTheme(handler: (theme: Readonly<Record<string, string>>) => void): () => void;
+    /** The console navigated within this page's address. */
+    onPath(handler: (path: string) => void): () => void;
+    /** Stops listening to the console's page. */
+    close(): void;
+}
+/** Sets the console's tokens on the document's root, `--sc-*` and nothing else. */
+export declare function applyTheme(document: FrameDocument, theme: Readonly<Record<string, string>>): void;
+/**
+ * Connects the frame to the console's page: says `ready`, waits for `init`, applies the tokens,
+ * and answers the connection. Call it once, when the bundle starts.
+ */
+export declare function connect(options?: ConnectOptions): Promise<PluginFrame>;
+//# sourceMappingURL=web.d.ts.map

package/dist/plugin/web.d.ts.map

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