raffel 0.1.2

package/dist/middleware/interceptors/request-id.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Request ID Interceptor
+ *
+ * Ensures every request has a unique ID for tracing and debugging.
+ * Propagates IDs from incoming requests or generates new ones.
+ */
+import type { Interceptor } from '../../types/index.js';
+import type { RequestIdConfig } from '../types.js';
+/**
+ * Create a request ID interceptor
+ *
+ * This interceptor ensures every request has a unique ID that can be used
+ * for distributed tracing, logging, and debugging.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - generates nanoid for each request
+ * const requestId = createRequestIdInterceptor()
+ *
+ * // Custom generator
+ * const requestId = createRequestIdInterceptor({
+ *   generator: () => `req_${Date.now()}_${Math.random().toString(36).slice(2)}`,
+ * })
+ *
+ * // Propagate from incoming metadata
+ * const requestId = createRequestIdInterceptor({
+ *   propagate: true,
+ *   metadataKey: 'x-request-id',
+ * })
+ *
+ * server.use(requestId)
+ * ```
+ */
+export declare function createRequestIdInterceptor(config?: RequestIdConfig): Interceptor;
+/**
+ * Create a request ID interceptor with prefix
+ *
+ * Useful for identifying requests from specific services or environments.
+ *
+ * @example
+ * ```typescript
+ * const requestId = createPrefixedRequestIdInterceptor('api')
+ * // Generates IDs like: api_V1StGXR8_Z5jdHi6B-myT
+ * ```
+ */
+export declare function createPrefixedRequestIdInterceptor(prefix: string, config?: Omit<RequestIdConfig, 'generator'>): Interceptor;
+/**
+ * Create a request ID interceptor with correlation ID support
+ *
+ * Supports both request ID (per-request) and correlation ID (per-user-action).
+ *
+ * @example
+ * ```typescript
+ * const requestId = createCorrelatedRequestIdInterceptor({
+ *   correlationKey: 'x-correlation-id',
+ * })
+ * ```
+ */
+export declare function createCorrelatedRequestIdInterceptor(config?: {
+    correlationKey?: string;
+    requestIdKey?: string;
+}): Interceptor;
+//# sourceMappingURL=request-id.d.ts.map

package/dist/middleware/interceptors/request-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-id.d.ts","sourceRoot":"","sources":["../../../src/middleware/interceptors/request-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,GAAE,eAAoB,GAAG,WAAW,CA4CpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAM,GAC9C,WAAW,CAKb;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oCAAoC,CAAC,MAAM,GAAE;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,WAAW,CA4BnB"}

package/dist/middleware/interceptors/request-id.int.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Request ID Interceptor Tests
+ */
+export {};
+//# sourceMappingURL=request-id.int.test.d.ts.map

package/dist/middleware/interceptors/request-id.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-id.int.test.d.ts","sourceRoot":"","sources":["../../../src/middleware/interceptors/request-id.int.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/middleware/interceptors/request-id.int.test.js

@@ -0,0 +1,136 @@
+/**
+ * Request ID Interceptor Tests
+ */
+import { describe, it, expect } from 'vitest';
+import { createRequestIdInterceptor, createPrefixedRequestIdInterceptor, createCorrelatedRequestIdInterceptor, } from './request-id.js';
+import { createContext } from '../../types/index.js';
+function createEnvelope(procedure, metadata = {}) {
+    return {
+        id: `test-${Date.now()}`,
+        procedure,
+        payload: {},
+        type: 'request',
+        metadata: { ...metadata },
+        context: createContext('test-id'),
+    };
+}
+function createTestContext() {
+    return createContext('test');
+}
+describe('createRequestIdInterceptor', () => {
+    it('should generate a request ID if none exists', async () => {
+        const interceptor = createRequestIdInterceptor();
+        const ctx = createTestContext();
+        ctx.requestId = '';
+        await interceptor(createEnvelope('test'), ctx, async () => 'done');
+        expect(ctx.requestId).toBeDefined();
+        expect(ctx.requestId.length).toBeGreaterThan(0);
+    });
+    it('should add request ID to envelope metadata', async () => {
+        const interceptor = createRequestIdInterceptor();
+        const envelope = createEnvelope('test');
+        const ctx = createTestContext();
+        await interceptor(envelope, ctx, async () => 'done');
+        expect(envelope.metadata['x-request-id']).toBe(ctx.requestId);
+    });
+    it('should use custom metadataKey', async () => {
+        const interceptor = createRequestIdInterceptor({
+            metadataKey: 'x-trace-id',
+        });
+        const envelope = createEnvelope('test');
+        const ctx = createTestContext();
+        await interceptor(envelope, ctx, async () => 'done');
+        expect(envelope.metadata['x-trace-id']).toBe(ctx.requestId);
+    });
+    it('should use custom generator function', async () => {
+        const interceptor = createRequestIdInterceptor({
+            generator: () => 'custom-generated-id',
+        });
+        const envelope = createEnvelope('test');
+        const ctx = createTestContext();
+        await interceptor(envelope, ctx, async () => 'done');
+        expect(ctx.requestId).toBe('custom-generated-id');
+    });
+    it('should propagate existing ID from envelope metadata', async () => {
+        const interceptor = createRequestIdInterceptor({
+            propagate: true,
+        });
+        const envelope = createEnvelope('test', { 'x-request-id': 'from-metadata' });
+        const ctx = createTestContext();
+        await interceptor(envelope, ctx, async () => 'done');
+        expect(ctx.requestId).toBe('from-metadata');
+    });
+    it('should not propagate when propagate is false', async () => {
+        const interceptor = createRequestIdInterceptor({
+            propagate: false,
+        });
+        const envelope = createEnvelope('test', { 'x-request-id': 'from-metadata' });
+        const ctx = createTestContext();
+        await interceptor(envelope, ctx, async () => 'done');
+        expect(ctx.requestId).not.toBe('from-metadata');
+    });
+});
+describe('createPrefixedRequestIdInterceptor', () => {
+    it('should generate ID with prefix', async () => {
+        const interceptor = createPrefixedRequestIdInterceptor('api');
+        const envelope = createEnvelope('test');
+        const ctx = createTestContext();
+        await interceptor(envelope, ctx, async () => 'done');
+        expect(ctx.requestId).toMatch(/^api_/);
+    });
+    it('should propagate from metadata with prefix handling', async () => {
+        const interceptor = createPrefixedRequestIdInterceptor('svc', {
+            propagate: true,
+        });
+        const envelope = createEnvelope('test', { 'x-request-id': 'existing-id' });
+        const ctx = createTestContext();
+        await interceptor(envelope, ctx, async () => 'done');
+        // When propagating, should use existing ID
+        expect(ctx.requestId).toBe('existing-id');
+    });
+});
+describe('createCorrelatedRequestIdInterceptor', () => {
+    it('should track correlation ID in tracing context', async () => {
+        const interceptor = createCorrelatedRequestIdInterceptor();
+        const envelope = createEnvelope('test', {
+            'x-correlation-id': 'correlation-123',
+        });
+        const ctx = createTestContext();
+        ctx.tracing = { traceId: '', spanId: '' };
+        await interceptor(envelope, ctx, async () => 'done');
+        // Correlation ID is stored as traceId
+        expect(ctx.tracing?.traceId).toBe('correlation-123');
+    });
+    it('should generate correlation ID if not present', async () => {
+        const interceptor = createCorrelatedRequestIdInterceptor();
+        const envelope = createEnvelope('test');
+        const ctx = createTestContext();
+        ctx.tracing = { traceId: '', spanId: '' };
+        await interceptor(envelope, ctx, async () => 'done');
+        // When no correlation ID, request ID becomes both
+        expect(ctx.requestId).toBeDefined();
+        expect(ctx.requestId.length).toBeGreaterThan(0);
+    });
+    it('should set correlation ID in metadata for propagation', async () => {
+        const interceptor = createCorrelatedRequestIdInterceptor();
+        const envelope = createEnvelope('test');
+        const ctx = createTestContext();
+        ctx.tracing = { traceId: '', spanId: '' };
+        await interceptor(envelope, ctx, async () => 'done');
+        expect(envelope.metadata['x-correlation-id']).toBeDefined();
+        expect(envelope.metadata['x-request-id']).toBe(ctx.requestId);
+    });
+    it('should use custom correlation key', async () => {
+        const interceptor = createCorrelatedRequestIdInterceptor({
+            correlationKey: 'x-trace-correlation',
+        });
+        const envelope = createEnvelope('test', {
+            'x-trace-correlation': 'my-correlation',
+        });
+        const ctx = createTestContext();
+        ctx.tracing = { traceId: '', spanId: '' };
+        await interceptor(envelope, ctx, async () => 'done');
+        expect(ctx.tracing?.traceId).toBe('my-correlation');
+    });
+});
+//# sourceMappingURL=request-id.int.test.js.map

package/dist/middleware/interceptors/request-id.int.test.js.map

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

package/dist/middleware/interceptors/request-id.js

@@ -0,0 +1,119 @@
+/**
+ * Request ID Interceptor
+ *
+ * Ensures every request has a unique ID for tracing and debugging.
+ * Propagates IDs from incoming requests or generates new ones.
+ */
+import { sid } from '../../utils/id/index.js';
+/**
+ * Create a request ID interceptor
+ *
+ * This interceptor ensures every request has a unique ID that can be used
+ * for distributed tracing, logging, and debugging.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - generates nanoid for each request
+ * const requestId = createRequestIdInterceptor()
+ *
+ * // Custom generator
+ * const requestId = createRequestIdInterceptor({
+ *   generator: () => `req_${Date.now()}_${Math.random().toString(36).slice(2)}`,
+ * })
+ *
+ * // Propagate from incoming metadata
+ * const requestId = createRequestIdInterceptor({
+ *   propagate: true,
+ *   metadataKey: 'x-request-id',
+ * })
+ *
+ * server.use(requestId)
+ * ```
+ */
+export function createRequestIdInterceptor(config = {}) {
+    const { generator = () => sid(), propagate = true, metadataKey = 'x-request-id', } = config;
+    return async (envelope, ctx, next) => {
+        let requestId;
+        // Try to propagate from incoming metadata
+        if (propagate) {
+            const incomingId = envelope.metadata[metadataKey] || envelope.metadata[metadataKey.toLowerCase()];
+            if (incomingId) {
+                requestId = incomingId;
+            }
+            else {
+                requestId = generator();
+            }
+        }
+        else {
+            requestId = generator();
+        }
+        // Update context with the request ID
+        // Note: Context is immutable, but we can update the requestId since
+        // it's the same request flow
+        ;
+        ctx.requestId = requestId;
+        // Update tracing context
+        if (ctx.tracing) {
+            ;
+            ctx.tracing.traceId = ctx.tracing.traceId || requestId;
+            ctx.tracing.spanId = requestId;
+        }
+        // Store in envelope metadata for propagation
+        envelope.metadata[metadataKey] = requestId;
+        // Also set the trace ID for distributed tracing
+        if (!envelope.metadata['x-trace-id']) {
+            envelope.metadata['x-trace-id'] = ctx.tracing?.traceId || requestId;
+        }
+        return next();
+    };
+}
+/**
+ * Create a request ID interceptor with prefix
+ *
+ * Useful for identifying requests from specific services or environments.
+ *
+ * @example
+ * ```typescript
+ * const requestId = createPrefixedRequestIdInterceptor('api')
+ * // Generates IDs like: api_V1StGXR8_Z5jdHi6B-myT
+ * ```
+ */
+export function createPrefixedRequestIdInterceptor(prefix, config = {}) {
+    return createRequestIdInterceptor({
+        ...config,
+        generator: () => `${prefix}_${sid()}`,
+    });
+}
+/**
+ * Create a request ID interceptor with correlation ID support
+ *
+ * Supports both request ID (per-request) and correlation ID (per-user-action).
+ *
+ * @example
+ * ```typescript
+ * const requestId = createCorrelatedRequestIdInterceptor({
+ *   correlationKey: 'x-correlation-id',
+ * })
+ * ```
+ */
+export function createCorrelatedRequestIdInterceptor(config = {}) {
+    const { correlationKey = 'x-correlation-id', requestIdKey = 'x-request-id', } = config;
+    return async (envelope, ctx, next) => {
+        // Generate or propagate request ID (always unique per request)
+        const requestId = envelope.metadata[requestIdKey] || sid();
+        // Propagate or generate correlation ID (shared across related requests)
+        const correlationId = envelope.metadata[correlationKey] || requestId;
+        ctx.requestId = requestId;
+        // Update tracing with correlation ID as trace ID
+        if (ctx.tracing) {
+            ;
+            ctx.tracing.traceId = correlationId;
+            ctx.tracing.spanId = requestId;
+        }
+        // Store in metadata for propagation
+        envelope.metadata[requestIdKey] = requestId;
+        envelope.metadata[correlationKey] = correlationId;
+        return next();
+    };
+}
+//# sourceMappingURL=request-id.js.map

package/dist/middleware/interceptors/request-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-id.js","sourceRoot":"","sources":["../../../src/middleware/interceptors/request-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAA;AAI7C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,0BAA0B,CAAC,SAA0B,EAAE;IACrE,MAAM,EACJ,SAAS,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,EACvB,SAAS,GAAG,IAAI,EAChB,WAAW,GAAG,cAAc,GAC7B,GAAG,MAAM,CAAA;IAEV,OAAO,KAAK,EAAE,QAAkB,EAAE,GAAY,EAAE,IAA4B,EAAE,EAAE;QAC9E,IAAI,SAAiB,CAAA;QAErB,0CAA0C;QAC1C,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAA;YAEjG,IAAI,UAAU,EAAE,CAAC;gBACf,SAAS,GAAG,UAAU,CAAA;YACxB,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,SAAS,EAAE,CAAA;YACzB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,SAAS,GAAG,SAAS,EAAE,CAAA;QACzB,CAAC;QAED,qCAAqC;QACrC,oEAAoE;QACpE,6BAA6B;QAC7B,CAAC;QAAC,GAAW,CAAC,SAAS,GAAG,SAAS,CAAA;QAEnC,yBAAyB;QACzB,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,CAAC;YAAC,GAAG,CAAC,OAAe,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,SAAS,CAC/D;YAAC,GAAG,CAAC,OAAe,CAAC,MAAM,GAAG,SAAS,CAAA;QAC1C,CAAC;QAED,6CAA6C;QAC7C,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,SAAS,CAAA;QAE1C,gDAAgD;QAChD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,OAAO,IAAI,SAAS,CAAA;QACrE,CAAC;QAED,OAAO,IAAI,EAAE,CAAA;IACf,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kCAAkC,CAChD,MAAc,EACd,SAA6C,EAAE;IAE/C,OAAO,0BAA0B,CAAC;QAChC,GAAG,MAAM;QACT,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,EAAE;KACtC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oCAAoC,CAAC,SAGjD,EAAE;IACJ,MAAM,EACJ,cAAc,GAAG,kBAAkB,EACnC,YAAY,GAAG,cAAc,GAC9B,GAAG,MAAM,CAAA;IAEV,OAAO,KAAK,EAAE,QAAkB,EAAE,GAAY,EAAE,IAA4B,EAAE,EAAE;QAC9E,+DAA+D;QAC/D,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,GAAG,EAAE,CAAA;QAE1D,wEAAwE;QACxE,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,SAAS,CAGnE;QAAC,GAAW,CAAC,SAAS,GAAG,SAAS,CAAA;QAEnC,iDAAiD;QACjD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,CAAC;YAAC,GAAG,CAAC,OAAe,CAAC,OAAO,GAAG,aAAa,CAC5C;YAAC,GAAG,CAAC,OAAe,CAAC,MAAM,GAAG,SAAS,CAAA;QAC1C,CAAC;QAED,oCAAoC;QACpC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS,CAAA;QAC3C,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,aAAa,CAAA;QAEjD,OAAO,IAAI,EAAE,CAAA;IACf,CAAC,CAAA;AACH,CAAC"}

package/dist/middleware/interceptors/retry.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Retry Interceptor
+ *
+ * Protocol-agnostic retry logic with multiple backoff strategies.
+ * Handles transient failures gracefully.
+ *
+ * Strategies:
+ * - `linear`: delay grows linearly (100, 200, 300...)
+ * - `exponential`: delay doubles each attempt (100, 200, 400...)
+ * - `decorrelated`: AWS-style jitter, prevents thundering herd
+ */
+import type { Interceptor } from '../../types/index.js';
+import type { RetryConfig } from '../types.js';
+/**
+ * Parse Retry-After header value
+ *
+ * Supports two formats:
+ * - Seconds: "120" → 120000ms
+ * - HTTP-date: "Wed, 21 Oct 2015 07:28:00 GMT" → ms until that time
+ *
+ * @returns Delay in milliseconds, or undefined if invalid
+ */
+export declare function parseRetryAfter(value: string | number | null | undefined): number | undefined;
+/**
+ * Create a retry interceptor
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with defaults
+ * const retry = createRetryInterceptor()
+ *
+ * // Custom retry configuration
+ * const retry = createRetryInterceptor({
+ *   maxAttempts: 5,
+ *   initialDelayMs: 200,
+ *   maxDelayMs: 5000,
+ *   backoffStrategy: 'exponential',
+ * })
+ *
+ * // Decorrelated jitter (AWS-style, best for preventing thundering herd)
+ * const retry = createRetryInterceptor({
+ *   backoffStrategy: 'decorrelated',
+ *   maxAttempts: 5,
+ * })
+ *
+ * // With retry hook for observability
+ * const retry = createRetryInterceptor({
+ *   onRetry: ({ attempt, error, delayMs, procedure }) => {
+ *     logger.warn({ attempt, procedure, delayMs }, `Retrying: ${error.message}`)
+ *   }
+ * })
+ *
+ * // Custom retry predicate
+ * const retry = createRetryInterceptor({
+ *   shouldRetry: (error, attempt) => {
+ *     // Only retry specific errors
+ *     return error.code === 'UNAVAILABLE' && attempt < 3
+ *   }
+ * })
+ *
+ * server.use(retry)
+ * ```
+ */
+export declare function createRetryInterceptor(config?: RetryConfig): Interceptor;
+/**
+ * Create a retry interceptor for specific procedures
+ *
+ * @example
+ * ```typescript
+ * const retry = createSelectiveRetryInterceptor({
+ *   procedures: ['external.api.*', 'payment.*'],
+ *   config: { maxAttempts: 5 }
+ * })
+ * ```
+ */
+export declare function createSelectiveRetryInterceptor(options: {
+    procedures: string[];
+    config?: RetryConfig;
+}): Interceptor;
+//# sourceMappingURL=retry.d.ts.map

package/dist/middleware/interceptors/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/middleware/interceptors/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAsC,MAAM,aAAa,CAAA;AAqBlF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAwB7F;AAyFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,WAAgB,GAAG,WAAW,CAmH5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE;IACvD,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,GAAG,WAAW,CA2Bd"}

package/dist/middleware/interceptors/retry.int.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Retry Interceptor Tests
+ */
+export {};
+//# sourceMappingURL=retry.int.test.d.ts.map

package/dist/middleware/interceptors/retry.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.int.test.d.ts","sourceRoot":"","sources":["../../../src/middleware/interceptors/retry.int.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}