@plyaz/types 1.7.17 → 1.7.18

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

@@ -54,7 +54,7 @@ export type RetryInterceptor = NonNullable<FetchffRequestConfig['onRetry']>;
  * Extends fetchff's RequestConfig with our abstraction layer
  * Supports ALL fetchff configuration options
  */
-export interface ApiConfig extends Partial<Omit<FetchffRequestConfig, 'retry' | 'cache' | 'cacheTime' | 'staleTime' | 'skipCache' | 'cacheErrors' | 'cacheKey' | 'cacheBuster' | 'pollingInterval' | 'pollingDelay' | 'maxPollingAttempts' | 'shouldStopPolling' | 'data' | 'headers' | 'onRequest' | 'onResponse' | 'onError' | 'onRetry'>> {
+export interface ApiConfig<TApiPackageError = unknown> extends Partial<Omit<FetchffRequestConfig, 'retry' | 'cache' | 'cacheTime' | 'staleTime' | 'skipCache' | 'cacheErrors' | 'cacheKey' | 'cacheBuster' | 'pollingInterval' | 'pollingDelay' | 'maxPollingAttempts' | 'shouldStopPolling' | 'data' | 'headers' | 'onRequest' | 'onResponse' | 'onError' | 'onRetry'>> {
     /** Base URL for all requests */
     baseURL?: string;
     /** Default HTTP method */
@@ -325,7 +325,7 @@ export interface ApiConfig extends Partial<Omit<FetchffRequestConfig, 'retry' |
      * });
      * ```
      */
-    errorHandlers?: ErrorEventHandlers;
+    errorHandlers?: ErrorEventHandlers<TApiPackageError>;
     /**
      * Configuration event handlers for monitoring config changes and updates
      * Track when global config is updated, reset, or when presets are applied

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

@@ -88,25 +88,25 @@ export interface ApiPackageErrorOptionsErrorDetail<ValueGiven, AllowedValues, Co
  * Event handler types for API package errors
  * Note: ApiPackageError is not imported here to avoid implementation dependencies
  */
-export interface ErrorEventHandlers {
-    onValidationError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onNetworkError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onAuthenticationError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onAuthorizationError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onRateLimitError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onTimeoutError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onConflictError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onNotFoundError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onServerError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onClientError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onExternalServiceError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onCacheError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onHeadersError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onRetryError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onStrategyError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onRegionalError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onUnknownError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
-    onAnyError?: ((error: unknown) => void) | Array<(error: unknown) => void>;
+export interface ErrorEventHandlers<ApiPackageError> {
+    onValidationError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onNetworkError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onAuthenticationError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onAuthorizationError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onRateLimitError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onTimeoutError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onConflictError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onNotFoundError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onServerError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onClientError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onExternalServiceError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onCacheError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onHeadersError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onRetryError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onStrategyError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onRegionalError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onUnknownError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
+    onAnyError?: ((error: ApiPackageError) => void) | Array<(error: ApiPackageError) => void>;
 }
 /**
  * Options for error handler registration

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

@@ -625,6 +625,76 @@ export interface CacheInvalidateEvent extends BaseEvent {
  * Union type for all cache event types
  */
 export type CacheEventData = CacheHitEvent | CacheMissEvent | CacheInvalidateEvent;
+/**
+ * Client conflict event
+ */
+export interface ClientConflictEvent extends BaseEvent {
+    type: string;
+    data: Record<string, unknown>;
+}
+/**
+ * Client debug event
+ */
+export interface ClientDebugEvent extends BaseEvent {
+    type: string;
+    data: Record<string, unknown>;
+}
+/**
+ * Client created event
+ */
+export interface ClientCreatedEvent extends BaseEvent {
+    type: string;
+    data: {
+        clientId: string;
+        config: Record<string, unknown>;
+    };
+}
+/**
+ * Request start event (client-level)
+ */
+export interface RequestStartEvent extends BaseEvent {
+    type: 'request:start';
+    data: {
+        url?: string;
+        method?: string;
+        timestamp: number;
+    };
+}
+/**
+ * Response received event
+ */
+export interface ResponseReceivedEvent extends BaseEvent {
+    type: 'response:received';
+    data: {
+        url?: string;
+        status?: number;
+        statusText?: string;
+        headers?: Record<string, string>;
+        timestamp: number;
+    };
+}
+/**
+ * Retry attempt event
+ */
+export interface RetryAttemptEvent extends BaseEvent {
+    type: 'retry:attempt';
+    data: {
+        error: {
+            message: string;
+            code?: string;
+            status?: number;
+        };
+        attempt: number;
+        maxAttempts: number;
+        delay: number;
+        url?: string;
+        method?: string;
+    };
+}
+/**
+ * Union type for all client event types
+ */
+export type ClientEventType = ClientConflictEvent | ClientDebugEvent | ClientCreatedEvent | RequestStartEvent | ResponseReceivedEvent | RetryAttemptEvent;
 export type AnyHeaderEvent = HeaderEventData;
 export type AnyNetworkEvent = NetworkEventData;
 export type AnyErrorEvent = ErrorEventData;
@@ -632,10 +702,11 @@ export type AnyDebugEvent = DebugEventData;
 export type AnyPerformanceEvent = PerformanceEventData;
 export type AnyConfigEvent = ConfigEventData;
 export type AnyCacheEvent = CacheEventData;
+export type AnyClientEvent = ClientEventType;
 /**
  * Combined event type
  */
-export type AnyEvent = AnyHeaderEvent | AnyNetworkEvent | AnyErrorEvent | AnyDebugEvent | AnyPerformanceEvent | AnyConfigEvent | AnyCacheEvent;
+export type AnyEvent = AnyHeaderEvent | AnyNetworkEvent | AnyErrorEvent | AnyDebugEvent | AnyPerformanceEvent | AnyConfigEvent | AnyCacheEvent | AnyClientEvent;
 export type HeaderEventHandler = EventHandler<HeaderEventData>;
 export type NetworkEventHandler = EventHandler<NetworkEventData>;
 export type ErrorEventHandler = EventHandler<ErrorEventData>;
@@ -650,6 +721,7 @@ export type AnyDebugEventHandler = EventHandler<AnyDebugEvent>;
 export type AnyPerformanceEventHandler = EventHandler<AnyPerformanceEvent>;
 export type AnyConfigEventHandler = EventHandler<AnyConfigEvent>;
 export type AnyCacheEventHandler = EventHandler<AnyCacheEvent>;
+export type AnyClientEventHandler = EventHandler<AnyClientEvent>;
 export type UniversalEventHandler = EventHandler<AnyEvent>;
 /**
  * Header event handlers interface
@@ -713,11 +785,11 @@ export interface CacheEventHandlers {
  * Client event handlers interface
  */
 export interface ClientEventHandlers {
-    onClientConflict?: (event: unknown) => void;
-    onClientDebug?: (event: unknown) => void;
-    onClientCreated?: (event: unknown) => void;
-    onRequestStart?: (event: unknown) => void;
-    onResponseReceived?: (event: unknown) => void;
-    onRetryAttempt?: (event: unknown) => void;
-    onAnyClientEvent?: (event: unknown) => void;
+    onClientConflict?: (event: ClientConflictEvent) => void;
+    onClientDebug?: (event: ClientDebugEvent) => void;
+    onClientCreated?: (event: ClientCreatedEvent) => void;
+    onRequestStart?: (event: RequestStartEvent) => void;
+    onResponseReceived?: (event: ResponseReceivedEvent) => void;
+    onRetryAttempt?: (event: RetryAttemptEvent) => void;
+    onAnyClientEvent?: (event: ClientEventType) => void;
 }

package/package.json

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