mongodash 2.0.0 → 2.1.0

package/dist/lib/{withLock.js → src/withLock.js}

@@ -1,6 +1,6 @@
 /**!
-   * mongodash v2.0.0
-   * https://github.com/VaclavObornik/mongodash.git
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
    *
    * Copyright (c) 2025 Václav Oborník
    * Released under the MIT license
@@ -15,7 +15,6 @@ exports.withLock = withLock;
 const mongodb_1 = require("mongodb");
 const createContinuousLock_1 = require("./createContinuousLock");
 const getCollection_1 = require("./getCollection");
-const lodash_1 = require("lodash");
 // const debug = _debug('mongodash:withLock');
 let onError;
 function init(options) {
@@ -83,7 +82,7 @@ async function withLock(key, callback, { maxWaitForLock = 3 * 1000, startingDela
             break;
         }
         catch (err) {
-            const randomMultiplier = (0, lodash_1.random)(1, 1.2, true);
+            const randomMultiplier = Math.random() * (1.2 - 1) + 1; // replaces random(1, 1.2, true)
             let waitTime = Math.min(2 ** n * randomMultiplier * startingDelay, maxDelay);
             let nextTime = new Date(Date.now() + waitTime);
             const ultimateAttemptStart = new Date(maxDate.getTime() - lastAcquireDuration);

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

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

package/dist/lib/{withTransaction.js → src/withTransaction.js}

@@ -1,6 +1,6 @@
 /**!
-   * mongodash v2.0.0
-   * https://github.com/VaclavObornik/mongodash.git
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
    *
    * Copyright (c) 2025 Václav Oborník
    * Released under the MIT license
@@ -36,7 +36,7 @@ async function withTransaction(callback, options) {
         await clientSession.withTransaction(async () => {
             returnValue = await callback(clientSession);
         }, options);
-        const hooks = postCommitHooks.get(clientSession); // eslint-disable-line @typescript-eslint/no-non-null-assertion
+        const hooks = postCommitHooks.get(clientSession);
         if (hooks.length > 0) {
             const results = await Promise.allSettled(hooks.map((hook) => hook()));
             results.forEach((result) => {
@@ -45,7 +45,7 @@ async function withTransaction(callback, options) {
                 }
             });
         }
-        return returnValue; // eslint-disable-line @typescript-eslint/no-non-null-assertion
+        return returnValue;
     }
     finally {
         postCommitHooks.delete(clientSession);

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

@@ -0,0 +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"}

package/dist/lib/tools/check-db-connection.js

@@ -0,0 +1,28 @@
+/**!
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
+   *
+   * Copyright (c) 2025 Václav Oborník
+   * Released under the MIT license
+   */
+  "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mongodb_1 = require("mongodb");
+const testingDatabase_1 = require("./testingDatabase");
+exports.default = async () => {
+    const uri = (0, testingDatabase_1.getConnectionString)();
+    console.log(`Checking database connection at: ${uri}`);
+    try {
+        const client = new mongodb_1.MongoClient(uri, { serverSelectionTimeoutMS: 2000 }); // Fast fail
+        await client.connect();
+        await client.db('admin').command({ ping: 1 });
+        await client.close();
+        console.log('Database connection successful.');
+    }
+    catch (err) {
+        console.error('Database connection failed! Ensure MongoDB is running.');
+        console.error('Error:', err.message);
+        throw err; // Throwing error will cause Jest to fail fast
+    }
+};
+//# sourceMappingURL=check-db-connection.js.map

package/dist/lib/tools/check-db-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-db-connection.js","sourceRoot":"","sources":["../../../tools/check-db-connection.ts"],"names":[],"mappings":";;AAAA,qCAAsC;AACtC,uDAAwD;AAExD,kBAAe,KAAK,IAAI,EAAE;IACtB,MAAM,GAAG,GAAG,IAAA,qCAAmB,GAAE,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,qBAAW,CAAC,GAAG,EAAE,EAAE,wBAAwB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,YAAY;QACrF,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACxE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,GAAG,CAAC,CAAC,8CAA8C;IAC7D,CAAC;AACL,CAAC,CAAC"}

package/dist/lib/tools/clean-testing-databases.js

@@ -0,0 +1,12 @@
+/**!
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
+   *
+   * Copyright (c) 2025 Václav Oborník
+   * Released under the MIT license
+   */
+  "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const testingDatabase_1 = require("./testingDatabase");
+(0, testingDatabase_1.cleanTestingDatabases)(true);
+//# sourceMappingURL=clean-testing-databases.js.map

package/dist/lib/tools/clean-testing-databases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-testing-databases.js","sourceRoot":"","sources":["../../../tools/clean-testing-databases.ts"],"names":[],"mappings":";;AAAA,uDAA0D;AAE1D,IAAA,uCAAqB,EAAC,IAAI,CAAC,CAAC"}

package/dist/lib/tools/prepare-republish.js

@@ -0,0 +1,27 @@
+/**!
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
+   *
+   * Copyright (c) 2025 Václav Oborník
+   * Released under the MIT license
+   */
+  "use strict";
+const sh = require('shelljs');
+const cli = require('@bndynet/cli');
+cli.print(cli.styles.info(`
+# **** NOTE THAT ****
+# This command is just for failed to publish to NPM during running GitHub Action.
+# That will rewrite your history commits.
+# Please double confirm the commit id you typed and which is in your current branch.
+# *******************
+`));
+cli.questions(['Version(v1.0.0):', 'Commit id for publish:']).then((answers) => {
+    const version = answers[0] || 'v1.0.0';
+    const commitId = answers[1];
+    cli.log(`Remove your remote tag ${version} ...`);
+    sh.exec(`git tag -d ${version}`);
+    sh.exec(`git push --delete origin ${version}`);
+    cli.log(`Reset your commit and force to push ...`);
+    sh.exec(`git reset ${commitId} --hard && git push -f`);
+});
+//# sourceMappingURL=prepare-republish.js.map

package/dist/lib/tools/prepare-republish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-republish.js","sourceRoot":"","sources":["../../../tools/prepare-republish.ts"],"names":[],"mappings":";AAAA,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAEpC,GAAG,CAAC,KAAK,CACL,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;CAMnB,CAAC,CACD,CAAC;AAEF,GAAG,CAAC,SAAS,CAAC,CAAC,kBAAkB,EAAE,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAc,EAAE,EAAE;IAClF,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE5B,GAAG,CAAC,GAAG,CAAC,0BAA0B,OAAO,MAAM,CAAC,CAAC;IACjD,EAAE,CAAC,IAAI,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;IACjC,EAAE,CAAC,IAAI,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;IAE/C,GAAG,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACnD,EAAE,CAAC,IAAI,CAAC,aAAa,QAAQ,wBAAwB,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC"}

package/dist/lib/tools/test-matrix-local.js

@@ -0,0 +1,212 @@
+/**!
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
+   *
+   * Copyright (c) 2025 Václav Oborník
+   * Released under the MIT license
+   */
+  "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = require("fs");
+const path = require("path");
+const child_process = require("child_process");
+const util = require("util");
+// --- Configuration ---
+const CONFIG_FILE = path.resolve(__dirname, '../test-matrix.json');
+const NETWORK_NAME = 'mongodash-local-matrix-net';
+const MONGO_CONTAINER_NAME = 'mongodash-local-mongo';
+const NODE_CONTAINER_NAME = 'mongodash-local-node';
+// --- Helpers ---
+const exec = util.promisify(child_process.exec);
+const spawn = (cmd, args, opts) => {
+    return new Promise((resolve, reject) => {
+        const proc = child_process.spawn(cmd, args, Object.assign({ stdio: 'inherit' }, opts));
+        proc.on('close', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`Command ${cmd} ${args.join(' ')} failed with code ${code}`));
+        });
+        proc.on('error', reject);
+    });
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+// --- Main Logic ---
+async function loadMatrix() {
+    const content = await fs.promises.readFile(CONFIG_FILE, 'utf-8');
+    return JSON.parse(content);
+}
+function parseArgs(matrix) {
+    const args = process.argv.slice(2);
+    const options = {
+        nodeVersion: matrix['node-version'][0], // Default to first (usually latest)
+        mongoVersion: matrix['mongodb-version'][0], // Default to first
+        driverVersion: matrix['mongodb-driver-version'][0], // Default to first
+        all: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        switch (args[i]) {
+            case '--node':
+                options.nodeVersion = args[++i];
+                break;
+            case '--mongo':
+                options.mongoVersion = args[++i];
+                break;
+            case '--driver':
+                options.driverVersion = args[++i];
+                break;
+            case '--all':
+                options.all = true;
+                break;
+            case '--help':
+                console.log('Usage: ts-node tools/test-matrix-local.ts [options]');
+                console.log('Options:');
+                console.log(`  --node <ver>    Node.js version (choices: ${matrix['node-version'].join(', ')}) [default: ${options.nodeVersion}]`);
+                console.log(`  --mongo <ver>   MongoDB version (choices: ${matrix['mongodb-version'].join(', ')}) [default: ${options.mongoVersion}]`);
+                console.log(`  --driver <ver>  Driver version  (choices: ${matrix['mongodb-driver-version'].join(', ')}) [default: ${options.driverVersion}]`);
+                console.log('  --all           Run all combinations locally (sanity check)');
+                process.exit(0);
+        }
+    }
+    return options;
+}
+async function cleanupContainers() {
+    try {
+        await exec(`docker rm -f ${MONGO_CONTAINER_NAME} ${NODE_CONTAINER_NAME}`);
+    }
+    catch (_a) {
+        // Ignore errors if they don't exist
+    }
+    try {
+        await exec(`docker network rm ${NETWORK_NAME}`);
+    }
+    catch (_b) {
+        // Ignore
+    }
+}
+async function runTest(options) {
+    console.log(`\n>>> Running test with: Node ${options.nodeVersion}, Mongo ${options.mongoVersion}, Driver ${options.driverVersion}`);
+    try {
+        await cleanupContainers();
+        // 1. Create Network
+        console.log('Creating Docker network...');
+        await exec(`docker network create ${NETWORK_NAME}`);
+        // 2. Start MongoDB
+        console.log(`Starting MongoDB ${options.mongoVersion}...`);
+        // Use mongo:version tag. For 4.x/5.x/6.x/7.x usually just number works or number.0
+        // Matrix has "7", "8".
+        const mongoImage = `mongo:${options.mongoVersion}`;
+        await exec(`docker run -d --name ${MONGO_CONTAINER_NAME} --network ${NETWORK_NAME} ${mongoImage} mongod --replSet rs0`);
+        // Wait for Mongo to be ready
+        console.log('Waiting for MongoDB to accept connections...');
+        let retries = 30;
+        let connected = false;
+        while (retries > 0) {
+            try {
+                // Try simple eval inside container
+                await exec(`docker exec ${MONGO_CONTAINER_NAME} mongosh --eval "db.adminCommand('ping')" --quiet`);
+                connected = true;
+                break;
+            }
+            catch (_a) {
+                // Try legacy mongo shell if mongosh missing (older versions)
+                try {
+                    await exec(`docker exec ${MONGO_CONTAINER_NAME} mongo --eval "db.adminCommand('ping')" --quiet`);
+                    connected = true;
+                    break;
+                }
+                catch (_b) {
+                    await sleep(1000);
+                    retries--;
+                }
+            }
+        }
+        if (!connected)
+            throw new Error('MongoDB failed to start or is unreachable');
+        // Initiate Replica Set
+        console.log('Initiating Replica Set...');
+        // Try mongosh first, then mongo
+        try {
+            await exec(`docker exec ${MONGO_CONTAINER_NAME} mongosh --eval "try { rs.initiate(); } catch(e) { if (e.codeName !== 'AlreadyInitialized') throw e; }" --quiet`);
+        }
+        catch (_c) {
+            await exec(`docker exec ${MONGO_CONTAINER_NAME} mongo --eval "try { rs.initiate(); } catch(e) { if (e.codeName !== 'AlreadyInitialized') throw e; }" --quiet`);
+        }
+        // Wait for Primary
+        console.log('Waiting for Primary...');
+        await sleep(2000); // Give it a moment to elect
+        // 3. Run Node Tests
+        console.log(`Starting Node.js ${options.nodeVersion} test runner...`);
+        const projectRoot = path.resolve(__dirname, '..');
+        // We mount the project root.
+        // WARNING: node_modules might be architecture dependent if using native addons (snappy, etc).
+        // While mongodash dependencies seem mostly pure JS, `mongodb` driver might have optional deps.
+        // Best practice is to install deps INSIDE container.
+        // We will mount to /app, but use a separate internal /app/node_modules if we assume host is mac (arm64) and container might be linux/amd64 or similar.
+        // However, standard node image is usually same arch as host.
+        // To be safe and clean, we should run `npm ci` inside.
+        // Command script
+        const testScript = [
+            'echo ">>> Inside Container Setup"',
+            'npm install -g npm@latest', // Ensure npm is decent
+            'npm ci',
+            `npm install mongodb@${options.driverVersion}`,
+            'npx tsc', // Ensure build is fresh or just rely on ts-node in tests?
+            // package.json test:simple runs jest directly (ts-jest)
+            'echo ">>> Running Tests"',
+            // We need to point to the mongo container.
+            // In CI we might use explicit hostname. in docker network it is the container name.
+            `export MONGODB_URI="mongodb://${MONGO_CONTAINER_NAME}:27017/mongodashTesting?replicaSet=rs0&directConnection=true"`,
+            'npm run test:simple',
+        ].join(' && ');
+        await spawn('docker', [
+            'run',
+            '--rm',
+            '--name',
+            NODE_CONTAINER_NAME,
+            '--network',
+            NETWORK_NAME,
+            '-v',
+            `${projectRoot}:/app`,
+            '-w',
+            '/app',
+            // '-e', 'CI=true', // Maybe?
+            `node:${options.nodeVersion}`,
+            '/bin/sh',
+            '-c',
+            testScript,
+        ]);
+        console.log('✅ Test run passed!');
+    }
+    catch (err) {
+        console.error('❌ Test run failed:', err);
+        throw err;
+    }
+    finally {
+        await cleanupContainers();
+    }
+}
+async function main() {
+    try {
+        const matrix = await loadMatrix();
+        const options = parseArgs(matrix);
+        if (options.all) {
+            console.log('Running ALL matrix combinations...');
+            for (const n of matrix['node-version']) {
+                for (const m of matrix['mongodb-version']) {
+                    for (const d of matrix['mongodb-driver-version']) {
+                        await runTest({ nodeVersion: n, mongoVersion: m, driverVersion: d, all: false });
+                    }
+                }
+            }
+        }
+        else {
+            await runTest(options);
+        }
+    }
+    catch (_a) {
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=test-matrix-local.js.map

package/dist/lib/tools/test-matrix-local.js.map

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

package/dist/lib/tools/testingDatabase.js

@@ -0,0 +1,55 @@
+/**!
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
+   *
+   * Copyright (c) 2025 Václav Oborník
+   * Released under the MIT license
+   */
+  "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConnectionString = getConnectionString;
+exports.cleanTestingDatabases = cleanTestingDatabases;
+const mongodb_1 = require("mongodb");
+const debug_1 = require("debug");
+const debug = (0, debug_1.default)('mongodash:testingDatabase');
+const baseDatabaseName = 'mongodashTesting';
+function getConnectionString() {
+    if (process.env.MONGODB_URI) {
+        return process.env.MONGODB_URI;
+    }
+    const withPostfix = !process.env.KEEP_SINGLE_DATABASE;
+    const postfix = `__${process.pid}`;
+    return `mongodb://127.0.0.1:27017/${baseDatabaseName}${withPostfix ? postfix : ''}`;
+}
+async function cleanTestingDatabases(all = false) {
+    let client;
+    try {
+        client = new mongodb_1.MongoClient(getConnectionString(), {
+            // @ts-expect-error useUnifiedTopology is legacy but might be needed for older drivers or specific testing setups
+            useUnifiedTopology: true,
+        });
+    }
+    catch (err) {
+        if (/MongoParseError: option useunifiedtopology is not supported/i.test(err.toString())) {
+            client = new mongodb_1.MongoClient(getConnectionString());
+        }
+        else {
+            throw err;
+        }
+    }
+    await client.connect();
+    const db = client.db();
+    const postfixMatcher = /__([0-9]+)/;
+    const matcher = new RegExp(`^${baseDatabaseName}(${postfixMatcher.source})?$`);
+    const adminDb = db.admin();
+    const { databases } = await adminDb.listDatabases({ nameOnly: true });
+    await Promise.all(databases.map(async ({ name }) => {
+        const shouldDelete = !all ? name === db.databaseName : name.match(matcher);
+        if (shouldDelete) {
+            debug(`DROPPING TESTING database ${name}`);
+            await client.db(name).dropDatabase();
+        }
+    }));
+    await client.close();
+}
+//# sourceMappingURL=testingDatabase.js.map

package/dist/lib/tools/testingDatabase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testingDatabase.js","sourceRoot":"","sources":["../../../tools/testingDatabase.ts"],"names":[],"mappings":";;AAOA,kDAOC;AAED,sDAmCC;AAnDD,qCAAsC;AACtC,iCAA2B;AAE3B,MAAM,KAAK,GAAG,IAAA,eAAM,EAAC,2BAA2B,CAAC,CAAC;AAElD,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAE5C,SAAgB,mBAAmB;IAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACnC,CAAC;IACD,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACtD,MAAM,OAAO,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;IACnC,OAAO,6BAA6B,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACxF,CAAC;AAEM,KAAK,UAAU,qBAAqB,CAAC,GAAG,GAAG,KAAK;IACnD,IAAI,MAAmB,CAAC;IACxB,IAAI,CAAC;QACD,MAAM,GAAG,IAAI,qBAAW,CAAC,mBAAmB,EAAE,EAAE;YAC5C,iHAAiH;YACjH,kBAAkB,EAAE,IAAI;SAC3B,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,8DAA8D,CAAC,IAAI,CAAE,GAAa,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;YACjG,MAAM,GAAG,IAAI,qBAAW,CAAC,mBAAmB,EAAE,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACJ,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;IAED,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACvB,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC;IAEvB,MAAM,cAAc,GAAG,YAAY,CAAC;IAEpC,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,gBAAgB,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;IAC3B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtE,MAAM,OAAO,CAAC,GAAG,CACb,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,EAAoB,EAAE,EAAE;QAC/C,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3E,IAAI,YAAY,EAAE,CAAC;YACf,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;YAC3C,MAAM,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;QACzC,CAAC;IACL,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/types/playground/server.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,30 @@
+import { OnError } from './OnError';
+export interface ConcurrentRunnerOptions {
+    concurrency: number;
+}
+export interface SourceOptions {
+    minPollMs: number;
+    maxPollMs: number;
+    jitterMs: number;
+}
+export type TryRunATaskCallback = (sourceName: string) => Promise<void>;
+export declare class ConcurrentRunner {
+    private onError;
+    private options;
+    private sources;
+    private isRunning;
+    private workers;
+    private wakeUpSignals;
+    private tryRunATask;
+    constructor(options: ConcurrentRunnerOptions, onError?: OnError);
+    registerSource(name: string, options: SourceOptions): void;
+    hasSource(name: string): boolean;
+    start(tryRunATask: TryRunATaskCallback): void;
+    stop(): Promise<void>;
+    speedUp(sourceName: string): void;
+    private runWorker;
+    private prolongNextRun;
+    private sleep;
+    private wakeUpOneWorker;
+    private wakeUpAllWorkers;
+}

package/dist/types/{OnInfo.d.ts → src/OnInfo.d.ts}

@@ -1,6 +1,6 @@
 export type OnInfo = (info: {
     message: string;
     code: string;
-} & Record<string, string | number | Date>) => void;
+} & Record<string, unknown>) => void;
 export declare const defaultOnInfo: OnInfo;
 export declare function secureOnInfo(onInfo: OnInfo): OnInfo;

package/dist/types/{cronTasks.d.ts → src/cronTasks.d.ts}

@@ -11,6 +11,36 @@ export type StaticInterval = ScalarInterval | Date;
 export type IntervalFunction = () => StaticInterval | Promise<StaticInterval>;
 export type Interval = ScalarInterval | IntervalFunction;
 export type TaskId = string;
+export type CronTaskStatus = 'locked' | 'running' | 'idle' | 'failed' | 'scheduled';
+export interface CronTaskRecord {
+    _id: TaskId;
+    status: CronTaskStatus;
+    nextRunAt: Date;
+    runImmediately: boolean;
+    lockedTill: Date | null;
+    lastRun: {
+        startedAt: Date;
+        finishedAt: Date | null;
+        error: string | null;
+        durationMs?: number;
+    } | null;
+    isRegistered: boolean;
+}
+export interface CronTaskQuery {
+    filter?: string;
+    limit?: number;
+    skip?: number;
+    sort?: {
+        field: keyof CronTaskRecord;
+        direction: 1 | -1;
+    };
+}
+export interface CronPagedResult<T> {
+    items: T[];
+    total: number;
+    limit: number;
+    offset: number;
+}
 export interface CronTaskCaller {
     <T>(task: () => Promise<T>): Promise<T> | T;
 }
@@ -28,8 +58,21 @@ export type InitOptions = {
     cronTaskCaller: CronTaskCaller;
     cronTaskFilter: CronTaskFilter;
 };
-export declare function init({ runCronTasks, cronTaskFilter, cronExpressionParserOptions, onError, onInfo, cronTaskCaller }: InitOptions): void;
+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>;
 export declare function cronTask(taskId: TaskId, interval: Interval, task: TaskFunction): Promise<void>;
+/**
+ * Lists cron tasks with pagination and sorting.
+ */
+export declare function getCronTasksList(query?: CronTaskQuery): Promise<CronPagedResult<CronTaskRecord>>;
+/**
+ * Triggers a cron task immediately.
+ * Alias for scheduleCronTaskImmediately but returns the new state or confirmation.
+ */
+export declare function triggerCronTask(taskId: TaskId): Promise<void>;
+/**
+ * Returns IDs of all registered cron tasks in this instance.
+ */
+export declare function getRegisteredCronTaskIds(): string[];

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

@@ -0,0 +1,4 @@
+import { Collection, Document, ObjectId } from 'mongodb';
+export type GlobalsCollection = Collection<Document & {
+    _id: ObjectId | string;
+}>;

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

@@ -0,0 +1,28 @@
+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';
+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';
+type PackageOptions = {
+    onError?: OnError;
+    onInfo?: OnInfo;
+    taskCaller?: TaskCaller;
+};
+export interface TaskCaller {
+    <T>(task: () => Promise<T>): Promise<T> | T;
+}
+export type InitOptions = PackageOptions & GetMongoClientInitOptions & Partial<CronTasksInitOptions> & Partial<GetCollectionInitOptions> & Partial<Omit<ReactiveTasksInitOptions, 'globalsCollection'>> & {
+    globalsCollection?: string | Collection;
+};
+export declare function init(options: InitOptions): Promise<void>;

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

@@ -0,0 +1,29 @@
+import { Document, FindOneAndUpdateOptions, BulkWriteOptions } from 'mongodb';
+/**
+ * Compatible options for findOneAndUpdate across MongoDB drivers v4, v5, v6, v7.
+ * v5+ requires 'includeResultMetadata' to return the full result object.
+ * v4 ignores this property.
+ * Using Omit ensures we don't conflict with existing definition if it exists,
+ * and explicitly adding it ensures it's allowed even if the base type lacks it.
+ */
+export interface CompatibleFindOneAndUpdateOptions extends Omit<FindOneAndUpdateOptions, 'includeResultMetadata'> {
+    includeResultMetadata?: boolean;
+}
+/**
+ * Compatible result for findOneAndUpdate.
+ * Wraps the potential return shapes.
+ * v4: { value: T, ok: 1, ... }
+ * v7 (with includeResultMetadata): { value: T, ok: 1, ... }
+ *
+ * Accessing .value on this interface is safe.
+ */
+export interface CompatibleModifyResult<T extends Document = Document> {
+    value?: T | null;
+    ok?: number;
+    lastErrorObject?: Document;
+}
+/**
+ * Compatible options for bulkWrite.
+ * Ensures strict typing.
+ */
+export type CompatibleBulkWriteOptions = BulkWriteOptions;

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

@@ -0,0 +1,12 @@
+import { CronExpressionOptions } from 'cron-parser';
+/**
+ * Create a function that returns the next run Date based on an interval specification.
+ *
+ * Supports:
+ * - Number: returns Date that is `interval` milliseconds from now
+ * - Duration string: '1h', '24h', '7d' - returns Date that is duration from now
+ * - Cron expression: 'CRON 0 3 * * *' (must start with CRON) - returns next cron occurrence
+ */
+export declare function createIntervalFunction(interval: number | string | ((date?: Date) => Date | number), options?: {
+    cronOptions?: CronExpressionOptions;
+}): (referenceDate?: Date) => Date;

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

@@ -0,0 +1,11 @@
+import { Document, Filter } from 'mongodb';
+/**
+ * Recursively prefixes all keys in a MongoDB filter object.
+ * This is used to apply a filter meant for a document to a field
+ * within a larger document, such as 'fullDocument' in a change stream event.
+ *
+ * @param filter The filter object to process.
+ * @param prefix The prefix to add to each key (e.g., 'fullDocument').
+ * @returns A new filter object with all keys prefixed.
+ */
+export declare function prefixFilterKeys<T extends Document>(filter: Filter<T>, prefix: string): Filter<T>;

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

@@ -0,0 +1,10 @@
+import { Collection, Document, Filter } from 'mongodb';
+export interface ProcessInBatchesOptions {
+    batchSize?: number;
+    shouldStop?: () => boolean;
+}
+export interface ProcessInBatchesResult {
+    processedDocuments: number;
+    operationsPerformed: number;
+}
+export declare function processInBatches<TDoc extends Document, TOp>(collection: Collection<TDoc>, queryOrPipeline: Filter<TDoc> | Document[], transform: (doc: TDoc) => TOp | TOp[] | null | undefined | Promise<TOp | TOp[] | null | undefined>, executeBatch: (ops: TOp[]) => Promise<void>, options?: ProcessInBatchesOptions): Promise<ProcessInBatchesResult>;