typescript-retry-decorator 2.4.0 → 2.5.1

package/.eslintrc.js

@@ -1,18 +1,42 @@
 module.exports = {
   root: true,
-  parser: '@typescript-eslint/parser',  // Specifies the ESLint parser
-  plugins: ["@typescript-eslint"],
+  env: {
+    jest: true,
+    node: true,
+  },
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint'],
   extends: [
-    // https://github.com/typescript-eslint/typescript-eslint/blob/master/packages/eslint-plugin/src/configs/recommended.json
-    'plugin:@typescript-eslint/recommended',  // Uses the recommended rules from the @typescript-eslint/eslint-plugin
-    'eslint-config-ts-vcfvct',
+    'plugin:@typescript-eslint/recommended',
   ],
   parserOptions: {
-    ecmaVersion: 2018,  // Allows for the parsing of modern ECMAScript features
-    sourceType: 'module',  // Allows for the use of imports
+    ecmaVersion: 2020,
+    sourceType: 'module',
   },
   rules: {
-    // Place to specify ESLint rules. Can be used to overwrite rules specified from the extended configs
+    '@typescript-eslint/no-var-requires': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/no-non-null-assertion': 'off',
+    '@typescript-eslint/no-use-before-define': 'off',
+    '@typescript-eslint/no-empty-interface': 'off',
+    '@typescript-eslint/explicit-function-return-type': ['warn', { allowExpressions: true }],
+
+    indent: ['error', 2],
+    'no-trailing-spaces': 'error',
+    quotes: ['error', 'single', { allowTemplateLiterals: true }],
+    semi: ['error', 'always'],
+    'spaced-comment': ['error', 'always'],
+    'no-irregular-whitespace': ['error', { skipComments: true }],
+    'space-infix-ops': 'error',
+    'array-bracket-spacing': 'error',
+    'object-curly-spacing': ['error', 'always'],
+    'space-before-function-paren': ['error', {
+      named: 'never',
+      anonymous: 'never',
+      asyncArrow: 'always',
+    }],
+    'comma-dangle': ['warn', 'always-multiline'],
+    'no-multiple-empty-lines': 'error',
   },
 };
 

package/.github/workflows/ci.yml

@@ -23,7 +23,7 @@ jobs:
       name: Install pnpm
       id: pnpm-install
       with:
-          version: 7
+          version: 10
           run_install: false
 
     - name: Get pnpm store directory

package/.github/workflows/npm-publish.yml

@@ -7,22 +7,26 @@ on:
   release:
     types: [created]
 
+permissions:
+  id-token: write # Required for OIDC / Trusted Publisher
+  contents: read
+
 jobs:
   publish-npm:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - name: Install Node.js 
-        uses: actions/setup-node@v3
+      - uses: actions/checkout@v4
+      - name: Install Node.js
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 24
           registry-url: https://registry.npmjs.org/
 
       - uses: pnpm/action-setup@v2
         name: Install pnpm
         id: pnpm-install
         with:
-            version: 7
+            version: 10
             run_install: false
 
       - name: Get pnpm store directory
@@ -42,6 +46,4 @@ jobs:
       - run: pnpm install
       - run: npm run build
       - run: npm test
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
+      - run: npm publish --provenance

package/README.md

@@ -7,6 +7,13 @@ Import and use it. Retry for `Promise` is supported as long as the `runtime` has
 ### Install
 > npm install typescript-retry-decorator
 
+This library supports both TypeScript's legacy ("experimental") decorators and TypeScript 5+ standard decorators.
+
+- If your project uses legacy decorators, enable [`experimentalDecorators`](https://www.typescriptlang.org/tsconfig#experimentalDecorators) in `tsconfig.json`.
+- If your project uses TypeScript 5+ standard decorators (no `experimentalDecorators`), it should work without extra config.
+
+> TypeScript 5 note: this library also supports the new "standard decorators" call signature (`(value, context)`) at runtime. If you're using TS5+ standard decorators (without `experimentalDecorators`), it should work without extra config — see `ts5-decorator.md` for background.
+
 ### Options
 | Option Name       |           Type           | Required? |                 Default                 |                                                    Description                                                    |
 |:-----------------:|:------------------------:|:---------:|:---------------------------------------:|:-----------------------------------------------------------------------------------------------------------------:|

package/dist/example.js

@@ -1,12 +1,37 @@
 "use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
 };
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
 };
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -20,101 +45,93 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 const retry_decorator_1 = require("./retry.decorator");
 let count = 1;
-class RetryExample {
-    static noDelayRetry() {
-        return __awaiter(this, void 0, void 0, function* () {
-            console.info(`Calling noDelayRetry for the ${count++} time at ${new Date().toLocaleTimeString()}`);
-            throw new Error('I failed!');
-        });
-    }
-    static noDelaySpecificRetry() {
-        return __awaiter(this, void 0, void 0, function* () {
-            console.info(`Calling noDelayRetry for the ${count++} time at ${new Date().toLocaleTimeString()}`);
-            throw new SyntaxError('I failed with SyntaxError!');
-        });
-    }
-    static doRetry() {
-        return __awaiter(this, void 0, void 0, function* () {
-            console.info(`Calling doRetry for the ${count++} time at ${new Date().toLocaleTimeString()}`);
-            throw new Error('Error: 429');
-        });
-    }
-    static doNotRetry() {
-        return __awaiter(this, void 0, void 0, function* () {
-            console.info(`Calling doNotRetry for the ${count++} time at ${new Date().toLocaleTimeString()}`);
-            throw new Error('Error: 404');
-        });
-    }
-    static fixedBackOffRetry() {
-        return __awaiter(this, void 0, void 0, function* () {
-            console.info(`Calling fixedBackOffRetry 1s for the ${count++} time at ${new Date().toLocaleTimeString()}`);
-            throw new Error('I failed!');
-        });
-    }
-    static ExponentialBackOffRetry() {
-        return __awaiter(this, void 0, void 0, function* () {
-            console.info(`Calling ExponentialBackOffRetry backOff 1s, multiplier=3 for the ${count++} time at ${new Date().toLocaleTimeString()}`);
-            throw new Error('I failed!');
-        });
-    }
-}
-__decorate([
-    (0, retry_decorator_1.Retryable)({ maxAttempts: 3 }),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", Promise)
-], RetryExample, "noDelayRetry", null);
-__decorate([
-    (0, retry_decorator_1.Retryable)({ maxAttempts: 3, value: [SyntaxError, ReferenceError] }),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", Promise)
-], RetryExample, "noDelaySpecificRetry", null);
-__decorate([
-    (0, retry_decorator_1.Retryable)({
-        maxAttempts: 3,
-        backOff: 1000,
-        doRetry: (e) => {
-            return e.message === 'Error: 429';
-        },
-    }),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", Promise)
-], RetryExample, "doRetry", null);
-__decorate([
-    (0, retry_decorator_1.Retryable)({
-        maxAttempts: 3,
-        backOff: 1000,
-        doRetry: (e) => {
-            return e.message === 'Error: 429';
+let RetryExample = (() => {
+    var _a;
+    let _staticExtraInitializers = [];
+    let _static_noDelayRetry_decorators;
+    let _static_noDelaySpecificRetry_decorators;
+    let _static_doRetry_decorators;
+    let _static_doNotRetry_decorators;
+    let _static_fixedBackOffRetry_decorators;
+    let _static_ExponentialBackOffRetry_decorators;
+    return _a = class RetryExample {
+            static noDelayRetry() {
+                return __awaiter(this, void 0, void 0, function* () {
+                    console.info(`Calling noDelayRetry for the ${count++} time at ${new Date().toLocaleTimeString()}`);
+                    throw new Error('I failed!');
+                });
+            }
+            static noDelaySpecificRetry() {
+                return __awaiter(this, void 0, void 0, function* () {
+                    console.info(`Calling noDelayRetry for the ${count++} time at ${new Date().toLocaleTimeString()}`);
+                    throw new SyntaxError('I failed with SyntaxError!');
+                });
+            }
+            static doRetry() {
+                return __awaiter(this, void 0, void 0, function* () {
+                    console.info(`Calling doRetry for the ${count++} time at ${new Date().toLocaleTimeString()}`);
+                    throw new Error('Error: 429');
+                });
+            }
+            static doNotRetry() {
+                return __awaiter(this, void 0, void 0, function* () {
+                    console.info(`Calling doNotRetry for the ${count++} time at ${new Date().toLocaleTimeString()}`);
+                    throw new Error('Error: 404');
+                });
+            }
+            static fixedBackOffRetry() {
+                return __awaiter(this, void 0, void 0, function* () {
+                    console.info(`Calling fixedBackOffRetry 1s for the ${count++} time at ${new Date().toLocaleTimeString()}`);
+                    throw new Error('I failed!');
+                });
+            }
+            static ExponentialBackOffRetry() {
+                return __awaiter(this, void 0, void 0, function* () {
+                    console.info(`Calling ExponentialBackOffRetry backOff 1s, multiplier=3 for the ${count++} time at ${new Date().toLocaleTimeString()}`);
+                    throw new Error('I failed!');
+                });
+            }
         },
-    }),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", Promise)
-], RetryExample, "doNotRetry", null);
-__decorate([
-    (0, retry_decorator_1.Retryable)({
-        maxAttempts: 3,
-        backOffPolicy: retry_decorator_1.BackOffPolicy.FixedBackOffPolicy,
-        backOff: 1000,
-    }),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", Promise)
-], RetryExample, "fixedBackOffRetry", null);
-__decorate([
-    (0, retry_decorator_1.Retryable)({
-        maxAttempts: 3,
-        backOffPolicy: retry_decorator_1.BackOffPolicy.ExponentialBackOffPolicy,
-        backOff: 1000,
-        exponentialOption: { maxInterval: 4000, multiplier: 3 },
-    }),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", Promise)
-], RetryExample, "ExponentialBackOffRetry", null);
+        (() => {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _static_noDelayRetry_decorators = [(0, retry_decorator_1.Retryable)({ maxAttempts: 3 })];
+            _static_noDelaySpecificRetry_decorators = [(0, retry_decorator_1.Retryable)({ maxAttempts: 3, value: [SyntaxError, ReferenceError] })];
+            _static_doRetry_decorators = [(0, retry_decorator_1.Retryable)({
+                    maxAttempts: 3,
+                    backOff: 1000,
+                    doRetry: (e) => {
+                        return e.message === 'Error: 429';
+                    },
+                })];
+            _static_doNotRetry_decorators = [(0, retry_decorator_1.Retryable)({
+                    maxAttempts: 3,
+                    backOff: 1000,
+                    doRetry: (e) => {
+                        return e.message === 'Error: 429';
+                    },
+                })];
+            _static_fixedBackOffRetry_decorators = [(0, retry_decorator_1.Retryable)({
+                    maxAttempts: 3,
+                    backOffPolicy: retry_decorator_1.BackOffPolicy.FixedBackOffPolicy,
+                    backOff: 1000,
+                })];
+            _static_ExponentialBackOffRetry_decorators = [(0, retry_decorator_1.Retryable)({
+                    maxAttempts: 3,
+                    backOffPolicy: retry_decorator_1.BackOffPolicy.ExponentialBackOffPolicy,
+                    backOff: 1000,
+                    exponentialOption: { maxInterval: 4000, multiplier: 3 },
+                })];
+            __esDecorate(_a, null, _static_noDelayRetry_decorators, { kind: "method", name: "noDelayRetry", static: true, private: false, access: { has: obj => "noDelayRetry" in obj, get: obj => obj.noDelayRetry }, metadata: _metadata }, null, _staticExtraInitializers);
+            __esDecorate(_a, null, _static_noDelaySpecificRetry_decorators, { kind: "method", name: "noDelaySpecificRetry", static: true, private: false, access: { has: obj => "noDelaySpecificRetry" in obj, get: obj => obj.noDelaySpecificRetry }, metadata: _metadata }, null, _staticExtraInitializers);
+            __esDecorate(_a, null, _static_doRetry_decorators, { kind: "method", name: "doRetry", static: true, private: false, access: { has: obj => "doRetry" in obj, get: obj => obj.doRetry }, metadata: _metadata }, null, _staticExtraInitializers);
+            __esDecorate(_a, null, _static_doNotRetry_decorators, { kind: "method", name: "doNotRetry", static: true, private: false, access: { has: obj => "doNotRetry" in obj, get: obj => obj.doNotRetry }, metadata: _metadata }, null, _staticExtraInitializers);
+            __esDecorate(_a, null, _static_fixedBackOffRetry_decorators, { kind: "method", name: "fixedBackOffRetry", static: true, private: false, access: { has: obj => "fixedBackOffRetry" in obj, get: obj => obj.fixedBackOffRetry }, metadata: _metadata }, null, _staticExtraInitializers);
+            __esDecorate(_a, null, _static_ExponentialBackOffRetry_decorators, { kind: "method", name: "ExponentialBackOffRetry", static: true, private: false, access: { has: obj => "ExponentialBackOffRetry" in obj, get: obj => obj.ExponentialBackOffRetry }, metadata: _metadata }, null, _staticExtraInitializers);
+            if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_a, _staticExtraInitializers);
+        })(),
+        _a;
+})();
 (() => __awaiter(void 0, void 0, void 0, function* () {
     try {
         resetCount();

package/dist/example.js.map

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

package/dist/retry.decorator.d.ts

@@ -1,9 +1,21 @@
+export interface StandardDecoratorContext {
+    kind?: string;
+    name?: string | symbol;
+}
+export type LegacyDecoratorFunction = (target: Record<string, any>, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<any>) => TypedPropertyDescriptor<any> | void;
+export type StandardMethodDecorator = (value: (...args: any[]) => any, context: StandardDecoratorContext) => ((...args: any[]) => any) | void;
+export type RetryableDecorator = LegacyDecoratorFunction & StandardMethodDecorator;
+export type DecoratorFunction = LegacyDecoratorFunction;
 /**
- * retry decorator which is nothing but a high order function wrapper
+ * Retry decorator (legacy + TypeScript 5 standard decorators).
+ *
+ * In legacy/"experimentalDecorators" mode, it's applied as
+ *   (target, propertyKey, descriptor)
  *
- * @param options the 'RetryOptions'
+ * In TS5+ standard decorators mode, it's applied as
+ *   (value, context)
  */
-export declare function Retryable(options: RetryOptions): DecoratorFunction;
+export declare function Retryable(options: RetryOptions): RetryableDecorator;
 export declare class MaxAttemptsError extends Error {
     code: string;
 }
@@ -46,6 +58,5 @@ export declare enum ExponentialBackoffStrategy {
      */
     EqualJitter = "EqualJitter"
 }
-export declare type DecoratorFunction = (target: Record<string, any>, propertyKey: string, descriptor: TypedPropertyDescriptor<any>) => TypedPropertyDescriptor<any>;
 export {};
 //# sourceMappingURL=retry.decorator.d.ts.map

package/dist/retry.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry.decorator.d.ts","sourceRoot":"","sources":["../src/retry.decorator.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,iBAAiB,CAyFlE;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,IAAI,SAAS;CAMd;AAED,UAAU,kBAAkB;IAC1B,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB;;;WAGG;QACH,eAAe,CAAC,EAAE,0BAA0B,CAAC;KAC9C,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,oBAAY,aAAa;IACvB,kBAAkB,uBAAuB;IACzC,wBAAwB,6BAA6B;CACtD;AAED;;;GAGG;AACH,oBAAY,0BAA0B;IACpC;;OAEG;IACH,UAAU,eAAe;IACzB;;OAEG;IACH,WAAW,gBAAgB;CAC5B;AAED,oBAAY,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,uBAAuB,CAAC,GAAG,CAAC,KAAK,uBAAuB,CAAC,GAAG,CAAC,CAAC"}
+{"version":3,"file":"retry.decorator.d.ts","sourceRoot":"","sources":["../src/retry.decorator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,UAAU,EAAE,uBAAuB,CAAC,GAAG,CAAC,KACrC,uBAAuB,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AAEzC,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC9B,OAAO,EAAE,wBAAwB,KAC9B,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC;AAEtC,MAAM,MAAM,kBAAkB,GAAG,uBAAuB,GAAG,uBAAuB,CAAC;AAGnF,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAExD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,kBAAkB,CAuGnE;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,IAAI,SAAS;CAMd;AAED,UAAU,kBAAkB;IAC1B,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB;;;WAGG;QACH,eAAe,CAAC,EAAE,0BAA0B,CAAC;KAC9C,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,oBAAY,aAAa;IACvB,kBAAkB,uBAAuB;IACzC,wBAAwB,6BAA6B;CACtD;AAED;;;GAGG;AACH,oBAAY,0BAA0B;IACpC;;OAEG;IACH,UAAU,eAAe;IACzB;;OAEG;IACH,WAAW,gBAAgB;CAC5B"}

package/dist/retry.decorator.js

@@ -12,42 +12,42 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExponentialBackoffStrategy = exports.BackOffPolicy = exports.MaxAttemptsError = exports.Retryable = void 0;
 const utils_1 = require("./utils");
 /**
- * retry decorator which is nothing but a high order function wrapper
+ * Retry decorator (legacy + TypeScript 5 standard decorators).
  *
- * @param options the 'RetryOptions'
+ * In legacy/"experimentalDecorators" mode, it's applied as
+ *   (target, propertyKey, descriptor)
+ *
+ * In TS5+ standard decorators mode, it's applied as
+ *   (value, context)
  */
 function Retryable(options) {
-    /**
-     * target: The prototype of the class (Object)
-     * propertyKey: The name of the method (string | symbol).
-     * descriptor: A TypedPropertyDescriptor — see the type, leveraging the Object.defineProperty under the hood.
-     *
-     * NOTE: It's very important here we do not use arrow function otherwise 'this' will be messed up due
-     * to the nature how arrow function defines this inside.
-     *
-     */
-    return function (target, propertyKey, descriptor) {
-        const originalFn = descriptor.value;
-        // set default value for ExponentialBackOffPolicy
-        if (options.backOffPolicy === BackOffPolicy.ExponentialBackOffPolicy) {
-            setExponentialBackOffPolicyDefault();
+    function setExponentialBackOffPolicyDefault() {
+        if (!options.backOff) {
+            options.backOff = 1000;
         }
-        descriptor.value = function (...args) {
-            return __awaiter(this, void 0, void 0, function* () {
-                try {
-                    return yield retryAsync.apply(this, [originalFn, args, options.maxAttempts, options.backOff]);
-                }
-                catch (e) {
-                    if (e instanceof MaxAttemptsError) {
-                        const msgPrefix = `Failed for '${propertyKey}' for ${options.maxAttempts} times.`;
-                        e.message = e.message ? `${msgPrefix} Original Error: ${e.message}` : msgPrefix;
-                    }
-                    throw e;
-                }
-            });
-        };
-        return descriptor;
-    };
+        options.exponentialOption = Object.assign({ maxInterval: 2000, multiplier: 2 }, options.exponentialOption);
+    }
+    function applyBackoffStrategy(baseBackoff) {
+        var _a;
+        const { backoffStrategy } = (_a = options.exponentialOption) !== null && _a !== void 0 ? _a : {};
+        if (backoffStrategy === ExponentialBackoffStrategy.EqualJitter) {
+            return baseBackoff / 2 + (Math.random() * baseBackoff / 2);
+        }
+        if (backoffStrategy === ExponentialBackoffStrategy.FullJitter) {
+            return Math.random() * baseBackoff;
+        }
+        return baseBackoff;
+    }
+    function canRetry(e) {
+        var _a;
+        if (options.doRetry && !options.doRetry(e)) {
+            return false;
+        }
+        if (((_a = options.value) === null || _a === void 0 ? void 0 : _a.length) && !options.value.some(errorType => e instanceof errorType)) {
+            return false;
+        }
+        return true;
+    }
     function retryAsync(fn, args, maxAttempts, backOff) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
@@ -55,11 +55,13 @@ function Retryable(options) {
             }
             catch (e) {
                 if (--maxAttempts < 0) {
-                    (typeof options.useConsoleLogger !== 'boolean' || options.useConsoleLogger) && (e === null || e === void 0 ? void 0 : e.message) && console.error(e.message);
-                    if (options.useOriginalError)
+                    if ((typeof options.useConsoleLogger !== 'boolean' || options.useConsoleLogger) && (e === null || e === void 0 ? void 0 : e.message)) {
+                        console.error(e.message);
+                    }
+                    if (options.useOriginalError) {
                         throw e;
+                    }
                     const maxAttemptsErrorInstance = new MaxAttemptsError(e === null || e === void 0 ? void 0 : e.message);
-                    // Add the existing error stack if present
                     if (e === null || e === void 0 ? void 0 : e.stack) {
                         maxAttemptsErrorInstance.stack = e.stack;
                     }
@@ -68,44 +70,49 @@ function Retryable(options) {
                 if (!canRetry(e)) {
                     throw e;
                 }
-                backOff && (yield (0, utils_1.sleep)(applyBackoffStrategy(backOff)));
-                if (options.backOffPolicy === BackOffPolicy.ExponentialBackOffPolicy) {
-                    backOff = Math.min(backOff * options.exponentialOption.multiplier, options.exponentialOption.maxInterval);
+                if (backOff) {
+                    yield (0, utils_1.sleep)(applyBackoffStrategy(backOff));
+                    if (options.exponentialOption && options.backOffPolicy === BackOffPolicy.ExponentialBackOffPolicy) {
+                        backOff = Math.min(backOff * options.exponentialOption.multiplier, options.exponentialOption.maxInterval);
+                    }
                 }
                 return retryAsync.apply(this, [fn, args, maxAttempts, backOff]);
             }
         });
     }
-    function canRetry(e) {
-        var _a;
-        if (options.doRetry && !options.doRetry(e)) {
-            return false;
-        }
-        if (((_a = options.value) === null || _a === void 0 ? void 0 : _a.length) && !options.value.some(errorType => e instanceof errorType)) {
-            return false;
+    function wrapWithRetry(originalFn, name) {
+        if (options.backOffPolicy === BackOffPolicy.ExponentialBackOffPolicy) {
+            setExponentialBackOffPolicyDefault();
         }
-        return true;
-    }
-    function setExponentialBackOffPolicyDefault() {
-        !options.backOff && (options.backOff = 1000);
-        options.exponentialOption = Object.assign({ maxInterval: 2000, multiplier: 2 }, options.exponentialOption);
+        return function (...args) {
+            return __awaiter(this, void 0, void 0, function* () {
+                try {
+                    return yield retryAsync.apply(this, [originalFn, args, options.maxAttempts, options.backOff]);
+                }
+                catch (e) {
+                    if (e instanceof MaxAttemptsError) {
+                        const retryForName = typeof name === 'symbol' ? name.toString() : name;
+                        const msgPrefix = `Failed for '${retryForName !== null && retryForName !== void 0 ? retryForName : originalFn.name}' for ${options.maxAttempts} times.`;
+                        e.message = e.message ? `${msgPrefix} Original Error: ${e.message}` : msgPrefix;
+                    }
+                    throw e;
+                }
+            });
+        };
     }
-    /**
-     * Calculate the actual backoff using the specified backoff strategy, if any
-     * @see https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/
-     * @param baseBackoff - base backoff time in ms
-     */
-    function applyBackoffStrategy(baseBackoff) {
-        var _a;
-        const { backoffStrategy } = (_a = options.exponentialOption) !== null && _a !== void 0 ? _a : {};
-        if (backoffStrategy === ExponentialBackoffStrategy.EqualJitter) {
-            return baseBackoff / 2 + (Math.random() * baseBackoff / 2);
-        }
-        if (backoffStrategy === ExponentialBackoffStrategy.FullJitter) {
-            return Math.random() * baseBackoff;
+    const decorator = function (...decoratorArgs) {
+        // Legacy TypeScript decorators: (target, propertyKey, descriptor)
+        if (decoratorArgs.length === 3) {
+            const [, propertyKey, descriptor] = decoratorArgs;
+            const originalFn = descriptor.value;
+            descriptor.value = wrapWithRetry(originalFn, propertyKey);
+            return descriptor;
         }
-        return baseBackoff;
-    }
+        // TypeScript 5 standard decorators: (value, context)
+        const [value, context] = decoratorArgs;
+        return wrapWithRetry(value, context === null || context === void 0 ? void 0 : context.name);
+    };
+    return decorator;
 }
 exports.Retryable = Retryable;
 class MaxAttemptsError extends Error {
@@ -124,7 +131,7 @@ var BackOffPolicy;
 (function (BackOffPolicy) {
     BackOffPolicy["FixedBackOffPolicy"] = "FixedBackOffPolicy";
     BackOffPolicy["ExponentialBackOffPolicy"] = "ExponentialBackOffPolicy";
-})(BackOffPolicy = exports.BackOffPolicy || (exports.BackOffPolicy = {}));
+})(BackOffPolicy || (exports.BackOffPolicy = BackOffPolicy = {}));
 /**
  * Represents different strategies for applying jitter to backoff times.
  * @see https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/
@@ -139,5 +146,5 @@ var ExponentialBackoffStrategy;
      * The backoff time will be (base backoff time / 2) + (random number between 0 and (base backoff time / 2)).
      */
     ExponentialBackoffStrategy["EqualJitter"] = "EqualJitter";
-})(ExponentialBackoffStrategy = exports.ExponentialBackoffStrategy || (exports.ExponentialBackoffStrategy = {}));
+})(ExponentialBackoffStrategy || (exports.ExponentialBackoffStrategy = ExponentialBackoffStrategy = {}));
 //# sourceMappingURL=retry.decorator.js.map