@plyaz/api 1.0.1 → 1.1.0

package/dist/api/client/helpers/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../../../src/api/client/helpers/headers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAGjB,MAAM,kBAAkB,CAAC;AAS1B;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAiBrF;AAsGD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,gBAAgB,EACzB,WAAW,GAAE,UAAe,GAC3B,OAAO,CAAC,UAAU,CAAC,CAgDrB"}

package/dist/api/client/helpers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Client Helper Functions
+ * Export all helper modules for API client creation
+ */
+export { applyCacheStrategyConfig, applyRetryStrategyConfig, applyPollingStrategyConfig, applyPerformancePresetConfig, applyUnifiedStrategyToConfig, applyIndividualStrategies, applyCustomQualityPresetStrategies, } from './strategies';
+export { applyHeaderPresets, processHeaders } from './headers';
+export { getNetworkQualityWithThresholds, checkOverrideTriggers, setupTemporaryOverride, setupNetworkMonitoring, } from './network';
+export { trackDirectCacheConfig, trackSpreadProperties, createPreservedConfig } from './tracking';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/client/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/client/helpers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,kCAAkC,GACnC,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG/D,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/api/client/helpers/interceptors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Interceptor Helper Functions
+ * Handles request/response interceptor chains and transformations
+ */
+import type { RequestConfig } from 'fetchff';
+import type { RequestInterceptor, ResponseInterceptor, ErrorInterceptor, RetryInterceptor, ApiClientOptions, SetupUnifiedHandlersParams } from '@plyaz/types/api';
+/**
+ * Create unified onRetry handler that triggers ApiConfig.onRetry[] and emits events
+ */
+export declare function createOnRetryHandler(handlers: RetryInterceptor[] | undefined): RequestConfig<unknown, unknown, unknown, unknown>['onRetry'];
+/**
+ * Create unified onRequest handler that triggers ApiConfig.onRequest[] and emits events
+ */
+export declare function createOnRequestHandler(handlers: RequestInterceptor[] | undefined, enrichedHeadersConfig?: ApiClientOptions['enrichedHeaders']): RequestConfig<unknown, unknown, unknown, unknown>['onRequest'];
+/**
+ * Create unified onResponse handler that triggers ApiConfig.onResponse[] and emits events
+ */
+export declare function createOnResponseHandler(handlers: ResponseInterceptor[] | undefined, clearTemporaryOverrides?: () => void, clearOnComplete?: boolean): RequestConfig<unknown, unknown, unknown, unknown>['onResponse'];
+/**
+ * Create unified onError handler with ApiPackageError integration and ApiConfig.onError[] calls
+ */
+export declare function createOnErrorHandler(handlers: ErrorInterceptor[] | undefined, clearTemporaryOverrides?: () => void, clearOnComplete?: boolean): RequestConfig<unknown, unknown, unknown, unknown>['onError'];
+export declare function setupUnifiedHandlers(params: SetupUnifiedHandlersParams): {
+    onRequest: RequestConfig<unknown, unknown, unknown, unknown>['onRequest'];
+    onResponse: RequestConfig<unknown, unknown, unknown, unknown>['onResponse'];
+    onError: RequestConfig<unknown, unknown, unknown, unknown>['onError'];
+    onRetry: RequestConfig<unknown, unknown, unknown, unknown>['onRetry'];
+};
+//# sourceMappingURL=interceptors.d.ts.map

package/dist/api/client/helpers/interceptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../../../../src/api/client/helpers/interceptors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgC,MAAM,SAAS,CAAC;AAM3E,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAEhB,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,kBAAkB,CAAC;AAyF1B;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACvC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAwB9D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,SAAS,EAC1C,qBAAqB,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,GAC1D,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,WAAW,CAAC,CAsDhE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,SAAS,EAC3C,uBAAuB,CAAC,EAAE,MAAM,IAAI,EACpC,eAAe,CAAC,EAAE,OAAO,GACxB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,YAAY,CAAC,CAiCjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,EACxC,uBAAuB,CAAC,EAAE,MAAM,IAAI,EACpC,eAAe,CAAC,EAAE,OAAO,GACxB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAqD9D;AA6BD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG;IACxE,SAAS,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC;IAC1E,UAAU,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;IAC5E,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC;IACtE,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC;CACvE,CA8CA"}

package/dist/api/client/helpers/network.d.ts

@@ -0,0 +1,21 @@
+import type { NetworkInfo, ApiClientOptions, ApiClientInstance, TemporaryOverrideSetupConfig } from '@plyaz/types/api';
+import { NETWORK_QUALITY } from '@plyaz/types/api';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Helper function to determine network quality with custom thresholds
+ */
+export declare function getNetworkQualityWithThresholds(networkInfo: NetworkInfo, thresholds: NonNullable<ApiClientOptions['networkAware']>['thresholds']): NETWORK_QUALITY;
+/**
+ * Check if network override triggers are met
+ */
+export declare function checkOverrideTriggers(networkInfo: NetworkInfo, options: NonNullable<ApiClientOptions['networkAware']>): boolean;
+/**
+ * Setup temporary override system for network conditions
+ */
+export declare function setupTemporaryOverride(config: TemporaryOverrideSetupConfig<ApiClientInstance<EndpointsList>>): () => void;
+/**
+ * Setup network monitoring for API client
+ * Configures network-aware features including quality monitoring and temporary overrides
+ */
+export declare function setupNetworkMonitoring(client: ApiClientInstance<EndpointsList>, options: ApiClientOptions, userConfig: ApiClientOptions['preservedConfig']): () => void;
+//# sourceMappingURL=network.d.ts.map

package/dist/api/client/helpers/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../../src/api/client/helpers/network.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAGV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,EAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAkB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA0CrD;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,WAAW,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,GACtE,eAAe,CAgBjB;AAqDD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,WAAW,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,GACrD,OAAO,CAcT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,4BAA4B,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,GACrE,MAAM,IAAI,CA2GZ;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,iBAAiB,CAAC,aAAa,CAAC,EACxC,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,GAC9C,MAAM,IAAI,CAiEZ"}

package/dist/api/client/helpers/strategies.d.ts

@@ -0,0 +1,30 @@
+import type { NETWORK_QUALITY, UnifiedStrategyName, DebuggerConfigSource, ApiClientOptions, ApiConfig } from '@plyaz/types/api';
+/**
+ * Apply cache strategy configuration
+ */
+export declare function applyCacheStrategyConfig(config: ApiConfig, strategyName: string, source: DebuggerConfigSource): void;
+/**
+ * Apply retry strategy configuration
+ */
+export declare function applyRetryStrategyConfig(config: ApiConfig, strategyName: string, source: DebuggerConfigSource): void;
+/**
+ * Apply polling strategy configuration
+ */
+export declare function applyPollingStrategyConfig(config: ApiConfig, strategyName: string, source: DebuggerConfigSource): void;
+/**
+ * Apply performance preset configuration
+ */
+export declare function applyPerformancePresetConfig(config: ApiConfig, presetName: string, source: DebuggerConfigSource): void;
+/**
+ * Apply unified strategy to configuration with tracking
+ */
+export declare function applyUnifiedStrategyToConfig(config: ApiConfig, unifiedStrategyName: UnifiedStrategyName): ApiConfig;
+/**
+ * Apply individual strategies to configuration with tracking
+ */
+export declare function applyIndividualStrategies(config: ApiConfig, options: ApiClientOptions): ApiConfig;
+/**
+ * Apply custom quality preset to config (using strategy names)
+ */
+export declare function applyCustomQualityPresetStrategies(config: ApiConfig, preset: NonNullable<NonNullable<ApiClientOptions['networkAware']>['qualityPresets']>[NETWORK_QUALITY] | undefined): void;
+//# sourceMappingURL=strategies.d.ts.map

package/dist/api/client/helpers/strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../../../../src/api/client/helpers/strategies.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EAEpB,gBAAgB,EAChB,SAAS,EACV,MAAM,kBAAkB,CAAC;AAC1B;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,oBAAoB,GAC3B,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,oBAAoB,GAC3B,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,oBAAoB,GAC3B,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,oBAAoB,GAC3B,IAAI,CAsCN;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,mBAAmB,GACvC,SAAS,CAuBX;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAqBjG;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,SAAS,EACjB,MAAM,EACF,WAAW,CAAC,WAAW,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,GAC7F,SAAS,GACZ,IAAI,CAsBN"}

package/dist/api/client/helpers/tracking.d.ts

@@ -0,0 +1,15 @@
+import type { ApiClientOptions, ApiConfig } from '@plyaz/types/api';
+/**
+ * Track direct cache configuration
+ */
+export declare function trackDirectCacheConfig(cache: ApiConfig['cache']): void;
+/**
+ * Track spread properties from options
+ */
+export declare function trackSpreadProperties(options: ApiClientOptions): void;
+/**
+ * Create preserved user configuration
+ * Store original user configuration if preservation is enabled
+ */
+export declare function createPreservedConfig(options: ApiClientOptions): ApiClientOptions['preservedConfig'];
+//# sourceMappingURL=tracking.d.ts.map

package/dist/api/client/helpers/tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../../../src/api/client/helpers/tracking.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEpE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAStE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CA4BrE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,GACxB,gBAAgB,CAAC,iBAAiB,CAAC,CAarC"}

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

@@ -0,0 +1,7 @@
+/**
+ * API Client Module
+ * Main client factory and exports
+ */
+export { createApiClient } from './createApiClient';
+export { setupClientEvents, shouldApplyConfig } from './clientEventManager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/api/config/adapter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Configuration Adapter
+ * Converts our abstracted configuration to fetchff's format
+ * This is the ONLY place where we handle the mapping
+ */
+import type { RequestConfig as FetchffConfig } from 'fetchff';
+import type { ApiConfig, RequestConfig } from '@plyaz/types/api';
+/**
+ * Convert our ApiConfig to fetchff's RequestConfig
+ * This is where the mapping happens between our abstraction and fetchff
+ */
+export declare function toFetchffConfig(config: ApiConfig | RequestConfig): FetchffConfig;
+/**
+ * Convert endpoints to fetchff format
+ * Handles cache configuration conversion for individual endpoints
+ */
+export declare function convertEndpointsToFetchff(endpoints: Record<string, unknown>): Record<string, FetchffConfig & {
+    url?: string;
+}>;
+/**
+ * Convert fetchff's config back to our format (for response.config)
+ * Since ApiResponse extends FetchResponse, we mostly just need to handle the config mapping
+ */
+export declare function fromFetchffConfig(config: FetchffConfig): RequestConfig;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/api/config/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/api/config/adapter.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,OAAO,KAAK,EAEV,aAAa,IAAI,aAAa,EAE/B,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EAKd,MAAM,kBAAkB,CAAC;AAgI1B;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,aAAa,CAiChF;AA2LD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkClD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAiFtE"}

package/dist/api/config/configBuilder.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Configuration Builder
+ * Handles merging and building configurations with proper precedence
+ */
+import type { ApiConfig } from '@plyaz/types/api';
+/**
+ * Configuration builder class
+ * Provides a fluent API for building configurations
+ */
+export declare class ConfigBuilder {
+    private config;
+    /**
+     * Set the base configuration
+     */
+    base(config: ApiConfig): this;
+    /**
+     * Add a configuration layer
+     */
+    with(config: Partial<ApiConfig>): this;
+    /**
+     * Add request interceptor(s)
+     */
+    onRequest(interceptor: ApiConfig['onRequest']): this;
+    /**
+     * Add response interceptor(s)
+     */
+    onResponse(interceptor: ApiConfig['onResponse']): this;
+    /**
+     * Add error interceptor(s)
+     */
+    onError(interceptor: ApiConfig['onError']): this;
+    /**
+     * Set retry configuration
+     */
+    retry(config: ApiConfig['retry']): this;
+    /**
+     * Set cache configuration
+     */
+    cache(config: ApiConfig['cache']): this;
+    /**
+     * Check if polling config should be merged
+     */
+    private shouldMergePolling;
+    /**
+     * Set polling configuration
+     */
+    polling(config: ApiConfig['polling']): this;
+    /**
+     * Build the final configuration
+     */
+    build(): ApiConfig;
+}
+/**
+ * Create a new configuration builder
+ */
+export declare function createConfigBuilder(base?: ApiConfig): ConfigBuilder;
+/**
+ * Merge multiple configurations
+ * Priority: left to right (later configs override earlier ones)
+ */
+export declare function mergeConfigs(...configs: Partial<ApiConfig>[]): ApiConfig;
+//# sourceMappingURL=configBuilder.d.ts.map

package/dist/api/config/configBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configBuilder.d.ts","sourceRoot":"","sources":["../../../src/api/config/configBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;IAE/B;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAK7B;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;IAKtC;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI;IAiBpD;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,SAAS,CAAC,YAAY,CAAC,GAAG,IAAI;IAiBtD;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI;IAiBhD;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI;IAKvC;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI;IAMvC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI;IAmB3C;;OAEG;IACH,KAAK,IAAI,SAAS;CAGnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,aAAa,CAMnE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,GAAG,SAAS,CAExE"}

package/dist/api/config/configManager.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Configuration Management Utilities
+ *
+ * Provides utilities for managing configuration state with different merge strategies
+ * and proper handling of configuration hierarchies and overrides.
+ *
+ * This utility properly handles:
+ * - Global config → Client config → Temporary overrides hierarchy
+ * - configOverride option from initial client creation
+ * - Different update strategies (merge, replace, temporary)
+ * - Preservation of essential fields during replace operations
+ */
+import type { ApiConfig, ConfigUpdateStrategy, ConfigState, ConfigUpdateOptions, ConfigUpdateResult } from '@plyaz/types/api';
+/**
+ * Creates a new configuration state with initial config
+ */
+export declare function createConfigState(initialConfig: ApiConfig): ConfigState;
+/**
+ * Applies configuration updates with the specified strategy
+ *
+ * @param state - Current configuration state
+  // eslint-disable-next-line complexity
+ * @param updates - Configuration updates to apply
+ * @param options - Options for how to apply the updates
+ * @returns Result containing updated state and effective configuration
+ */
+export declare function applyConfigUpdate(state: ConfigState, updates: Partial<ApiConfig>, options?: ConfigUpdateOptions): ConfigUpdateResult;
+/**
+ * Gets the effective configuration by merging base with temporary overrides
+ */
+export declare function getEffectiveConfig(state: ConfigState): ApiConfig;
+/**
+ * Clears temporary overrides from the configuration state
+ */
+export declare function clearTemporaryOverrides(state: ConfigState): ConfigUpdateResult;
+/**
+ * Handles configOverride option from initial client options
+ *
+ * This is specifically for handling the configOverride field in ApiConfig,
+ * which allows initial configuration overrides with a specific strategy.
+ */
+export declare function applyConfigOverride(state: ConfigState, configOverride: ApiConfig['configOverride']): ConfigUpdateResult;
+/**
+ * Gets information about the configuration hierarchy
+ */
+export declare function getConfigHierarchy(state: ConfigState, hasGlobalConfig: boolean, initialStrategy?: ConfigUpdateStrategy): {
+    hasGlobalConfig: boolean;
+    hasClientConfig: boolean;
+    hasTemporaryOverrides: boolean;
+    configOverrideStrategy?: ConfigUpdateStrategy;
+};
+/**
+ * Gets a list of field keys that have temporary overrides
+ */
+export declare function getActiveOverrideKeys(state: ConfigState): string[] | undefined;
+/**
+ * Creates a deep copy of configuration to prevent external mutations
+ */
+export declare function cloneConfig(config: ApiConfig): ApiConfig;
+/**
+ * Validates that a configuration update is valid
+ */
+export declare function validateConfigUpdate(updates: Partial<ApiConfig>, options?: ConfigUpdateOptions): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=configManager.d.ts.map

package/dist/api/config/configManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configManager.d.ts","sourceRoot":"","sources":["../../../src/api/config/configManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EACV,SAAS,EAET,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AA8B1B;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,SAAS,GAAG,WAAW,CAWvE;AA2HD;;;;;;;;GAQG;AAEH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,EAC3B,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CAgDpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAMhE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB,CAiC9E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,cAAc,EAAE,SAAS,CAAC,gBAAgB,CAAC,GAC1C,kBAAkB,CAgDpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,eAAe,EAAE,OAAO,EACxB,eAAe,CAAC,EAAE,oBAAoB,GACrC;IACD,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,sBAAsB,CAAC,EAAE,oBAAoB,CAAC;CAC/C,CAOA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,GAAG,SAAS,CAG9E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAkBxD;AAED;;GAEG;AAEH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,EAC3B,OAAO,CAAC,EAAE,mBAAmB,GAC5B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA8CtC"}

package/dist/api/config/global.d.ts

@@ -0,0 +1,106 @@
+import type { ApiConfig } from '@plyaz/types/api';
+/**
+ * Get the current global configuration.
+ * Returns our stored ApiConfig, not fetchff's global config.
+ *
+ * @returns Current global configuration
+ *
+ * @example
+ * ```typescript
+ * const config = getGlobalConfig();
+ * console.log('Current timeout:', config.timeout);
+ * console.log('Retry attempts:', config.retry?.attempts);
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare function getGlobalConfig(): ApiConfig;
+export declare function setGlobalConfig(config: ApiConfig): void;
+/**
+ * Update the global configuration with partial values.
+ * Merges the provided configuration with the existing global configuration.
+ *
+ * @param config - Partial configuration to merge
+ *
+ * @example
+ * ```typescript
+ * // Update only timeout, keeping other settings
+ * updateGlobalConfig({
+ *   timeout: 45000
+ * });
+ *
+  // eslint-disable-next-line complexity
+ * // Update retry configuration
+ * updateGlobalConfig({
+ *   retry: { attempts: 5 }
+ * });
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare function updateGlobalConfig(config: Partial<ApiConfig>): void;
+/**
+ * Reset global configuration to defaults.
+ * Clears all global configuration settings.
+ *
+ * @example
+ * ```typescript
+ * // Reset to empty defaults
+ * resetGlobalConfig();
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare function resetGlobalConfig(): void;
+/**
+ * Configure global settings based on environment.
+ * Helper function for common environment-based setup patterns.
+ *
+ * @param env - Environment name ('production', 'development', 'test')
+ * @param config - Configuration for the environment
+ *
+ * @example
+ * ```typescript
+ * // Configure for current environment
+ * import { getEnv } from '@utils/environment';
+ * configureForEnvironment(getEnv('NODE_ENV'), {
+ *   production: {
+ *     timeout: 15000,
+ *     retry: { attempts: 3 },
+ *     debug: false
+ *   },
+ *   development: {
+ *     timeout: 60000,
+ *     retry: { attempts: 5 },
+ *     debug: true
+ *   },
+ *   test: {
+ *     timeout: 5000,
+ *     retry: { attempts: 0 },
+ *     debug: false
+ *   }
+ * });
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare function configureForEnvironment(env: string | undefined, config: Record<string, ApiConfig>): void;
+/**
+ * Apply a preset configuration template.
+ * Combines existing cache and polling strategies for common use cases.
+ *
+ * @param preset - Name of the preset to apply
+ *
+ * @example
+ * ```typescript
+ * // Apply mobile-optimized settings
+ * applyConfigPreset('mobile');
+ *
+ * // Apply high-reliability settings
+ * applyConfigPreset('reliable');
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare function applyConfigPreset(preset: 'default' | 'mobile' | 'reliable' | 'fast' | 'offline-first'): void;
+//# sourceMappingURL=global.d.ts.map

package/dist/api/config/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../../src/api/config/global.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,SAAS,EAIV,MAAM,kBAAkB,CAAC;AAQ1B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAE3C;AAqLD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0EvD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAEnE;AAED;;;;;;;;;;;GAWG;AAEH,wBAAgB,iBAAiB,IAAI,IAAI,CAqExC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAChC,IAAI,CAeN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,eAAe,GACnE,IAAI,CAuCN"}

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

@@ -0,0 +1,11 @@
+/**
+ * Configuration Module
+ * Provides vendor-agnostic configuration with proper type safety
+ *
+ * Note: Types are available from @plyaz/types/api, not re-exported here
+ */
+export { ConfigBuilder, createConfigBuilder, mergeConfigs, } from './configBuilder';
+export { toFetchffConfig, fromFetchffConfig, convertEndpointsToFetchff } from './adapter';
+export { getGlobalConfig, setGlobalConfig, updateGlobalConfig, resetGlobalConfig, configureForEnvironment, applyConfigPreset, } from './global';
+export { createConfigState, applyConfigUpdate, getEffectiveConfig, clearTemporaryOverrides, applyConfigOverride, getConfigHierarchy, getActiveOverrideKeys, cloneConfig, validateConfigUpdate, } from './configManager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAG1F,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/api/debugger/DebugReport.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Comprehensive Debug Report Generator
+ *
+ * Provides detailed analysis of all API package operations including:
+ * - Compliance analysis with auto-detection
+ * - Header transformation security analysis
+ * - Event migration tracking
+ * - Network adaptation effectiveness
+ * - Temporary configuration lifecycle
+ * - Fetchff interceptor chain monitoring
+ *
+ * - Performance recommendations
+ */
+import type { ComprehensiveDebugReport } from '@plyaz/types/api';
+/**
+ * Security analysis for headers
+ */
+/**
+ * Event migration analysis
+ */
+/**
+ * Network adaptation analysis
+ */
+/**
+ * Temporary config lifecycle analysis
+ */
+/**
+ * Fetchff interceptor analysis
+ */
+/**
+ * Event emitter factory analysis
+ */
+/**
+ * Event scope analysis
+ */
+/**
+ * Available events analysis by source
+ */
+/**
+ * Event validation report
+ */
+/**
+ * Comprehensive event emitter analysis
+ */
+/**
+ * Comprehensive debug report
+ */
+/**
+ * Generate comprehensive debug report
+ */
+export declare function generateComprehensiveReport(): Promise<ComprehensiveDebugReport>;
+/**
+ * Export formatted report with colors
+ */
+export declare function formatReportForConsole(report: ComprehensiveDebugReport): string;
+/**
+ * Log network configuration override
+ * This provides comprehensive logging for network overrides
+ */
+export declare function logNetworkOverride(params: {
+    property: string;
+    originalValue: unknown;
+    overrideValue: unknown;
+    source: string;
+    reason: string;
+    networkInfo?: Record<string, unknown>;
+    networkQuality?: string;
+    duration?: number;
+    trigger?: string;
+}): void;
+//# sourceMappingURL=DebugReport.d.ts.map

package/dist/api/debugger/DebugReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugReport.d.ts","sourceRoot":"","sources":["../../../src/api/debugger/DebugReport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAEV,wBAAwB,EAsBzB,MAAM,kBAAkB,CAAC;AAiG1B;;GAEG;AACH;;GAEG;AACH;;GAEG;AACH;;GAEG;AACH;;GAEG;AACH;;GAEG;AACH;;GAEG;AACH;;GAEG;AACH;;GAEG;AACH;;GAEG;AACH;;GAEG;AACH;;GAEG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,wBAAwB,CAAC,CA6FrF;AAilDD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAqB/E;AA+oBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CA8BP"}