@peerbit/native-backbone 0.1.4 → 0.2.0

package/dist/src/durability/node-lease.js

@@ -0,0 +1,214 @@
+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;
+};
+import { NATIVE_DURABILITY_MAX_U64, NATIVE_DURABILITY_MAX_WRITER_ID_BYTES, NativeDurabilityFenceExhaustedError, NativeDurabilityLeaseClosedError, NativeDurabilityLeaseDirectorySyncError, NativeDurabilityLeaseStateError, NativeDurabilityLeaseUnavailableError, } from "./lease.js";
+export const NATIVE_DURABILITY_NODE_LEASE_DIRECTORY_NAME = ".peerbit-native-durability-lease";
+const LEASE_STATE_KEY = "fence";
+const LEASE_STATE_VERSION = 1;
+const dynamicImport = (specifier) => import(__rewriteRelativeImportExtension(/* @vite-ignore */ specifier));
+const importClassicLevel = async () => {
+    const module = await dynamicImport("classic-level");
+    return module.ClassicLevel;
+};
+const hasErrorCode = (error, expected) => {
+    const visited = new Set();
+    let current = error;
+    while (current != null &&
+        typeof current === "object" &&
+        !visited.has(current)) {
+        visited.add(current);
+        if (current.code === expected) {
+            return true;
+        }
+        current = current.cause;
+    }
+    return false;
+};
+const isMissingKeyError = (error) => hasErrorCode(error, "LEVEL_NOT_FOUND");
+const decodeLeaseState = (encoded, directory) => {
+    let decoded;
+    try {
+        decoded = JSON.parse(encoded);
+    }
+    catch (error) {
+        throw new NativeDurabilityLeaseStateError(directory, `Invalid native durability lease state in ${directory}`, { cause: error });
+    }
+    const value = decoded;
+    if (value?.version !== LEASE_STATE_VERSION ||
+        typeof value.epoch !== "string" ||
+        !/^(0|[1-9][0-9]*)$/.test(value.epoch) ||
+        BigInt(value.epoch) > NATIVE_DURABILITY_MAX_U64 ||
+        typeof value.ownerId !== "string" ||
+        value.ownerId.length === 0 ||
+        new TextEncoder().encode(value.ownerId).byteLength >
+            NATIVE_DURABILITY_MAX_WRITER_ID_BYTES ||
+        typeof value.domainId !== "string" ||
+        value.domainId.length === 0 ||
+        new TextEncoder().encode(value.domainId).byteLength >
+            NATIVE_DURABILITY_MAX_WRITER_ID_BYTES) {
+        throw new NativeDurabilityLeaseStateError(directory, `Invalid native durability lease state in ${directory}`);
+    }
+    return value;
+};
+const readLeaseState = async (database, directory) => {
+    try {
+        const encoded = await database.get(LEASE_STATE_KEY);
+        return encoded == null ? undefined : decodeLeaseState(encoded, directory);
+    }
+    catch (error) {
+        if (isMissingKeyError(error)) {
+            return undefined;
+        }
+        throw error;
+    }
+};
+const syncDirectory = async (fs, directory) => {
+    let handle;
+    try {
+        handle = await fs.open(directory, "r");
+        await handle.sync();
+    }
+    catch (error) {
+        throw new NativeDurabilityLeaseDirectorySyncError(directory, {
+            cause: error,
+        });
+    }
+    finally {
+        await handle?.close();
+    }
+};
+class NodeNativeDurabilityLease {
+    fence;
+    database;
+    state = "held";
+    closePromise;
+    activeOperations = 0;
+    drainPromise;
+    resolveDrain;
+    constructor(fence, database) {
+        this.fence = fence;
+        this.database = database;
+    }
+    async assertHeld() {
+        if (this.state !== "held" || this.database.status !== "open") {
+            throw new NativeDurabilityLeaseClosedError(this.fence);
+        }
+    }
+    async runWhileHeld(operation) {
+        if (this.state !== "held" || this.database.status !== "open") {
+            throw new NativeDurabilityLeaseClosedError(this.fence);
+        }
+        // The state check and increment are synchronous, so close() cannot release
+        // the database lock between them.
+        this.activeOperations++;
+        try {
+            return await operation();
+        }
+        finally {
+            this.activeOperations--;
+            if (this.activeOperations === 0) {
+                this.resolveDrain?.();
+                this.resolveDrain = undefined;
+                this.drainPromise = undefined;
+            }
+        }
+    }
+    close() {
+        if (this.closePromise) {
+            return this.closePromise;
+        }
+        this.state = "closing";
+        if (this.activeOperations > 0 && !this.drainPromise) {
+            this.drainPromise = new Promise((resolve) => {
+                this.resolveDrain = resolve;
+            });
+        }
+        this.closePromise = (this.drainPromise ?? Promise.resolve())
+            .then(() => this.database.close())
+            .finally(() => {
+            this.state = "closed";
+        });
+        return this.closePromise;
+    }
+}
+/**
+ * Acquire the crash-released Node ownership lease for an existing program
+ * directory.
+ *
+ * The dedicated ClassicLevel database lives beside, rather than inside, the
+ * transaction namespace. Its native LevelDB `LOCK` is held for this object's
+ * lifetime and is released by the operating system when the process dies. The
+ * lock database itself is intentionally retained so fence epochs cannot be
+ * reused after a normal reopen.
+ */
+export const acquireNativeDurabilityNodeLease = async (programDirectory) => {
+    const [fs, path, crypto, ClassicLevel] = await Promise.all([
+        dynamicImport("node:fs/promises"),
+        dynamicImport("node:path"),
+        dynamicImport("node:crypto"),
+        importClassicLevel(),
+    ]);
+    let canonicalDirectory;
+    try {
+        canonicalDirectory = await fs.realpath(programDirectory);
+    }
+    catch (error) {
+        throw new NativeDurabilityLeaseStateError(programDirectory, `Native durability program directory must already exist: ${programDirectory}`, { cause: error });
+    }
+    const leaseDirectory = path.join(canonicalDirectory, NATIVE_DURABILITY_NODE_LEASE_DIRECTORY_NAME);
+    const database = new ClassicLevel(leaseDirectory, {
+        keyEncoding: "utf8",
+        valueEncoding: "utf8",
+    });
+    try {
+        await database.open();
+    }
+    catch (error) {
+        if (hasErrorCode(error, "LEVEL_LOCKED")) {
+            throw new NativeDurabilityLeaseUnavailableError(canonicalDirectory, {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+    try {
+        const previous = await readLeaseState(database, canonicalDirectory);
+        if (BigInt(previous?.epoch ?? "0") === NATIVE_DURABILITY_MAX_U64) {
+            throw new NativeDurabilityFenceExhaustedError(canonicalDirectory);
+        }
+        const fence = Object.freeze({
+            epoch: BigInt(previous?.epoch ?? "0") + 1n,
+            ownerId: crypto.randomUUID(),
+            domainId: previous?.domainId ?? crypto.randomUUID(),
+        });
+        const next = {
+            version: LEASE_STATE_VERSION,
+            epoch: fence.epoch.toString(),
+            ownerId: fence.ownerId,
+            domainId: fence.domainId,
+        };
+        await database.put(LEASE_STATE_KEY, JSON.stringify(next), { sync: true });
+        // LevelDB's sync option covers its value/WAL. Explicit directory syncs
+        // additionally make creation of the lease database and its files durable
+        // before the fence is handed to a transaction writer.
+        await syncDirectory(fs, leaseDirectory);
+        await syncDirectory(fs, canonicalDirectory);
+        return new NodeNativeDurabilityLease(fence, database);
+    }
+    catch (error) {
+        try {
+            await database.close();
+        }
+        catch {
+            // The acquisition error is authoritative. A failed close must not make
+            // the partially initialized lease usable by this process.
+        }
+        throw error;
+    }
+};
+//# sourceMappingURL=node-lease.js.map

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

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

package/dist/src/durability/node-storage.d.ts

@@ -0,0 +1,76 @@
+import { type NativeDurabilityLease } from "./lease.js";
+import { type NativeDurabilityCheckpoint, type NativeDurabilityCheckpointReceipt, type NativeDurabilityCheckpointRequest, type NativeDurabilityDeleteReceipt, type NativeDurabilityDeleteRequest, type NativeDurabilityIncompleteTailReconciliationRequest, type NativeDurabilityJournalAppendRequest, type NativeDurabilityJournalReceipt, type NativeDurabilityJournalReconciliationReceipt, type NativeDurabilityStageReceipt, type NativeDurabilityStageRequest, type NativeDurabilityStagingManifest, type NativeDurabilityStorage, type NativeDurabilityStorageStats } from "./storage.js";
+export type NativeDurabilityNodeWritable = {
+    write: (buffer: Uint8Array, offset: number, length: number, position: number) => Promise<{
+        bytesWritten: number;
+    }>;
+};
+export type NativeDurabilityNodeReadable = {
+    read: (buffer: Uint8Array, offset: number, length: number, position: number) => Promise<{
+        bytesRead: number;
+    }>;
+};
+/** `FileHandle.write()` is allowed to complete with a short write. */
+export declare const writeNativeDurabilityBytesFully: (handle: NativeDurabilityNodeWritable, bytes: Uint8Array, position: number) => Promise<void>;
+export declare const readNativeDurabilityBytesFully: (handle: NativeDurabilityNodeReadable, byteLength: number) => Promise<Uint8Array>;
+export type NativeDurabilityNodeStorageOptions = {
+    directory: string;
+    programId: Uint8Array;
+};
+export declare class NodeNativeDurabilityStorage implements NativeDurabilityStorage {
+    private readonly lease;
+    private readonly journalCodec;
+    private readonly programId;
+    readonly version: 1;
+    readonly kind: "node-fsync";
+    readonly crashSafe = true;
+    readonly domainId: string;
+    readonly fence: NativeDurabilityLease["fence"];
+    private readonly rootDirectory;
+    private readonly namespaceDirectory;
+    private readonly stagingDirectory;
+    private readonly checkpointDirectory;
+    private readonly journalPath;
+    private operationTail;
+    private closePromise?;
+    private closing;
+    private closed;
+    private barrierOrdinal;
+    private strictDeleteCount;
+    private constructor();
+    static create(options: NativeDurabilityNodeStorageOptions): Promise<NodeNativeDurabilityStorage>;
+    private enqueue;
+    private initialize;
+    private checkpointManifestPath;
+    private checkpointHighwaterPath;
+    private readGenerationState;
+    private writeGenerationState;
+    private readCheckpointSlot;
+    private readCheckpointManifest;
+    private readJournalBaseCheckpoint;
+    private readValidCheckpointsInternal;
+    private ensureGenesisCheckpoint;
+    private reconcileCheckpointGenerationState;
+    private reconcileStagingOrphans;
+    private checkpointAuthorizesStagingDeletion;
+    private checkpointValidationContext;
+    private transactionDirectory;
+    private readStagingManifestInternal;
+    stageAndSync(unsafeRequest: NativeDurabilityStageRequest): Promise<NativeDurabilityStageReceipt>;
+    readStagingManifest(transactionId: string): Promise<NativeDurabilityStagingManifest | undefined>;
+    readStagedBlock(transactionId: string, ordinal: number): Promise<Uint8Array | undefined>;
+    private listStagingTransactionIdsInternal;
+    listStagingTransactionIds(): Promise<string[]>;
+    appendJournalAndSync(unsafeRequest: NativeDurabilityJournalAppendRequest): Promise<NativeDurabilityJournalReceipt>;
+    readJournal(): Promise<Uint8Array>;
+    reconcileIncompleteJournalTailAndSync(unsafeRequest: NativeDurabilityIncompleteTailReconciliationRequest): Promise<NativeDurabilityJournalReconciliationReceipt>;
+    private checkpointReceipt;
+    writeCheckpointAndSync(unsafeRequest: NativeDurabilityCheckpointRequest): Promise<NativeDurabilityCheckpointReceipt>;
+    readLatestCheckpoint(): Promise<NativeDurabilityCheckpoint | undefined>;
+    deleteAndSync(unsafeRequest: NativeDurabilityDeleteRequest): Promise<NativeDurabilityDeleteReceipt>;
+    stats(): Promise<NativeDurabilityStorageStats>;
+    /** Drains admitted operations before releasing the owned OS lease. */
+    close(): Promise<void>;
+}
+export declare const createNodeNativeDurabilityStorage: (options: NativeDurabilityNodeStorageOptions) => Promise<NodeNativeDurabilityStorage>;
+//# sourceMappingURL=node-storage.d.ts.map

package/dist/src/durability/node-storage.d.ts.map

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