@harperfast/harper 5.3.0-alpha.1 → 5.3.0-beta.2

package/dist/resources/indexes/nativeFullTextDerivedIndexLifecycle.d.ts

@@ -0,0 +1,24 @@
+import { FullTextDerivedIndexBackend, type FullTextDerivedIndexBackendOptions, type FullTextDerivedIndexEngine, type FullTextDerivedIndexInspection } from './fullTextDerivedIndex.ts';
+import { type NativeFullTextIndexConfiguration, type NativeFullTextModule } from './fullTextNativeBinding.ts';
+export type NativeFullTextDerivedIndexLifecycleOptions = NativeFullTextIndexConfiguration & {
+    storePath: string;
+    storeName: string;
+    indexId: string;
+    sourceGeneration: string;
+    binding?: NativeFullTextModule | (() => Promise<NativeFullTextModule>);
+};
+export type NativeFullTextDerivedIndexBackendOptions = Omit<FullTextDerivedIndexBackendOptions, 'lifecycle'> & Omit<NativeFullTextDerivedIndexLifecycleOptions, 'indexId'>;
+export declare class NativeFullTextDerivedIndexLifecycle {
+    #private;
+    constructor(options: NativeFullTextDerivedIndexLifecycleOptions);
+    get path(): string;
+    initialize(options?: {
+        reclaimRetired?: boolean;
+    }): Promise<void>;
+    startRetiredStorageReclamation(): void;
+    get maxCommitPayloadBytes(): number;
+    inspect(): FullTextDerivedIndexInspection;
+    open(): Promise<FullTextDerivedIndexEngine>;
+    reset(): Promise<void>;
+}
+export declare function createNativeFullTextDerivedIndexBackend(options: NativeFullTextDerivedIndexBackendOptions): Promise<FullTextDerivedIndexBackend>;

package/dist/resources/indexes/nativeFullTextDerivedIndexLifecycle.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeFullTextDerivedIndexLifecycle = void 0;
+exports.createNativeFullTextDerivedIndexBackend = createNativeFullTextDerivedIndexBackend;
+const node_crypto_1 = require("node:crypto");
+const node_path_1 = require("node:path");
+const logger_ts_1 = require("../../utility/logging/logger.js");
+const fullTextDerivedIndex_ts_1 = require("./fullTextDerivedIndex.js");
+const fullTextNativeBinding_ts_1 = require("./fullTextNativeBinding.js");
+const logger = (0, logger_ts_1.loggerWithTag)('fulltext-derived-index');
+class NativeFullTextDerivedIndexLifecycle {
+    #options;
+    #path;
+    #generation;
+    #binding;
+    #maxCommitPayloadBytes;
+    #reclaimOperation = Promise.resolve();
+    constructor(options) {
+        if (!(0, node_path_1.isAbsolute)(options.storePath))
+            throw new TypeError('Full-text storePath must be absolute');
+        if (!options.storeName)
+            throw new TypeError('Full-text storeName is required');
+        if (!options.indexId)
+            throw new TypeError('Full-text indexId is required');
+        if (!options.sourceGeneration)
+            throw new TypeError('Full-text sourceGeneration is required');
+        this.#options = {
+            ...options,
+            fields: options.fields.map((field) => ({ ...field })),
+            limits: { ...options.limits },
+        };
+        // Hashing bounds filenames for arbitrary store names; the index id remains in native metadata and logs.
+        this.#path = (0, node_path_1.join)((0, node_path_1.resolve)(options.storePath), `${digest(options.storeName)}.fulltext`);
+        this.#generation = digest(options.sourceGeneration);
+    }
+    get path() {
+        return this.#path;
+    }
+    async initialize(options = {}) {
+        const binding = await this.#getBinding();
+        binding.validateNativeFullTextIndexOptions({
+            ...this.#nativeOptions(),
+            limits: this.#options.limits,
+        });
+        this.#maxCommitPayloadBytes = (0, fullTextNativeBinding_ts_1.getValidatedFullTextRuntimeInfo)(binding).limits.maxCommitPayloadBytes;
+        if (options.reclaimRetired !== false)
+            this.#queueReclaimRetired();
+    }
+    startRetiredStorageReclamation() {
+        this.#requireBinding();
+        // Fulltext publishes unique retired paths and removes them with force, so workers may sweep concurrently.
+        this.#queueReclaimRetired();
+    }
+    get maxCommitPayloadBytes() {
+        if (this.#maxCommitPayloadBytes === undefined)
+            throw new Error('Full-text lifecycle has not been initialized');
+        return this.#maxCommitPayloadBytes;
+    }
+    inspect() {
+        return this.#requireBinding().inspectNativeFullTextIndex(this.#nativeOptions());
+    }
+    async open() {
+        return this.#requireBinding().openNativeFullTextIndex({
+            ...this.#nativeOptions(),
+            limits: this.#options.limits,
+        });
+    }
+    async reset() {
+        const result = await this.#requireBinding().resetNativeFullTextIndex({
+            path: this.#path,
+            indexId: this.#options.indexId,
+        });
+        this.#queueReclaimRetired(result.state === 'reset' ? result.retiredPath : undefined);
+    }
+    #queueReclaimRetired(retiredPath) {
+        const reclaim = () => this.#reclaimRetired(retiredPath);
+        this.#reclaimOperation = this.#reclaimOperation.then(reclaim, reclaim).catch((error) => {
+            logWarning(`Could not complete reclamation for full-text index '${this.#options.indexId}'`, error);
+        });
+    }
+    async #reclaimRetired(retiredPath) {
+        try {
+            const result = await this.#requireBinding().reclaimRetiredNativeFullTextIndexes({
+                path: this.#path,
+                retiredPath,
+            });
+            if (result.failed > 0)
+                logWarning(`Could not remove ${result.failed} retired paths for full-text index '${this.#options.indexId}'`);
+        }
+        catch (error) {
+            logWarning(`Could not reclaim retired paths for full-text index '${this.#options.indexId}'`, error);
+        }
+    }
+    #nativeOptions() {
+        return {
+            path: this.#path,
+            indexId: this.#options.indexId,
+            generation: this.#generation,
+            fields: this.#options.fields,
+            analyzer: this.#options.analyzer,
+            stopWords: this.#options.stopWords,
+            positions: this.#options.positions,
+            surfaceTerms: this.#options.surfaceTerms,
+        };
+    }
+    async #getBinding() {
+        if (this.#binding)
+            return this.#binding;
+        const configured = this.#options.binding;
+        this.#binding = configured
+            ? await (0, fullTextNativeBinding_ts_1.validateFullTextNativeBinding)(typeof configured === 'function' ? await configured() : configured)
+            : await (0, fullTextNativeBinding_ts_1.loadFullTextNativeBinding)();
+        return this.#binding;
+    }
+    #requireBinding() {
+        if (!this.#binding)
+            throw new Error('Full-text native binding has not been initialized');
+        return this.#binding;
+    }
+}
+exports.NativeFullTextDerivedIndexLifecycle = NativeFullTextDerivedIndexLifecycle;
+async function createNativeFullTextDerivedIndexBackend(options) {
+    const maxCursorPayloadBytes = options.maxCursorPayloadBytes ?? fullTextDerivedIndex_ts_1.HARPER_FULLTEXT_MAX_CURSOR_PAYLOAD_BYTES;
+    if (maxCursorPayloadBytes > fullTextDerivedIndex_ts_1.HARPER_FULLTEXT_MAX_CURSOR_PAYLOAD_BYTES)
+        throw new RangeError(`Full-text maxCursorPayloadBytes must not exceed ${fullTextDerivedIndex_ts_1.HARPER_FULLTEXT_MAX_CURSOR_PAYLOAD_BYTES}`);
+    const lifecycle = new NativeFullTextDerivedIndexLifecycle({ ...options, indexId: options.id });
+    await lifecycle.initialize({ reclaimRetired: false });
+    if (maxCursorPayloadBytes > lifecycle.maxCommitPayloadBytes)
+        throw new RangeError('Full-text maxCursorPayloadBytes exceeds the native commit payload capacity');
+    const backend = new fullTextDerivedIndex_ts_1.FullTextDerivedIndexBackend({
+        ...options,
+        id: options.id,
+        lifecycle,
+        maxCursorPayloadBytes,
+    });
+    lifecycle.startRetiredStorageReclamation();
+    return backend;
+}
+function digest(value) {
+    return (0, node_crypto_1.createHash)('sha256').update(value).digest('hex');
+}
+function logWarning(message, error) {
+    const code = error && typeof error === 'object' && 'code' in error && typeof error.code === 'string' ? error.code : undefined;
+    try {
+        logger.warn?.(`${message}${code ? ` (${code})` : ''}`);
+    }
+    catch { }
+}
+//# sourceMappingURL=nativeFullTextDerivedIndexLifecycle.js.map

package/dist/resources/indexes/nativeFullTextDerivedIndexLifecycle.js.map

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

package/dist/resources/nodeIdMapping.d.ts

@@ -11,3 +11,8 @@ export declare function getIdOfRemoteNode(remoteNodeName: any, auditStore: any):
  */
 export declare function lastTimeInAuditStore(auditStore: Database): import("lmdb").Key;
 export declare function getThisNodeId(auditStore: any): any;
+/**
+ * The node name a local short id refers to. Callers that must attribute a replicated entry to its
+ * origin node need the globally stable name, not the id, which is assigned per node.
+ */
+export declare function getNodeNameForId(auditStore: any, nodeId: number | undefined, rebuildOnMiss?: boolean): string | undefined;

package/dist/resources/nodeIdMapping.js

@@ -5,6 +5,7 @@ exports.remoteToLocalNodeId = remoteToLocalNodeId;
 exports.getIdOfRemoteNode = getIdOfRemoteNode;
 exports.lastTimeInAuditStore = lastTimeInAuditStore;
 exports.getThisNodeId = getThisNodeId;
+exports.getNodeNameForId = getNodeNameForId;
 /**
  * This module is responsible for managing the mapping of node/host names to node ids.
  */
@@ -56,6 +57,7 @@ function getIdMappingRecord(auditStore) {
         // now we can take over the local node id
         nameToId[node_name] = 0;
         auditStore.putSync(REMOTE_NODE_IDS, (0, msgpackr_1.pack)(idMappingRecord));
+        invalidateNodeNames(auditStore);
     }
     return idMappingRecord;
 }
@@ -89,6 +91,7 @@ function remoteToLocalNodeId(remoteMapping, auditStore) {
     }
     if (hasChanges) {
         auditStore.putSync(REMOTE_NODE_IDS, (0, msgpackr_1.pack)(idMappingRecord));
+        invalidateNodeNames(auditStore);
     }
     return remoteToLocalId;
 }
@@ -107,6 +110,7 @@ function getIdOfRemoteNode(remoteNodeName, auditStore) {
         id = lastId + 1;
         nameToId[remoteNodeName] = id;
         auditStore.putSync(REMOTE_NODE_IDS, (0, msgpackr_1.pack)(idMappingRecord));
+        invalidateNodeNames(auditStore);
     }
     logger_ts_1.logger.trace?.('The remote node name map', remoteNodeName, nameToId, id);
     return id;
@@ -126,4 +130,49 @@ function lastTimeInAuditStore(auditStore) {
 function getThisNodeId(auditStore) {
     return exportIdMapping(auditStore)?.[Server_ts_1.server.hostname];
 }
+// Inverted id -> name map. exportIdMapping() re-reads and unpacks the mapping record on every call,
+// which is far too much per replicated entry on the apply thread; ids are stable once minted, so the
+// inversion is cached and dropped wherever nameToId is written. Keyed per audit store because short
+// ids are minted per database in first-seen order — id 1 names a different node in each one.
+// Refresh window for a MISS. A hit is always trusted, but a miss cannot be: ids are minted by
+// whichever worker first talks to a peer, and invalidation only reaches that worker's own copy — so
+// a newly admitted node is absent from every other worker's map until it is rebuilt. Rebuilding on
+// every miss would put a store read and unpack back on the apply thread for each unmapped entry, so
+// misses re-read at most this often — short enough that a joining node loses at most a stray entry,
+// long enough that a burst of unmapped ids cannot drive the store. `onMiss` records whether the
+// cached map was built by a `rebuildOnMiss` caller, which is what bounds that caller to one read per
+// window too rather than exempting it from the interval entirely.
+const NODE_NAME_REFRESH_MS = 50;
+const idToNodeName = new WeakMap();
+function invalidateNodeNames(auditStore) {
+    idToNodeName.delete(auditStore);
+}
+/**
+ * The node name a local short id refers to. Callers that must attribute a replicated entry to its
+ * origin node need the globally stable name, not the id, which is assigned per node.
+ */
+function getNodeNameForId(auditStore, nodeId, rebuildOnMiss = false) {
+    if (typeof nodeId !== 'number' || !auditStore)
+        return undefined;
+    const cached = idToNodeName.get(auditStore);
+    const hit = cached?.names.get(nodeId);
+    if (hit !== undefined)
+        return hit;
+    const now = Date.now();
+    // `rebuildOnMiss` is for entry classes whose loss costs more than the read: a dropped record lock
+    // release leaves the home holding a grant until its own deadline, so a just-minted id is worth one
+    // store read rather than up to `NODE_NAME_REFRESH_MS` of dropped entries. ONE read, though, not one
+    // per entry — an id this map will never resolve (a node whose mapping was purged, an origin
+    // relayed from a database that never minted one) is exactly the burst the interval exists to keep
+    // off the apply thread, and a rebuild inside the window is not stale: a write to the mapping drops
+    // this entry outright (`invalidateNodeNames`).
+    if (cached && now - cached.refreshedAt < NODE_NAME_REFRESH_MS && (!rebuildOnMiss || cached.onMiss))
+        return undefined;
+    const nameToId = exportIdMapping(auditStore);
+    const names = new Map();
+    for (const name in nameToId)
+        names.set(nameToId[name], name);
+    idToNodeName.set(auditStore, { names, refreshedAt: now, onMiss: rebuildOnMiss });
+    return names.get(nodeId);
+}
 //# sourceMappingURL=nodeIdMapping.js.map

package/dist/resources/nodeIdMapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodeIdMapping.js","sourceRoot":"","sources":["../../resources/nodeIdMapping.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nodeIdMapping.js","sourceRoot":"","sources":["../../resources/nodeIdMapping.ts"],"names":[],"mappings":";;AAwDA,0CAEC;AAKD,kDA2BC;AAED,8CAmBC;AAMD,oDAOC;AACD,sCAEC;AAwBD,4CAuBC;AA9KD;;GAEG;AACH,4DAAsD;AACtD,uDAAwD;AACxD,uCAAwC;AAExC,mDAA6C;AAE7C,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACjD,SAAS,kBAAkB,CAAC,UAAU;IACrC,MAAM,qBAAqB,GAAG,UAAU,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACpE,IAAI,eAAe,GAAG,qBAAqB,CAAC,CAAC,CAAC,IAAA,iBAAM,EAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnF,IAAI,CAAC,eAAe,EAAE,CAAC;QACtB,eAAe,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IACD,6EAA6E;IAC7E,MAAM,SAAS,GAAG,IAAA,6BAAe,GAAE,CAAC;IACpC,eAAe,CAAC,QAAQ,GAAG,IAAA,6BAAe,GAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,eAAe,CAAC,cAAc,CAAC;IAChD,IAAI,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,wHAAwH;QACxH,0GAA0G;QAC1G,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,qBAA6B,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;gBACd,qBAAqB,GAAG,IAAI,CAAC;YAC9B,CAAC;iBAAM,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;gBACxB,MAAM,GAAG,EAAE,CAAC;YACb,CAAC;QACF,CAAC;QACD,IAAI,qBAAqB,EAAE,CAAC;YAC3B,kEAAkE;YAClE,MAAM,EAAE,CAAC;YACT,QAAQ,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAC;YACzC,4GAA4G;YAC5G,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;YAC3C,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE;gBAChD,6FAA6F;gBAC7F,kFAAkF;gBAClF,IAAI,CAAE,UAAU,CAAC,SAAS,CAAC,MAAc,CAAC,OAAO,CAAC,MAAM,CAAC;oBACxD,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE;wBAC3C,KAAK,EAAE,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC;wBAC5C,KAAK,EAAE,EAAE;qBACT,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACJ,CAAC;QACD,yCAAyC;QACzC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,IAAA,eAAI,EAAC,eAAe,CAAC,CAAC,CAAC;QAC3D,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,eAAe,CAAC;AACxB,CAAC;AACD,SAAgB,eAAe,CAAC,UAAU;IACzC,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,aAAkB,EAAE,UAAe;IACtE,MAAM,eAAe,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,eAAe,CAAC,cAAc,CAAC;IAChD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAE,CAAC;IAClC,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,KAAK,MAAM,cAAc,IAAI,aAAa,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;QAC/C,IAAI,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;QACvC,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;YAC1B,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC7B,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC1B,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;oBACjB,MAAM,GAAG,EAAE,CAAC;gBACb,CAAC;YACF,CAAC;YACD,OAAO,GAAG,MAAM,GAAG,CAAC,CAAC;YACrB,QAAQ,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC;YACnC,UAAU,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QAChB,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,IAAA,eAAI,EAAC,eAAe,CAAC,CAAC,CAAC;QAC3D,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,eAAe,CAAC;AACxB,CAAC;AAED,SAAgB,iBAAiB,CAAC,cAAc,EAAE,UAAU;IAC3D,MAAM,eAAe,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,eAAe,CAAC,cAAc,CAAC;IAChD,IAAI,EAAE,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClC,IAAI,EAAE,IAAI,SAAS,EAAE,CAAC;QACrB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;gBACjB,MAAM,GAAG,EAAE,CAAC;YACb,CAAC;QACF,CAAC;QACD,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC;QAChB,QAAQ,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;QAC9B,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,IAAA,eAAI,EAAC,eAAe,CAAC,CAAC,CAAC;QAC3D,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IACD,kBAAM,CAAC,KAAK,EAAE,CAAC,0BAA0B,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IACzE,OAAO,EAAE,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,UAAoB;IACxD,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,OAAO,CAAC;QAC1C,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,IAAI;KACb,CAAC,EAAE,CAAC;QACJ,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC;AACD,SAAgB,aAAa,CAAC,UAAe;IAC5C,OAAO,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC,kBAAM,CAAC,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED,oGAAoG;AACpG,qGAAqG;AACrG,oGAAoG;AACpG,6FAA6F;AAC7F,8FAA8F;AAC9F,oGAAoG;AACpG,mGAAmG;AACnG,oGAAoG;AACpG,oGAAoG;AACpG,gGAAgG;AAChG,qGAAqG;AACrG,kEAAkE;AAClE,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,YAAY,GAAG,IAAI,OAAO,EAAgF,CAAC;AACjH,SAAS,mBAAmB,CAAC,UAAe;IAC3C,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAC/B,UAAe,EACf,MAA0B,EAC1B,aAAa,GAAG,KAAK;IAErB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,kGAAkG;IAClG,mGAAmG;IACnG,oGAAoG;IACpG,4FAA4F;IAC5F,kGAAkG;IAClG,mGAAmG;IACnG,+CAA+C;IAC/C,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,WAAW,GAAG,oBAAoB,IAAI,CAAC,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACrH,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,QAAQ;QAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7D,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IACjF,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}

package/dist/resources/recordLock.d.ts

@@ -1,10 +1,16 @@
 import { ClientError } from '../utility/errors/hdbError.ts';
 /**
- * Exclusive per-record locks (harper#483, Phase 0: one node, every worker thread).
+ * Exclusive per-record locks (harper#483).
  *
- * The sole authority is the rocksdb-js process-wide key lock: one `locks` map per DBDescriptor
- * shared by every worker thread's handle. Nothing is written to the store or audit log. Lock and
- * unlock are pure in-memory operations; the record's version and bytes are unchanged.
+ * The intra-node authority is the rocksdb-js process-wide key lock: one `locks` map per DBDescriptor
+ * shared by every worker thread's handle. Acquiring and releasing it write nothing to the store, and
+ * the record's version and bytes are unchanged.
+ *
+ * Phase 1 layers cluster-wide exclusion on top without changing that: once the native key is held,
+ * `Table.lock()` obtains a delegation for the key from its home node (see `recordLockCoordinator.ts`)
+ * and calls `joinClusterRound()` on the handle. A live delegation serves repeat locks with no cluster
+ * message at all. A node-scoped lock (`{ scope: 'node' }`), or any lock on a database with no
+ * transport registered, skips the cluster step entirely and behaves exactly as it did in Phase 0.
  */
 export declare const DEFAULT_LOCK_LEASE_MS = 30000;
 /** Below this a generation can expire before the caller's work completes, handing back a lock already lost. */
@@ -19,11 +25,19 @@ export interface RecordLockOptions {
     timeout?: number;
     /** A held lock outlives the acquiring transaction; it is released by `unlock()` or by its lease */
     hold?: boolean;
+    /**
+     * `'cluster'` (default) is exclusive across every participating node; `'node'` keeps Phase 0
+     * semantics and is exclusive only across this node's worker threads.
+     */
+    scope?: 'cluster' | 'node';
 }
 export interface ResolvedRecordLockOptions {
     lease: number;
     timeout: number;
     hold: boolean;
+    scope: 'cluster' | 'node';
+    /** True when the caller named `scope` explicitly, which makes `'cluster'` fail-closed. */
+    scopeRequested: boolean;
 }
 /**
  * The handle returned by `lock()` and held by each gated write until its transaction completes.
@@ -48,6 +62,35 @@ export interface RecordLockHandle {
     noteCandidateFloor(version: number): void;
     /** Compute a holder-write version without advancing the floor until that write commits. */
     holderVersionCandidate(floor?: number): number;
+    /** `ts_R` of the granted cluster round; undefined while the hold is node-scoped (Phase 0). */
+    clusterTsR?: number;
+    /**
+     * Whether this handle may still authorize a write, evaluated NOW rather than trusting the lease
+     * timer to have run. A holder whose event loop stalled past its deadline would otherwise commit
+     * between the deadline and its own timer callback, while peers had already expired the hold.
+     * Expiry is detected on a monotonic clock, so a wall-clock jump cannot extend a lease.
+     */
+    isExpired(): boolean;
+    /**
+     * Whether the LEASE elapsed. Distinct from `isExpired()` in that a deliberate release does NOT
+     * make it true on its own: a write staged while the lock was held stays valid at commit if the
+     * caller merely unlocked. Once the deadline passes it is true either way, because by then peers
+     * have passed their own bound and the key may already belong to someone else.
+     */
+    isLeaseExpired(): boolean;
+    /** Revoke authority ahead of the lease, so a staged-but-uncommitted write is fenced at commit. */
+    revokeLease(): void;
+    /**
+     * Re-anchor a granted cluster round: the hold now runs from `tsR` (no margin, so this node
+     * always expires before any participant does) and `onRelease` emits the durable LOCK_RELEASE.
+     * Returns false when the round completed after the lease had already elapsed.
+     *
+     * `mintedMono` is `performance.now()` at the instant `tsR` was minted. The remaining lease is
+     * measured from it rather than from `tsR - Date.now()`: `tsR` comes from a never-decreasing
+     * monotonic source, so after a backward wall-clock step that subtraction would hand back MORE
+     * lease than the round was granted, past what every peer bounded from its own observation.
+     */
+    joinClusterRound(tsR: number, leaseMs: number, mintedMono: number, onRelease: () => void): boolean;
     /**
      * Return the next version to stamp a holder write with. Starts at acquiredAt when no transaction
      * version has been noted; otherwise advances by the minimum monotonic step from the recorded floor.

package/dist/resources/recordLock.js

@@ -9,14 +9,21 @@ exports.lockNotHeldError = lockNotHeldError;
 exports.lockAttemptKey = lockAttemptKey;
 exports.makeKeyLockHandle = makeKeyLockHandle;
 exports.acquireRecordKey = acquireRecordKey;
+const node_perf_hooks_1 = require("node:perf_hooks");
 const harper_logger_ts_1 = __importDefault(require("../utility/logging/harper_logger.js"));
 const hdbError_ts_1 = require("../utility/errors/hdbError.js");
 /**
- * Exclusive per-record locks (harper#483, Phase 0: one node, every worker thread).
+ * Exclusive per-record locks (harper#483).
  *
- * The sole authority is the rocksdb-js process-wide key lock: one `locks` map per DBDescriptor
- * shared by every worker thread's handle. Nothing is written to the store or audit log. Lock and
- * unlock are pure in-memory operations; the record's version and bytes are unchanged.
+ * The intra-node authority is the rocksdb-js process-wide key lock: one `locks` map per DBDescriptor
+ * shared by every worker thread's handle. Acquiring and releasing it write nothing to the store, and
+ * the record's version and bytes are unchanged.
+ *
+ * Phase 1 layers cluster-wide exclusion on top without changing that: once the native key is held,
+ * `Table.lock()` obtains a delegation for the key from its home node (see `recordLockCoordinator.ts`)
+ * and calls `joinClusterRound()` on the handle. A live delegation serves repeat locks with no cluster
+ * message at all. A node-scoped lock (`{ scope: 'node' }`), or any lock on a database with no
+ * transport registered, skips the cluster step entirely and behaves exactly as it did in Phase 0.
  */
 exports.DEFAULT_LOCK_LEASE_MS = 30_000;
 /** Below this a generation can expire before the caller's work completes, handing back a lock already lost. */
@@ -40,10 +47,15 @@ function resolveLockOptions(options) {
     const hold = options?.hold ?? false;
     if (typeof hold !== 'boolean')
         throw new hdbError_ts_1.ClientError(`Lock option hold must be a boolean, but received ${hold}`);
+    const scope = options?.scope ?? 'cluster';
+    if (scope !== 'cluster' && scope !== 'node')
+        throw new hdbError_ts_1.ClientError(`Lock option scope must be 'cluster' or 'node', but received ${scope}`);
     return {
         lease: requireDuration('lease', options?.lease, exports.DEFAULT_LOCK_LEASE_MS, exports.MIN_LOCK_LEASE_MS, exports.MAX_LOCK_LEASE_MS),
         timeout: requireDuration('timeout', options?.timeout, exports.DEFAULT_LOCK_TIMEOUT_MS, 1, exports.MAX_LOCK_TIMEOUT_MS),
         hold,
+        scope,
+        scopeRequested: options?.scope !== undefined,
     };
 }
 /**
@@ -59,6 +71,20 @@ function lockAttemptKey(tableId, id) {
     return Array.isArray(id) ? [LOCK_KEY_PREFIX, tableId, ...id] : [LOCK_KEY_PREFIX, tableId, id];
 }
 const warnedLeaseTimerStores = new WeakSet();
+/**
+ * Rate-limited rather than latched, for the reason `warnOnce` in the coordinator gives: a release
+ * that cannot be written leaves peers waiting out the lease, and a latch would show an operator the
+ * first occurrence and then hide the condition for as long as it lasts.
+ */
+const CLUSTER_RELEASE_WARN_INTERVAL_MS = 60_000;
+let lastClusterReleaseWarn = -Infinity;
+function warnClusterReleaseFailure(err) {
+    const now = node_perf_hooks_1.performance.now();
+    if (now - lastClusterReleaseWarn < CLUSTER_RELEASE_WARN_INTERVAL_MS)
+        return;
+    lastClusterReleaseWarn = now;
+    harper_logger_ts_1.default.warn?.('cluster record lock release could not be written; peers will expire the hold', err);
+}
 class KeyLockHandle {
     store;
     key;
@@ -68,9 +94,15 @@ class KeyLockHandle {
     released = false;
     expired = false;
     acquiredAt;
+    clusterTsR;
     #lastHolderVersion;
     #candidateFloor;
     #timer;
+    // Monotonic mirror of expiresAt. The wall-clock field stays public (callers and the cluster
+    // protocol both speak in timestamps) but the enforcement compares monotonic readings, so neither
+    // an NTP step nor a manual clock change can extend a lease past what peers assumed.
+    #deadlineMono;
+    #onRelease;
     constructor(store, key, keyId, lease, hold = false, acquiredAt) {
         this.store = store;
         this.key = key;
@@ -79,6 +111,7 @@ class KeyLockHandle {
         this.hold = hold;
         this.acquiredAt = acquiredAt ?? store.getMonotonicTimestamp();
         if (lease != null) {
+            this.#deadlineMono = node_perf_hooks_1.performance.now() + lease;
             this.#timer = setTimeout(() => this.#onLeaseExpire(), lease).unref();
         }
     }
@@ -93,7 +126,70 @@ class KeyLockHandle {
         const MIN_STEP = 0.000488;
         return Math.max(this.#lastHolderVersion != null ? this.#lastHolderVersion + MIN_STEP : this.acquiredAt, this.acquiredAt, this.#candidateFloor ?? -Infinity, floor ?? -Infinity);
     }
+    isExpired() {
+        return this.released || this.expired || this.#leaseLapsed();
+    }
+    isLeaseExpired() {
+        return this.expired || this.#leaseLapsed();
+    }
+    // The single place the deadline is evaluated, so the two predicates cannot disagree about it. A
+    // deliberate release does not make a lapsed lease valid again: by then peers have passed their own
+    // bound and the key may belong to someone else.
+    #leaseLapsed() {
+        if (this.#deadlineMono === undefined || node_perf_hooks_1.performance.now() < this.#deadlineMono)
+            return false;
+        // Finish the expiry rather than only reporting it: the native key must actually go back so a
+        // stalled holder does not keep a key every participant has already written off.
+        if (!this.released)
+            this.#onLeaseExpire();
+        return true;
+    }
+    /**
+     * Revoke this handle's authority immediately, ahead of its lease. A recall must stop a delegate
+     * from COMMITTING, not merely from admitting: a caller that already staged a write and then called
+     * `unlock()` has nothing outstanding for a drain to wait on, but its write is still in the
+     * transaction and would land after the successor was admitted. Expiring the handle is what makes
+     * the commit-time fence reject it (§6).
+     */
+    revokeLease() {
+        if (this.expired)
+            return;
+        // `expired` is what the commit-time fence reads, and it must be set even when the caller has
+        // ALREADY unlocked: a write staged before `unlock()` is still in its transaction, and that is
+        // precisely the handoff §6 exists to fence. Gating this on `released` made the revocation a
+        // no-op in the one state it was written for.
+        this.expired = true;
+        if (this.released) {
+            // The native key is already back and `onRelease` already fired; only the fence flag and the
+            // lease timer are left to settle.
+            clearTimeout(this.#timer);
+            return;
+        }
+        this.#onLeaseExpire();
+    }
+    joinClusterRound(tsR, leaseMs, mintedMono, onRelease) {
+        // A round that completed after the native lease already fired yields no usable hold: the key
+        // has gone back and another worker may hold it, so every write through this handle would 409.
+        if (this.isLeaseExpired())
+            return false;
+        const remaining = leaseMs - (node_perf_hooks_1.performance.now() - mintedMono);
+        if (remaining <= 0)
+            return false;
+        this.clusterTsR = tsR;
+        this.acquiredAt = tsR;
+        this.#lastHolderVersion = undefined;
+        this.#onRelease = onRelease;
+        this.expiresAt = tsR + leaseMs;
+        // From the mint origin, not a second clock read: the design says this bound has no margin.
+        this.#deadlineMono = mintedMono + leaseMs;
+        clearTimeout(this.#timer);
+        this.#timer = setTimeout(() => this.#onLeaseExpire(), remaining).unref();
+        return true;
+    }
     nextHolderVersion() {
+        // TODO(harper#2412): under the settled dual-clock model the lock-ordered stamp belongs in the
+        // distinct-version second word (HAS_DISTINCT_VERSION_FLAG), not the transaction timestamp.
+        // Until that lands, Phase 1 keeps this Phase 0 mechanism, anchored at ts_R in cluster mode.
         const next = this.holderVersionCandidate();
         this.#lastHolderVersion = next;
         return next;
@@ -103,6 +199,7 @@ class KeyLockHandle {
             return;
         this.released = true;
         this.expired = true;
+        clearTimeout(this.#timer);
         try {
             this.store.unlock(this.key);
         }
@@ -112,6 +209,25 @@ class KeyLockHandle {
                 harper_logger_ts_1.default.warn?.('record lock lease timer failed (store may have been dropped)', err);
             }
         }
+        this.#emitRelease();
+    }
+    // The cluster release is a durability optimization, not the safety mechanism — peers expire the
+    // hold on their own lease bound — so neither a throw nor a rejected promise may escape here. This
+    // runs from a lease timer and from post-commit cleanup, where an escaping rejection would take
+    // down the worker or turn a committed transaction into a 500.
+    #emitRelease() {
+        const onRelease = this.#onRelease;
+        if (!onRelease)
+            return;
+        this.#onRelease = undefined;
+        try {
+            const result = onRelease();
+            if (result && typeof result.then === 'function')
+                result.then(undefined, warnClusterReleaseFailure);
+        }
+        catch (err) {
+            warnClusterReleaseFailure(err);
+        }
     }
     release() {
         if (this.released)
@@ -127,13 +243,28 @@ class KeyLockHandle {
                 harper_logger_ts_1.default.warn?.('record lock release failed (store may have been dropped)', err);
             }
         }
+        this.#emitRelease();
         return true;
     }
     upgradeToHold(lease) {
         this.hold = true;
         clearTimeout(this.#timer);
-        this.expiresAt = Date.now() + lease;
-        this.#timer = setTimeout(() => this.#onLeaseExpire(), lease).unref();
+        // A granted cluster round may not be extended locally: peers bound the hold from the request
+        // they saw, and a longer local lease is exactly the two-holder window this protocol removes.
+        // Clamped on the monotonic deadline, not on expiresAt, so a backward wall-clock step cannot
+        // turn the upgrade into the extension this is here to refuse.
+        const now = node_perf_hooks_1.performance.now();
+        const extended = now + lease;
+        const deadline = this.clusterTsR === undefined ? extended : Math.min(extended, this.#deadlineMono ?? extended);
+        const remaining = deadline - now;
+        this.#deadlineMono = deadline;
+        this.expiresAt = Date.now() + remaining;
+        this.#timer = setTimeout(() => this.#onLeaseExpire(), remaining).unref();
+        // Prime the nextHolderVersion counter so a later CLOSED-path save (e.g. after the
+        // enclosing transaction commits) gets acquiredAt+MIN_STEP rather than acquiredAt again
+        // — the same priming the fresh-hold path performs.  Without this, a post-commit save
+        // and any in-transaction save both get acquiredAt, causing a LWW tie that drops the write.
+        this.nextHolderVersion();
     }
 }
 function makeKeyLockHandle(store, key, keyId, lease, hold = false, acquiredAt) {
@@ -146,7 +277,7 @@ function makeKeyLockHandle(store, key, keyId, lease, hold = false, acquiredAt) {
  */
 async function acquireRecordKey(txn, store, key, keyId, waitMs, lease, hold = false) {
     const existing = txn.recordLockFor(store, keyId);
-    if (existing && !existing.released && !existing.expired)
+    if (existing && !existing.isExpired())
         return existing;
     const deadline = Date.now() + waitMs;
     // One persistent wake slot: at most one onUnlocked callback is registered per waiter at any

package/dist/resources/recordLock.js.map

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