raffel 0.1.2

package/dist/middleware/presets.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Middleware Presets
+ *
+ * Pre-configured middleware combinations for common use cases.
+ */
+import type { Interceptor } from '../types/index.js';
+import type { RateLimitConfig, LoggingConfig, TimeoutConfig, RetryConfig, CircuitBreakerConfig } from './types.js';
+import type { ExtendedCacheConfig } from './interceptors/cache.js';
+/**
+ * Standard middleware stack for production APIs
+ *
+ * Includes: request ID, logging, timeout, rate limiting
+ *
+ * @example
+ * ```typescript
+ * const middleware = createProductionStack()
+ * server.use(middleware)
+ * ```
+ */
+export declare function createProductionStack(config?: {
+    rateLimit?: RateLimitConfig;
+    timeout?: TimeoutConfig;
+    logging?: LoggingConfig;
+}): Interceptor;
+/**
+ * Development middleware stack with verbose logging
+ *
+ * @example
+ * ```typescript
+ * const middleware = createDevelopmentStack()
+ * server.use(middleware)
+ * ```
+ */
+export declare function createDevelopmentStack(config?: {
+    rateLimit?: RateLimitConfig;
+    timeout?: TimeoutConfig;
+}): Interceptor;
+/**
+ * Resilient middleware stack for external service calls
+ *
+ * Includes: retry, circuit breaker, timeout
+ *
+ * @example
+ * ```typescript
+ * const resilient = createResilientStack()
+ * server.procedure('external.call').use(resilient).handler(...)
+ * ```
+ */
+export declare function createResilientStack(config?: {
+    retry?: RetryConfig;
+    circuitBreaker?: CircuitBreakerConfig;
+    timeout?: TimeoutConfig;
+}): Interceptor;
+/**
+ * Minimal middleware stack
+ *
+ * Just request ID and basic timeout. For high-performance scenarios.
+ *
+ * @example
+ * ```typescript
+ * const minimal = createMinimalStack()
+ * server.use(minimal)
+ * ```
+ */
+export declare function createMinimalStack(config?: {
+    timeoutMs?: number;
+}): Interceptor;
+/**
+ * Rate limiting presets
+ */
+export declare const rateLimitPresets: {
+    /**
+     * Strict rate limiting (10 requests per minute)
+     */
+    strict: RateLimitConfig;
+    /**
+     * Standard rate limiting (100 requests per minute)
+     */
+    standard: RateLimitConfig;
+    /**
+     * Relaxed rate limiting (1000 requests per minute)
+     */
+    relaxed: RateLimitConfig;
+    /**
+     * Burst-friendly (high limit with short window)
+     */
+    burst: RateLimitConfig;
+    /**
+     * Per-user with higher limits
+     */
+    authenticated: RateLimitConfig;
+};
+/**
+ * Timeout presets
+ */
+export declare const timeoutPresets: {
+    /**
+     * Fast timeout (5 seconds)
+     */
+    fast: TimeoutConfig;
+    /**
+     * Standard timeout (30 seconds)
+     */
+    standard: TimeoutConfig;
+    /**
+     * Long timeout (2 minutes)
+     */
+    long: TimeoutConfig;
+    /**
+     * Mixed - fast default with long for specific procedures
+     */
+    mixed: TimeoutConfig;
+};
+/**
+ * Circuit breaker presets
+ */
+export declare const circuitBreakerPresets: {
+    /**
+     * Sensitive - opens quickly (3 failures)
+     */
+    sensitive: CircuitBreakerConfig;
+    /**
+     * Standard - balanced (5 failures)
+     */
+    standard: CircuitBreakerConfig;
+    /**
+     * Tolerant - allows more failures (10)
+     */
+    tolerant: CircuitBreakerConfig;
+};
+/**
+ * Retry presets
+ */
+export declare const retryPresets: {
+    /**
+     * Quick retry (2 attempts, fast backoff)
+     */
+    quick: RetryConfig;
+    /**
+     * Standard retry (3 attempts)
+     */
+    standard: RetryConfig;
+    /**
+     * Aggressive retry (5 attempts with longer delays)
+     */
+    aggressive: RetryConfig;
+};
+/**
+ * Cache presets (re-exported from interceptors)
+ */
+export declare const cachePresets: {
+    /**
+     * Short-lived cache (5 seconds) for frequently changing data
+     */
+    short: ExtendedCacheConfig;
+    /**
+     * Standard cache (1 minute) for general purpose
+     */
+    standard: ExtendedCacheConfig;
+    /**
+     * Long-lived cache (5 minutes) for stable data
+     */
+    long: ExtendedCacheConfig;
+    /**
+     * Aggressive cache (1 hour) for rarely changing data
+     */
+    aggressive: ExtendedCacheConfig;
+    /**
+     * No stale - strict TTL without SWR
+     */
+    strict: ExtendedCacheConfig;
+};
+/**
+ * Security presets (HTTP-specific)
+ */
+export declare const securityPresets: {
+    strict: import("./types.js").SecurityConfig;
+    recommended: import("./types.js").SecurityConfig;
+    relaxed: import("./types.js").SecurityConfig;
+};
+/**
+ * Get a complete middleware stack based on environment
+ *
+ * @example
+ * ```typescript
+ * const stack = getEnvironmentStack('production')
+ * server.use(stack)
+ * ```
+ */
+export declare function getEnvironmentStack(env: 'development' | 'staging' | 'production'): Interceptor;
+/**
+ * Create a custom middleware stack from preset configurations
+ *
+ * @example
+ * ```typescript
+ * const stack = createCustomStack({
+ *   rateLimit: 'strict',
+ *   timeout: 'fast',
+ *   circuitBreaker: 'sensitive',
+ *   retry: 'quick',
+ *   cache: 'standard',
+ * })
+ * ```
+ */
+export declare function createCustomStack(config: {
+    rateLimit?: keyof typeof rateLimitPresets | RateLimitConfig;
+    timeout?: keyof typeof timeoutPresets | TimeoutConfig;
+    circuitBreaker?: keyof typeof circuitBreakerPresets | CircuitBreakerConfig;
+    retry?: keyof typeof retryPresets | RetryConfig;
+    cache?: keyof typeof cachePresets | ExtendedCacheConfig;
+    includeRequestId?: boolean;
+    includeLogging?: boolean | 'production' | 'debug';
+}): Interceptor;
+//# sourceMappingURL=presets.d.ts.map

package/dist/middleware/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/middleware/presets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAiBpD,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,WAAW,EACX,oBAAoB,EACrB,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AASlE;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE;IAC7C,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB,GAAG,WAAW,CAOd;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE;IAC9C,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB,GAAG,WAAW,CAWd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE;IAC5C,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,cAAc,CAAC,EAAE,oBAAoB,CAAA;IACrC,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB,GAAG,WAAW,CAMd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,WAAW,CAKd;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;YAIE,eAAe;IAEpB;;OAEG;cAIE,eAAe;IAEpB;;OAEG;aAIE,eAAe;IAEpB;;OAEG;WAIE,eAAe;IAEpB;;OAEG;mBAKE,eAAe;CACrB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;UAGE,aAAa;IAElB;;OAEG;cAGE,aAAa;IAElB;;OAEG;UAGE,aAAa;IAElB;;OAEG;WAQE,aAAa;CACnB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC;;OAEG;eAKE,oBAAoB;IAEzB;;OAEG;cAKE,oBAAoB;IAEzB;;OAEG;cAKE,oBAAoB;CAC1B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;WAME,WAAW;IAEhB;;OAEG;cAME,WAAW;IAEhB;;OAEG;gBAOE,WAAW;CACjB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEJ,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;CAI3B,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,GAC5C,WAAW,CAgBb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,SAAS,CAAC,EAAE,MAAM,OAAO,gBAAgB,GAAG,eAAe,CAAA;IAC3D,OAAO,CAAC,EAAE,MAAM,OAAO,cAAc,GAAG,aAAa,CAAA;IACrD,cAAc,CAAC,EAAE,MAAM,OAAO,qBAAqB,GAAG,oBAAoB,CAAA;IAC1E,KAAK,CAAC,EAAE,MAAM,OAAO,YAAY,GAAG,WAAW,CAAA;IAC/C,KAAK,CAAC,EAAE,MAAM,OAAO,YAAY,GAAG,mBAAmB,CAAA;IACvD,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,cAAc,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,OAAO,CAAA;CAClD,GAAG,WAAW,CAwDd"}

package/dist/middleware/presets.js

@@ -0,0 +1,329 @@
+/**
+ * Middleware Presets
+ *
+ * Pre-configured middleware combinations for common use cases.
+ */
+import { compose } from './compose.js';
+// Interceptors
+import { createRateLimitInterceptor, createRequestIdInterceptor, createLoggingInterceptor, createProductionLoggingInterceptor, createTimeoutInterceptor, createRetryInterceptor, createCircuitBreakerInterceptor, createCacheInterceptor, CachePresets, } from './interceptors/index.js';
+// HTTP
+import { defaultSecurityConfig, strictSecurityConfig, relaxedSecurityConfig, } from './http/index.js';
+/**
+ * Standard middleware stack for production APIs
+ *
+ * Includes: request ID, logging, timeout, rate limiting
+ *
+ * @example
+ * ```typescript
+ * const middleware = createProductionStack()
+ * server.use(middleware)
+ * ```
+ */
+export function createProductionStack(config) {
+    return compose(createRequestIdInterceptor(), createProductionLoggingInterceptor({ logger: config?.logging?.logger }), createTimeoutInterceptor(config?.timeout), createRateLimitInterceptor(config?.rateLimit));
+}
+/**
+ * Development middleware stack with verbose logging
+ *
+ * @example
+ * ```typescript
+ * const middleware = createDevelopmentStack()
+ * server.use(middleware)
+ * ```
+ */
+export function createDevelopmentStack(config) {
+    return compose(createRequestIdInterceptor(), createLoggingInterceptor({
+        format: 'pretty',
+        includePayload: true,
+        includeResponse: true,
+    }), createTimeoutInterceptor(config?.timeout ?? { defaultMs: 60000 }), createRateLimitInterceptor(config?.rateLimit ?? { maxRequests: 1000 }));
+}
+/**
+ * Resilient middleware stack for external service calls
+ *
+ * Includes: retry, circuit breaker, timeout
+ *
+ * @example
+ * ```typescript
+ * const resilient = createResilientStack()
+ * server.procedure('external.call').use(resilient).handler(...)
+ * ```
+ */
+export function createResilientStack(config) {
+    return compose(createTimeoutInterceptor(config?.timeout ?? { defaultMs: 10000 }), createCircuitBreakerInterceptor(config?.circuitBreaker), createRetryInterceptor(config?.retry));
+}
+/**
+ * Minimal middleware stack
+ *
+ * Just request ID and basic timeout. For high-performance scenarios.
+ *
+ * @example
+ * ```typescript
+ * const minimal = createMinimalStack()
+ * server.use(minimal)
+ * ```
+ */
+export function createMinimalStack(config) {
+    return compose(createRequestIdInterceptor(), createTimeoutInterceptor({ defaultMs: config?.timeoutMs ?? 30000 }));
+}
+/**
+ * Rate limiting presets
+ */
+export const rateLimitPresets = {
+    /**
+     * Strict rate limiting (10 requests per minute)
+     */
+    strict: {
+        windowMs: 60000,
+        maxRequests: 10,
+    },
+    /**
+     * Standard rate limiting (100 requests per minute)
+     */
+    standard: {
+        windowMs: 60000,
+        maxRequests: 100,
+    },
+    /**
+     * Relaxed rate limiting (1000 requests per minute)
+     */
+    relaxed: {
+        windowMs: 60000,
+        maxRequests: 1000,
+    },
+    /**
+     * Burst-friendly (high limit with short window)
+     */
+    burst: {
+        windowMs: 10000, // 10 seconds
+        maxRequests: 100,
+    },
+    /**
+     * Per-user with higher limits
+     */
+    authenticated: {
+        windowMs: 60000,
+        maxRequests: 500,
+        keyGenerator: (envelope, ctx) => ctx.auth?.principal ?? 'anonymous',
+    },
+};
+/**
+ * Timeout presets
+ */
+export const timeoutPresets = {
+    /**
+     * Fast timeout (5 seconds)
+     */
+    fast: {
+        defaultMs: 5000,
+    },
+    /**
+     * Standard timeout (30 seconds)
+     */
+    standard: {
+        defaultMs: 30000,
+    },
+    /**
+     * Long timeout (2 minutes)
+     */
+    long: {
+        defaultMs: 120000,
+    },
+    /**
+     * Mixed - fast default with long for specific procedures
+     */
+    mixed: {
+        defaultMs: 10000,
+        patterns: {
+            'reports.**': 60000,
+            'export.*': 120000,
+            'import.*': 180000,
+        },
+    },
+};
+/**
+ * Circuit breaker presets
+ */
+export const circuitBreakerPresets = {
+    /**
+     * Sensitive - opens quickly (3 failures)
+     */
+    sensitive: {
+        failureThreshold: 3,
+        successThreshold: 2,
+        resetTimeoutMs: 30000,
+    },
+    /**
+     * Standard - balanced (5 failures)
+     */
+    standard: {
+        failureThreshold: 5,
+        successThreshold: 3,
+        resetTimeoutMs: 30000,
+    },
+    /**
+     * Tolerant - allows more failures (10)
+     */
+    tolerant: {
+        failureThreshold: 10,
+        successThreshold: 5,
+        resetTimeoutMs: 60000,
+    },
+};
+/**
+ * Retry presets
+ */
+export const retryPresets = {
+    /**
+     * Quick retry (2 attempts, fast backoff)
+     */
+    quick: {
+        maxAttempts: 2,
+        initialDelayMs: 50,
+        maxDelayMs: 500,
+        backoffMultiplier: 2,
+    },
+    /**
+     * Standard retry (3 attempts)
+     */
+    standard: {
+        maxAttempts: 3,
+        initialDelayMs: 100,
+        maxDelayMs: 5000,
+        backoffMultiplier: 2,
+    },
+    /**
+     * Aggressive retry (5 attempts with longer delays)
+     */
+    aggressive: {
+        maxAttempts: 5,
+        initialDelayMs: 200,
+        maxDelayMs: 30000,
+        backoffMultiplier: 2,
+        jitter: true,
+    },
+};
+/**
+ * Cache presets (re-exported from interceptors)
+ */
+export const cachePresets = {
+    /**
+     * Short-lived cache (5 seconds) for frequently changing data
+     */
+    short: CachePresets.short,
+    /**
+     * Standard cache (1 minute) for general purpose
+     */
+    standard: CachePresets.standard,
+    /**
+     * Long-lived cache (5 minutes) for stable data
+     */
+    long: CachePresets.long,
+    /**
+     * Aggressive cache (1 hour) for rarely changing data
+     */
+    aggressive: CachePresets.aggressive,
+    /**
+     * No stale - strict TTL without SWR
+     */
+    strict: CachePresets.strict,
+};
+/**
+ * Security presets (HTTP-specific)
+ */
+export const securityPresets = {
+    strict: strictSecurityConfig,
+    recommended: defaultSecurityConfig,
+    relaxed: relaxedSecurityConfig,
+};
+/**
+ * Get a complete middleware stack based on environment
+ *
+ * @example
+ * ```typescript
+ * const stack = getEnvironmentStack('production')
+ * server.use(stack)
+ * ```
+ */
+export function getEnvironmentStack(env) {
+    switch (env) {
+        case 'development':
+            return createDevelopmentStack();
+        case 'staging':
+            return createProductionStack({
+                rateLimit: rateLimitPresets.relaxed,
+                timeout: timeoutPresets.long,
+            });
+        case 'production':
+        default:
+            return createProductionStack({
+                rateLimit: rateLimitPresets.standard,
+                timeout: timeoutPresets.standard,
+            });
+    }
+}
+/**
+ * Create a custom middleware stack from preset configurations
+ *
+ * @example
+ * ```typescript
+ * const stack = createCustomStack({
+ *   rateLimit: 'strict',
+ *   timeout: 'fast',
+ *   circuitBreaker: 'sensitive',
+ *   retry: 'quick',
+ *   cache: 'standard',
+ * })
+ * ```
+ */
+export function createCustomStack(config) {
+    const interceptors = [];
+    // Request ID (default: on)
+    if (config.includeRequestId !== false) {
+        interceptors.push(createRequestIdInterceptor());
+    }
+    // Logging
+    if (config.includeLogging === true || config.includeLogging === 'debug') {
+        interceptors.push(createLoggingInterceptor({ format: 'pretty' }));
+    }
+    else if (config.includeLogging === 'production') {
+        interceptors.push(createProductionLoggingInterceptor());
+    }
+    // Timeout
+    if (config.timeout) {
+        const timeoutConfig = typeof config.timeout === 'string'
+            ? timeoutPresets[config.timeout]
+            : config.timeout;
+        interceptors.push(createTimeoutInterceptor(timeoutConfig));
+    }
+    // Cache (before rate limit to serve cached responses without counting)
+    if (config.cache) {
+        const cacheConfig = typeof config.cache === 'string'
+            ? cachePresets[config.cache]
+            : config.cache;
+        interceptors.push(createCacheInterceptor(cacheConfig));
+    }
+    // Rate Limit
+    if (config.rateLimit) {
+        const rateLimitConfig = typeof config.rateLimit === 'string'
+            ? rateLimitPresets[config.rateLimit]
+            : config.rateLimit;
+        interceptors.push(createRateLimitInterceptor(rateLimitConfig));
+    }
+    // Circuit Breaker
+    if (config.circuitBreaker) {
+        const cbConfig = typeof config.circuitBreaker === 'string'
+            ? circuitBreakerPresets[config.circuitBreaker]
+            : config.circuitBreaker;
+        interceptors.push(createCircuitBreakerInterceptor(cbConfig));
+    }
+    // Retry
+    if (config.retry) {
+        const retryConfig = typeof config.retry === 'string'
+            ? retryPresets[config.retry]
+            : config.retry;
+        interceptors.push(createRetryInterceptor(retryConfig));
+    }
+    return compose(...interceptors);
+}
+//# sourceMappingURL=presets.js.map

package/dist/middleware/presets.js.map

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

package/dist/middleware/rate-limit.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Rate Limiting Middleware
+ *
+ * Protects services from abuse with configurable rate limiting.
+ * Supports sliding window algorithm with in-memory or custom stores.
+ */
+import type { Interceptor, Envelope, Context } from '../types/index.js';
+/**
+ * Rate limit configuration
+ */
+export interface RateLimitOptions {
+    /** Maximum requests allowed in the window */
+    limit: number;
+    /** Window size in milliseconds (default: 60000 = 1 minute) */
+    windowMs?: number;
+    /** Function to extract the rate limit key (default: uses principal or IP) */
+    keyExtractor?: (envelope: Envelope, ctx: Context) => string;
+    /** Custom store for distributed rate limiting */
+    store?: RateLimitStore;
+    /** Handler for rate limit exceeded (default: throws RATE_LIMITED error) */
+    onLimitReached?: (envelope: Envelope, ctx: Context, info: RateLimitInfo) => void | Promise<void>;
+    /** Skip rate limiting for certain requests */
+    skip?: (envelope: Envelope, ctx: Context) => boolean | Promise<boolean>;
+    /** Procedures to skip rate limiting */
+    skipProcedures?: string[];
+    /** Custom headers to include in response metadata */
+    includeHeaders?: boolean;
+}
+/**
+ * Rate limit information
+ */
+export interface RateLimitInfo {
+    /** Total limit for the window */
+    limit: number;
+    /** Remaining requests in the window */
+    remaining: number;
+    /** Timestamp when the window resets (ms since epoch) */
+    resetAt: number;
+    /** Whether the limit was exceeded */
+    exceeded: boolean;
+}
+/**
+ * Store interface for rate limit state
+ */
+export interface RateLimitStore {
+    /** Increment the counter and return current count + TTL info */
+    increment(key: string, windowMs: number): Promise<{
+        count: number;
+        resetAt: number;
+    }>;
+    /** Get current count for a key */
+    get(key: string): Promise<{
+        count: number;
+        resetAt: number;
+    } | null>;
+    /** Reset a key */
+    reset(key: string): Promise<void>;
+}
+/**
+ * Create an in-memory rate limit store
+ */
+export declare function createInMemoryStore(): RateLimitStore;
+/**
+ * Create rate limiting middleware
+ */
+export declare function createRateLimitMiddleware(options: RateLimitOptions): Interceptor;
+/**
+ * Create rate limit middleware with per-procedure limits
+ */
+export interface ProcedureRateLimit {
+    /** Procedure name or pattern (supports * and .*) */
+    procedure: string;
+    /** Maximum requests allowed in the window */
+    limit: number;
+    /** Window size in milliseconds */
+    windowMs?: number;
+}
+export interface PerProcedureRateLimitOptions extends Omit<RateLimitOptions, 'limit' | 'windowMs'> {
+    /** Rate limits per procedure */
+    limits: ProcedureRateLimit[];
+    /** Default limit for procedures not in the list */
+    defaultLimit?: {
+        limit: number;
+        windowMs?: number;
+    };
+}
+/**
+ * Create rate limit middleware with different limits per procedure
+ */
+export declare function createPerProcedureRateLimitMiddleware(options: PerProcedureRateLimitOptions): Interceptor;
+/**
+ * Sliding window rate limiter for more precise rate limiting
+ */
+export declare function createSlidingWindowRateLimiter(options: {
+    limit: number;
+    windowMs: number;
+}): {
+    check: (key: string) => {
+        allowed: boolean;
+        remaining: number;
+        resetAt: number;
+    };
+    reset: (key: string) => void;
+};
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/middleware/rate-limit.d.ts.map

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

package/dist/middleware/rate-limit.int.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Rate Limiting Middleware Tests
+ */
+export {};
+//# sourceMappingURL=rate-limit.int.test.d.ts.map

package/dist/middleware/rate-limit.int.test.d.ts.map

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