@plyaz/api 1.2.2 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/api",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "@plyaz/api ⚡ Core Plyaz API client enabling seamless Web3 interactions, authentication, and data access across apps and services. Built for scalability, reliability, and tokenized fan engagement experiences.",
   "type": "module",
   "keywords": [],
@@ -27,9 +27,11 @@
     "dist"
   ],
   "dependencies": {
-    "@nestjs/common": "^11.1.3",
-    "@plyaz/config": "^1.6.1",
-    "@tanstack/react-query": "^5.85.6",
+    "@nestjs/common": "^11.1.7",
+    "@plyaz/config": "^1.7.0",
+    "@plyaz/errors": "^1.3.1",
+    "@plyaz/logger": "^1.3.2",
+    "@tanstack/react-query": "5.85.6",
     "@tanstack/react-query-devtools": "^5.85.6",
     "express": "^5.1.0",
     "fetchff": "^4.1.0",
@@ -49,7 +51,7 @@
     "@next/eslint-plugin-next": "^15.0.3",
     "@plyaz/devtools": "^1.8.5",
     "@plyaz/testing": "^1.5.1",
-    "@plyaz/types": "^1.10.0",
+    "@plyaz/types": "^1.14.4",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.1",

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

@@ -1,101 +0,0 @@
-/**
- * Main error class for @plyaz/api package
- */
-import type { ResponseError, RequestConfig } from 'fetchff';
-import type { ApiPackageErrorOptions, ErrorContext, ApiClientInstance, ApiPackageErrorLike, ErrorCategoryValue, ApiErrorCodeValue, StatusCodeValue } from '@plyaz/types/api';
-import type { ErrorResponse, ErrorDetail } from '@plyaz/types';
-import type { EndpointsList } from '../endpoints';
-/**
- * Enhanced error class that implements ErrorResponse interface
- * Wraps fetchff's ResponseError for compatibility
- */
-export declare class ApiPackageError extends Error implements ApiPackageErrorLike {
-    readonly statusCode: StatusCodeValue;
-    readonly errorCode: ApiErrorCodeValue;
-    readonly message: string;
-    readonly errors?: ErrorDetail<unknown, unknown, unknown>[];
-    readonly correlationId?: string;
-    readonly timestamp: string;
-    readonly responseError?: ResponseError;
-    readonly category: ErrorCategoryValue;
-    readonly cause?: Error;
-    readonly context?: ErrorContext;
-    readonly requestConfig?: RequestConfig;
-    readonly responseData?: ResponseError['response'];
-    readonly details?: ErrorDetail<unknown, unknown, unknown>[];
-    readonly originalError?: Error;
-    readonly metadata?: Record<string, string | number | boolean | null>;
-    /**
-     * Getter for code property (alias for errorCode)
-     * Provides compatibility with standard error patterns
-     */
-    get code(): string;
-    constructor(message: string, statusCode?: StatusCodeValue | 0, errorCode?: ApiErrorCodeValue, options?: ApiPackageErrorOptions<EndpointsList>);
-    /**
-     * Resolves the status code from the provided value or error definitions
-     */
-    private resolveStatusCode;
-    /**
-     * Emit error event for this error
-     * Can be called with a specific client context or uses global handlers
-     */
-    private emitEvent;
-    /**
-     * Creates an ApiPackageError from a fetchff ResponseError
-     */
-    static fromResponseError(responseError: ResponseError, config?: RequestConfig, clientContext?: ApiClientInstance<EndpointsList>): ApiPackageError;
-    /**
-     * Creates an ApiPackageError from a standard Error
-     */
-    static fromError(error: Error, statusCode?: StatusCodeValue | 0, errorCode?: ApiErrorCodeValue, context?: ApiClientInstance<EndpointsList>): ApiPackageError;
-    /**
-     * Classifies an error and returns appropriate code and status
-     */
-    private static classifyError;
-    /**
-     * Determines appropriate error code from ResponseError by looking up status in ERROR_DEFINITIONS
-     */
-    private static determineErrorCode;
-    /**
-     * Gets a generic error code based on HTTP status range
-     */
-    private static getGenericErrorCode;
-    /**
-     * Gets the error category from ERROR_DEFINITIONS
-     */
-    private categorizeError;
-    /**
-     * Checks if this is a specific category of error
-     */
-    isAuthError(): boolean;
-    isValidationError(): boolean;
-    isNetworkError(): boolean;
-    isServerError(): boolean;
-    isClientError(): boolean;
-    isRetryable(): boolean;
-    /**
-     * Converts to ErrorResponse format (as per task-020)
-     */
-    toJSON(): ErrorResponse;
-    /**
-     * Creates a string representation
-     */
-    toString(): string;
-    /**
-     * Check if error is an ApiPackageError
-     */
-    static isApiPackageError(error: Error | ApiPackageError): error is ApiPackageError;
-    /**
-     * Get user-friendly message for display
-     */
-    getUserMessage(): string;
-    /**
-     * Gets custom user message from error details if available
-     */
-    private getCustomUserMessage;
-    /**
-     * Gets default user message based on error category
-     */
-    private getDefaultUserMessage;
-}
-//# sourceMappingURL=ApiPackageError.d.ts.map

package/dist/api/errors/ApiPackageError.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ApiPackageError.d.ts","sourceRoot":"","sources":["../../../src/api/errors/ApiPackageError.ts"],"names":[],"mappings":"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"}

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

@@ -1,24 +0,0 @@
-/**
- * Centralized error definitions mapping for @plyaz/api package
- * Maps error codes to their HTTP status and metadata
- */
-import type { ErrorDefinitions, ErrorDefinition } from '@plyaz/types/api';
-import { ERROR_CATEGORY } from '@plyaz/types';
-/**
- * Centralized error definitions mapping
- * Maps error codes to their HTTP status and metadata
- */
-export declare const ERROR_DEFINITIONS: ErrorDefinitions;
-/**
- * Helper function to get error definition by code
- */
-export declare function getErrorDefinition(errorCode: string): ErrorDefinition | undefined;
-/**
- * Helper function to get error code by status
- */
-export declare function getErrorCodeByStatus(status: number): string | undefined;
-/**
- * Helper function to get category for error code
- */
-export declare function getErrorCategory(errorCode: string): (typeof ERROR_CATEGORY)[keyof typeof ERROR_CATEGORY];
-//# sourceMappingURL=definitions.d.ts.map

package/dist/api/errors/definitions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/api/errors/definitions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBA0RtB,CAAC;AAEX;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEjF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,GAChB,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAEtD"}

package/dist/api/errors/error-codes.d.ts

@@ -1,116 +0,0 @@
-/**
- * Domain-specific error codes for @plyaz/api package
- * Following the error code pattern from Confluence architecture
- */
-/**
- * API Error Codes - domain-specific and grouped by category
- */
-export declare const API_ERROR_CODES: {
-    readonly CLIENT_INITIALIZATION_FAILED: "CLIENT_INITIALIZATION_FAILED";
-    readonly CLIENT_INVALID_CONFIG: "CLIENT_INVALID_CONFIG";
-    readonly CLIENT_MISSING_BASE_URL: "CLIENT_MISSING_BASE_URL";
-    readonly CLIENT_CANCELLED: "CLIENT_CANCELLED";
-    readonly CONFIG_VALIDATION_FAILED: "CONFIG_VALIDATION_FAILED";
-    readonly HEADER_PROCESSING_FAILED: "HEADER_PROCESSING_FAILED";
-    readonly NETWORK_OVERRIDE_FAILED: "NETWORK_OVERRIDE_FAILED";
-    readonly REQUEST_TIMEOUT: "REQUEST_TIMEOUT";
-    readonly REQUEST_ABORTED: "REQUEST_ABORTED";
-    readonly REQUEST_INVALID_PARAMS: "REQUEST_INVALID_PARAMS";
-    readonly REQUEST_PREPARATION_FAILED: "REQUEST_PREPARATION_FAILED";
-    readonly RESPONSE_INVALID_FORMAT: "RESPONSE_INVALID_FORMAT";
-    readonly RESPONSE_PARSING_FAILED: "RESPONSE_PARSING_FAILED";
-    readonly NETWORK_CONNECTION_FAILED: "NETWORK_CONNECTION_FAILED";
-    readonly NETWORK_OFFLINE: "NETWORK_OFFLINE";
-    readonly NETWORK_DNS_FAILED: "NETWORK_DNS_FAILED";
-    readonly NETWORK_TIMEOUT: "NETWORK_TIMEOUT";
-    readonly NETWORK_ERROR: "NETWORK_ERROR";
-    readonly NETWORK_PRESET_NOT_FOUND: "NETWORK_PRESET_NOT_FOUND";
-    readonly NETWORK_CONFIGURATION_INVALID: "NETWORK_CONFIGURATION_INVALID";
-    readonly REGIONAL_PRESET_NOT_FOUND: "REGIONAL_PRESET_NOT_FOUND";
-    readonly REGION_DETECTION_FAILED: "REGION_DETECTION_FAILED";
-    readonly HEADERS_ENRICHMENT_FAILED: "HEADERS_ENRICHMENT_FAILED";
-    readonly HEADERS_VALIDATION_FAILED: "HEADERS_VALIDATION_FAILED";
-    readonly HEADERS_MERGE_CONFLICT: "HEADERS_MERGE_CONFLICT";
-    readonly CACHE_STORAGE_FAILED: "CACHE_STORAGE_FAILED";
-    readonly CACHE_RETRIEVAL_FAILED: "CACHE_RETRIEVAL_FAILED";
-    readonly CACHE_INVALIDATION_FAILED: "CACHE_INVALIDATION_FAILED";
-    readonly RETRY_EXHAUSTED: "RETRY_EXHAUSTED";
-    readonly RETRY_STRATEGY_INVALID: "RETRY_STRATEGY_INVALID";
-    readonly STRATEGY_INVALID: "STRATEGY_INVALID";
-    readonly STRATEGY_CONFLICT: "STRATEGY_CONFLICT";
-    readonly STRATEGY_EXECUTION_FAILED: "STRATEGY_EXECUTION_FAILED";
-    readonly POLLING_TIMEOUT: "POLLING_TIMEOUT";
-    readonly POLLING_CANCELLED: "POLLING_CANCELLED";
-    readonly POLLING_INVALID_CONFIG: "POLLING_INVALID_CONFIG";
-    readonly PUBSUB_SUBSCRIPTION_FAILED: "PUBSUB_SUBSCRIPTION_FAILED";
-    readonly PUBSUB_PUBLICATION_FAILED: "PUBSUB_PUBLICATION_FAILED";
-    readonly PUBSUB_INVALID_TOPIC: "PUBSUB_INVALID_TOPIC";
-    readonly PUBSUB_CHANNEL_ERROR: "PUBSUB_CHANNEL_ERROR";
-    readonly REVALIDATION_FAILED: "REVALIDATION_FAILED";
-    readonly REVALIDATION_IN_PROGRESS: "REVALIDATION_IN_PROGRESS";
-    readonly DEBUG_TRACKING_FAILED: "DEBUG_TRACKING_FAILED";
-    readonly DEBUG_OVERRIDE_FAILED: "DEBUG_OVERRIDE_FAILED";
-    readonly DEBUG_CONFLICT_DETECTED: "DEBUG_CONFLICT_DETECTED";
-    readonly ENDPOINT_BUILD_FAILED: "ENDPOINT_BUILD_FAILED";
-    readonly ENDPOINT_NOT_FOUND: "ENDPOINT_NOT_FOUND";
-    readonly ENDPOINT_INVALID_CONFIG: "ENDPOINT_INVALID_CONFIG";
-    readonly EVENT_HANDLER_FAILED: "EVENT_HANDLER_FAILED";
-    readonly EVENT_EMISSION_FAILED: "EVENT_EMISSION_FAILED";
-    readonly MONITORING_FAILED: "MONITORING_FAILED";
-    readonly CONTEXT_OPERATION_FAILED: "CONTEXT_OPERATION_FAILED";
-    readonly AUTH_TOKEN_EXPIRED: "AUTH_TOKEN_EXPIRED";
-    readonly AUTH_UNAUTHORIZED: "AUTH_UNAUTHORIZED";
-    readonly AUTH_FORBIDDEN: "AUTH_FORBIDDEN";
-    readonly AUTH_INVALID_CREDENTIALS: "AUTH_INVALID_CREDENTIALS";
-    readonly RATE_LIMIT_EXCEEDED: "RATE_LIMIT_EXCEEDED";
-    readonly RESOURCE_NOT_FOUND: "RESOURCE_NOT_FOUND";
-    readonly INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR";
-    readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
-    readonly EXTERNAL_SERVICE_ERROR: "EXTERNAL_SERVICE_ERROR";
-    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
-    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
-    readonly VALIDATION_FAILED: "VALIDATION_FAILED";
-    readonly REQUIRED_FIELD_MISSING: "REQUIRED_FIELD_MISSING";
-    readonly INVALID_FORMAT: "INVALID_FORMAT";
-    readonly VALIDATION_INVALID_FORMAT: "INVALID_FORMAT";
-    readonly STRING_TOO_SHORT: "STRING_TOO_SHORT";
-    readonly STRING_TOO_LONG: "STRING_TOO_LONG";
-    readonly CLIENT_ERROR: "CLIENT_ERROR";
-    readonly SERVER_ERROR: "SERVER_ERROR";
-    readonly TIMEOUT: "TIMEOUT";
-};
-/**
- * Type for API error codes
- */
-export type ApiErrorCode = (typeof API_ERROR_CODES)[keyof typeof API_ERROR_CODES];
-/**
- * Internal package status codes (non-HTTP)
- * Used for internal configuration and validation errors that aren't HTTP-related
- */
-export declare const PACKAGE_STATUS_CODES: {
-    readonly INVALID_CONFIGURATION: 1001;
-    readonly MISSING_CONFIGURATION: 1002;
-    readonly CONFIGURATION_CONFLICT: 1003;
-    readonly CONFIGURATION_TRACKING_FAILED: 1004;
-    readonly DEBUG_TRACKING_FAILED: 1005;
-    readonly RESOURCE_NOT_FOUND: 1010;
-    readonly RESOURCE_ALREADY_EXISTS: 1011;
-    readonly RESOURCE_UNAVAILABLE: 1012;
-    readonly INVALID_PARAMETER: 1020;
-    readonly MISSING_PARAMETER: 1021;
-    readonly PARAMETER_OUT_OF_RANGE: 1022;
-    readonly STRATEGY_NOT_FOUND: 1030;
-    readonly PRESET_NOT_FOUND: 1031;
-    readonly INVALID_STRATEGY: 1032;
-    readonly REQUEST_FAILED: 1035;
-    readonly INITIALIZATION_FAILED: 1040;
-    readonly OPERATION_FAILED: 1041;
-    readonly STATE_CORRUPTION: 1042;
-    readonly SERIALIZATION_FAILED: 1043;
-    readonly DESERIALIZATION_FAILED: 1044;
-    readonly CONFIGURATION_INVALID: 1045;
-    readonly HEADER_PROCESSING_ERROR: 1046;
-    readonly REGION_DETECTION_ERROR: 1047;
-    readonly NETWORK_OVERRIDE_ERROR: 1048;
-};
-//# sourceMappingURL=error-codes.d.ts.map

package/dist/api/errors/error-codes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../../src/api/errors/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoHlB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;CAoCvB,CAAC"}

package/dist/api/errors/error-events.d.ts

@@ -1,63 +0,0 @@
-/**
- * Error event management for @plyaz/api package
- * Simplified to use shared event emitter and factories
- */
-import type { ErrorEventHandlers, ErrorHandlerOptions, ERROR_EVENTS, ApiPackageErrorLike } from '@plyaz/types/api';
-import { HANDLER_SCOPES } from '@plyaz/types/api';
-/**
- * Register an error handler for any scope
- * @param eventType - The event type (e.g., ERROR_EVENTS.NETWORK_ERROR, 'network', '*')
- * @param handler - The handler function
- * @param options - Registration options (scope defaults to 'GLOBAL' - app-wide handlers that persist across all instances)
- * @returns Cleanup function to unregister the handler
- *
- * @example
- * // Register a global handler (default)
- * registerErrorHandler(ERROR_EVENTS.NETWORK_ERROR, handleNetworkError);
- *
- * // Register a client-specific handler
- * registerErrorHandler(ERROR_EVENTS.NETWORK_ERROR, handleNetworkError, { scope: 'CLIENT' });
- */
-export declare function registerErrorHandler(eventType: string | (typeof ERROR_EVENTS)[keyof typeof ERROR_EVENTS], handler: (error: ApiPackageErrorLike) => void, options?: ErrorHandlerOptions): () => void;
-/**
- * Set error handlers for a specific scope
- * @param handlers - The error handlers to register
- * @param scope - The scope to register handlers at (defaults to GLOBAL - lowest priority, persists across all instances)
- */
-export declare function setErrorHandlers(handlers: ErrorEventHandlers, scope?: keyof typeof HANDLER_SCOPES): void;
-/**
- * Get error handlers for a specific scope
- * @param scope - The scope to retrieve handlers from (defaults to GLOBAL)
- * @returns The registered error handlers for the specified scope
- */
-export declare function getErrorHandlers(scope?: keyof typeof HANDLER_SCOPES): ErrorEventHandlers;
-/**
- * Register multiple error handlers at once
- * @param handlers - The error handlers to register
- * @param options - Registration options (scope defaults to 'GLOBAL' - app-wide handlers)
- */
-export declare function registerErrorHandlers(handlers: ErrorEventHandlers, options?: ErrorHandlerOptions): void;
-/**
- * Unregister error handlers
- * @param eventTypes - Optional array of event types to remove (can use ERROR_EVENTS values or plain types)
- *                     If not provided, all handlers for the scope are removed.
- * @param options - Options including scope (defaults to 'GLOBAL')
- */
-export declare function unregisterErrorHandlers(eventTypes?: Array<string | (typeof ERROR_EVENTS)[keyof typeof ERROR_EVENTS]>, options?: Pick<ErrorHandlerOptions, 'scope'>): void;
-/**
- * Clear error handlers
- * @param options - Options including scope(s) to clear (defaults to ['GLOBAL'])
- */
-export declare function clearErrorHandlers(options?: {
-    scopes?: Array<keyof typeof HANDLER_SCOPES>;
-}): void;
-/**
- * Register a one-time error handler
- * Handler will be automatically removed after first execution
- * @param eventType - The event type (e.g., ERROR_EVENTS.NETWORK_ERROR, 'network', '*')
- * @param handler - The handler function
- * @param options - Registration options (scope defaults to 'GLOBAL')
- */
-export declare function onceErrorHandler(eventType: string | (typeof ERROR_EVENTS)[keyof typeof ERROR_EVENTS], handler: (error: ApiPackageErrorLike) => void, options?: Pick<ErrorHandlerOptions, 'scope'>): void;
-export declare function emitErrorEvent(error: ApiPackageErrorLike): Promise<void>;
-//# sourceMappingURL=error-events.d.ts.map

package/dist/api/errors/error-events.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-events.d.ts","sourceRoot":"","sources":["../../../src/api/errors/error-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EACV,kBAAkB,EAElB,mBAAmB,EAGnB,YAAY,EACZ,mBAAmB,EAEpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAiC,MAAM,kBAAkB,CAAC;AAsGjF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,EACpE,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,EAC7C,OAAO,GAAE,mBAAwB,GAChC,MAAM,IAAI,CA0BZ;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,GAAE,MAAM,OAAO,cAAyB,GAC5C,IAAI,CAEN;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,GAAE,MAAM,OAAO,cAAyB,GAC5C,kBAAkB,CAEpB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE,mBAAwB,GAChC,IAAI,CAGN;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC,EAC7E,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAM,GAC/C,IAAI,CAmBN;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA;CAAO,GAC5D,IAAI,CAQN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,EACpE,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,EAC7C,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAM,GAC/C,IAAI,CAaN;AAuID,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9E"}

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

@@ -1,64 +0,0 @@
-/**
- * Typed constants for error handling
- */
-export declare const OPERATIONS: {
-    readonly STORAGE: "storage";
-    readonly RETRIEVAL: "retrieval";
-    readonly INVALIDATION: "invalidation";
-    readonly ENRICHMENT: "enrichment";
-    readonly VALIDATION: "validation";
-    readonly PRESET_LOOKUP: "preset-lookup";
-    readonly INITIALIZATION: "initialization";
-    readonly CONFIGURATION: "configuration";
-    readonly REQUEST: "request";
-    readonly RESPONSE: "response";
-    readonly RETRY: "retry";
-    readonly REVALIDATION: "revalidation";
-    readonly STRATEGY_EXECUTION: "strategy-execution";
-    readonly POLLING: "polling";
-    readonly SUBSCRIPTION: "subscription";
-    readonly PUBLICATION: "publication";
-    readonly DEBUG: "debug";
-    readonly DEBUG_TRACKING: "debug-tracking";
-    readonly ENDPOINT_BUILD: "endpoint-build";
-    readonly TRACKING: "tracking";
-    readonly NETWORK_CHECK: "network-check";
-    readonly EVENT_HANDLING: "event-handling";
-    readonly SERIALIZATION: "serialization";
-    readonly DESERIALIZATION: "deserialization";
-    readonly REGIONAL_DETECTION: "regional-detection";
-    readonly MONITORING: "monitoring";
-    readonly CONTEXT_SETUP: "context-setup";
-    readonly FALLBACK: "fallback";
-};
-export type Operation = (typeof OPERATIONS)[keyof typeof OPERATIONS];
-export declare const ERROR_FIELDS: {
-    readonly STORAGE: "storage";
-    readonly CACHE: "cache";
-    readonly HEADERS: "headers";
-    readonly PRESET_NAME: "presetName";
-    readonly PRESET_ID: "presetId";
-    readonly CONFIG: "config";
-    readonly URL: "url";
-    readonly METHOD: "method";
-    readonly STRATEGY: "strategy";
-    readonly RETRY_COUNT: "retryCount";
-    readonly MAX_RETRIES: "maxRetries";
-    readonly POLLING_INTERVAL: "pollingInterval";
-    readonly TOPIC: "topic";
-    readonly CHANNEL: "channel";
-    readonly ENDPOINT: "endpoint";
-    readonly CLIENT: "client";
-    readonly NETWORK_TYPE: "networkType";
-    readonly TIME_INTERVAL: "timeInterval";
-};
-export type ErrorField = (typeof ERROR_FIELDS)[keyof typeof ERROR_FIELDS];
-export declare const STORAGE_TYPES: {
-    readonly PRIMARY: "primary";
-    readonly FALLBACK: "fallback";
-    readonly MEMORY: "memory";
-    readonly SESSION: "session";
-    readonly LOCAL: "local";
-};
-export type StorageType = (typeof STORAGE_TYPES)[keyof typeof STORAGE_TYPES];
-//# sourceMappingURL=types-constants.d.ts.map

package/dist/api/errors/types-constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-constants.d.ts","sourceRoot":"","sources":["../../../src/api/errors/types-constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Bb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAGrE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;CAmBf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAG1E,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}

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

@@ -1,82 +0,0 @@
-/**
- * Hook Types and Options
- * TypeScript types for React Query hooks with API configuration support
- */
-import type { UseQueryOptions, UseMutationOptions, QueryKey, UseQueryResult, UseMutationResult } from '@tanstack/react-query';
-import type { ApiConfig, ApiClientWithEvents } from '@plyaz/types/api';
-import type { ClientEventManager } from '../client/clientEventManager';
-import type { EndpointsList } from '../endpoints';
-/**
- * Options for query hooks (GET requests)
- * Extends React Query's UseQueryOptions with API-specific options
- *
- * @template TData - The type of data returned by the query
- * @template TError - The type of error that can be thrown (defaults to Error)
- *
- * @example
- * ```typescript
- * const queryOptions: ApiQueryOptions<Campaign> = {
- *   staleTime: 5 * 60 * 1000,
- *   apiConfig: { timeout: 10000 },
- *   enabled: !!campaignId,
- * };
- * ```
- */
-export interface ApiQueryOptions<TData, TError = Error, OverrideEndpointsList = EndpointsList> extends Omit<UseQueryOptions<TData, TError>, 'queryKey' | 'queryFn'> {
-    /**
-     * Optional API client instance to use for this query
-     * Overrides the default client instance
-     */
-    apiClient?: ApiClientWithEvents<ClientEventManager, OverrideEndpointsList>;
-    /**
-     * Optional API configuration for this specific query
-     * Applied temporarily using updateConfig({ strategy: 'temporary' })
-     */
-    apiConfig?: Partial<ApiConfig>;
-}
-/**
- * Options for mutation hooks (POST, PUT, PATCH, DELETE)
- * Extends React Query's UseMutationOptions with API-specific options
- *
- * @template TData - The type of data returned by the mutation
- * @template TVariables - The type of variables passed to the mutation
- * @template TError - The type of error that can be thrown (defaults to Error)
- *
- * @example
- * ```typescript
- * const mutationOptions: ApiMutationOptions<Campaign, CreateCampaignDto> = {
- *   apiConfig: { timeout: 30000 },
- *   onSuccess: (data) => {
- *     console.log('Campaign created:', data.id);
- *   },
- * };
- * ```
- */
-export interface ApiMutationOptions<TData, TVariables, TError = Error, OverrideEndpointsList = EndpointsList> extends Omit<UseMutationOptions<TData, TError, TVariables>, 'mutationFn'> {
-    /**
-     * Optional API client instance to use for this mutation
-     * Overrides the default client instance
-     */
-    apiClient?: ApiClientWithEvents<ClientEventManager, OverrideEndpointsList>;
-    /**
-     * Optional API configuration for this specific mutation
-     * Applied temporarily using updateConfig({ strategy: 'temporary' })
-     */
-    apiConfig?: Partial<ApiConfig>;
-}
-/**
- * Return type for query hooks
- * Re-export from React Query for convenience
- */
-export type { UseQueryResult };
-/**
- * Return type for mutation hooks
- * Re-export from React Query for convenience
- */
-export type { UseMutationResult };
-/**
- * Query key type
- * Re-export from React Query for convenience
- */
-export type { QueryKey };
-//# sourceMappingURL=types.d.ts.map

package/dist/api/hooks/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/api/hooks/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,qBAAqB,GAAG,aAAa,CAC3F,SAAQ,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACpE;;;OAGG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;IAE3E;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,kBAAkB,CACjC,KAAK,EACL,UAAU,EACV,MAAM,GAAG,KAAK,EACd,qBAAqB,GAAG,aAAa,CACrC,SAAQ,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,YAAY,CAAC;IACzE;;;OAGG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;IAE3E;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;GAGG;AACH,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;;GAGG;AACH,YAAY,EAAE,QAAQ,EAAE,CAAC"}