@plyaz/types 1.19.4 → 1.20.0

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

@@ -10,6 +10,8 @@ import type { UnknownRecord } from 'type-fest';
 import type { NETWORK_QUALITY, NetworkInfo } from '../network';
 import type { ConfigConflict, DebugInfo } from '../debugger';
 import type { PackageErrorLike } from '../../errors';
+import type { ReactNode } from 'react';
+import type { QueryClient } from '@tanstack/react-query';
 /**
  * Options for creating an API client
  * Endpoints are automatically included from src/api/endpoints
@@ -406,3 +408,60 @@ export interface SetupUnifiedHandlersParams {
     clientOptions?: ApiClientOptions;
     clearTemporaryOverrides?: () => void;
 }
+/**
+ * Props for API initialization loading component.
+ * Used by ApiProvider to display loading state during client initialization.
+ */
+export interface ApiInitializationLoadingProps {
+    /** Custom loading component override */
+    loading?: ReactNode;
+}
+/**
+ * Props for API initialization error component.
+ * Used by ApiProvider to display error state when initialization fails.
+ */
+export interface ApiInitializationErrorProps {
+    /** The error that occurred during initialization */
+    error: PackageErrorLike;
+    /** Custom error component override */
+    errorComponent?: (error: PackageErrorLike) => ReactNode;
+}
+/**
+ * Props for ApiProvider component.
+ * Provides React Query context and optionally initializes the default API client.
+ */
+export interface ApiProviderProps {
+    /** Child components that will have access to React Query */
+    children: ReactNode;
+    /** Optional custom QueryClient instance (defaults to shared singleton) */
+    queryClient?: QueryClient;
+    /**
+     * Optional global API configuration.
+     * Applied via setGlobalConfig() before client initialization.
+     * These settings apply to ALL API clients as defaults.
+     */
+    globalConfig?: ApiConfig;
+    /**
+     * Optional API client configuration.
+     * If provided, creates and sets the default API client automatically.
+     */
+    apiConfig?: ApiClientOptions;
+    /**
+     * Custom loading component to show while API client is initializing.
+     * Overrides the default ApiInitializationLoading component.
+     */
+    loading?: ReactNode;
+    /**
+     * Custom error renderer function.
+     * Overrides the default ApiInitializationError component.
+     */
+    error?: (error: PackageErrorLike) => ReactNode;
+    /**
+     * Callback when API client is ready.
+     */
+    onReady?: () => void;
+    /**
+     * Callback when API client initialization fails.
+     */
+    onError?: (error: PackageErrorLike) => void;
+}

package/dist/api/index.cjs

@@ -1192,6 +1192,10 @@ var ERROR_CODES = {
   ERROR_SYSTEM_NOT_INITIALIZED: "error.system.not.initialized",
   EVENT_FACTORY_NOT_REGISTERED: "error.event.factory.not.registered",
   DATABASE_ERROR: "error.database",
+  // Global Error Handler
+  UNCAUGHT_EXCEPTION: "error.uncaught.exception",
+  UNHANDLED_REJECTION: "error.unhandled.rejection",
+  RUNTIME_ERROR: "error.runtime",
   // ===== Database Errors =====
   // Connection & Configuration
   DB_ACCESS_DENIED: "db.access_denied",
@@ -3872,6 +3876,31 @@ var ERROR_DEFINITIONS = {
     retryable: false,
     userMessage: "errors.database"
   },
+  // Global Error Handler
+  [ERROR_CODES.UNCAUGHT_EXCEPTION]: {
+    code: ERROR_CODES.UNCAUGHT_EXCEPTION,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.System,
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false,
+    userMessage: "errors.uncaught.exception"
+  },
+  [ERROR_CODES.UNHANDLED_REJECTION]: {
+    code: ERROR_CODES.UNHANDLED_REJECTION,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.System,
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false,
+    userMessage: "errors.unhandled.rejection"
+  },
+  [ERROR_CODES.RUNTIME_ERROR]: {
+    code: ERROR_CODES.RUNTIME_ERROR,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.System,
+    severity: ERROR_SEVERITY.High,
+    retryable: false,
+    userMessage: "errors.runtime"
+  },
   // ===== Database Error Definitions =====
   // Connection & Configuration
   [ERROR_CODES.DB_ACCESS_DENIED]: {