@peerbit/native-backbone 0.1.4 → 0.2.0

package/README.md

@@ -25,3 +25,34 @@ Buffered helpers also install a bounded checkpoint policy by default. When the
 coordinate journal reaches the checkpoint threshold, the adapter writes a compact
 snapshot and removes the replay WAL. This keeps high-throughput strict-native
 document writes from trading append speed for unbounded restart replay cost.
+
+The coordinate WAL supports clean stop/restart. It is not the recovery authority
+for a crash-atomic append across blocks, graph state, heads, coordinates,
+documents, and signer facts.
+
+## Local durability transaction primitives
+
+The package also exposes the first, intentionally unwired building blocks for
+the proposed local crash-safe transaction protocol. This is an on-disk recovery
+format for one program directory; it is not a peer-to-peer wire protocol.
+
+- a versioned, checksummed native journal codec that distinguishes a
+  structurally incomplete final frame from complete corruption;
+- transaction-private block staging and typed strict-barrier receipts;
+- immutable checkpoint generations with an A/B manifest switch; and
+- a Node directory lease backed by an OS-held LevelDB lock and a persistent
+  fencing epoch.
+
+These APIs do not change current append or open behavior. The Node filesystem
+adapter owns its official Rust codec and crash-released directory lease, and is
+the first supported strict physical backend on filesystems that support file and
+directory sync. Its first open creates a synced genesis only in an otherwise
+empty program directory; a nonempty legacy directory fails with
+`NativeDurabilityMigrationRequiredError` and is never adopted implicitly.
+
+Phase one retains the full journal and pins genesis as its scan base while newer
+A/B checkpoints prove staging coverage. Journal compaction is deliberately
+deferred until a later phase can switch the journal generation and its scan base
+together. Memory storage is a non-crash-safe reference adapter, and OPFS remains
+unsupported until its lifetime lease and worker-termination barriers have a
+dedicated conformance gate.

package/dist/src/durability/codec.d.ts

@@ -0,0 +1,86 @@
+import type { NativeDurabilityJournalClassification, NativeDurabilityJournalClassifier } from "./storage.js";
+export declare const NATIVE_DURABILITY_JOURNAL_FORMAT_VERSION: 1;
+export declare const NATIVE_DURABILITY_JOURNAL_MAX_U64: bigint;
+export declare const NATIVE_DURABILITY_JOURNAL_MAX_BODY_LENGTH: number;
+export declare const NATIVE_DURABILITY_JOURNAL_MAX_PROGRAM_ID_LENGTH = 4096;
+export declare const NATIVE_DURABILITY_JOURNAL_MAX_TRANSACTION_ID_LENGTH = 1024;
+export declare const NATIVE_DURABILITY_JOURNAL_MAX_WRITER_OWNER_ID_LENGTH = 1024;
+export declare const NATIVE_DURABILITY_JOURNAL_MAX_WRITER_DOMAIN_ID_LENGTH = 1024;
+export declare const NATIVE_DURABILITY_JOURNAL_CODEC_BRAND: unique symbol;
+export declare enum NativeDurabilityPhase {
+    DurablePrepared = 1,
+    NativeApplied = 2,
+    Published = 3,
+    Committed = 4,
+    CleanupPending = 5,
+    Clean = 6
+}
+export declare enum NativeDurabilityOperationKind {
+    Append = 1,
+    Batch = 2,
+    Document = 3,
+    Receive = 4,
+    Repair = 5
+}
+export type NativeDurabilityJournalRecord = {
+    recordLsn: bigint;
+    txSequence: bigint;
+    writerEpoch: bigint;
+    writerOwnerId: string;
+    writerDomainId: string;
+    phase: NativeDurabilityPhase;
+    operationKind: NativeDurabilityOperationKind;
+    programId: Uint8Array;
+    transactionId: string;
+    planDigest: Uint8Array;
+    payload: Uint8Array;
+};
+export type NativeDurabilityCheckpointTransactionState = Pick<NativeDurabilityJournalRecord, "txSequence" | "transactionId" | "phase" | "operationKind" | "planDigest">;
+export type NativeDurabilityJournalValidationContext = {
+    checkpointLsn: bigint;
+    checkpointTxSequenceHighwater: bigint;
+    expectedProgramId: Uint8Array;
+    expectedWriterDomainId: string;
+    checkpointWriterEpoch: bigint;
+    checkpointWriterOwnerId?: string;
+    currentWriterEpoch: bigint;
+    currentWriterOwnerId: string;
+    retainedTransactions?: readonly NativeDurabilityCheckpointTransactionState[];
+};
+export type NativeDurabilityIncompleteTailReason = "short-header" | "short-body" | "short-trailer";
+export type NativeDurabilityJournalScan = {
+    records: NativeDurabilityJournalRecord[];
+    validLength: number;
+    incompleteTailOffset?: number;
+    incompleteTailReason?: NativeDurabilityIncompleteTailReason;
+    lastRecordLsn: bigint;
+};
+export type NativeDurabilityJournalErrorCode = "ERR_NATIVE_DURABILITY_JOURNAL_INPUT" | `ERR_NATIVE_DURABILITY_JOURNAL_${string}`;
+export declare class NativeDurabilityJournalCodecError extends Error {
+    readonly code: NativeDurabilityJournalErrorCode;
+    readonly byteOffset?: number | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(code: NativeDurabilityJournalErrorCode, message: string, byteOffset?: number | undefined, cause?: unknown | undefined);
+}
+export declare class NativeDurabilityJournalInputError extends NativeDurabilityJournalCodecError {
+    readonly field: string;
+    constructor(field: string, message: string);
+}
+export declare class NativeDurabilityJournalCorruptionError extends NativeDurabilityJournalCodecError {
+    constructor(code: NativeDurabilityJournalErrorCode, message: string, byteOffset?: number, cause?: unknown);
+}
+export declare class NativeDurabilityJournalCodec implements NativeDurabilityJournalClassifier {
+    private readonly native;
+    readonly formatVersion: 1;
+    readonly [NATIVE_DURABILITY_JOURNAL_CODEC_BRAND]: true;
+    private readonly validationContext;
+    private constructor();
+    static create(context: NativeDurabilityJournalValidationContext): Promise<NativeDurabilityJournalCodec>;
+    get context(): NativeDurabilityJournalValidationContext;
+    encode(record: NativeDurabilityJournalRecord): Uint8Array;
+    scan(bytes: Uint8Array, context?: NativeDurabilityJournalValidationContext): NativeDurabilityJournalScan;
+    classify(bytes: Uint8Array): NativeDurabilityJournalClassification;
+}
+export declare const isNativeDurabilityJournalCodec: (value: unknown) => value is NativeDurabilityJournalCodec;
+export declare const createNativeDurabilityJournalCodec: (context: NativeDurabilityJournalValidationContext) => Promise<NativeDurabilityJournalCodec>;
+//# sourceMappingURL=codec.d.ts.map

package/dist/src/durability/codec.d.ts.map

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

package/dist/src/durability/codec.js

@@ -0,0 +1,365 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+export const NATIVE_DURABILITY_JOURNAL_FORMAT_VERSION = 1;
+export const NATIVE_DURABILITY_JOURNAL_MAX_U64 = (1n << 64n) - 1n;
+export const NATIVE_DURABILITY_JOURNAL_MAX_BODY_LENGTH = 64 * 1024 * 1024;
+export const NATIVE_DURABILITY_JOURNAL_MAX_PROGRAM_ID_LENGTH = 4096;
+export const NATIVE_DURABILITY_JOURNAL_MAX_TRANSACTION_ID_LENGTH = 1024;
+export const NATIVE_DURABILITY_JOURNAL_MAX_WRITER_OWNER_ID_LENGTH = 1024;
+export const NATIVE_DURABILITY_JOURNAL_MAX_WRITER_DOMAIN_ID_LENGTH = 1024;
+export const NATIVE_DURABILITY_JOURNAL_CODEC_BRAND = Symbol.for("@peerbit/native-backbone/native-durability-journal-codec/v1");
+export var NativeDurabilityPhase;
+(function (NativeDurabilityPhase) {
+    NativeDurabilityPhase[NativeDurabilityPhase["DurablePrepared"] = 1] = "DurablePrepared";
+    NativeDurabilityPhase[NativeDurabilityPhase["NativeApplied"] = 2] = "NativeApplied";
+    NativeDurabilityPhase[NativeDurabilityPhase["Published"] = 3] = "Published";
+    NativeDurabilityPhase[NativeDurabilityPhase["Committed"] = 4] = "Committed";
+    NativeDurabilityPhase[NativeDurabilityPhase["CleanupPending"] = 5] = "CleanupPending";
+    NativeDurabilityPhase[NativeDurabilityPhase["Clean"] = 6] = "Clean";
+})(NativeDurabilityPhase || (NativeDurabilityPhase = {}));
+export var NativeDurabilityOperationKind;
+(function (NativeDurabilityOperationKind) {
+    NativeDurabilityOperationKind[NativeDurabilityOperationKind["Append"] = 1] = "Append";
+    NativeDurabilityOperationKind[NativeDurabilityOperationKind["Batch"] = 2] = "Batch";
+    NativeDurabilityOperationKind[NativeDurabilityOperationKind["Document"] = 3] = "Document";
+    NativeDurabilityOperationKind[NativeDurabilityOperationKind["Receive"] = 4] = "Receive";
+    NativeDurabilityOperationKind[NativeDurabilityOperationKind["Repair"] = 5] = "Repair";
+})(NativeDurabilityOperationKind || (NativeDurabilityOperationKind = {}));
+export class NativeDurabilityJournalCodecError extends Error {
+    code;
+    byteOffset;
+    cause;
+    constructor(code, message, byteOffset, cause) {
+        super(message);
+        this.code = code;
+        this.byteOffset = byteOffset;
+        this.cause = cause;
+        this.name = "NativeDurabilityJournalCodecError";
+    }
+}
+export class NativeDurabilityJournalInputError extends NativeDurabilityJournalCodecError {
+    field;
+    constructor(field, message) {
+        super("ERR_NATIVE_DURABILITY_JOURNAL_INPUT", message);
+        this.field = field;
+        this.name = "NativeDurabilityJournalInputError";
+    }
+}
+export class NativeDurabilityJournalCorruptionError extends NativeDurabilityJournalCodecError {
+    constructor(code, message, byteOffset, cause) {
+        super(code, message, byteOffset, cause);
+        this.name = "NativeDurabilityJournalCorruptionError";
+    }
+}
+let wasmModulePromise;
+let wasmInitialization;
+const nativeDurabilityJournalCodecConstructionToken = Symbol();
+const trustedNativeDurabilityJournalCodecs = new WeakSet();
+const loadWasm = async () => {
+    const wasmModulePath = "../../wasm/native_backbone.js";
+    wasmModulePromise ??= import(__rewriteRelativeImportExtension(
+    /* @vite-ignore */ wasmModulePath));
+    wasmInitialization ??= wasmModulePromise.then(async (wasm) => {
+        const processLike = globalThis;
+        if (processLike.process?.versions?.node) {
+            const fsPromises = "fs/promises";
+            const { readFile } = (await import(__rewriteRelativeImportExtension(
+            /* @vite-ignore */ fsPromises)));
+            const bytes = await readFile(new URL("../../wasm/native_backbone_bg.wasm", import.meta.url));
+            wasm.initSync({ module: bytes });
+        }
+        else {
+            await wasm.default({
+                module_or_path: new URL("../../wasm/native_backbone_bg.wasm", import.meta.url),
+            });
+        }
+        return wasm;
+    });
+    return wasmInitialization;
+};
+let textEncoder;
+const utf8ByteLength = (value) => {
+    textEncoder ??= new TextEncoder();
+    return textEncoder.encode(value).byteLength;
+};
+const assertU64 = (value, field, options = {}) => {
+    if (typeof value !== "bigint" ||
+        value < 0n ||
+        value > NATIVE_DURABILITY_JOURNAL_MAX_U64 ||
+        (options.nonzero === true && value === 0n)) {
+        throw new NativeDurabilityJournalInputError(field, `${field} must be ${options.nonzero ? "a non-zero" : "an"} unsigned 64-bit bigint`);
+    }
+};
+const assertBytes = (value, field, options = {}) => {
+    if (!(value instanceof Uint8Array)) {
+        throw new NativeDurabilityJournalInputError(field, `${field} must be Uint8Array`);
+    }
+    if (options.exact != null && value.byteLength !== options.exact) {
+        throw new NativeDurabilityJournalInputError(field, `${field} must contain exactly ${options.exact} bytes`);
+    }
+    if (options.min != null && value.byteLength < options.min) {
+        throw new NativeDurabilityJournalInputError(field, `${field} must contain at least ${options.min} bytes`);
+    }
+    if (options.max != null && value.byteLength > options.max) {
+        throw new NativeDurabilityJournalInputError(field, `${field} exceeds ${options.max} bytes`);
+    }
+};
+const assertBoundedString = (value, field, maxBytes) => {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new NativeDurabilityJournalInputError(field, `${field} must not be empty`);
+    }
+    const byteLength = utf8ByteLength(value);
+    if (byteLength > maxBytes) {
+        throw new NativeDurabilityJournalInputError(field, `${field} exceeds ${maxBytes} UTF-8 bytes`);
+    }
+};
+const assertPhase = (value, field) => {
+    if (!Number.isInteger(value) || value < 1 || value > 6) {
+        throw new NativeDurabilityJournalInputError(field, `${field} is invalid`);
+    }
+};
+const assertOperationKind = (value, field) => {
+    if (!Number.isInteger(value) || value < 1 || value > 5) {
+        throw new NativeDurabilityJournalInputError(field, `${field} is invalid`);
+    }
+};
+const assertRecord = (record) => {
+    assertU64(record.recordLsn, "recordLsn", { nonzero: true });
+    assertU64(record.txSequence, "txSequence", { nonzero: true });
+    assertU64(record.writerEpoch, "writerEpoch", { nonzero: true });
+    assertBoundedString(record.writerOwnerId, "writerOwnerId", NATIVE_DURABILITY_JOURNAL_MAX_WRITER_OWNER_ID_LENGTH);
+    assertBoundedString(record.writerDomainId, "writerDomainId", NATIVE_DURABILITY_JOURNAL_MAX_WRITER_DOMAIN_ID_LENGTH);
+    assertPhase(record.phase, "phase");
+    assertOperationKind(record.operationKind, "operationKind");
+    assertBytes(record.programId, "programId", {
+        min: 1,
+        max: NATIVE_DURABILITY_JOURNAL_MAX_PROGRAM_ID_LENGTH,
+    });
+    assertBoundedString(record.transactionId, "transactionId", NATIVE_DURABILITY_JOURNAL_MAX_TRANSACTION_ID_LENGTH);
+    assertBytes(record.planDigest, "planDigest", { exact: 32 });
+    assertBytes(record.payload, "payload", {
+        max: NATIVE_DURABILITY_JOURNAL_MAX_BODY_LENGTH,
+    });
+};
+const assertContext = (context) => {
+    assertU64(context.checkpointLsn, "checkpointLsn");
+    assertU64(context.checkpointTxSequenceHighwater, "checkpointTxSequenceHighwater");
+    assertBytes(context.expectedProgramId, "expectedProgramId", {
+        min: 1,
+        max: NATIVE_DURABILITY_JOURNAL_MAX_PROGRAM_ID_LENGTH,
+    });
+    assertBoundedString(context.expectedWriterDomainId, "expectedWriterDomainId", NATIVE_DURABILITY_JOURNAL_MAX_WRITER_DOMAIN_ID_LENGTH);
+    assertU64(context.checkpointWriterEpoch, "checkpointWriterEpoch");
+    assertU64(context.currentWriterEpoch, "currentWriterEpoch", { nonzero: true });
+    if (context.checkpointWriterEpoch > context.currentWriterEpoch) {
+        throw new NativeDurabilityJournalInputError("checkpointWriterEpoch", "checkpointWriterEpoch must not exceed currentWriterEpoch");
+    }
+    if (context.checkpointWriterEpoch > 0n && context.checkpointWriterOwnerId == null) {
+        throw new NativeDurabilityJournalInputError("checkpointWriterOwnerId", "checkpointWriterOwnerId is required for a non-genesis checkpoint epoch");
+    }
+    if (context.checkpointWriterOwnerId != null) {
+        assertBoundedString(context.checkpointWriterOwnerId, "checkpointWriterOwnerId", NATIVE_DURABILITY_JOURNAL_MAX_WRITER_OWNER_ID_LENGTH);
+    }
+    assertBoundedString(context.currentWriterOwnerId, "currentWriterOwnerId", NATIVE_DURABILITY_JOURNAL_MAX_WRITER_OWNER_ID_LENGTH);
+    for (const [index, retained] of (context.retainedTransactions ?? []).entries()) {
+        assertU64(retained.txSequence, `retainedTransactions[${index}].txSequence`, {
+            nonzero: true,
+        });
+        if (retained.txSequence > context.checkpointTxSequenceHighwater) {
+            throw new NativeDurabilityJournalInputError(`retainedTransactions[${index}].txSequence`, "retained transaction sequence exceeds checkpoint highwater");
+        }
+        assertBoundedString(retained.transactionId, `retainedTransactions[${index}].transactionId`, NATIVE_DURABILITY_JOURNAL_MAX_TRANSACTION_ID_LENGTH);
+        assertPhase(retained.phase, `retainedTransactions[${index}].phase`);
+        assertOperationKind(retained.operationKind, `retainedTransactions[${index}].operationKind`);
+        assertBytes(retained.planDigest, `retainedTransactions[${index}].planDigest`, {
+            exact: 32,
+        });
+    }
+};
+const copyContext = (context) => ({
+    ...context,
+    expectedProgramId: new Uint8Array(context.expectedProgramId),
+    retainedTransactions: (context.retainedTransactions ?? []).map((retained) => ({
+        ...retained,
+        planDigest: new Uint8Array(retained.planDigest),
+    })),
+});
+const parseDecimalU64 = (value, field) => {
+    if (typeof value !== "string" || !/^(0|[1-9][0-9]*)$/.test(value)) {
+        throw new NativeDurabilityJournalCorruptionError("ERR_NATIVE_DURABILITY_JOURNAL_INVALID_DECIMAL_U64", `${field} is not a canonical decimal u64`);
+    }
+    const parsed = BigInt(value);
+    if (parsed > NATIVE_DURABILITY_JOURNAL_MAX_U64) {
+        throw new NativeDurabilityJournalCorruptionError("ERR_NATIVE_DURABILITY_JOURNAL_INVALID_DECIMAL_U64", `${field} exceeds u64`);
+    }
+    return parsed;
+};
+const parseSafeOffset = (value, field, maximum) => {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value < 0 ||
+        value > maximum) {
+        throw new NativeDurabilityJournalCorruptionError("ERR_NATIVE_DURABILITY_JOURNAL_INVALID_SCAN_ROW", `${field} is not a safe byte offset`);
+    }
+    return value;
+};
+const bytesFromRow = (value, field) => {
+    if (!(value instanceof Uint8Array)) {
+        throw new NativeDurabilityJournalCorruptionError("ERR_NATIVE_DURABILITY_JOURNAL_INVALID_SCAN_ROW", `${field} is not bytes`);
+    }
+    return new Uint8Array(value);
+};
+const stringFromRow = (value, field) => {
+    if (typeof value !== "string") {
+        throw new NativeDurabilityJournalCorruptionError("ERR_NATIVE_DURABILITY_JOURNAL_INVALID_SCAN_ROW", `${field} is not a string`);
+    }
+    return value;
+};
+const enumFromRow = (value, field, min, max) => {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < min || value > max) {
+        throw new NativeDurabilityJournalCorruptionError("ERR_NATIVE_DURABILITY_JOURNAL_INVALID_SCAN_ROW", `${field} is invalid`);
+    }
+    return value;
+};
+const errorFromWasm = (error, kind) => {
+    if (Array.isArray(error) && typeof error[0] === "string" && typeof error[1] === "string") {
+        const offset = typeof error[2] === "number" && Number.isSafeInteger(error[2])
+            ? error[2]
+            : undefined;
+        if (kind === "corruption") {
+            return new NativeDurabilityJournalCorruptionError(error[0], error[1], offset, error);
+        }
+        return new NativeDurabilityJournalCodecError(error[0], error[1], offset, error);
+    }
+    return kind === "corruption"
+        ? new NativeDurabilityJournalCorruptionError("ERR_NATIVE_DURABILITY_JOURNAL_WASM", "Native durability journal codec failed", undefined, error)
+        : new NativeDurabilityJournalCodecError("ERR_NATIVE_DURABILITY_JOURNAL_WASM", "Native durability journal codec failed", undefined, error);
+};
+const parseScan = (raw, byteLength) => {
+    if (!Array.isArray(raw) || raw.length !== 5 || !Array.isArray(raw[4])) {
+        throw new NativeDurabilityJournalCorruptionError("ERR_NATIVE_DURABILITY_JOURNAL_INVALID_SCAN_ROW", "Native durability journal scan result is malformed");
+    }
+    const validLength = parseSafeOffset(raw[0], "validLength", byteLength);
+    const incompleteTailOffset = raw[1] == null
+        ? undefined
+        : parseSafeOffset(raw[1], "incompleteTailOffset", byteLength);
+    const reasonCode = enumFromRow(raw[2], "incompleteTailReason", 0, 3);
+    const incompleteTailReason = reasonCode === 0
+        ? undefined
+        : reasonCode === 1
+            ? "short-header"
+            : reasonCode === 2
+                ? "short-body"
+                : "short-trailer";
+    if ((incompleteTailOffset == null) !== (incompleteTailReason == null)) {
+        throw new NativeDurabilityJournalCorruptionError("ERR_NATIVE_DURABILITY_JOURNAL_INVALID_SCAN_ROW", "Incomplete-tail offset and reason disagree");
+    }
+    const records = raw[4].map((unknownRow, index) => {
+        if (!Array.isArray(unknownRow) || unknownRow.length !== 11) {
+            throw new NativeDurabilityJournalCorruptionError("ERR_NATIVE_DURABILITY_JOURNAL_INVALID_SCAN_ROW", `Journal record row ${index} is malformed`);
+        }
+        const row = unknownRow;
+        return {
+            recordLsn: parseDecimalU64(row[0], `records[${index}].recordLsn`),
+            txSequence: parseDecimalU64(row[1], `records[${index}].txSequence`),
+            writerEpoch: parseDecimalU64(row[2], `records[${index}].writerEpoch`),
+            writerOwnerId: stringFromRow(row[3], `records[${index}].writerOwnerId`),
+            writerDomainId: stringFromRow(row[4], `records[${index}].writerDomainId`),
+            phase: enumFromRow(row[5], `records[${index}].phase`, 1, 6),
+            operationKind: enumFromRow(row[6], `records[${index}].operationKind`, 1, 5),
+            programId: bytesFromRow(row[7], `records[${index}].programId`),
+            transactionId: stringFromRow(row[8], `records[${index}].transactionId`),
+            planDigest: bytesFromRow(row[9], `records[${index}].planDigest`),
+            payload: bytesFromRow(row[10], `records[${index}].payload`),
+        };
+    });
+    return {
+        records,
+        validLength,
+        incompleteTailOffset,
+        incompleteTailReason,
+        lastRecordLsn: parseDecimalU64(raw[3], "lastRecordLsn"),
+    };
+};
+export class NativeDurabilityJournalCodec {
+    native;
+    formatVersion = NATIVE_DURABILITY_JOURNAL_FORMAT_VERSION;
+    [NATIVE_DURABILITY_JOURNAL_CODEC_BRAND] = true;
+    validationContext;
+    constructor(constructionToken, native, context) {
+        this.native = native;
+        if (constructionToken !== nativeDurabilityJournalCodecConstructionToken) {
+            throw new TypeError("NativeDurabilityJournalCodec must be created by createNativeDurabilityJournalCodec");
+        }
+        assertContext(context);
+        this.validationContext = copyContext(context);
+    }
+    static async create(context) {
+        assertContext(context);
+        // Snapshot before the first await so caller mutation cannot change the
+        // validation authority while the Wasm module is loading.
+        const validationContext = copyContext(context);
+        const wasm = await loadWasm();
+        const codec = new NativeDurabilityJournalCodec(nativeDurabilityJournalCodecConstructionToken, new wasm.NativeDurabilityJournalCodec(), validationContext);
+        trustedNativeDurabilityJournalCodecs.add(codec);
+        return codec;
+    }
+    get context() {
+        return copyContext(this.validationContext);
+    }
+    encode(record) {
+        assertRecord(record);
+        try {
+            return new Uint8Array(this.native.encodeFrame(record.recordLsn.toString(), record.txSequence.toString(), record.writerEpoch.toString(), record.writerOwnerId, record.writerDomainId, record.phase, record.operationKind, record.programId, record.transactionId, record.planDigest, record.payload));
+        }
+        catch (error) {
+            throw errorFromWasm(error, "input");
+        }
+    }
+    scan(bytes, context = this.validationContext) {
+        assertBytes(bytes, "journalBytes");
+        assertContext(context);
+        const retainedTransactions = (context.retainedTransactions ?? []).map((retained) => [
+            retained.txSequence.toString(),
+            retained.transactionId,
+            retained.phase,
+            retained.operationKind,
+            retained.planDigest,
+        ]);
+        try {
+            return parseScan(this.native.scan(bytes, context.checkpointLsn.toString(), context.checkpointTxSequenceHighwater.toString(), context.expectedProgramId, context.expectedWriterDomainId, context.checkpointWriterEpoch.toString(), context.checkpointWriterOwnerId, context.currentWriterEpoch.toString(), context.currentWriterOwnerId, retainedTransactions), bytes.byteLength);
+        }
+        catch (error) {
+            if (error instanceof NativeDurabilityJournalCodecError)
+                throw error;
+            throw errorFromWasm(error, "corruption");
+        }
+    }
+    classify(bytes) {
+        const scan = this.scan(bytes);
+        if (scan.incompleteTailOffset != null && scan.incompleteTailReason != null) {
+            return {
+                kind: "incomplete-tail",
+                validLength: scan.validLength,
+                lastRecordLsn: scan.lastRecordLsn,
+                reason: scan.incompleteTailReason,
+            };
+        }
+        return {
+            kind: "complete",
+            validLength: scan.validLength,
+            lastRecordLsn: scan.lastRecordLsn,
+        };
+    }
+}
+export const isNativeDurabilityJournalCodec = (value) => (typeof value === "object" || typeof value === "function") &&
+    value !== null &&
+    trustedNativeDurabilityJournalCodecs.has(value);
+export const createNativeDurabilityJournalCodec = async (context) => NativeDurabilityJournalCodec.create(context);
+//# sourceMappingURL=codec.js.map

package/dist/src/durability/codec.js.map

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

package/dist/src/durability/lease.d.ts

@@ -0,0 +1,59 @@
+export type NativeDurabilityFence = Readonly<{
+    epoch: bigint;
+    ownerId: string;
+    domainId: string;
+}>;
+export declare const NATIVE_DURABILITY_MAX_U64: bigint;
+export declare const NATIVE_DURABILITY_MAX_WRITER_ID_BYTES = 1024;
+/**
+ * Exclusive ownership capability for one native durability directory.
+ *
+ * Implementations keep the underlying ownership primitive alive until
+ * `close()` completes. Storage writers must wrap the complete asynchronous
+ * mutation and its barrier in `runWhileHeld()` and persist the accompanying
+ * fence with their records. `assertHeld()` is diagnostic only; it is not a
+ * lifecycle guard for an operation that later awaits I/O.
+ */
+export interface NativeDurabilityLease {
+    readonly fence: NativeDurabilityFence;
+    assertHeld(): Promise<void>;
+    /**
+     * Keep the lease alive for the complete asynchronous operation. `close()`
+     * starts rejecting new operations immediately and waits for operations that
+     * already entered this guard before releasing the underlying OS lock.
+     */
+    runWhileHeld<T>(operation: () => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+}
+export declare class NativeDurabilityLeaseUnavailableError extends Error {
+    readonly directory: string;
+    readonly code = "NATIVE_DURABILITY_LEASE_UNAVAILABLE";
+    constructor(directory: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class NativeDurabilityLeaseClosedError extends Error {
+    readonly fence: NativeDurabilityFence;
+    readonly code = "NATIVE_DURABILITY_LEASE_CLOSED";
+    constructor(fence: NativeDurabilityFence);
+}
+export declare class NativeDurabilityLeaseStateError extends Error {
+    readonly directory: string;
+    readonly code = "NATIVE_DURABILITY_LEASE_STATE_INVALID";
+    constructor(directory: string, message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class NativeDurabilityLeaseDirectorySyncError extends Error {
+    readonly directory: string;
+    readonly code = "NATIVE_DURABILITY_LEASE_DIRECTORY_SYNC_FAILED";
+    constructor(directory: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class NativeDurabilityFenceExhaustedError extends Error {
+    readonly directory: string;
+    readonly code = "NATIVE_DURABILITY_FENCE_EXHAUSTED";
+    constructor(directory: string);
+}
+//# sourceMappingURL=lease.d.ts.map

package/dist/src/durability/lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease.d.ts","sourceRoot":"","sources":["../../../src/durability/lease.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAAmB,CAAC;AAC1D,eAAO,MAAM,qCAAqC,OAAO,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B;;;;OAIG;IACH,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,qBAAa,qCAAsC,SAAQ,KAAK;IAI9D,QAAQ,CAAC,SAAS,EAAE,MAAM;IAH3B,QAAQ,CAAC,IAAI,yCAAyC;gBAG5C,SAAS,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAK9B;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IAG9C,QAAQ,CAAC,KAAK,EAAE,qBAAqB;IAFjD,QAAQ,CAAC,IAAI,oCAAoC;gBAE5B,KAAK,EAAE,qBAAqB;CAIjD;AAED,qBAAa,+BAAgC,SAAQ,KAAK;IAIxD,QAAQ,CAAC,SAAS,EAAE,MAAM;IAH3B,QAAQ,CAAC,IAAI,2CAA2C;gBAG9C,SAAS,EAAE,MAAM,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAK9B;AAED,qBAAa,uCAAwC,SAAQ,KAAK;IAIhE,QAAQ,CAAC,SAAS,EAAE,MAAM;IAH3B,QAAQ,CAAC,IAAI,mDAAmD;gBAGtD,SAAS,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ9B;AAED,qBAAa,mCAAoC,SAAQ,KAAK;IAGjD,QAAQ,CAAC,SAAS,EAAE,MAAM;IAFtC,QAAQ,CAAC,IAAI,uCAAuC;gBAE/B,SAAS,EAAE,MAAM;CAItC"}

package/dist/src/durability/lease.js

@@ -0,0 +1,48 @@
+export const NATIVE_DURABILITY_MAX_U64 = (1n << 64n) - 1n;
+export const NATIVE_DURABILITY_MAX_WRITER_ID_BYTES = 1024;
+export class NativeDurabilityLeaseUnavailableError extends Error {
+    directory;
+    code = "NATIVE_DURABILITY_LEASE_UNAVAILABLE";
+    constructor(directory, options) {
+        super(`Native durability directory is already open: ${directory}`, options);
+        this.directory = directory;
+        this.name = "NativeDurabilityLeaseUnavailableError";
+    }
+}
+export class NativeDurabilityLeaseClosedError extends Error {
+    fence;
+    code = "NATIVE_DURABILITY_LEASE_CLOSED";
+    constructor(fence) {
+        super(`Native durability lease is no longer held: ${fence.domainId}`);
+        this.fence = fence;
+        this.name = "NativeDurabilityLeaseClosedError";
+    }
+}
+export class NativeDurabilityLeaseStateError extends Error {
+    directory;
+    code = "NATIVE_DURABILITY_LEASE_STATE_INVALID";
+    constructor(directory, message, options) {
+        super(message, options);
+        this.directory = directory;
+        this.name = "NativeDurabilityLeaseStateError";
+    }
+}
+export class NativeDurabilityLeaseDirectorySyncError extends Error {
+    directory;
+    code = "NATIVE_DURABILITY_LEASE_DIRECTORY_SYNC_FAILED";
+    constructor(directory, options) {
+        super(`Native durability requires directory fsync support: ${directory}`, options);
+        this.directory = directory;
+        this.name = "NativeDurabilityLeaseDirectorySyncError";
+    }
+}
+export class NativeDurabilityFenceExhaustedError extends Error {
+    directory;
+    code = "NATIVE_DURABILITY_FENCE_EXHAUSTED";
+    constructor(directory) {
+        super(`Native durability fence epoch is exhausted: ${directory}`);
+        this.directory = directory;
+        this.name = "NativeDurabilityFenceExhaustedError";
+    }
+}
+//# sourceMappingURL=lease.js.map

package/dist/src/durability/lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease.js","sourceRoot":"","sources":["../../../src/durability/lease.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AAC1D,MAAM,CAAC,MAAM,qCAAqC,GAAG,IAAI,CAAC;AAuB1D,MAAM,OAAO,qCAAsC,SAAQ,KAAK;IAIrD;IAHD,IAAI,GAAG,qCAAqC,CAAC;IAEtD,YACU,SAAiB,EAC1B,OAA6B;QAE7B,KAAK,CAAC,gDAAgD,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;QAHnE,cAAS,GAAT,SAAS,CAAQ;QAI1B,IAAI,CAAC,IAAI,GAAG,uCAAuC,CAAC;IACrD,CAAC;CACD;AAED,MAAM,OAAO,gCAAiC,SAAQ,KAAK;IAGrC;IAFZ,IAAI,GAAG,gCAAgC,CAAC;IAEjD,YAAqB,KAA4B;QAChD,KAAK,CAAC,8CAA8C,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QADlD,UAAK,GAAL,KAAK,CAAuB;QAEhD,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IAChD,CAAC;CACD;AAED,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IAI/C;IAHD,IAAI,GAAG,uCAAuC,CAAC;IAExD,YACU,SAAiB,EAC1B,OAAe,EACf,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAJf,cAAS,GAAT,SAAS,CAAQ;QAK1B,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAC/C,CAAC;CACD;AAED,MAAM,OAAO,uCAAwC,SAAQ,KAAK;IAIvD;IAHD,IAAI,GAAG,+CAA+C,CAAC;IAEhE,YACU,SAAiB,EAC1B,OAA6B;QAE7B,KAAK,CACJ,uDAAuD,SAAS,EAAE,EAClE,OAAO,CACP,CAAC;QANO,cAAS,GAAT,SAAS,CAAQ;QAO1B,IAAI,CAAC,IAAI,GAAG,yCAAyC,CAAC;IACvD,CAAC;CACD;AAED,MAAM,OAAO,mCAAoC,SAAQ,KAAK;IAGxC;IAFZ,IAAI,GAAG,mCAAmC,CAAC;IAEpD,YAAqB,SAAiB;QACrC,KAAK,CAAC,+CAA+C,SAAS,EAAE,CAAC,CAAC;QAD9C,cAAS,GAAT,SAAS,CAAQ;QAErC,IAAI,CAAC,IAAI,GAAG,qCAAqC,CAAC;IACnD,CAAC;CACD"}