@fgrzl/fetch 1.1.0-alpha.2 → 1.1.0-alpha.7

package/dist/middleware/index.js

@@ -0,0 +1,134 @@
+/**
+ * @fileoverview Complete middleware collection for FetchClient - "pit of success" APIs.
+ *
+ * This module provides a comprehensive set of middleware for common HTTP client concerns:
+ * - 🔐 Authentication: Bearer token injection
+ * - 🛡️ Authorization: 401/403 response handling
+ * - 💾 Cache: Response caching with TTL
+ * - 🔒 CSRF: Cross-site request forgery protection
+ * - 📝 Logging: Request/response logging
+ * - 🚦 Rate Limiting: Request rate limiting with token bucket
+ * - 🔄 Retry: Automatic retry with backoff
+ *
+ * Each middleware follows the "pit of success" pattern with:
+ * - Smart defaults for common scenarios
+ * - Simple `use{Middleware}()` convenience functions
+ * - Advanced `create{Middleware}Middleware()` for custom scenarios
+ * - Comprehensive TypeScript support
+ *
+ * @example Quick setup with multiple middleware:
+ * ```typescript
+ * import { FetchClient } from '@fgrzl/fetch';
+ * import { useAuthentication, useRetry, useLogging } from '@fgrzl/fetch/middleware';
+ *
+ * const client = new FetchClient();
+ * const enhancedClient = useAuthentication(client, {
+ *   tokenProvider: () => localStorage.getItem('auth-token') || ''
+ * })
+ * .pipe(useRetry, { retries: 3 })
+ * .pipe(useLogging);
+ * ```
+ */
+export { useAuthentication, createAuthenticationMiddleware, } from './authentication';
+export { useAuthorization, createAuthorizationMiddleware, } from './authorization';
+export { useCache, createCacheMiddleware } from './cache';
+// 🔒 CSRF middleware
+export { useCSRF } from './csrf';
+export { useLogging, createLoggingMiddleware } from './logging';
+export { useRateLimit, createRateLimitMiddleware } from './rate-limit';
+export { useRetry, createRetryMiddleware } from './retry';
+import { useAuthentication } from './authentication';
+import { useRetry } from './retry';
+import { useLogging } from './logging';
+import { useCache } from './cache';
+import { useRateLimit } from './rate-limit';
+/**
+ * Production-ready middleware stack with authentication, retry, logging, and caching.
+ * Perfect for API clients that need reliability and observability.
+ *
+ * @param client - The FetchClient to enhance
+ * @param config - Configuration for each middleware
+ * @returns Enhanced FetchClient with production middleware stack
+ *
+ * @example
+ * ```typescript
+ * const apiClient = useProductionStack(new FetchClient(), {
+ *   auth: { tokenProvider: () => getAuthToken() },
+ *   cache: { ttl: 5 * 60 * 1000 }, // 5 minutes
+ *   logging: { level: 'info' }
+ * });
+ * ```
+ */
+export function useProductionStack(client, config = {}) {
+    let enhanced = client;
+    // Apply middleware in order: auth → cache → retry → rate-limit → logging
+    if (config.auth) {
+        enhanced = useAuthentication(enhanced, config.auth);
+    }
+    if (config.cache !== undefined) {
+        enhanced = useCache(enhanced, config.cache);
+    }
+    if (config.retry !== undefined) {
+        enhanced = useRetry(enhanced, config.retry);
+    }
+    if (config.rateLimit !== undefined) {
+        enhanced = useRateLimit(enhanced, config.rateLimit);
+    }
+    if (config.logging !== undefined) {
+        enhanced = useLogging(enhanced, config.logging);
+    }
+    return enhanced;
+}
+/**
+ * Development-friendly middleware stack with comprehensive logging and retries.
+ * Perfect for local development and debugging.
+ *
+ * @param client - The FetchClient to enhance
+ * @param config - Configuration for development middleware
+ * @returns Enhanced FetchClient with development middleware stack
+ *
+ * @example
+ * ```typescript
+ * const devClient = useDevelopmentStack(new FetchClient(), {
+ *   auth: { tokenProvider: () => 'dev-token' }
+ * });
+ * ```
+ */
+export function useDevelopmentStack(client, config = {}) {
+    let enhanced = client;
+    if (config.auth) {
+        enhanced = useAuthentication(enhanced, config.auth);
+    }
+    // Development-optimized settings
+    enhanced = useRetry(enhanced, {
+        maxRetries: 1,
+        delay: 100,
+    });
+    enhanced = useLogging(enhanced, {
+        level: 'debug',
+        includeRequestHeaders: true,
+        includeResponseHeaders: true,
+        includeRequestBody: true,
+        includeResponseBody: true,
+    });
+    return enhanced;
+}
+/**
+ * Basic middleware stack with just authentication and retry.
+ * Perfect for simple API clients that need minimal overhead.
+ *
+ * @param client - The FetchClient to enhance
+ * @param config - Basic configuration
+ * @returns Enhanced FetchClient with basic middleware stack
+ *
+ * @example
+ * ```typescript
+ * const basicClient = useBasicStack(new FetchClient(), {
+ *   auth: { tokenProvider: () => getToken() }
+ * });
+ * ```
+ */
+export function useBasicStack(client, config) {
+    return useRetry(useAuthentication(client, config.auth), { maxRetries: 2 });
+}
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

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

package/dist/middleware/logging/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Logging middleware - "pit of success" API.
+ */
+import type { FetchClient } from '../../client/fetch-client';
+import type { LoggingOptions } from './types';
+export type { LoggingOptions, Logger, LogEntry, LogLevel } from './types';
+export { createLoggingMiddleware } from './logging';
+/**
+ * "Pit of success" API for adding logging to a FetchClient.
+ * Logs HTTP requests and responses for debugging and monitoring.
+ *
+ * @param client - The FetchClient to add logging to
+ * @param options - Logging configuration options
+ * @returns A new FetchClient with logging middleware
+ *
+ * @example Basic logging to console:
+ * ```typescript
+ * const loggedClient = useLogging(client);
+ *
+ * // Logs: → GET /api/users
+ * // Logs: ← GET /api/users → 200 (245ms)
+ * await loggedClient.get('/api/users');
+ * ```
+ *
+ * @example Custom log level and headers:
+ * ```typescript
+ * const loggedClient = useLogging(client, {
+ *   level: 'debug',
+ *   includeRequestHeaders: true,
+ *   includeResponseHeaders: true
+ * });
+ * ```
+ *
+ * @example Skip health check endpoints:
+ * ```typescript
+ * const loggedClient = useLogging(client, {
+ *   skipPatterns: ['/health', '/metrics', '/ping']
+ * });
+ * ```
+ */
+export declare function useLogging(client: FetchClient, options?: LoggingOptions): FetchClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/middleware/logging/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,cAAmB,GAC3B,WAAW,CAEb"}

package/dist/middleware/logging/index.js

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Logging middleware - "pit of success" API.
+ */
+import { createLoggingMiddleware } from './logging';
+export { createLoggingMiddleware } from './logging';
+/**
+ * "Pit of success" API for adding logging to a FetchClient.
+ * Logs HTTP requests and responses for debugging and monitoring.
+ *
+ * @param client - The FetchClient to add logging to
+ * @param options - Logging configuration options
+ * @returns A new FetchClient with logging middleware
+ *
+ * @example Basic logging to console:
+ * ```typescript
+ * const loggedClient = useLogging(client);
+ *
+ * // Logs: → GET /api/users
+ * // Logs: ← GET /api/users → 200 (245ms)
+ * await loggedClient.get('/api/users');
+ * ```
+ *
+ * @example Custom log level and headers:
+ * ```typescript
+ * const loggedClient = useLogging(client, {
+ *   level: 'debug',
+ *   includeRequestHeaders: true,
+ *   includeResponseHeaders: true
+ * });
+ * ```
+ *
+ * @example Skip health check endpoints:
+ * ```typescript
+ * const loggedClient = useLogging(client, {
+ *   skipPatterns: ['/health', '/metrics', '/ping']
+ * });
+ * ```
+ */
+export function useLogging(client, options = {}) {
+    return client.use(createLoggingMiddleware(options));
+}
+//# sourceMappingURL=index.js.map

package/dist/middleware/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/middleware/logging/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAIpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,UAAU,CACxB,MAAmB,EACnB,UAA0B,EAAE;IAE5B,OAAO,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/middleware/logging/logging.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Logging middleware implementation.
+ */
+import type { FetchMiddleware } from '../../client/fetch-client';
+import type { LoggingOptions } from './types';
+/**
+ * Creates logging middleware with smart defaults.
+ * Logs HTTP requests and responses for debugging and monitoring.
+ *
+ * @param options - Logging configuration options
+ * @returns Logging middleware for use with FetchClient
+ *
+ * @example Basic logging:
+ * ```typescript
+ * const loggedClient = useLogging(client);
+ * // Logs all requests to console
+ * ```
+ *
+ * @example Custom logger:
+ * ```typescript
+ * const loggedClient = useLogging(client, {
+ *   logger: winston.createLogger({...}),
+ *   level: 'debug',
+ *   includeRequestHeaders: true
+ * });
+ * ```
+ */
+export declare function createLoggingMiddleware(options?: LoggingOptions): FetchMiddleware;
+//# sourceMappingURL=logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/middleware/logging/logging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAA8B,MAAM,SAAS,CAAC;AA2D1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,cAAmB,GAC3B,eAAe,CAmGjB"}

package/dist/middleware/logging/logging.js

@@ -0,0 +1,168 @@
+/**
+ * @fileoverview Logging middleware implementation.
+ */
+/**
+ * Default console logger implementation.
+ */
+const defaultLogger = {
+    // eslint-disable-next-line no-console -- allow console.debug in logger implementation
+    debug: (message, data) => console.debug(message, data),
+    // eslint-disable-next-line no-console -- allow console.info in logger implementation
+    info: (message, data) => console.info(message, data),
+    // eslint-disable-next-line no-console -- allow console.warn in logger implementation
+    warn: (message, data) => console.warn(message, data),
+    // eslint-disable-next-line no-console -- allow console.error in logger implementation
+    error: (message, data) => console.error(message, data),
+};
+/**
+ * Log level priority for filtering.
+ */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/**
+ * Default log formatter.
+ */
+const defaultFormatter = (entry) => {
+    const { method, url, status, duration } = entry;
+    let message = `${method} ${url}`;
+    if (status) {
+        message += ` → ${status}`;
+    }
+    if (duration) {
+        message += ` (${duration}ms)`;
+    }
+    return message;
+};
+/**
+ * Checks if a URL should skip logging based on configured patterns.
+ */
+function shouldSkipLogging(url, skipPatterns = []) {
+    return skipPatterns.some((pattern) => {
+        if (typeof pattern === 'string') {
+            return url.includes(pattern);
+        }
+        return pattern.test(url);
+    });
+}
+/**
+ * Creates logging middleware with smart defaults.
+ * Logs HTTP requests and responses for debugging and monitoring.
+ *
+ * @param options - Logging configuration options
+ * @returns Logging middleware for use with FetchClient
+ *
+ * @example Basic logging:
+ * ```typescript
+ * const loggedClient = useLogging(client);
+ * // Logs all requests to console
+ * ```
+ *
+ * @example Custom logger:
+ * ```typescript
+ * const loggedClient = useLogging(client, {
+ *   logger: winston.createLogger({...}),
+ *   level: 'debug',
+ *   includeRequestHeaders: true
+ * });
+ * ```
+ */
+export function createLoggingMiddleware(options = {}) {
+    const { level = 'info', logger = defaultLogger, includeRequestHeaders = false, includeResponseHeaders = false, includeRequestBody = false, includeResponseBody = false, skipPatterns = [], formatter = defaultFormatter, } = options;
+    const minLevel = LOG_LEVELS[level];
+    return async (request, next) => {
+        const url = request.url || '';
+        const method = (request.method || 'GET').toUpperCase();
+        // Skip logging if URL matches skip patterns
+        if (shouldSkipLogging(url, skipPatterns)) {
+            return next(request);
+        }
+        const startTime = Date.now();
+        // Log request start (debug level)
+        if (LOG_LEVELS.debug >= minLevel) {
+            const requestHeaders = includeRequestHeaders
+                ? getHeadersObject(request.headers)
+                : undefined;
+            const requestBody = includeRequestBody ? request.body : undefined;
+            const requestEntry = {
+                level: 'debug',
+                timestamp: startTime,
+                method,
+                url,
+                ...(requestHeaders && { requestHeaders }),
+                ...(requestBody && { requestBody }),
+            };
+            logger.debug(`→ ${formatter(requestEntry)}`, requestEntry);
+        }
+        try {
+            const response = await next(request);
+            const duration = Date.now() - startTime;
+            // Determine log level based on response status
+            const logLevel = response.status >= 400 ? 'error' : 'info';
+            // Log response (info/error level)
+            if (LOG_LEVELS[logLevel] >= minLevel) {
+                const responseHeaders = includeResponseHeaders
+                    ? getHeadersObject(response.headers)
+                    : undefined;
+                const responseBody = includeResponseBody ? response.data : undefined;
+                const responseEntry = {
+                    level: logLevel,
+                    timestamp: Date.now(),
+                    method,
+                    url,
+                    status: response.status,
+                    duration,
+                    ...(responseHeaders ? { responseHeaders } : {}),
+                    ...(responseBody !== undefined ? { responseBody } : {}),
+                };
+                const logMessage = `← ${formatter(responseEntry)}`;
+                if (logLevel === 'error') {
+                    logger.error(logMessage, responseEntry);
+                }
+                else {
+                    logger.info(logMessage, responseEntry);
+                }
+            }
+            return response;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            // Log error
+            if (LOG_LEVELS.error >= minLevel) {
+                const errorEntry = {
+                    level: 'error',
+                    timestamp: Date.now(),
+                    method,
+                    url,
+                    duration,
+                    error: error instanceof Error ? error : new Error(String(error)),
+                };
+                logger.error(`✗ ${formatter(errorEntry)}`, errorEntry);
+            }
+            throw error;
+        }
+    };
+}
+/**
+ * Convert Headers object to plain object.
+ */
+function getHeadersObject(headers) {
+    if (!headers) {
+        return undefined;
+    }
+    const obj = {};
+    if (headers instanceof Headers) {
+        headers.forEach((value, key) => {
+            obj[key] = value;
+        });
+        return obj;
+    }
+    else {
+        // It's already a Record<string, string>
+        return headers;
+    }
+}
+//# sourceMappingURL=logging.js.map

package/dist/middleware/logging/logging.js.map

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

package/dist/middleware/logging/types.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Logging middleware types and configuration.
+ */
+/**
+ * Log levels for filtering log output.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Log entry structure.
+ */
+export interface LogEntry {
+    level: LogLevel;
+    timestamp: number;
+    method: string;
+    url: string;
+    status?: number;
+    duration?: number;
+    error?: Error;
+    requestHeaders?: Record<string, string>;
+    responseHeaders?: Record<string, string>;
+    requestBody?: unknown;
+    responseBody?: unknown;
+}
+/**
+ * Custom logger interface.
+ */
+export interface Logger {
+    debug(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, data?: unknown): void;
+}
+/**
+ * Logging configuration options - optimized for "pit of success".
+ *
+ * Smart defaults:
+ * - Logs to console
+ * - Info level by default
+ * - Excludes request/response bodies by default
+ * - Includes timing information
+ */
+export interface LoggingOptions {
+    /**
+     * Minimum log level to output (default: 'info')
+     * Logs at this level and above will be output
+     */
+    level?: LogLevel;
+    /**
+     * Custom logger implementation (default: console)
+     * Can be replaced with winston, pino, etc.
+     */
+    logger?: Logger;
+    /**
+     * Include request headers in logs (default: false)
+     * May contain sensitive information
+     */
+    includeRequestHeaders?: boolean;
+    /**
+     * Include response headers in logs (default: false)
+     * May contain sensitive information
+     */
+    includeResponseHeaders?: boolean;
+    /**
+     * Include request body in logs (default: false)
+     * May contain sensitive information and increase log size
+     */
+    includeRequestBody?: boolean;
+    /**
+     * Include response body in logs (default: false)
+     * May contain sensitive information and increase log size
+     */
+    includeResponseBody?: boolean;
+    /**
+     * Skip logging for requests matching these URL patterns
+     * Useful for health checks, metrics endpoints, etc.
+     *
+     * @example
+     * ```typescript
+     * skipPatterns: ['/health', '/metrics', /\/static\//]
+     * ```
+     */
+    skipPatterns?: (RegExp | string)[];
+    /**
+     * Custom log formatter function
+     * Allows complete customization of log output
+     */
+    formatter?: (entry: LogEntry) => string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/middleware/logging/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/middleware/logging/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAEnC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,MAAM,CAAC;CACzC;AAGD,OAAO,EAAE,CAAC"}

package/dist/middleware/logging/types.js

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Logging middleware types and configuration.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/middleware/logging/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/middleware/logging/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Rate limiting middleware - specialized use cases.
+ */
+import type { FetchClient } from '../../client/fetch-client';
+import type { RateLimitOptions } from './types';
+export type { RateLimitOptions, RateLimitAlgorithm } from './types';
+export { createRateLimitMiddleware } from './rate-limit';
+/**
+ * Rate limiting middleware - mainly for API quota management.
+ * Note: This is primarily useful for specific scenarios like:
+ * - Respecting third-party API limits
+ * - Bulk operations that need throttling
+ * - Pay-per-request API cost management
+ */
+export declare function useRateLimit(client: FetchClient, options?: RateLimitOptions): FetchClient;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/middleware/rate-limit/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIhD,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,gBAAqB,GAC7B,WAAW,CAEb"}

package/dist/middleware/rate-limit/index.js

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Rate limiting middleware - specialized use cases.
+ */
+import { createRateLimitMiddleware } from './rate-limit';
+export { createRateLimitMiddleware } from './rate-limit';
+/**
+ * Rate limiting middleware - mainly for API quota management.
+ * Note: This is primarily useful for specific scenarios like:
+ * - Respecting third-party API limits
+ * - Bulk operations that need throttling
+ * - Pay-per-request API cost management
+ */
+export function useRateLimit(client, options = {}) {
+    return client.use(createRateLimitMiddleware(options));
+}
+//# sourceMappingURL=index.js.map

package/dist/middleware/rate-limit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/middleware/rate-limit/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAIzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAmB,EACnB,UAA4B,EAAE;IAE9B,OAAO,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Rate limiting middleware implementation.
+ */
+import type { FetchMiddleware } from '../../client/fetch-client';
+import type { RateLimitOptions } from './types';
+/**
+ * Creates rate limiting middleware - mainly for API quota management.
+ * Note: Rate limiting is typically a server concern, but this can help with:
+ * - Respecting API provider limits
+ * - Preventing runaway requests in bulk operations
+ * - Cost management for pay-per-request APIs
+ */
+export declare function createRateLimitMiddleware(options?: RateLimitOptions): FetchMiddleware;
+//# sourceMappingURL=rate-limit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../../src/middleware/rate-limit/rate-limit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAyChD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CA6DjB"}