@goodie-ts/resilience 0.4.0

package/README.md

@@ -0,0 +1,58 @@
+# @goodie-ts/resilience
+
+Resilience patterns for [goodie-ts](https://github.com/GOOD-Code-ApS/goodie) — retry, circuit breaker, and timeout decorators. Built on `@goodie-ts/aop`.
+
+## Install
+
+```bash
+pnpm add @goodie-ts/resilience
+```
+
+## Overview
+
+Declarative resilience via decorators. Interceptors execute in order: **Timeout > Circuit Breaker > Retry > method** — so the timeout covers all retries, and the circuit breaker tracks the overall outcome.
+
+## Decorators
+
+| Decorator | Description | Defaults |
+|-----------|-------------|----------|
+| `@Retryable({ maxAttempts?, delay?, multiplier? })` | Retry with exponential backoff + jitter | 3 attempts, 1000ms, 2x |
+| `@CircuitBreaker({ failureThreshold?, resetTimeout?, halfOpenAttempts? })` | Circuit breaker state machine | 5 failures, 30s reset, 3 probes |
+| `@Timeout(durationMs)` | Reject if method exceeds duration | required |
+
+## Usage
+
+```typescript
+import { Retryable, CircuitBreaker, Timeout } from '@goodie-ts/resilience';
+import { Singleton } from '@goodie-ts/decorators';
+
+@Singleton()
+class PaymentService {
+  @Timeout(5000)
+  @CircuitBreaker({ failureThreshold: 3, resetTimeout: 10_000 })
+  @Retryable({ maxAttempts: 3, delay: 500 })
+  async charge(amount: number) {
+    return fetch('/api/charge', { body: JSON.stringify({ amount }) });
+  }
+}
+```
+
+## Error Types
+
+- `TimeoutError` — thrown when `@Timeout` duration is exceeded
+- `CircuitOpenError` — thrown when the circuit breaker is OPEN and rejecting calls
+
+## Vite Plugin Setup
+
+```typescript
+import { diPlugin } from '@goodie-ts/vite-plugin';
+import { createResiliencePlugin } from '@goodie-ts/resilience';
+
+export default defineConfig({
+  plugins: [diPlugin({ plugins: [createResiliencePlugin()] })],
+});
+```
+
+## License
+
+[MIT](https://github.com/GOOD-Code-ApS/goodie/blob/main/LICENSE)

package/dist/circuit-breaker-interceptor.d.ts

@@ -0,0 +1,24 @@
+import type { InvocationContext, MethodInterceptor } from '@goodie-ts/aop';
+type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
+/** Error thrown when the circuit breaker is open and rejecting calls. */
+export declare class CircuitOpenError extends Error {
+    constructor(methodKey: string);
+}
+/**
+ * AOP interceptor implementing the circuit breaker pattern.
+ *
+ * State machine: CLOSED → OPEN → HALF_OPEN → CLOSED (on success) or OPEN (on failure).
+ *
+ * Each decorated method gets its own circuit, keyed by `className:methodName`.
+ */
+export declare class CircuitBreakerInterceptor implements MethodInterceptor {
+    private readonly circuits;
+    intercept(ctx: InvocationContext): unknown;
+    /** Visible for testing — get the current state of a circuit. */
+    getCircuitState(className: string, methodName: string): CircuitState;
+    private getOrCreateCircuit;
+    private onSuccess;
+    private onFailure;
+}
+export {};
+//# sourceMappingURL=circuit-breaker-interceptor.d.ts.map

package/dist/circuit-breaker-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker-interceptor.d.ts","sourceRoot":"","sources":["../src/circuit-breaker-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,KAAK,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAoBpD,yEAAyE;AACzE,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,SAAS,EAAE,MAAM;CAI9B;AAED;;;;;;GAMG;AACH,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAE5D,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO;IAyD1C,gEAAgE;IAChE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY;IAKpE,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,SAAS;CAclB"}

package/dist/circuit-breaker-interceptor.js

@@ -0,0 +1,118 @@
+/** Error thrown when the circuit breaker is open and rejecting calls. */
+export class CircuitOpenError extends Error {
+    constructor(methodKey) {
+        super(`Circuit breaker is OPEN for ${methodKey}`);
+        this.name = 'CircuitOpenError';
+    }
+}
+/**
+ * AOP interceptor implementing the circuit breaker pattern.
+ *
+ * State machine: CLOSED → OPEN → HALF_OPEN → CLOSED (on success) or OPEN (on failure).
+ *
+ * Each decorated method gets its own circuit, keyed by `className:methodName`.
+ */
+export class CircuitBreakerInterceptor {
+    circuits = new Map();
+    intercept(ctx) {
+        const meta = ctx.metadata;
+        if (!meta)
+            return ctx.proceed();
+        const key = `${ctx.className}:${ctx.methodName}`;
+        const circuit = this.getOrCreateCircuit(key, meta);
+        if (circuit.state === 'OPEN') {
+            const elapsed = Date.now() - circuit.lastFailureTime;
+            if (elapsed >= circuit.resetTimeout) {
+                circuit.state = 'HALF_OPEN';
+                circuit.successCount = 0;
+            }
+            else {
+                throw new CircuitOpenError(key);
+            }
+        }
+        // Only allow one probe at a time during HALF_OPEN. Concurrent calls are
+        // rejected immediately so a burst of requests doesn't overwhelm a
+        // recovering backend.
+        if (circuit.state === 'HALF_OPEN' && circuit.halfOpenProbeInFlight) {
+            throw new CircuitOpenError(key);
+        }
+        const isProbe = circuit.state === 'HALF_OPEN';
+        if (isProbe) {
+            circuit.halfOpenProbeInFlight = true;
+        }
+        try {
+            const result = ctx.proceed();
+            if (result instanceof Promise) {
+                return result.then((value) => {
+                    if (isProbe)
+                        circuit.halfOpenProbeInFlight = false;
+                    this.onSuccess(circuit);
+                    return value;
+                }, (error) => {
+                    if (isProbe)
+                        circuit.halfOpenProbeInFlight = false;
+                    this.onFailure(circuit);
+                    throw error;
+                });
+            }
+            if (isProbe)
+                circuit.halfOpenProbeInFlight = false;
+            this.onSuccess(circuit);
+            return result;
+        }
+        catch (error) {
+            if (isProbe)
+                circuit.halfOpenProbeInFlight = false;
+            this.onFailure(circuit);
+            throw error;
+        }
+    }
+    /** Visible for testing — get the current state of a circuit. */
+    getCircuitState(className, methodName) {
+        const key = `${className}:${methodName}`;
+        return this.circuits.get(key)?.state ?? 'CLOSED';
+    }
+    getOrCreateCircuit(key, meta) {
+        let circuit = this.circuits.get(key);
+        if (!circuit) {
+            circuit = {
+                state: 'CLOSED',
+                failureCount: 0,
+                successCount: 0,
+                lastFailureTime: 0,
+                failureThreshold: meta.failureThreshold,
+                resetTimeout: meta.resetTimeout,
+                halfOpenAttempts: meta.halfOpenAttempts,
+                halfOpenProbeInFlight: false,
+            };
+            this.circuits.set(key, circuit);
+        }
+        return circuit;
+    }
+    onSuccess(circuit) {
+        if (circuit.state === 'HALF_OPEN') {
+            circuit.successCount++;
+            if (circuit.successCount >= circuit.halfOpenAttempts) {
+                circuit.state = 'CLOSED';
+                circuit.failureCount = 0;
+                circuit.successCount = 0;
+            }
+        }
+        else if (circuit.state === 'CLOSED') {
+            circuit.failureCount = 0;
+        }
+    }
+    onFailure(circuit) {
+        circuit.failureCount++;
+        circuit.lastFailureTime = Date.now();
+        if (circuit.state === 'HALF_OPEN') {
+            circuit.state = 'OPEN';
+            circuit.successCount = 0;
+        }
+        else if (circuit.state === 'CLOSED' &&
+            circuit.failureCount >= circuit.failureThreshold) {
+            circuit.state = 'OPEN';
+        }
+    }
+}
+//# sourceMappingURL=circuit-breaker-interceptor.js.map

package/dist/circuit-breaker-interceptor.js.map

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

package/dist/decorators/circuit-breaker.d.ts

@@ -0,0 +1,18 @@
+export interface CircuitBreakerOptions {
+    /** Number of failures before opening the circuit (default: 5). */
+    failureThreshold?: number;
+    /** Time in ms before moving from OPEN to HALF_OPEN (default: 30000). */
+    resetTimeout?: number;
+    /** Number of successes in HALF_OPEN needed to close the circuit (default: 1). */
+    halfOpenAttempts?: number;
+}
+type MethodDecorator_Stage3 = (target: (...args: never) => unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * Mark a method for circuit breaker protection.
+ *
+ * At compile time, the resilience transformer plugin reads this decorator
+ * and wires the `CircuitBreakerInterceptor` via AOP.
+ */
+export declare function CircuitBreaker(_opts?: CircuitBreakerOptions): MethodDecorator_Stage3;
+export {};
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/decorators/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/decorators/circuit-breaker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,KAAK,sBAAsB,GAAG,CAC5B,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EACnC,OAAO,EAAE,2BAA2B,KACjC,IAAI,CAAC;AAEV;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,CAAC,EAAE,qBAAqB,GAC5B,sBAAsB,CAIxB"}

package/dist/decorators/circuit-breaker.js

@@ -0,0 +1,12 @@
+/**
+ * Mark a method for circuit breaker protection.
+ *
+ * At compile time, the resilience transformer plugin reads this decorator
+ * and wires the `CircuitBreakerInterceptor` via AOP.
+ */
+export function CircuitBreaker(_opts) {
+    return (_target, _context) => {
+        // No-op: read at compile time by the resilience transformer plugin
+    };
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/decorators/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/decorators/circuit-breaker.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,KAA6B;IAE7B,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QAC3B,mEAAmE;IACrE,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/retryable.d.ts

@@ -0,0 +1,18 @@
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3). */
+    maxAttempts?: number;
+    /** Delay between retries in milliseconds (default: 1000). */
+    delay?: number;
+    /** Multiplier for exponential backoff (default: 1 — no backoff). */
+    multiplier?: number;
+}
+type MethodDecorator_Stage3 = (target: (...args: never) => unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * Mark a method for automatic retry on failure.
+ *
+ * At compile time, the resilience transformer plugin reads this decorator
+ * and wires the `RetryInterceptor` via AOP. No runtime metadata is stored.
+ */
+export declare function Retryable(_opts?: RetryOptions): MethodDecorator_Stage3;
+export {};
+//# sourceMappingURL=retryable.d.ts.map

package/dist/decorators/retryable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryable.d.ts","sourceRoot":"","sources":["../../src/decorators/retryable.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,sBAAsB,GAAG,CAC5B,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EACnC,OAAO,EAAE,2BAA2B,KACjC,IAAI,CAAC;AAEV;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,sBAAsB,CAItE"}

package/dist/decorators/retryable.js

@@ -0,0 +1,12 @@
+/**
+ * Mark a method for automatic retry on failure.
+ *
+ * At compile time, the resilience transformer plugin reads this decorator
+ * and wires the `RetryInterceptor` via AOP. No runtime metadata is stored.
+ */
+export function Retryable(_opts) {
+    return (_target, _context) => {
+        // No-op: read at compile time by the resilience transformer plugin
+    };
+}
+//# sourceMappingURL=retryable.js.map

package/dist/decorators/retryable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryable.js","sourceRoot":"","sources":["../../src/decorators/retryable.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAoB;IAC5C,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QAC3B,mEAAmE;IACrE,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/timeout.d.ts

@@ -0,0 +1,12 @@
+type MethodDecorator_Stage3 = (target: (...args: never) => unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * Mark a method for automatic timeout.
+ *
+ * At compile time, the resilience transformer plugin reads this decorator
+ * and wires the `TimeoutInterceptor` via AOP.
+ *
+ * @param duration - Timeout duration in milliseconds.
+ */
+export declare function Timeout(_duration: number): MethodDecorator_Stage3;
+export {};
+//# sourceMappingURL=timeout.d.ts.map

package/dist/decorators/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/decorators/timeout.ts"],"names":[],"mappings":"AAAA,KAAK,sBAAsB,GAAG,CAC5B,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EACnC,OAAO,EAAE,2BAA2B,KACjC,IAAI,CAAC;AAEV;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAIjE"}

package/dist/decorators/timeout.js

@@ -0,0 +1,14 @@
+/**
+ * Mark a method for automatic timeout.
+ *
+ * At compile time, the resilience transformer plugin reads this decorator
+ * and wires the `TimeoutInterceptor` via AOP.
+ *
+ * @param duration - Timeout duration in milliseconds.
+ */
+export function Timeout(_duration) {
+    return (_target, _context) => {
+        // No-op: read at compile time by the resilience transformer plugin
+    };
+}
+//# sourceMappingURL=timeout.js.map

package/dist/decorators/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/decorators/timeout.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,SAAiB;IACvC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QAC3B,mEAAmE;IACrE,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { CircuitBreakerInterceptor, CircuitOpenError, } from './circuit-breaker-interceptor.js';
+export { CircuitBreaker } from './decorators/circuit-breaker.js';
+export { Retryable } from './decorators/retryable.js';
+export { Timeout } from './decorators/timeout.js';
+export { createResiliencePlugin } from './resilience-transformer-plugin.js';
+export { RetryInterceptor } from './retry-interceptor.js';
+export { TimeoutError, TimeoutInterceptor } from './timeout-interceptor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { CircuitBreakerInterceptor, CircuitOpenError, } from './circuit-breaker-interceptor.js';
+export { CircuitBreaker } from './decorators/circuit-breaker.js';
+export { Retryable } from './decorators/retryable.js';
+export { Timeout } from './decorators/timeout.js';
+export { createResiliencePlugin } from './resilience-transformer-plugin.js';
+export { RetryInterceptor } from './retry-interceptor.js';
+export { TimeoutError, TimeoutInterceptor } from './timeout-interceptor.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/resilience-transformer-plugin.d.ts

@@ -0,0 +1,9 @@
+import type { TransformerPlugin } from '@goodie-ts/transformer';
+/**
+ * Create the resilience transformer plugin.
+ *
+ * Scans @Retryable, @CircuitBreaker, and @Timeout decorators on methods
+ * and wires the appropriate interceptors as AOP dependencies at compile time.
+ */
+export declare function createResiliencePlugin(): TransformerPlugin;
+//# sourceMappingURL=resilience-transformer-plugin.d.ts.map

package/dist/resilience-transformer-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience-transformer-plugin.d.ts","sourceRoot":"","sources":["../src/resilience-transformer-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AA4BhC;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,iBAAiB,CAiJ1D"}

package/dist/resilience-transformer-plugin.js

@@ -0,0 +1,211 @@
+const DECORATOR_MAP = {
+    Retryable: 'retry',
+    CircuitBreaker: 'circuitBreaker',
+    Timeout: 'timeout',
+};
+/** Order values — outermost (lowest) runs first: Timeout → CircuitBreaker → Retry */
+const ORDER_MAP = {
+    timeout: -30, // Outermost — enforces deadline
+    circuitBreaker: -20, // Middle — rejects if circuit open
+    retry: -10, // Innermost — retries close to the method
+};
+const INTERCEPTOR_CLASS_MAP = {
+    retry: 'RetryInterceptor',
+    circuitBreaker: 'CircuitBreakerInterceptor',
+    timeout: 'TimeoutInterceptor',
+};
+/**
+ * Create the resilience transformer plugin.
+ *
+ * Scans @Retryable, @CircuitBreaker, and @Timeout decorators on methods
+ * and wires the appropriate interceptors as AOP dependencies at compile time.
+ */
+export function createResiliencePlugin() {
+    const classResilienceInfo = new Map();
+    return {
+        name: 'resilience',
+        beforeScan() {
+            classResilienceInfo.clear();
+        },
+        visitMethod(ctx) {
+            const decorators = ctx.methodDeclaration.getDecorators();
+            for (const decorator of decorators) {
+                const decoratorName = decorator.getName();
+                const kind = DECORATOR_MAP[decoratorName];
+                if (!kind)
+                    continue;
+                const args = decorator.getArguments();
+                const metadata = parseMetadata(kind, args);
+                const key = `${ctx.filePath}:${ctx.className}`;
+                const existing = classResilienceInfo.get(key) ?? [];
+                existing.push({
+                    methodName: ctx.methodName,
+                    kind,
+                    metadata,
+                });
+                classResilienceInfo.set(key, existing);
+            }
+        },
+        afterResolve(beans) {
+            const usedInterceptors = new Set();
+            for (const bean of beans) {
+                const className = bean.tokenRef.kind === 'class' ? bean.tokenRef.className : undefined;
+                if (!className)
+                    continue;
+                const key = `${bean.tokenRef.importPath}:${className}`;
+                const infos = classResilienceInfo.get(key);
+                if (!infos || infos.length === 0)
+                    continue;
+                const existing = (bean.metadata.interceptedMethods ?? []);
+                for (const info of infos) {
+                    const interceptorClassName = INTERCEPTOR_CLASS_MAP[info.kind];
+                    usedInterceptors.add(interceptorClassName);
+                    const methodEntry = existing.find((m) => m.methodName === info.methodName);
+                    const interceptorRef = {
+                        className: interceptorClassName,
+                        importPath: '@goodie-ts/resilience',
+                        adviceType: 'around',
+                        order: ORDER_MAP[info.kind],
+                        metadata: info.metadata,
+                    };
+                    if (methodEntry) {
+                        methodEntry.interceptors.push(interceptorRef);
+                    }
+                    else {
+                        existing.push({
+                            methodName: info.methodName,
+                            interceptors: [interceptorRef],
+                        });
+                    }
+                }
+                bean.metadata.interceptedMethods = existing;
+            }
+            if (usedInterceptors.size === 0)
+                return beans;
+            // Add synthetic beans for each used interceptor
+            const syntheticBeans = [];
+            for (const interceptorClassName of usedInterceptors) {
+                syntheticBeans.push({
+                    tokenRef: {
+                        kind: 'class',
+                        className: interceptorClassName,
+                        importPath: '@goodie-ts/resilience',
+                    },
+                    scope: 'singleton',
+                    eager: false,
+                    name: undefined,
+                    constructorDeps: [],
+                    fieldDeps: [],
+                    factoryKind: 'constructor',
+                    providesSource: undefined,
+                    metadata: {},
+                    sourceLocation: {
+                        filePath: '@goodie-ts/resilience',
+                        line: 0,
+                        column: 0,
+                    },
+                });
+            }
+            return [...beans, ...syntheticBeans];
+        },
+        codegen(beans) {
+            const usedClasses = new Set();
+            for (const bean of beans) {
+                const methods = bean.metadata.interceptedMethods;
+                if (!methods)
+                    continue;
+                for (const m of methods) {
+                    for (const i of m.interceptors) {
+                        if (i.importPath === '@goodie-ts/resilience') {
+                            usedClasses.add(i.className);
+                        }
+                    }
+                }
+            }
+            if (usedClasses.size === 0)
+                return {};
+            const classNames = [...usedClasses].sort().join(', ');
+            return {
+                imports: [
+                    `import { ${classNames} } from '@goodie-ts/resilience'`,
+                    "import { buildInterceptorChain } from '@goodie-ts/aop'",
+                ],
+            };
+        },
+    };
+}
+/** Strip TypeScript numeric separators: 1_000 → 1000 */
+function stripSeparators(s) {
+    return s.replace(/_/g, '');
+}
+/**
+ * Parse decorator arguments into metadata.
+ *
+ * **Limitation:** Only literal numeric values are supported. Const references
+ * or computed expressions (e.g. `maxAttempts: MAX_RETRIES`) will fall back to
+ * defaults silently. This matches the compile-time AST text parsing approach
+ * used by all goodie-ts transformer plugins.
+ */
+function parseMetadata(kind, args) {
+    switch (kind) {
+        case 'retry': {
+            const defaults = { maxAttempts: 3, delay: 1000, multiplier: 1 };
+            if (args.length === 0)
+                return defaults;
+            const text = args[0].getText();
+            const maxMatch = text.match(/maxAttempts\s*:\s*(\d[\d_]*)/);
+            const delayMatch = text.match(/delay\s*:\s*(\d[\d_]*)/);
+            const multMatch = text.match(/multiplier\s*:\s*([\d_]+(?:\.[\d_]+)?)/);
+            return {
+                maxAttempts: maxMatch
+                    ? Number.parseInt(stripSeparators(maxMatch[1]), 10)
+                    : defaults.maxAttempts,
+                delay: delayMatch
+                    ? Number.parseInt(stripSeparators(delayMatch[1]), 10)
+                    : defaults.delay,
+                multiplier: multMatch
+                    ? Number.parseFloat(stripSeparators(multMatch[1]))
+                    : defaults.multiplier,
+            };
+        }
+        case 'circuitBreaker': {
+            const defaults = {
+                failureThreshold: 5,
+                resetTimeout: 30000,
+                halfOpenAttempts: 1,
+            };
+            if (args.length === 0)
+                return defaults;
+            const text = args[0].getText();
+            const threshMatch = text.match(/failureThreshold\s*:\s*(\d[\d_]*)/);
+            const resetMatch = text.match(/resetTimeout\s*:\s*(\d[\d_]*)/);
+            const halfMatch = text.match(/halfOpenAttempts\s*:\s*(\d[\d_]*)/);
+            return {
+                failureThreshold: threshMatch
+                    ? Number.parseInt(stripSeparators(threshMatch[1]), 10)
+                    : defaults.failureThreshold,
+                resetTimeout: resetMatch
+                    ? Number.parseInt(stripSeparators(resetMatch[1]), 10)
+                    : defaults.resetTimeout,
+                halfOpenAttempts: halfMatch
+                    ? Number.parseInt(stripSeparators(halfMatch[1]), 10)
+                    : defaults.halfOpenAttempts,
+            };
+        }
+        case 'timeout': {
+            if (args.length === 0)
+                return { duration: 5000 };
+            const text = stripSeparators(args[0].getText());
+            const num = Number.parseInt(text, 10);
+            if (Number.isNaN(num)) {
+                if (text.includes('{')) {
+                    console.warn(`[resilience] @Timeout received an object literal argument (${text}). ` +
+                        'Only numeric durations are supported — falling back to 5000ms.');
+                }
+                return { duration: 5000 };
+            }
+            return { duration: num };
+        }
+    }
+}
+//# sourceMappingURL=resilience-transformer-plugin.js.map

package/dist/resilience-transformer-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience-transformer-plugin.js","sourceRoot":"","sources":["../src/resilience-transformer-plugin.ts"],"names":[],"mappings":"AAcA,MAAM,aAAa,GAA2D;IAC5E,SAAS,EAAE,OAAO;IAClB,cAAc,EAAE,gBAAgB;IAChC,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,qFAAqF;AACrF,MAAM,SAAS,GAA2B;IACxC,OAAO,EAAE,CAAC,EAAE,EAAE,gCAAgC;IAC9C,cAAc,EAAE,CAAC,EAAE,EAAE,mCAAmC;IACxD,KAAK,EAAE,CAAC,EAAE,EAAE,0CAA0C;CACvD,CAAC;AAEF,MAAM,qBAAqB,GAA2B;IACpD,KAAK,EAAE,kBAAkB;IACzB,cAAc,EAAE,2BAA2B;IAC3C,OAAO,EAAE,oBAAoB;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAkC,CAAC;IAEtE,OAAO;QACL,IAAI,EAAE,YAAY;QAElB,UAAU;YACR,mBAAmB,CAAC,KAAK,EAAE,CAAC;QAC9B,CAAC;QAED,WAAW,CAAC,GAAyB;YACnC,MAAM,UAAU,GAAG,GAAG,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC;YAEzD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;gBAC1C,MAAM,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;gBAC1C,IAAI,CAAC,IAAI;oBAAE,SAAS;gBAEpB,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC;gBACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAE3C,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBAC/C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACpD,QAAQ,CAAC,IAAI,CAAC;oBACZ,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,IAAI;oBACJ,QAAQ;iBACT,CAAC,CAAC;gBACH,mBAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,YAAY,CAAC,KAAyB;YACpC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;YAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,SAAS,GACb,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvE,IAAI,CAAC,SAAS;oBAAE,SAAS;gBAEzB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,SAAS,EAAE,CAAC;gBACvD,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC3C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAS;gBAE3C,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,IAAI,EAAE,CAStD,CAAC;gBAEH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,oBAAoB,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC9D,gBAAgB,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;oBAE3C,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,CACxC,CAAC;oBAEF,MAAM,cAAc,GAAG;wBACrB,SAAS,EAAE,oBAAoB;wBAC/B,UAAU,EAAE,uBAAuB;wBACnC,UAAU,EAAE,QAAiB;wBAC7B,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;wBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;qBACxB,CAAC;oBAEF,IAAI,WAAW,EAAE,CAAC;wBAChB,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;oBAChD,CAAC;yBAAM,CAAC;wBACN,QAAQ,CAAC,IAAI,CAAC;4BACZ,UAAU,EAAE,IAAI,CAAC,UAAU;4BAC3B,YAAY,EAAE,CAAC,cAAc,CAAC;yBAC/B,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,QAAQ,CAAC,kBAAkB,GAAG,QAAQ,CAAC;YAC9C,CAAC;YAED,IAAI,gBAAgB,CAAC,IAAI,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YAE9C,gDAAgD;YAChD,MAAM,cAAc,GAAuB,EAAE,CAAC;YAC9C,KAAK,MAAM,oBAAoB,IAAI,gBAAgB,EAAE,CAAC;gBACpD,cAAc,CAAC,IAAI,CAAC;oBAClB,QAAQ,EAAE;wBACR,IAAI,EAAE,OAAO;wBACb,SAAS,EAAE,oBAAoB;wBAC/B,UAAU,EAAE,uBAAuB;qBACpC;oBACD,KAAK,EAAE,WAAW;oBAClB,KAAK,EAAE,KAAK;oBACZ,IAAI,EAAE,SAAS;oBACf,eAAe,EAAE,EAAE;oBACnB,SAAS,EAAE,EAAE;oBACb,WAAW,EAAE,aAAa;oBAC1B,cAAc,EAAE,SAAS;oBACzB,QAAQ,EAAE,EAAE;oBACZ,cAAc,EAAE;wBACd,QAAQ,EAAE,uBAAuB;wBACjC,IAAI,EAAE,CAAC;wBACP,MAAM,EAAE,CAAC;qBACV;iBACF,CAAC,CAAC;YACL,CAAC;YAED,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,cAAc,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,CAAC,KAAyB;YAC/B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;YAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,kBAIjB,CAAC;gBACd,IAAI,CAAC,OAAO;oBAAE,SAAS;gBAEvB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;wBAC/B,IAAI,CAAC,CAAC,UAAU,KAAK,uBAAuB,EAAE,CAAC;4BAC7C,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;wBAC/B,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAEtC,MAAM,UAAU,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtD,OAAO;gBACL,OAAO,EAAE;oBACP,YAAY,UAAU,iCAAiC;oBACvD,wDAAwD;iBACzD;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,SAAS,eAAe,CAAC,CAAS;IAChC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CACpB,IAA4C,EAC5C,IAIC;IAED,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,QAAQ,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;YAChE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACxD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;YACvE,OAAO;gBACL,WAAW,EAAE,QAAQ;oBACnB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACnD,CAAC,CAAC,QAAQ,CAAC,WAAW;gBACxB,KAAK,EAAE,UAAU;oBACf,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACrD,CAAC,CAAC,QAAQ,CAAC,KAAK;gBAClB,UAAU,EAAE,SAAS;oBACnB,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;oBAClD,CAAC,CAAC,QAAQ,CAAC,UAAU;aACxB,CAAC;QACJ,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,QAAQ,GAAG;gBACf,gBAAgB,EAAE,CAAC;gBACnB,YAAY,EAAE,KAAK;gBACnB,gBAAgB,EAAE,CAAC;aACpB,CAAC;YACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACpE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;YAClE,OAAO;gBACL,gBAAgB,EAAE,WAAW;oBAC3B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACtD,CAAC,CAAC,QAAQ,CAAC,gBAAgB;gBAC7B,YAAY,EAAE,UAAU;oBACtB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACrD,CAAC,CAAC,QAAQ,CAAC,YAAY;gBACzB,gBAAgB,EAAE,SAAS;oBACzB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACpD,CAAC,CAAC,QAAQ,CAAC,gBAAgB;aAC9B,CAAC;QACJ,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAChD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACvB,OAAO,CAAC,IAAI,CACV,8DAA8D,IAAI,KAAK;wBACrE,gEAAgE,CACnE,CAAC;gBACJ,CAAC;gBACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC5B,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/retry-interceptor.d.ts

@@ -0,0 +1,27 @@
+import type { InvocationContext, MethodInterceptor } from '@goodie-ts/aop';
+/**
+ * AOP interceptor that retries failed method calls with configurable
+ * backoff strategy (exponential backoff with random jitter).
+ *
+ * Reads retry configuration from `ctx.metadata` (set by the resilience
+ * transformer plugin).
+ *
+ * **Design note — interceptor chain:** Retry sits innermost in the interceptor
+ * chain (order -10). On retry, `proceed()` calls the target method directly —
+ * outer interceptors (circuit breaker, timeout) are NOT re-entered. This is
+ * intentional: the timeout deadline applies to the total call including all
+ * retries, and the circuit breaker tracks the overall outcome, not individual
+ * retry attempts.
+ *
+ * **Design note — sync methods:** When a sync method fails and retries are
+ * needed, the retry delay uses `setTimeout`, which returns a `Promise`.
+ * As a result, decorated sync methods effectively become async on the first
+ * failure. Callers should always `await` the return value of `@Retryable`
+ * methods.
+ */
+export declare class RetryInterceptor implements MethodInterceptor {
+    intercept(ctx: InvocationContext): unknown;
+    private tryCall;
+    private handleError;
+}
+//# sourceMappingURL=retry-interceptor.d.ts.map

package/dist/retry-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-interceptor.d.ts","sourceRoot":"","sources":["../src/retry-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAS3E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO;IAQ1C,OAAO,CAAC,OAAO;IAoBf,OAAO,CAAC,WAAW;CA+BpB"}

package/dist/retry-interceptor.js

@@ -0,0 +1,68 @@
+/**
+ * AOP interceptor that retries failed method calls with configurable
+ * backoff strategy (exponential backoff with random jitter).
+ *
+ * Reads retry configuration from `ctx.metadata` (set by the resilience
+ * transformer plugin).
+ *
+ * **Design note — interceptor chain:** Retry sits innermost in the interceptor
+ * chain (order -10). On retry, `proceed()` calls the target method directly —
+ * outer interceptors (circuit breaker, timeout) are NOT re-entered. This is
+ * intentional: the timeout deadline applies to the total call including all
+ * retries, and the circuit breaker tracks the overall outcome, not individual
+ * retry attempts.
+ *
+ * **Design note — sync methods:** When a sync method fails and retries are
+ * needed, the retry delay uses `setTimeout`, which returns a `Promise`.
+ * As a result, decorated sync methods effectively become async on the first
+ * failure. Callers should always `await` the return value of `@Retryable`
+ * methods.
+ */
+export class RetryInterceptor {
+    intercept(ctx) {
+        const meta = ctx.metadata;
+        if (!meta)
+            return ctx.proceed();
+        const result = this.tryCall(ctx, meta, 1);
+        return result;
+    }
+    tryCall(ctx, meta, attempt) {
+        try {
+            const result = ctx.proceed();
+            if (result instanceof Promise) {
+                return result.catch((error) => this.handleError(ctx, meta, attempt, error));
+            }
+            return result;
+        }
+        catch (error) {
+            return this.handleError(ctx, meta, attempt, error);
+        }
+    }
+    handleError(ctx, meta, attempt, error) {
+        if (attempt >= meta.maxAttempts) {
+            throw error;
+        }
+        // Exponential backoff with random jitter (50–100% of computed delay)
+        // to prevent thundering herd when many callers retry simultaneously.
+        const baseDelay = meta.delay * meta.multiplier ** (attempt - 1);
+        const delayMs = baseDelay * (0.5 + Math.random() * 0.5);
+        // For async methods, use setTimeout-based delay
+        return new Promise((resolve, reject) => {
+            setTimeout(() => {
+                try {
+                    const result = this.tryCall(ctx, meta, attempt + 1);
+                    if (result instanceof Promise) {
+                        result.then(resolve, reject);
+                    }
+                    else {
+                        resolve(result);
+                    }
+                }
+                catch (retryError) {
+                    reject(retryError);
+                }
+            }, delayMs);
+        });
+    }
+}
+//# sourceMappingURL=retry-interceptor.js.map

package/dist/retry-interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-interceptor.js","sourceRoot":"","sources":["../src/retry-interceptor.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,SAAS,CAAC,GAAsB;QAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,QAAqC,CAAC;QACvD,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC;QAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,OAAO,CACb,GAAsB,EACtB,IAAmB,EACnB,OAAe;QAEf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;YAE7B,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAC5B,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAC5C,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAEO,WAAW,CACjB,GAAsB,EACtB,IAAmB,EACnB,OAAe,EACf,KAAc;QAEd,IAAI,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAChC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,qEAAqE;QACrE,qEAAqE;QACrE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,SAAS,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;QAExD,gDAAgD;QAChD,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;oBACpD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;wBAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBAC/B,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,MAAM,CAAC,CAAC;oBAClB,CAAC;gBACH,CAAC;gBAAC,OAAO,UAAU,EAAE,CAAC;oBACpB,MAAM,CAAC,UAAU,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC,EAAE,OAAO,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/timeout-interceptor.d.ts

@@ -0,0 +1,16 @@
+import type { InvocationContext, MethodInterceptor } from '@goodie-ts/aop';
+/** Error thrown when a method call exceeds its timeout. */
+export declare class TimeoutError extends Error {
+    constructor(methodKey: string, duration: number);
+}
+/**
+ * AOP interceptor that enforces a timeout on method execution.
+ *
+ * For async methods, uses `Promise.race` with a timeout promise.
+ * For sync methods, the timeout cannot be enforced (sync code blocks the
+ * event loop), so the result is returned as-is.
+ */
+export declare class TimeoutInterceptor implements MethodInterceptor {
+    intercept(ctx: InvocationContext): unknown;
+}
+//# sourceMappingURL=timeout-interceptor.d.ts.map

package/dist/timeout-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-interceptor.d.ts","sourceRoot":"","sources":["../src/timeout-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAO3E,2DAA2D;AAC3D,qBAAa,YAAa,SAAQ,KAAK;gBACzB,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAIhD;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB;IAC1D,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO;CAuB3C"}

package/dist/timeout-interceptor.js

@@ -0,0 +1,33 @@
+/** Error thrown when a method call exceeds its timeout. */
+export class TimeoutError extends Error {
+    constructor(methodKey, duration) {
+        super(`Method ${methodKey} timed out after ${duration}ms`);
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * AOP interceptor that enforces a timeout on method execution.
+ *
+ * For async methods, uses `Promise.race` with a timeout promise.
+ * For sync methods, the timeout cannot be enforced (sync code blocks the
+ * event loop), so the result is returned as-is.
+ */
+export class TimeoutInterceptor {
+    intercept(ctx) {
+        const meta = ctx.metadata;
+        if (!meta)
+            return ctx.proceed();
+        const key = `${ctx.className}:${ctx.methodName}`;
+        const result = ctx.proceed();
+        // Timeout only applies to async methods (sync methods can't be interrupted)
+        if (result instanceof Promise) {
+            let timeoutId;
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutId = setTimeout(() => reject(new TimeoutError(key, meta.duration)), meta.duration);
+            });
+            return Promise.race([result, timeoutPromise]).finally(() => clearTimeout(timeoutId));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=timeout-interceptor.js.map

package/dist/timeout-interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-interceptor.js","sourceRoot":"","sources":["../src/timeout-interceptor.ts"],"names":[],"mappings":"AAOA,2DAA2D;AAC3D,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,SAAiB,EAAE,QAAgB;QAC7C,KAAK,CAAC,UAAU,SAAS,oBAAoB,QAAQ,IAAI,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IAC7B,SAAS,CAAC,GAAsB;QAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,QAAuC,CAAC;QACzD,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC;QAEhC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;QAE7B,4EAA4E;QAC5E,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,IAAI,SAAwC,CAAC;YAC7C,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBACtD,SAAS,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAClD,IAAI,CAAC,QAAQ,CACd,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CACzD,YAAY,CAAC,SAAS,CAAC,CACxB,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@goodie-ts/resilience",
+  "version": "0.4.0",
+  "description": "Resilience patterns for goodie-ts — @Retryable, @CircuitBreaker, @Timeout decorators",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GOOD-Code-ApS/goodie.git",
+    "directory": "packages/resilience"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "@goodie-ts/aop": "workspace:*"
+  },
+  "peerDependencies": {
+    "@goodie-ts/transformer": "workspace:*"
+  },
+  "devDependencies": {
+    "@goodie-ts/transformer": "workspace:*",
+    "@types/node": "^22.0.0",
+    "ts-morph": "^24.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}