keri-ts 0.11.0 → 2.0.0

package/esm/keri/npm/src/app/signaling.js

@@ -1,388 +0,0 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _Signal_raw, _Signal_pad, _Signal_ckey, _Signal_immutable;
-import { MtrDex, ResourceAdmissionError, ResourceLimitError, ResourcePolicy, Salter, } from "cesr-ts";
-import { runtimeTurn } from "./runtime-turn.js";
-const textEncoder = new TextEncoder();
-const textDecoder = new TextDecoder();
-function randomNonce() {
-    const raw = crypto.getRandomValues(new Uint8Array(16));
-    return new Salter({ code: MtrDex.Salt_128, raw }).qb64;
-}
-function encodePad(pad) {
-    return textEncoder.encode(JSON.stringify(pad));
-}
-function decodePad(raw) {
-    return JSON.parse(textDecoder.decode(raw));
-}
-/**
- * Transient host signal matching the KERIpy `Signal` pad shape.
- *
- * Unlike `Notice`, this is not durably stored. Hosts use it as a reload hint.
- */
-export class Signal {
-    constructor(init) {
-        _Signal_raw.set(this, void 0);
-        _Signal_pad.set(this, void 0);
-        _Signal_ckey.set(this, void 0);
-        _Signal_immutable.set(this, false);
-        if ("raw" in init) {
-            __classPrivateFieldSet(this, _Signal_ckey, init.ckey, "f");
-            this.raw = init.raw;
-            return;
-        }
-        __classPrivateFieldSet(this, _Signal_ckey, init.ckey, "f");
-        this.pad = init.pad;
-    }
-    /** Inspect backing before copying a finite seed signal. */
-    get rawByteLength() {
-        return __classPrivateFieldGet(this, _Signal_raw, "f").byteLength;
-    }
-    get raw() {
-        return new Uint8Array(__classPrivateFieldGet(this, _Signal_raw, "f"));
-    }
-    set raw(raw) {
-        if (__classPrivateFieldGet(this, _Signal_immutable, "f"))
-            throw new Error("Queued signals are immutable");
-        this.pad = decodePad(raw);
-    }
-    get pad() {
-        return {
-            ...__classPrivateFieldGet(this, _Signal_pad, "f"),
-            a: { ...__classPrivateFieldGet(this, _Signal_pad, "f").a },
-        };
-    }
-    set pad(pad) {
-        if (__classPrivateFieldGet(this, _Signal_immutable, "f"))
-            throw new Error("Queued signals are immutable");
-        const normalized = {
-            i: typeof pad.i === "string" && pad.i.length > 0 ? pad.i : randomNonce(),
-            dt: typeof pad.dt === "string" && pad.dt.length > 0
-                ? pad.dt
-                : new Date().toISOString(),
-            r: pad.r,
-            a: { ...pad.a },
-        };
-        __classPrivateFieldSet(this, _Signal_pad, normalized, "f");
-        __classPrivateFieldSet(this, _Signal_raw, encodePad(normalized), "f");
-    }
-    get rid() {
-        return __classPrivateFieldGet(this, _Signal_pad, "f").i;
-    }
-    get datetime() {
-        return __classPrivateFieldGet(this, _Signal_pad, "f").dt;
-    }
-    get topic() {
-        return __classPrivateFieldGet(this, _Signal_pad, "f").r;
-    }
-    get attrs() {
-        return { ...__classPrivateFieldGet(this, _Signal_pad, "f").a };
-    }
-    get ckey() {
-        return __classPrivateFieldGet(this, _Signal_ckey, "f");
-    }
-    asDict() {
-        return this.pad;
-    }
-    /** Snapshot and freeze a method-managed ping; caller input and queued state never share mutable children. */
-    freeze() {
-        __classPrivateFieldSet(this, _Signal_pad, decodePad(__classPrivateFieldGet(this, _Signal_raw, "f")), "f");
-        const freeze = (value) => {
-            if (value === null || typeof value !== "object")
-                return;
-            for (const child of Object.values(value))
-                freeze(child);
-            Object.freeze(value);
-        };
-        freeze(__classPrivateFieldGet(this, _Signal_pad, "f"));
-        __classPrivateFieldSet(this, _Signal_immutable, true, "f");
-        return this;
-    }
-}
-_Signal_raw = new WeakMap(), _Signal_pad = new WeakMap(), _Signal_ckey = new WeakMap(), _Signal_immutable = new WeakMap();
-export function signal(attrs, topic, options = {}) {
-    const dt = typeof options.dt === "string"
-        ? options.dt
-        : options.dt?.toISOString();
-    return new Signal({
-        pad: {
-            i: "",
-            dt,
-            r: topic,
-            a: attrs,
-        },
-        ckey: options.ckey,
-    });
-}
-const signalNodes = 4096;
-/** Bound this signal's plain JSON before stringify; no accessors, custom serializers or retained input aliases. */
-function checkSignalJson(value, maxBytes) {
-    let bytes = 256, nodes = 0;
-    const ancestors = new Set();
-    const visit = (current, depth) => {
-        if (++nodes > signalNodes || depth > 64)
-            throw new ResourceLimitError("Signal JSON inspection exceeds policy");
-        if (typeof current === "string")
-            bytes += 6 * current.length + 2;
-        else if (current === null || current === undefined || typeof current === "number" || typeof current === "boolean") {
-            bytes += 32;
-        }
-        else if (typeof current === "object") {
-            if (ancestors.has(current))
-                throw new TypeError("Circular signal JSON");
-            const array = Array.isArray(current);
-            const prototype = Object.getPrototypeOf(current);
-            if (prototype !== null && prototype !== Object.prototype && prototype !== Array.prototype) {
-                throw new RangeError("Signal attributes require plain JSON values");
-            }
-            ancestors.add(current);
-            try {
-                if (array) {
-                    if (current.length > signalNodes - nodes) {
-                        throw new ResourceLimitError("Signal JSON inspection exceeds policy");
-                    }
-                    for (let index = 0; index < current.length; index++) {
-                        const descriptor = Object.getOwnPropertyDescriptor(current, index);
-                        if (descriptor && !Object.hasOwn(descriptor, "value")) {
-                            throw new RangeError("Signal accessors are unsupported");
-                        }
-                        bytes += 2;
-                        visit(descriptor?.value ?? null, depth + 1);
-                    }
-                }
-                else {
-                    for (const key in current) {
-                        if (!Object.hasOwn(current, key))
-                            continue;
-                        const descriptor = Object.getOwnPropertyDescriptor(current, key);
-                        if (!Object.hasOwn(descriptor, "value"))
-                            throw new RangeError("Signal accessors are unsupported");
-                        bytes += 6 * key.length + 5;
-                        visit(descriptor.value, depth + 1);
-                    }
-                }
-            }
-            finally {
-                ancestors.delete(current);
-            }
-        }
-        else
-            throw new RangeError("Signal attributes require plain JSON values");
-        if (bytes > maxBytes)
-            throw new ResourceLimitError("Signal exceeds conservative JSON byte ceiling");
-    };
-    visit(value, 0);
-}
-/** Existing transient signal queue; immutable method-managed entries retain shared credit until retirement. */
-export class Signaler {
-    constructor({ signals = [], signalTimeoutMs = Signaler.SignalTimeoutMs, resources = new ResourcePolicy(), maxSignals = 1024, maxSignalBytes = 64 * 1024, } = {}) {
-        Object.defineProperty(this, "signalTimeoutMs", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "maxSignals", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "maxSignalBytes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "resources", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "queued", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: []
-        });
-        Object.defineProperty(this, "reservations", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Map()
-        });
-        Object.defineProperty(this, "pending", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "closed", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: false
-        });
-        if (!Number.isSafeInteger(maxSignals) || maxSignals < 0 || !Number.isSafeInteger(maxSignalBytes) || maxSignalBytes < 1
-            || !Number.isFinite(signalTimeoutMs) || signalTimeoutMs < 0)
-            throw new RangeError("Invalid signal limits");
-        this.resources = resources;
-        this.maxSignals = maxSignals;
-        this.maxSignalBytes = maxSignalBytes;
-        this.signalTimeoutMs = signalTimeoutMs;
-        try {
-            for (const seed of signals) {
-                const prepared = this.prepareValue(() => {
-                    if (seed.rawByteLength > this.maxSignalBytes) {
-                        throw new ResourceLimitError("Seed signal exceeds byte ceiling");
-                    }
-                    checkSignalJson(seed.pad, this.maxSignalBytes);
-                    return new Signal({ raw: seed.raw, ckey: seed.ckey });
-                });
-                try {
-                    prepared.publish();
-                }
-                finally {
-                    prepared.release();
-                }
-            }
-        }
-        catch (error) {
-            this.close();
-            throw error;
-        }
-    }
-    /** Borrowed readonly queue view; arbitrary external mutation or retention is outside managed admission. */
-    get signals() {
-        return this.queued;
-    }
-    /** Admit slot/inspection/copy credit before invoking a finite producer or constructing its ping. */
-    prepare(attrs, topic, options = {}) {
-        return this.prepareValue(() => {
-            const value = typeof attrs === "function" ? attrs() : attrs;
-            const dt = typeof options.dt === "string" ? options.dt : options.dt?.toISOString();
-            checkSignalJson({ a: value, r: topic, dt: dt ?? "", ckey: options.ckey ?? "" }, this.maxSignalBytes);
-            return signal(value, topic, { ...options, dt });
-        }, options.ckey);
-    }
-    prepareValue(create, ckey) {
-        if (this.closed)
-            throw new Error("Signaler is closed");
-        if (this.pending)
-            throw new ResourceAdmissionError("Signal preparation is occupied", "busy");
-        if (this.maxSignals === 0)
-            throw new ResourceLimitError("Signal item capacity is zero");
-        const replacing = ckey !== undefined ? this.queued.find((current) => current.ckey === ckey) : undefined;
-        if (!replacing && this.queued.length >= this.maxSignals) {
-            throw new ResourceAdmissionError("Signal item capacity is occupied", "busy");
-        }
-        // Whole finite constructor allowance: JSON text/raw/snapshot copies and bounded inspection metadata.
-        const credit = this.resources.reserve({ bytes: 8 * this.maxSignalBytes + 128 * signalNodes + 16384 });
-        if (credit.kind === "refuse") {
-            throw new ResourceAdmissionError(`Signal byte admission refused: ${credit.reason}`, credit.reason);
-        }
-        let state = "prepared";
-        const release = () => {
-            if (state !== "prepared")
-                return;
-            state = "released";
-            this.pending = undefined;
-            credit.reservation.release();
-        };
-        this.pending = { release };
-        try {
-            const created = create().freeze();
-            if (state !== "prepared" || this.closed)
-                throw new Error("Signal preparation was closed");
-            return {
-                signal: created,
-                release,
-                publish: () => {
-                    if (state !== "prepared" || this.closed)
-                        throw new Error("Signal preparation is no longer publishable");
-                    const index = replacing ? this.queued.indexOf(replacing) : -1;
-                    if (index >= 0)
-                        this.queued.splice(index, 1, created);
-                    else
-                        this.queued.push(created);
-                    this.reservations.set(created, credit.reservation);
-                    state = "published";
-                    this.pending = undefined;
-                    if (index >= 0)
-                        this.retire(replacing);
-                },
-            };
-        }
-        catch (error) {
-            release();
-            throw error;
-        }
-    }
-    /** Prepare and immediately publish one transient wakeup. */
-    push(attrs, topic, options = {}) {
-        const prepared = this.prepare(attrs, topic, options);
-        try {
-            prepared.publish();
-            return prepared.signal;
-        }
-        finally {
-            prepared.release();
-        }
-    }
-    list() {
-        return this.queued.map((current) => new Signal({ raw: current.raw, ckey: current.ckey }));
-    }
-    count() {
-        return this.queued.length;
-    }
-    retire(current) {
-        this.reservations.get(current)?.release();
-        this.reservations.delete(current);
-    }
-    processOnce(now = Date.now()) {
-        const before = this.queued.length;
-        for (let index = this.queued.length - 1; index >= 0; index--) {
-            const current = this.queued[index];
-            const time = new Date(current.datetime).getTime();
-            if (Number.isNaN(time) || now - time > this.signalTimeoutMs) {
-                this.queued.splice(index, 1);
-                this.retire(current);
-            }
-        }
-        return before - this.queued.length;
-    }
-    /** Drop only transient wakeups, releasing their credit exactly once. */
-    clear() {
-        for (const current of this.queued)
-            this.retire(current);
-        this.queued.length = 0;
-    }
-    /** Close this owned producer and release queued and unpublished preparation. */
-    close() {
-        this.closed = true;
-        this.pending?.release();
-        this.clear();
-    }
-    *signalDo() {
-        while (true) {
-            this.processOnce();
-            yield* runtimeTurn();
-        }
-    }
-}
-Object.defineProperty(Signaler, "SignalTimeoutMs", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: 10 * 60 * 1000
-});

package/esm/keri/npm/src/app/stored-replies.js

@@ -1,85 +0,0 @@
-/** Finite stored endpoint-reply reconstruction; current proof rows are borrowed only during this synchronous call. */
-import { b, Cigar, Diger, Prefixer, ResourceLimitError, Seqner, SerderKERI } from "cesr-ts";
-import { attachmentCounterQb64b, resolveAttachmentGvrsn } from "../core/attachment-countering.js";
-import { TransIdxSigGroup } from "../core/dispatch.js";
-import { DatabaseOperationError } from "../core/errors.js";
-import { messagize } from "../core/protocol-serialization.js";
-/**
- * Rebuild one persisted reply with all stored groups and exactly one optional cigar.
- *
- * Missing bodies return empty bytes. Limit refusals precede retention growth or final
- * serialization; native proof decoding/copy admission remains a separate boundary.
- */
-export function loadStoredReply(db, said, limits = {}) {
-    const maxBytes = limits.maxMessageBytes ?? 8 * 1024 * 1024;
-    const maxRows = limits.maxProofRows ?? 4096;
-    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1 || !Number.isSafeInteger(maxRows) || maxRows < 0) {
-        throw new RangeError("Invalid stored reply limits");
-    }
-    const raw = db.getValBounded(db.rpys.sdb, b(said), maxBytes);
-    if (!raw)
-        return new Uint8Array();
-    const serder = new SerderKERI({ raw });
-    let rows = 0, retainedBytes = raw.length;
-    const admit = (bytes) => {
-        if (++rows > maxRows || bytes > maxBytes - retainedBytes) {
-            throw new ResourceLimitError("Stored reply exceeds proof retention limits");
-        }
-        retainedBytes += bytes;
-    };
-    const groups = new Map();
-    for (const [keys, siger] of db.ssgs.getTopItemIter([said], { topive: true })) {
-        admit(siger.qb64.length);
-        const prefix = keys[1], snh = keys[2], digest = keys[3];
-        if (keys.length !== 4 || !prefix || !digest || !/^[0-9a-f]{1,32}$/.test(snh ?? "")) {
-            throw new DatabaseOperationError("Corrupt stored reply group key");
-        }
-        // Actual 714 fetchTsgs reconstructs stored seals in key order, without reopening establishment bodies.
-        const ordinal = new Seqner({
-            code: "0A",
-            raw: Uint8Array.from(snh.padStart(32, "0").match(/../g), (pair) => Number.parseInt(pair, 16)),
-        });
-        const key = `${prefix}.${snh}.${digest}`;
-        let group = groups.get(key);
-        if (!group) {
-            group = new TransIdxSigGroup(new Prefixer({ qb64: prefix }), ordinal, new Diger({ qb64: digest }), []);
-            groups.set(key, group);
-        }
-        group.sigers.push(siger);
-    }
-    // Existing TS rows use compact hex. Canonical ordering matches 714 fixed-width keys without rewriting storage.
-    const orderKey = (group) => `${group.pre}.${group.snh.padStart(32, "0")}.${group.said}`;
-    const ordered = [...groups.values()].sort((left, right) => {
-        const a = orderKey(left), b = orderKey(right);
-        return a < b ? -1 : a > b ? 1 : 0; // Stable raw-key ties preserve distinct original groups.
-    });
-    const gvrsn = resolveAttachmentGvrsn(serder, limits.gvrsn);
-    // Use the same counter codex/count rules as messagize, without constructing its proof payload.
-    const counterSize = (name, count, bytes) => attachmentCounterQb64b(name, gvrsn.major >= 2 ? bytes / 4 : count, gvrsn).length;
-    const requireWire = (footerBytes) => {
-        const framedBytes = raw.length + footerBytes
-            + attachmentCounterQb64b("AttachmentGroup", footerBytes / 4, gvrsn).length;
-        if (framedBytes > maxBytes)
-            throw new ResourceLimitError("Stored reply exceeds message byte limit");
-    };
-    let groupBytes = 0;
-    for (const group of groups.values()) {
-        const sigBytes = group.sigers.reduce((size, siger) => size + siger.qb64.length, 0);
-        groupBytes += group.prefixer.qb64.length + group.seqner.qb64.length + group.diger.qb64.length + sigBytes
-            + counterSize("ControllerIdxSigs", group.sigers.length, sigBytes);
-    }
-    const transferBytes = groups.size ? groupBytes + counterSize("TransIdxSigGroups", groups.size, groupBytes) : 0;
-    const cigars = [];
-    let cigarBytes = 0;
-    for (const tuple of db.scgs.getIter([said])) {
-        const bytes = tuple[0].qb64.length + tuple[1].qb64.length;
-        admit(bytes);
-        cigarBytes += bytes;
-        cigars.push(new Cigar(tuple[1], tuple[0]));
-    }
-    const selectedCigars = cigars.length === 1 ? cigars : [];
-    const cigarFooter = selectedCigars.length ? cigarBytes + counterSize("NonTransReceiptCouples", 1, cigarBytes) : 0;
-    if (groups.size || selectedCigars.length)
-        requireWire(transferBytes + cigarFooter);
-    return messagize(serder, { tsgs: ordered, cigars: selectedCigars, pipelined: true, gvrsn });
-}