@weaveprotocol/core 0.1.0

package/dist/node/carrier.js

@@ -0,0 +1,192 @@
+import { createP256Provider } from '../identity/crypto-p256.js';
+import { publicKeyToDid, P256_MULTICODEC } from '../identity/did.js';
+import { createSigner } from '../schema/signer.js';
+import { createSchemaEngine } from '../schema/schema-engine.js';
+import { createSpaceManager, parseSpaceInvite } from '../space/space-manager.js';
+import { carriedRecord, CARRY_CLOSED_KEY, openPass, PASS_COLLECTION } from '../space/pass.js';
+import { createLocalHub } from '../network/local-transport.js';
+import { meshFor, openSpaceRuntime } from './space-runtime.js';
+/**
+ * Starts a carrier.
+ * @throws When the carry invite is not a readable invite to a private space
+ */
+export async function createCarrierNode(config) {
+    const provider = config.provider ?? createP256Provider();
+    const signer = createSigner(provider);
+    const schemas = createSchemaEngine();
+    const did = publicKeyToDid(await provider.exportPublicKey(config.key.publicKey), P256_MULTICODEC);
+    // It never writes, so it never needs a note; the session only names it on the wire.
+    const session = { did, key: config.key.privateKey, proof: () => '' };
+    // The pod copy is a peer of its own on the local link, so it needs a name of its own.
+    const podKeys = await provider.generateKeyPair();
+    const podDid = publicKeyToDid(await provider.exportPublicKey(podKeys.publicKey), P256_MULTICODEC);
+    const podSession = { did: podDid, key: podKeys.privateKey, proof: () => '' };
+    const listeners = new Set();
+    const emit = (event) => {
+        for (const listener of listeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error('Error in carrier listener:', error);
+            }
+        }
+    };
+    // The carry space is joined like any space: it is the one key the carrier holds.
+    const registryStore = await config.stores('registry');
+    const registry = createSpaceManager(registryStore, provider);
+    const carrySpace = parseSpaceInvite(config.carry).space.id;
+    const carryRecord = (await registry.get(carrySpace)) ?? (await registry.join(config.carry));
+    if (carryRecord.space.visibility !== 'private' || !carryRecord.key)
+        throw new Error('That is not an invite to a carry space.');
+    let closed = false;
+    let podStores = null;
+    const carried = new Map();
+    const mesh = meshFor(config.network, did);
+    const open = (record, stores, as, network, onEvent) => openSpaceRuntime({
+        // The carrier's own spaces meet through relays; its copy in the pod only over the local link.
+        ...(as === session && mesh ? { mesh } : {}),
+        record,
+        stores,
+        provider,
+        signer,
+        schemas,
+        session: as,
+        rootDid: as.did,
+        network,
+        watchIntervalMs: config.watchIntervalMs ?? 2000,
+        emit: onEvent,
+    });
+    function openPod(record, hub, stores) {
+        const opening = open(record, stores, podSession, { transports: () => [hub.transport(podDid)] }, () => { });
+        opening.catch(() => {
+            // A folder that went away, or lost its permission; the carrier's own copy goes on.
+            const held = carried.get(record.space.id);
+            if (held?.pod === opening)
+                held.pod = null;
+            emit({ type: 'status', space: record.space.id });
+        });
+        return opening;
+    }
+    async function carry(record) {
+        const spaceId = record.space.id;
+        if (carried.has(spaceId) || closed)
+            return;
+        const hub = createLocalHub();
+        const network = {
+            ...config.network,
+            transports: (space, sessionDid) => [...(config.network?.transports?.(space, sessionDid) ?? []), hub.transport(did)],
+        };
+        const runtime = await open(record, config.stores, session, network, (event) => {
+            if (event.type === 'records' || event.type === 'status')
+                emit({ type: 'status', space: spaceId });
+            if (event.type === 'records' && spaceId === carrySpace)
+                void refresh();
+        });
+        if (closed)
+            return void (await runtime.close());
+        const entry = { record, hub, runtime, pod: null };
+        carried.set(spaceId, entry);
+        if (podStores)
+            entry.pod = openPod(record, hub, podStores);
+    }
+    async function drop(spaceId) {
+        const entry = carried.get(spaceId);
+        if (!entry)
+            return;
+        carried.delete(spaceId);
+        await (await entry.pod?.catch(() => null))?.close();
+        await entry.runtime.close();
+    }
+    /** Carries what the passes say, and nothing else. */
+    let refreshing = Promise.resolve();
+    function refresh() {
+        refreshing = refreshing.then(refreshOnce).catch((error) => {
+            if (!closed)
+                console.error('Could not read the carry space:', error);
+        });
+        return refreshing;
+    }
+    async function refreshOnce() {
+        const carryRuntime = carried.get(carrySpace)?.runtime;
+        if (!carryRuntime || closed)
+            return;
+        const records = (await carryRuntime.list({ collection: PASS_COLLECTION })).filter((record) => record.verified && record.root === config.account);
+        if (records.some((record) => record.key === CARRY_CLOSED_KEY)) {
+            emit({ type: 'closed' });
+            return;
+        }
+        const wanted = new Map();
+        for (const record of records) {
+            if (!record.key.startsWith('pass:'))
+                continue;
+            const pass = await openPass(record.body, provider);
+            if (pass && pass.space.id !== carrySpace)
+                wanted.set(pass.space.id, carriedRecord(pass));
+        }
+        let changed = false;
+        for (const [spaceId, record] of wanted) {
+            if (carried.has(spaceId))
+                continue;
+            await carry(record);
+            changed = true;
+        }
+        for (const spaceId of [...carried.keys()]) {
+            if (spaceId === carrySpace || wanted.has(spaceId))
+                continue;
+            await drop(spaceId);
+            changed = true;
+        }
+        if (changed)
+            emit({ type: 'spaces' });
+    }
+    await carry(carryRecord);
+    await refresh();
+    return Object.freeze({
+        did,
+        carrySpace,
+        async spaces() {
+            const found = [];
+            for (const [spaceId, entry] of carried) {
+                const status = await entry.runtime.status();
+                found.push({
+                    id: spaceId,
+                    name: entry.record.space.name,
+                    visibility: entry.record.space.visibility,
+                    carry: spaceId === carrySpace,
+                    connection: status.connection,
+                    peers: status.peers.filter((peer) => peer !== podDid).length,
+                    inPod: entry.pod !== null,
+                });
+            }
+            return found;
+        },
+        async usePod(stores) {
+            podStores = stores;
+            for (const entry of carried.values()) {
+                const was = entry.pod;
+                entry.pod = null;
+                await (await was?.catch(() => null))?.close();
+                if (stores)
+                    entry.pod = openPod(entry.record, entry.hub, stores);
+            }
+            emit({ type: 'spaces' });
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            await refreshing;
+            await Promise.all([...carried.keys()].map((spaceId) => drop(spaceId)));
+            await registryStore.close();
+            listeners.clear();
+        },
+    });
+}
+//# sourceMappingURL=carrier.js.map

package/dist/node/carrier.js.map

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

package/dist/node/copy.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @module node/copy
+ * Moving an account's data from one set of stores to another — out of a
+ * browser's own database into a data folder, say.
+ *
+ * There is no separate "merge". Every record is signed and named by its own
+ * content, and a delete is a record too, so combining two copies of the same
+ * account is the union of what each holds: nothing can conflict, nothing is
+ * duplicated, and whatever either copy deleted stays deleted. Copying into a
+ * store that already has some of it is therefore safe, and copying twice does
+ * nothing the second time. Where both hold a version of the same record, the
+ * ordering rule picks the same one sync would.
+ */
+import type { StoreFactory } from './stores.js';
+export interface CopyAccountParams {
+    readonly from: StoreFactory;
+    readonly to: StoreFactory;
+    /** The account's DID — invites between the two registries are issued as it */
+    readonly did: string;
+    /** Also copy the account registry space, which neither registry lists */
+    readonly accountKey?: Uint8Array;
+    /** Called after each space, for a progress display */
+    readonly onProgress?: (done: number, total: number) => void;
+}
+export interface CopyResult {
+    /** Spaces the destination did not know about before */
+    readonly spacesAdded: number;
+    /** Records the destination did not hold before */
+    readonly recordsAdded: number;
+    /** Every space looked at, including the registry */
+    readonly spaces: number;
+}
+/**
+ * Copies every space an account holds, with its key and its records, into
+ * another set of stores. Whatever the destination already has is kept.
+ */
+export declare function copyAccountData(params: CopyAccountParams): Promise<CopyResult>;
+//# sourceMappingURL=copy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/node/copy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0CpF"}

package/dist/node/copy.js

@@ -0,0 +1,53 @@
+import { createSpaceManager } from '../space/space-manager.js';
+import { deriveAccountRegistry } from '../space/account-registry.js';
+import { createStorageProvider } from '../storage/storage-provider.js';
+/**
+ * Copies every space an account holds, with its key and its records, into
+ * another set of stores. Whatever the destination already has is kept.
+ */
+export async function copyAccountData(params) {
+    const fromRegistryStore = await params.from('registry', { seal: true });
+    const toRegistryStore = await params.to('registry', { seal: true });
+    const fromRegistry = createSpaceManager(fromRegistryStore);
+    const toRegistry = createSpaceManager(toRegistryStore);
+    let spacesAdded = 0;
+    const spaceIds = [];
+    for (const { space } of await fromRegistry.list()) {
+        spaceIds.push(space.id);
+        if (await toRegistry.get(space.id))
+            continue;
+        // An invite carries exactly what a registry needs: the space, and its key.
+        await toRegistry.join(await fromRegistry.createInvite(space.id, params.did));
+        spacesAdded++;
+    }
+    if (params.accountKey)
+        spaceIds.push((await deriveAccountRegistry(params.accountKey, params.did)).space.id);
+    let recordsAdded = 0;
+    for (const [index, spaceId] of spaceIds.entries()) {
+        const source = createStorageProvider(await params.from(`spaces/${spaceId}`));
+        const target = createStorageProvider(await params.to(`spaces/${spaceId}`));
+        try {
+            // Every version the source keeps — current, first, retained — goes
+            // through the ordering rule on arrival, so the target ends up with what
+            // it would have reached by syncing with the source.
+            const ids = new Set((await source.entries()).map((entry) => entry.value));
+            for (const id of ids) {
+                const held = await target.getExpression(id);
+                const expression = await source.getExpression(id);
+                if (!expression)
+                    continue;
+                await target.addExpression(expression);
+                // Counted only if it stayed: a version the target's own one supersedes is dropped again.
+                if (!held && (await target.getExpression(id)))
+                    recordsAdded++;
+            }
+        }
+        finally {
+            await Promise.all([source.close(), target.close()]);
+        }
+        params.onProgress?.(index + 1, spaceIds.length);
+    }
+    await Promise.all([fromRegistryStore.close(), toRegistryStore.close()]);
+    return { spacesAdded, recordsAdded, spaces: spaceIds.length };
+}
+//# sourceMappingURL=copy.js.map

package/dist/node/copy.js.map

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

package/dist/node/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @module node
+ * A node, and the actions every front end builds on.
+ */
+export { createNode, SESSION_CAPABILITY } from './node.js';
+export { writeCapability, relayRoom } from './space-runtime.js';
+export { indexedDBStores, folderStores } from './stores.js';
+export { copyAccountData } from './copy.js';
+export { createCarrierNode } from './carrier.js';
+export type { CarrierConfig, CarrierNode, CarriedSpace, CarrierEvent } from './carrier.js';
+export type { CopyAccountParams, CopyResult } from './copy.js';
+export type { StoreFactory, StoreOptions } from './stores.js';
+export { NODE_ACTIONS, runAction, checkActionInput } from './actions.js';
+export type { NodeAction, ActionSchema } from './actions.js';
+export type { P2PNode, NodeConfig, NodeNetworkConfig, NodeSpaces, NodeRecords, NodeRecord, NodeEvent, SpaceSummary, SpaceStatus, SpaceProfile, NewSpace, InvitePreview, ListOptions, ConnectionState, DelegateParams, Delegated, NodeCollection, NodeCollections, DefineCollection, NodeAccount, NodeCarriers, CarrierSummary, AccountProfileView, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC3F,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EACV,OAAO,EACP,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EACd,SAAS,EACT,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/node/index.js

@@ -0,0 +1,11 @@
+/**
+ * @module node
+ * A node, and the actions every front end builds on.
+ */
+export { createNode, SESSION_CAPABILITY } from './node.js';
+export { writeCapability, relayRoom } from './space-runtime.js';
+export { indexedDBStores, folderStores } from './stores.js';
+export { copyAccountData } from './copy.js';
+export { createCarrierNode } from './carrier.js';
+export { NODE_ACTIONS, runAction, checkActionInput } from './actions.js';
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAIjD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/node/node.d.ts

@@ -0,0 +1,12 @@
+import { type Capability } from '../identity/ucan.js';
+import type { NodeConfig, P2PNode } from './types.js';
+/** Everything a session key may do, across every space the node holds */
+export declare const SESSION_CAPABILITY: Capability;
+/**
+ * Starts a node.
+ *
+ * @param config Who it acts for, where it keeps data, and how it reaches peers
+ * @returns The running node; call `close()` when done
+ */
+export declare function createNode(config: NodeConfig): Promise<P2PNode>;
+//# sourceMappingURL=node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/node/node.ts"],"names":[],"mappings":"AAqBA,OAAO,EAA+C,KAAK,UAAU,EAAkB,MAAM,qBAAqB,CAAC;AAoBnH,OAAO,KAAK,EAOV,UAAU,EAQV,OAAO,EAER,MAAM,YAAY,CAAC;AAEpB,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,EAAE,UAA+C,CAAC;AAgCjF;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAszBrE"}