@plyaz/types 1.7.19 → 1.7.21

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

@@ -2,8 +2,11 @@
  * API Client Types
  * Defines the client interface and options
  */
+import type { ApiHandlerMethods } from 'fetchff';
 import type { ApiConfig } from '../config';
 import type { ConfigUpdateStrategy, HandlerStrategy } from '../events';
+import type { EndpointTypes } from '../endpoints';
+import type { UnknownRecord } from 'type-fest';
 /**
  * Options for creating an API client
  * Endpoints are automatically included from src/api/endpoints
@@ -23,14 +26,14 @@ import type { ConfigUpdateStrategy, HandlerStrategy } from '../events';
  *
  * Note: ApiConfig is imported from config/types, not defined here to avoid circular dependencies
  */
-export type ApiClientOptions = Record<string, unknown>;
+export type ApiClientOptions = ApiConfig;
 /**
  * API client instance with full TypeScript support
  * The client IS the fetchff instance with all endpoint methods
  *
  * Note: Full type definition requires EndpointTypes and endpoints from api package
  */
-export type ApiClientInstance = Record<string, unknown>;
+export type ApiClientInstance<EndpointsList = UnknownRecord> = ApiHandlerMethods<EndpointTypes, EndpointsList>;
 /**
  * Event handler registration options
  */

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

@@ -15,7 +15,6 @@ import type { ConfigUpdateStrategy, HandlerStrategy, EventScopeWithTemporary } f
 import type { NETWORK_QUALITY } from '../network';
 import type { HeaderEventHandlers, NetworkEventHandlers, ConfigEventHandlers, ClientEventHandlers, CacheEventHandlers, PerformanceEventHandlers } from '../events';
 import type { ApiClientOptions } from '../client';
-import type { CacheConfig } from '../../features';
 import type { DebugEventsConfig } from '../debugger';
 /**
  * HTTP Methods - extend from fetchff but uppercase
@@ -83,7 +82,7 @@ export interface ApiConfig extends Partial<Omit<FetchffRequestConfig, 'retry' |
     /** Retry configuration with better naming */
     retry?: RetryConfig | false;
     /** Cache configuration with better naming */
-    cache?: CacheConfig;
+    cache?: ApiCacheConfig;
     /**
      * Polling configuration
      * Can be:

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

@@ -150,3 +150,4 @@ export declare const UNIFIED_OPERATIONS: {
     readonly HANDLER_UNREGISTERED: "handler_unregistered";
     readonly SCOPE_LISTENERS_CLEARED: "scope_listeners_cleared";
 };
+export type DebuggerConfigSource = (typeof DEBUGGER_CONFIG_SOURCES)[keyof typeof DEBUGGER_CONFIG_SOURCES];

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

@@ -2,8 +2,8 @@
  * Debug Event Types
  * Type definitions for all debug-related events and data structures
  */
-import type { DEBUG_EVENTS, NetworkConfigOverrideEvent, NetworkQualityEvent } from '../events';
-import type { ConfigSource } from '..';
+import type { ConfigChangeEvent, HeadersTrackedEvent, NetworkConfigOverrideEvent, NetworkOverrideEvent, NetworkQualityEvent } from '../events';
+import type { DebuggerConfigSource } from '..';
 import type { ApiConfig } from '../config';
 import type { EventTrackingAnalysis } from './factories';
 import type { NETWORK_QUALITY, NetworkClientHints, NetworkInfo } from '../network';
@@ -96,7 +96,7 @@ export interface ConfigHistoryEntry {
         property: string;
         previousValue: unknown;
         newValue: unknown;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
     }>;
     networkConditions?: {
         quality: NETWORK_QUALITY;
@@ -217,45 +217,9 @@ export type EventOperationType = 'on' | 'once' | 'off' | 'emit' | 'emit_across_s
  * Combined operation types for unified tracking
  */
 export type UnifiedOperationType = FactoryOperationType | EventOperationType;
-/**
- * Debug event types
- */
-export interface DebugEvent {
-    type: string;
-    data: unknown;
-    timestamp: string;
-}
-export interface ConfigConflictEvent extends DebugEvent {
-    type: typeof DEBUG_EVENTS.CONFIG_CONFLICT;
-    data: ConfigConflict;
-}
-export interface ConfigChangeEvent extends DebugEvent {
-    type: typeof DEBUG_EVENTS.CONFIG_CHANGE;
-    data: {
-        property: string;
-        oldValue: unknown;
-        newValue: unknown;
-        source: ConfigSource;
-    };
-}
-export interface HeadersTrackedEvent extends DebugEvent {
-    type: typeof DEBUG_EVENTS.HEADERS_TRACKED;
-    data: {
-        headers: Record<string, string>;
-        source: ConfigSource;
-    };
-}
-export interface NetworkOverrideEvent extends DebugEvent {
-    type: typeof DEBUG_EVENTS.NETWORK_OVERRIDE;
-    data: {
-        overrides: ActiveOverride[];
-        reason: string;
-        temporary?: boolean;
-    };
-}
 export interface TrackedValue {
     value: unknown;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     timestamp: number;
     metadata?: Record<string, unknown>;
 }
@@ -270,7 +234,7 @@ export interface HeaderChanges {
 export interface HeaderTransformation {
     stage: HeaderStage;
     headers: Record<string, string>;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     timestamp: number;
     changes?: HeaderChanges;
     metadata?: Record<string, unknown>;
@@ -284,7 +248,7 @@ export interface NetworkOverrideParams {
     property: string;
     originalValue: unknown;
     overrideValue: unknown;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     reason: string;
     networkInfo?: NetworkInfo;
     networkQuality?: NETWORK_QUALITY;
@@ -295,12 +259,12 @@ export interface NetworkOverrideParams {
 export interface DebugHistoryEntry {
     type: 'config' | 'header' | 'network' | 'performance' | 'event' | 'event_operation';
     timestamp: number;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     changes?: Array<{
         property: string;
         oldValue: unknown;
         newValue: unknown;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         timestamp: number;
     }>;
     conflicts?: ConfigConflict[];
@@ -313,7 +277,7 @@ export interface TrackingResult {
         property: string;
         oldValue: unknown;
         newValue: unknown;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         timestamp: number;
     }>;
     conflicts: ConfigConflict[];
@@ -361,7 +325,7 @@ export interface DebugReport {
     complianceReport: ComplianceReport;
     recommendations: string[];
 }
-export interface ConfigUpdateStrategy {
+export interface DebuggerConfigUpdateStrategy {
     strategy?: 'merge' | 'replace' | 'temporary';
     preserveFields?: string[];
     trackUpdate?: boolean;

package/dist/api/endpoints/types.d.ts

@@ -1,5 +1,12 @@
+import type { CampaignEndpointTypes } from './campaigns';
+import type { PollingEndpointTypes } from './health';
 /**
  * Query parameters type - matches fetchff's flexible param handling
  * Supports objects, URLSearchParams, and arrays of name-value pairs
  */
 export type QueryParams = Record<string, string | number | boolean | string[] | number[]> | URLSearchParams | Array<[string, string]>;
+/**
+ * All endpoint types combined
+ */
+export interface EndpointTypes extends CampaignEndpointTypes, PollingEndpointTypes {
+}

package/dist/api/events/enum.d.ts

@@ -138,7 +138,7 @@ export declare const DEBUG_EVENTS: {
 /**
  * Configuration sources - where config updates originate from
  */
-export declare const CONFIG_SOURCES: {
+export declare const EVENTS_CONFIG_SOURCES: {
     readonly GLOBAL: "global";
     readonly CREATE_API_CLIENT: "createApiClient";
     readonly UPDATE_CONFIG: "updateConfig";
@@ -259,3 +259,4 @@ export declare const ALL_EVENTS: {
     readonly CACHE_HIT: "headers:cache:hit";
     readonly CACHE_MISS: "headers:cache:miss";
 };
+export type EventsConfigSource = (typeof EVENTS_CONFIG_SOURCES)[keyof typeof EVENTS_CONFIG_SOURCES];

package/dist/api/events/factories/config/types.d.ts

@@ -2,9 +2,7 @@
  * Config Event Factory
  * Factory for creating and emitting configuration-related events
  */
-import type { EventOptions } from '../types';
-import type { CONFIG_EVENTS, ConfigSource } from '../../../events';
-import type { ApiConfig } from '../../../config';
+import type { DebuggerConfigSource, CONFIG_EVENTS, EventOptions, ApiConfig } from '../../..';
 /**
  * Configuration updated event
  */
@@ -14,7 +12,7 @@ export interface ConfigGlobalUpdatedEvent {
     data: {
         previous: ApiConfig;
         current: ApiConfig;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         changes: string[];
     };
 }
@@ -27,7 +25,7 @@ export interface ConfigGlobalResetEvent {
     data: {
         previous: ApiConfig;
         defaults: ApiConfig;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
     };
 }
 /**
@@ -39,7 +37,7 @@ export interface ConfigEnvironmentEvent {
     data: {
         environment: string;
         config: ApiConfig;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
     };
 }
 /**
@@ -51,7 +49,7 @@ export interface ConfigPresetAppliedEvent {
     data: {
         presetName: string;
         config: ApiConfig;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
     };
 }
 /**
@@ -64,7 +62,7 @@ export type ConfigEventData = ConfigGlobalUpdatedEvent | ConfigGlobalResetEvent
 export interface EmitGlobalUpdatedOptions extends EventOptions {
     previous: ApiConfig;
     current: ApiConfig;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     changes: string[];
 }
 /**

package/dist/api/events/factories/debug/types.d.ts

@@ -5,7 +5,7 @@
 import { type BaseEvent, type EventOptions } from '..';
 import type { DEBUG_EVENTS } from '../..';
 import type { ConfigConflict, DebugInfo, ActiveOverride, PerformanceImpact, MonitoringAlert } from '../../../debugger';
-import type { ConfigSource } from '../../types';
+import type { DebuggerConfigSource } from '../../..';
 /**
  * Base structure for debug events
  */
@@ -29,7 +29,7 @@ export interface ConfigChangeEvent extends BaseEvent {
         property: string;
         oldValue: unknown;
         newValue: unknown;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         reason?: string;
     };
 }
@@ -40,7 +40,7 @@ export interface HeadersTrackedEvent extends BaseEvent {
     type: typeof DEBUG_EVENTS.HEADERS_TRACKED;
     data: {
         headers: Record<string, string>;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         metadata?: {
             phase: 'config' | 'request' | 'response';
             reason?: string;
@@ -55,6 +55,7 @@ export interface NetworkOverrideEvent extends BaseEvent {
     data: {
         overrides: ActiveOverride[];
         reason: string;
+        temporary?: boolean;
     };
 }
 /**
@@ -91,7 +92,7 @@ export interface ConfigTrackingEvent extends BaseEvent {
     type: typeof DEBUG_EVENTS.CONFIG_TRACKED;
     data: {
         config: Record<string, unknown>;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         phase: 'initialization' | 'runtime' | 'update';
         metadata?: Record<string, unknown>;
     };
@@ -103,7 +104,7 @@ export interface EmitConfigChangeOptions extends EventOptions {
     property: string;
     oldValue: unknown;
     newValue: unknown;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     reason?: string;
 }
 /**
@@ -111,7 +112,7 @@ export interface EmitConfigChangeOptions extends EventOptions {
  */
 export interface EmitHeadersTrackedOptions extends EventOptions {
     headers: Record<string, string>;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     phase?: 'config' | 'request' | 'response';
     reason?: string;
 }
@@ -120,7 +121,7 @@ export interface EmitHeadersTrackedOptions extends EventOptions {
  */
 export interface EmitConfigTrackedOptions extends EventOptions {
     config: Record<string, unknown>;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     phase?: 'initialization' | 'runtime' | 'update';
     metadata?: Record<string, unknown>;
 }

package/dist/api/events/factories/headers/types.d.ts

@@ -4,7 +4,7 @@
  */
 import { type BaseEvent, type EventOptions } from '..';
 import type { ApiHeaders } from '../../../headers';
-import type { ConfigSource, HEADER_EVENTS } from '../..';
+import type { DebuggerConfigSource, HEADER_EVENTS } from '../../..';
 /**
  * Base structure for header events
  */
@@ -25,7 +25,7 @@ export interface HeadersChangedEvent extends HeaderEvent {
             modified: ApiHeaders;
             removed: string[];
         };
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         reason?: string;
     };
 }
@@ -55,12 +55,12 @@ export interface HeadersConflictEvent extends HeaderEvent {
     data: {
         header: string;
         conflicts: Array<{
-            source: ConfigSource;
+            source: DebuggerConfigSource;
             value: string;
             priority: number;
         }>;
         resolution: {
-            source: ConfigSource;
+            source: DebuggerConfigSource;
             value: string;
             reason: string;
         };
@@ -76,7 +76,7 @@ export interface HeadersOverrideEvent extends HeaderEvent {
         header: string;
         previousValue: string | undefined;
         newValue: string;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         reason: string;
         temporary?: boolean;
     };
@@ -103,7 +103,7 @@ export interface HeadersFilteredEvent extends HeaderEvent {
         filtered: ApiHeaders;
         removedHeaders: string[];
         reason: string;
-        source?: ConfigSource;
+        source?: DebuggerConfigSource;
     };
 }
 /**
@@ -166,7 +166,7 @@ export interface HeadersCacheMissEvent extends HeaderEvent {
 export interface EmitChangedOptions extends EventOptions {
     previous: ApiHeaders;
     current: ApiHeaders;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     reason?: string;
 }
 /**
@@ -184,12 +184,12 @@ export interface EmitEnrichedOptions extends EventOptions {
 export interface EmitConflictOptions extends EventOptions {
     header: string;
     conflicts: Array<{
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         value: string;
         priority: number;
     }>;
     resolution: {
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         value: string;
         reason: string;
     };
@@ -202,7 +202,7 @@ export interface EmitOverrideOptions extends EventOptions {
     header: string;
     previousValue: string | undefined;
     newValue: string;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     reason: string;
     temporary?: boolean;
 }
@@ -222,7 +222,7 @@ export interface EmitFilteredOptions extends EventOptions {
     original: ApiHeaders;
     filtered: ApiHeaders;
     reason: string;
-    source?: ConfigSource;
+    source?: DebuggerConfigSource;
 }
 /**
  * Options for emitCached method

package/dist/api/events/factories/network/types.d.ts

@@ -4,7 +4,7 @@
  */
 import { type BaseEvent, type EventOptions } from '..';
 import type { NetworkClientHints as NetworkHints, NETWORK_QUALITY, NetworkInfo } from '../../../network';
-import type { ConfigSource, NETWORK_EVENTS } from '../..';
+import type { DebuggerConfigSource, NETWORK_EVENTS } from '../../..';
 /**
  * Base structure for network events
  */
@@ -57,7 +57,7 @@ export interface NetworkConfigOverrideEvent extends NetworkEvent {
         property: string;
         previousValue: unknown;
         newValue: unknown;
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         overrideReason: string;
         temporaryOverride?: boolean;
         duration?: number;
@@ -127,7 +127,7 @@ export interface EmitConfigOverrideOptions extends EventOptions {
     property: string;
     previousValue: unknown;
     newValue: unknown;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     overrideReason: string;
     temporaryOverride?: boolean;
     duration?: number;
@@ -139,7 +139,7 @@ export interface EmitConfigRestoredOptions extends EventOptions {
     property: string;
     previousValue: unknown;
     newValue: unknown;
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     reason: string;
 }
 /**

package/dist/api/events/types.d.ts

@@ -12,10 +12,6 @@ export type EventScope = 'global' | 'config' | 'client' | 'request';
  * Type for event scopes including 'temporary'
  */
 export type EventScopeWithTemporary = EventScope | 'temporary';
-/**
- * Configuration source type
- */
-export type ConfigSource = 'global' | 'createApiClient' | 'updateConfig' | 'manual' | 'environment' | 'preset' | 'networkAware' | 'adaptive';
 /**
  * Configuration update strategy - controls WHERE configuration is applied
  * - 'merge': Merges with existing config at CLIENT scope

package/dist/api/headers/types.d.ts

@@ -2,7 +2,7 @@
  * Header Management Type Definitions
  * Comprehensive types for HTTP headers, following TASK-016 specification
  */
-import type { ApiClientInstance, ConfigSource, PerformancePresetName, RetryStrategyName, CacheStrategyName, RevalidationStrategyName } from '..';
+import type { ApiClientInstance, DebuggerConfigSource, PerformancePresetName, RetryStrategyName, CacheStrategyName, RevalidationStrategyName } from '..';
 /**
  * Headers that affect cache key generation (based on fetchff behavior)
  * These headers will be included in cache key computation
@@ -195,7 +195,7 @@ export interface HeaderMergeResult {
     conflicts: Array<{
         header: string;
         sources: Array<{
-            source: ConfigSource;
+            source: DebuggerConfigSource;
             value: string;
             priority: number;
         }>;
@@ -367,7 +367,7 @@ export interface ProcessSingleHeaderResult {
     conflict?: {
         header: string;
         sources: Array<{
-            source: ConfigSource;
+            source: DebuggerConfigSource;
             value: string;
             priority: number;
         }>;
@@ -393,7 +393,7 @@ export interface ConflictTrackingParams {
     conflicts: Record<string, {
         header: string;
         sources: Array<{
-            source: ConfigSource;
+            source: DebuggerConfigSource;
             value: string;
             priority: number;
         }>;
@@ -406,7 +406,7 @@ export interface ConflictTrackingParams {
     priority: number;
     /** Original source information */
     originalSource: {
-        source: ConfigSource;
+        source: DebuggerConfigSource;
         value: string;
         priority: number;
     } | null;

package/dist/api/index.d.ts

@@ -8,6 +8,7 @@ export type * from './queue';
 export type * from './headers';
 export type * from './network';
 export type * from './endpoints';
+export type * from './debugger';
 export type * from './cache';
 export type * from './retry';
 export type * from './polling';

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

@@ -2,8 +2,7 @@
  * Network Information API types
  * Properly typed definitions for browser and Node.js navigator
  */
-import type { NETWORK_QUALITY } from '.';
-import type { ConfigSource, NetworkEvent } from '../events';
+import type { DebuggerConfigSource, NetworkEvent, NETWORK_QUALITY } from '../../..';
 /**
  * Network Information interface (partial for what we use)
  */
@@ -316,7 +315,7 @@ export interface TemporaryOverride {
     /** How long the override should last (in milliseconds) */
     duration?: number;
     /** Source configuration that requested the override */
-    source: ConfigSource;
+    source: DebuggerConfigSource;
     /** Reason for the override */
     reason: string;
     /** Function to restore original value */

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

@@ -2,6 +2,7 @@
  * Polling Configuration Types
  * Provides type definitions for polling functionality
  */
+import type { FetchResponse, PollingFunction } from 'fetchff';
 /**
  * Polling configuration for repeated requests
  * Uses generic types to work with any response data
@@ -28,8 +29,9 @@ export interface PollingConfig<T = unknown> {
     /**
      * Function to determine if polling should stop
      * Return true to stop, false to continue
+     * Uses fetchff's PollingFunction type for compatibility
      */
-    shouldStop?: (response: T) => boolean | Promise<boolean>;
+    shouldStop?: PollingFunction<T>;
 }
 /**
  * Result of a polling operation
@@ -62,9 +64,9 @@ export interface ProgressivePollingOptions {
  */
 export interface ConditionalPollingOptions<T = unknown> {
     /** Function to check if polling succeeded */
-    successCondition?: (response: T) => boolean;
+    successCondition?: (response: FetchResponse<T>) => boolean;
     /** Function to check if polling should error */
-    errorCondition?: (response: T) => boolean;
+    errorCondition?: (response: FetchResponse<T>) => boolean;
     /** Maximum time to poll in milliseconds */
     timeoutMs?: number;
 }

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

@@ -2,7 +2,7 @@
  * Queue System Type Definitions
  */
 import type { PRIORITY_LEVEL } from './enums';
-import type { ConfigUpdateStrategy, ConfigSource } from '..';
+import type { ConfigUpdateStrategy, DebuggerConfigSource } from '..';
 /**
  * Processing strategy for queue operations
  */
@@ -96,13 +96,13 @@ export interface BatchProcessorConfig<T> {
 export interface EventQueueOperation<TEventData = unknown> extends QueueOperation {
     eventType: string;
     scope?: 'global' | 'client' | 'request' | 'temporary';
-    configSource?: ConfigSource;
+    configSource?: DebuggerConfigSource;
     updateStrategy?: ConfigUpdateStrategy;
     data: {
         eventData: TEventData;
         metadata?: {
             correlationId?: string;
-            source: ConfigSource;
+            source: DebuggerConfigSource;
             timestamp: number;
             retryAttempt?: number;
         };

package/dist/auth/types.d.ts

@@ -1,10 +1,4 @@
-import type { WithUuid, WithExpiration, WithAuthTokens } from '../common/types';
-/**
- * Represents a simplified user model.
- * @description Typically used for identification purposes within auth or session logic.
- */
-export interface User extends WithUuid {
-}
+import type { WithExpiration, WithAuthTokens } from '../common/types';
 /**
  * AuthToken Interface.
  * @description Represents an authentication token set returned after a successful login or refresh.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.7.19",
+  "version": "1.7.21",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",