mongodash 2.2.0 → 2.3.0

package/dist/lib/src/task-management/OperationalTaskController.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OperationalTaskController = void 0;
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore
+const mongodb_1 = require("mongodb");
 const cronTasks_1 = require("../cronTasks");
 const getMongoClient_1 = require("../getMongoClient");
-const mongodb_1 = require("mongodb");
+const OnInfo_1 = require("../OnInfo");
+const ReactiveTaskTypes_1 = require("../reactiveTasks/ReactiveTaskTypes");
 class OperationalTaskController {
     constructor(scheduler) {
         this.scheduler = scheduler;
@@ -45,7 +49,7 @@ class OperationalTaskController {
             this.scheduler.getTaskManager().getTasks(query, {
                 limit: Number(params.limit || 50),
                 skip: Number(params.skip || 0),
-                sort: { field: 'scheduledAt', direction: 1 },
+                sort: { field: 'nextRunAt', direction: 1 },
             }),
             this.scheduler.getTaskManager().getTaskStats(statsQuery),
         ]);
@@ -72,7 +76,15 @@ class OperationalTaskController {
         if (body.sourceDocId) {
             query.sourceDocFilter = this.createSmartIdFilter(body.sourceDocId);
         }
-        return this.scheduler.getTaskManager().retryTasks(query);
+        const result = await this.scheduler.getTaskManager().retryTasks(query);
+        (0, OnInfo_1.onInfo)({
+            message: `Manual intervention via Dashboard: Retry tasks matching ${JSON.stringify(body)}`,
+            code: ReactiveTaskTypes_1.CODE_MANUAL_TRIGGER,
+            action: 'retry',
+            params: body,
+            modifiedCount: result.modifiedCount,
+        });
+        return result;
     }
     createSmartIdFilter(sourceDocId) {
         const input = sourceDocId.trim();
@@ -102,6 +114,12 @@ class OperationalTaskController {
         if (!body.taskId)
             throw new Error('taskId is required');
         await (0, cronTasks_1.triggerCronTask)(body.taskId);
+        (0, OnInfo_1.onInfo)({
+            message: `Manual intervention via Dashboard: Triggered Cron Task '${body.taskId}'`,
+            code: ReactiveTaskTypes_1.CODE_MANUAL_TRIGGER,
+            action: 'triggerCron',
+            taskId: body.taskId,
+        });
         return { success: true };
     }
     async getInfo() {

package/dist/lib/src/task-management/OperationalTaskController.js.map

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

package/dist/lib/src/withLock.js

@@ -1,18 +1,13 @@
 'use strict';
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LockAlreadyAcquiredError = void 0;
-exports.init = init;
+exports.reset = reset;
 exports.isLockAlreadyAcquiredError = isLockAlreadyAcquiredError;
 exports.withLock = withLock;
 // import * as _debug from 'debug';
 const mongodb_1 = require("mongodb");
 const createContinuousLock_1 = require("./createContinuousLock");
 const getCollection_1 = require("./getCollection");
-// const debug = _debug('mongodash:withLock');
-let onError;
-function init(options) {
-    onError = options.onError;
-}
 const lockAcquiredMessage = 'The lock is already acquired.';
 const expirationKey = 'expiresAt';
 let collectionPromise;
@@ -26,6 +21,11 @@ async function getLockerCollection() {
     }
     return collectionPromise;
 }
+function reset() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    collectionPromise = null;
+}
 class LockAlreadyAcquiredError extends Error {
     constructor(key) {
         super(lockAcquiredMessage);
@@ -40,7 +40,12 @@ function isLockAlreadyAcquiredError(err, key) {
     }
     return key ? err.key === key : true;
 }
-async function withLock(key, callback, { maxWaitForLock = 3 * 1000, startingDelay = 50, expireIn = 15 * 1000 } = {}) {
+async function withLock(key, callback, options) {
+    var _a, _b, _c;
+    const _options = options !== null && options !== void 0 ? options : {};
+    const maxWaitForLock = (_a = _options.maxWaitForLock) !== null && _a !== void 0 ? _a : 3 * 1000;
+    const startingDelay = (_b = _options.startingDelay) !== null && _b !== void 0 ? _b : 50;
+    const expireIn = (_c = _options.expireIn) !== null && _c !== void 0 ? _c : 15 * 1000;
     const lockId = new mongodb_1.ObjectId();
     const stringKey = `${key}`;
     const maxDate = new Date(Date.now() + maxWaitForLock);
@@ -94,7 +99,7 @@ async function withLock(key, callback, { maxWaitForLock = 3 * 1000, startingDela
             }
         }
     }
-    const stopContinuousLock = (0, createContinuousLock_1.createContinuousLock)(collection, stringKey, expirationKey, expireIn, onError);
+    const stopContinuousLock = (0, createContinuousLock_1.createContinuousLock)(collection, stringKey, expirationKey, expireIn);
     const cleanUp = () => Promise.all([stopContinuousLock(), releaseLock()]);
     let value;
     let err;

package/dist/lib/src/withLock.js.map

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

package/dist/lib/src/withTransaction.js

@@ -1,16 +1,10 @@
 'use strict';
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.init = init;
 exports.registerPostCommitHook = registerPostCommitHook;
 exports.withTransaction = withTransaction;
 const getMongoClient_1 = require("./getMongoClient");
+const OnError_1 = require("./OnError");
 const postCommitHooks = new WeakMap();
-let _onError;
-let _onInfo;
-function init(options) {
-    _onError = options.onError;
-    _onInfo = options.onInfo;
-}
 function registerPostCommitHook(session, hook) {
     if (!session.inTransaction()) {
         throw new Error('It is not possible to register a post commit hook without active transaction.');
@@ -21,20 +15,20 @@ function registerPostCommitHook(session, hook) {
     }
     hooks.push(hook);
 }
-async function withTransaction(callback, options) {
+async function withTransaction(callback) {
     const clientSession = (0, getMongoClient_1.getMongoClient)().startSession();
     postCommitHooks.set(clientSession, []);
     try {
         let returnValue;
         await clientSession.withTransaction(async () => {
             returnValue = await callback(clientSession);
-        }, options);
+        });
         const hooks = postCommitHooks.get(clientSession);
         if (hooks.length > 0) {
             const results = await Promise.allSettled(hooks.map((hook) => hook()));
             results.forEach((result) => {
                 if (result.status === 'rejected') {
-                    _onError(result.reason);
+                    (0, OnError_1.onError)(result.reason);
                 }
             });
         }

package/dist/lib/src/withTransaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"withTransaction.js","sourceRoot":"","sources":["../../../src/withTransaction.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAkBb,oBAGC;AAED,wDAYC;AAED,0CA4BC;AA9DD,qDAAkD;AAWlD,MAAM,eAAe,GAAG,IAAI,OAAO,EAAmC,CAAC;AACvE,IAAI,QAAiB,CAAC;AACtB,IAAI,OAAe,CAAC;AAEpB,SAAgB,IAAI,CAAC,OAAoB;IACrC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAC3B,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;AAC7B,CAAC;AAED,SAAgB,sBAAsB,CAAC,OAAsB,EAAE,IAAoB;IAC/E,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,wGAAwG,CAAC,CAAC;IAC9H,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAEM,KAAK,UAAU,eAAe,CAAI,QAAgD,EAAE,OAA4B;IACnH,MAAM,aAAa,GAAG,IAAA,+BAAc,GAAE,CAAC,YAAY,EAAE,CAAC;IAEtD,eAAe,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAEvC,IAAI,CAAC;QACD,IAAI,WAAc,CAAC;QAEnB,MAAM,aAAa,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE;YAC3C,WAAW,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;QAChD,CAAC,EAAE,OAAO,CAAC,CAAC;QAEZ,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC;QAElD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBACvB,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;oBAC/B,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC5B,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,WAAY,CAAC;IACxB,CAAC;YAAS,CAAC;QACP,eAAe,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACtC,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC;AACL,CAAC"}
+{"version":3,"file":"withTransaction.js","sourceRoot":"","sources":["../../../src/withTransaction.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAYb,wDAYC;AAED,0CA4BC;AAjDD,qDAAkD;AAClD,uCAAoC;AAIpC,MAAM,eAAe,GAAG,IAAI,OAAO,EAAmC,CAAC;AAEvE,SAAgB,sBAAsB,CAAC,OAAsB,EAAE,IAAoB;IAC/E,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,wGAAwG,CAAC,CAAC;IAC9H,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAEM,KAAK,UAAU,eAAe,CAAI,QAAgD;IACrF,MAAM,aAAa,GAAG,IAAA,+BAAc,GAAE,CAAC,YAAY,EAAE,CAAC;IAEtD,eAAe,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAEvC,IAAI,CAAC;QACD,IAAI,WAAc,CAAC;QAEnB,MAAM,aAAa,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE;YAC3C,WAAW,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC;QAElD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBACvB,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;oBAC/B,IAAA,iBAAO,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC3B,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,WAAY,CAAC;IACxB,CAAC;YAAS,CAAC;QACP,eAAe,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACtC,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC;AACL,CAAC"}

package/dist/types/src/OnError.d.ts

@@ -1,3 +1,12 @@
 export type OnError = (error: Error) => void;
 export declare const defaultOnError: OnError;
-export declare function secureOnError(onError: OnError): OnError;
+/**
+ * Updates the global onError handler.
+ * Automatically wraps the provided handler with secureOnError for safety.
+ */
+export declare function setGlobalOnError(onError: OnError): void;
+/**
+ * Global wrapper that delegates to the currently configured onError handler.
+ * Can be imported and used directly by any component.
+ */
+export declare const onError: OnError;

package/dist/types/src/OnInfo.d.ts

@@ -3,4 +3,13 @@ export type OnInfo = (info: {
     code: string;
 } & Record<string, unknown>) => void;
 export declare const defaultOnInfo: OnInfo;
-export declare function secureOnInfo(onInfo: OnInfo): OnInfo;
+/**
+ * Updates the global onInfo handler.
+ * Automatically wraps the provided handler with secureOnInfo for safety.
+ */
+export declare function setGlobalOnInfo(onInfo: OnInfo): void;
+/**
+ * Global wrapper that delegates to the currently configured onInfo handler.
+ * Can be imported and used directly by any component.
+ */
+export declare const onInfo: OnInfo;

package/dist/types/src/createContinuousLock.d.ts

@@ -1,7 +1,6 @@
-import { Collection } from 'mongodb';
-import { OnError } from './OnError';
+import { Collection, ObjectId } from 'mongodb';
 type StopContinuousLock = () => Promise<void>;
 export declare function createContinuousLock<DocumentType extends {
-    _id: string;
-}>(collection: Collection<DocumentType>, documentId: string, lockProperty: keyof DocumentType, lockTime: number, onError: OnError): StopContinuousLock;
+    _id: string | ObjectId;
+}>(collection: Collection<DocumentType>, documentId: DocumentType['_id'], lockProperty: keyof DocumentType, lockTime: number): StopContinuousLock;
 export {};

package/dist/types/src/createSecureHandler.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Creates a secure wrapper for a handler function.
+ * The wrapped function will catch and suppress any errors thrown by the handler.
+ */
+export declare function createSecureHandler<T extends (...args: any[]) => any>(handler: T): T;

package/dist/types/src/cronTasks.d.ts

@@ -1,6 +1,11 @@
 import { CronExpressionOptions } from 'cron-parser';
-import { OnError } from './OnError';
-import { OnInfo } from './OnInfo';
+export interface InitOptions {
+    runCronTasks: boolean;
+    cronExpressionParserOptions: CronExpressionOptions;
+    cronTaskCaller: CronTaskCaller;
+    cronTaskFilter: CronTaskFilter;
+}
+export declare function init(options: InitOptions): void;
 export declare const CODE_CRON_TASK_STARTED = "cronTaskStarted";
 export declare const CODE_CRON_TASK_FINISHED = "cronTaskFinished";
 export declare const CODE_CRON_TASK_SCHEDULED = "cronTaskScheduled";
@@ -50,15 +55,6 @@ export interface CronTaskFilter {
     }): boolean;
 }
 export declare function runCronTask(taskId: TaskId): Promise<void>;
-export type InitOptions = {
-    runCronTasks: boolean;
-    cronExpressionParserOptions: CronExpressionOptions;
-    onError: OnError;
-    onInfo: OnInfo;
-    cronTaskCaller: CronTaskCaller;
-    cronTaskFilter: CronTaskFilter;
-};
-export declare function init(initOptions: InitOptions): void;
 export declare function stopCronTasks(): void;
 export declare function startCronTasks(): void;
 export declare function scheduleCronTaskImmediately(taskId: TaskId): Promise<void>;

package/dist/types/src/getCollection.d.ts

@@ -11,4 +11,5 @@ export type InitOptions = {
     collectionFactory: CollectionFactory | null;
 };
 export declare function init(options: InitOptions): void;
+export declare function reset(): void;
 export declare function getCollection<T extends Document>(name: string): Collection<T>;

package/dist/types/src/index.d.ts

@@ -1,19 +1,19 @@
+import { Collection } from 'mongodb';
 import { InitOptions as CronTasksInitOptions } from './cronTasks';
-import { InitOptions as ReactiveTasksInitOptions } from './reactiveTasks';
 import { InitOptions as GetCollectionInitOptions } from './getCollection';
 import { InitOptions as GetMongoClientInitOptions } from './getMongoClient';
 import { OnError } from './OnError';
 import { OnInfo } from './OnInfo';
-import { Collection } from 'mongodb';
-export { cronTask, Interval, runCronTask, scheduleCronTaskImmediately, startCronTasks, stopCronTasks, TaskFunction, TaskId, CODE_CRON_TASK_STARTED, CODE_CRON_TASK_FINISHED, CODE_CRON_TASK_SCHEDULED, CODE_CRON_TASK_FAILED, getCronTasksList, triggerCronTask, CronTaskQuery, CronPagedResult, CronTaskRecord, CronTaskStatus, } from './cronTasks';
+import { InitOptions as ReactiveTasksInitOptions } from './reactiveTasks';
+export { CODE_CRON_TASK_FAILED, CODE_CRON_TASK_FINISHED, CODE_CRON_TASK_SCHEDULED, CODE_CRON_TASK_STARTED, CronPagedResult, cronTask, CronTaskQuery, CronTaskRecord, CronTaskStatus, getCronTasksList, Interval, runCronTask, scheduleCronTaskImmediately, startCronTasks, stopCronTasks, TaskFunction, TaskId, triggerCronTask, } from './cronTasks';
 export { getCollection } from './getCollection';
 export { getMongoClient } from './getMongoClient';
 export { OnError } from './OnError';
-export { withLock, isLockAlreadyAcquiredError, WithLockOptions, LockAlreadyAcquiredError } from './withLock';
-export { withTransaction, registerPostCommitHook, PostCommitHook } from './withTransaction';
-export { reactiveTask, ReactiveTask, ReactiveTaskHandler, TaskConditionFailedError, startReactiveTasks, stopReactiveTasks, getPrometheusMetrics, _scheduler, CODE_REACTIVE_TASK_STARTED, CODE_REACTIVE_TASK_FINISHED, CODE_REACTIVE_TASK_FAILED, CODE_REACTIVE_TASK_PLANNER_STARTED, CODE_REACTIVE_TASK_PLANNER_STOPPED, CODE_REACTIVE_TASK_PLANNER_RECONCILIATION_STARTED, CODE_REACTIVE_TASK_PLANNER_RECONCILIATION_FINISHED, CODE_REACTIVE_TASK_PLANNER_STREAM_ERROR, CODE_REACTIVE_TASK_LEADER_LOCK_LOST, getReactiveTasks, countReactiveTasks, retryReactiveTasks, } from './reactiveTasks';
 export { processInBatches, ProcessInBatchesOptions, ProcessInBatchesResult } from './processInBatches';
-export { serveDashboard, OperationalTaskController } from './task-management';
+export { CODE_REACTIVE_TASK_FAILED, CODE_REACTIVE_TASK_FINISHED, CODE_REACTIVE_TASK_LEADER_LOCK_LOST, CODE_REACTIVE_TASK_PLANNER_RECONCILIATION_FINISHED, CODE_REACTIVE_TASK_PLANNER_RECONCILIATION_STARTED, CODE_REACTIVE_TASK_PLANNER_STARTED, CODE_REACTIVE_TASK_PLANNER_STOPPED, CODE_REACTIVE_TASK_PLANNER_STREAM_ERROR, CODE_REACTIVE_TASK_STARTED, countReactiveTasks, getPrometheusMetrics, getReactiveTasks, reactiveTask, ReactiveTask, ReactiveTaskHandler, retryReactiveTasks, startReactiveTasks, stopReactiveTasks, TaskConditionFailedError, _scheduler, } from './reactiveTasks';
+export { OperationalTaskController, serveDashboard } from './task-management';
+export { isLockAlreadyAcquiredError, LockAlreadyAcquiredError, withLock, WithLockOptions } from './withLock';
+export { PostCommitHook, registerPostCommitHook, withTransaction } from './withTransaction';
 type PackageOptions = {
     onError?: OnError;
     onInfo?: OnInfo;

package/dist/types/src/reactiveTasks/ReactiveTaskTypes.d.ts

@@ -33,16 +33,25 @@ export interface ReactiveTaskRecord<T = Document> {
     sourceDocId: WithId<T>['_id'];
     status: ReactiveTaskStatus;
     attempts: number;
-    scheduledAt: Date;
+    /**
+     * The effective time used for polling.
+     * - Pending: Time when the task becomes eligible to run.
+     * - Processing: Time when the lock expires (zombie recovery).
+     * - Completed/Failed: NULL (not indexed, not polled).
+     */
+    nextRunAt: Date | null;
+    /**
+     * The original time the task was first scheduled to run.
+     * This preserves the original baseline for global lag calculation.
+     */
+    dueAt: Date;
     createdAt: Date;
     updatedAt: Date;
     startedAt?: Date | null;
     completedAt?: Date | null;
-    lockExpiresAt?: Date | null;
     firstErrorAt?: Date | null;
     lastError?: string | null;
     lastFinalizedAt?: Date | null;
-    initialScheduledAt?: Date | null;
     lastObservedValues?: Record<string, unknown> | null;
     lastSuccess?: {
         at: Date;
@@ -131,7 +140,7 @@ export interface ReactiveTaskContext<T = Document> {
      * Defers the task execution to a later time.
      * The task will remain 'pending' (or effectively so) until the specified time.
      * Use this for temporary external failures (e.g. rate limits) or to postpone processing.
-     * This preserves the original `scheduledAt` for global lag calculation.
+     * This preserves the original baseline `dueAt` for global lag calculation.
      */
     deferCurrent(delay: number | Date): void;
     /**
@@ -224,7 +233,7 @@ export interface ReactiveTask<T extends Document> {
      */
     filter?: Filter<T>;
     handler: ReactiveTaskHandler<T>;
-    /** Time (ms) or interval description (e.g. "500ms", "1s") to postpone `scheduledAt` on change (Debouncing). Default: 1000ms */
+    /** Time (ms) or interval description (e.g. "500ms", "1s") to postpone execution on change (Debouncing). Default: 1000ms */
     debounce?: number | string;
     /** Retry Policy configuration */
     retryPolicy?: RetryPolicy;
@@ -303,6 +312,12 @@ export interface ReactiveTaskSchedulerOptions {
      * Default: '24h'
      */
     reactiveTaskCleanupInterval?: number | string;
+    /**
+     * Timeout for the visibility lock on tasks (ms).
+     * Tasks that take longer than this will be picked up by other workers (if lock renewal fails).
+     * Default: 60000 (1m)
+     */
+    visibilityTimeoutMs?: number;
 }
 /**
  * Filter function to restrict which tasks are processed by the worker.
@@ -329,6 +344,7 @@ export declare const CODE_REACTIVE_TASK_PLANNER_STREAM_ERROR = "reactiveTaskPlan
 export declare const CODE_REACTIVE_TASK_LEADER_LOCK_LOST = "reactiveTaskLeaderLockLost";
 export declare const CODE_REACTIVE_TASK_INITIALIZED = "reactiveTaskInitialized";
 export declare const CODE_REACTIVE_TASK_CLEANUP = "reactiveTaskCleanup";
+export declare const CODE_MANUAL_TRIGGER = "manualTrigger";
 export declare const REACTIVE_TASK_META_DOC_ID = "_mongodash_planner_meta";
 /**
  * Filter for querying tasks.

package/dist/types/src/reactiveTasks/index.d.ts

@@ -1,16 +1,12 @@
 import { Document } from 'mongodb';
 import type { Registry } from 'prom-client';
 import { GlobalsCollection } from '../globalsCollection';
-import { OnError } from '../OnError';
-import { OnInfo } from '../OnInfo';
 import { ReactiveTaskManager } from './ReactiveTaskManager';
 import { ReactiveTaskRegistry } from './ReactiveTaskRegistry';
 import { PagedResult, PaginationOptions, ReactiveTask, ReactiveTaskQuery, ReactiveTaskRecord, ReactiveTaskSchedulerOptions } from './ReactiveTaskTypes';
 export { CODE_REACTIVE_TASK_CLEANUP, CODE_REACTIVE_TASK_FAILED, CODE_REACTIVE_TASK_FINISHED, CODE_REACTIVE_TASK_INITIALIZED, CODE_REACTIVE_TASK_LEADER_LOCK_LOST, CODE_REACTIVE_TASK_PLANNER_RECONCILIATION_FINISHED, CODE_REACTIVE_TASK_PLANNER_RECONCILIATION_STARTED, CODE_REACTIVE_TASK_PLANNER_STARTED, CODE_REACTIVE_TASK_PLANNER_STOPPED, CODE_REACTIVE_TASK_PLANNER_STREAM_ERROR, CODE_REACTIVE_TASK_STARTED, PagedResult, PaginationOptions, ReactiveTask, ReactiveTaskCaller, ReactiveTaskFilter, ReactiveTaskHandler, ReactiveTaskQuery, ReactiveTaskRecord, ReactiveTaskSchedulerOptions, ReactiveTaskStatus, REACTIVE_TASK_META_DOC_ID, TaskConditionFailedError, } from './ReactiveTaskTypes';
 export { scheduler as _scheduler };
 export type InitOptions = {
-    onError: OnError;
-    onInfo: OnInfo;
     globalsCollection: GlobalsCollection;
 } & Partial<ReactiveTaskSchedulerOptions>;
 /**

package/dist/types/src/task-management/OperationalTaskController.d.ts

@@ -1,6 +1,6 @@
 import { ReactiveTaskScheduler } from '../reactiveTasks/index';
-import { CronTaskQuery } from '../cronTasks';
 import { Document } from 'mongodb';
+import { CronTaskQuery } from '../cronTasks';
 export declare class OperationalTaskController {
     private scheduler;
     constructor(scheduler: ReactiveTaskScheduler);

package/dist/types/src/withLock.d.ts

@@ -1,8 +1,4 @@
 import { ObjectId } from 'mongodb';
-import { OnError } from './OnError';
-export declare function init(options: {
-    onError: OnError;
-}): void;
 export type LockKey = string | number | ObjectId;
 export type LockCallback<T> = () => Promise<T>;
 export type WithLockOptions = {
@@ -10,9 +6,10 @@ export type WithLockOptions = {
     startingDelay?: number;
     expireIn?: number;
 };
+export declare function reset(): void;
 export declare class LockAlreadyAcquiredError extends Error {
     readonly key: LockKey;
     constructor(key: LockKey);
 }
 export declare function isLockAlreadyAcquiredError(err: unknown, key?: LockKey): boolean;
-export declare function withLock<T>(key: LockKey, callback: LockCallback<T>, { maxWaitForLock, startingDelay, expireIn }?: WithLockOptions): Promise<T>;
+export declare function withLock<T>(key: LockKey, callback: LockCallback<T>, options?: WithLockOptions): Promise<T>;

package/dist/types/src/withTransaction.d.ts

@@ -1,11 +1,4 @@
-import { ClientSession, TransactionOptions } from 'mongodb';
-import { OnError } from './OnError';
-import { OnInfo } from './OnInfo';
-export type InitOptions = {
-    onError: OnError;
-    onInfo: OnInfo;
-};
+import { ClientSession } from 'mongodb';
 export type PostCommitHook = () => void | Promise<void>;
-export declare function init(options: InitOptions): void;
 export declare function registerPostCommitHook(session: ClientSession, hook: PostCommitHook): void;
-export declare function withTransaction<T>(callback: (session: ClientSession) => Promise<T>, options?: TransactionOptions): Promise<T>;
+export declare function withTransaction<T>(callback: (session: ClientSession) => Promise<T>): Promise<T>;

package/docs/.vitepress/cache/deps/_metadata.json

@@ -1,25 +1,25 @@
 {
-  "hash": "c467da12",
+  "hash": "65ae190e",
   "configHash": "1734f516",
-  "lockfileHash": "f98f585a",
-  "browserHash": "10463ff1",
+  "lockfileHash": "68b03582",
+  "browserHash": "246dbe54",
   "optimized": {
     "vue": {
       "src": "../../../../node_modules/vue/dist/vue.runtime.esm-bundler.js",
       "file": "vue.js",
-      "fileHash": "de0034a7",
+      "fileHash": "1ab8f95b",
       "needsInterop": false
     },
     "vitepress > @vue/devtools-api": {
       "src": "../../../../node_modules/@vue/devtools-api/dist/index.js",
       "file": "vitepress___@vue_devtools-api.js",
-      "fileHash": "d9769aa4",
+      "fileHash": "eb38336e",
       "needsInterop": false
     },
     "vitepress > @vueuse/core": {
       "src": "../../../../node_modules/@vueuse/core/index.mjs",
       "file": "vitepress___@vueuse_core.js",
-      "fileHash": "0b22d1b5",
+      "fileHash": "d06fa19f",
       "needsInterop": false
     }
   },

package/docs/.vitepress/config.mts

@@ -36,7 +36,7 @@ export default defineConfig({
                             { text: 'Configuration', link: '/reactive-tasks/configuration' },
                             { text: 'Retry Policy', link: '/reactive-tasks/policy-retry' },
                             { text: 'Cleanup Policy', link: '/reactive-tasks/policy-cleanup' },
-                            { text: 'Filter & Logic Evolution', link: '/reactive-tasks/evolution' },
+                            { text: 'Task Evolution', link: '/reactive-tasks/evolution' },
                             { text: 'Reconciliation', link: '/reactive-tasks/reconciliation' },
                             { text: 'Task Management & DLQ', link: '/reactive-tasks/management' },
                             { text: 'Monitoring', link: '/reactive-tasks/monitoring' },

package/docs/reactive-tasks/configuration.md

@@ -25,7 +25,7 @@ you can use the following options:
 | `retryPolicy` | `RetryPolicy` | Configuration for retries on failure. See [Retry Policy](./policy-retry.md). |
 | `cleanupPolicy` | `CleanupPolicy` | Configuration for automatic cleanup of orphaned task records. See [Cleanup Policy](./policy-cleanup.md). |
 | `executionHistoryLimit` | `number` | Number of past execution entries to keep in `_tasks` doc. Default: `5`. |
-| `evolution` | `EvolutionConfig` | Configuration for handling task logic updates (versioning, reconciliation policies). See [Filter & Logic Evolution](./evolution.md). |
+| `evolution` | `EvolutionConfig` | Configuration for handling task logic updates (versioning, reconciliation policies). See [Task Evolution](./evolution.md). |
 
 ## Advanced Initialization
 

package/docs/reactive-tasks/core-concepts.md

@@ -41,6 +41,8 @@ To ensure reliability and efficiency, the system needs to determine *when* to tr
     watchProjection: { updatedAt: 1 } 
     ```
 
+
+
 ## Task Lifecycle (States)
 
 Every task record in the `_tasks` collection follows a specific lifecycle:
@@ -56,3 +58,20 @@ Every task record in the `_tasks` collection follows a specific lifecycle:
 
 
 
+
+## Task Schema
+
+Each reactive task is stored as a document in the `[collection]_tasks` collection. Key fields include:
+
+-   `task`: The task name.
+-   `sourceDocId`: The `_id` of the source document.
+-   `status`: Current state (`pending`, `processing`, `completed`, `failed`).
+-   `nextRunAt`: **Core Scheduling Field**.
+    -   For `pending` tasks: The time when the task is eligible to run (includes delays/backoff).
+    -   For `processing` tasks: The time when the processing lock expires (visibility timeout).
+    -   For `completed`/`failed` tasks: `null` (removed from the polling index).
+-   `dueAt` (formerly `initialScheduledAt`): The **Original Scheduled Time**.
+    -   This value is static and represents when the task *should* have run primarily.
+    -   It is used for calculating **Lag** metrics (SLA monitoring) and does not change during retries or backoffs.
+-   `attempts`: Number of execution attempts (including the first one).
+-   `lastError`: The error message from the last failure (if any).

package/docs/reactive-tasks/evolution.md

@@ -1,4 +1,4 @@
-# Filter & Logic Evolution
+# Task Evolution
 
 Reactive Tasks are designed to evolve with your application. As you deploy new versions of your code, you might change the `filter`, `watchProjection`, or the `handler` logic itself. The system automatically detects these changes and adapts the task state accordingly.
 

package/docs/reactive-tasks/guides.md

@@ -1,24 +1,64 @@
 # Guides & Patterns
 
+## Understanding Logic: Filter vs WatchProjection
+
+It is important to understand the relationship between `filter` and `watchProjection`. You can think of them as **"The Gatekeeper"** and **"The Trigger"**.
+
+### 1. `filter` (The Gatekeeper)
+Decides **IF** the task should exist at all.
+-   **Enters Filter**: If a document changes to match the filter (e.g., `status` changes from `'pending'` -> `'paid'`), the task is **created and runs immediately**, regardless of `watchProjection`.
+-   **Leaves Filter**: If a document changes to no longer match (e.g., `'paid'` -> `'cancelled'`), the task is **removed/cleaned up** (depending on your [Cleanup Policy](./policy-cleanup.md)).
+
+### 2. `watchProjection` (The Trigger)
+Decides **WHEN** to re-run the task *if it already exists*.
+-   Once the task matches the filter and is active, `watchProjection` determines which future updates matter.
+-   **Example**: You have a task to sync paid orders to ERP.
+    ```typescript
+    {
+        filter: { status: 'paid' },
+        watchProjection: { status: 1 } // Only watch status
+    }
+    ```
+    -   **Scenario**: User updates `shippingAddress` on a `paid` order.
+    -   **Result**: The system sees `status` didn't change (still `'paid'`). It **IGNORES** the address update. The ERP sync **does not re-run** (potentially leaving ERP with stale address).
+    -   **Fix**: If you need to re-sync on address changes, include `shippingAddress` in `watchProjection` (or omit it to watch everything).
+
+> [!TIP]
+> **Best Practice**: If you use a field in `filter` (like `status: 'paid'`), you implicitly don't need to put it in `watchProjection` unless the value can change while remaining valid (e.g., `amount > 100`). However, adding it is harmless and can improve clarity and storage efficiency.
+
+## Execution Model & Guarantees
+
+The system follows a **Reactive (State-Based)** execution model. It prioritizes **Eventual Consistency** over strict event logging.
 
+### 1. State-Based Consistency (vs. Event-Based)
 
-## Idempotency & Re-execution
+Unlike an Event Bus (e.g., Kafka) that processes every single state transition log, this library guarantees that the **current state** of the document will consistently match your task logic.
 
-The system is designed with an **At-Least-Once** execution guarantee. This is a fundamental property of distributed systems that value reliability over "exactly-once".
+*   **Transient States are Skipped**: If a document changes state multiple times rapidly (e.g., `pending` -> `paid` -> `refunded` in milliseconds), the system may skip processing the intermediate `paid` state if it is no longer valid by the time the worker picks it up.
+*   **Late Binding Check**: This is enforced via a runtime check (`getDocument`). If the fetched document no longer matches the task filter or the watched fields have changed since triggering, the task for the "stale" version is skipped. This is a feature (Optimistic Concurrency) to prevent processing obsolete data.
 
-While the system strives to execute your handler exactly once per event, there are specific scenarios where it might execute multiple times for the same document state. Therefore, **your `handler` must be idempotent**.
+### 2. At-Least-Once Guarantee (Final State)
 
-### Common Re-execution Scenarios
+The system guarantees that the **final, stable state** of a document will strictly be processed **at least once**.
+If a worker crashes, loses network, or restarts *before* successfully completing a task (and releasing the lock), the task remains `pending`. Another worker will pick it up and retry execution.
+
+### 3. Idempotency Requirement
+
+Because of the "At-Least-Once" guarantee, **your `handler` must be idempotent**.
+This means it should be safe to run the same handler multiple times for the same document without producing incorrect side effects (like sending duplicate emails or charging a card twice).
+
+#### Common Re-execution Scenarios
 
 1.  **Transient Failures ([Retries](./policy-retry.md))**: If a worker crashes or loses network connectivity during execution (before marking the task `completed`), the lock will expire. Another worker will pick up the task and retry it.
 2.  **[Reconciliation](./reconciliation.md) Recovery**: If task records are deleted (e.g. manual cleanup) but source documents remain, once a reconciliation runs, it recreates them as `pending`.
-3.  **Filter Re-matching** If a document is no longer matching the task filter, the task is deleted because the **[sourceDocumentDeletedOrNoLongerMatching](./policy-cleanup.md)** cleanup policy is used and then the document is changed back again to match the task filter, the task will be recreated as `pending`.
-4.  **Explicit Reprocessing**: You might trigger re-execution manually (via `retryReactiveTasks`) or through [schema evolution policies](./evolution.md) (`reprocess_all`).
+3.  **Filter Re-matching**: If a document is no longer matching the task filter, the task is deleted because the **[sourceDocumentDeletedOrNoLongerMatching](./policy-cleanup.md)** cleanup policy is used and then the document is changed back again to match the task filter, the task will be recreated as `pending`.
+4.  **Explicit Reprocessing**: You might trigger re-execution manually (via `retryReactiveTasks`) or through [Task Evolution policies](./evolution.md) (`reprocess_all`).
 
-### Designing Idempotent Handlers
+#### Designing Idempotent Handlers
 
 Ensure your handler allows multiple executions without adverse side effects.
 
+
 **Example**:
 ```typescript
 handler: async (context) => {