@weaveprotocol/core 0.1.0

package/dist/network/signaling.js

@@ -0,0 +1,124 @@
+/**
+ * @fileoverview WebRTC signaling over one WebSocket to a relay.
+ *
+ * One socket serves every room this peer is in: it joins and leaves rooms as
+ * spaces open and close, and joins them all again after a reconnect.
+ */
+import { createEmitter } from '../utils/events.js';
+const SIGNAL_KINDS = new Set(['offer', 'answer', 'candidate']);
+/**
+ * Creates a new signaling client.
+ *
+ * @param url - The relay's WebSocket URL.
+ * @param did - The decentralized identifier of this peer.
+ * @returns The signaling client instance.
+ */
+export function createSignalingClient(url, did) {
+    let ws = null;
+    let connected = false;
+    let retryCount = 0;
+    const maxRetries = 5;
+    const maxBackoffMs = 30000;
+    let reconnectTimer = null;
+    const rooms = new Set();
+    const { on, off, emit } = createEmitter();
+    const sendMessage = (msg) => {
+        if (!ws || ws.readyState !== WebSocket.OPEN)
+            return;
+        ws.send(JSON.stringify({ ...msg, from: did }));
+    };
+    const connect = () => {
+        return new Promise((resolve, reject) => {
+            if (ws && (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING)) {
+                resolve();
+                return;
+            }
+            try {
+                ws = new WebSocket(url);
+            }
+            catch (err) {
+                reject(err);
+                return;
+            }
+            ws.onopen = () => {
+                connected = true;
+                retryCount = 0;
+                emit('connected');
+                for (const room of rooms)
+                    sendMessage({ type: 'join', room });
+                resolve();
+            };
+            ws.onmessage = (event) => {
+                try {
+                    const msg = JSON.parse(event.data);
+                    if (SIGNAL_KINDS.has(msg.type))
+                        emit('signal', msg);
+                    else if (typeof msg.room !== 'string')
+                        return;
+                    else if (msg.type === 'join')
+                        emit('peer-joined', msg.from, msg.room);
+                    else if (msg.type === 'leave')
+                        emit('peer-left', msg.from, msg.room);
+                }
+                catch (err) {
+                    emit('error', err instanceof Error ? err : new Error(String(err)));
+                }
+            };
+            ws.onerror = () => {
+                const error = new Error('WebSocket error occurred');
+                emit('error', error);
+                if (!connected) {
+                    reject(error);
+                }
+            };
+            ws.onclose = () => {
+                connected = false;
+                emit('disconnected');
+                if (retryCount < maxRetries) {
+                    const backoff = Math.min(1000 * Math.pow(2, retryCount), maxBackoffMs);
+                    retryCount++;
+                    if (reconnectTimer) {
+                        clearTimeout(reconnectTimer);
+                    }
+                    reconnectTimer = setTimeout(() => {
+                        connect().catch(() => {
+                            // Ignore promise rejection on reconnect attempt
+                        });
+                    }, backoff);
+                }
+            };
+        });
+    };
+    const disconnect = () => {
+        if (reconnectTimer) {
+            clearTimeout(reconnectTimer);
+            reconnectTimer = null;
+        }
+        retryCount = maxRetries; // Prevent reconnection
+        if (ws) {
+            ws.close();
+            ws = null;
+        }
+        connected = false;
+        rooms.clear();
+    };
+    return Object.freeze({
+        connect,
+        disconnect,
+        join: (room) => {
+            if (rooms.has(room))
+                return;
+            rooms.add(room);
+            sendMessage({ type: 'join', room });
+        },
+        leave: (room) => {
+            if (rooms.delete(room))
+                sendMessage({ type: 'leave', room });
+        },
+        signal: (kind, targetDid, payload) => sendMessage({ type: kind, to: targetDid, payload }),
+        on,
+        off,
+        isConnected: () => connected,
+    });
+}
+//# sourceMappingURL=signaling.js.map

package/dist/network/signaling.js.map

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

package/dist/network/transport.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview What the mesh and network managers need from any way of moving bytes
+ * between peers.
+ *
+ * Two kinds exist. A **signalled** transport (WebRTC) cannot open a connection
+ * on its own: an offer and an answer have to be carried to the other side by
+ * something else — a relay, or a peer already connected to both. An
+ * **unsignalled** one (a WebSocket to an always-on node, an in-memory fake in
+ * tests) just dials. The first kind is the mesh's (`mesh.ts`); the second, a
+ * network manager's (`network-manager.ts`).
+ */
+export type PeerTransportEvents = {
+    data: (peerId: string, data: Uint8Array) => void;
+    connected: (peerId: string) => void;
+    disconnected: (peerId: string) => void;
+    error: (peerId: string, error: Error) => void;
+};
+export interface PeerTransport {
+    /**
+     * Starts dialling, for a transport that reaches out on its own. Called by
+     * the network manager's `connect()`. A signalled transport has nothing to
+     * start — its connections begin with an offer.
+     */
+    readonly connect?: () => Promise<void>;
+    readonly send: (peerId: string, data: Uint8Array) => void;
+    readonly close: (peerId: string) => void;
+    /** Closes every connection. Deliberate: a transport must not reconnect after it. */
+    readonly closeAll: () => void;
+    readonly on: <K extends keyof PeerTransportEvents>(event: K, callback: PeerTransportEvents[K]) => void;
+    readonly off: <K extends keyof PeerTransportEvents>(event: K, callback: PeerTransportEvents[K]) => void;
+    /**
+     * The certificates of one open connection's two ends, for binding the peer
+     * handshake to it (`peer-auth.ts`). Absent where the connection has none.
+     */
+    readonly binding?: (peerId: string) => {
+        readonly local: string;
+        readonly remote: string;
+    } | null;
+}
+/** Receives the ICE candidates a connection discovers, to be carried to the other side. */
+export type CandidateSink = (candidate: RTCIceCandidateInit) => void;
+export interface SignalledTransport extends PeerTransport {
+    /** Opens a connection and returns the offer to carry to the peer. */
+    readonly createOffer: (peerId: string, onCandidate: CandidateSink) => Promise<RTCSessionDescriptionInit>;
+    /** Accepts a peer's offer and returns the answer to carry back. */
+    readonly handleOffer: (peerId: string, offer: RTCSessionDescriptionInit, onCandidate: CandidateSink) => Promise<RTCSessionDescriptionInit>;
+    readonly handleAnswer: (peerId: string, answer: RTCSessionDescriptionInit) => Promise<void>;
+    readonly addIceCandidate: (peerId: string, candidate: RTCIceCandidateInit) => Promise<void>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/network/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/network/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACjD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACvG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACxG;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnG;AAED,2FAA2F;AAC3F,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAErE,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,qEAAqE;IACrE,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACzG,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,EAAE,WAAW,EAAE,aAAa,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC3I,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,yBAAyB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,QAAQ,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7F"}

package/dist/network/transport.js

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview What the mesh and network managers need from any way of moving bytes
+ * between peers.
+ *
+ * Two kinds exist. A **signalled** transport (WebRTC) cannot open a connection
+ * on its own: an offer and an answer have to be carried to the other side by
+ * something else — a relay, or a peer already connected to both. An
+ * **unsignalled** one (a WebSocket to an always-on node, an in-memory fake in
+ * tests) just dials. The first kind is the mesh's (`mesh.ts`); the second, a
+ * network manager's (`network-manager.ts`).
+ */
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/network/transport.js.map

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

package/dist/network/ws-transport.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview A WebSocket to one always-on node, as a transport.
+ *
+ * Browsers cannot accept connections, but they can dial a node that has a DNS
+ * name and a TLS certificate — no relay, no offer and answer, and no TURN for
+ * peers that could not otherwise reach each other. The node appears as a
+ * single peer.
+ *
+ * The wire is deliberately plain — three text frames, then binary:
+ *
+ * 1. node → `{"type":"challenge","nonce":…,"did":…}`
+ * 2. client → `{"type":"hello","did":…,"nonce":…,"sig"?:…}`
+ * 3. node → `{"type":"welcome","did":…,"sig"?:…}`
+ * 4. binary frames either way, passed through untouched.
+ *
+ * With an authenticator both sides sign: the client proves the DID it gives
+ * is its own — and, for a private space, that it may read — and the node that
+ * the welcome comes from the node that sent the challenge (see `peer-auth.ts`).
+ */
+import type { PeerTransport } from './transport.js';
+import { type ClientAuth } from './peer-auth.js';
+export interface WebSocketTransportConfig {
+    /** `wss://node.example.com/peer` */
+    readonly url: string;
+    /** This side's DID, sent in the hello */
+    readonly did: string;
+    /** Redial after an unexpected close. Default true. */
+    readonly reconnect?: boolean;
+    /** Ceiling for the redial backoff. Default 30 s. */
+    readonly maxBackoffMs?: number;
+    /** Proves who this side is (and that it may read a private space), and checks the node's welcome. */
+    readonly authenticator?: ClientAuth | null;
+}
+/**
+ * Creates a transport that holds one socket to one node, redialling it with
+ * backoff for as long as the transport is wanted.
+ *
+ * @param config - Where to dial, and as whom.
+ * @returns The transport; call `connect()` to start.
+ */
+export declare function createWebSocketTransport(config: WebSocketTransportConfig): PeerTransport;
+//# sourceMappingURL=ws-transport.d.ts.map

package/dist/network/ws-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-transport.d.ts","sourceRoot":"","sources":["../../src/network/ws-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAuB,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5D,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,qGAAqG;IACrG,QAAQ,CAAC,aAAa,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5C;AAmBD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,aAAa,CAmKxF"}

package/dist/network/ws-transport.js

@@ -0,0 +1,194 @@
+/**
+ * @fileoverview A WebSocket to one always-on node, as a transport.
+ *
+ * Browsers cannot accept connections, but they can dial a node that has a DNS
+ * name and a TLS certificate — no relay, no offer and answer, and no TURN for
+ * peers that could not otherwise reach each other. The node appears as a
+ * single peer.
+ *
+ * The wire is deliberately plain — three text frames, then binary:
+ *
+ * 1. node → `{"type":"challenge","nonce":…,"did":…}`
+ * 2. client → `{"type":"hello","did":…,"nonce":…,"sig"?:…}`
+ * 3. node → `{"type":"welcome","did":…,"sig"?:…}`
+ * 4. binary frames either way, passed through untouched.
+ *
+ * With an authenticator both sides sign: the client proves the DID it gives
+ * is its own — and, for a private space, that it may read — and the node that
+ * the welcome comes from the node that sent the challenge (see `peer-auth.ts`).
+ */
+import { peerNonce } from './peer-auth.js';
+import { createEmitter } from '../utils/events.js';
+function parseFrame(data, type) {
+    if (typeof data !== 'string')
+        return null;
+    try {
+        const parsed = JSON.parse(data);
+        return parsed?.type === type && typeof parsed.did === 'string' && parsed.did.length > 0 ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Creates a transport that holds one socket to one node, redialling it with
+ * backoff for as long as the transport is wanted.
+ *
+ * @param config - Where to dial, and as whom.
+ * @returns The transport; call `connect()` to start.
+ */
+export function createWebSocketTransport(config) {
+    const reconnect = config.reconnect !== false;
+    const maxBackoffMs = config.maxBackoffMs ?? 30_000;
+    let ws = null;
+    /** The node's DID, once its hello has arrived */
+    let peerId = null;
+    /** Set by close/closeAll: an intentional shutdown must never be fought */
+    let stopped = false;
+    let retryCount = 0;
+    let reconnectTimer = null;
+    const { on, off, emit } = createEmitter();
+    const scheduleRedial = () => {
+        if (stopped || !reconnect || reconnectTimer)
+            return;
+        // Exponential, capped, with jitter so a node restart is not met by every
+        // client at the same instant.
+        const base = Math.min(1000 * 2 ** retryCount, maxBackoffMs);
+        const delay = base / 2 + Math.random() * (base / 2);
+        retryCount += 1;
+        reconnectTimer = setTimeout(() => {
+            reconnectTimer = null;
+            dial().catch(() => {
+                // The close handler schedules the next attempt.
+            });
+        }, delay);
+    };
+    const dial = () => new Promise((resolve, reject) => {
+        if (stopped) {
+            reject(new Error('Transport was closed'));
+            return;
+        }
+        let socket;
+        try {
+            socket = new WebSocket(config.url);
+        }
+        catch (err) {
+            reject(err instanceof Error ? err : new Error(String(err)));
+            scheduleRedial();
+            return;
+        }
+        ws = socket;
+        socket.binaryType = 'arraybuffer';
+        let settled = false;
+        let stage = 'challenge';
+        const ourNonce = peerNonce();
+        const authenticator = config.authenticator ?? null;
+        /** Who sent the challenge: the welcome must come from the same node */
+        let nodeDid = null;
+        const refuse = (reason) => {
+            const error = new Error(reason);
+            emit('error', config.url, error);
+            if (!settled) {
+                settled = true;
+                reject(error);
+            }
+            // Clients may only send 1000 or 3000–4999; 4002 mirrors 1002 "protocol error".
+            socket.close(4002, 'protocol error');
+        };
+        const handle = async (event) => {
+            if (stage === 'challenge') {
+                const challenge = parseFrame(event.data, 'challenge');
+                if (!challenge || typeof challenge.nonce !== 'string')
+                    return refuse('Expected a challenge from the node');
+                nodeDid = challenge.did;
+                const proof = authenticator ? await authenticator.hello(config.did, nodeDid, challenge.nonce) : {};
+                socket.send(JSON.stringify({ type: 'hello', did: config.did, nonce: ourNonce, ...proof }));
+                stage = 'welcome';
+                return;
+            }
+            if (stage === 'welcome') {
+                const welcome = parseFrame(event.data, 'welcome');
+                if (!welcome)
+                    return refuse('Expected a welcome from the node');
+                const did = welcome.did;
+                if (authenticator && (did !== nodeDid || !(await authenticator.checkWelcome(did, ourNonce, welcome.sig)))) {
+                    return refuse('The node could not prove it is the node that answered');
+                }
+                stage = 'open';
+                peerId = did;
+                retryCount = 0;
+                settled = true;
+                emit('connected', peerId);
+                resolve();
+                return;
+            }
+            if (event.data instanceof ArrayBuffer && peerId !== null) {
+                emit('data', peerId, new Uint8Array(event.data));
+            }
+            // Text after the welcome has no meaning in this protocol; ignore it.
+        };
+        // Frames are handled one at a time: the handshake awaits crypto, and a
+        // data frame must not overtake the welcome that opens the connection.
+        let queue = Promise.resolve();
+        socket.onmessage = (event) => {
+            queue = queue
+                .then(() => handle(event))
+                .catch((error) => refuse(error instanceof Error ? error.message : String(error)));
+        };
+        socket.onerror = () => {
+            const error = new Error(`WebSocket error on ${config.url}`);
+            emit('error', peerId ?? config.url, error);
+            if (!settled) {
+                settled = true;
+                reject(error);
+            }
+        };
+        socket.onclose = () => {
+            if (ws === socket)
+                ws = null;
+            const wasConnected = peerId;
+            peerId = null;
+            if (wasConnected)
+                emit('disconnected', wasConnected);
+            if (!settled) {
+                settled = true;
+                reject(new Error(`Connection to ${config.url} closed before the handshake finished`));
+            }
+            scheduleRedial();
+        };
+    });
+    const connect = () => {
+        stopped = false;
+        if (ws && (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING)) {
+            return Promise.resolve();
+        }
+        return dial();
+    };
+    const send = (target, data) => {
+        if (!ws || ws.readyState !== WebSocket.OPEN || target !== peerId) {
+            throw new Error(`Not connected to ${target}`);
+        }
+        ws.send(data);
+    };
+    const closeAll = () => {
+        stopped = true;
+        if (reconnectTimer) {
+            clearTimeout(reconnectTimer);
+            reconnectTimer = null;
+        }
+        ws?.close(1000, 'closed');
+    };
+    return Object.freeze({
+        connect,
+        send,
+        // One socket, one peer: closing the peer closes the transport.
+        close: (target) => {
+            if (target === peerId)
+                closeAll();
+        },
+        closeAll,
+        on,
+        off,
+    });
+}
+//# sourceMappingURL=ws-transport.js.map

package/dist/network/ws-transport.js.map

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

package/dist/node/actions.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @module node/actions
+ * The node's operations, described once so every front end can be generated
+ * from the same list.
+ *
+ * Each action has a name, a sentence saying what it does, a JSON Schema for its
+ * input and a function that runs it. That is exactly what a command line needs
+ * to parse flags, what an MCP server lists as tools, and what WebMCP's
+ * `registerTool` takes — so a CLI, an agent on the desktop and an agent in the
+ * browser all see the same operations with the same names.
+ *
+ * Inputs and outputs are plain JSON. Nothing here may return a key, a handle or
+ * a function.
+ */
+import type { P2PNode } from './types.js';
+/** The subset of JSON Schema these inputs use */
+export interface ActionSchema {
+    readonly type: 'object';
+    readonly properties: Readonly<Record<string, {
+        readonly type?: string;
+        readonly enum?: ReadonlyArray<string>;
+        readonly description?: string;
+        readonly items?: unknown;
+    }>>;
+    readonly required?: ReadonlyArray<string>;
+    readonly additionalProperties?: boolean;
+}
+export interface NodeAction {
+    /** `[a-z_]+`, so it is a valid tool name everywhere */
+    readonly name: string;
+    readonly description: string;
+    readonly input: ActionSchema;
+    /** Reads only. Agents may run these without asking; everything else changes data. */
+    readonly readOnly: boolean;
+    /**
+     * Returns something that grants access — an invite to a private space
+     * carries its key. A front end should confirm with a person before handing
+     * the result to anyone.
+     */
+    readonly sensitive?: boolean;
+    /**
+     * Removes or overwrites something, or brings in someone else's space. A
+     * front end should ask a person before an agent runs it: an agent reads
+     * records other people wrote, and one of them may be telling it what to do.
+     */
+    readonly destructive?: boolean;
+    /**
+     * Returns what other people wrote — record bodies, names, collection
+     * descriptions. Data for an agent to read, never instructions to follow.
+     */
+    readonly peerContent?: boolean;
+    readonly run: (node: P2PNode, input: Record<string, unknown>) => Promise<unknown>;
+}
+export declare const NODE_ACTIONS: ReadonlyArray<NodeAction>;
+/** Why an input does not fit an action's schema, or null when it does. */
+export declare function checkActionInput(action: NodeAction, input: unknown): string | null;
+/**
+ * Runs an action by name, checking its input first.
+ * @throws When the action is unknown or the input does not fit
+ */
+export declare function runAction(node: P2PNode, name: string, input?: unknown): Promise<unknown>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/node/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/node/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAO1C,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAC3B,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAC3I,CAAC;IACF,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnF;AAkBD,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,UAAU,CAodjD,CAAC;AAEH,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAgBlF;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,OAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAMlG"}