oh-my-super-agent 0.1.0

package/dist/src/runtime/record-store.d.ts

@@ -0,0 +1,45 @@
+import { type RuntimeRecord, type TransitionOutcome } from "../domain/records.js";
+import { type JsonSchemaNode } from "./schema.js";
+export interface RecordStoreOptions {
+    recordsRoot: string;
+    locksRoot: string;
+    schema?: JsonSchemaNode;
+    createValidator?: (record: RuntimeRecord) => void;
+    recordValidator?: (record: RuntimeRecord) => void;
+    transitionValidator?: (current: RuntimeRecord, next: RuntimeRecord) => void;
+}
+export declare class RecordAlreadyExistsError extends Error {
+    readonly recordId: string;
+    constructor(recordId: string);
+}
+export interface TransitionOptions<State extends string, Payload extends Record<string, unknown>> {
+    recordId: string;
+    ownerId: string;
+    expectedVersion: number;
+    nonce: string;
+    expectedActor: string;
+    expectedAttempt: number;
+    expectedLeaseToken: string | null;
+    nextActor?: string;
+    nextAttempt?: number;
+    nextLeaseToken?: string | null;
+    fromStates: readonly State[];
+    toState: State;
+    updatePayload?: (current: Readonly<RuntimeRecord<State, Payload>>) => Payload;
+}
+export type TransitionResult<State extends string, Payload extends Record<string, unknown>> = {
+    status: "applied";
+    record: RuntimeRecord<State, Payload>;
+    outcome: TransitionOutcome<State>;
+} | {
+    status: "replayed";
+    record: RuntimeRecord<State, Payload>;
+    outcome: TransitionOutcome<State>;
+};
+export declare function createRecordStore(options: RecordStoreOptions): {
+    create<State extends string, Payload extends Record<string, unknown>>(record: RuntimeRecord<State, Payload>): RuntimeRecord<State, Payload>;
+    read<State extends string, Payload extends Record<string, unknown>>(recordId: string): RuntimeRecord<State, Payload>;
+    readIfExists<State extends string, Payload extends Record<string, unknown>>(recordId: string): RuntimeRecord<State, Payload> | undefined;
+    list<State extends string, Payload extends Record<string, unknown>>(): readonly RuntimeRecord<State, Payload>[];
+    transition<State extends string, Payload extends Record<string, unknown>>(transition: TransitionOptions<State, Payload>): TransitionResult<State, Payload>;
+};

package/dist/src/runtime/record-store.js

@@ -0,0 +1,272 @@
+import { lstatSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { MAX_TRANSITION_OUTCOMES, assertActorId, assertLeaseToken, assertRecordId, assertTransitionNonce, loadRuntimeRecordSchema, parseRuntimeRecord, recordFileName, recordLockId, } from "../domain/records.js";
+import { lstatIfExists, readJsonFileNoFollow, validateExistingDirectory, writeJsonAtomic, writeJsonAtomicNoReplace, } from "../utils/fs.js";
+import { acquireDirectoryLock } from "./lock.js";
+import { assertSchema } from "./schema.js";
+export class RecordAlreadyExistsError extends Error {
+    recordId;
+    constructor(recordId) {
+        super(`record already exists: ${recordId}`);
+        this.name = "RecordAlreadyExistsError";
+        this.recordId = recordId;
+    }
+}
+export function createRecordStore(options) {
+    const schema = frozenStructuredClone(options.schema ?? loadRuntimeRecordSchema());
+    const createValidator = options.createValidator;
+    const recordValidator = options.recordValidator;
+    const transitionValidator = options.transitionValidator;
+    const recordsRoot = validateExistingDirectory(options.recordsRoot, "records root");
+    const locksRoot = validateExistingDirectory(options.locksRoot, "locks root");
+    if (recordsRoot === locksRoot)
+        throw new Error("records root and locks root must be different directories");
+    const recordsRootIdentity = captureDirectoryIdentity(recordsRoot);
+    const locksRootIdentity = captureDirectoryIdentity(locksRoot);
+    function validateRoots() {
+        validateDirectoryIdentity(recordsRootIdentity, "records root");
+        validateDirectoryIdentity(locksRootIdentity, "locks root");
+    }
+    return {
+        create(record) {
+            validateRoots();
+            const detachedRecord = cloneJson(record, "runtime record create input");
+            const candidate = validateRecord(detachedRecord, schema, recordValidator, "runtime record");
+            const lock = acquireDirectoryLock({
+                locksRoot,
+                lockId: recordLockId(candidate.record_id),
+                ownerId: candidate.actor,
+                note: `create:${candidate.record_id}`,
+            });
+            try {
+                validateRoots();
+                const lockedCandidate = validateRecord(candidate, schema, recordValidator, "runtime record under create lock");
+                if (lockedCandidate.record_id !== candidate.record_id) {
+                    throw new Error("runtime record id changed during create validation");
+                }
+                createValidator?.(frozenStructuredClone(lockedCandidate));
+                const path = recordPath(recordsRoot, lockedCandidate.record_id);
+                const entry = lstatIfExists(path);
+                if (entry) {
+                    if (entry.isSymbolicLink() || !entry.isFile())
+                        throw new Error(`unsafe existing record path: ${lockedCandidate.record_id}`);
+                    throw new RecordAlreadyExistsError(lockedCandidate.record_id);
+                }
+                try {
+                    writeJsonAtomicNoReplace(path, lockedCandidate);
+                }
+                catch (error) {
+                    if (isErrorCode(error, "EEXIST"))
+                        throw new RecordAlreadyExistsError(lockedCandidate.record_id);
+                    throw error;
+                }
+                const stored = loadRecord(path, schema, recordValidator);
+                validateRoots();
+                return stored;
+            }
+            finally {
+                lock.release();
+            }
+        },
+        read(recordId) {
+            validateRoots();
+            const path = recordPath(recordsRoot, assertRecordId(recordId));
+            const record = loadRecord(path, schema, recordValidator);
+            validateRoots();
+            return record;
+        },
+        readIfExists(recordId) {
+            validateRoots();
+            const path = recordPath(recordsRoot, assertRecordId(recordId));
+            const entry = lstatIfExists(path);
+            if (!entry) {
+                validateRoots();
+                return undefined;
+            }
+            if (entry.isSymbolicLink() || !entry.isFile())
+                throw new Error(`unsafe existing record path: ${recordId}`);
+            const record = loadRecord(path, schema, recordValidator);
+            validateRoots();
+            return record;
+        },
+        list() {
+            validateRoots();
+            const entries = readdirSync(recordsRoot, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name));
+            validateRoots();
+            const records = [];
+            for (const entry of entries) {
+                if (!entry.name.endsWith(".json"))
+                    continue;
+                if (!entry.isFile())
+                    throw new Error(`unsafe record directory entry: ${entry.name}`);
+                const recordId = assertRecordId(entry.name.slice(0, -".json".length));
+                if (recordFileName(recordId) !== entry.name)
+                    throw new Error(`invalid record filename: ${entry.name}`);
+                validateRoots();
+                records.push(loadRecord(join(recordsRoot, entry.name), schema, recordValidator));
+                validateRoots();
+            }
+            validateRoots();
+            return Object.freeze(records);
+        },
+        transition(transition) {
+            validateRoots();
+            const recordId = assertRecordId(transition.recordId);
+            const nonce = assertTransitionNonce(transition.nonce);
+            const lock = acquireDirectoryLock({
+                locksRoot,
+                lockId: recordLockId(recordId),
+                ownerId: transition.ownerId,
+                note: `transition:${recordId}`,
+            });
+            try {
+                validateRoots();
+                const path = recordPath(recordsRoot, recordId);
+                const current = loadRecord(path, schema, recordValidator);
+                validateRoots();
+                const replayed = current.transition_outcomes.find((outcome) => outcome.nonce === nonce);
+                if (replayed)
+                    return Object.freeze({ status: "replayed", record: current, outcome: replayed });
+                const normalized = validateTransition(current, transition, nonce);
+                const next = buildNextRecord(current, transition, normalized);
+                transitionValidator?.(frozenStructuredClone(current), frozenStructuredClone(next));
+                const candidate = validateRecord(next, schema, recordValidator, "next runtime record");
+                writeJsonAtomic(path, candidate);
+                const stored = loadRecord(path, schema, recordValidator);
+                validateRoots();
+                const outcome = stored.transition_outcomes.at(-1);
+                if (!outcome)
+                    throw new Error("stored runtime record is missing its transition outcome");
+                return Object.freeze({ status: "applied", record: stored, outcome });
+            }
+            finally {
+                lock.release();
+            }
+        },
+    };
+}
+function recordPath(recordsRoot, recordId) {
+    return join(recordsRoot, recordFileName(recordId));
+}
+function loadRecord(path, schema, recordValidator) {
+    const raw = readJsonFileNoFollow(path);
+    return validateRecord(raw, schema, recordValidator, "stored runtime record");
+}
+function validateRecord(value, schema, recordValidator, label) {
+    assertSchema(value, schema, label);
+    const record = parseRuntimeRecord(value);
+    const snapshot = frozenStructuredClone(record);
+    recordValidator?.(snapshot);
+    return snapshot;
+}
+function validateTransition(current, transition, nonce) {
+    assertNonNegativeInteger(transition.expectedVersion, "expected version");
+    assertPositiveInteger(transition.expectedAttempt, "expected attempt");
+    const expectedActor = assertActorId(transition.expectedActor, "expected actor");
+    const expectedLeaseToken = transition.expectedLeaseToken === null
+        ? null
+        : assertLeaseToken(transition.expectedLeaseToken, "expected lease token");
+    const nextActor = transition.nextActor === undefined
+        ? current.actor
+        : assertActorId(transition.nextActor, "next actor");
+    const nextAttempt = transition.nextAttempt ?? current.attempt;
+    const nextLeaseToken = transition.nextLeaseToken === undefined
+        ? current.lease_token
+        : transition.nextLeaseToken === null
+            ? null
+            : assertLeaseToken(transition.nextLeaseToken, "next lease token");
+    assertPositiveInteger(nextAttempt, "next attempt");
+    if (current.version !== transition.expectedVersion)
+        throw new Error("stale version");
+    if (current.actor !== expectedActor)
+        throw new Error("actor mismatch");
+    if (current.attempt !== transition.expectedAttempt)
+        throw new Error("attempt mismatch");
+    if (current.lease_token !== expectedLeaseToken)
+        throw new Error("lease token mismatch");
+    if (!transition.fromStates.includes(current.state))
+        throw new Error("illegal transition");
+    if (nextAttempt < current.attempt)
+        throw new Error("attempt cannot move backwards");
+    if (nextAttempt > current.attempt + 1)
+        throw new Error("attempt must advance by exactly one");
+    if (nextAttempt > current.max_attempts)
+        throw new Error("attempt budget exhausted");
+    if (current.transition_outcomes.length >= MAX_TRANSITION_OUTCOMES) {
+        throw new Error("transition outcome history is full");
+    }
+    return { nonce, nextActor, nextAttempt, nextLeaseToken };
+}
+function buildNextRecord(current, transition, normalized) {
+    const callbackCurrent = recursivelyFreeze(cloneJson(current, "runtime record snapshot"));
+    const proposedPayload = transition.updatePayload
+        ? transition.updatePayload(callbackCurrent)
+        : callbackCurrent.payload;
+    if (!proposedPayload || typeof proposedPayload !== "object" || Array.isArray(proposedPayload)) {
+        throw new Error("payload update must return an object");
+    }
+    const nextPayload = cloneJson(proposedPayload, "payload update");
+    const outcome = {
+        nonce: normalized.nonce,
+        version: current.version + 1,
+        state: transition.toState,
+        attempt: normalized.nextAttempt,
+        actor: normalized.nextActor,
+        lease_token: normalized.nextLeaseToken,
+    };
+    return {
+        ...current,
+        version: outcome.version,
+        state: outcome.state,
+        attempt: outcome.attempt,
+        actor: outcome.actor,
+        lease_token: outcome.lease_token,
+        transition_nonce: outcome.nonce,
+        payload: nextPayload,
+        transition_outcomes: [...current.transition_outcomes, outcome],
+    };
+}
+function cloneJson(value, label) {
+    try {
+        const serialized = JSON.stringify(value);
+        if (serialized === undefined)
+            throw new Error("value is not JSON serializable");
+        return JSON.parse(serialized);
+    }
+    catch (error) {
+        throw new Error(`${label} must be JSON serializable`, { cause: error });
+    }
+}
+function recursivelyFreeze(value) {
+    if (typeof value !== "object" || value === null || Object.isFrozen(value))
+        return value;
+    for (const nested of Object.values(value))
+        recursivelyFreeze(nested);
+    return Object.freeze(value);
+}
+function frozenStructuredClone(value) {
+    return recursivelyFreeze(structuredClone(value));
+}
+function assertNonNegativeInteger(value, label) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error(`${label} must be a non-negative integer`);
+}
+function assertPositiveInteger(value, label) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new Error(`${label} must be a positive integer`);
+}
+function captureDirectoryIdentity(path) {
+    const entry = lstatSync(path);
+    return { path, device: entry.dev, inode: entry.ino };
+}
+function validateDirectoryIdentity(expected, label) {
+    const path = validateExistingDirectory(expected.path, label);
+    const entry = lstatSync(path);
+    if (path !== expected.path || entry.dev !== expected.device || entry.ino !== expected.inode) {
+        throw new Error(`${label} changed after store creation`);
+    }
+}
+function isErrorCode(error, code) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+//# sourceMappingURL=record-store.js.map

package/dist/src/runtime/record-store.js.map

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

package/dist/src/runtime/schema.d.ts

@@ -0,0 +1,28 @@
+export interface JsonSchemaNode {
+    type?: string | readonly string[];
+    properties?: Record<string, JsonSchemaNode>;
+    required?: readonly string[];
+    additionalProperties?: boolean;
+    const?: unknown;
+    enum?: readonly unknown[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+    pattern?: string;
+    items?: JsonSchemaNode;
+}
+export interface SchemaValidationIssue {
+    path: string;
+    message: string;
+}
+export declare class SchemaValidationError extends Error {
+    readonly issues: readonly SchemaValidationIssue[];
+    constructor(message: string, issues: readonly SchemaValidationIssue[]);
+}
+export declare function loadJsonSchema(path: string): JsonSchemaNode;
+export declare function parseJsonSchema(value: unknown, label?: string): JsonSchemaNode;
+export declare function assertSchema(value: unknown, schema: JsonSchemaNode, label: string): void;
+export declare function validateWithSchema(value: unknown, schema: JsonSchemaNode, path?: string): SchemaValidationIssue[];

package/dist/src/runtime/schema.js

@@ -0,0 +1,194 @@
+import { isRecord, readJsonFile } from "../utils/fs.js";
+const SUPPORTED_SCHEMA_KEYS = new Set([
+    "$schema",
+    "$id",
+    "title",
+    "description",
+    "default",
+    "type",
+    "properties",
+    "required",
+    "additionalProperties",
+    "const",
+    "enum",
+    "minimum",
+    "maximum",
+    "minLength",
+    "maxLength",
+    "minItems",
+    "maxItems",
+    "pattern",
+    "items",
+]);
+export class SchemaValidationError extends Error {
+    issues;
+    constructor(message, issues) {
+        super(message);
+        this.name = "SchemaValidationError";
+        this.issues = issues;
+    }
+}
+export function loadJsonSchema(path) {
+    return parseJsonSchema(readJsonFile(path), path);
+}
+export function parseJsonSchema(value, label = "schema") {
+    const issues = validateSchemaShape(value, "$");
+    if (issues.length > 0) {
+        const first = issues[0];
+        throw new SchemaValidationError(`invalid schema: ${label}: ${first?.path ?? "$"} ${first?.message ?? "validation failed"}`, issues);
+    }
+    return value;
+}
+export function assertSchema(value, schema, label) {
+    const issues = validateWithSchema(value, schema, "$");
+    if (issues.length > 0)
+        throw new SchemaValidationError(`${label} failed schema validation`, issues);
+}
+export function validateWithSchema(value, schema, path = "$") {
+    const issues = [];
+    if (schema.const !== undefined && !Object.is(value, schema.const)) {
+        issues.push({ path, message: `expected constant ${JSON.stringify(schema.const)}` });
+        return issues;
+    }
+    if (schema.enum && !schema.enum.some((candidate) => Object.is(candidate, value))) {
+        issues.push({ path, message: `expected one of ${schema.enum.map((item) => JSON.stringify(item)).join(", ")}` });
+        return issues;
+    }
+    if (schema.type && !matchesAllowedType(value, schema.type)) {
+        issues.push({ path, message: `expected ${describeAllowedTypes(schema.type)}` });
+        return issues;
+    }
+    if (schema.pattern && typeof value === "string" && !new RegExp(schema.pattern, "u").test(value)) {
+        issues.push({ path, message: `expected string matching ${schema.pattern}` });
+    }
+    if (schema.minimum !== undefined && typeof value === "number" && value < schema.minimum) {
+        issues.push({ path, message: `expected number >= ${schema.minimum}` });
+    }
+    if (schema.maximum !== undefined && typeof value === "number" && value > schema.maximum) {
+        issues.push({ path, message: `expected number <= ${schema.maximum}` });
+    }
+    if (schema.minLength !== undefined && typeof value === "string" && value.length < schema.minLength) {
+        issues.push({ path, message: `expected at least ${schema.minLength} characters` });
+    }
+    if (schema.maxLength !== undefined && typeof value === "string" && value.length > schema.maxLength) {
+        issues.push({ path, message: `expected at most ${schema.maxLength} characters` });
+    }
+    if (schema.minItems !== undefined && Array.isArray(value) && value.length < schema.minItems) {
+        issues.push({ path, message: `expected at least ${schema.minItems} items` });
+    }
+    if (schema.maxItems !== undefined && Array.isArray(value) && value.length > schema.maxItems) {
+        issues.push({ path, message: `expected at most ${schema.maxItems} items` });
+    }
+    if (issues.length > 0)
+        return issues;
+    if (isRecord(value)) {
+        const required = new Set(schema.required ?? []);
+        for (const property of required) {
+            if (!Object.hasOwn(value, property))
+                issues.push({ path: `${path}.${property}`, message: "missing required property" });
+        }
+        const properties = schema.properties ?? {};
+        for (const [property, childSchema] of Object.entries(properties)) {
+            if (Object.hasOwn(value, property))
+                issues.push(...validateWithSchema(value[property], childSchema, `${path}.${property}`));
+        }
+        if (schema.additionalProperties === false) {
+            for (const property of Object.keys(value)) {
+                if (!Object.hasOwn(properties, property)) {
+                    issues.push({ path: `${path}.${property}`, message: "unexpected property" });
+                }
+            }
+        }
+    }
+    if (Array.isArray(value) && schema.items) {
+        for (let index = 0; index < value.length; index += 1) {
+            issues.push(...validateWithSchema(value[index], schema.items, `${path}[${index}]`));
+        }
+    }
+    return issues;
+}
+function validateSchemaShape(value, path) {
+    if (!isRecord(value))
+        return [{ path, message: "schema node must be an object" }];
+    const issues = [];
+    for (const keyword of Object.keys(value)) {
+        if (!SUPPORTED_SCHEMA_KEYS.has(keyword))
+            issues.push({ path: `${path}.${keyword}`, message: "unsupported schema keyword" });
+    }
+    if ("type" in value && !isTypeKeyword(value.type)) {
+        issues.push({ path: `${path}.type`, message: "type must be a string or string array" });
+    }
+    if ("properties" in value) {
+        if (!isRecord(value.properties)) {
+            issues.push({ path: `${path}.properties`, message: "properties must be an object" });
+        }
+        else {
+            for (const [property, child] of Object.entries(value.properties)) {
+                issues.push(...validateSchemaShape(child, `${path}.properties.${property}`));
+            }
+        }
+    }
+    if ("required" in value && (!Array.isArray(value.required) || value.required.some((entry) => typeof entry !== "string"))) {
+        issues.push({ path: `${path}.required`, message: "required must be a string array" });
+    }
+    if ("additionalProperties" in value && typeof value.additionalProperties !== "boolean") {
+        issues.push({ path: `${path}.additionalProperties`, message: "additionalProperties must be boolean" });
+    }
+    if ("minimum" in value && typeof value.minimum !== "number") {
+        issues.push({ path: `${path}.minimum`, message: "minimum must be a number" });
+    }
+    if ("maximum" in value && typeof value.maximum !== "number") {
+        issues.push({ path: `${path}.maximum`, message: "maximum must be a number" });
+    }
+    if ("minLength" in value && (typeof value.minLength !== "number" || !Number.isSafeInteger(value.minLength) || value.minLength < 0)) {
+        issues.push({ path: `${path}.minLength`, message: "minLength must be a non-negative integer" });
+    }
+    if ("maxLength" in value && (typeof value.maxLength !== "number" || !Number.isSafeInteger(value.maxLength) || value.maxLength < 0)) {
+        issues.push({ path: `${path}.maxLength`, message: "maxLength must be a non-negative integer" });
+    }
+    if ("minItems" in value && (typeof value.minItems !== "number" || !Number.isSafeInteger(value.minItems) || value.minItems < 0)) {
+        issues.push({ path: `${path}.minItems`, message: "minItems must be a non-negative integer" });
+    }
+    if ("maxItems" in value && (typeof value.maxItems !== "number" || !Number.isSafeInteger(value.maxItems) || value.maxItems < 0)) {
+        issues.push({ path: `${path}.maxItems`, message: "maxItems must be a non-negative integer" });
+    }
+    if ("pattern" in value && typeof value.pattern !== "string") {
+        issues.push({ path: `${path}.pattern`, message: "pattern must be a string" });
+    }
+    if ("items" in value)
+        issues.push(...validateSchemaShape(value.items, `${path}.items`));
+    return issues;
+}
+function isTypeKeyword(value) {
+    return typeof value === "string" || (Array.isArray(value) && value.every((entry) => typeof entry === "string"));
+}
+function matchesAllowedType(value, allowed) {
+    const types = Array.isArray(allowed) ? allowed : [allowed];
+    return types.some((type) => matchesType(value, type));
+}
+function matchesType(value, type) {
+    switch (type) {
+        case "object":
+            return isRecord(value);
+        case "string":
+            return typeof value === "string";
+        case "integer":
+            return typeof value === "number" && Number.isSafeInteger(value);
+        case "number":
+            return typeof value === "number" && Number.isFinite(value);
+        case "boolean":
+            return typeof value === "boolean";
+        case "array":
+            return Array.isArray(value);
+        case "null":
+            return value === null;
+        default:
+            return false;
+    }
+}
+function describeAllowedTypes(allowed) {
+    if (typeof allowed === "string")
+        return allowed;
+    return Array.from(allowed).join(" or ");
+}
+//# sourceMappingURL=schema.js.map

package/dist/src/runtime/schema.js.map

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

package/dist/src/runtime/stable-id.d.ts

@@ -0,0 +1,3 @@
+import { type OpaqueId, type TransitionNonce } from "../domain/records.js";
+export declare function createStableId(prefix: string, ...parts: readonly string[]): OpaqueId;
+export declare function createTransitionNonce(action: string, recordId: string, operationId: string): TransitionNonce;

package/dist/src/runtime/stable-id.js

@@ -0,0 +1,27 @@
+import { createHash } from "node:crypto";
+import { assertOpaqueId, assertTransitionNonce } from "../domain/records.js";
+const DIGEST_LENGTH = 48;
+const MAX_PREFIX_LENGTH = 14;
+export function createStableId(prefix, ...parts) {
+    const normalizedPrefix = assertOpaqueId(prefix, "stable id prefix");
+    if (normalizedPrefix.length > MAX_PREFIX_LENGTH) {
+        throw new Error(`stable id prefix exceeds ${MAX_PREFIX_LENGTH} characters`);
+    }
+    if (parts.length === 0)
+        throw new Error("stable id requires at least one identity part");
+    const hash = createHash("sha256");
+    hash.update(`${normalizedPrefix.length}:${normalizedPrefix}`);
+    for (const part of parts) {
+        if (typeof part !== "string")
+            throw new Error("stable id parts must be strings");
+        hash.update(`\0${Buffer.byteLength(part, "utf8")}:`);
+        hash.update(part, "utf8");
+    }
+    return assertOpaqueId(`${normalizedPrefix}-${hash.digest("hex").slice(0, DIGEST_LENGTH)}`, "stable id");
+}
+export function createTransitionNonce(action, recordId, operationId) {
+    const normalizedAction = assertOpaqueId(action, "transition action");
+    const normalizedOperation = assertOpaqueId(operationId, "operation id");
+    return assertTransitionNonce(createStableId("nonce", normalizedAction, recordId, normalizedOperation));
+}
+//# sourceMappingURL=stable-id.js.map

package/dist/src/runtime/stable-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-id.js","sourceRoot":"","sources":["../../../src/runtime/stable-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAuC,MAAM,sBAAsB,CAAC;AAElH,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,GAAG,KAAwB;IACxE,MAAM,gBAAgB,GAAG,cAAc,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACpE,IAAI,gBAAgB,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,4BAA4B,iBAAiB,aAAa,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAEzF,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC,CAAC;IAC9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,cAAc,CAAC,GAAG,gBAAgB,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,QAAgB,EAAE,WAAmB;IACzF,MAAM,gBAAgB,GAAG,cAAc,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACrE,MAAM,mBAAmB,GAAG,cAAc,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACxE,OAAO,qBAAqB,CAAC,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC;AACzG,CAAC"}

package/dist/src/runtime/system-clock.d.ts

@@ -0,0 +1,8 @@
+import { type OpaqueId } from "../domain/records.js";
+export interface SystemClockSample {
+    readonly wallTime: string;
+    readonly monotonicNs: bigint;
+    readonly bootId: OpaqueId;
+}
+export declare function systemClockSample(): SystemClockSample;
+export declare function systemBootId(): OpaqueId;