@claudexor/daemon 3.25.1 → 4.0.1

package/dist/store/legacy-journal/frame-codec.d.ts

@@ -0,0 +1,94 @@
+export declare const PREFIX_BYTES: number;
+export declare const HASH_BYTES = 32;
+export declare const MAX_PAYLOAD_BYTES: number;
+export declare const MAX_COMPACTED_LOGICAL_BYTES: number;
+export declare const ZERO_HASH: string;
+export declare const COMPACTED_SNAPSHOT = "journal.compacted_snapshot";
+export interface JournalRecord<T = unknown> {
+    partition: string;
+    epoch: string;
+    seq: number;
+    previousFrameHash: string;
+    frameHash: string;
+    time: string;
+    type: string;
+    payload: T;
+    byteOffset: number;
+}
+export interface FrameHeader {
+    partition: string;
+    epoch: string;
+    seq: number;
+    previousFrameHash: string;
+    time: string;
+    type: string;
+    logicalSpan?: number;
+}
+/** A logical record inside a compacted snapshot. `seq` is present in
+ * seq-preserving snapshots (a chunk may then cover more sequence numbers than
+ * it holds records); its absence means the legacy dense layout. */
+export interface CompactedRecord {
+    seq?: number;
+    time: string;
+    type: string;
+    payload: unknown;
+}
+export interface ReplayResult {
+    records: JournalRecord[];
+    incompleteOffset: number | null;
+    error: {
+        offset: number;
+        reason: string;
+    } | null;
+}
+export type FramePrefix = {
+    status: "incomplete";
+} | {
+    status: "corrupt";
+    reason: string;
+} | {
+    status: "frame";
+    headerLength: number;
+    payloadLength: number;
+    frameLength: number;
+};
+export type FrameBody = {
+    status: "corrupt";
+    reason: string;
+} | {
+    status: "frame";
+    header: FrameHeader;
+    payload: unknown;
+    frameHash: string;
+};
+/** Sequential validation state shared by every reader of one partition. */
+export interface FrameChain {
+    partition: string;
+    epoch: string | null;
+    expectedSeq: number;
+    previous: string;
+}
+export type ChainedFrame = {
+    status: "corrupt";
+    reason: string;
+} | {
+    status: "frame";
+    records: JournalRecord[];
+    byteLengths: number[];
+};
+/** Legacy whole-buffer replay; the positional reader runs the same three steps. */
+export declare function replayFrames(bytes: Buffer, partition: string): ReplayResult;
+export declare function newFrameChain(partition: string): FrameChain;
+/** Step 1: the fixed prefix. `remaining` is the readable byte count from the
+ * frame start; `view` must expose at least `min(remaining, PREFIX_BYTES)`. */
+export declare function readFramePrefix(view: Buffer, remaining: number): FramePrefix;
+/** Step 2: hash and JSON of one complete frame (`frame` is exactly its bytes).
+ * The payload handed out is the parsed object covered by the verified hash. */
+export declare function decodeFrameBody(frame: Buffer, headerLength: number, payloadLength: number): FrameBody;
+/** Step 3: partition/epoch/seq/hash-chain semantics, then logical records.
+ * A compacted snapshot advances the expected sequence by its logical span. */
+export declare function chainFrame(chain: FrameChain, body: Extract<FrameBody, {
+    status: "frame";
+}>, byteOffset: number, payloadLength: number): ChainedFrame;
+export declare function encodeFrame(header: FrameHeader, payload: Buffer): Buffer;
+//# sourceMappingURL=frame-codec.d.ts.map

package/dist/store/legacy-journal/frame-codec.d.ts.map

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

package/dist/store/legacy-journal/frame-codec.js

@@ -0,0 +1,352 @@
+import { createHash } from "node:crypto";
+import { gunzipSync } from "node:zlib";
+const MAGIC = Buffer.from([0x43, 0x4c, 0x58, 0x4a, 0x4e, 0x4c, 0x32, 0x00]);
+const VERSION = 1;
+const PREFIX_CORE_BYTES = MAGIC.length + 2 + 4 + 4;
+const PREFIX_CHECKSUM_BYTES = 8;
+export const PREFIX_BYTES = PREFIX_CORE_BYTES + PREFIX_CHECKSUM_BYTES;
+export const HASH_BYTES = 32;
+const MAX_HEADER_BYTES = 64 * 1024;
+export const MAX_PAYLOAD_BYTES = 16 * 1024 * 1024;
+// A compacted frame's physical payload is bounded, but gzip expansion is not.
+// Keep replay fail-closed before an unbounded allocation while retaining
+// headroom for the large single-frame snapshots earlier writers produced.
+export const MAX_COMPACTED_LOGICAL_BYTES = 512 * 1024 * 1024;
+export const ZERO_HASH = "0".repeat(64);
+export const COMPACTED_SNAPSHOT = "journal.compacted_snapshot";
+/** Legacy whole-buffer replay; the positional reader runs the same three steps. */
+export function replayFrames(bytes, partition) {
+    const records = [];
+    const chain = newFrameChain(partition);
+    let offset = 0;
+    while (offset < bytes.length) {
+        const prefix = readFramePrefix(bytes.subarray(offset), bytes.length - offset);
+        if (prefix.status === "incomplete")
+            return { records, incompleteOffset: offset, error: null };
+        if (prefix.status === "corrupt")
+            return corrupt(records, offset, prefix.reason);
+        const body = decodeFrameBody(bytes.subarray(offset, offset + prefix.frameLength), prefix.headerLength, prefix.payloadLength);
+        if (body.status === "corrupt")
+            return corrupt(records, offset, body.reason);
+        const chained = chainFrame(chain, body, offset, prefix.payloadLength);
+        if (chained.status === "corrupt")
+            return corrupt(records, offset, chained.reason);
+        for (const record of chained.records)
+            records.push(record);
+        offset += prefix.frameLength;
+    }
+    return { records, incompleteOffset: null, error: null };
+}
+export function newFrameChain(partition) {
+    return { partition, epoch: null, expectedSeq: 1, previous: ZERO_HASH };
+}
+/** Step 1: the fixed prefix. `remaining` is the readable byte count from the
+ * frame start; `view` must expose at least `min(remaining, PREFIX_BYTES)`. */
+export function readFramePrefix(view, remaining) {
+    if (remaining < PREFIX_BYTES)
+        return { status: "incomplete" };
+    if (!view.subarray(0, MAGIC.length).equals(MAGIC)) {
+        return { status: "corrupt", reason: "frame magic mismatch" };
+    }
+    const prefix = view.subarray(0, PREFIX_BYTES);
+    const expectedPrefix = createHash("sha256")
+        .update(prefix.subarray(0, PREFIX_CORE_BYTES))
+        .digest()
+        .subarray(0, PREFIX_CHECKSUM_BYTES);
+    if (!prefix.subarray(PREFIX_CORE_BYTES).equals(expectedPrefix)) {
+        return { status: "corrupt", reason: "frame prefix checksum mismatch" };
+    }
+    const version = view.readUInt16BE(MAGIC.length);
+    const headerLength = view.readUInt32BE(MAGIC.length + 2);
+    const payloadLength = view.readUInt32BE(MAGIC.length + 6);
+    if (version !== VERSION) {
+        return { status: "corrupt", reason: `unsupported frame version ${version}` };
+    }
+    if (headerLength === 0 || headerLength > MAX_HEADER_BYTES || payloadLength > MAX_PAYLOAD_BYTES) {
+        return { status: "corrupt", reason: "invalid frame lengths" };
+    }
+    const frameLength = PREFIX_BYTES + headerLength + payloadLength + HASH_BYTES;
+    if (frameLength > remaining)
+        return { status: "incomplete" };
+    return { status: "frame", headerLength, payloadLength, frameLength };
+}
+/** Step 2: hash and JSON of one complete frame (`frame` is exactly its bytes).
+ * The payload handed out is the parsed object covered by the verified hash. */
+export function decodeFrameBody(frame, headerLength, payloadLength) {
+    const headerStart = PREFIX_BYTES;
+    const payloadStart = headerStart + headerLength;
+    const bodyEnd = payloadStart + payloadLength;
+    const frameHashBytes = createHash("sha256").update(frame.subarray(0, bodyEnd)).digest();
+    if (!frame.subarray(bodyEnd, bodyEnd + HASH_BYTES).equals(frameHashBytes)) {
+        return { status: "corrupt", reason: "frame checksum mismatch" };
+    }
+    let header;
+    let payload;
+    try {
+        header = JSON.parse(frame.subarray(headerStart, payloadStart).toString("utf8"));
+        payload = JSON.parse(frame.subarray(payloadStart, bodyEnd).toString("utf8"));
+    }
+    catch {
+        return { status: "corrupt", reason: "frame JSON is malformed" };
+    }
+    return { status: "frame", header, payload, frameHash: frameHashBytes.toString("hex") };
+}
+/** Step 3: partition/epoch/seq/hash-chain semantics, then logical records.
+ * A compacted snapshot advances the expected sequence by its logical span. */
+export function chainFrame(chain, body, byteOffset, payloadLength) {
+    const { header, payload, frameHash } = body;
+    const semantic = validateHeader(header, chain.partition, chain.epoch, chain.expectedSeq, chain.previous);
+    if (semantic)
+        return { status: "corrupt", reason: semantic };
+    const records = [];
+    const byteLengths = [];
+    if (header.type === COMPACTED_SNAPSHOT) {
+        let compacted;
+        try {
+            compacted = decodeCompactedSnapshot(payload, header.logicalSpan, header.seq);
+        }
+        catch (error) {
+            return { status: "corrupt", reason: `compacted snapshot is invalid: ${String(error)}` };
+        }
+        compacted.forEach((record, index) => {
+            records.push({
+                partition: chain.partition,
+                epoch: header.epoch,
+                seq: record.seq,
+                previousFrameHash: index === 0 ? header.previousFrameHash : frameHash,
+                frameHash,
+                time: record.time,
+                type: record.type,
+                payload: record.payload,
+                byteOffset,
+            });
+            byteLengths.push(record.byteLength);
+        });
+        chain.expectedSeq += header.logicalSpan;
+    }
+    else {
+        records.push({
+            partition: chain.partition,
+            epoch: header.epoch,
+            seq: header.seq,
+            previousFrameHash: header.previousFrameHash,
+            frameHash,
+            time: header.time,
+            type: header.type,
+            payload,
+            byteOffset,
+        });
+        // The `{time,type,payload}` logical form this frame would take in a snapshot.
+        byteLengths.push(28 +
+            Buffer.byteLength(JSON.stringify(header.time)) +
+            Buffer.byteLength(JSON.stringify(header.type)) +
+            payloadLength);
+        chain.expectedSeq += 1;
+    }
+    chain.epoch ??= header.epoch;
+    chain.previous = frameHash;
+    return { status: "frame", records, byteLengths };
+}
+export function encodeFrame(header, payload) {
+    const headerBytes = encodeJson(header);
+    if (headerBytes.length > MAX_HEADER_BYTES)
+        throw new Error("journal header is too large");
+    const prefix = Buffer.alloc(PREFIX_BYTES);
+    MAGIC.copy(prefix);
+    prefix.writeUInt16BE(VERSION, MAGIC.length);
+    prefix.writeUInt32BE(headerBytes.length, MAGIC.length + 2);
+    prefix.writeUInt32BE(payload.length, MAGIC.length + 6);
+    createHash("sha256")
+        .update(prefix.subarray(0, PREFIX_CORE_BYTES))
+        .digest()
+        .subarray(0, PREFIX_CHECKSUM_BYTES)
+        .copy(prefix, PREFIX_CORE_BYTES);
+    const body = Buffer.concat([prefix, headerBytes, payload]);
+    return Buffer.concat([body, createHash("sha256").update(body).digest()]);
+}
+function corrupt(records, offset, reason) {
+    return { records, incompleteOffset: null, error: { offset, reason } };
+}
+function validateHeader(header, partition, epoch, seq, previous) {
+    if (!header || typeof header !== "object")
+        return "frame header is not an object";
+    if (header.partition !== partition)
+        return "frame partition mismatch";
+    if (typeof header.epoch !== "string" || !header.epoch)
+        return "frame epoch is invalid";
+    if (epoch !== null && header.epoch !== epoch)
+        return "frame epoch changed";
+    if (header.seq !== seq)
+        return "frame sequence mismatch";
+    if (header.previousFrameHash !== previous)
+        return "frame hash-chain mismatch";
+    if (typeof header.time !== "string" || !header.time)
+        return "frame timestamp is invalid";
+    if (typeof header.type !== "string" || !header.type)
+        return "frame type is invalid";
+    if (header.type === COMPACTED_SNAPSHOT) {
+        if (!Number.isSafeInteger(header.logicalSpan) || Number(header.logicalSpan) <= 0) {
+            return "compacted snapshot logical span is invalid";
+        }
+    }
+    else if (header.logicalSpan !== undefined)
+        return "ordinary frame declares a logical span";
+    return null;
+}
+/** Legacy snapshots carry no `seq`: exactly `logicalSpan` records numbered from
+ * the header. Seq-preserving snapshots carry one per record, strictly
+ * increasing inside the covered span, so `count <= logicalSpan`. Mixing the two
+ * inside one frame is corruption. */
+function decodeCompactedSnapshot(payload, logicalSpan, firstSeq) {
+    if (!isRecord(payload) || payload.version !== 1 || payload.encoding !== "gzip-base64") {
+        throw new Error("unsupported payload");
+    }
+    const span = logicalSpan;
+    const count = payload.count;
+    if (!Number.isSafeInteger(count) || Number(count) < 0 || Number(count) > span) {
+        throw new Error("record count mismatch");
+    }
+    if (typeof payload.data !== "string")
+        throw new Error("encoded data is missing");
+    const decoded = gunzipSync(Buffer.from(payload.data, "base64"), {
+        maxOutputLength: MAX_COMPACTED_LOGICAL_BYTES,
+    });
+    const records = parseCompactedRecords(decoded, count);
+    // An empty covering chunk can only come from the seq-preserving writer.
+    const numbered = records.length === 0 || records[0].seq !== undefined;
+    let previous = firstSeq - 1;
+    for (const record of records) {
+        if ((record.seq !== undefined) !== numbered)
+            throw new Error("mixed record sequence");
+        if (!numbered) {
+            previous += 1;
+            record.seq = previous;
+            continue;
+        }
+        const seq = record.seq;
+        if (seq <= previous || seq > firstSeq + span - 1)
+            throw new Error("record sequence is invalid");
+        previous = seq;
+    }
+    if (!numbered && records.length !== span)
+        throw new Error("record count mismatch");
+    return records;
+}
+function parseCompactedRecords(bytes, count) {
+    let cursor = skipJsonWhitespace(bytes, 0);
+    if (bytes[cursor] !== 0x5b)
+        throw new Error("invalid records");
+    cursor += 1;
+    const records = [];
+    for (let index = 0; index < count; index += 1) {
+        cursor = skipJsonWhitespace(bytes, cursor);
+        const end = scanCompactedRecord(bytes, cursor);
+        let value;
+        try {
+            // Parse one logical record at a time. Converting the complete decompressed
+            // array to a JavaScript string is what overflows on large valid journals.
+            value = JSON.parse(bytes.subarray(cursor, end).toString("utf8"));
+        }
+        catch {
+            throw new Error("invalid records");
+        }
+        records.push({ ...validateCompactedRecord(value), byteLength: end - cursor });
+        cursor = skipJsonWhitespace(bytes, end);
+        const separator = bytes[cursor];
+        if (index + 1 < count) {
+            if (separator !== 0x2c)
+                throw new Error("invalid records");
+            cursor += 1;
+        }
+        else {
+            if (separator !== 0x5d)
+                throw new Error("invalid records");
+            cursor += 1;
+        }
+    }
+    if (count === 0) {
+        cursor = skipJsonWhitespace(bytes, cursor);
+        if (bytes[cursor] !== 0x5d)
+            throw new Error("invalid records");
+        cursor += 1;
+    }
+    cursor = skipJsonWhitespace(bytes, cursor);
+    if (cursor !== bytes.length)
+        throw new Error("invalid records");
+    return records;
+}
+function validateCompactedRecord(record) {
+    if (!isRecord(record) ||
+        typeof record.time !== "string" ||
+        typeof record.type !== "string" ||
+        !record.type ||
+        record.type === COMPACTED_SNAPSHOT ||
+        (record.seq !== undefined && (!Number.isSafeInteger(record.seq) || Number(record.seq) < 1))) {
+        throw new Error("invalid logical record");
+    }
+    const logical = {
+        time: record.time,
+        type: record.type,
+        payload: record.payload,
+    };
+    if (record.seq !== undefined)
+        logical.seq = record.seq;
+    return logical;
+}
+function scanCompactedRecord(bytes, start) {
+    if (bytes[start] !== 0x7b)
+        throw new Error("invalid records");
+    const stack = [];
+    let inString = false;
+    let escaped = false;
+    for (let cursor = start; cursor < bytes.length; cursor += 1) {
+        const value = bytes[cursor];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (value === 0x5c)
+                escaped = true;
+            else if (value === 0x22)
+                inString = false;
+            continue;
+        }
+        if (value === 0x22) {
+            inString = true;
+            continue;
+        }
+        if (value === 0x7b || value === 0x5b) {
+            stack.push(value);
+            continue;
+        }
+        if (value !== 0x7d && value !== 0x5d)
+            continue;
+        const opening = stack.pop();
+        if ((value === 0x7d && opening !== 0x7b) || (value === 0x5d && opening !== 0x5b)) {
+            throw new Error("invalid records");
+        }
+        if (stack.length === 0)
+            return cursor + 1;
+    }
+    throw new Error("invalid records");
+}
+function skipJsonWhitespace(bytes, start) {
+    let cursor = start;
+    while (cursor < bytes.length &&
+        (bytes[cursor] === 0x20 ||
+            bytes[cursor] === 0x09 ||
+            bytes[cursor] === 0x0a ||
+            bytes[cursor] === 0x0d)) {
+        cursor += 1;
+    }
+    return cursor;
+}
+function encodeJson(value) {
+    const encoded = JSON.stringify(value);
+    if (encoded === undefined)
+        throw new Error("journal value is not JSON serializable");
+    return Buffer.from(encoded);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=frame-codec.js.map

package/dist/store/legacy-journal/frame-codec.js.map

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

package/dist/store/legacy-journal/frame-reader.d.ts

@@ -0,0 +1,30 @@
+import { type JournalRecord } from "./frame-codec.js";
+import { type JournalFold } from "./journal-fold.js";
+export interface FrameReadOptions {
+    /** Treat the file as ending at this byte (an append intent's prefix). */
+    limit?: number;
+    fold?: JournalFold;
+}
+/** Disk chain state comes from the LAST FRAME ON DISK, never from the last
+ * retained record: a fold may drop that frame, and the next append must still
+ * chain to it. */
+export interface FrameReadResult {
+    retained: JournalRecord[];
+    epoch: string | null;
+    nextSeq: number;
+    previousFrameHash: string;
+    knownFileBytes: number;
+    incompleteOffset: number | null;
+    error: {
+        offset: number;
+        reason: string;
+    } | null;
+    retiredCount: number;
+    retiredBytes: number;
+}
+/** Positional frame-at-a-time reader over a descriptor: bounded buffers, the
+ * same prefix/hash/chain/epoch/seq validation as `replayFrames`, optional fold
+ * applied while streaming. Throws when the file shrinks underneath the read. */
+export declare function readFrames(fd: number, partition: string, options?: FrameReadOptions): FrameReadResult;
+export declare function descriptorSize(fd: number): number;
+//# sourceMappingURL=frame-reader.d.ts.map

package/dist/store/legacy-journal/frame-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-reader.d.ts","sourceRoot":"","sources":["../../../src/store/legacy-journal/frame-reader.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKjE,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;kBAEkB;AAClB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;gFAEgF;AAChF,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CA4DjB;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD"}

package/dist/store/legacy-journal/frame-reader.js

@@ -0,0 +1,97 @@
+import { fstatSync, readSync } from "node:fs";
+import { PREFIX_BYTES, chainFrame, decodeFrameBody, newFrameChain, readFramePrefix, } from "./frame-codec.js";
+import { foldStream } from "./journal-fold.js";
+// Read-ahead window; a frame larger than the window gets its own exact buffer.
+const WINDOW_BYTES = 4 * 1024 * 1024;
+/** Positional frame-at-a-time reader over a descriptor: bounded buffers, the
+ * same prefix/hash/chain/epoch/seq validation as `replayFrames`, optional fold
+ * applied while streaming. Throws when the file shrinks underneath the read. */
+export function readFrames(fd, partition, options = {}) {
+    const size = descriptorSize(fd);
+    const end = options.limit === undefined ? size : Math.min(size, options.limit);
+    const window = new PositionalWindow(fd, end);
+    const chain = newFrameChain(partition);
+    const sink = foldStream(options.fold);
+    let offset = 0;
+    let incompleteOffset = null;
+    let error = null;
+    while (offset < end) {
+        const remaining = end - offset;
+        const prefix = readFramePrefix(window.view(offset, Math.min(PREFIX_BYTES, remaining)), remaining);
+        if (prefix.status === "incomplete") {
+            incompleteOffset = offset;
+            break;
+        }
+        if (prefix.status === "corrupt") {
+            error = { offset, reason: prefix.reason };
+            break;
+        }
+        const body = decodeFrameBody(window.view(offset, prefix.frameLength), prefix.headerLength, prefix.payloadLength);
+        if (body.status === "corrupt") {
+            error = { offset, reason: body.reason };
+            break;
+        }
+        const chained = chainFrame(chain, body, offset, prefix.payloadLength);
+        if (chained.status === "corrupt") {
+            error = { offset, reason: chained.reason };
+            break;
+        }
+        chained.records.forEach((record, index) => sink.push(record, {
+            seq: record.seq,
+            type: record.type,
+            time: record.time,
+            payload: record.payload,
+            byteLength: chained.byteLengths[index],
+        }));
+        offset += prefix.frameLength;
+    }
+    const folded = sink.finish();
+    return {
+        retained: folded.retained,
+        epoch: chain.epoch,
+        nextSeq: chain.expectedSeq,
+        previousFrameHash: chain.previous,
+        knownFileBytes: offset,
+        incompleteOffset,
+        error,
+        retiredCount: folded.retiredCount,
+        retiredBytes: folded.retiredBytes,
+    };
+}
+export function descriptorSize(fd) {
+    const size = Number(fstatSync(fd, { bigint: true }).size);
+    if (!Number.isSafeInteger(size) || size < 0)
+        throw new Error("journal file size is invalid");
+    return size;
+}
+class PositionalWindow {
+    fd;
+    end;
+    buffer = Buffer.alloc(0);
+    start = 0;
+    length = 0;
+    constructor(fd, end) {
+        this.fd = fd;
+        this.end = end;
+    }
+    /** A view of `[offset, offset + length)`; valid until the next call. */
+    view(offset, length) {
+        if (offset >= this.start && offset + length <= this.start + this.length) {
+            return this.buffer.subarray(offset - this.start, offset - this.start + length);
+        }
+        const wanted = Math.min(Math.max(WINDOW_BYTES, length), this.end - offset);
+        if (this.buffer.length < wanted)
+            this.buffer = Buffer.allocUnsafe(wanted);
+        let filled = 0;
+        while (filled < wanted) {
+            const read = readSync(this.fd, this.buffer, filled, wanted - filled, offset + filled);
+            if (read === 0)
+                throw new Error("journal changed while being read");
+            filled += read;
+        }
+        this.start = offset;
+        this.length = wanted;
+        return this.buffer.subarray(0, length);
+    }
+}
+//# sourceMappingURL=frame-reader.js.map

package/dist/store/legacy-journal/frame-reader.js.map

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