@harperfast/harper 5.2.13 → 5.3.0-beta.1

package/dist/resources/replayLogsGuards.js

@@ -9,12 +9,17 @@
 // running over potentially millions of entries, pinning CPU. These guards classify each
 // entry up front so the loop can skip cleanly.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REPLAY_WALL_CLOCK_LIMIT_MS = exports.REPLAY_NO_PROGRESS_TIME_SKIP_FLOOR = exports.REPLAY_NO_PROGRESS_TIME_LIMIT_MS = exports.REPLAY_NO_PROGRESS_COUNT_LIMIT = exports.RECORD_BEARING_FLAGS = void 0;
+exports.MAX_CORRUPT_FRAME_REPORTS = exports.REPLAY_WALL_CLOCK_LIMIT_MS = exports.REPLAY_NO_PROGRESS_TIME_SKIP_FLOOR = exports.REPLAY_NO_PROGRESS_TIME_LIMIT_MS = exports.REPLAY_NO_PROGRESS_COUNT_LIMIT = exports.RECORD_BEARING_FLAGS = void 0;
 exports.classifyAuditEntryForReplay = classifyAuditEntryForReplay;
 exports.isUndecodableValidatedWrite = isUndecodableValidatedWrite;
 exports.shouldAbortStalledReplay = shouldAbortStalledReplay;
 exports.shouldAbortSlowReplay = shouldAbortSlowReplay;
+exports.isMidLogBreak = isMidLogBreak;
 exports.endIteratorOnCorruptFrame = endIteratorOnCorruptFrame;
+exports.getCorruptFrameReports = getCorruptFrameReports;
+exports.getEvictedCorruptFrameReportCount = getEvictedCorruptFrameReportCount;
+exports.clearCorruptFrameReports = clearCorruptFrameReports;
+exports.createCorruptFrameReporter = createCorruptFrameReporter;
 // Mirrors `HAS_RECORD` (16) | `HAS_PARTIAL_RECORD` (32) from auditStore.ts — the action
 // bits the writer sets when an entry carries (or should carry) a record body. Redeclared
 // here so this module stays free of the Harper module graph for unit testing; a lock
@@ -122,12 +127,26 @@ function shouldAbortSlowReplay(totalElapsedMs, timeLimitMs = exports.REPLAY_WALL
     return totalElapsedMs >= timeLimitMs;
 }
 /**
- * Wraps a transaction-log query iterator so a corrupt/torn frame ends that log's iteration
- * cleanly instead of escaping as an uncaughtException. rocksdb-js throws a bounded RangeError
- * when an entry's framing is broken; framing loss means the next entry can't be located, so the
- * frame marks end-of-log (entries before it were already yielded) and startup replay /
- * replication broadcast continue. `onCorruptFrame` fires once, latched — kept a callback (not a
- * direct log) so this module stays out of the Harper module graph and is unit-testable.
+ * Whether a corrupt frame is a mid-log break — intact entries followed it, so entries were lost
+ * rather than the log merely being torn at its tail. Shared by the reporter below and by
+ * `RocksTransactionLogStore.getRange`'s `CorruptFrameStop.midLogBreak`, so the two can't drift on
+ * what counts as a mid-log break.
+ */
+function isMidLogBreak(error) {
+    return error.resyncPosition != null;
+}
+/**
+ * Wraps a transaction-log query iterator so a corrupt/torn frame ends that log's iteration cleanly
+ * instead of escaping as an uncaughtException.
+ *
+ * Iteration stops at the break whether or not intact entries follow it. Resuming past a mid-log
+ * break would recover those entries, but a transaction log carries no frame-level transaction
+ * boundaries: replay groups equal-version entries into one source transaction, so skipping a frame
+ * inside such a group applies and checkpoints the surviving subset of a transaction that never
+ * committed that way at the source. Availability loss is visible and recoverable; a silently torn
+ * transaction is neither. Recovery is deferred until the engine can resume at a proven boundary
+ * (harper#2016, harper#2063); `resyncPosition` is used only to report the break as lost entries
+ * rather than as a truncated tail.
  */
 function endIteratorOnCorruptFrame(iterator, onCorruptFrame) {
     let stopped = false;
@@ -167,4 +186,89 @@ function endIteratorOnCorruptFrame(iterator, onCorruptFrame) {
         },
     };
 }
+/** Distinct break sites retained. One physical corruption yields one site, so this is generous. */
+exports.MAX_CORRUPT_FRAME_REPORTS = 256;
+// Re-encounters move a site to the end, so the first key is the least recently seen. Full means
+// evicting that one rather than refusing a new site, which could not then be deduplicated.
+const corruptFrameReports = new Map();
+let evictedCorruptFrameReports = 0;
+/**
+ * Every corrupt frame seen by this worker. This is not yet consumed by cluster/health status;
+ * callers must aggregate it across worker threads before exposing a node-wide signal.
+ *
+ * Mid-log breaks are immediately logged at error level even without that consumer.
+ */
+function getCorruptFrameReports() {
+    return [...corruptFrameReports.values()];
+}
+/** Break sites evicted because {@link MAX_CORRUPT_FRAME_REPORTS} was reached. */
+function getEvictedCorruptFrameReportCount() {
+    return evictedCorruptFrameReports;
+}
+function clearCorruptFrameReports() {
+    corruptFrameReports.clear();
+    evictedCorruptFrameReports = 0;
+}
+// `logId`/`position` are absent on any rocksdb-js predating the resync support, and every break on
+// a stream would then collapse onto one key — folding genuinely different corruptions into a single
+// count that only ever logs once. The message carries the offset and file in text, so it separates
+// them when the fields can't.
+function corruptFrameKey(logName, error) {
+    const { logId, position } = error;
+    return logId != null && position != null
+        ? `${logName}\u0000${logId}:${position}`
+        : `${logName}\u0000${error.message}`;
+}
+/**
+ * Records a corrupt frame and logs it once per distinct break.
+ *
+ * A mid-log break is an `error`, not a `warn`: entries after it were acknowledged and are now
+ * quarantined behind it. Severity follows the break's own shape, never this pass's outcome — every
+ * pass stops, so keying on that would report the #2063 signature with the benign torn-tail `warn`.
+ * A site first seen as a torn tail can escalate later, since only a rocksdb-js that reports
+ * `resyncPosition` can tell the two apart.
+ */
+function createCorruptFrameReporter(logger) {
+    return (logName) => (error) => {
+        const midLog = isMidLogBreak(error);
+        const unreadableBytes = error.unreadableBytes ?? 0;
+        const now = Date.now();
+        const key = corruptFrameKey(logName, error);
+        const existing = corruptFrameReports.get(key);
+        if (existing) {
+            corruptFrameReports.delete(key);
+            corruptFrameReports.set(key, existing);
+            existing.occurrences++;
+            existing.lastSeen = now;
+            if (!midLog || existing.midLog)
+                return;
+            existing.midLog = true;
+            existing.unreadableBytes = unreadableBytes;
+        }
+        else {
+            if (corruptFrameReports.size >= exports.MAX_CORRUPT_FRAME_REPORTS) {
+                corruptFrameReports.delete(corruptFrameReports.keys().next().value);
+                evictedCorruptFrameReports++;
+            }
+            corruptFrameReports.set(key, {
+                log: logName,
+                logId: error.logId ?? undefined,
+                position: error.position ?? undefined,
+                midLog,
+                unreadableBytes,
+                firstSeen: now,
+                lastSeen: now,
+                occurrences: 1,
+            });
+        }
+        if (midLog) {
+            logger.error(`Corrupt entry in transaction log "${logName}"; ${unreadableBytes} byte(s) are unreadable and the entries within them are lost. ` +
+                'Intact entries follow the break, but reading stops there rather than skipping the frame, which could tear a source transaction: ' +
+                'they are quarantined until the log is repaired or this node is re-cloned, and they are neither replayed nor replicated meanwhile.', error);
+        }
+        else {
+            logger.warn(`Stopping transaction log "${logName}" at a corrupt entry during replay`, error);
+        }
+    };
+}
 //# sourceMappingURL=replayLogsGuards.js.map

package/dist/resources/replayLogsGuards.js.map

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

package/dist/resources/replicatedApplyFailure.d.ts

@@ -0,0 +1,16 @@
+export interface ReplicatedApplyFailure {
+    readonly database: string;
+    readonly table?: string;
+    readonly nodeId: number;
+    readonly position: number;
+    readonly localTime?: number;
+    readonly error: unknown;
+}
+export type ReplicatedApplyFailureListener = (failure: ReplicatedApplyFailure) => void | Promise<void>;
+export declare function registerReplicatedApplyFailureListener(database: string, listener: ReplicatedApplyFailureListener): void;
+export declare function unregisterReplicatedApplyFailureListener(database: string, listener: ReplicatedApplyFailureListener): void;
+export declare function notifyReplicatedApplyFailure(database: string, event: {
+    table?: string;
+    nodeId?: number;
+    localTime?: number;
+}, position: number | undefined, error: unknown, table?: string): Promise<void>;

package/dist/resources/replicatedApplyFailure.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerReplicatedApplyFailureListener = registerReplicatedApplyFailureListener;
+exports.unregisterReplicatedApplyFailureListener = unregisterReplicatedApplyFailureListener;
+exports.notifyReplicatedApplyFailure = notifyReplicatedApplyFailure;
+const databases_ts_1 = require("./databases.js");
+const logger_ts_1 = require("../utility/logging/logger.js");
+const transaction_ts_1 = require("./transaction.js");
+const listenersByDatabase = new Map();
+let watchingDatabaseRemoval = false;
+function registerReplicatedApplyFailureListener(database, listener) {
+    if (!watchingDatabaseRemoval) {
+        (0, databases_ts_1.onRemovedDB)((database) => listenersByDatabase.delete(database));
+        watchingDatabaseRemoval = true;
+    }
+    let listeners = listenersByDatabase.get(database);
+    if (!listeners)
+        listenersByDatabase.set(database, (listeners = new Set()));
+    listeners.add(listener);
+}
+function unregisterReplicatedApplyFailureListener(database, listener) {
+    const listeners = listenersByDatabase.get(database);
+    listeners?.delete(listener);
+    if (listeners?.size === 0)
+        listenersByDatabase.delete(database);
+}
+async function notifyReplicatedApplyFailure(database, event, position, error, table) {
+    if (listenersByDatabase.size === 0)
+        return;
+    try {
+        if (typeof event?.nodeId !== 'number' || typeof position !== 'number')
+            return;
+        const listeners = listenersByDatabase.get(database);
+        if (!listeners)
+            return;
+        const failure = Object.freeze({
+            database,
+            table: event.table ?? table,
+            nodeId: event.nodeId,
+            position,
+            localTime: event.localTime,
+            error,
+        });
+        for (const listener of [...listeners]) {
+            try {
+                await transaction_ts_1.contextStorage.exit(() => listener(failure));
+            }
+            catch (error) {
+                logListenerFailure(database, error);
+            }
+        }
+    }
+    catch (error) {
+        logListenerFailure(database, error);
+    }
+}
+function logListenerFailure(database, error) {
+    try {
+        logger_ts_1.logger.error?.('replicated apply failure listener failed', database, error);
+    }
+    catch { }
+}
+//# sourceMappingURL=replicatedApplyFailure.js.map

package/dist/resources/replicatedApplyFailure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replicatedApplyFailure.js","sourceRoot":"","sources":["../../resources/replicatedApplyFailure.ts"],"names":[],"mappings":";;AAkBA,wFAWC;AAED,4FAOC;AAED,oEA8BC;AAtED,iDAA6C;AAC7C,4DAAsD;AACtD,qDAAkD;AAalD,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAA+C,CAAC;AACnF,IAAI,uBAAuB,GAAG,KAAK,CAAC;AAEpC,SAAgB,sCAAsC,CACrD,QAAgB,EAChB,QAAwC;IAExC,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC9B,IAAA,0BAAW,EAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChE,uBAAuB,GAAG,IAAI,CAAC;IAChC,CAAC;IACD,IAAI,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,CAAC,SAAS;QAAE,mBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;IAC3E,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED,SAAgB,wCAAwC,CACvD,QAAgB,EAChB,QAAwC;IAExC,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpD,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,SAAS,EAAE,IAAI,KAAK,CAAC;QAAE,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAEM,KAAK,UAAU,4BAA4B,CACjD,QAAgB,EAChB,KAA8D,EAC9D,QAA4B,EAC5B,KAAc,EACd,KAAc;IAEd,IAAI,mBAAmB,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO;IAC3C,IAAI,CAAC;QACJ,IAAI,OAAO,KAAK,EAAE,MAAM,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,OAAO;QAC9E,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,OAAO,GAA2B,MAAM,CAAC,MAAM,CAAC;YACrD,QAAQ;YACR,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK;YAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ;YACR,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK;SACL,CAAC,CAAC;QACH,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC;gBACJ,MAAM,+BAAc,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;QACF,CAAC;IACF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB,EAAE,KAAc;IAC3D,IAAI,CAAC;QACJ,kBAAM,CAAC,KAAK,EAAE,CAAC,0CAA0C,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACX,CAAC"}

package/dist/resources/scheduler/scheduler.js

@@ -81,12 +81,12 @@ async function handleApplication(scope) {
         jobs.push(job);
     }
     // Activation gates: one worker owns scheduling for the whole node
-    // (getWorkerIndex() === 0 is correct in every threading mode, including
+    // (the application's primary worker is correct in every threading mode, including
     // threads:0 where the main thread acts as worker 0), and a deploy
     // pre-flight validation scope must never touch the live engine — it can
     // share a running component's identity, so registering from it would
-    // displace the real component's jobs (review finding).
-    if ((0, manageThreads_js_1.getWorkerIndex)() !== 0) {
+    // displace the real component's jobs.
+    if (!(0, manageThreads_js_1.isApplicationPrimaryWorker)(scope.applicationScope?.name)) {
         schedulerLogger.debug?.('Scheduler config validated; activation skipped on non-primary worker');
         return;
     }

package/dist/resources/scheduler/scheduler.js.map

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

package/dist/resources/search.d.ts

@@ -10,15 +10,21 @@ export declare const COERCIBLE_OPERATORS: {
 };
 export declare function executeConditions(conditions: any, operator: any, table: any, txn: any, request: any, context: any, transformToEntries: any, filtered: any, recordAccess?: any): any;
 /**
- * Search for records or keys, based on the search condition, using an index if available
+ * Search for records or keys, based on the search condition, using an index if available. The four
+ * leading parameters are required at every call site; everything optional is named, so a new
+ * capability can be added without shifting positions at callers that don't use it.
  * @param searchCondition
  * @param transaction
  * @param reverse
  * @param Table
- * @param allowFullScan
- * @param filtered
+ * @param options
  */
-export declare function searchByIndex(searchCondition: DirectCondition, transaction: any, reverse: boolean, Table: any, allowFullScan?: boolean, filtered?: any, context?: any, minResults?: number): AsyncIterable<Id | {
+export declare function searchByIndex(searchCondition: DirectCondition, transaction: any, reverse: boolean, Table: any, options?: {
+    allowFullScan?: boolean;
+    filtered?: any;
+    context?: any;
+    minResults?: number;
+}): AsyncIterable<Id | {
     key: Id;
     value: any;
 }>;