@peerbit/native-backbone 0.1.4 → 0.2.0

package/dist/src/durability/storage.js

@@ -0,0 +1,343 @@
+import { NATIVE_DURABILITY_MAX_U64, NATIVE_DURABILITY_MAX_WRITER_ID_BYTES, } from "./lease.js";
+export const NATIVE_DURABILITY_STORAGE_VERSION = 1;
+export const NATIVE_DURABILITY_MAX_TRANSACTION_ID_BYTES = 1024;
+export class NativeDurabilityStorageUnsupportedError extends Error {
+    code = "ERR_NATIVE_DURABILITY_STORAGE_UNSUPPORTED";
+    constructor(message) {
+        super(message);
+        this.name = "NativeDurabilityStorageUnsupportedError";
+    }
+}
+export class NativeDurabilityMigrationRequiredError extends Error {
+    directory;
+    code = "ERR_NATIVE_DURABILITY_MIGRATION_REQUIRED";
+    constructor(directory) {
+        super(`Native crash-safe durability requires an explicit migration for nonempty program directory: ${directory}`);
+        this.directory = directory;
+        this.name = "NativeDurabilityMigrationRequiredError";
+    }
+}
+export class NativeDurabilityStorageClosedError extends Error {
+    code = "ERR_NATIVE_DURABILITY_STORAGE_CLOSED";
+    constructor() {
+        super("Native durability storage is closed");
+        this.name = "NativeDurabilityStorageClosedError";
+    }
+}
+export class NativeDurabilityStorageCorruptionError extends Error {
+    cause;
+    code = "ERR_NATIVE_DURABILITY_STORAGE_CORRUPTION";
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = "NativeDurabilityStorageCorruptionError";
+    }
+}
+export class NativeDurabilityDigestMismatchError extends Error {
+    subject;
+    code = "ERR_NATIVE_DURABILITY_DIGEST_MISMATCH";
+    constructor(subject) {
+        super(`Native durability digest mismatch for ${subject}`);
+        this.subject = subject;
+        this.name = "NativeDurabilityDigestMismatchError";
+    }
+}
+export class NativeDurabilityJournalOffsetConflictError extends Error {
+    expectedOffset;
+    actualOffset;
+    code = "ERR_NATIVE_DURABILITY_JOURNAL_OFFSET_CONFLICT";
+    constructor(expectedOffset, actualOffset) {
+        super(`Native durability journal offset conflict: expected ${expectedOffset}, found ${actualOffset}`);
+        this.expectedOffset = expectedOffset;
+        this.actualOffset = actualOffset;
+        this.name = "NativeDurabilityJournalOffsetConflictError";
+    }
+}
+export class NativeDurabilityOutcomeUnknownError extends Error {
+    operation;
+    transactionId;
+    txSequence;
+    cause;
+    code = "ERR_NATIVE_DURABILITY_OUTCOME_UNKNOWN";
+    outcome = "unknown";
+    constructor(operation, transactionId, txSequence, cause) {
+        super(`Native durability ${operation} outcome is unknown for transaction ${transactionId}`);
+        this.operation = operation;
+        this.transactionId = transactionId;
+        this.txSequence = txSequence;
+        this.cause = cause;
+        this.name = "NativeDurabilityOutcomeUnknownError";
+    }
+}
+export class NativeDurabilityIncompleteTailMismatchError extends Error {
+    code = "ERR_NATIVE_DURABILITY_INCOMPLETE_TAIL_MISMATCH";
+    constructor(message) {
+        super(message);
+        this.name = "NativeDurabilityIncompleteTailMismatchError";
+    }
+}
+export const copyNativeDurabilityBytes = (bytes) => new Uint8Array(bytes);
+export const nativeDurabilityBytesEqual = (left, right) => {
+    if (left.byteLength !== right.byteLength)
+        return false;
+    for (let i = 0; i < left.byteLength; i++) {
+        if (left[i] !== right[i])
+            return false;
+    }
+    return true;
+};
+export const nativeDurabilityDigestHex = (digest) => Array.from(digest, (byte) => byte.toString(16).padStart(2, "0")).join("");
+export const nativeDurabilityDigestFromHex = (value) => {
+    if (!/^[0-9a-f]{64}$/.test(value)) {
+        throw new NativeDurabilityStorageCorruptionError("Native durability digest must be 32 lowercase hexadecimal bytes");
+    }
+    const bytes = new Uint8Array(32);
+    for (let i = 0; i < bytes.byteLength; i++) {
+        bytes[i] = Number.parseInt(value.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+};
+const canonicalValue = (value) => {
+    if (typeof value === "bigint")
+        return { bigint: value.toString() };
+    if (value instanceof Uint8Array) {
+        return { bytes: nativeDurabilityDigestHex(value) };
+    }
+    if (Array.isArray(value))
+        return value.map(canonicalValue);
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+            .map(([key, entry]) => [key, canonicalValue(entry)]));
+    }
+    return value;
+};
+export const encodeNativeDurabilityCanonical = (value) => new TextEncoder().encode(JSON.stringify(canonicalValue(value)));
+export const sha256NativeDurability = async (bytes) => {
+    if (!globalThis.crypto?.subtle) {
+        throw new NativeDurabilityStorageUnsupportedError("SHA-256 requires Web Crypto in the memory durability adapter");
+    }
+    const input = new Uint8Array(bytes.byteLength);
+    input.set(bytes);
+    return new Uint8Array(await globalThis.crypto.subtle.digest("SHA-256", input.buffer));
+};
+export const assertNativeDurabilityDigest = async (subject, bytes, expected) => {
+    if (expected.byteLength !== 32) {
+        throw new NativeDurabilityDigestMismatchError(subject);
+    }
+    const actual = await sha256NativeDurability(bytes);
+    if (!nativeDurabilityBytesEqual(actual, expected)) {
+        throw new NativeDurabilityDigestMismatchError(subject);
+    }
+};
+export const nativeDurabilityScopeDigest = async (value) => sha256NativeDurability(encodeNativeDurabilityCanonical(value));
+const assertU64 = (name, value) => {
+    if (typeof value !== "bigint" ||
+        value < 0n ||
+        value > NATIVE_DURABILITY_MAX_U64) {
+        throw new TypeError(`${name} must be an unsigned 64-bit bigint`);
+    }
+};
+export const assertNativeDurabilityOperationScope = (scope) => {
+    if (!scope ||
+        typeof scope.transactionId !== "string" ||
+        !scope.transactionId) {
+        throw new TypeError("transactionId must be a non-empty string");
+    }
+    if (new TextEncoder().encode(scope.transactionId).byteLength >
+        NATIVE_DURABILITY_MAX_TRANSACTION_ID_BYTES) {
+        throw new TypeError("transactionId exceeds the journal format limit");
+    }
+    assertU64("txSequence", scope.txSequence);
+    assertU64("recordLsn", scope.recordLsn);
+};
+export const assertNativeDurabilityFence = (fence) => {
+    if (!fence ||
+        typeof fence.ownerId !== "string" ||
+        !fence.ownerId ||
+        typeof fence.domainId !== "string" ||
+        !fence.domainId) {
+        throw new TypeError("Durability fence ownerId/domainId must be non-empty");
+    }
+    if (new TextEncoder().encode(fence.ownerId).byteLength >
+        NATIVE_DURABILITY_MAX_WRITER_ID_BYTES ||
+        new TextEncoder().encode(fence.domainId).byteLength >
+            NATIVE_DURABILITY_MAX_WRITER_ID_BYTES) {
+        throw new TypeError("Durability fence ownerId/domainId exceeds format limit");
+    }
+    assertU64("fence.epoch", fence.epoch);
+    if (fence.epoch === 0n) {
+        throw new TypeError("Durability fence epoch must be non-zero");
+    }
+};
+export const assertNativeDurabilityStageRequest = (request) => {
+    assertNativeDurabilityOperationScope(request?.scope);
+    if (request.scope.txSequence === 0n || request.scope.recordLsn === 0n) {
+        throw new RangeError("Staging txSequence and recordLsn must be non-zero");
+    }
+    if (!Array.isArray(request.blocks)) {
+        throw new TypeError("Staging blocks must be an array");
+    }
+    const sorted = [...request.blocks].sort((left, right) => left.ordinal - right.ordinal);
+    for (let index = 0; index < sorted.length; index++) {
+        const block = sorted[index];
+        if (block.ordinal !== index) {
+            throw new RangeError("Staging ordinals must be contiguous from zero");
+        }
+        if (typeof block.cid !== "string" || !block.cid) {
+            throw new TypeError(`Staging block ${index} has an invalid CID`);
+        }
+        if (!(block.bytes instanceof Uint8Array)) {
+            throw new TypeError(`Staging block ${index} bytes must be Uint8Array`);
+        }
+        if (!(block.digest instanceof Uint8Array) ||
+            block.digest.byteLength !== 32) {
+            throw new TypeError(`Staging block ${index} digest must be 32 bytes`);
+        }
+    }
+};
+export const assertNativeDurabilityJournalAppendRequest = (request) => {
+    if (!request ||
+        typeof request.transactionId !== "string" ||
+        !request.transactionId) {
+        throw new TypeError("transactionId must be a non-empty string");
+    }
+    if (new TextEncoder().encode(request.transactionId).byteLength >
+        NATIVE_DURABILITY_MAX_TRANSACTION_ID_BYTES) {
+        throw new TypeError("transactionId exceeds the journal format limit");
+    }
+    assertU64("txSequence", request.txSequence);
+    assertU64("firstRecordLsn", request.firstRecordLsn);
+    assertU64("lastRecordLsn", request.lastRecordLsn);
+    if (request.txSequence === 0n ||
+        request.firstRecordLsn === 0n ||
+        request.lastRecordLsn === 0n) {
+        throw new RangeError("Journal sequence and LSN values must be non-zero");
+    }
+    if (request.lastRecordLsn < request.firstRecordLsn) {
+        throw new RangeError("lastRecordLsn must not precede firstRecordLsn");
+    }
+    if (!Number.isSafeInteger(request.expectedOffset) ||
+        request.expectedOffset < 0) {
+        throw new RangeError("expectedOffset must be a non-negative safe integer");
+    }
+    if (!(request.frames instanceof Uint8Array) ||
+        request.frames.byteLength === 0) {
+        throw new TypeError("Journal frames must be a non-empty Uint8Array");
+    }
+    if (!(request.framesDigest instanceof Uint8Array) ||
+        request.framesDigest.byteLength !== 32) {
+        throw new TypeError("framesDigest must be 32 bytes");
+    }
+};
+export const assertNativeDurabilityCheckpointRequest = (request) => {
+    assertNativeDurabilityOperationScope(request?.scope);
+    assertU64("checkpointLsn", request.checkpointLsn);
+    assertU64("txSequenceHighwater", request.txSequenceHighwater);
+    if (request.scope.txSequence === 0n ||
+        request.scope.recordLsn === 0n ||
+        request.scope.recordLsn > request.checkpointLsn ||
+        request.scope.txSequence > request.txSequenceHighwater) {
+        throw new RangeError("Checkpoint scope cannot exceed its LSN or transaction highwater");
+    }
+    if (!(request.bytes instanceof Uint8Array)) {
+        throw new TypeError("Checkpoint bytes must be Uint8Array");
+    }
+    if (!(request.digest instanceof Uint8Array) ||
+        request.digest.byteLength !== 32) {
+        throw new TypeError("Checkpoint digest must be 32 bytes");
+    }
+    if (!Array.isArray(request.stagingCoverage)) {
+        throw new TypeError("Checkpoint stagingCoverage must be an array");
+    }
+    const transactionIds = new Set();
+    for (const coverage of request.stagingCoverage) {
+        if (typeof coverage.transactionId !== "string" ||
+            !coverage.transactionId ||
+            transactionIds.has(coverage.transactionId)) {
+            throw new TypeError("Checkpoint staging coverage transaction IDs must be unique");
+        }
+        transactionIds.add(coverage.transactionId);
+        assertU64("coverage.txSequence", coverage.txSequence);
+        assertU64("coverage.coveredThroughLsn", coverage.coveredThroughLsn);
+        if (coverage.coveredThroughLsn > request.checkpointLsn) {
+            throw new RangeError("Staging coverage cannot extend beyond checkpointLsn");
+        }
+        if (new TextEncoder().encode(coverage.transactionId).byteLength >
+            NATIVE_DURABILITY_MAX_TRANSACTION_ID_BYTES ||
+            !(coverage.stagingManifestDigest instanceof Uint8Array) ||
+            coverage.stagingManifestDigest.byteLength !== 32) {
+            throw new TypeError("Checkpoint staging coverage fields exceed their format limits");
+        }
+    }
+    if (!Array.isArray(request.retainedTransactions)) {
+        throw new TypeError("Checkpoint retainedTransactions must be an array");
+    }
+    const retainedIds = new Set();
+    const retainedSequences = new Set();
+    for (const retained of request.retainedTransactions) {
+        assertU64("retained transaction sequence", retained.txSequence);
+        if (retained.txSequence === 0n ||
+            retained.txSequence > request.txSequenceHighwater ||
+            typeof retained.transactionId !== "string" ||
+            !retained.transactionId ||
+            new TextEncoder().encode(retained.transactionId).byteLength >
+                NATIVE_DURABILITY_MAX_TRANSACTION_ID_BYTES ||
+            retainedIds.has(retained.transactionId) ||
+            retainedSequences.has(retained.txSequence) ||
+            !Number.isInteger(retained.phase) ||
+            retained.phase < 1 ||
+            retained.phase > 6 ||
+            !Number.isInteger(retained.operationKind) ||
+            retained.operationKind < 1 ||
+            retained.operationKind > 5 ||
+            !(retained.planDigest instanceof Uint8Array) ||
+            retained.planDigest.byteLength !== 32) {
+            throw new TypeError("Checkpoint retained transaction is invalid");
+        }
+        retainedIds.add(retained.transactionId);
+        retainedSequences.add(retained.txSequence);
+    }
+    for (const coverage of request.stagingCoverage) {
+        const retained = request.retainedTransactions.find((candidate) => candidate.transactionId === coverage.transactionId);
+        if (!retained ||
+            retained.txSequence !== coverage.txSequence ||
+            retained.phase !== 6) {
+            throw new TypeError("Checkpoint staging coverage requires the exact retained CLEAN transaction");
+        }
+    }
+};
+export const assertNativeDurabilityDeleteRequest = (request) => {
+    assertNativeDurabilityOperationScope(request?.scope);
+    if (!Array.isArray(request.targets) || request.targets.length === 0) {
+        throw new TypeError("Delete targets must be a non-empty array");
+    }
+    if (request.scope.txSequence === 0n || request.scope.recordLsn === 0n) {
+        throw new RangeError("Delete scope sequence and LSN must be non-zero");
+    }
+    const targetKeys = new Set();
+    for (const target of request.targets) {
+        if (target.kind === "staging") {
+            if (typeof target.transactionId !== "string" ||
+                !target.transactionId ||
+                new TextEncoder().encode(target.transactionId).byteLength >
+                    NATIVE_DURABILITY_MAX_TRANSACTION_ID_BYTES) {
+                throw new TypeError("Staging delete transactionId must be non-empty");
+            }
+        }
+        else if (target.kind === "checkpoint") {
+            assertU64("checkpoint generation", target.generation);
+        }
+        else {
+            throw new TypeError("Unknown native durability delete target");
+        }
+        const key = target.kind === "staging"
+            ? `staging:${target.transactionId}`
+            : `checkpoint:${target.generation}`;
+        if (targetKeys.has(key)) {
+            throw new TypeError("Delete targets must be unique");
+        }
+        targetKeys.add(key);
+    }
+};
+//# sourceMappingURL=storage.js.map

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

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

package/dist/src/index.d.ts

@@ -1,3 +1,9 @@
+export * from "./durability/codec.js";
+export * from "./durability/lease.js";
+export * from "./durability/memory-storage.js";
+export * from "./durability/node-lease.js";
+export * from "./durability/node-storage.js";
+export * from "./durability/storage.js";
 export type RangeResolution = "u32" | "u64";
 type NativePeerbitBackboneHandle = {
     log_len: () => number;
@@ -920,23 +926,64 @@ export type NativeBackboneCoordinatePersistenceStore = {
     /**
      * Appends `bytes` to the named file. Callers hand over ownership of
      * `bytes` and must not mutate it afterwards: buffering stores keep the
-     * array until their next flush instead of copying it.
+     * array until their next flush instead of copying it. A rejected append
+     * must either leave the file unchanged or make later appends fail closed.
      */
     append(name: string, bytes: Uint8Array): Promise<void>;
     remove?(name: string): Promise<void>;
-    flush?(): Promise<void>;
-    close?(): Promise<void>;
+    /** Explicit physical durability barrier; its presence is a capability. */
+    durableBarrier?(name?: string): Promise<void>;
+    /** Override removal inference for wrappers whose remove method is conditional. */
+    supportsRemoval?: boolean;
+    /** Flush one named file when supported, otherwise the complete store. */
+    flush?(name?: string): Promise<void>;
+    close?(options?: {
+        flush?: boolean;
+    }): Promise<void>;
 };
 export type NativeBackboneCoordinatePersistenceAdapter = {
+    /**
+     * Optional durable capability used by higher layers for atomic operation
+     * intents that must share this persistence lifecycle.
+     */
+    intentStore?: NativeBackboneCoordinatePersistenceStore;
     flushOnAppend?: boolean;
     flushMaxPendingBytes?: number;
     flushIntervalMs?: number;
     compactMaxJournalBytes?: number;
     compactMaxJournalRecords?: number;
+    /** Explicit opt-in for a generation-based, crash-atomic compaction protocol. */
+    crashSafeCompaction?: boolean;
+    /** Every acknowledged WAL/intent write crosses a physical durability barrier. */
+    durableBarrier?: boolean;
+    /** Drop is implemented by the underlying namespace, not only by a wrapper. */
+    supportsDrop?: boolean;
+    /** A successful drop owns handle cleanup and must not need ordinary close(). */
+    dropIsTerminal?: boolean;
     hydrate(backbone: NativePeerbitBackbone): Promise<number>;
     flushJournal(backbone: NativePeerbitBackbone): Promise<number>;
     flushJournalOnAppend?(backbone: NativePeerbitBackbone): number | Promise<number>;
     compact?(backbone: NativePeerbitBackbone): Promise<void>;
+    /**
+     * Durably erase this adapter's configured files and any additional files
+     * sharing the same namespace. A tombstone makes interrupted erases resumable.
+     */
+    drop?(additionalFiles?: readonly string[]): Promise<void>;
+    /**
+     * Complete an interrupted drop before hydration or on the same adapter
+     * generation after `drop()` rejected. Returning `true` means the tombstoned
+     * erase completed: this generation remains terminal only if it initiated that
+     * drop, while recovery of a prior generation's marker returns to active.
+     * Returning `false` means no durable marker exists and an explicit `drop()`
+     * may start again; a generation that already initiated drop remains fenced
+     * from ordinary hydrate/flush work until that destructive retry completes.
+     * A corrupt/invalid marker rejection must likewise restore the adapter to an
+     * explicit-drop-admitting state so drop can overwrite it; transient I/O
+     * failures may keep the generation in its resumable dropping state. Once
+     * close is admitted, no new resume may queue behind terminal store teardown.
+     */
+    resumeDrop?(): Promise<boolean>;
+    /** A rejected close may be retried to resume its first incomplete store stage. */
     close?(): Promise<void>;
 };
 export type NativeBackboneCoordinatePersistenceConfig = NativeBackboneCoordinatePersistenceAdapter | (NativeBackboneCoordinatePersistenceOptions & {
@@ -956,7 +1003,9 @@ export type NativeBackboneNodeCoordinatePersistenceOptions = NativeBackboneCoord
     fs?: NativeBackboneNodeFs;
     writeBufferMaxBytes?: number;
 };
+export declare const nativeBackboneCoordinateDropTombstoneFile = "native-backbone-drop.tombstone";
 export declare const defaultNativeBackboneCoordinateFlushMaxPendingBytes: number;
+/** @deprecated Built-in coordinate persistence compaction is currently disabled. */
 export declare const defaultNativeBackboneCoordinateCompactMaxJournalBytes: number;
 type NativeBackboneNodeFs = {
     mkdir(path: string, options?: {
@@ -971,7 +1020,10 @@ type NativeBackboneNodeFs = {
     }): Promise<unknown>;
 };
 type NativeBackboneNodeAppendFileHandle = {
-    write(data: Uint8Array): Promise<unknown>;
+    write(data: Uint8Array): Promise<{
+        bytesWritten: number;
+    }>;
+    sync?(): Promise<unknown>;
     close(): Promise<unknown>;
 };
 type NativeBackboneOPFSFile = {
@@ -983,6 +1035,7 @@ type NativeBackboneOPFSSyncAccessHandle = {
     write(buffer: Uint8Array, options?: {
         at?: number;
     }): number;
+    truncate?(size: number): void;
     flush?(): void;
     close(): void;
 };
@@ -1463,6 +1516,7 @@ export declare class NativeBackboneMemoryCoordinatePersistenceStore implements N
     write(name: string, bytes: Uint8Array): Promise<void>;
     append(name: string, bytes: Uint8Array): Promise<void>;
     remove(name: string): Promise<void>;
+    flush(_name?: string): Promise<void>;
 }
 export declare class NativeBackboneNodeCoordinatePersistenceStore implements NativeBackboneCoordinatePersistenceStore {
     private readonly directory;
@@ -1470,6 +1524,8 @@ export declare class NativeBackboneNodeCoordinatePersistenceStore implements Nat
     private readonly appendHandles;
     private readonly filePaths;
     private directoryEnsured;
+    private appendFailure;
+    readonly durableBarrier?: (name?: string) => Promise<void>;
     constructor(directory: string, fs?: NativeBackboneNodeFs | undefined);
     private nodeFs;
     private filePath;
@@ -1480,10 +1536,13 @@ export declare class NativeBackboneNodeCoordinatePersistenceStore implements Nat
     write(name: string, bytes: Uint8Array): Promise<void>;
     append(name: string, bytes: Uint8Array): Promise<void>;
     remove(name: string): Promise<void>;
+    flush(name?: string): Promise<void>;
+    private syncDurably;
     close(): Promise<void>;
 }
 export declare class NativeBackboneOPFSCoordinatePersistenceStore implements NativeBackboneCoordinatePersistenceStore {
     private readonly directory;
+    private appendFailure;
     constructor(directory: NativeBackboneOPFSDirectoryHandle);
     static create(options?: {
         root?: NativeBackboneOPFSDirectoryHandle;
@@ -1495,12 +1554,16 @@ export declare class NativeBackboneOPFSCoordinatePersistenceStore implements Nat
     write(name: string, bytes: Uint8Array): Promise<void>;
     append(name: string, bytes: Uint8Array): Promise<void>;
     remove(name: string): Promise<void>;
+    flush(_name?: string): Promise<void>;
+    durableBarrier(name?: string): Promise<void>;
 }
 export declare class NativeBackboneBufferedCoordinatePersistenceStore implements NativeBackboneCoordinatePersistenceStore {
     private readonly inner;
     private readonly options;
     private readonly buffers;
     private bufferedBytes;
+    readonly supportsRemoval: boolean;
+    readonly durableBarrier?: (name?: string) => Promise<void>;
     constructor(inner: NativeBackboneCoordinatePersistenceStore, options?: {
         maxBufferedBytes?: number;
     });
@@ -1510,7 +1573,9 @@ export declare class NativeBackboneBufferedCoordinatePersistenceStore implements
     append(name: string, bytes: Uint8Array): Promise<void>;
     remove(name: string): Promise<void>;
     flush(name?: string): Promise<void>;
-    close(): Promise<void>;
+    close(options?: {
+        flush?: boolean;
+    }): Promise<void>;
 }
 export declare class NativeBackboneCoordinatePersistence {
     private readonly store;
@@ -1519,6 +1584,10 @@ export declare class NativeBackboneCoordinatePersistence {
     readonly flushIntervalMs?: number;
     readonly compactMaxJournalBytes?: number;
     readonly compactMaxJournalRecords?: number;
+    readonly crashSafeCompaction = false;
+    readonly durableBarrier: boolean;
+    readonly supportsDrop: boolean;
+    readonly dropIsTerminal = true;
     private readonly snapshotFile;
     private readonly journalFile;
     private readonly documentSnapshotFile;
@@ -1526,26 +1595,36 @@ export declare class NativeBackboneCoordinatePersistence {
     private readonly documentSignerSnapshotFile;
     private readonly documentSignerJournalFile;
     private journalInitialized;
-    private journalByteLength;
-    private journalRecordCount;
     private documentJournalInitialized;
-    private documentJournalByteLength;
-    private documentJournalRecordCount;
     private documentSignerJournalInitialized;
-    private documentSignerJournalByteLength;
-    private documentSignerJournalRecordCount;
     private lastFlushMs;
     private persistenceQueue;
+    private persistenceLifecycle;
+    private dropInitiatedOnGeneration;
+    private persistenceFailure;
+    private closeMode;
+    private closeFlushCompleted;
+    private closeStoreCompleted;
+    private closePromise;
     constructor(store: NativeBackboneCoordinatePersistenceStore, options?: NativeBackboneCoordinatePersistenceOptions);
+    /** Durable operation-intent capability for strict shared-log transactions. */
+    get intentStore(): NativeBackboneCoordinatePersistenceStore;
+    private configuredFiles;
+    private assertLifecycleActive;
+    private assertActive;
+    private resetJournalTracking;
+    private eraseDropFiles;
+    drop(additionalFiles?: readonly string[]): Promise<void>;
+    resumeDrop(): Promise<boolean>;
     hydrate(backbone: NativePeerbitBackbone): Promise<number>;
+    private assertHydrating;
+    private resumeDropInternal;
     shouldFlushJournalOnAppend(backbone: NativePeerbitBackbone, now?: number): boolean;
     flushJournalOnAppend(backbone: NativePeerbitBackbone): number | Promise<number>;
     flushJournal(backbone: NativePeerbitBackbone): Promise<number>;
     private enqueuePersistence;
     private flushJournalInternal;
-    private shouldCompactJournal;
-    compact(backbone: NativePeerbitBackbone): Promise<void>;
-    private compactInternal;
+    compact(_backbone: NativePeerbitBackbone): Promise<void>;
     close(): Promise<void>;
 }
 export declare class NativeBackboneNodeCoordinatePersistence extends NativeBackboneCoordinatePersistence {
@@ -1557,5 +1636,4 @@ export declare const createNativeBackboneCoordinatePersistence: (config: NativeB
 export declare const createBufferedNativeBackboneCoordinatePersistence: (store: NativeBackboneCoordinatePersistenceStore, options?: NativeBackboneBufferedCoordinatePersistenceOptions) => NativeBackboneCoordinatePersistenceAdapter;
 export declare const createBufferedNativeBackboneNodeCoordinatePersistence: (directory: string, options?: NativeBackboneNodeCoordinatePersistenceOptions) => NativeBackboneCoordinatePersistenceAdapter;
 export declare const createNativePeerbitBackbone: typeof NativePeerbitBackbone.create;
-export {};
 //# sourceMappingURL=index.d.ts.map