keri-ts 1.0.0 → 2.0.1

package/esm/keri/npm/src/db/payload-store.js

@@ -1,406 +0,0 @@
-import * as dntShim from "../_dnt.shims.js";
-import { join, resolve } from "../deps/jsr.io/@std/path/1.1.6/mod.js";
-/** Complete partial writes without retaining or queueing additional chunks. */
-export async function writePayloadChunk(writer, chunk, signal) {
-    let offset = 0;
-    while (offset < chunk.length) {
-        signal?.throwIfAborted();
-        const bytesWritten = await writer.write(chunk.subarray(offset));
-        if (bytesWritten <= 0 || bytesWritten > chunk.length - offset)
-            throw new Error("Invalid payload write progress");
-        offset += bytesWritten;
-    }
-    signal?.throwIfAborted();
-}
-/** Private staged files and explicitly promoted objects, with no database policy. */
-export class PayloadStore {
-    /** Bind a store directory and bounded reader allocation size. */
-    constructor(root, chunkSize = 65536) {
-        Object.defineProperty(this, "chunkSize", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: chunkSize
-        });
-        /** Canonical store root used for all private staging and object paths. */
-        Object.defineProperty(this, "root", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        /** Only unfinished stages remain store-owned and are aborted on close. */
-        Object.defineProperty(this, "sinks", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Set()
-        });
-        /** Prevent new stages or opens after shutdown begins. */
-        Object.defineProperty(this, "closed", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: false
-        });
-        if (!Number.isSafeInteger(chunkSize) || chunkSize < 1)
-            throw new RangeError("Invalid payload read chunk size");
-        this.root = resolve(root);
-    }
-    /** Open one exclusively created stage. Await every write. */
-    async stage(signal) {
-        if (this.closed)
-            throw new Error("Payload store is closed");
-        signal?.throwIfAborted();
-        await dntShim.Deno.mkdir(join(this.root, "staging"), { recursive: true, mode: 0o700 });
-        // The final content/owner identity is unavailable while the stream is incomplete.
-        const id = crypto.randomUUID();
-        const path = join(this.root, "staging", id);
-        const file = await dntShim.Deno.open(path, { write: true, createNew: true, mode: 0o600 });
-        const sink = new FileSink(file, path, signal, (size) => {
-            this.sinks.delete(sink);
-            return new FileValue(this.root, id, size, this.chunkSize, true);
-        }, () => {
-            this.sinks.delete(sink);
-        });
-        this.sinks.add(sink);
-        if (this.closed || signal?.aborted) {
-            await sink.abort();
-            signal?.throwIfAborted();
-            throw new Error("Payload store is closed");
-        }
-        return sink;
-    }
-    /** Reopen one promoted file; untrusted IDs cannot address arbitrary paths. */
-    async open(id) {
-        if (this.closed)
-            throw new Error("Payload store is closed");
-        checkPayloadId(id);
-        const file = await dntShim.Deno.open(join(this.root, "objects", id), { read: true });
-        try {
-            const stat = await file.stat();
-            if (!stat.isFile || !Number.isSafeInteger(stat.size))
-                throw new Error("Invalid payload file");
-            return new FileValue(this.root, id, stat.size, this.chunkSize, false);
-        }
-        finally {
-            file.close();
-        }
-    }
-    /** Identify an owned local file without exposing filesystem paths. */
-    owns(payload) {
-        return payload instanceof FileValue && payload.belongsTo(this.root);
-    }
-    /** Transfer a local handle to a new owner while keeping existing read views usable. */
-    adopt(payload) {
-        if (this.closed)
-            throw new Error("Payload store is closed");
-        if (!(payload instanceof FileValue) || !payload.belongsTo(this.root)) {
-            throw new TypeError("Payload belongs to another store");
-        }
-        return payload.transfer();
-    }
-    /** Abort unfinished writes only; completed files have transferred to callers. */
-    async close() {
-        this.closed = true;
-        await Promise.all([...this.sinks].map((sink) => sink.abort()));
-    }
-}
-/** A finished stage or promoted object; each read owns its own file descriptor. */
-class FileValue {
-    /** Represent one completed file without taking ownership of any reader descriptor. */
-    constructor(root, id, size, chunkSize, staged, state) {
-        Object.defineProperty(this, "root", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: root
-        });
-        Object.defineProperty(this, "size", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: size
-        });
-        Object.defineProperty(this, "chunkSize", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: chunkSize
-        });
-        /** Revokes only mutation rights after another owner adopts this handle. */
-        Object.defineProperty(this, "transferred", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: false
-        });
-        /** Shared identity and location keep borrowed views valid after owner publication. */
-        Object.defineProperty(this, "state", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.state = state ?? { id, staged, removed: false, busy: false };
-    }
-    /** Resolve the current final identity through the shared owner state. */
-    get id() {
-        return this.state.id;
-    }
-    /** Test private store provenance without exposing filesystem paths. */
-    belongsTo(root) {
-        return this.root === root;
-    }
-    /** Move mutation rights to a new handle sharing the same file lifetime. */
-    transfer() {
-        this.checkOwner();
-        this.transferred = true;
-        return new FileValue(this.root, this.id, this.size, this.chunkSize, this.state.staged, this.state);
-    }
-    /** Resolve the current stage/object location after any completed promotion. */
-    get path() {
-        return join(this.root, this.state.staged ? "staging" : "objects", this.id);
-    }
-    /** Reopen from byte zero and release the descriptor on return, failure, or cancellation. */
-    async *open(signal) {
-        this.check();
-        signal?.throwIfAborted();
-        const file = await dntShim.Deno.open(this.path, { read: true });
-        try {
-            let offset = 0;
-            while (offset < this.size) {
-                signal?.throwIfAborted();
-                const bytes = new Uint8Array(Math.min(this.chunkSize, this.size - offset));
-                const bytesRead = await file.read(bytes);
-                signal?.throwIfAborted();
-                if (bytesRead === null || bytesRead === 0)
-                    throw new Error("Payload file is shorter than declared size");
-                offset += bytesRead;
-                yield bytes.subarray(0, bytesRead);
-            }
-        }
-        finally {
-            file.close();
-        }
-    }
-    /** Publish a completed file under its final identity without overwriting another owner. */
-    async promote(id) {
-        this.checkOwner();
-        checkPayloadId(id);
-        if (!this.state.staged) {
-            if (id !== this.id)
-                throw new Error("Payload is already promoted under another ID");
-            return;
-        }
-        this.state.busy = true;
-        try {
-            await dntShim.Deno.mkdir(join(this.root, "objects"), { recursive: true, mode: 0o700 });
-            const stage = this.path;
-            // Linking publishes the complete file atomically and rejects an existing ID.
-            await dntShim.Deno.link(stage, join(this.root, "objects", id));
-            this.state.id = id;
-            this.state.staged = false;
-            await dntShim.Deno.remove(stage);
-        }
-        finally {
-            this.state.busy = false;
-        }
-    }
-    /** Remove this owned file once, rejecting concurrent ownership mutations. */
-    async discard() {
-        if (this.transferred || this.state.removed)
-            return;
-        this.checkOwner();
-        this.state.busy = true;
-        try {
-            await dntShim.Deno.remove(this.path);
-            this.state.removed = true;
-        }
-        finally {
-            this.state.busy = false;
-        }
-    }
-    /** Reject mutation by a stale transferred handle before inspecting file state. */
-    checkOwner() {
-        if (this.transferred)
-            throw new Error("Payload ownership was transferred");
-        this.check();
-    }
-    /** Ensure this file remains readable and is not changing ownership. */
-    check() {
-        if (this.state.removed || this.state.busy)
-            throw new Error("Payload file is removed or changing ownership");
-    }
-}
-/** One writer with no internal queue; abort waits for its active write to settle. */
-class FileSink {
-    /** Own one exclusive stage descriptor and its completion/cleanup callbacks. */
-    constructor(file, path, signal, completed, removed) {
-        Object.defineProperty(this, "file", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: file
-        });
-        Object.defineProperty(this, "path", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: path
-        });
-        Object.defineProperty(this, "signal", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: signal
-        });
-        Object.defineProperty(this, "completed", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: completed
-        });
-        Object.defineProperty(this, "removed", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: removed
-        });
-        /** Successfully written bytes, excluding a currently pending write. */
-        Object.defineProperty(this, "size", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0
-        });
-        /** Stage ownership moves exactly once to finished or aborted. */
-        Object.defineProperty(this, "state", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "open"
-        });
-        /** Single in-flight file operation; no unbounded internal write queue. */
-        Object.defineProperty(this, "active", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
-        /** Deno descriptors close synchronously and must not be closed twice. */
-        Object.defineProperty(this, "fileClosed", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: false
-        });
-        /** Reused abort completion prevents duplicate close/unlink operations. */
-        Object.defineProperty(this, "cleanup", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
-        /** Begin cleanup on cancellation without throwing from the event listener. */
-        Object.defineProperty(this, "cancel", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: () => {
-                void this.abort().catch(() => undefined);
-            }
-        });
-        signal?.addEventListener("abort", this.cancel, { once: true });
-    }
-    /** Await every partial write before accepting another chunk or finalizing. */
-    async write(chunk) {
-        this.check();
-        const writing = writePayloadChunk(this.file, chunk, this.signal);
-        this.active = writing;
-        try {
-            await writing;
-            if (this.state !== "open")
-                throw new Error("Payload sink is aborted");
-            this.size += chunk.length;
-        }
-        catch (error) {
-            this.active = null;
-            await this.abort();
-            throw error;
-        }
-        finally {
-            this.active = null;
-        }
-    }
-    /** Sync and close bytes, then transfer the completed file to its new owner. */
-    async finish() {
-        this.check();
-        const finishing = (async () => {
-            await this.file.sync();
-            this.closeFile();
-        })();
-        this.active = finishing;
-        try {
-            await finishing;
-            this.signal?.throwIfAborted();
-            if (this.state !== "open")
-                throw new Error("Payload sink is aborted");
-            this.state = "finished";
-            this.signal?.removeEventListener("abort", this.cancel);
-            return this.completed(this.size);
-        }
-        catch (error) {
-            this.active = null;
-            await this.abort();
-            throw error;
-        }
-        finally {
-            this.active = null;
-        }
-    }
-    /** Wait for active I/O before removing an unfinished stage exactly once. */
-    abort() {
-        if (this.state === "finished")
-            return Promise.resolve();
-        if (this.cleanup)
-            return this.cleanup;
-        this.state = "aborted";
-        this.signal?.removeEventListener("abort", this.cancel);
-        const active = this.active;
-        this.cleanup = (async () => {
-            try {
-                await active?.catch(() => undefined);
-                this.closeFile();
-            }
-            finally {
-                try {
-                    await dntShim.Deno.remove(this.path);
-                }
-                finally {
-                    this.removed();
-                }
-            }
-        })();
-        return this.cleanup;
-    }
-    /** Close exactly once, including cancellation racing a completed fsync. */
-    closeFile() {
-        if (this.fileClosed)
-            return;
-        this.fileClosed = true;
-        this.file.close();
-    }
-    /** Reject cancellation, overlapping operations, and closed stage access. */
-    check() {
-        this.signal?.throwIfAborted();
-        if (this.state !== "open" || this.active)
-            throw new Error("Payload sink is closed or has an active operation");
-    }
-}
-/** Accept a flat SAID/digest name, optionally scoped by dot-separated owner segments. */
-function checkPayloadId(id) {
-    if (id.length > 240 || !/^[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*$/.test(id)) {
-        throw new TypeError("Invalid payload ID");
-    }
-}

package/esm/keri/npm/src/db/payload-view.js

@@ -1,23 +0,0 @@
-/** A non-owning bounded range; reopening never retains its owner's full byte array. */
-export function payloadRange(payload, offset) {
-    if (!Number.isSafeInteger(offset) || offset < 0 || offset > payload.size) {
-        throw new RangeError("Invalid payload offset");
-    }
-    return {
-        size: payload.size - offset,
-        /** Reopen the source and skip chunks until the requested range begins. */
-        async *open(signal) {
-            let skip = offset;
-            for await (const chunk of payload.open(signal)) {
-                if (skip >= chunk.length) {
-                    skip -= chunk.length;
-                    continue;
-                }
-                yield chunk.subarray(skip);
-                skip = 0;
-            }
-            if (skip)
-                throw new Error("Payload ended before its declared offset");
-        },
-    };
-}

package/esm/keri/npm/src/db/verifier-cueing.js

@@ -1,132 +0,0 @@
-/**
- * Sally-like verifier communication cue database.
- *
- * This sidecar intentionally stays outside the KERIpy `Reger` namespace. The
- * VDR stores remain byte-compatible with KERIpy, while verifier webhook retry
- * and ack state lives in this operational database.
- */
-import { Dater, Prefixer, SerderACDC } from "cesr-ts";
-import { DatabaseNotOpenError } from "../core/errors.js";
-import { LMDBer } from "./core/lmdber.js";
-import { CesrSuber, SerderSuber } from "./subing.js";
-/** Durable cue DB matching Sally's `CueBaser` store layout. */
-export class VerifierCueBaser extends LMDBer {
-    constructor(options = {}) {
-        const compat = options.compat ?? false;
-        super(options, {
-            tailDirPath: VerifierCueBaser.TailDirPath,
-            cleanTailDirPath: "keri/clean/verifier",
-            altTailDirPath: compat ? VerifierCueBaser.CompatAltTailDirPath : VerifierCueBaser.AltTailDirPath,
-            altCleanTailDirPath: compat ? ".keri/clean/verifier" : ".tufa/clean/verifier",
-            tempPrefix: VerifierCueBaser.TempPrefix,
-        });
-        Object.defineProperty(this, "snd", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "iss", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "rev", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "recv", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "revk", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "ack", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "rack", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-    }
-    *reopen(options = {}) {
-        const opened = yield* super.reopen(options);
-        if (!opened) {
-            return false;
-        }
-        this.snd = new CesrSuber(this, { subkey: "snd.", ctor: Prefixer });
-        this.iss = new CesrSuber(this, { subkey: "iss.", ctor: Dater });
-        this.rev = new CesrSuber(this, { subkey: "rev.", ctor: Dater });
-        this.recv = new SerderSuber(this, { subkey: "recv", ctor: SerderACDC });
-        this.revk = new SerderSuber(this, { subkey: "revk", ctor: SerderACDC });
-        this.ack = new SerderSuber(this, { subkey: "ack", ctor: SerderACDC });
-        this.rack = new SerderSuber(this, { subkey: "rack", ctor: SerderACDC });
-        return true;
-    }
-    clearEscrows() {
-        this.iss.trim();
-        this.rev.trim();
-        this.recv.trim();
-        this.revk.trim();
-        this.ack.trim();
-        this.rack.trim();
-    }
-    getCounts() {
-        return {
-            senders: this.snd.cntAll(),
-            iss: this.iss.cntAll(),
-            rev: this.rev.cntAll(),
-            recv: this.recv.cntAll(),
-            revk: this.revk.cntAll(),
-            ack: this.ack.cntAll(),
-            rack: this.rack.cntAll(),
-        };
-    }
-}
-Object.defineProperty(VerifierCueBaser, "TailDirPath", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: "keri/verifier"
-});
-Object.defineProperty(VerifierCueBaser, "AltTailDirPath", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: ".tufa/verifier"
-});
-Object.defineProperty(VerifierCueBaser, "CompatAltTailDirPath", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: ".keri/verifier"
-});
-Object.defineProperty(VerifierCueBaser, "TempPrefix", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: "keri_verifier_"
-});
-/** Open a verifier cue sidecar and return the ready-to-use databaser. */
-export function* createVerifierCueBaser(options = {}) {
-    const cdb = new VerifierCueBaser(options);
-    const opened = yield* cdb.reopen(options);
-    if (!opened) {
-        throw new DatabaseNotOpenError("Failed to open VerifierCueBaser");
-    }
-    return cdb;
-}