@agent-teams/repository-mutation 0.0.0

package/dist/repository-mutation-envelope.js

@@ -0,0 +1,292 @@
+import { TextDecoder } from "node:util";
+import { canonicalJson, sha256Json } from "./canonical-json.js";
+import { parseStrictJson } from "./strict-json.js";
+export const REPOSITORY_MUTATION_ENVELOPE_FORMAT = "agent-teams.repository-mutation.transaction-envelope/v1";
+const maximumEnvelopeBytes = 32 * 1024 * 1024;
+const maximumDepth = 64;
+const maximumEntries = 100_000;
+const maximumStringLength = 1024 * 1024;
+const maximumIdentifierLength = 256;
+const maximumArtifactFieldLength = 1024;
+const sha256 = /^sha256:[0-9a-f]{64}$/u;
+const identifier = /^[\x21-\x7e]+$/u;
+const strictUtf8 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
+export class RepositoryMutationEnvelopeError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "RepositoryMutationEnvelopeError";
+    }
+}
+function fail(message) {
+    throw new RepositoryMutationEnvelopeError(message);
+}
+function record(value, subject) {
+    if (typeof value !== "object" || value === null || Array.isArray(value) ||
+        (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)) {
+        fail(`${subject} must be a plain object.`);
+    }
+    return value;
+}
+function exactKeys(value, expected, subject) {
+    const keys = Reflect.ownKeys(value);
+    if (keys.some((key) => typeof key !== "string") ||
+        keys.toSorted().join("\0") !== [...expected].toSorted().join("\0") ||
+        keys.some((key) => {
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            return descriptor === undefined || !("value" in descriptor) || descriptor.enumerable !== true;
+        })) {
+        fail(`${subject} has unknown or missing fields.`);
+    }
+}
+function boundedIdentifier(value, subject) {
+    if (typeof value !== "string" || value.length === 0 ||
+        value.length > maximumIdentifierLength || !identifier.test(value) ||
+        value.normalize("NFC") !== value) {
+        fail(`${subject} is invalid.`);
+    }
+    return value;
+}
+function positiveInteger(value, subject) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        fail(`${subject} must be a positive safe integer.`);
+    }
+    return value;
+}
+function artifact(value, subject) {
+    const candidate = record(value, subject);
+    exactKeys(candidate, ["buildIdentity", "name", "version"], subject);
+    if (typeof candidate["name"] !== "string" || candidate["name"].length === 0 ||
+        candidate["name"].length > maximumArtifactFieldLength ||
+        typeof candidate["version"] !== "string" || candidate["version"].length === 0 ||
+        candidate["version"].length > maximumArtifactFieldLength ||
+        candidate["name"].normalize("NFC") !== candidate["name"] ||
+        candidate["version"].normalize("NFC") !== candidate["version"] ||
+        !sha256.test(String(candidate["buildIdentity"]))) {
+        fail(`${subject} is invalid.`);
+    }
+    return {
+        name: candidate["name"],
+        version: candidate["version"],
+        buildIdentity: candidate["buildIdentity"]
+    };
+}
+function appendCanonicalArray(candidate, depth, pending) {
+    const keys = Reflect.ownKeys(candidate);
+    if (Object.getPrototypeOf(candidate) !== Array.prototype ||
+        keys.some((key) => typeof key !== "string" ||
+            (key !== "length" && !/^(?:0|[1-9][0-9]*)$/u.test(key))) ||
+        keys.length !== candidate.length + 1) {
+        fail("Repository Mutation payload contains a noncanonical array.");
+    }
+    for (let index = candidate.length - 1; index >= 0; index -= 1) {
+        const descriptor = Object.getOwnPropertyDescriptor(candidate, String(index));
+        if (descriptor === undefined || !("value" in descriptor) || !descriptor.enumerable) {
+            fail("Repository Mutation payload arrays must contain only dense enumerable data properties.");
+        }
+        pending.push({ value: descriptor.value, depth: depth + 1 });
+    }
+    return candidate.length;
+}
+function appendCanonicalObject(candidate, depth, pending) {
+    if (Object.getPrototypeOf(candidate) !== Object.prototype && Object.getPrototypeOf(candidate) !== null) {
+        fail("Repository Mutation payload objects must have a plain or null prototype.");
+    }
+    const keys = Reflect.ownKeys(candidate);
+    for (const key of keys) {
+        if (typeof key !== "string" || key.length > maximumStringLength || key.normalize("NFC") !== key) {
+            fail("Repository Mutation payload contains a noncanonical object key.");
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(candidate, key);
+        if (descriptor === undefined || !("value" in descriptor) || descriptor.enumerable !== true) {
+            fail("Repository Mutation payload objects must contain enumerable own data properties.");
+        }
+        pending.push({ value: descriptor.value, depth: depth + 1 });
+    }
+    return keys.length;
+}
+function canonicalPayload(value) {
+    let entries = 0;
+    const pending = [
+        { value, depth: 0 }
+    ];
+    while (pending.length > 0) {
+        const current = pending.pop();
+        if (current.depth > maximumDepth) {
+            fail("Repository Mutation payload is too deep.");
+        }
+        if (typeof current.value === "string") {
+            if (current.value.length > maximumStringLength) {
+                fail("Repository Mutation payload contains an oversized string.");
+            }
+            continue;
+        }
+        if (current.value === null || typeof current.value === "boolean") {
+            continue;
+        }
+        if (typeof current.value === "number") {
+            if (!Number.isSafeInteger(current.value) || Object.is(current.value, -0)) {
+                fail("Repository Mutation payload contains a noncanonical number.");
+            }
+            continue;
+        }
+        if (typeof current.value !== "object") {
+            fail("Repository Mutation payload is outside the canonical JSON data model.");
+        }
+        const candidate = current.value;
+        if (Array.isArray(candidate)) {
+            entries += appendCanonicalArray(candidate, current.depth, pending);
+        }
+        else {
+            entries += appendCanonicalObject(candidate, current.depth, pending);
+        }
+        if (entries > maximumEntries) {
+            fail("Repository Mutation payload has too many entries.");
+        }
+    }
+    // The leaf canonicalizer is the sole canonical serialization and digest authority.
+    canonicalJson(value);
+    return value;
+}
+function clone(value) {
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        const result = [];
+        for (let index = 0; index < value.length; index += 1) {
+            const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+            result.push(clone(descriptor.value));
+        }
+        return result;
+    }
+    const result = {};
+    for (const key of Object.keys(value)) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        result[key] = clone(descriptor.value);
+    }
+    return result;
+}
+function deepFreeze(value) {
+    const pending = [];
+    if (typeof value === "object" && value !== null) {
+        pending.push(value);
+    }
+    while (pending.length > 0) {
+        const current = pending.pop();
+        for (const child of Object.values(current)) {
+            if (typeof child === "object" && child !== null && !Object.isFrozen(child)) {
+                pending.push(child);
+            }
+        }
+        Object.freeze(current);
+    }
+    return value;
+}
+function compile(value) {
+    const ownerArtifact = artifact(value["ownerArtifact"], "Owner artifact identity");
+    const kernelArtifact = artifact(value["kernelArtifact"], "Kernel artifact identity");
+    const recoveryHandler = record(value["recoveryHandler"], "Recovery handler");
+    exactKeys(recoveryHandler, ["contractVersion", "id"], "Recovery handler");
+    const payload = clone(canonicalPayload(value["payload"]));
+    const body = {
+        schemaVersion: 6,
+        format: REPOSITORY_MUTATION_ENVELOPE_FORMAT,
+        operationKind: boundedIdentifier(value["operationKind"], "Operation kind"),
+        recoveryHandler: {
+            id: boundedIdentifier(recoveryHandler["id"], "Recovery handler id"),
+            contractVersion: positiveInteger(recoveryHandler["contractVersion"], "Recovery handler contract version")
+        },
+        ownerArtifact,
+        kernelArtifact,
+        adapterContractVersion: positiveInteger(value["adapterContractVersion"], "Adapter contract version"),
+        payloadKind: boundedIdentifier(value["payloadKind"], "Payload kind"),
+        state: boundedIdentifier(value["state"], "Envelope state"),
+        payload,
+        payloadDigest: sha256Json(payload)
+    };
+    return deepFreeze({
+        ...body,
+        envelopeDigest: sha256Json(body)
+    });
+}
+export function compileRepositoryMutationEnvelope(input) {
+    const candidate = record(input, "Repository Mutation envelope input");
+    exactKeys(candidate, [
+        "adapterContractVersion", "kernelArtifact", "operationKind", "ownerArtifact",
+        "payload", "payloadKind", "recoveryHandler", "state"
+    ], "Repository Mutation envelope input");
+    return compile(candidate);
+}
+function assertBoundedSourceDepth(source) {
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (const character of source) {
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (character === "\\") {
+                escaped = true;
+            }
+            else if (character === '"') {
+                inString = false;
+            }
+        }
+        else if (character === '"') {
+            inString = true;
+        }
+        else if (character === "{" || character === "[") {
+            depth += 1;
+            if (depth > maximumDepth + 1) {
+                fail("Repository Mutation envelope is too deep.");
+            }
+        }
+        else if (character === "}" || character === "]") {
+            depth -= 1;
+        }
+    }
+}
+export function parseRepositoryMutationEnvelope(bytes) {
+    if (!(bytes instanceof Uint8Array) || bytes.byteLength === 0 || bytes.byteLength > maximumEnvelopeBytes) {
+        fail("Repository Mutation envelope byte length is invalid.");
+    }
+    let value;
+    try {
+        const source = strictUtf8.decode(bytes);
+        assertBoundedSourceDepth(source);
+        value = parseStrictJson(source);
+    }
+    catch (error) {
+        if (error instanceof RepositoryMutationEnvelopeError) {
+            throw error;
+        }
+        throw new RepositoryMutationEnvelopeError("Repository Mutation envelope is not strict UTF-8 JSON.", { cause: error });
+    }
+    const candidate = record(value, "Repository Mutation envelope");
+    exactKeys(candidate, [
+        "adapterContractVersion", "envelopeDigest", "format", "kernelArtifact",
+        "operationKind", "ownerArtifact", "payload", "payloadDigest", "payloadKind",
+        "recoveryHandler", "schemaVersion", "state"
+    ], "Repository Mutation envelope");
+    if (candidate["schemaVersion"] !== 6 || candidate["format"] !== REPOSITORY_MUTATION_ENVELOPE_FORMAT ||
+        !sha256.test(String(candidate["payloadDigest"])) || !sha256.test(String(candidate["envelopeDigest"]))) {
+        fail("Repository Mutation envelope binding is invalid.");
+    }
+    const compiled = compile(candidate);
+    if (compiled.payloadDigest !== candidate["payloadDigest"] ||
+        compiled.envelopeDigest !== candidate["envelopeDigest"]) {
+        fail("Repository Mutation envelope digest is invalid.");
+    }
+    return compiled;
+}
+export function assertRepositoryMutationArtifactBindings(envelope, expectedOwner, expectedKernel) {
+    const owner = artifact(expectedOwner, "Expected owner artifact identity");
+    const kernel = artifact(expectedKernel, "Expected kernel artifact identity");
+    const fields = ["name", "version", "buildIdentity"];
+    if (fields.some((field) => envelope.ownerArtifact[field] !== owner[field] ||
+        envelope.kernelArtifact[field] !== kernel[field])) {
+        fail("The exact owner and kernel artifacts that created the Repository Mutation envelope are required.");
+    }
+}
+//# sourceMappingURL=repository-mutation-envelope.js.map

package/dist/repository-mutation-envelope.js.map

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

package/dist/state-contract.d.ts

@@ -0,0 +1,6 @@
+export declare const LOCAL_STATE_DIRECTORY: ".agent-teams-local";
+export declare const LOCAL_OPERATION_LOCK: "foundation-operation.lock";
+export declare const FOUNDATION_TRANSACTION_FILE: "scaffolding-transaction.json";
+export declare const TRANSACTION_TEMPORARY_FILE: "scaffolding-transaction.json.tmp";
+export declare const KNOWN_FILE_TRANSACTION_TEMPORARY_FILE: "scaffolding-transaction.json.known-file.tmp";
+//# sourceMappingURL=state-contract.d.ts.map

package/dist/state-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-contract.d.ts","sourceRoot":"","sources":["../src/state-contract.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,EAAG,oBAA6B,CAAC;AACnE,eAAO,MAAM,oBAAoB,EAAG,2BAAoC,CAAC;AACzE,eAAO,MAAM,2BAA2B,EAAG,8BAAuC,CAAC;AACnF,eAAO,MAAM,0BAA0B,oCAAgD,CAAC;AACxF,eAAO,MAAM,qCAAqC,+CAA2D,CAAC"}

package/dist/state-contract.js

@@ -0,0 +1,6 @@
+export const LOCAL_STATE_DIRECTORY = ".agent-teams-local";
+export const LOCAL_OPERATION_LOCK = "foundation-operation.lock";
+export const FOUNDATION_TRANSACTION_FILE = "scaffolding-transaction.json";
+export const TRANSACTION_TEMPORARY_FILE = `${FOUNDATION_TRANSACTION_FILE}.tmp`;
+export const KNOWN_FILE_TRANSACTION_TEMPORARY_FILE = `${FOUNDATION_TRANSACTION_FILE}.known-file.tmp`;
+//# sourceMappingURL=state-contract.js.map

package/dist/state-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-contract.js","sourceRoot":"","sources":["../src/state-contract.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAA6B,CAAC;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAAoC,CAAC;AACzE,MAAM,CAAC,MAAM,2BAA2B,GAAG,8BAAuC,CAAC;AACnF,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,2BAA2B,MAAe,CAAC;AACxF,MAAM,CAAC,MAAM,qCAAqC,GAAG,GAAG,2BAA2B,iBAA0B,CAAC"}

package/dist/strict-json.d.ts

@@ -0,0 +1,7 @@
+export type StrictJsonFailure = "duplicate-key" | "syntax";
+export declare class StrictJsonError extends Error {
+    readonly failure: StrictJsonFailure;
+    constructor(failure: StrictJsonFailure);
+}
+export declare function parseStrictJson(source: string): unknown;
+//# sourceMappingURL=strict-json.d.ts.map

package/dist/strict-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-json.d.ts","sourceRoot":"","sources":["../src/strict-json.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,QAAQ,CAAC;AAE3D,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IAEpC,YAAY,OAAO,EAAE,iBAAiB,EAIrC;CACF;AAwFD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CASvD"}

package/dist/strict-json.js

@@ -0,0 +1,131 @@
+export class StrictJsonError extends Error {
+    failure;
+    constructor(failure) {
+        super(`Strict JSON parsing failed: ${failure}.`);
+        this.name = "StrictJsonError";
+        this.failure = failure;
+    }
+}
+class JsonCursor {
+    #offset = 0;
+    #source;
+    constructor(source) {
+        this.#source = source;
+    }
+    get done() {
+        this.#space();
+        return this.#offset === this.#source.length;
+    }
+    #space() {
+        while (/\s/u.test(this.#source[this.#offset] ?? "")) {
+            this.#offset += 1;
+        }
+    }
+    #take(expected) {
+        this.#space();
+        if (!this.#source.startsWith(expected, this.#offset)) {
+            throw new StrictJsonError("syntax");
+        }
+        this.#offset += expected.length;
+    }
+    #string() {
+        this.#space();
+        const start = this.#offset;
+        if (this.#source[this.#offset] !== '"') {
+            throw new StrictJsonError("syntax");
+        }
+        this.#offset += 1;
+        while (this.#offset < this.#source.length) {
+            const character = this.#source[this.#offset];
+            if (character === '"') {
+                this.#offset += 1;
+                try {
+                    return JSON.parse(this.#source.slice(start, this.#offset));
+                }
+                catch {
+                    throw new StrictJsonError("syntax");
+                }
+            }
+            if (character === "\\") {
+                this.#offset += 1;
+            }
+            this.#offset += 1;
+        }
+        throw new StrictJsonError("syntax");
+    }
+    value() {
+        this.#space();
+        const character = this.#source[this.#offset];
+        if (character === "{") {
+            return this.#object();
+        }
+        if (character === "[") {
+            return this.#array();
+        }
+        if (character === '"') {
+            this.#string();
+            return;
+        }
+        const remainder = this.#source.slice(this.#offset);
+        const token = /^(?:true|false|null|-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?)/u.exec(remainder)?.[0];
+        if (token === undefined) {
+            throw new StrictJsonError("syntax");
+        }
+        this.#offset += token.length;
+    }
+    #array() {
+        this.#take("[");
+        this.#space();
+        if (this.#source[this.#offset] === "]") {
+            this.#offset += 1;
+            return;
+        }
+        for (;;) {
+            this.value();
+            this.#space();
+            if (this.#source[this.#offset] === "]") {
+                this.#offset += 1;
+                return;
+            }
+            this.#take(",");
+        }
+    }
+    #object() {
+        this.#take("{");
+        const keys = new Set();
+        this.#space();
+        if (this.#source[this.#offset] === "}") {
+            this.#offset += 1;
+            return;
+        }
+        for (;;) {
+            const key = this.#string();
+            if (keys.has(key)) {
+                throw new StrictJsonError("duplicate-key");
+            }
+            keys.add(key);
+            this.#take(":");
+            this.value();
+            this.#space();
+            if (this.#source[this.#offset] === "}") {
+                this.#offset += 1;
+                return;
+            }
+            this.#take(",");
+        }
+    }
+}
+export function parseStrictJson(source) {
+    const cursor = new JsonCursor(source);
+    cursor.value();
+    if (!cursor.done) {
+        throw new StrictJsonError("syntax");
+    }
+    try {
+        return JSON.parse(source);
+    }
+    catch {
+        throw new StrictJsonError("syntax");
+    }
+}
+//# sourceMappingURL=strict-json.js.map

package/dist/strict-json.js.map

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

package/dist/transaction-coordination/adapters/node/node-journal-slot-evidence.d.ts

@@ -0,0 +1,29 @@
+import type { JournalSlotAuthority, JournalSlotFailureFactory, JournalSlotResidueMatcher, StoredJournalSlot } from "./node-journal-slot-profile.js";
+export declare function observeJournalSlotAuthority(path: string, expected: JournalSlotAuthority, maximumBytes: number): Promise<"match" | "missing" | "other">;
+export declare function journalSlotPathExists(path: string, maximumBytes: number): Promise<boolean>;
+export declare function readJournalSlot<TJournal>(options: {
+    readonly failure: JournalSlotFailureFactory;
+    readonly maximumBytes: number;
+    readonly parse: (bytes: Buffer) => Promise<TJournal>;
+    readonly path: string;
+}): Promise<StoredJournalSlot<TJournal> | undefined>;
+export declare function journalSlotResidueNames(options: {
+    readonly failure: JournalSlotFailureFactory;
+    readonly matchers: readonly JournalSlotResidueMatcher[];
+    readonly parent: string;
+}): Promise<readonly string[]>;
+/**
+ * Creates one private evidence directory. Owners choose the naming; a name
+ * collision retries with the next generated name so concurrent retirements
+ * never share a directory.
+ */
+export declare function createPrivateJournalSlotDirectory(parent: string, name: () => string): Promise<{
+    readonly directory: string;
+    readonly path: string;
+}>;
+export declare function prepareJournalSlotCandidate(options: {
+    readonly bytes: Buffer;
+    readonly candidatePath: string;
+    readonly failure: JournalSlotFailureFactory;
+}): Promise<JournalSlotAuthority>;
+//# sourceMappingURL=node-journal-slot-evidence.d.ts.map

package/dist/transaction-coordination/adapters/node/node-journal-slot-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-journal-slot-evidence.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-journal-slot-evidence.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,gCAAgC,CAAC;AAiBxC,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,oBAAoB,EAC9B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,CAgBxC;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE;IACvD,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,CAiBnD;AAQD,wBAAsB,uBAAuB,CAAC,OAAO,EAAE;IACrD,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CA8B7B;AAED;;;;GAIG;AACH,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAYhE;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;CAC7C,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAsBhC"}

package/dist/transaction-coordination/adapters/node/node-journal-slot-evidence.js

@@ -0,0 +1,139 @@
+import { mkdir, open, opendir } from "node:fs/promises";
+import { join } from "node:path";
+import { captureFileHandleIdentity, pathMatchesRegularFileIdentity, readBoundedRegularFile } from "../../../repository-mutation/adapters/node/node-bounded-regular-file.js";
+import { sha256Bytes } from "../../../canonical-json.js";
+const MAXIMUM_DIRECTORY_ENTRIES = 1024;
+function journalSlotErrorCode(error) {
+    return error instanceof Error && "code" in error
+        ? error.code
+        : undefined;
+}
+function journalSlotAuthority(identity, bytes) {
+    return { authorityDigest: sha256Bytes(bytes), identity };
+}
+export async function observeJournalSlotAuthority(path, expected, maximumBytes) {
+    try {
+        const observed = await readBoundedRegularFile(path, maximumBytes);
+        if (observed.outcome !== "read") {
+            return "other";
+        }
+        return (await pathMatchesRegularFileIdentity(path, expected.identity)) === "match" &&
+            sha256Bytes(observed.bytes) === expected.authorityDigest
+            ? "match"
+            : "other";
+    }
+    catch (error) {
+        if (journalSlotErrorCode(error) === "ENOENT") {
+            return "missing";
+        }
+        throw error;
+    }
+}
+export async function journalSlotPathExists(path, maximumBytes) {
+    try {
+        await readBoundedRegularFile(path, maximumBytes);
+        return true;
+    }
+    catch (error) {
+        if (journalSlotErrorCode(error) === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function readJournalSlot(options) {
+    let observed;
+    try {
+        observed = await readBoundedRegularFile(options.path, options.maximumBytes);
+    }
+    catch (error) {
+        if (journalSlotErrorCode(error) === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+    if (observed.outcome !== "read") {
+        throw options.failure("not-regular-file", {});
+    }
+    return {
+        authority: journalSlotAuthority(observed.identity, observed.bytes),
+        journal: await options.parse(observed.bytes)
+    };
+}
+function matchesResidue(entry, matcher) {
+    return "exact" in matcher
+        ? entry === matcher.exact
+        : entry.startsWith(matcher.prefix);
+}
+export async function journalSlotResidueNames(options) {
+    let directory;
+    try {
+        directory = await opendir(options.parent);
+    }
+    catch (error) {
+        if (journalSlotErrorCode(error) === "ENOENT") {
+            throw options.failure("state-directory-missing", { cause: error });
+        }
+        throw error;
+    }
+    const residues = [];
+    let entries = 0;
+    try {
+        for (;;) {
+            const entry = await directory.read();
+            if (entry === null) {
+                break;
+            }
+            entries += 1;
+            if (entries > MAXIMUM_DIRECTORY_ENTRIES) {
+                throw options.failure("too-many-entries", {});
+            }
+            if (options.matchers.some((matcher) => matchesResidue(entry.name, matcher))) {
+                residues.push(entry.name);
+            }
+        }
+    }
+    finally {
+        await directory.close();
+    }
+    return residues.toSorted();
+}
+/**
+ * Creates one private evidence directory. Owners choose the naming; a name
+ * collision retries with the next generated name so concurrent retirements
+ * never share a directory.
+ */
+export async function createPrivateJournalSlotDirectory(parent, name) {
+    for (;;) {
+        const directory = join(parent, name());
+        try {
+            await mkdir(directory, { mode: 0o700 });
+            return { directory, path: join(directory, "evidence") };
+        }
+        catch (error) {
+            if (journalSlotErrorCode(error) !== "EEXIST") {
+                throw error;
+            }
+        }
+    }
+}
+export async function prepareJournalSlotCandidate(options) {
+    let handle;
+    try {
+        handle = await open(options.candidatePath, "wx", 0o600);
+    }
+    catch (error) {
+        throw options.failure(journalSlotErrorCode(error) === "EEXIST"
+            ? "candidate-exists"
+            : "candidate-unavailable", { cause: error });
+    }
+    try {
+        await handle.writeFile(options.bytes);
+        await handle.sync();
+        return journalSlotAuthority(await captureFileHandleIdentity(handle), options.bytes);
+    }
+    finally {
+        await handle.close();
+    }
+}
+//# sourceMappingURL=node-journal-slot-evidence.js.map