@claudexor/journal 3.10.0 → 3.10.2

package/dist/journal-background-compaction.js

@@ -0,0 +1,189 @@
+import { randomUUID } from "node:crypto";
+import { constants } from "node:fs";
+import { open, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { Readable, Writable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { setImmediate } from "node:timers/promises";
+import { createGzip } from "node:zlib";
+import { encodeJournalPayload } from "./append-batch.js";
+import { HASH_BYTES, MAX_COMPACTED_LOGICAL_BYTES, MAX_PAYLOAD_BYTES, encodeFrame, } from "./frame-codec.js";
+import { compactedJournalRecord, encodeCompactionSnapshot, isCompactionCapacityError, logicalRecord, } from "./journal-compaction.js";
+// A working batch, never a history retention limit or a user setting.
+const STREAM_BATCH_BYTES = 64 * 1024;
+const COMPACTION_FILE_PREFIX = "journal-compaction-";
+/** The journal owns freshness and installation; this helper owns only its
+ * temporary file and immutable logical-record references. */
+export async function prepareBackgroundCompaction(input) {
+    let handle = null;
+    let path = null;
+    try {
+        await setImmediate(undefined, { signal: input.signal });
+        const compressed = await compressRecords(input.entries, input.prefix.count, input.signal);
+        const snapshot = encodeCompactionSnapshot({
+            partition: input.partition,
+            epoch: input.epoch,
+            time: input.time,
+            count: input.prefix.count,
+            compressed,
+        });
+        if (!snapshot || snapshot.frame.length >= input.prefix.knownFileBytes)
+            return null;
+        input.signal.throwIfAborted();
+        const records = [];
+        for (let index = 0; index < input.prefix.count; index += 1) {
+            records.push(compactedJournalRecord(input.entries[index], input.partition, input.epoch, index, snapshot.frameHash));
+            if ((index + 1) % (STREAM_BATCH_BYTES / 128) === 0)
+                await setImmediate(undefined, { signal: input.signal });
+        }
+        input.signal.throwIfAborted();
+        path = join(input.stagingDir, `${COMPACTION_FILE_PREFIX}${randomUUID()}.compact`);
+        handle = await open(path, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL, 0o600);
+        await writeBytes(handle, snapshot.frame, input.signal);
+        const candidate = {
+            path,
+            records,
+            epoch: input.epoch,
+            nextSeq: input.prefix.nextSeq,
+            previousFrameHash: snapshot.frameHash,
+            knownFileBytes: snapshot.frame.length,
+            receipt: {
+                beforeBytes: input.prefix.knownFileBytes,
+                afterBytes: snapshot.frame.length,
+                records: input.prefix.count,
+            },
+        };
+        for (;;) {
+            input.signal.throwIfAborted();
+            // appendBatch publishes its entries/counters together, after ACK. Capture
+            // only complete batches, even when encoding yields partway through one.
+            const boundary = input.current();
+            await appendTail(handle, candidate, input.entries, boundary.count, input.signal);
+            await handle.sync();
+            input.signal.throwIfAborted();
+            if (!sameBoundary(boundary, input.current()))
+                continue;
+            // Windows requires both the old canonical writer and stage handle closed
+            // before rename. Closing can await; appends during it must be caught too.
+            await handle.close();
+            handle = null;
+            input.signal.throwIfAborted();
+            candidate.receipt = {
+                beforeBytes: boundary.knownFileBytes,
+                afterBytes: candidate.knownFileBytes,
+                records: candidate.records.length,
+            };
+            if (input.install(candidate, boundary))
+                return candidate.receipt;
+            input.signal.throwIfAborted();
+            handle = await open(path, constants.O_WRONLY | constants.O_APPEND | constants.O_NOFOLLOW);
+        }
+    }
+    catch (error) {
+        if ((input.signal.aborted &&
+            (error === input.signal.reason ||
+                (error instanceof Error && error.name === "AbortError"))) ||
+            isCompactionCapacityError(error))
+            return null;
+        throw error;
+    }
+    finally {
+        try {
+            await handle?.close();
+        }
+        finally {
+            if (path)
+                await unlink(path).catch((error) => {
+                    if (error.code !== "ENOENT")
+                        throw error;
+                });
+        }
+    }
+}
+export function sameBoundary(a, b) {
+    return (a.count === b.count &&
+        a.nextSeq === b.nextSeq &&
+        a.previousFrameHash === b.previousFrameHash &&
+        a.knownFileBytes === b.knownFileBytes);
+}
+async function compressRecords(entries, count, signal) {
+    const chunks = [];
+    let compressedBytes = 0;
+    await pipeline(Readable.from(serializeRecords(entries, count, signal), {
+        objectMode: false,
+        highWaterMark: STREAM_BATCH_BYTES,
+    }), createGzip(), new Writable({
+        write(chunk, _encoding, done) {
+            compressedBytes += chunk.length;
+            if (compressedBytes > MAX_PAYLOAD_BYTES)
+                return done(capacityError("compressed bytes"));
+            chunks.push(chunk);
+            done();
+        },
+    }), { signal });
+    return Buffer.concat(chunks, compressedBytes);
+}
+async function* serializeRecords(entries, count, signal) {
+    let totalBytes = 2; // brackets
+    let batchBytes = 0;
+    yield "[";
+    for (let index = 0; index < count; index += 1) {
+        signal.throwIfAborted();
+        const json = JSON.stringify(logicalRecord(entries[index]));
+        const bytes = Buffer.byteLength(json, "utf8") + (index === 0 ? 0 : 1);
+        totalBytes += bytes;
+        if (totalBytes > MAX_COMPACTED_LOGICAL_BYTES)
+            throw capacityError("logical bytes");
+        if (index > 0)
+            yield ",";
+        yield json;
+        batchBytes += bytes;
+        if (batchBytes >= STREAM_BATCH_BYTES) {
+            await setImmediate(undefined, { signal });
+            batchBytes = 0;
+        }
+    }
+    yield "]";
+}
+async function appendTail(handle, candidate, entries, count, signal) {
+    for (let index = candidate.records.length; index < count; index += 1) {
+        signal.throwIfAborted();
+        const record = entries[index];
+        const header = {
+            partition: record.partition,
+            epoch: record.epoch,
+            seq: record.seq,
+            previousFrameHash: candidate.previousFrameHash,
+            time: record.time,
+            type: record.type,
+        };
+        const frame = encodeFrame(header, encodeJournalPayload(record.payload));
+        const frameHash = frame.subarray(frame.length - HASH_BYTES).toString("hex");
+        await writeBytes(handle, frame, signal);
+        candidate.records.push({
+            ...header,
+            frameHash,
+            payload: record.payload,
+            byteOffset: candidate.knownFileBytes,
+        });
+        candidate.previousFrameHash = frameHash;
+        candidate.knownFileBytes += frame.length;
+        candidate.nextSeq = record.seq + 1;
+    }
+}
+async function writeBytes(handle, bytes, signal) {
+    let offset = 0;
+    while (offset < bytes.length) {
+        signal.throwIfAborted();
+        const { bytesWritten } = await handle.write(bytes, offset, bytes.length - offset);
+        if (bytesWritten === 0)
+            throw new Error("journal compaction write made no progress");
+        offset += bytesWritten;
+    }
+}
+function capacityError(kind) {
+    return Object.assign(new Error(`journal compaction exceeds the existing ${kind} cap`), {
+        code: "journal_compaction_capacity",
+    });
+}
+//# sourceMappingURL=journal-background-compaction.js.map

package/dist/journal-background-compaction.js.map

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

package/dist/journal-compaction.d.ts

@@ -1,5 +1,6 @@
-import { type JournalRecord } from "./frame-codec.js";
+import { type CompactedRecord, type JournalRecord } from "./frame-codec.js";
 export interface JournalCompactionResult {
+    path: string;
     receipt: {
         beforeBytes: number;
         afterBytes: number;
@@ -11,11 +12,26 @@ export interface JournalCompactionResult {
     previousFrameHash: string;
     knownFileBytes: number;
 }
-export declare function compactJournalFile(input: {
+/** Prepare a fsynced candidate. Only DurableJournal installs canonical bytes. */
+export declare function prepareJournalCompaction(input: {
     path: string;
     partition: string;
     entries: readonly JournalRecord[];
     knownFileBytes: number;
     now: () => Date;
 }): JournalCompactionResult | null;
+export declare function logicalRecord(record: CompactedRecord, payload?: unknown): CompactedRecord;
+/** Both producers share the versioned envelope and existing materialization caps. */
+export declare function encodeCompactionSnapshot(input: {
+    partition: string;
+    epoch: string;
+    time: string;
+    count: number;
+    compressed: Buffer;
+}): {
+    frame: Buffer;
+    frameHash: string;
+} | null;
+export declare function compactedJournalRecord(record: CompactedRecord, partition: string, epoch: string, index: number, frameHash: string, payload?: unknown): JournalRecord;
+export declare function isCompactionCapacityError(error: unknown): boolean;
 //# sourceMappingURL=journal-compaction.d.ts.map

package/dist/journal-compaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"journal-compaction.d.ts","sourceRoot":"","sources":["../src/journal-compaction.ts"],"names":[],"mappings":"AAMA,OAAO,EAUL,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB,GAAG,uBAAuB,GAAG,IAAI,CA0GjC"}
+{"version":3,"file":"journal-compaction.d.ts","sourceRoot":"","sources":["../src/journal-compaction.ts"],"names":[],"mappings":"AAIA,OAAO,EAOL,KAAK,eAAe,EAGpB,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB,GAAG,uBAAuB,GAAG,IAAI,CA8EjC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,UAAiB,GAAG,eAAe,CAEhG;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6B9C;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,UAAiB,GACvB,aAAa,CAYf;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgBjE"}

package/dist/journal-compaction.js

@@ -1,21 +1,16 @@
 import { randomUUID } from "node:crypto";
-import { closeSync, constants, openSync, renameSync } from "node:fs";
-import { dirname } from "node:path";
+import { closeSync, constants, openSync, rmSync } from "node:fs";
 import { gzipSync } from "node:zlib";
-import { fsyncDirectory } from "@claudexor/util";
 import { encodeJournalPayload } from "./append-batch.js";
 import { COMPACTED_SNAPSHOT, HASH_BYTES, MAX_COMPACTED_LOGICAL_BYTES, MAX_PAYLOAD_BYTES, ZERO_HASH, encodeFrame, } from "./frame-codec.js";
 import { appendAndSync } from "./journal-files.js";
-export function compactJournalFile(input) {
+/** Prepare a fsynced candidate. Only DurableJournal installs canonical bytes. */
+export function prepareJournalCompaction(input) {
     if (input.entries.length === 0)
         return null;
     let logical;
     try {
-        logical = input.entries.map((record) => ({
-            time: record.time,
-            type: record.type,
-            payload: cloneJson(record.payload),
-        }));
+        logical = input.entries.map((record) => logicalRecord(record, cloneJson(record.payload)));
     }
     catch (error) {
         if (isCompactionCapacityError(error))
@@ -46,61 +41,20 @@ export function compactJournalFile(input) {
             return null;
         throw error;
     }
-    // A base64 representation plus its JSON envelope is always larger than the
-    // compressed bytes, so this snapshot cannot fit the frame payload. Avoid
-    // creating an unnecessarily large string before returning the no-op.
-    if (compressed.length > MAX_PAYLOAD_BYTES)
-        return null;
-    // Base64 and payload JSON are also materialization steps. Keep them inside
-    // the same capacity boundary so an otherwise readable journal remains the
-    // authoritative file when either conversion hits a runtime limit.
-    let payload;
-    let payloadBytes;
-    try {
-        payload = {
-            version: 1,
-            count: logical.length,
-            encoding: "gzip-base64",
-            data: compressed.toString("base64"),
-        };
-        payloadBytes = encodeJournalPayload(payload);
-    }
-    catch (error) {
-        if (isCompactionCapacityError(error))
-            return null;
-        throw error;
-    }
-    if (payloadBytes.length > MAX_PAYLOAD_BYTES)
-        return null;
     const epoch = randomUUID();
-    const header = {
+    const snapshot = encodeCompactionSnapshot({
         partition: input.partition,
         epoch,
-        seq: 1,
-        previousFrameHash: ZERO_HASH,
         time: input.now().toISOString(),
-        type: COMPACTED_SNAPSHOT,
-        logicalSpan: logical.length,
-    };
-    const frame = encodeFrame(header, payloadBytes);
-    if (frame.length >= input.knownFileBytes)
+        count: logical.length,
+        compressed,
+    });
+    if (!snapshot || snapshot.frame.length >= input.knownFileBytes)
         return null;
-    const frameHash = frame.subarray(frame.length - HASH_BYTES).toString("hex");
-    // Materialize the replacement records before the rename. If cloning a
-    // payload fails, the existing journal must remain the authoritative file.
+    const { frame, frameHash } = snapshot;
     let records;
     try {
-        records = logical.map((record, index) => ({
-            partition: input.partition,
-            epoch,
-            seq: index + 1,
-            previousFrameHash: index === 0 ? ZERO_HASH : frameHash,
-            frameHash,
-            time: record.time,
-            type: record.type,
-            payload: cloneJson(record.payload),
-            byteOffset: 0,
-        }));
+        records = logical.map((record, index) => compactedJournalRecord(record, input.partition, epoch, index, frameHash, cloneJson(record.payload)));
     }
     catch (error) {
         if (isCompactionCapacityError(error))
@@ -110,14 +64,19 @@ export function compactJournalFile(input) {
     const temp = `${input.path}.${randomUUID()}.compact`;
     const tempFd = openSync(temp, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL, 0o600);
     try {
-        appendAndSync(tempFd, frame);
+        try {
+            appendAndSync(tempFd, frame);
+        }
+        finally {
+            closeSync(tempFd);
+        }
     }
-    finally {
-        closeSync(tempFd);
+    catch (error) {
+        rmSync(temp, { force: true });
+        throw error;
     }
-    renameSync(temp, input.path);
-    fsyncDirectory(dirname(input.path));
     return {
+        path: temp,
         receipt: {
             beforeBytes: input.knownFileBytes,
             afterBytes: frame.length,
@@ -130,7 +89,58 @@ export function compactJournalFile(input) {
         knownFileBytes: frame.length,
     };
 }
-function isCompactionCapacityError(error) {
+export function logicalRecord(record, payload = record.payload) {
+    return { time: record.time, type: record.type, payload };
+}
+/** Both producers share the versioned envelope and existing materialization caps. */
+export function encodeCompactionSnapshot(input) {
+    if (input.compressed.length > MAX_PAYLOAD_BYTES)
+        return null;
+    let payload;
+    let payloadBytes;
+    try {
+        payload = {
+            version: 1,
+            count: input.count,
+            encoding: "gzip-base64",
+            data: input.compressed.toString("base64"),
+        };
+        payloadBytes = encodeJournalPayload(payload);
+    }
+    catch (error) {
+        if (isCompactionCapacityError(error))
+            return null;
+        throw error;
+    }
+    if (payloadBytes.length > MAX_PAYLOAD_BYTES)
+        return null;
+    const header = {
+        partition: input.partition,
+        epoch: input.epoch,
+        seq: 1,
+        previousFrameHash: ZERO_HASH,
+        time: input.time,
+        type: COMPACTED_SNAPSHOT,
+        logicalSpan: input.count,
+    };
+    const frame = encodeFrame(header, payloadBytes);
+    const frameHash = frame.subarray(frame.length - HASH_BYTES).toString("hex");
+    return { frame, frameHash };
+}
+export function compactedJournalRecord(record, partition, epoch, index, frameHash, payload = record.payload) {
+    return {
+        partition,
+        epoch,
+        seq: index + 1,
+        previousFrameHash: index === 0 ? ZERO_HASH : frameHash,
+        frameHash,
+        time: record.time,
+        type: record.type,
+        payload,
+        byteOffset: 0,
+    };
+}
+export function isCompactionCapacityError(error) {
     if (error instanceof RangeError &&
         (error.message === "Invalid string length" ||
             ("code" in error && error.code === "ERR_STRING_TOO_LONG"))) {
@@ -139,7 +149,9 @@ function isCompactionCapacityError(error) {
     return (typeof error === "object" &&
         error !== null &&
         "code" in error &&
-        (error.code === "ERR_BUFFER_TOO_LARGE" || error.code === "ERR_STRING_TOO_LONG"));
+        (error.code === "ERR_BUFFER_TOO_LARGE" ||
+            error.code === "ERR_STRING_TOO_LONG" ||
+            error.code === "journal_compaction_capacity"));
 }
 function cloneJson(value) {
     return JSON.parse(JSON.stringify(value));

package/dist/journal-compaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"journal-compaction.js","sourceRoot":"","sources":["../src/journal-compaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,SAAS,EACT,WAAW,GAKZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWnD,MAAM,UAAU,kBAAkB,CAAC,KAMlC;IACC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,OAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACvC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;SACnC,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,yBAAyB,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACrC,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,yBAAyB,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,2BAA2B;QAAE,OAAO,IAAI,CAAC;IACrF,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,uEAAuE;QACvE,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACzF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,yBAAyB,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,2EAA2E;IAC3E,yEAAyE;IACzE,qEAAqE;IACrE,IAAI,UAAU,CAAC,MAAM,GAAG,iBAAiB;QAAE,OAAO,IAAI,CAAC;IACvD,2EAA2E;IAC3E,0EAA0E;IAC1E,kEAAkE;IAClE,IAAI,OAAiC,CAAC;IACtC,IAAI,YAAoB,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,GAAG;YACR,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,QAAQ,EAAE,aAAa;YACvB,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;SACpC,CAAC;QACF,YAAY,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,yBAAyB,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,GAAG,iBAAiB;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAgB;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK;QACL,GAAG,EAAE,CAAC;QACN,iBAAiB,EAAE,SAAS;QAC5B,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC/B,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,OAAO,CAAC,MAAM;KAC5B,CAAC;IACF,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5E,sEAAsE;IACtE,0EAA0E;IAC1E,IAAI,OAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACxC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK;YACL,GAAG,EAAE,KAAK,GAAG,CAAC;YACd,iBAAiB,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YACtD,SAAS;YACT,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;YAClC,UAAU,EAAE,CAAC;SACd,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,yBAAyB,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,UAAU,EAAE,UAAU,CAAC;IACrD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChG,IAAI,CAAC;QACH,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IACD,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,OAAO;QACL,OAAO,EAAE;YACP,WAAW,EAAE,KAAK,CAAC,cAAc;YACjC,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,OAAO,EAAE,OAAO,CAAC,MAAM;SACxB;QACD,OAAO;QACP,KAAK;QACL,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;QAC3B,iBAAiB,EAAE,SAAS;QAC5B,cAAc,EAAE,KAAK,CAAC,MAAM;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,IACE,KAAK,YAAY,UAAU;QAC3B,CAAC,KAAK,CAAC,OAAO,KAAK,uBAAuB;YACxC,CAAC,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC,EAC5D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,CAAC,KAAK,CAAC,IAAI,KAAK,sBAAsB,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAChF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAI,KAAQ;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAM,CAAC;AAChD,CAAC"}
+{"version":3,"file":"journal-compaction.js","sourceRoot":"","sources":["../src/journal-compaction.ts"],"names":[],"mappings":"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"}

package/dist/journal-cursor.d.ts

@@ -6,4 +6,5 @@ export declare class JournalCursorError extends Error {
 }
 export declare function encodeCursor(partition: string, epoch: string, seq: number): string;
 export declare function cursorError(detail: string): JournalCursorError;
+export declare function sequenceAfterCursor(cursor: string | null | undefined, partition: string, epoch: string, nextSeq: number): number;
 //# sourceMappingURL=journal-cursor.d.ts.map

package/dist/journal-cursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"journal-cursor.d.ts","sourceRoot":"","sources":["../src/journal-cursor.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,SAAS,QAAQ;IAC1B,QAAQ,CAAC,eAAe,WAAkB;CAC3C;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIlF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAE9D"}
+{"version":3,"file":"journal-cursor.d.ts","sourceRoot":"","sources":["../src/journal-cursor.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,SAAS,QAAQ;IAC1B,QAAQ,CAAC,eAAe,WAAkB;CAC3C;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIlF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAE9D;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,MAAM,CAoBR"}

package/dist/journal-cursor.js

@@ -10,4 +10,32 @@ export function encodeCursor(partition, epoch, seq) {
 export function cursorError(detail) {
     return new JournalCursorError(`journal cursor is ${detail}; resnapshot is required`);
 }
+export function sequenceAfterCursor(cursor, partition, epoch, nextSeq) {
+    if (!cursor)
+        return 0;
+    if (!/^[A-Za-z0-9_-]{1,4096}$/.test(cursor))
+        throw cursorError("malformed");
+    let value;
+    try {
+        value = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+    }
+    catch {
+        throw cursorError("malformed");
+    }
+    if (!isRecord(value) || Object.keys(value).sort().join(",") !== "e,p,s,v" || value.v !== 1) {
+        throw cursorError("unsupported");
+    }
+    if (value.p !== partition || value.e !== epoch)
+        throw cursorError("stale epoch");
+    if (!Number.isSafeInteger(value.s) || Number(value.s) < 0 || Number(value.s) >= nextSeq) {
+        throw cursorError("ahead of the durable partition");
+    }
+    if (encodeCursor(value.p, value.e, value.s) !== cursor) {
+        throw cursorError("not canonically encoded");
+    }
+    return value.s;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 //# sourceMappingURL=journal-cursor.js.map

package/dist/journal-cursor.js.map

@@ -1 +1 @@
-{"version":3,"file":"journal-cursor.js","sourceRoot":"","sources":["../src/journal-cursor.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,wBAAwB,CAAC;IAChC,MAAM,GAAG,GAAG,CAAC;IACb,SAAS,GAAG,IAAI,CAAC;IACjB,eAAe,GAAG,CAAC,YAAY,CAAC,CAAC;CAC3C;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,KAAa,EAAE,GAAW;IACxE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CACnF,WAAW,CACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,IAAI,kBAAkB,CAAC,qBAAqB,MAAM,0BAA0B,CAAC,CAAC;AACvF,CAAC"}
+{"version":3,"file":"journal-cursor.js","sourceRoot":"","sources":["../src/journal-cursor.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,wBAAwB,CAAC;IAChC,MAAM,GAAG,GAAG,CAAC;IACb,SAAS,GAAG,IAAI,CAAC;IACjB,eAAe,GAAG,CAAC,YAAY,CAAC,CAAC;CAC3C;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,KAAa,EAAE,GAAW;IACxE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CACnF,WAAW,CACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,IAAI,kBAAkB,CAAC,qBAAqB,MAAM,0BAA0B,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAiC,EACjC,SAAiB,EACjB,KAAa,EACb,OAAe;IAEf,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC5E,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3F,MAAM,WAAW,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,KAAK,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,KAAK,KAAK;QAAE,MAAM,WAAW,CAAC,aAAa,CAAC,CAAC;IACjF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QACxF,MAAM,WAAW,CAAC,gCAAgC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,YAAY,CAAC,KAAK,CAAC,CAAW,EAAE,KAAK,CAAC,CAAW,EAAE,KAAK,CAAC,CAAW,CAAC,KAAK,MAAM,EAAE,CAAC;QACrF,MAAM,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC,CAAW,CAAC;AAC3B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/journal-files.d.ts

@@ -1,9 +1,17 @@
+import { type Stats } from "node:fs";
 export interface AppendIntent {
     v: 1;
     offset: number;
     length: number;
 }
+export declare function sameJournalFile(expected: Stats, actual: Stats, bytes?: number): boolean;
+export declare function openJournalWriter(path: string): number;
+/** A failed rename may resume only the exact original canonical file. */
+export declare function reopenOriginalWriter(path: string, original: Stats): number;
 export declare function appendAndSync(fd: number, bytes: Buffer): void;
+/** Truncate only an already validated pending suffix. Windows append handles
+ * lack FILE_WRITE_DATA, required by NtSetInformationFile's EOF operation. */
+export declare function truncatePendingSuffix(fd: number, path: string, offset: number, bytes: number): void;
 export declare function ensurePrivateFile(path: string): void;
 export declare function readDescriptor(fd: number): Buffer;
 export declare function readIntent(path: string): AppendIntent | null;

package/dist/journal-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"journal-files.d.ts","sourceRoot":"","sources":["../src/journal-files.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,CAAC,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAcpD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAqB5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAanE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI7C"}
+{"version":3,"file":"journal-files.d.ts","sourceRoot":"","sources":["../src/journal-files.ts"],"names":[],"mappings":"AACA,OAAO,EAcL,KAAK,KAAK,EACX,MAAM,SAAS,CAAC;AAIjB,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,CAAC,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,SAAgB,GAAG,OAAO,CAQ9F;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CActD;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,MAAM,CAW1E;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED;6EAC6E;AAC7E,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,IAAI,CA6BN;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAcpD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAqB5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAanE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI7C"}

package/dist/journal-files.js

@@ -1,13 +1,83 @@
 import { randomUUID } from "node:crypto";
-import { closeSync, constants, existsSync, fstatSync, fsyncSync, lstatSync, openSync, readFileSync, renameSync, rmSync, writeSync, } from "node:fs";
+import { closeSync, constants, existsSync, fchmodSync, fstatSync, ftruncateSync, fsyncSync, lstatSync, openSync, readFileSync, renameSync, rmSync, writeSync, } from "node:fs";
 import { dirname } from "node:path";
 import { fsyncDirectory } from "@claudexor/util";
+export function sameJournalFile(expected, actual, bytes = expected.size) {
+    return (actual.isFile() &&
+        actual.nlink === 1 &&
+        actual.dev === expected.dev &&
+        actual.ino === expected.ino &&
+        actual.size === bytes);
+}
+export function openJournalWriter(path) {
+    const fd = openSync(path, constants.O_RDWR | constants.O_APPEND | constants.O_NOFOLLOW);
+    try {
+        const stat = fstatSync(fd);
+        if (!stat.isFile() || stat.nlink !== 1)
+            throw new Error("journal file is not privately owned");
+        if ((stat.mode & 0o777) !== 0o600) {
+            fchmodSync(fd, 0o600);
+            fsyncSync(fd);
+        }
+        return fd;
+    }
+    catch (error) {
+        closeSync(fd);
+        throw error;
+    }
+}
+/** A failed rename may resume only the exact original canonical file. */
+export function reopenOriginalWriter(path, original) {
+    let fd = -1;
+    try {
+        if (!sameJournalFile(original, lstatSync(path)))
+            return -1;
+        fd = openJournalWriter(path);
+        if (sameJournalFile(original, fstatSync(fd)))
+            return fd;
+    }
+    catch {
+        /* the caller enters its typed recovery path */
+    }
+    if (fd >= 0)
+        closeSync(fd);
+    return -1;
+}
 export function appendAndSync(fd, bytes) {
     let offset = 0;
     while (offset < bytes.length)
         offset += writeSync(fd, bytes, offset, bytes.length - offset);
     fsyncSync(fd);
 }
+/** Truncate only an already validated pending suffix. Windows append handles
+ * lack FILE_WRITE_DATA, required by NtSetInformationFile's EOF operation. */
+export function truncatePendingSuffix(fd, path, offset, bytes) {
+    if (process.platform !== "win32") {
+        ftruncateSync(fd, offset);
+        fsyncSync(fd);
+        return;
+    }
+    const original = fstatSync(fd);
+    const recoveryFd = openSync(path, constants.O_RDWR | constants.O_NOFOLLOW);
+    try {
+        if (!sameJournalFile(original, fstatSync(fd), bytes) ||
+            !sameJournalFile(original, fstatSync(recoveryFd), bytes) ||
+            !sameJournalFile(original, lstatSync(path), bytes)) {
+            throw new Error("journal identity changed before pending suffix recovery");
+        }
+        ftruncateSync(recoveryFd, offset);
+        fsyncSync(recoveryFd);
+        if (!sameJournalFile(original, fstatSync(fd), offset) ||
+            !sameJournalFile(original, fstatSync(recoveryFd), offset) ||
+            !sameJournalFile(original, lstatSync(path), offset)) {
+            throw new Error("journal identity changed during pending suffix recovery");
+        }
+    }
+    finally {
+        // A close failure must also leave the intent in place and refuse readiness.
+        closeSync(recoveryFd);
+    }
+}
 export function ensurePrivateFile(path) {
     if (!existsSync(path)) {
         const fd = openSync(path, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL, 0o600);