@plyaz/api 1.0.1 → 1.1.0

package/dist/api/network/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../src/api/network/platform.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,UAAU,EAGX,MAAM,kBAAkB,CAAC;AA6E1B,wBAAgB,QAAQ,CAAC,SAAS,GAAE,MAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAOnE;AA2BD,wBAAgB,aAAa,CAAC,SAAS,GAAE,MAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAO7E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,MAAW,GAAG,YAAY,CAAC,YAAY,CAAC,CASnF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,GAAE,MAAW,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAIvC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAAC,YAAY,CAAC,CAS7D;AAiCD;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAcnD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAYrC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,IAAI,YAAY,CAW7C;AAsCD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA8BvC;AAiJD,wBAAgB,WAAW,IAAI,MAAM,CAWpC;AAoDD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAkB1C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS9E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAM7C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAM3C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,MAAM,EAAE,CAMvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAc7C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;CAsBX,CAAC"}

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

@@ -0,0 +1,55 @@
+/**
+ * Network Quality Presets
+ * Centralized configuration presets for different network conditions
+ * These presets can be easily updated and extended
+ */
+import { NETWORK_QUALITY } from '@plyaz/types/api';
+import type { NetworkInfo, NetworkQualityPreset, NetworkPresetName } from '@plyaz/types/api';
+/**
+ * Network quality presets registry
+ * Easily extendable with new presets
+ */
+export declare const networkPresets: Record<NetworkPresetName, NetworkQualityPreset>;
+/**
+ * Get preset by name
+ */
+export declare function getNetworkPreset(name: NetworkPresetName): NetworkQualityPreset;
+/**
+ * Get preset for network quality
+ */
+export declare function getPresetForQuality(quality: NETWORK_QUALITY): NetworkQualityPreset | null;
+/**
+ * Get preset based on network info
+ */
+export declare function getPresetForNetworkInfo(networkInfo: NetworkInfo): NetworkQualityPreset | null;
+/**
+ * Get all presets matching conditions
+ */
+export declare function getMatchingPresets(networkInfo: NetworkInfo, quality: NETWORK_QUALITY): NetworkQualityPreset[];
+/**
+ * Create custom preset
+ */
+export declare function createCustomPreset(id: string, name: string, targetQuality: NETWORK_QUALITY, config: Partial<NetworkQualityPreset['config']>): NetworkQualityPreset;
+/**
+ * Merge multiple presets
+ */
+export declare function mergePresets(...presets: NetworkQualityPreset[]): NetworkQualityPreset['config'];
+/**
+ * Validate preset configuration
+ */
+export declare function validatePreset(preset: NetworkQualityPreset): boolean;
+/**
+ * Export preset names for easy access
+ */
+export declare const NetworkPresetNames: {
+    readonly OFFLINE_FIRST: "offline-first";
+    readonly DATA_SAVER: "data-saver";
+    readonly SLOW_CONNECTION: "slow-connection";
+    readonly FAIR_CONNECTION: "fair-connection";
+    readonly GOOD_CONNECTION: "good-connection";
+    readonly EXCELLENT_CONNECTION: "excellent-connection";
+    readonly AGGRESSIVE_CACHE: "aggressive-cache";
+    readonly REALTIME: "realtime";
+    readonly BACKGROUND_SYNC: "background-sync";
+};
+//# sourceMappingURL=presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/api/network/presets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAmK7F;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CA0R1E,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,oBAAoB,CAE9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,oBAAoB,GAAG,IAAI,CAezF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,oBAAoB,GAAG,IAAI,CAc7F;AAqFD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,eAAe,GACvB,oBAAoB,EAAE,CAIxB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,eAAe,EAC9B,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,GAC9C,oBAAoB,CAatB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAQ/F;AAwCD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CASpE;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;CAUrB,CAAC"}

package/dist/api/network/quality.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Network quality assessment utilities
+ */
+import type { QualityThresholds } from '@plyaz/types/api';
+import { NETWORK_QUALITY } from '@plyaz/types/api';
+/**
+ * Determine network quality based on various factors
+ */
+export declare function getNetworkQuality(thresholds?: QualityThresholds): NETWORK_QUALITY;
+/**
+ * Get quality score (0-100)
+ *
+ * @returns Numeric score for network quality
+ */
+export declare function getNetworkQualityScore(): number;
+/**
+ * Check if network is suitable for heavy operations
+ *
+ * @returns True if network can handle heavy operations
+ */
+export declare function canPerformHeavyOperation(): boolean;
+/**
+ * Get recommended timeout based on network quality
+ *
+ * @returns Timeout in milliseconds
+ */
+export declare function getAdaptiveTimeout(): number;
+//# sourceMappingURL=quality.d.ts.map

package/dist/api/network/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../../src/api/network/quality.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAiD,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAyElG;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,GAAE,iBAAsC,GACjD,eAAe,CA+DjB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAa/C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAa3C"}

package/dist/api/network/status.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Network status change callback
+ */
+export type NetworkStatusCallback = (online: boolean) => void;
+/**
+ * Network status monitor
+ */
+declare class NetworkStatusMonitor {
+    private callbacks;
+    private isMonitoring;
+    /**
+     * Check if currently online
+     *
+     * @returns True if online
+     */
+    isOnline(): boolean;
+    /**
+     * Check if currently offline
+     *
+     * @returns True if offline
+     */
+    isOffline(): boolean;
+    /**
+     * Subscribe to network status changes
+     *
+     * @param callback - Function to call on status change
+     * @returns Unsubscribe function
+     *
+     * @example
+     * const unsubscribe = networkStatus.subscribe(online => {
+     *   console.log('Network status:', online ? 'online' : 'offline');
+     * });
+     * // Later: unsubscribe();
+     */
+    subscribe(callback: NetworkStatusCallback): () => void;
+    /**
+     * Start monitoring network status
+     */
+    private startMonitoring;
+    /**
+     * Stop monitoring network status
+     */
+    private stopMonitoring;
+    private handleOnline;
+    private handleOffline;
+    private notifyCallbacks;
+}
+export declare const networkStatus: NetworkStatusMonitor;
+/**
+ * Wait for online status
+ *
+ * @returns Promise that resolves when online
+ *
+ * @example
+ * await waitForOnline();
+ * console.log('Back online!');
+ */
+export declare function waitForOnline(): Promise<void>;
+/**
+ * Execute callback when online
+ *
+ * @param callback - Function to execute when online
+ * @returns Cleanup function
+ */
+export declare function onOnline(callback: () => void): () => void;
+/**
+ * Execute callback when offline
+ *
+ * @param callback - Function to execute when offline
+ * @returns Cleanup function
+ */
+export declare function onOffline(callback: () => void): () => void;
+export {};
+//# sourceMappingURL=status.d.ts.map

package/dist/api/network/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/api/network/status.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAE9D;;GAEG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,YAAY,CAAS;IAE7B;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAatD;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,YAAY,CAElB;IAEF,OAAO,CAAC,aAAa,CAEnB;IAEF,OAAO,CAAC,eAAe;CASxB;AAGD,eAAO,MAAM,aAAa,sBAA6B,CAAC;AAExD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAa7C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAQzD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAQ1D"}

package/dist/api/performance/adaptive.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Adaptive Performance Configuration
+ * Connection-aware and environment-adaptive optimization
+ */
+import type { EffectiveConnectionType, PerformanceConfig } from '@plyaz/types/api';
+/**
+ * Get current connection type
+ */
+export declare function getConnectionType(): EffectiveConnectionType;
+/**
+ * Get adaptive configuration based on connection
+ * Automatically adjusts timeouts, cache times, and retry strategies
+ */
+export declare function getAdaptiveConfig(): PerformanceConfig;
+/**
+ * Monitor connection changes and adapt configuration
+ */
+export declare function setupConnectionMonitoring(onConnectionChange: (config: PerformanceConfig) => void): () => void;
+/**
+ * Get recommended batch size based on connection
+ */
+export declare function getAdaptiveBatchSize(): number;
+/**
+ * Get recommended page size for pagination
+ */
+export declare function getAdaptivePageSize(): number;
+/**
+ * Should prefetch data based on connection
+ */
+export declare function shouldPrefetch(): boolean;
+/**
+ * Should use progressive loading
+ */
+export declare function shouldUseProgressive(): boolean;
+//# sourceMappingURL=adaptive.d.ts.map

package/dist/api/performance/adaptive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive.d.ts","sourceRoot":"","sources":["../../../src/api/performance/adaptive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA8CnF;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CAgB3D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CA+BrD;AAgID;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,kBAAkB,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GACtD,MAAM,IAAI,CAqCZ;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAiB7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAmB5C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CASxC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAK9C"}

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

@@ -0,0 +1,133 @@
+/**
+ * Performance Optimization Module
+ * Comprehensive performance optimization for API operations
+ *
+ * @module performance
+ */
+export type { PerformanceConfig, PerformancePresetName, DataPatternType, PerformanceOption, PerformanceTiming, RequestPerformance, ApiPerformanceMetrics, } from '@plyaz/types/api';
+export { performancePresets } from './presets';
+export { dataPatternConfigs, getDataPatternConfig, detectDataPattern } from './patterns';
+export { getConnectionType, getAdaptiveConfig, setupConnectionMonitoring, getAdaptiveBatchSize, getAdaptivePageSize, shouldPrefetch, shouldUseProgressive, } from './adaptive';
+export { PerformanceMonitor, performanceMonitor, formatMetrics, logMetrics, } from './performanceMonitor';
+export { applyPerformancePreset, applyDataPattern, resolvePerformanceOption, getOptimizedConfig, mergePerformanceConfigs, getBundleSizeOptimizedConfig, calculateOptimalCacheTime, calculateOptimalDedupeTime, getPerformanceRecommendation, shouldOptimize, isPerformanceFetchResponse, isPerformanceRequestConfig, isPerformanceResponseError, } from './utils';
+/**
+ * Quick setup for common use cases
+ */
+export declare const quickSetup: {
+    /**
+     * Setup for mobile app
+     */
+    readonly mobile: () => {
+        enableMetrics: boolean;
+        enableAdaptive?: boolean;
+        enableProgressive?: boolean;
+        maxCacheSize?: number;
+        compressionThreshold?: number;
+        cacheTime?: number;
+        staleTime?: number;
+        dedupeTime?: number;
+        strategy?: string;
+        retry?: unknown;
+        cancellable?: boolean;
+        skipCache?: boolean;
+        cacheErrors?: boolean;
+        refetchOnFocus?: boolean;
+        refetchOnReconnect?: boolean;
+        immediate?: boolean;
+        timeout?: number;
+        flattenResponse?: boolean;
+    };
+    /**
+     * Setup for desktop app
+     */
+    readonly desktop: () => {
+        enableMetrics: boolean;
+        enableAdaptive?: boolean;
+        enableProgressive?: boolean;
+        maxCacheSize?: number;
+        compressionThreshold?: number;
+        cacheTime?: number;
+        staleTime?: number;
+        dedupeTime?: number;
+        strategy?: string;
+        retry?: unknown;
+        cancellable?: boolean;
+        skipCache?: boolean;
+        cacheErrors?: boolean;
+        refetchOnFocus?: boolean;
+        refetchOnReconnect?: boolean;
+        immediate?: boolean;
+        timeout?: number;
+        flattenResponse?: boolean;
+    };
+    /**
+     * Setup for PWA
+     */
+    readonly pwa: () => {
+        enableMetrics: boolean;
+        enableProgressive: boolean;
+        enableAdaptive?: boolean;
+        maxCacheSize?: number;
+        compressionThreshold?: number;
+        cacheTime?: number;
+        staleTime?: number;
+        dedupeTime?: number;
+        strategy?: string;
+        retry?: unknown;
+        cancellable?: boolean;
+        skipCache?: boolean;
+        cacheErrors?: boolean;
+        refetchOnFocus?: boolean;
+        refetchOnReconnect?: boolean;
+        immediate?: boolean;
+        timeout?: number;
+        flattenResponse?: boolean;
+    };
+    /**
+     * Setup for real-time app
+     */
+    readonly realtime: () => {
+        enableMetrics: boolean;
+        enableAdaptive?: boolean;
+        enableProgressive?: boolean;
+        maxCacheSize?: number;
+        compressionThreshold?: number;
+        cacheTime?: number;
+        staleTime?: number;
+        dedupeTime?: number;
+        strategy?: string;
+        retry?: unknown;
+        cancellable?: boolean;
+        skipCache?: boolean;
+        cacheErrors?: boolean;
+        refetchOnFocus?: boolean;
+        refetchOnReconnect?: boolean;
+        immediate?: boolean;
+        timeout?: number;
+        flattenResponse?: boolean;
+    };
+    /**
+     * Setup for static site
+     */
+    readonly static: () => {
+        enableMetrics: boolean;
+        enableAdaptive?: boolean;
+        enableProgressive?: boolean;
+        maxCacheSize?: number;
+        compressionThreshold?: number;
+        cacheTime?: number;
+        staleTime?: number;
+        dedupeTime?: number;
+        strategy?: string;
+        retry?: unknown;
+        cancellable?: boolean;
+        skipCache?: boolean;
+        cacheErrors?: boolean;
+        refetchOnFocus?: boolean;
+        refetchOnReconnect?: boolean;
+        immediate?: boolean;
+        timeout?: number;
+        flattenResponse?: boolean;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/performance/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGzF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,UAAU,GACX,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,cAAc,EACd,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;;;;;;;;;;;;;;;;;;;;;IAOH;;OAEG;;;;;;;;;;;;;;;;;;;;;IAMH;;OAEG;;;;;;;;;;;;;;;;;;;;;IAQH;;OAEG;;;;;;;;;;;;;;;;;;;;;IAMH;;OAEG;;;;;;;;;;;;;;;;;;;;;CAMK,CAAC"}

package/dist/api/performance/patterns.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Data Pattern Configurations
+ * Optimized configurations for different data access patterns
+ */
+import type { DataPatternType, PerformanceConfig } from '@plyaz/types/api';
+/**
+ * Data pattern-specific performance configurations
+ * Each pattern is optimized for its specific characteristics
+ */
+export declare const dataPatternConfigs: Readonly<Record<DataPatternType, PerformanceConfig>>;
+/**
+ * Get recommended configuration for a data pattern
+ */
+export declare function getDataPatternConfig(pattern: DataPatternType): PerformanceConfig;
+export declare function detectDataPattern(options: {
+    method?: string;
+    url?: string;
+    contentType?: string;
+}): DataPatternType | undefined;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/api/performance/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../../src/api/performance/patterns.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAS3E;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAwInF,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,iBAAiB,CAEhF;AAiCD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,eAAe,GAAG,SAAS,CAgB9B"}

package/dist/api/performance/performanceMonitor.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Performance Monitoring System
+ * Track and analyze API performance metrics
+ */
+import type { RequestConfig } from 'fetchff';
+import type { ApiPerformanceMetrics, RequestPerformance } from '@plyaz/types/api';
+/**
+ * Performance monitor class for tracking API metrics
+ */
+export declare class PerformanceMonitor {
+    private metrics;
+    private requestTimings;
+    private requestPerformance;
+    private maxHistorySize;
+    /**
+     * Create performance monitoring configuration
+     */
+    createMonitoringConfig(): Pick<RequestConfig, 'onRequest' | 'onResponse' | 'onError'>;
+    /**
+     * Update average response time
+     */
+    private updateAverageResponseTime;
+    /**
+     * Record request performance data
+     */
+    private recordRequestPerformance;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): ApiPerformanceMetrics;
+    /**
+     * Track response timing and performance
+     */
+    private trackResponseTiming;
+    /**
+     * Track optimization metrics
+     */
+    private trackOptimizationMetrics;
+    /**
+     * Get performance history
+     */
+    getPerformanceHistory(): RequestPerformance[];
+    /**
+     * Calculate optimization metrics
+     */
+    private calculateOptimizationMetrics;
+    /**
+     * Generate all recommendations
+     */
+    private generateAllRecommendations;
+    /**
+     * Get performance summary
+     */
+    getSummary(): {
+        metrics: ApiPerformanceMetrics;
+        optimization: {
+            requestsSaved: number;
+            cacheEfficiency: number;
+            dedupeEfficiency: number;
+            errorRecovery: number;
+        };
+        recommendations: string[];
+    };
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Set maximum history size
+     */
+    setMaxHistorySize(size: number): void;
+}
+/**
+ * Global performance monitor instance
+ */
+export declare const performanceMonitor: PerformanceMonitor;
+/**
+ * Format metrics for display
+ */
+export declare function formatMetrics(metrics: ApiPerformanceMetrics): string;
+/**
+ * Log performance metrics to console
+ */
+export declare function logMetrics(label?: string): void;
+//# sourceMappingURL=performanceMonitor.d.ts.map

package/dist/api/performance/performanceMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performanceMonitor.d.ts","sourceRoot":"","sources":["../../../src/api/performance/performanceMonitor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAgC,MAAM,SAAS,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAyClF;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAUb;IAEF,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,cAAc,CAAO;IAE7B;;OAEG;IACH,sBAAsB,IAAI,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;IAiErF;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAUjC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAShC;;OAEG;IACH,UAAU,IAAI,qBAAqB;IASnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;OAEG;IACH,qBAAqB,IAAI,kBAAkB,EAAE;IAI7C;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAwBpC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA0ClC;;OAEG;IACH,UAAU,IAAI;QACZ,OAAO,EAAE,qBAAqB,CAAC;QAC/B,YAAY,EAAE;YACZ,aAAa,EAAE,MAAM,CAAC;YACtB,eAAe,EAAE,MAAM,CAAC;YACxB,gBAAgB,EAAE,MAAM,CAAC;YACzB,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;QACF,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B;IAYD;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAQtC;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,oBAA2B,CAAC;AAE3D;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAgBpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CA2B/C"}

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

@@ -0,0 +1,18 @@
+/**
+ * Performance Optimization Presets
+ * Pre-configured performance strategies for different use cases
+ */
+import type { PerformancePresetName, PerformanceConfig } from '@plyaz/types/api';
+/**
+ * Performance-optimized configuration presets
+ * Based on fetchff's performance implications documentation
+ *
+ * Performance Impact Statistics:
+ * - Caching: 70-90% fewer requests
+ * - Deduplication: 50-80% fewer concurrent requests
+ * - SWR: 90% faster perceived loading
+ * - Cancellation: Reduced bandwidth waste
+ * - Retry: 95%+ success rate
+ */
+export declare const performancePresets: Readonly<Record<PerformancePresetName, PerformanceConfig>>;
+//# sourceMappingURL=presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/api/performance/presets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEjF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAgIzF,CAAC"}

package/dist/api/performance/utils.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Performance Optimization Utilities
+ * Helper functions for performance optimization
+ */
+import type { PerformancePresetName, DataPatternType, PerformanceConfig, BundleSizeLevel, PerformanceOptions, PerformanceOption, PerformanceFetchResponse, PerformanceRequestConfig, PerformanceResponseError } from '@plyaz/types/api';
+/**
+ * Apply performance preset by name with tracking
+ */
+export declare function applyPerformancePreset(preset: PerformancePresetName): PerformanceConfig;
+/**
+ * Resolve performance option to configuration
+ * Supports string preset names, config objects, or false to disable
+ *
+ * @param option - Performance option to resolve
+ * @returns Resolved performance configuration or undefined if disabled
+ *
+ * @example
+ * ```typescript
+ * // String preset
+ * const config = resolvePerformanceOption('balanced');
+ *
+ * // Config object
+ * const config = resolvePerformanceOption({ cacheTime: 300 });
+ *
+ * // Disabled
+ * const config = resolvePerformanceOption(false); // returns undefined
+ * ```
+ */
+export declare function resolvePerformanceOption(option: PerformanceOption): PerformanceConfig | undefined;
+/**
+ * Apply data pattern configuration with tracking
+ */
+export declare function applyDataPattern(pattern: DataPatternType): PerformanceConfig;
+/**
+ * Get optimized configuration based on multiple factors
+ */
+export declare function getOptimizedConfig(options?: PerformanceOptions): PerformanceConfig;
+/**
+ * Merge multiple performance configurations
+ * Later configs override earlier ones
+ */
+export declare function mergePerformanceConfigs(...configs: (PerformanceConfig | undefined)[]): PerformanceConfig;
+/**
+ * Get bundle-size optimized configuration
+ * Reduces features based on bundle size requirements
+ */
+export declare function getBundleSizeOptimizedConfig(level: BundleSizeLevel): PerformanceConfig;
+/**
+ * Calculate optimal cache time based on data characteristics
+ */
+export declare function calculateOptimalCacheTime(options: {
+    updateFrequency?: number;
+    dataSize?: number;
+    importance?: 'low' | 'medium' | 'high';
+    userTolerance?: number;
+}): number;
+/**
+ * Calculate optimal dedupe time based on request patterns
+ */
+export declare function calculateOptimalDedupeTime(options: {
+    requestRate?: number;
+    userInteraction?: boolean;
+    dataVolatility?: 'low' | 'medium' | 'high';
+}): number;
+/**
+ * Get performance recommendation based on endpoint
+ */
+export declare function getPerformanceRecommendation(options: {
+    method?: string;
+    url?: string;
+    responseSize?: number;
+    frequency?: 'rare' | 'occasional' | 'frequent' | 'continuous';
+    dataPattern?: DataPatternType;
+}): {
+    preset: PerformancePresetName;
+    pattern: DataPatternType | undefined;
+    config: PerformanceConfig;
+    reason: string;
+};
+/**
+ * Check if performance optimization is worth it
+ */
+export declare function shouldOptimize(metrics: {
+    requestCount: number;
+    averageResponseTime: number;
+    errorRate: number;
+    cacheHitRate?: number;
+}): {
+    shouldOptimize: boolean;
+    reasons: string[];
+};
+/**
+ * Type guards for performance monitoring
+ */
+export declare function isPerformanceRequestConfig(config: unknown): config is PerformanceRequestConfig;
+export declare function isPerformanceFetchResponse(response: unknown): response is PerformanceFetchResponse;
+export declare function isPerformanceResponseError(error: unknown): error is PerformanceResponseError;
+//# sourceMappingURL=utils.d.ts.map

package/dist/api/performance/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/api/performance/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAEV,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,iBAAiB,CAIvF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,SAAS,CAajG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,iBAAiB,CAI5E;AAgDD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CAStF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,OAAO,EAAE,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,GAC5C,iBAAiB,CAUnB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,CAoCtF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CA2CT;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC5C,GAAG,MAAM,CA2BT;AAgDD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC;IAC9D,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B,GAAG;IACF,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,EAAE,eAAe,GAAG,SAAS,CAAC;IACrC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAmBA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG;IACF,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAgCA;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,wBAAwB,CAE9F;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,wBAAwB,CAEtC;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,wBAAwB,CAE5F"}

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

@@ -0,0 +1,10 @@
+/**
+ * Polling Configuration Module
+ * Provides polling strategies and utilities for repeated API requests
+ *
+ * @module polling
+ */
+export { pollingStrategies, createPollingStrategy, applyPollingStrategy, type PollingStrategyName, } from './strategies';
+export { isPollingActive, calculatePollingDuration, getSSRSafePollingConfig, createProgressivePolling, createConditionalPolling, createVisibilityAwarePolling, mergePollingConfigs, isValidPollingConfig, } from './utils';
+export type { PollingConfig, PollingResult, ProgressivePollingOptions, ConditionalPollingOptions, } from '@plyaz/types/api';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/polling/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,4BAA4B,EAC5B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,aAAa,EACb,aAAa,EACb,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC"}