@freqhole/haruspex 0.0.0

package/dist/flows/add-peer/types.d.ts

@@ -0,0 +1,271 @@
+import type { PeerTarget } from "../../share/peer-addr.js";
+export type { PeerTarget };
+/** lifecycle stage of an in-progress remote addition, persisted so a
+ *  closed tab/modal can resume where it left off. */
+export type PendingRemoteStage = "testing" | "connected" | "failed" | "knock_pending" | "knock_accepted" | "knock_rejected";
+/** a persisted in-progress remote addition. field names are snake_case:
+ *  these records live in app storage (idb) and are adopted in place. */
+export interface PendingRemote {
+    id: string;
+    /** p2p node id / endpoint json, or the http base url. */
+    peer_addr: string;
+    /** app-defined transport tag (e.g. "wasm", "app", "http"). */
+    transport: string;
+    stage: PendingRemoteStage;
+    server_name: string | null;
+    server_description: string | null;
+    server_version: string | null;
+    server_image_data: string | null;
+    server_image_type: string | null;
+    knock_username: string | null;
+    knock_message: string | null;
+    error_message: string | null;
+}
+/** what a peer's public hello endpoint reports about itself. snake_case
+ *  matches the wire shape. */
+export interface PeerServerInfo {
+    name: string;
+    description?: string | null;
+    version: string;
+    image_url?: string | null;
+    image_blob_id?: string | null;
+    requires_auth: boolean;
+    knocking_enabled?: boolean | null;
+    passkey_p2p_enabled?: boolean | null;
+}
+/** a saved remote, as returned by the app's remote store. */
+export interface SavedRemote {
+    remote_id: string;
+    name: string;
+    base_url?: string;
+    peer_addr?: string;
+}
+export type AddPeerState = {
+    step: "url";
+    subStep: "input" | "knock_form";
+    error: string | null;
+    pendingRemotes: PendingRemote[];
+    serverInfo: PeerServerInfo | null;
+    peerAddr: string | null;
+} | {
+    step: "testing";
+    progress: string | null;
+    peerAddr: string | null;
+    url: string;
+} | {
+    step: "auth";
+    error: string | null;
+    serverInfo: PeerServerInfo | null;
+    peerAddr: string | null;
+    url: string;
+} | {
+    step: "knock_sent";
+} | {
+    step: "complete";
+    remote: SavedRemote;
+};
+/** outcome of a connection probe (hello + whoami against the target). */
+export type ConnectionOutcome = {
+    kind: "already_authed";
+    serverInfo: PeerServerInfo;
+} | {
+    kind: "needs_knock";
+    serverInfo: PeerServerInfo;
+    error?: string;
+} | {
+    kind: "needs_auth";
+    serverInfo: PeerServerInfo;
+} | {
+    kind: "failed";
+    error: string;
+};
+/** outcome of a knock-status re-check for a pending knock. */
+export type KnockStatusOutcome = {
+    kind: "accepted_authed";
+    serverInfo: PeerServerInfo | null;
+} | {
+    kind: "accepted_needs_auth";
+    serverInfo: PeerServerInfo | null;
+} | {
+    kind: "denied";
+} | {
+    kind: "pending";
+} | {
+    kind: "unreachable";
+};
+export type AddPeerEvent = {
+    type: "MODAL_OPEN";
+    initialInput?: string;
+} | {
+    type: "MODAL_CLOSE";
+} | {
+    type: "INPUT_CHANGE";
+    input: string;
+} | {
+    type: "QR_SCAN";
+    input: string;
+} | {
+    type: "SUBMIT_URL";
+    input: string;
+} | {
+    type: "SUBMIT_KNOCK";
+    username: string;
+    message: string;
+} | {
+    type: "CANCEL_KNOCK";
+} | {
+    type: "USE_INVITE_CODE";
+} | {
+    type: "PASSKEY_SIGNIN";
+} | {
+    type: "SUBMIT_AUTH";
+    mode: "login" | "register";
+    username: string;
+    inviteCode?: string;
+} | {
+    type: "PASSKEY_AUTH";
+    mode: "login" | "register";
+    username?: string;
+    inviteCode?: string;
+} | {
+    type: "BACK";
+} | {
+    type: "RETRY_PENDING";
+    pending: PendingRemote;
+} | {
+    type: "DELETE_PENDING";
+    pending: PendingRemote;
+} | {
+    type: "PENDING_LOADED";
+    records: PendingRemote[];
+} | {
+    type: "DUPLICATE_RESULT";
+    duplicateName: string | null;
+} | {
+    type: "CONNECTION_RESULT";
+    outcome: ConnectionOutcome;
+} | {
+    type: "KNOCK_SENT_RESULT";
+    ok: boolean;
+    error?: string;
+} | {
+    type: "KNOCK_STATUS_RESULT";
+    outcome: KnockStatusOutcome;
+} | {
+    type: "AUTH_RESULT";
+    ok: boolean;
+    error?: string;
+} | {
+    type: "REMOTE_CREATED";
+    ok: boolean;
+    remote?: SavedRemote;
+    error?: string;
+} | {
+    type: "COMPLETE_PEER_ADDR";
+    peerAddr: string;
+} | {
+    type: "TIMER_FIRED";
+    id: string;
+};
+export type AddPeerEffect = {
+    type: "LOAD_PENDING_REMOTES";
+} | {
+    type: "CHECK_DUPLICATE";
+    target: PeerTarget;
+} | {
+    type: "UPSERT_PENDING";
+    peerAddr: string;
+    patch: Partial<Omit<PendingRemote, "id" | "peer_addr">>;
+} | {
+    type: "DELETE_PENDING";
+    id: string;
+} | {
+    type: "DELETE_PENDING_BY_ADDR";
+    peerAddr: string;
+} | {
+    type: "CHECK_CONNECTION";
+    target: PeerTarget;
+} | {
+    type: "SEND_KNOCK";
+    peerAddr: string;
+    username: string;
+    message: string;
+} | {
+    type: "CHECK_KNOCK_STATUS";
+    pending: PendingRemote;
+} | {
+    type: "AUTH_HTTP";
+    url: string;
+    mode: "login" | "register";
+    username: string;
+    inviteCode?: string;
+} | {
+    type: "AUTH_REDEEM_INVITE";
+    peerAddr: string;
+    username: string;
+    inviteCode: string;
+} | {
+    type: "AUTH_PASSKEY_REGISTER";
+    peerAddr: string;
+    username?: string;
+    inviteCode: string;
+} | {
+    type: "AUTH_PASSKEY_LOGIN";
+    target: PeerTarget;
+    username?: string;
+} | {
+    type: "CREATE_REMOTE";
+    peerAddr: string | null;
+    url: string;
+} | {
+    type: "CANCEL_IN_FLIGHT";
+} | {
+    type: "SCHEDULE_TIMER";
+    id: string;
+    ms: number;
+} | {
+    type: "CLEAR_QUERY_PARAM";
+} | {
+    type: "CALL_ON_SUCCESS";
+    remote: SavedRemote;
+} | {
+    type: "CALL_ON_CLOSE";
+};
+/** everything the bundled effect runner needs from the app. each dep is a
+ *  thin binding over the app's own storage/client layer; the machine
+ *  itself never calls these - only `runEffect` does. */
+export interface AddPeerFlowDeps {
+    getAllRemotes(): Promise<SavedRemote[]>;
+    getAllPendingRemotes(): Promise<PendingRemote[]>;
+    getPendingRemoteByPeerAddr(peerAddr: string): Promise<PendingRemote | null>;
+    createPendingRemote(record: Omit<PendingRemote, "id">): Promise<PendingRemote>;
+    updatePendingRemote(id: string, patch: Partial<Omit<PendingRemote, "id">>): Promise<void>;
+    deletePendingRemote(id: string): Promise<void>;
+    deletePendingRemoteByPeerAddr(peerAddr: string): Promise<void>;
+    createRemote(input: {
+        base_url?: string;
+        peer_addr?: string;
+    }): Promise<SavedRemote>;
+    getServerInfo(target: PeerTarget): Promise<PeerServerInfo | null>;
+    whoami(target: PeerTarget): Promise<boolean>;
+    sendKnock(peerAddr: string, username: string, message: string): Promise<void>;
+    checkKnockStatus(peerAddr: string): Promise<"accepted" | "rejected" | "pending" | null>;
+    authenticateHttp(url: string, data: {
+        mode: "login" | "register";
+        username: string;
+        inviteCode?: string;
+    }): Promise<void>;
+    redeemInvite(peerAddr: string, username: string, inviteCode: string): Promise<void>;
+    registerWithPasskey(peerAddr: string, username: string | undefined, inviteCode: string): Promise<void>;
+    loginWithPasskey(target: PeerTarget, username?: string): Promise<void>;
+    /** app-defined transport tag recorded on pending remotes ("wasm", "app", "http"). */
+    transportFor(target: PeerTarget): string;
+    /** default scheme for scheme-less http input. default "https". */
+    defaultScheme?: "http" | "https";
+    clearQueryParam?(): void;
+    onSuccess?(remote: SavedRemote): void;
+    onClose?(): void;
+    /** timer scheduling seam - override in tests. defaults to setTimeout. */
+    scheduleTimer?(id: string, ms: number, fire: () => void): () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/flows/add-peer/types.d.ts.map

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

package/dist/flows/add-peer/types.js

@@ -0,0 +1,10 @@
+// shapes for the add-peer flow: the headless state machine that drives
+// "add a remote peer" ui across apps (address entry -> connection test ->
+// knock request or auth -> saved remote).
+//
+// the machine (see machine.ts) is pure and synchronous: `send(event)`
+// returns effect descriptors; an adapter executes the effects (async io,
+// timers, aborts) and feeds their outcomes back in as events. nothing in
+// this subpath imports a framework - solid/pixi/react shells all drive
+// the same machine.
+export {};

package/dist/flows/index.d.ts

@@ -0,0 +1,6 @@
+export { COMPLETE_DISMISS_MS, DISMISS_TIMER_ID, initialContext, projectState, transition, } from "./add-peer/machine.js";
+export type { AddPeerContext, TransitionResult } from "./add-peer/machine.js";
+export { createAddPeerFlow } from "./add-peer/runner.js";
+export type { AddPeerFlow } from "./add-peer/runner.js";
+export type { AddPeerEffect, AddPeerEvent, AddPeerFlowDeps, AddPeerState, ConnectionOutcome, KnockStatusOutcome, PeerServerInfo, PeerTarget, PendingRemote, PendingRemoteStage, SavedRemote, } from "./add-peer/types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flows/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,WAAW,GACZ,MAAM,qBAAqB,CAAC"}

package/dist/flows/index.js

@@ -0,0 +1,6 @@
+// framework-free flow state machines. each flow is a pure machine
+// (send(event) -> effects) plus a bundled effect runner over injected
+// deps; solid/pixi/react shells all drive the same machine. the ./solid
+// subpath ships optional rendered components over these.
+export { COMPLETE_DISMISS_MS, DISMISS_TIMER_ID, initialContext, projectState, transition, } from "./add-peer/machine.js";
+export { createAddPeerFlow } from "./add-peer/runner.js";

package/dist/identity/idbStore.d.ts

@@ -0,0 +1,51 @@
+import type { IdentityStore, P2PIdentity } from "./types.js";
+/**
+ * an idb database/store/key triple describing where an identity record
+ * lives. every consuming app parameterizes its own database name (and,
+ * when reading another app's database as a fallback source, that app's
+ * database name too) - see resolve.ts for the cross-app fallback story.
+ */
+export interface IdentitySource {
+    /** indexeddb database name. */
+    databaseName: string;
+    /** object store name within that database. */
+    storeName: string;
+    /** record key within the store; defaults to "p2p_identity". */
+    key?: string;
+}
+/**
+ * check whether a database exists without creating it.
+ *
+ * strategy:
+ *   1. use indexedDB.databases() when available (chrome/firefox 126+)
+ *   2. fall back to a versionless open; abort the versionchange transaction
+ *      if upgrade fires (meaning the db did not exist), then delete the
+ *      empty database that open unavoidably created before we could abort.
+ */
+export declare function databaseExists(databaseName: string): Promise<boolean>;
+/**
+ * open a database read-only-safe: returns null if it does not already
+ * exist, never creating or upgrading it in the process.
+ */
+export declare function openExistingDatabase(databaseName: string): Promise<IDBDatabase | null>;
+/** check whether a given identity source's database and store both exist,
+ *  without creating or upgrading anything. */
+export declare function identitySourceAvailable(source: IdentitySource): Promise<boolean>;
+/**
+ * read an identity record from a source, without creating or upgrading its
+ * database. returns null if the database, store, or record is absent.
+ */
+export declare function readIdentityFrom(source: IdentitySource): Promise<P2PIdentity | null>;
+/**
+ * write an identity record to a source. the database and store must already
+ * exist (this never creates or upgrades a database it doesn't own).
+ */
+export declare function writeIdentityTo(source: IdentitySource, identity: P2PIdentity): Promise<void>;
+/**
+ * an identity store backed by its own dedicated idb database/store, created
+ * on demand. suitable as an app's local, always-available identity store -
+ * the store the cross-app resolution in resolve.ts falls back to when no
+ * other source has an identity yet.
+ */
+export declare function createIdbIdentityStore(source: IdentitySource): IdentityStore;
+//# sourceMappingURL=idbStore.d.ts.map

package/dist/identity/idbStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idbStore.d.ts","sourceRoot":"","sources":["../../src/identity/idbStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK7D;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU3E;AA6BD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAiB7B;AAED;8CAC8C;AAC9C,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,OAAO,CAAC,CAMlB;AA6BD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAS7B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC,CAaf;AAwCD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAsB5E"}

package/dist/identity/idbStore.js

@@ -0,0 +1,183 @@
+/** record key used within an identity object store, unless overridden. */
+const DEFAULT_KEY = "p2p_identity";
+/**
+ * check whether a database exists without creating it.
+ *
+ * strategy:
+ *   1. use indexedDB.databases() when available (chrome/firefox 126+)
+ *   2. fall back to a versionless open; abort the versionchange transaction
+ *      if upgrade fires (meaning the db did not exist), then delete the
+ *      empty database that open unavoidably created before we could abort.
+ */
+export async function databaseExists(databaseName) {
+    if (typeof indexedDB.databases === "function") {
+        try {
+            const dbs = await indexedDB.databases();
+            return dbs.some((d) => d.name === databaseName);
+        }
+        catch {
+            // fall through to open-based detection
+        }
+    }
+    return openBasedExistenceCheck(databaseName);
+}
+function openBasedExistenceCheck(databaseName) {
+    return new Promise((resolve) => {
+        const req = indexedDB.open(databaseName);
+        let existed = true;
+        req.onupgradeneeded = (event) => {
+            // upgradeneeded on a version-0 open means the db is being created now
+            existed = false;
+            event.target.transaction?.abort();
+        };
+        req.onsuccess = () => {
+            req.result.close();
+            if (!existed) {
+                // clean up the empty database that was created before we could abort
+                indexedDB.deleteDatabase(databaseName);
+            }
+            resolve(existed);
+        };
+        req.onerror = () => {
+            // the abort above causes an error - if existed is false this is expected
+            resolve(existed);
+        };
+    });
+}
+/**
+ * open a database read-only-safe: returns null if it does not already
+ * exist, never creating or upgrading it in the process.
+ */
+export async function openExistingDatabase(databaseName) {
+    if (!(await databaseExists(databaseName)))
+        return null;
+    return new Promise((resolve) => {
+        const req = indexedDB.open(databaseName);
+        req.onupgradeneeded = (event) => {
+            // should not fire - databaseExists() just confirmed the db is there.
+            // abort defensively so we never create it out from under a concurrent
+            // deletion.
+            event.target.transaction?.abort();
+            resolve(null);
+        };
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => resolve(null);
+    });
+}
+/** check whether a given identity source's database and store both exist,
+ *  without creating or upgrading anything. */
+export async function identitySourceAvailable(source) {
+    const db = await openExistingDatabase(source.databaseName);
+    if (!db)
+        return false;
+    const has = db.objectStoreNames.contains(source.storeName);
+    db.close();
+    return has;
+}
+function getRecord(db, storeName, key) {
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(storeName, "readonly");
+        const req = tx.objectStore(storeName).get(key);
+        req.onsuccess = () => resolve(req.result ?? null);
+        req.onerror = () => reject(req.error);
+    });
+}
+function putRecord(db, storeName, key, value) {
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(storeName, "readwrite");
+        const req = tx.objectStore(storeName).put(value, key);
+        req.onsuccess = () => resolve();
+        req.onerror = () => reject(req.error);
+    });
+}
+/**
+ * read an identity record from a source, without creating or upgrading its
+ * database. returns null if the database, store, or record is absent.
+ */
+export async function readIdentityFrom(source) {
+    const db = await openExistingDatabase(source.databaseName);
+    if (!db)
+        return null;
+    try {
+        if (!db.objectStoreNames.contains(source.storeName))
+            return null;
+        return await getRecord(db, source.storeName, source.key ?? DEFAULT_KEY);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * write an identity record to a source. the database and store must already
+ * exist (this never creates or upgrades a database it doesn't own).
+ */
+export async function writeIdentityTo(source, identity) {
+    const db = await openExistingDatabase(source.databaseName);
+    if (!db || !db.objectStoreNames.contains(source.storeName)) {
+        db?.close();
+        throw new Error(`identity source "${source.databaseName}" (store "${source.storeName}") does not exist`);
+    }
+    try {
+        await putRecord(db, source.storeName, source.key ?? DEFAULT_KEY, identity);
+    }
+    finally {
+        db.close();
+    }
+}
+async function openAtCurrentVersion(databaseName) {
+    return new Promise((resolve, reject) => {
+        const req = indexedDB.open(databaseName);
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+    });
+}
+function openWithStoreCreated(databaseName, version, storeName) {
+    return new Promise((resolve, reject) => {
+        const req = indexedDB.open(databaseName, version);
+        req.onupgradeneeded = () => {
+            const db = req.result;
+            if (!db.objectStoreNames.contains(storeName)) {
+                db.createObjectStore(storeName);
+            }
+        };
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+    });
+}
+async function openOrCreateDatabase(databaseName, storeName) {
+    const db = await openAtCurrentVersion(databaseName);
+    if (db.objectStoreNames.contains(storeName))
+        return db;
+    const nextVersion = db.version + 1;
+    db.close();
+    return openWithStoreCreated(databaseName, nextVersion, storeName);
+}
+/**
+ * an identity store backed by its own dedicated idb database/store, created
+ * on demand. suitable as an app's local, always-available identity store -
+ * the store the cross-app resolution in resolve.ts falls back to when no
+ * other source has an identity yet.
+ */
+export function createIdbIdentityStore(source) {
+    const key = source.key ?? DEFAULT_KEY;
+    return {
+        async get() {
+            const db = await openOrCreateDatabase(source.databaseName, source.storeName);
+            try {
+                return await getRecord(db, source.storeName, key);
+            }
+            finally {
+                db.close();
+            }
+        },
+        async set(identity) {
+            const db = await openOrCreateDatabase(source.databaseName, source.storeName);
+            try {
+                await putRecord(db, source.storeName, key, identity);
+            }
+            finally {
+                db.close();
+            }
+        },
+    };
+}

package/dist/identity/idbStore.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=idbStore.test.d.ts.map

package/dist/identity/idbStore.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idbStore.test.d.ts","sourceRoot":"","sources":["../../src/identity/idbStore.test.ts"],"names":[],"mappings":""}

package/dist/identity/idbStore.test.js

@@ -0,0 +1,103 @@
+import { IDBFactory } from "fake-indexeddb";
+import { beforeEach, describe, expect, it } from "vitest";
+import { createIdbIdentityStore, databaseExists, identitySourceAvailable, openExistingDatabase, readIdentityFrom, writeIdentityTo, } from "./idbStore.js";
+function makeIdentity(nodeId = "node-abc") {
+    return {
+        secret_key: new Uint8Array([1, 2, 3]),
+        node_id: nodeId,
+        created_at: 1000,
+    };
+}
+beforeEach(() => {
+    // fresh, isolated indexedDB per test
+    globalThis.indexedDB = new IDBFactory();
+});
+describe("createIdbIdentityStore", () => {
+    it("returns null when nothing has been stored yet", async () => {
+        const store = createIdbIdentityStore({
+            databaseName: "app-db",
+            storeName: "identity",
+        });
+        expect(await store.get()).toBeNull();
+    });
+    it("creates the database and store lazily, round-tripping an identity", async () => {
+        const store = createIdbIdentityStore({
+            databaseName: "app-db",
+            storeName: "identity",
+        });
+        const identity = makeIdentity("node-1");
+        await store.set(identity);
+        const result = await store.get();
+        expect(result).toEqual(identity);
+    });
+    it("supports a custom record key", async () => {
+        const store = createIdbIdentityStore({
+            databaseName: "app-db",
+            storeName: "identity",
+            key: "custom-key",
+        });
+        const identity = makeIdentity("node-2");
+        await store.set(identity);
+        expect(await readIdentityFrom({
+            databaseName: "app-db",
+            storeName: "identity",
+            key: "custom-key",
+        })).toEqual(identity);
+    });
+    it("reuses the same database across separate store instances", async () => {
+        const first = createIdbIdentityStore({ databaseName: "shared-db", storeName: "identity" });
+        await first.set(makeIdentity("node-shared"));
+        const second = createIdbIdentityStore({ databaseName: "shared-db", storeName: "identity" });
+        expect(await second.get()).toEqual(makeIdentity("node-shared"));
+    });
+});
+describe("databaseExists / openExistingDatabase", () => {
+    it("reports false for a database that was never created", async () => {
+        expect(await databaseExists("nope")).toBe(false);
+        expect(await openExistingDatabase("nope")).toBeNull();
+    });
+    it("reports true once a database has actually been created", async () => {
+        const store = createIdbIdentityStore({ databaseName: "real-db", storeName: "identity" });
+        await store.set(makeIdentity());
+        expect(await databaseExists("real-db")).toBe(true);
+        const db = await openExistingDatabase("real-db");
+        expect(db).not.toBeNull();
+        db?.close();
+    });
+    it("never leaves behind a database after a failed existence check", async () => {
+        await databaseExists("probed-only");
+        expect(await databaseExists("probed-only")).toBe(false);
+    });
+});
+describe("identitySourceAvailable / readIdentityFrom / writeIdentityTo", () => {
+    it("is unavailable when the database does not exist", async () => {
+        const source = { databaseName: "missing-db", storeName: "identity" };
+        expect(await identitySourceAvailable(source)).toBe(false);
+        expect(await readIdentityFrom(source)).toBeNull();
+    });
+    it("is unavailable when the database exists but lacks the store", async () => {
+        const store = createIdbIdentityStore({ databaseName: "other-db", storeName: "other-store" });
+        await store.set(makeIdentity());
+        const source = { databaseName: "other-db", storeName: "identity" };
+        expect(await identitySourceAvailable(source)).toBe(false);
+        expect(await readIdentityFrom(source)).toBeNull();
+    });
+    it("reads an identity once the database and store exist", async () => {
+        const store = createIdbIdentityStore({ databaseName: "seeded-db", storeName: "identity" });
+        const identity = makeIdentity("node-seeded");
+        await store.set(identity);
+        const source = { databaseName: "seeded-db", storeName: "identity" };
+        expect(await identitySourceAvailable(source)).toBe(true);
+        expect(await readIdentityFrom(source)).toEqual(identity);
+    });
+    it("writeIdentityTo refuses to create a missing database", async () => {
+        await expect(writeIdentityTo({ databaseName: "missing-db", storeName: "identity" }, makeIdentity())).rejects.toThrow(/does not exist/);
+    });
+    it("writeIdentityTo updates an existing source in place", async () => {
+        const store = createIdbIdentityStore({ databaseName: "writable-db", storeName: "identity" });
+        await store.set(makeIdentity("node-original"));
+        const source = { databaseName: "writable-db", storeName: "identity" };
+        await writeIdentityTo(source, makeIdentity("node-updated"));
+        expect((await readIdentityFrom(source))?.node_id).toBe("node-updated");
+    });
+});

package/dist/identity/index.d.ts

@@ -0,0 +1,8 @@
+export type { IdentityStore, P2PIdentity } from "./types.js";
+export type { IdentitySource } from "./idbStore.js";
+export { createIdbIdentityStore, databaseExists, identitySourceAvailable, openExistingDatabase, readIdentityFrom, writeIdentityTo, } from "./idbStore.js";
+export type { ResolveIdentityOptions } from "./resolve.js";
+export { persistIdentity, resolveIdentity } from "./resolve.js";
+export type { AcquireNodeLeadershipOpts } from "./webLocks.js";
+export { acquireNodeLeadership, LOCK_NAME } from "./webLocks.js";
+//# sourceMappingURL=index.d.ts.map