@serfab/cadre-core 1.15.0 → 1.17.0

package/dist/edge-node/dissolve.js

@@ -0,0 +1,184 @@
+/**
+ * Dissolving the party this app founded and left (docs/architecture.md → "An app joins an
+ * existing cadre" → "Dissolving the party it left"): the check that the running party holds
+ * everything the left one holds, and the removal of the left party's local storage. The same
+ * removal deletes a party whose owner removed this app ("Removed from A"), with no check.
+ *
+ * The removal is local: it writes nothing to either party's control database. A marker in the
+ * node-local database names the party from before the first deletion until after the saved
+ * start stops naming it, so a removal that a crash or a failed step interrupts is finished by
+ * the next start or the next dissolve without checking again: the decision to remove was made
+ * before the marker was written. Every step deletes what may already be gone.
+ */
+import { controlStorageScope } from '../storage-scope.js';
+import { exportStrandBundle, unheldBundleContent } from '../strand-move.js';
+import { KeyStoreJoinedStrandStore } from '../joined-strand-store.js';
+import { bootstrapPeersKvKey, enrolledMachinesKvKey, strandNetworkKvKey } from './node-local.js';
+import { parseSavedStart, serializeSavedStart } from './options.js';
+import { toError } from './strand-move.js';
+/**
+ * `EdgeNode.dissolveFormerParty` refused, nothing stopped: moving the former party's strands has
+ * not finished. A move into the running party finishes with `finishStrandMove()`; one into
+ * another party is adopted only there.
+ */
+export class StrandMovePendingError extends Error {
+    constructor(pending) {
+        super(`Cannot dissolve party ${pending.fromPartyId}: moving its strands into party ${pending.toPartyId} has not finished`);
+        this.pending = pending;
+        this.name = 'StrandMovePendingError';
+    }
+}
+/** `EdgeNode.dissolveFormerParty` refused, nothing deleted: the former party holds what the running party lacks, or has other machines. */
+export class FormerPartyNotEmptyError extends Error {
+    constructor(partyId, remains) {
+        super(`Cannot dissolve party ${partyId}: ${describeRemains(remains)}`);
+        this.name = 'FormerPartyNotEmptyError';
+        this.partyId = partyId;
+        this.otherMachines = remains.otherMachines;
+        this.strandIds = remains.strandIds;
+        this.pendingJoinIds = remains.pendingJoinIds;
+    }
+}
+export async function readFormerParty(node) {
+    const self = node.peerId?.toString();
+    const machines = new Set((await node.listMembers()).map((member) => member.peerId));
+    return { bundle: await exportStrandBundle(node), otherMachines: [...machines].filter((peerId) => peerId !== self) };
+}
+/** The refusal `content` earns against what the running party holds, or null when it may be dissolved. */
+export function formerPartyRefusal(content, holdings, discard, nowMs) {
+    const discarded = new Set(discard);
+    const unheld = unheldBundleContent(content.bundle, holdings, nowMs);
+    const remains = {
+        otherMachines: content.otherMachines,
+        strandIds: unheld.strandIds.filter((strandId) => !discarded.has(strandId)),
+        pendingJoinIds: unheld.pendingJoinIds.filter((joinId) => !discarded.has(joinId)),
+    };
+    const empty = remains.otherMachines.length + remains.strandIds.length + remains.pendingJoinIds.length === 0;
+    return empty ? null : new FormerPartyNotEmptyError(content.bundle.partyId, remains);
+}
+/** The former party's start for {@link readFormerParty}: nothing to dial or reserve on, the running Noise mode. */
+export function formerPartyRead(partyId, running) {
+    return {
+        partyId,
+        bootstrapAddrs: [],
+        relayAddrs: [],
+        ...(running.noiseCryptoMode !== undefined && { noiseCryptoMode: running.noiseCryptoMode }),
+    };
+}
+/** `options` without `formerPartyId` when it names `partyId`. */
+export function withoutFormerParty(options, partyId) {
+    if (partyId === undefined || options.formerPartyId !== partyId)
+        return options;
+    const { formerPartyId: _dissolved, ...rest } = options;
+    return rest;
+}
+const MARKER_VERSION = 1;
+/** Mark `partyId` as being removed, then remove its local storage. Only once removing it is decided: a dissolve's check passed, or an owner removed this app. */
+export async function removeParty(storage, partyId) {
+    await storage.nodeLocal.set(storage.markerKey, JSON.stringify({ v: MARKER_VERSION, partyId }));
+    // On disk before the first deletion, so a crash during the removal leaves the marker that finishes it.
+    await storage.nodeLocal.flush();
+    await finishRemoving(storage, partyId);
+}
+/**
+ * The party a begun dissolve names, or `undefined`. A marker that does not parse is deleted with
+ * a warning: nothing can finish it, and the party it named keeps what is left of its storage.
+ */
+async function markedParty(storage) {
+    const text = await storage.nodeLocal.get(storage.markerKey);
+    if (text === undefined)
+        return undefined;
+    const partyId = parseMarker(text);
+    if (partyId === undefined) {
+        console.warn(`[cadre-core/edge-node] deleting the dissolve marker ${storage.markerKey}: it is not one this kit wrote`);
+        await storage.nodeLocal.delete(storage.markerKey);
+    }
+    return partyId;
+}
+/** Finish the removal a marker names, if any. */
+export async function finishMarkedRemoval(storage) {
+    const partyId = await markedParty(storage);
+    if (partyId !== undefined)
+        await finishRemoving(storage, partyId);
+}
+/**
+ * {@link finishMarkedRemoval} before a start, which must then not keep the party it names as
+ * `formerPartyId`, finished or not. A failure is logged and reported, and the start goes on; the
+ * marker stays for the next.
+ */
+export async function finishRemovalAtStart(storage) {
+    let partyId;
+    try {
+        partyId = await markedParty(storage);
+        if (partyId !== undefined)
+            await finishRemoving(storage, partyId);
+        return { partyId };
+    }
+    catch (err) {
+        console.warn('[cadre-core/edge-node] finishing the removal of a dissolved party failed; the next start retries:', err);
+        return { partyId, error: toError(err) };
+    }
+}
+/**
+ * Delete what is left of `partyId`'s local storage, then the marker: its control database, its
+ * node-local records, its trusted-owner anchor, its unpublished joined-strand records and its move
+ * record; then the saved start stops naming it as `formerPartyId`.
+ *
+ * NOTE: strand databases stay. A strand's storage scope is its strand id, not the party, so a
+ * moved strand's database is the running party's copy; a discarded strand's is left too, for the
+ * running party to reuse if it joins that strand again. If discarded strands' storage ever needs
+ * reclaiming, delete it here only for a strand no party on this device holds.
+ */
+async function finishRemoving(storage, partyId) {
+    await storage.destroyScope(controlStorageScope(partyId));
+    for (const key of [bootstrapPeersKvKey(partyId), enrolledMachinesKvKey(partyId), strandNetworkKvKey(partyId)]) {
+        await storage.nodeLocal.delete(key);
+    }
+    await storage.trustedOwnerSlot(partyId).remove();
+    await forgetJoinedStrands(storage.keyStore, partyId);
+    await storage.moves.remove(partyId);
+    await dropFromSavedStart(storage, partyId);
+    await storage.nodeLocal.delete(storage.markerKey);
+    // One batch: the saved start stops naming the party in the same write that deletes the marker.
+    await storage.nodeLocal.flush();
+}
+async function forgetJoinedStrands(keyStore, partyId) {
+    const joins = new KeyStoreJoinedStrandStore(keyStore, partyId);
+    for (const record of await joins.list())
+        await joins.forget(record.Id);
+}
+/** A write that throws, unlike the runtime's best-effort save, so a failure keeps the marker for the next start. */
+async function dropFromSavedStart(storage, partyId) {
+    const saved = parseSavedStart(await storage.nodeLocal.get(storage.savedStartKey));
+    if (saved?.options.formerPartyId !== partyId)
+        return;
+    await storage.nodeLocal.set(storage.savedStartKey, serializeSavedStart({ ...saved, options: withoutFormerParty(saved.options, partyId) }));
+}
+/** The party id in a marker's `text`, or `undefined` (logged) when it is not a marker. */
+function parseMarker(text) {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (err) {
+        console.warn('[cadre-core/edge-node] the dissolve marker is not JSON:', err);
+        return undefined;
+    }
+    if (typeof raw !== 'object' || raw === null)
+        return undefined;
+    const { v, partyId } = raw;
+    return v === MARKER_VERSION && typeof partyId === 'string' && partyId.length > 0 ? partyId : undefined;
+}
+/** "other machines are in it (…); the running party does not hold strands …": the non-empty lists. */
+function describeRemains(remains) {
+    const parts = [
+        listed('other machines are in it', remains.otherMachines),
+        listed('the running party does not hold its strands', remains.strandIds),
+        listed('the running party does not hold its open pending joins', remains.pendingJoinIds),
+    ].filter((part) => part !== null);
+    return parts.join('; ');
+}
+function listed(what, ids) {
+    return ids.length === 0 ? null : `${what} (${ids.join(', ')})`;
+}
+//# sourceMappingURL=dissolve.js.map

package/dist/edge-node/dissolve.js.map

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

package/dist/edge-node/edge-join.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `EdgeNode.joinCadre`'s sequence: redeem in place on a node already running in the credential's
+ * party, or stop the running node, start one in that party, redeem there and go back on any
+ * failure (docs/architecture.md → "An app joins an existing cadre"). The credential is a machine
+ * invitation, which admits the app as a machine, or an owner grant, which makes it a machine and
+ * an owner at once ({@link JoinCredential}). Runs over a narrow view of the runtime
+ * ({@link JoinRuntime}), inside one of its transitions.
+ */
+import type { CadreNode } from '../cadre-node.js';
+import type { OwnerSigner } from '../owner-signer.js';
+import type { OwnerGenesisResult } from './config.js';
+import type { EdgeNodeStatus, JoinCadreOptions, JoinCadreResult } from './edge-node.js';
+import { type JoinCredential } from './join-credential.js';
+import type { EdgeNodeOptions, SavedStart } from './options.js';
+import { type StrandMoveRecords } from './strand-move.js';
+/** The part of the edge-node runtime a join drives. Every call runs inside the join's own transition. */
+export interface JoinRuntime {
+    /** The running node, or null. */
+    readonly node: CadreNode | null;
+    /** The options the running node was started with; null unless running. */
+    readonly runningOptions: EdgeNodeOptions | null;
+    readonly moves: StrandMoveRecords;
+    readonly status: EdgeNodeStatus;
+    setStatus(status: EdgeNodeStatus): void;
+    readSavedStart(): Promise<SavedStart | undefined>;
+    /** Stop the node and close every store; nothing runs afterwards. */
+    shutDown(): Promise<void>;
+    /** Build and start the node for `options`, subscriptions attached; nothing saved, nothing reported. */
+    bringUp(options: EdgeNodeOptions): Promise<{
+        node: CadreNode;
+        resolved: EdgeNodeOptions;
+    }>;
+    /** Start a node for `options`' party only to run `read` on it, then stop it. */
+    readAlone<T>(options: EdgeNodeOptions, read: (node: CadreNode) => Promise<T>, purpose: string): Promise<T>;
+    /** A full start: bring up, settle the owner key, adopt waiting moves, save and report `running`. */
+    buildAndStart(options: EdgeNodeOptions): Promise<CadreNode>;
+    /** The owner slot's key, created when the slot is empty: the key an owner grant seats. */
+    ownerSlotSigner(): Promise<OwnerSigner>;
+    /** `granted`: an owner grant has just seated the slot's key, so wait for the row. */
+    wireJoinedOwner(node: CadreNode, granted: boolean): Promise<OwnerGenesisResult>;
+    saveRunningStart(resolved: EdgeNodeOptions): Promise<void>;
+    reportRunning(node: CadreNode, resolved: EdgeNodeOptions, owner: OwnerGenesisResult): void;
+}
+export declare function joinCadre(runtime: JoinRuntime, credential: JoinCredential, options: JoinCadreOptions, signal: AbortSignal): Promise<JoinCadreResult>;

package/dist/edge-node/edge-join.js

@@ -0,0 +1,227 @@
+/**
+ * `EdgeNode.joinCadre`'s sequence: redeem in place on a node already running in the credential's
+ * party, or stop the running node, start one in that party, redeem there and go back on any
+ * failure (docs/architecture.md → "An app joins an existing cadre"). The credential is a machine
+ * invitation, which admits the app as a machine, or an owner grant, which makes it a machine and
+ * an owner at once ({@link JoinCredential}). Runs over a narrow view of the runtime
+ * ({@link JoinRuntime}), inside one of its transitions.
+ */
+import { exportStrandBundle } from '../strand-move.js';
+import { isOwnerGrant } from './join-credential.js';
+import { adoptMovesInto, deferredOutcome, joinMoveRecord, toError, } from './strand-move.js';
+export async function joinCadre(runtime, credential, options, signal) {
+    signal.throwIfAborted();
+    const running = runtime.node;
+    if (running?.isRunning && runtime.runningOptions?.partyId === credential.partyId) {
+        return redeemInPlace(runtime, running, runtime.runningOptions, credential, options, signal);
+    }
+    return switchParty(runtime, credential, options, signal);
+}
+/** Redeem on the node already running in the credential's party; nothing to switch or roll back. */
+async function redeemInPlace(runtime, node, running, credential, options, signal) {
+    const admission = await redeemOnRunningNode(runtime, node, credential, options, signal);
+    reportProgress(options, { state: 'admitted', asOwner: admission.asOwner });
+    const owner = await runtime.wireJoinedOwner(node, admission.asOwner);
+    // An owner grant redeemed on a node that joined as a member finishes the move that join deferred.
+    const strandMove = await settleJoinMove(runtime, node, running.formerPartyId, owner);
+    if (owner === 'enrolled')
+        runtime.setStatus({ state: 'running', node, owner });
+    return joinResult(admission, running.formerPartyId, strandMove);
+}
+/**
+ * A machine invitation is redeemed as on a fresh node (a device already admitted is answered as
+ * such). An owner grant is redeemed for the owner slot's key: the node is a member of the party,
+ * so `redeemOwnerGrant` writes the row in its own store and the key can be wired at once.
+ */
+async function redeemOnRunningNode(runtime, node, credential, options, signal) {
+    if (!isOwnerGrant(credential))
+        return redeemInvitation(node, credential, options, signal);
+    // NOTE: a member running with no control connection to the party is refused `alone`
+    // (`OwnerKeyAddRefusedError`) by the grant's local path, where the invitation path waits for a
+    // member; if apps meet that, wait for a control connection before redeeming in place.
+    const redeemed = await node.redeemOwnerGrant(credential, await runtime.ownerSlotSigner(), redeemOptions(options, signal));
+    return { peerId: redeemed.memberPeerId, redeemedAt: new Date().toISOString(), asOwner: true };
+}
+/**
+ * Stop the running node, start one in the credential's party and redeem there; on any
+ * failure, go back to what ran before. Nothing is saved until a member has admitted this app.
+ * Leaving a party this app founded, its strands are recorded for the move first, so a refusal
+ * leaves that party running and unchanged.
+ */
+async function switchParty(runtime, credential, options, signal) {
+    const restore = runtime.runningOptions;
+    const leaving = restore ?? (await runtime.readSavedStart())?.options ?? null;
+    const founded = foundedPartyLeft(credential.partyId, leaving);
+    // The party this app founded, carried through any later join.
+    // NOTE: leaving a joined party while the move from `formerPartyId` into it is still pending
+    // (the key never wired as an owner there) leaves that record naming the party left, adopted
+    // only if the app goes back; `pendingStrandMove` keeps reporting it. If apps need the move
+    // to follow the app, retarget the record to the credential's party here.
+    const formerPartyId = founded?.partyId ?? leaving?.formerPartyId;
+    const joined = {
+        partyId: credential.partyId,
+        // None needed: the redemption retains the member that admits this app as a dial
+        // target in the party's bootstrap-peer store, which every later start reads.
+        bootstrapAddrs: [],
+        relayAddrs: options.relayAddrs ?? leaving?.relayAddrs ?? [],
+        origin: 'joined',
+    };
+    const noiseCryptoMode = options.noiseCryptoMode ?? leaving?.noiseCryptoMode;
+    if (noiseCryptoMode !== undefined)
+        joined.noiseCryptoMode = noiseCryptoMode;
+    if (formerPartyId !== undefined)
+        joined.formerPartyId = formerPartyId;
+    const movingFrom = founded ? await recordStrandMove(runtime, founded, credential) : undefined;
+    try {
+        await runtime.shutDown();
+        return await startAndRedeem(runtime, joined, credential, options, signal, movingFrom);
+    }
+    catch (err) {
+        await returnToLeftParty(runtime, restore, movingFrom);
+        throw err;
+    }
+}
+/**
+ * Export the founded party's strands and keep them in the key store for the joined party to
+ * adopt; the party's id when there was anything to move. Throws `StrandsNeedOwnerJoinError`, or
+ * the export's or the write's error: switching without the record would lose the strands.
+ * An empty export removes the party's record instead: one left by an earlier join that never
+ * finished describes strands the party no longer holds, and adopting it would bring them back.
+ */
+async function recordStrandMove(runtime, founded, credential) {
+    const running = runtime.node;
+    const bundle = running?.isRunning
+        ? await exportStrandBundle(running)
+        : await runtime.readAlone(founded, exportStrandBundle, 'export strands');
+    const record = joinMoveRecord(bundle, credential);
+    if (!record) {
+        await runtime.moves.remove(founded.partyId);
+        return undefined;
+    }
+    await runtime.moves.save(record);
+    return founded.partyId;
+}
+/**
+ * Admitted, the start is saved before the strands are adopted, so an app killed mid-adoption
+ * relaunches into the joined party and finishes the move there; `running` is reported after.
+ */
+async function startAndRedeem(runtime, joined, credential, options, signal, movingFrom) {
+    runtime.setStatus({ state: 'starting' });
+    const { node, resolved } = await runtime.bringUp(joined);
+    runtime.setStatus({ state: 'joining', node });
+    const admission = await redeemOnJoinedNode(runtime, node, credential, options, signal);
+    reportProgress(options, { state: 'admitted', asOwner: admission.asOwner });
+    const owner = await runtime.wireJoinedOwner(node, admission.asOwner);
+    await runtime.saveRunningStart(resolved);
+    if (movingFrom !== undefined && owner === 'enrolled')
+        reportProgress(options, { state: 'moving-strands' });
+    const strandMove = await settleJoinMove(runtime, node, resolved.formerPartyId, owner);
+    runtime.reportRunning(node, resolved, owner);
+    return joinResult(admission, resolved.formerPartyId, strandMove);
+}
+/**
+ * Redeem on the node started in the credential's party: a machine invitation admits the app, an
+ * owner grant makes it a machine and an owner (`CadreNode.joinWithOwnerGrant`).
+ *
+ * The grant seats the owner slot's key, created now when the slot is empty: the app's one owner
+ * key, which may already own the party the app founded and is leaving (one key, several cadres).
+ * A fresh key would need a second owner slot and a second signer per node, which the kits do not
+ * have, and replacing the slot's key would lose the left party, which a rollback restarts.
+ * Created before the redemption, the key stays in the slot when the join fails, an owner of
+ * nothing until the next founding or grant uses it.
+ */
+async function redeemOnJoinedNode(runtime, node, credential, options, signal) {
+    if (!isOwnerGrant(credential))
+        return redeemInvitation(node, credential, options, signal);
+    // NOTE: a rollback after the grant was redeemed but the self-invitation refused leaves the
+    // slot's key an owner of the credential's party while the app is back in the party it left;
+    // a later join there, with a machine invitation too, picks the ownership up through that key.
+    // NOTE: `joinWithOwnerGrant` already waits up to its own bound for the key's `OwnerKey` row
+    // and wires it; `wireJoinedOwner(node, true)` then asks again for up to the owner-step bound
+    // while it is still unwired, so a row that never arrives costs both waits before `timed-out`.
+    // If that shows up, carry `joined.ownerWired` in the admission and skip the second wait.
+    const joined = await node.joinWithOwnerGrant(credential, await runtime.ownerSlotSigner(), redeemOptions(options, signal));
+    return { peerId: joined.peerId, redeemedAt: joined.redeemedAt, asOwner: true };
+}
+async function redeemInvitation(node, invitation, options, signal) {
+    const redemption = await node.redeemCadreInvitation(invitation, redeemOptions(options, signal));
+    return { ...redemption, asOwner: false };
+}
+/**
+ * The move from `formerPartyId` as an admitted join reports it: adopted with every other move
+ * naming this party once the app's key is wired as its owner, deferred otherwise. Never throws:
+ * the app is admitted, and what is not adopted now is adopted by the next start.
+ */
+async function settleJoinMove(runtime, node, formerPartyId, owner) {
+    try {
+        if (owner === 'enrolled') {
+            const outcomes = await adoptMovesInto(node, runtime.moves);
+            return formerPartyId === undefined ? undefined : outcomes.get(formerPartyId);
+        }
+        const record = formerPartyId === undefined ? undefined : await runtime.moves.load(formerPartyId);
+        return record?.targetPartyId === node.partyId ? { state: 'deferred', reason: 'owner-key-not-wired' } : undefined;
+    }
+    catch (err) {
+        console.warn('[cadre-core/edge-node] reading the strand move records failed; the next start retries:', err);
+        return formerPartyId === undefined ? undefined : deferredOutcome(err);
+    }
+}
+/**
+ * After a failed join: discard the move record it wrote, stop the joined party's node and start
+ * again what ran before, if anything did.
+ */
+async function returnToLeftParty(runtime, restore, movingFrom) {
+    await discardStrandMove(runtime.moves, movingFrom);
+    try {
+        await runtime.shutDown();
+        if (restore)
+            await runtime.buildAndStart(restore);
+    }
+    catch (err) {
+        // The join's own error is the one its caller gets; this one is only logged.
+        console.warn('[cadre-core/edge-node] going back to the party a failed join left failed:', err);
+        if (runtime.status.state !== 'failed')
+            runtime.setStatus({ state: 'failed', error: toError(err) });
+    }
+}
+async function discardStrandMove(moves, fromPartyId) {
+    if (fromPartyId === undefined)
+        return;
+    try {
+        await moves.remove(fromPartyId);
+    }
+    catch (err) {
+        // Harmless when left: it names the party the join failed to reach, and the next join from
+        // this party replaces it.
+        console.warn(`[cadre-core/edge-node] could not discard the strand move record of party ${fromPartyId}:`, err);
+    }
+}
+/** Wait for a member: an app joining by invitation is often the only machine of the party up. The grant's options are the invitation's. */
+function redeemOptions(options, signal) {
+    return { waitForMember: true, signal, ...(options.onProgress ? { onProgress: options.onProgress } : {}) };
+}
+/** Tell the join's listener; one that throws must not fail a join a member has already admitted. */
+function reportProgress(options, progress) {
+    try {
+        options.onProgress?.(progress);
+    }
+    catch (err) {
+        console.warn('[cadre-core/edge-node] join progress listener threw:', err);
+    }
+}
+/**
+ * The start a join to `partyId` leaves, when it is of a party this app founded: the party whose
+ * strands move and which is kept as `formerPartyId` for clean-up. Null when the join leaves no
+ * start, a party this app joined, or the party it joins.
+ */
+function foundedPartyLeft(partyId, leaving) {
+    return leaving && leaving.origin !== 'joined' && leaving.partyId !== partyId ? leaving : null;
+}
+function joinResult(admission, formerPartyId, strandMove) {
+    return {
+        ...admission,
+        ...(formerPartyId !== undefined && { formerPartyId }),
+        ...(strandMove !== undefined && { strandMove }),
+    };
+}
+//# sourceMappingURL=edge-join.js.map

package/dist/edge-node/edge-join.js.map

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