@plyaz/api 1.0.1 → 1.1.0

package/dist/api/queue/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Queue System Module
+ *
+ * A high-performance, reusable queue system for managing async operations
+ * with support for priority queuing, batch processing, and backpressure.
+ *
+ * Features:
+ * - Generic queue implementation for any operation type
+ * - Priority queue support
+ * - Batch processing for better performance
+ * - Backpressure handling to prevent memory issues
+ * - Configurable processing strategies
+ * - Built-in performance optimization
+ */
+export { QueueSystem } from './QueueSystem';
+export { PriorityQueue } from './PriorityQueue';
+export { BatchProcessor } from './BatchProcessor';
+export { QueueFactory } from './QueueFactory';
+export { QueueOrchestrator } from './QueueOrchestrator';
+export { BaseOperationTracker, createDefaultPriorityDetector, createDefaultSourceDetector, } from './BaseOperationTracker';
+export { EventQueueManager, ConfigPriorityMapper, getDefaultEventQueue, getConfigEventQueue, getNetworkEventQueue, getDefaultEventQueue as defaultEventQueue, getConfigEventQueue as configEventQueue, getNetworkEventQueue as networkEventQueue, } from './EventQueueManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/queue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/queue/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EAEpB,oBAAoB,IAAI,iBAAiB,EACzC,mBAAmB,IAAI,gBAAgB,EACvC,oBAAoB,IAAI,iBAAiB,GAC1C,MAAM,qBAAqB,CAAC"}

package/dist/api/regional/constants.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Regional detection constants
+ */
+export declare const REGION_STORAGE_KEY = "@plyaz/api:userRegion";
+/**
+ * Confidence levels for region detection
+ */
+export declare const REGIONAL_CONFIDENCE_LEVELS: {
+    readonly CDN_HEADER: 0.95;
+    readonly TIMEZONE_DIRECT: 0.9;
+    readonly TIMEZONE_PREFIX: 0.8;
+    readonly HIGH: 0.8;
+    readonly LOCALE_DIRECT: 0.7;
+    readonly MEDIUM: 0.7;
+    readonly GEOLOCATION: 0.6;
+    readonly LOCALE_LANGUAGE: 0.5;
+    readonly LOW: 0.5;
+    readonly GLOBAL_FALLBACK: 0.3;
+    readonly UNKNOWN_FALLBACK: 0.2;
+    readonly FINAL_FALLBACK: 0.1;
+};
+/**
+ * Geographic coordinates for region detection
+ */
+export declare const COORDINATES: {
+    readonly EU: {
+        readonly MIN_LAT: 35;
+        readonly MAX_LAT: 70;
+        readonly MIN_LON: -10;
+        readonly MAX_LON: 40;
+    };
+    readonly US: {
+        readonly MIN_LAT: 25;
+        readonly MAX_LAT: 50;
+        readonly MIN_LON: -125;
+        readonly MAX_LON: -65;
+    };
+    readonly US_WEST: {
+        readonly MIN_LAT: 32;
+        readonly MAX_LAT: 42;
+        readonly MIN_LON: -125;
+        readonly MAX_LON: -114;
+    };
+    readonly US_EAST: {
+        readonly MIN_LAT: 38;
+        readonly MAX_LAT: 45;
+        readonly MIN_LON: -80;
+        readonly MAX_LON: -70;
+    };
+    readonly ASIA: {
+        readonly MIN_LAT: 18;
+        readonly MAX_LAT: 54;
+        readonly MIN_LON: 73;
+        readonly MAX_LON: 135;
+    };
+    readonly JAPAN: {
+        readonly MIN_LAT: 30;
+        readonly MAX_LAT: 46;
+        readonly MIN_LON: 129;
+        readonly MAX_LON: 146;
+    };
+};
+export declare const CACHE_DURATION_MS: number;
+/**
+ * Map regions to presets
+ */
+export declare const REGION_TO_PRESET: {
+    readonly eu: "gdpr";
+    readonly us: "ccpa";
+    readonly 'us-ca': "ccpa";
+    readonly cn: "pipl";
+    readonly jp: "appi";
+    readonly ca: "global";
+    readonly global: "global";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/api/regional/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/api/regional/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;CAa7B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCd,CAAC;AAWX,eAAO,MAAM,iBAAiB,QACyC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;CAQnB,CAAC"}

package/dist/api/regional/core.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Regional Detection and Compliance System
+ * Automatically detect user region for compliance with data protection laws
+ */
+import type { RegionInfo, RegionalCompliance, RegionDetectionOptions, RegionalCacheConfig } from '@plyaz/types/api';
+import { type RegionalPresetName } from './presets';
+/**
+ * Clear regional cache
+ * @param cacheConfig - Optional advanced cache configuration
+ */
+export declare function clearRegionalCache(cacheConfig?: RegionalCacheConfig): void;
+/**
+ * Get fallback region info
+ */
+export declare function getFallbackRegion(): RegionInfo;
+/**
+ * Detect user region with multiple fallback methods
+ */
+export declare function detectUserRegion(options?: RegionDetectionOptions): Promise<RegionInfo>;
+/**
+ * Get regional preset by name
+ */
+export declare function getRegionalPreset(name: RegionalPresetName): RegionalCompliance;
+/**
+ * Check if preset exists
+ */
+export declare function hasRegionalPreset(name: string): boolean;
+/**
+ * Get all preset names
+ */
+export declare function getRegionalPresetNames(): RegionalPresetName[];
+/**
+ * Get preset for detected region
+ */
+export declare function getPresetForRegion(region: string): RegionalCompliance;
+/**
+ * Get compliance requirements for a specific region
+ */
+export declare function getComplianceForRegion(region: string, state?: string): RegionalCompliance;
+/**
+ * Get the most restrictive compliance combining all regional requirements
+ */
+export declare function getMostRestrictiveCompliance(): RegionalCompliance;
+/**
+ * Apply regional compliance rules to headers
+ */
+export declare function applyRegionalCompliance(headers: Record<string, string>, region: string, state?: string): Record<string, string>;
+/**
+ * Check if a region is supported by the detection system
+ */
+export declare function isRegionSupported(region: string): boolean;
+/**
+ * Detect region synchronously (for backward compatibility)
+ */
+export declare function detectRegion(): string;
+//# sourceMappingURL=core.d.ts.map

package/dist/api/regional/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/api/regional/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAmB1B,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGrE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAe1E;AA8RD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAO9C;AAyFD;;GAEG;AAEH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,UAAU,CAAC,CAwFhG;AAGD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAmC9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,kBAAkB,EAAE,CAE7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAGrE;AAED;;GAEG;AAEH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,CA0BzF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,kBAAkB,CAkDjE;AAgGD;;GAEG;AAEH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED;;GAEG;AAEH,wBAAgB,YAAY,IAAI,MAAM,CAoBrC"}

package/dist/api/regional/helpers.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Helper functions for regional detection
+ */
+import type { RegionInfo } from '@plyaz/types/api';
+/**
+ * Helper to check if a timezone is global/universal
+ */
+export declare function isGlobalTimezone(tz: string): boolean;
+/**
+ * Create a RegionInfo object from timezone match
+ */
+export declare function createTimezoneRegionInfo(match: {
+    region: string;
+    country?: string;
+    state?: string;
+}, confidence: number): RegionInfo;
+/**
+ * Find timezone prefix match
+ */
+export declare function findTimezonePrefixMatch(tz: string): RegionInfo | null;
+/**
+ * Detect region from timezone
+ */
+export declare function detectRegionFromTimezone(tz: string): RegionInfo | null;
+/**
+ * Detect region from locale
+ */
+export declare function detectRegionFromLocale(locale: string): RegionInfo | null;
+/**
+ * CDN header parsing result
+ */
+type CDNGeoData = {
+    country?: string;
+    region?: string;
+    state?: string;
+    city?: string;
+    timezone?: string;
+};
+/**
+ * Parse CDN headers for region detection
+ */
+export declare function parseCDNHeaders(headers: Record<string, string>): CDNGeoData;
+/**
+ * Detect region from CDN headers
+ */
+export declare function detectRegionFromCDNHeaders(headers: Record<string, unknown>): RegionInfo | null;
+export declare function getRegionFromCoordinates(latitude: number, longitude: number): string;
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/api/regional/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/api/regional/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3D,UAAU,EAAE,MAAM,GACjB,UAAU,CASZ;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAOrE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA4BtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA6DxE;AAED;;GAEG;AACH,KAAK,UAAU,GAAG;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAiHF;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,CAiB3E;AAsDD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,GAAG,IAAI,CAmB9F;AAqBD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA6BpF"}

package/dist/api/regional/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Regional Detection and Compliance System
+ * Automatically detect user region for compliance with data protection laws
+ */
+export type { RegionInfo, RegionalCompliance, RegionDetectionOptions } from '@plyaz/types/api';
+export type { RegionalPresetName } from './presets';
+export { detectUserRegion, clearRegionalCache, getRegionalPreset, hasRegionalPreset, getRegionalPresetNames, getPresetForRegion, getComplianceForRegion, getMostRestrictiveCompliance, applyRegionalCompliance, isRegionSupported, detectRegion, } from './core';
+export { detectRegionFromTimezone, detectRegionFromLocale, detectRegionFromCDNHeaders, getRegionFromCoordinates, } from './helpers';
+export { regionalPresets } from './presets';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/regional/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/regional/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,4BAA4B,EAC5B,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,GACb,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/api/regional/presets.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Regional compliance presets
+ */
+import type { RegionalCompliance } from '@plyaz/types/api';
+/**
+ * Regional compliance presets
+ */
+export declare const regionalPresets: {
+    readonly gdpr: () => RegionalCompliance;
+    readonly ccpa: () => RegionalCompliance;
+    readonly pipl: () => RegionalCompliance;
+    readonly appi: () => RegionalCompliance;
+    readonly global: () => RegionalCompliance;
+};
+export type RegionalPresetName = keyof typeof regionalPresets;
+//# sourceMappingURL=presets.d.ts.map

package/dist/api/regional/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/api/regional/presets.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,eAAe;yBAEhB,kBAAkB;yBA+BlB,kBAAkB;yBAiBlB,kBAAkB;yBAkBlB,kBAAkB;2BAgBhB,kBAAkB;CAmCtB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,eAAe,CAAC"}

package/dist/api/request/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Request management utilities
+ *
+ * Provides comprehensive request lifecycle management including:
+ * - Request cancellation and abortion
+ * - Automatic cleanup in React components
+ * - Route change handling
+ * - Request grouping and tracking
+ *
+ * @module @plyaz/api/request
+ */
+export { abortRequest, isAbortError, createAbortError } from './management';
+export { requestTracker, RequestTracker } from './tracker';
+export { useRequestCleanup, useAbortableRequest, useRequestGroup, useRouteAwareRequest, } from './react';
+export { setupRouteChangeCleanup, createRouteGuard, createRouteScope } from './routing';
+export { abortByPattern, abortSearchRequests, abortUploadRequests, abortAllRequests, createScopedAbort, createDebouncedAbort, createThrottledAbort, requestWithTimeout, raceRequests, sequentialRequests, } from './utils';
+export { prepareRequestConfig, prepareRequestConfigWithEnrichedHeaders, headersContext, getContextHeaders, runWithHeaders, runWithHeadersAsync, } from './prepare';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/request/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/request/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGxF,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,oBAAoB,EACpB,uCAAuC,EACvC,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,mBAAmB,GACpB,MAAM,WAAW,CAAC"}

package/dist/api/request/management.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Request management utilities - direct pass-through to fetchff
+ * Used for controlling in-flight requests and cleanup
+ */
+import { abortRequest as fetchffAbortRequest } from 'fetchff';
+/**
+ * Abort a specific request by key or URL pattern
+ *
+ * @param key - Cache key or URL pattern to abort
+ * @param error - Optional error message or DOMException
+ *
+ * @example
+ * ```typescript
+ * // Abort specific request
+ * abortRequest('/api/slow-operation');
+ *
+ * // Abort with custom error message
+ * abortRequest('/api/upload', 'Upload cancelled by user');
+ *
+ * // Abort by pattern
+ * abortRequest('/api/search/*');
+ * ```
+ */
+export declare const abortRequest: typeof fetchffAbortRequest;
+/**
+ * Check if an error is an abort error
+ *
+ * @param error - Error to check
+ * @returns True if error is from aborted request
+ */
+export declare function isAbortError(error: Error | DOMException | null | undefined): boolean;
+/**
+ * Create an abort error message
+ *
+ * @param message - Error message
+ * @returns Abort error message string
+ */
+export declare function createAbortError(message?: string): string;
+/**
+ * Create a DOMException for abort (browser-compatible)
+ *
+ * @param message - Error message
+ * @returns DOMException instance if available, otherwise string
+ */
+export declare function createAbortDOMException(message?: string): DOMException | string;
+//# sourceMappingURL=management.d.ts.map

package/dist/api/request/management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../../../src/api/request/management.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,IAAI,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY,4BAAsB,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAoBpF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAA0B,GAAG,MAAM,CAM5E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,MAA0B,GAClC,YAAY,GAAG,MAAM,CAUvB"}

package/dist/api/request/prepare.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Request Preparation and Context Management (Simplified)
+ *
+ * Utilities for preparing request configurations with enriched headers
+ * and tracking context. Simplified version without unified processor.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import type { ApiHeaders, ApiConfig, EnrichedHeadersOptions } from '@plyaz/types/api';
+/**
+ * Context for headers that flow through service calls
+ */
+export declare const headersContext: AsyncLocalStorage<ApiHeaders>;
+/**
+ * Get current headers from context
+ */
+export declare function getContextHeaders(): ApiHeaders;
+/**
+ * Run function with headers in context
+ */
+export declare function runWithHeaders<T>(headers: ApiHeaders, fn: () => T): T;
+/**
+ * Run async function with headers in context
+ */
+export declare function runWithHeadersAsync<T>(headers: ApiHeaders, fn: () => Promise<T>): Promise<T>;
+/**
+ * Prepare request configuration with simple three-level precedence
+ * Global -> Client -> Request (highest priority)
+ */
+export declare function prepareRequestConfig(requestConfig?: Partial<ApiConfig>, clientConfig?: Partial<ApiConfig>): Promise<ApiConfig>;
+/**
+ * Prepare request configuration with enriched headers support
+ */
+export declare function prepareRequestConfigWithEnrichedHeaders(requestConfig?: Partial<ApiConfig>, clientConfig?: Partial<ApiConfig>, enrichedHeadersOptions?: EnrichedHeadersOptions): Promise<ApiConfig>;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/api/request/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/api/request/prepare.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,sBAAsB,EAEvB,MAAM,kBAAkB,CAAC;AAK1B;;GAEG;AACH,eAAO,MAAM,cAAc,+BAAsC,CAAC;AAElE;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAE9C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAErE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAWZ;AAqCD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EAClC,YAAY,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAChC,OAAO,CAAC,SAAS,CAAC,CAwCpB;AAED;;GAEG;AACH,wBAAsB,uCAAuC,CAC3D,aAAa,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EAClC,YAAY,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACjC,sBAAsB,CAAC,EAAE,sBAAsB,GAC9C,OAAO,CAAC,SAAS,CAAC,CA0BpB"}

package/dist/api/request/react.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Hook for automatic request cleanup on unmount
+ *
+ * @example
+ * ```tsx
+ * function Component() {
+ *   const { trackRequest, untrackRequest } = useRequestCleanup();
+ *
+ *   useEffect(() => {
+ *     const key = '/api/data';
+ *     trackRequest(key);
+ *     fetchData(key).finally(() => untrackRequest(key));
+ *   }, []);
+ * }
+ * ```
+ */
+export declare function useRequestCleanup(): {
+    trackRequest: (key: string) => void;
+    untrackRequest: (key: string) => void;
+    abortTracked: (reason?: string) => void;
+};
+/**
+ * Hook for request with automatic abort
+ *
+ * @param key - Unique request identifier
+ * @returns Object with signal and abort function
+ *
+ * @example
+ * ```tsx
+ * function SearchComponent() {
+ *   const { signal, abort } = useAbortableRequest('search');
+ *
+ *   const handleSearch = async (query: string) => {
+ *     try {
+ *       const results = await fetch(`/api/search?q=${query}`, { signal });
+ *       // Handle results
+ *     } catch (err) {
+ *       if (!isAbortError(err)) {
+ *         // Handle real error
+ *       }
+ *     }
+ *   };
+ * }
+ * ```
+ */
+export declare function useAbortableRequest(key: string): {
+    signal: AbortSignal | undefined;
+    abort: (reason?: string) => void;
+};
+/**
+ * Hook for managing a group of related requests
+ *
+ * @param groupName - Name for the request group
+ * @returns Object with request management functions
+ *
+ * @example
+ * ```tsx
+ * function Dashboard() {
+ *   const { makeRequest, abortGroup } = useRequestGroup('dashboard');
+ *
+ *   useEffect(() => {
+ *     makeRequest('stats', () => api.getStats());
+ *     makeRequest('users', () => api.getUsers());
+ *   }, []);
+ *
+ *   const handleRefresh = () => {
+ *     abortGroup('Refreshing');
+ *     // Make new requests
+ *   };
+ * }
+ * ```
+ */
+export declare function useRequestGroup(groupName: string): {
+    makeRequest: <T>(key: string, fetcher: () => Promise<T>) => Promise<T>;
+    abortGroup: (reason?: string) => void;
+    getActiveCount: () => number;
+};
+/**
+ * Hook for route-aware requests that abort on route change
+ *
+ * @returns Object with makeRequest function
+ *
+ * @example
+ * ```tsx
+ * function PageComponent() {
+ *   const { makeRequest } = useRouteAwareRequest();
+ *
+ *   useEffect(() => {
+ *     makeRequest('page-data', () => api.getPageData());
+ *   }, []);
+ *   // Automatically aborted on route change
+ * }
+ * ```
+ */
+export declare function useRouteAwareRequest(): {
+    makeRequest: <T>(key: string, fetcher: () => Promise<T>) => Promise<T>;
+};
+//# sourceMappingURL=react.d.ts.map

package/dist/api/request/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../src/api/request/react.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,IAAI;IACnC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,CA6BA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG;IAChD,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAgCA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG;IAClD,WAAW,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACvE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,cAAc,EAAE,MAAM,MAAM,CAAC;CAC9B,CA2BA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,WAAW,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACxE,CAoBA"}

package/dist/api/request/routing.d.ts

@@ -0,0 +1,74 @@
+import type { RequestRouter, RouteChangeOptions } from '@plyaz/types/api';
+/**
+ * Setup route change listeners for automatic cleanup
+ *
+ * @param router - Router instance from Next.js or React Router
+ * @param options - Configuration options
+ * @returns Cleanup function
+ *
+ * @example
+ * ```tsx
+ * // Next.js _app.tsx
+ * import { useRouter } from 'next/router';
+ *
+ * function MyApp({ Component, pageProps }) {
+ *   const router = useRouter();
+ *
+ *   useEffect(() => {
+ *     return setupRouteChangeCleanup(router, {
+ *       abortPattern: '/api/*',
+ *       preservePatterns: ['/api/auth/*']
+ *     });
+ *   }, [router]);
+ * }
+ * ```
+ */
+export declare function setupRouteChangeCleanup(router: RequestRouter, options?: RouteChangeOptions): () => void;
+/**
+ * Create a route guard that aborts requests when leaving
+ *
+ * @param pattern - Pattern to abort on route leave
+ * @returns Object with enter and leave functions
+ *
+ * @example
+ * ```tsx
+ * const guard = createRouteGuard('/api/page/*');
+ *
+ * // On route enter
+ * guard.enter();
+ *
+ * // On route leave
+ * guard.leave();
+ * ```
+ */
+export declare function createRouteGuard(pattern?: string): {
+    enter: () => void;
+    leave: (reason?: string) => void;
+    isActive: () => boolean;
+};
+/**
+ * Create a scoped abort manager for specific routes
+ *
+ * @param routeName - Name of the route
+ * @returns Abort manager functions
+ *
+ * @example
+ * ```tsx
+ * const profileRoute = createRouteScope('profile');
+ *
+ * // Register requests for this route
+ * profileRoute.register('/api/profile');
+ * profileRoute.register('/api/posts');
+ *
+ * // Abort all when leaving
+ * profileRoute.abortAll();
+ * ```
+ */
+export declare function createRouteScope(routeName: string): {
+    register: (key: string) => void;
+    unregister: (key: string) => void;
+    abortAll: (reason?: string) => void;
+    getActiveCount: () => number;
+    isActive: (key: string) => boolean;
+};
+//# sourceMappingURL=routing.d.ts.map

package/dist/api/request/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../src/api/request/routing.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAoB,aAAa,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE5F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,IAAI,CAsEZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAY,GAAG;IACvD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,OAAO,CAAC;CACzB,CAiBA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG;IACnD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC,CAwBA"}

package/dist/api/request/tracker.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Request tracking and management
+ */
+declare class RequestTracker {
+    private activeRequests;
+    private requestGroups;
+    /**
+     * Register a request with tracking
+     *
+     * @param key - Unique request identifier
+     * @param controller - Optional AbortController for the request
+     * @param group - Optional group name for bulk management
+     */
+    register(key: string, controller?: AbortController, group?: string): void;
+    /**
+     * Unregister a completed request
+     *
+     * @param key - Request identifier to remove
+     */
+    unregister(key: string): void;
+    /**
+     * Abort a specific request
+     *
+     * @param key - Request identifier
+     * @param reason - Optional abort reason
+     */
+    abort(key: string, reason?: string): void;
+    /**
+     * Abort all requests in a group
+     *
+     * @param group - Group name
+     * @param reason - Optional abort reason
+     */
+    abortGroup(group: string, reason?: string): void;
+    /**
+     * Abort all tracked requests
+     *
+     * @param reason - Optional abort reason
+     */
+    abortAll(reason?: string): void;
+    /**
+     * Get active request count
+     *
+     * @returns Number of active requests
+     */
+    getActiveCount(): number;
+    /**
+     * Check if a request is active
+     *
+     * @param key - Request identifier
+     * @returns True if request is active
+     */
+    isActive(key: string): boolean;
+    /**
+     * Get all active request keys
+     *
+     * @returns Array of active request keys
+     */
+    getActiveKeys(): string[];
+    /**
+     * Get all group names
+     *
+     * @returns Array of group names
+     */
+    getGroups(): string[];
+    /**
+     * Get requests in a specific group
+     *
+     * @param group - Group name
+     * @returns Array of request keys in the group
+     */
+    getGroupRequests(group: string): string[];
+}
+export declare const requestTracker: RequestTracker;
+export { RequestTracker };
+//# sourceMappingURL=tracker.d.ts.map

package/dist/api/request/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/api/request/tracker.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,aAAa,CAAkC;IAEvD;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAezE;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAS7B;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAWzC;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAQhD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAW/B;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;OAIG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;;;OAIG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAI1C;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,CAAC"}