@tc-libs/retry-policy 2.0.1

package/README.md

@@ -0,0 +1,11 @@
+# retry-policy
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build retry-policy` to build the library.
+
+## Running unit tests
+
+Run `nx test retry-policy` to execute the unit tests via [Jest](https://jestjs.io).

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@tc-libs/retry-policy",
+  "version": "2.0.1",
+  "dependencies": {
+    "@nestjs/common": "^11.0.12",
+    "mongodb": "6.15.0",
+    "tslib": "^2.8.1"
+  },
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts",
+  "types": "./src/index.d.ts"
+}

package/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from './retry-policy.module';
+export * from './retry-policy.mongo.service';

package/src/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./retry-policy.module"), exports);
+tslib_1.__exportStar(require("./retry-policy.mongo.service"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/retry-policy/src/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,uEAA6C"}

package/src/retry-policy.module.d.ts

@@ -0,0 +1,2 @@
+export declare class RetryPolicyModule {
+}

package/src/retry-policy.module.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryPolicyModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const retry_policy_mongo_service_1 = require("./retry-policy.mongo.service");
+let RetryPolicyModule = class RetryPolicyModule {
+};
+exports.RetryPolicyModule = RetryPolicyModule;
+exports.RetryPolicyModule = RetryPolicyModule = tslib_1.__decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [retry_policy_mongo_service_1.RetryPolicyMongoService],
+        exports: [retry_policy_mongo_service_1.RetryPolicyMongoService],
+    })
+], RetryPolicyModule);
+//# sourceMappingURL=retry-policy.module.js.map

package/src/retry-policy.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy.module.js","sourceRoot":"","sources":["../../../../packages/retry-policy/src/retry-policy.module.ts"],"names":[],"mappings":";;;;AAAA,2CAAgD;AAChD,6EAAuE;AAOhE,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;CAAG,CAAA;AAApB,8CAAiB;4BAAjB,iBAAiB;IAL7B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,oDAAuB,CAAC;QACpC,OAAO,EAAE,CAAC,oDAAuB,CAAC;KACnC,CAAC;GACW,iBAAiB,CAAG"}

package/src/retry-policy.mongo.service.d.ts

@@ -0,0 +1,13 @@
+import type { ClientSession } from 'mongodb';
+export type TxRetryOptions = {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    jitter?: boolean;
+};
+export declare class RetryPolicyMongoService {
+    runInTransactionWithRetry<T>(session: ClientSession, work: (session: ClientSession) => Promise<T>, opts?: TxRetryOptions): Promise<T>;
+    private _isRetryableMongoError;
+    private computeDelay;
+    private sleep;
+}

package/src/retry-policy.mongo.service.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryPolicyMongoService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const mongodb_1 = require("mongodb");
+let RetryPolicyMongoService = class RetryPolicyMongoService {
+    async runInTransactionWithRetry(session, work, opts = {}) {
+        /**
+         * Destructures retry configuration from `opts`, applying sensible defaults.
+         *
+         * @param opts - Optional configuration object for retry behavior.
+         * @param opts.maxRetries - Maximum number of retry attempts (default: 5).
+         * @param opts.baseDelayMs - Initial delay between retries in milliseconds (default: 50).
+         * @param opts.maxDelayMs - Maximum delay cap in milliseconds to prevent excessive waits (default: 2000).
+         * @param opts.jitter - Whether to apply randomized jitter to delays to avoid request bursts (default: true).
+         */
+        const { maxRetries = 5, baseDelayMs = 50, maxDelayMs = 2000, jitter = true, } = opts;
+        let attempt = 0;
+        while (true) {
+            try {
+                // Se qualcuno non l’ha già fatto (guard), la avviamo noi
+                if (!session.inTransaction()) {
+                    await session.startTransaction();
+                }
+                const result = await work(session);
+                // Commit: può fallire con UnknownTransactionCommitResult → retry
+                await session.commitTransaction();
+                return result;
+            }
+            catch (err) {
+                attempt++;
+                // Se siamo in transazione, abort (ignore errori abort)
+                if (session.inTransaction()) {
+                    try {
+                        await session.abortTransaction();
+                    }
+                    catch {
+                        /* noop */
+                    }
+                }
+                if (!this._isRetryableMongoError(err) || attempt > maxRetries) {
+                    throw err;
+                }
+                const delay = this.computeDelay(attempt, baseDelayMs, maxDelayMs, jitter);
+                await this.sleep(delay);
+                // Riparti con una nuova transaction sullo stesso session
+                // (startTransaction verrà richiamata all’inizio del loop)
+            }
+        }
+    }
+    _isRetryableMongoError(err) {
+        const e = err;
+        // Driver/Session labels
+        const labels = Array.isArray(e?.errorLabels) ? e.errorLabels : [];
+        const isWriteConflict = e instanceof mongodb_1.MongoServerError && e.code === 112; // WriteConflict
+        const msg = String(e?.message ?? '');
+        const looksLikeWriteConflict = msg.includes('Write conflict') || msg.includes('WriteConflict');
+        const transientTxn = labels.includes('TransientTransactionError');
+        const unknownCommit = labels.includes('UnknownTransactionCommitResult');
+        return (isWriteConflict || looksLikeWriteConflict || transientTxn || unknownCommit);
+    }
+    computeDelay(attempt, base, max, jitter) {
+        const raw = Math.min(max, base * Math.pow(2, attempt - 1));
+        if (!jitter)
+            return raw;
+        return Math.floor(Math.random() * raw);
+    }
+    sleep(ms) {
+        return new Promise((res) => setTimeout(res, ms));
+    }
+};
+exports.RetryPolicyMongoService = RetryPolicyMongoService;
+exports.RetryPolicyMongoService = RetryPolicyMongoService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], RetryPolicyMongoService);
+//# sourceMappingURL=retry-policy.mongo.service.js.map

package/src/retry-policy.mongo.service.js.map

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