api-core-lib 12.9.4 → 12.11.4

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import { InternalAxiosRequestConfig, AxiosResponse, AxiosRequestConfig, AxiosProgressEvent, AxiosInstance, Method, AxiosError } from 'axios';
-import React$1, { Dispatch, SetStateAction } from 'react';
+import * as React$1 from 'react';
+import React__default, { Dispatch, SetStateAction } from 'react';
 
 /**
  * يمثل معلومات الترقيم (Pagination) التي قد تعود من ה-API.
@@ -120,22 +121,11 @@ interface ActionConfig<TInput = any, TOutput = any> {
     isList?: boolean;
     invalidates?: string[];
 }
-/**
- * خيارات الإعداد لهوك useApiModule.
- */
-interface UseApiModuleOptions {
-    onSuccess?: (actionName: string, message: string, data: any) => void;
-    onError?: (actionName: string, message: string, error?: ApiError | null) => void;
-    staleTime?: number;
-    cacheTime?: number;
-    refetchOnWindowFocus?: boolean;
-    pathParams?: Record<string, any>;
-}
 /**
  * [مُحدَّث] يمثل الحالة التفاعلية الكاملة لإجراء واحد.
  * هذا هو النوع الذي يتم إرجاعه في `states` من الهوك.
  */
-interface ActionState<TOutput> {
+interface ActionStateModule<TOutput> {
     data: TOutput | null;
     links?: Record<string, string | null>;
     meta?: PaginationMeta | Record<string, any>;
@@ -146,12 +136,14 @@ interface ActionState<TOutput> {
     message?: string;
     validationErrors?: ValidationError[];
     rawResponse: any | null;
+    isStale?: boolean;
+    lastSuccessAt?: number;
 }
 /**
  * الكائن الموحد الذي يتم إرجاعه لكل إجراء، ويحتوي على حالته ومنفذه وأدوات التحكم.
  */
 interface ExecutableAction<TInput, TOutput> {
-    state: ActionState<TOutput>;
+    state: ActionStateModule<TOutput>;
     execute: (input?: TInput, options?: {
         pathParams?: Record<string, any>;
         config?: AxiosRequestConfig;
@@ -160,18 +152,12 @@ interface ExecutableAction<TInput, TOutput> {
     reset: () => void;
     query?: UseApiQuery;
 }
-/**
- * النوع النهائي الذي يعيده هوك useApiModule.
- */
-type ModuleActions<TModule extends ApiModuleConfig> = {
-    [K in keyof TModule['actions']]: TModule['actions'][K] extends ActionConfig<infer TInput, infer TOutput> ? ExecutableAction<TInput, TOutput> : never;
-};
 type UseApiState<T> = StandardResponse<T>;
 interface UseApiQuery {
     /** The current query options state. */
     options: QueryOptions;
     /** A function to set the entire query options object at once. */
-    setOptions: React$1.Dispatch<React$1.SetStateAction<QueryOptions>>;
+    setOptions: React__default.Dispatch<React__default.SetStateAction<QueryOptions>>;
     /** Sets the current page number. */
     setPage: (page: number) => void;
     /** Sets the number of items per page and resets to the first page. */
@@ -202,19 +188,72 @@ interface UseApiConfig<T> {
     onSuccess?: (message: string, data?: T) => void;
     onError?: (message: string, error?: ApiError) => void;
 }
-interface ActionConfigModule<TInput = any, TOutput = any> {
+
+declare function createApiClient(config: ApiClientConfig): AxiosInstance;
+
+/** @description Extends the base ActionState with an `isStale` flag for automatic refetching. */
+interface ActionState<TOutput> extends ActionStateModule<TOutput> {
+    isStale?: boolean;
+}
+/** @description Defines the configuration for a single API action within a module. */
+interface ActionConfigModule<TInput = unknown, TOutput = unknown> {
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
     path: string;
     description?: string;
-    isList?: boolean;
+    hasQuery?: boolean;
+    autoFetch?: boolean;
     invalidates?: string[];
+    _input?: TInput;
+    _output?: TOutput;
 }
-interface ApiModuleConfig {
+/** @description Defines the complete structure of an API module. */
+interface ApiModuleConfig<TActions extends Record<string, ActionConfigModule<any, any>>> {
     baseEndpoint: string;
-    actions: Record<string, ActionConfigModule<any, any>>;
+    actions: TActions;
+}
+/** @description Configuration options passed directly to the `useApiModule` hook. */
+interface UseApiModuleOptions {
+    onSuccess?: (actionName: string, message: string, data: unknown) => void;
+    onError?: (actionName: string, message: string, error?: ApiError | null) => void;
+    refetchOnWindowFocus?: boolean;
+    pathParams?: Record<string, any>;
+    enabled?: boolean;
+}
+/** A utility type to infer the Input type (`TInput`) from an ActionConfigModule. */
+type InputOf<TActionConfig> = TActionConfig extends ActionConfigModule<infer TInput, any> ? TInput : never;
+/** A utility type to infer the Output type (`TOutput`) from an ActionConfigModule. */
+type OutputOf<TActionConfig> = TActionConfig extends ActionConfigModule<any, infer TOutput> ? TOutput : never;
+/** @description Defines the options for the `execute` function, enabling optimistic updates. */
+interface ExecuteOptions<TInput, TOutput, TContext = unknown> {
+    pathParams?: Record<string, any>;
+    config?: AxiosRequestConfig;
+    onMutate?: (variables: TInput) => TContext | Promise<TContext>;
+    onSuccess?: (data: TOutput, context?: TContext) => void;
+    onError?: (error: ApiError, context?: TContext) => void;
+}
+/** @description A fully-typed object representing the callable actions for a module. */
+type ModuleActions<TActions extends Record<string, ActionConfigModule<any, any>>> = {
+    [K in keyof TActions]: {
+        execute: <TContext = unknown>(input?: InputOf<TActions[K]>, options?: ExecuteOptions<InputOf<TActions[K]>, OutputOf<TActions[K]>, TContext>) => Promise<StandardResponse<OutputOf<TActions[K]>>>;
+        reset: (input?: InputOf<TActions[K]>, options?: {
+            pathParams?: Record<string, any>;
+        }) => void;
+    };
+};
+/** @description A fully-typed object representing the reactive states for each action in a module. */
+type ModuleStates<TActions extends Record<string, ActionConfigModule<any, any>>> = {
+    [K in keyof TActions]: ActionState<OutputOf<TActions[K]>>;
+};
+/** @description The complete, fully-typed return object of the `useApiModule` hook. */
+interface UseApiModuleReturn<TActions extends Record<string, ActionConfigModule<any, any>>> {
+    states: ModuleStates<TActions>;
+    actions: ModuleActions<TActions>;
+    queries: {
+        [K in keyof TActions]?: TActions[K] extends {
+            hasQuery: true;
+        } ? UseApiQuery : never;
+    };
 }
-
-declare function createApiClient(config: ApiClientConfig): AxiosInstance;
 
 /**
  * A factory function to create a reusable set of API services for a specific endpoint.
@@ -231,6 +270,22 @@ declare function createApiServices<T>(axiosInstance: AxiosInstance, baseEndpoint
     bulkDelete: (ids: Array<string | number>, config?: ActionOptions) => Promise<StandardResponse<any>>;
     upload: (file: File, additionalData?: Record<string, any>, config?: ActionOptions) => Promise<StandardResponse<any>>;
 };
+/**
+ * [نسخة محدثة ومحسّنة]
+ * دالة عامة وصريحة لتنفيذ أي طلب API.
+ * تستقبل وسائط منظمة بدلاً من محاولة تخمينها.
+ *
+ * @param axiosInstance - نسخة Axios.
+ * @param baseEndpoint - نقطة النهاية الأساسية للموديول.
+ * @param actionConfig - إعدادات الإجراء المحدد.
+ * @param params - كائن يحتوي على جميع البارامترات اللازمة للطلب.
+ * @returns Promise<StandardResponse<any>>
+ */
+declare function callDynamicApi(axiosInstance: AxiosInstance, baseEndpoint: string, actionConfig: ActionConfigModule<any, any>, params: {
+    pathParams?: Record<string, string | number>;
+    body?: any;
+    config?: AxiosRequestConfig;
+}): Promise<StandardResponse<any>>;
 
 /**
  * [نسخة مطورة] يبني سلسلة استعلام (query string) من كائن الخيارات.
@@ -303,8 +358,6 @@ declare const processResponse: <T>(responseOrError: AxiosResponse<any> | AxiosEr
 
 declare function useApi<T>(axiosInstance: AxiosInstance, config: UseApiConfig<T>): any;
 
-declare function useApiModule<TModule extends ApiModuleConfig>(axiosInstance: AxiosInstance, moduleConfig: TModule, options?: UseApiModuleOptions): any;
-
 /**
  * Represents the internal state of the `useApiRecord` hook.
  * It mirrors the `StandardResponse` structure, which is the unified response format
@@ -407,6 +460,38 @@ type EffectCallback = () => (void | (() => void));
 type DependencyList = readonly any[];
 declare function useDeepCompareEffect(callback: EffectCallback, dependencies: DependencyList): void;
 
+declare const ApiModuleProvider: React$1.Provider<UseApiModuleReturn<any> | null>;
+declare function useModuleContext<TActions extends Record<string, ActionConfigModule<any, any>>>(): UseApiModuleReturn<TActions>;
+declare function useApiModule<TActions extends Record<string, ActionConfigModule<any, any>>>(axiosInstance: AxiosInstance, moduleConfig: ApiModuleConfig<TActions>, options?: UseApiModuleOptions): UseApiModuleReturn<TActions>;
+
+declare class GlobalStateManager {
+    private store;
+    /**
+     * يحصل على لقطة (snapshot) للحالة الحالية لمفتاح معين.
+     */
+    getSnapshot<T>(key: string): ActionStateModule<T>;
+    /**
+     * يسجل دالة callback للاستماع إلى التغييرات على مفتاح معين.
+     * @returns دالة لإلغاء الاشتراك.
+     */
+    subscribe(key: string, callback: () => void): () => void;
+    /**
+     * يحدّث الحالة لمفتاح معين ويقوم بإعلام جميع المشتركين.
+     */
+    setState<T>(key: string, updater: (prevState: ActionStateModule<T>) => ActionStateModule<T>): void;
+    /**
+     * يجعل البيانات المرتبطة بمفتاح معين "قديمة" (stale).
+     */
+    invalidate(key: string): void;
+    /**
+   * [نسخة محدثة وأكثر قوة]
+   * يجعل كل البيانات التي تبدأ بمفتاح معين "قديمة" (stale).
+   * @example invalidateByPrefix('myModule/list::') سيبطل كل صفحات القائمة.
+   */
+    invalidateByPrefix(prefix: string): void;
+}
+declare const globalStateManager: GlobalStateManager;
+
 /**
  * @file src/hooks/useApi.types.ts
  * @description This file defines the professional, publicly-facing types for the `useApi` hook,
@@ -436,8 +521,8 @@ interface UseApiActions<T, TListItem = T extends (infer U)[] ? U : T> {
  * @template T The type of the data entity being managed.
  */
 interface UseApiReturn<T> {
-    state: UseApiState<T>;
-    setState: React.Dispatch<React.SetStateAction<UseApiState<T>>>;
+    state: StandardResponse<T>;
+    setState: React.Dispatch<React.SetStateAction<StandardResponse<T>>>;
     actions: UseApiActions<T>;
     query: UseApiQuery;
 }
@@ -488,4 +573,4 @@ interface UseApiResourceReturn<T, TCreate, TUpdate, TPathParams> {
     setQuery: React.Dispatch<React.SetStateAction<QueryOptions>>;
 }
 
-export { type ActionConfig, type ActionConfigModule, type ActionOptions, type ActionState, type ApiClientConfig, type ApiError, type ApiModuleConfig, type ApiResourceStatus, type ExecutableAction, type LogLevel, type Middleware, type MiddlewareContext, type ModuleActions, type PaginationMeta, type QueryOptions, type RefreshTokenConfig, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiActions, type UseApiConfig, type UseApiModuleOptions, type UseApiQuery, type UseApiRecordActions, type UseApiRecordConfig, type UseApiRecordReturn, type UseApiRecordState, type UseApiResourceActions, type UseApiResourceConfig, type UseApiResourceReturn, type UseApiResourceState, type UseApiReturn, type UseApiState, type ValidationError, buildPaginateQuery, cacheManager, createApiActions, createApiClient, createApiServices, processResponse, useApi, useApiModule, useApiRecord, useDeepCompareEffect };
+export { type ActionConfig, type ActionConfigModule, type ActionOptions, type ActionState, type ActionStateModule, type ApiClientConfig, type ApiError, type ApiModuleConfig, ApiModuleProvider, type ApiResourceStatus, type ExecutableAction, type ExecuteOptions, type InputOf, type LogLevel, type Middleware, type MiddlewareContext, type ModuleActions, type ModuleStates, type OutputOf, type PaginationMeta, type QueryOptions, type RefreshTokenConfig, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiActions, type UseApiConfig, type UseApiModuleOptions, type UseApiModuleReturn, type UseApiQuery, type UseApiRecordActions, type UseApiRecordConfig, type UseApiRecordReturn, type UseApiRecordState, type UseApiResourceActions, type UseApiResourceConfig, type UseApiResourceReturn, type UseApiResourceState, type UseApiReturn, type UseApiState, type ValidationError, buildPaginateQuery, cacheManager, callDynamicApi, createApiActions, createApiClient, createApiServices, globalStateManager, processResponse, useApi, useApiModule, useApiRecord, useDeepCompareEffect, useModuleContext };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { InternalAxiosRequestConfig, AxiosResponse, AxiosRequestConfig, AxiosProgressEvent, AxiosInstance, Method, AxiosError } from 'axios';
-import React$1, { Dispatch, SetStateAction } from 'react';
+import * as React$1 from 'react';
+import React__default, { Dispatch, SetStateAction } from 'react';
 
 /**
  * يمثل معلومات الترقيم (Pagination) التي قد تعود من ה-API.
@@ -120,22 +121,11 @@ interface ActionConfig<TInput = any, TOutput = any> {
     isList?: boolean;
     invalidates?: string[];
 }
-/**
- * خيارات الإعداد لهوك useApiModule.
- */
-interface UseApiModuleOptions {
-    onSuccess?: (actionName: string, message: string, data: any) => void;
-    onError?: (actionName: string, message: string, error?: ApiError | null) => void;
-    staleTime?: number;
-    cacheTime?: number;
-    refetchOnWindowFocus?: boolean;
-    pathParams?: Record<string, any>;
-}
 /**
  * [مُحدَّث] يمثل الحالة التفاعلية الكاملة لإجراء واحد.
  * هذا هو النوع الذي يتم إرجاعه في `states` من الهوك.
  */
-interface ActionState<TOutput> {
+interface ActionStateModule<TOutput> {
     data: TOutput | null;
     links?: Record<string, string | null>;
     meta?: PaginationMeta | Record<string, any>;
@@ -146,12 +136,14 @@ interface ActionState<TOutput> {
     message?: string;
     validationErrors?: ValidationError[];
     rawResponse: any | null;
+    isStale?: boolean;
+    lastSuccessAt?: number;
 }
 /**
  * الكائن الموحد الذي يتم إرجاعه لكل إجراء، ويحتوي على حالته ومنفذه وأدوات التحكم.
  */
 interface ExecutableAction<TInput, TOutput> {
-    state: ActionState<TOutput>;
+    state: ActionStateModule<TOutput>;
     execute: (input?: TInput, options?: {
         pathParams?: Record<string, any>;
         config?: AxiosRequestConfig;
@@ -160,18 +152,12 @@ interface ExecutableAction<TInput, TOutput> {
     reset: () => void;
     query?: UseApiQuery;
 }
-/**
- * النوع النهائي الذي يعيده هوك useApiModule.
- */
-type ModuleActions<TModule extends ApiModuleConfig> = {
-    [K in keyof TModule['actions']]: TModule['actions'][K] extends ActionConfig<infer TInput, infer TOutput> ? ExecutableAction<TInput, TOutput> : never;
-};
 type UseApiState<T> = StandardResponse<T>;
 interface UseApiQuery {
     /** The current query options state. */
     options: QueryOptions;
     /** A function to set the entire query options object at once. */
-    setOptions: React$1.Dispatch<React$1.SetStateAction<QueryOptions>>;
+    setOptions: React__default.Dispatch<React__default.SetStateAction<QueryOptions>>;
     /** Sets the current page number. */
     setPage: (page: number) => void;
     /** Sets the number of items per page and resets to the first page. */
@@ -202,19 +188,72 @@ interface UseApiConfig<T> {
     onSuccess?: (message: string, data?: T) => void;
     onError?: (message: string, error?: ApiError) => void;
 }
-interface ActionConfigModule<TInput = any, TOutput = any> {
+
+declare function createApiClient(config: ApiClientConfig): AxiosInstance;
+
+/** @description Extends the base ActionState with an `isStale` flag for automatic refetching. */
+interface ActionState<TOutput> extends ActionStateModule<TOutput> {
+    isStale?: boolean;
+}
+/** @description Defines the configuration for a single API action within a module. */
+interface ActionConfigModule<TInput = unknown, TOutput = unknown> {
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
     path: string;
     description?: string;
-    isList?: boolean;
+    hasQuery?: boolean;
+    autoFetch?: boolean;
     invalidates?: string[];
+    _input?: TInput;
+    _output?: TOutput;
 }
-interface ApiModuleConfig {
+/** @description Defines the complete structure of an API module. */
+interface ApiModuleConfig<TActions extends Record<string, ActionConfigModule<any, any>>> {
     baseEndpoint: string;
-    actions: Record<string, ActionConfigModule<any, any>>;
+    actions: TActions;
+}
+/** @description Configuration options passed directly to the `useApiModule` hook. */
+interface UseApiModuleOptions {
+    onSuccess?: (actionName: string, message: string, data: unknown) => void;
+    onError?: (actionName: string, message: string, error?: ApiError | null) => void;
+    refetchOnWindowFocus?: boolean;
+    pathParams?: Record<string, any>;
+    enabled?: boolean;
+}
+/** A utility type to infer the Input type (`TInput`) from an ActionConfigModule. */
+type InputOf<TActionConfig> = TActionConfig extends ActionConfigModule<infer TInput, any> ? TInput : never;
+/** A utility type to infer the Output type (`TOutput`) from an ActionConfigModule. */
+type OutputOf<TActionConfig> = TActionConfig extends ActionConfigModule<any, infer TOutput> ? TOutput : never;
+/** @description Defines the options for the `execute` function, enabling optimistic updates. */
+interface ExecuteOptions<TInput, TOutput, TContext = unknown> {
+    pathParams?: Record<string, any>;
+    config?: AxiosRequestConfig;
+    onMutate?: (variables: TInput) => TContext | Promise<TContext>;
+    onSuccess?: (data: TOutput, context?: TContext) => void;
+    onError?: (error: ApiError, context?: TContext) => void;
+}
+/** @description A fully-typed object representing the callable actions for a module. */
+type ModuleActions<TActions extends Record<string, ActionConfigModule<any, any>>> = {
+    [K in keyof TActions]: {
+        execute: <TContext = unknown>(input?: InputOf<TActions[K]>, options?: ExecuteOptions<InputOf<TActions[K]>, OutputOf<TActions[K]>, TContext>) => Promise<StandardResponse<OutputOf<TActions[K]>>>;
+        reset: (input?: InputOf<TActions[K]>, options?: {
+            pathParams?: Record<string, any>;
+        }) => void;
+    };
+};
+/** @description A fully-typed object representing the reactive states for each action in a module. */
+type ModuleStates<TActions extends Record<string, ActionConfigModule<any, any>>> = {
+    [K in keyof TActions]: ActionState<OutputOf<TActions[K]>>;
+};
+/** @description The complete, fully-typed return object of the `useApiModule` hook. */
+interface UseApiModuleReturn<TActions extends Record<string, ActionConfigModule<any, any>>> {
+    states: ModuleStates<TActions>;
+    actions: ModuleActions<TActions>;
+    queries: {
+        [K in keyof TActions]?: TActions[K] extends {
+            hasQuery: true;
+        } ? UseApiQuery : never;
+    };
 }
-
-declare function createApiClient(config: ApiClientConfig): AxiosInstance;
 
 /**
  * A factory function to create a reusable set of API services for a specific endpoint.
@@ -231,6 +270,22 @@ declare function createApiServices<T>(axiosInstance: AxiosInstance, baseEndpoint
     bulkDelete: (ids: Array<string | number>, config?: ActionOptions) => Promise<StandardResponse<any>>;
     upload: (file: File, additionalData?: Record<string, any>, config?: ActionOptions) => Promise<StandardResponse<any>>;
 };
+/**
+ * [نسخة محدثة ومحسّنة]
+ * دالة عامة وصريحة لتنفيذ أي طلب API.
+ * تستقبل وسائط منظمة بدلاً من محاولة تخمينها.
+ *
+ * @param axiosInstance - نسخة Axios.
+ * @param baseEndpoint - نقطة النهاية الأساسية للموديول.
+ * @param actionConfig - إعدادات الإجراء المحدد.
+ * @param params - كائن يحتوي على جميع البارامترات اللازمة للطلب.
+ * @returns Promise<StandardResponse<any>>
+ */
+declare function callDynamicApi(axiosInstance: AxiosInstance, baseEndpoint: string, actionConfig: ActionConfigModule<any, any>, params: {
+    pathParams?: Record<string, string | number>;
+    body?: any;
+    config?: AxiosRequestConfig;
+}): Promise<StandardResponse<any>>;
 
 /**
  * [نسخة مطورة] يبني سلسلة استعلام (query string) من كائن الخيارات.
@@ -303,8 +358,6 @@ declare const processResponse: <T>(responseOrError: AxiosResponse<any> | AxiosEr
 
 declare function useApi<T>(axiosInstance: AxiosInstance, config: UseApiConfig<T>): any;
 
-declare function useApiModule<TModule extends ApiModuleConfig>(axiosInstance: AxiosInstance, moduleConfig: TModule, options?: UseApiModuleOptions): any;
-
 /**
  * Represents the internal state of the `useApiRecord` hook.
  * It mirrors the `StandardResponse` structure, which is the unified response format
@@ -407,6 +460,38 @@ type EffectCallback = () => (void | (() => void));
 type DependencyList = readonly any[];
 declare function useDeepCompareEffect(callback: EffectCallback, dependencies: DependencyList): void;
 
+declare const ApiModuleProvider: React$1.Provider<UseApiModuleReturn<any> | null>;
+declare function useModuleContext<TActions extends Record<string, ActionConfigModule<any, any>>>(): UseApiModuleReturn<TActions>;
+declare function useApiModule<TActions extends Record<string, ActionConfigModule<any, any>>>(axiosInstance: AxiosInstance, moduleConfig: ApiModuleConfig<TActions>, options?: UseApiModuleOptions): UseApiModuleReturn<TActions>;
+
+declare class GlobalStateManager {
+    private store;
+    /**
+     * يحصل على لقطة (snapshot) للحالة الحالية لمفتاح معين.
+     */
+    getSnapshot<T>(key: string): ActionStateModule<T>;
+    /**
+     * يسجل دالة callback للاستماع إلى التغييرات على مفتاح معين.
+     * @returns دالة لإلغاء الاشتراك.
+     */
+    subscribe(key: string, callback: () => void): () => void;
+    /**
+     * يحدّث الحالة لمفتاح معين ويقوم بإعلام جميع المشتركين.
+     */
+    setState<T>(key: string, updater: (prevState: ActionStateModule<T>) => ActionStateModule<T>): void;
+    /**
+     * يجعل البيانات المرتبطة بمفتاح معين "قديمة" (stale).
+     */
+    invalidate(key: string): void;
+    /**
+   * [نسخة محدثة وأكثر قوة]
+   * يجعل كل البيانات التي تبدأ بمفتاح معين "قديمة" (stale).
+   * @example invalidateByPrefix('myModule/list::') سيبطل كل صفحات القائمة.
+   */
+    invalidateByPrefix(prefix: string): void;
+}
+declare const globalStateManager: GlobalStateManager;
+
 /**
  * @file src/hooks/useApi.types.ts
  * @description This file defines the professional, publicly-facing types for the `useApi` hook,
@@ -436,8 +521,8 @@ interface UseApiActions<T, TListItem = T extends (infer U)[] ? U : T> {
  * @template T The type of the data entity being managed.
  */
 interface UseApiReturn<T> {
-    state: UseApiState<T>;
-    setState: React.Dispatch<React.SetStateAction<UseApiState<T>>>;
+    state: StandardResponse<T>;
+    setState: React.Dispatch<React.SetStateAction<StandardResponse<T>>>;
     actions: UseApiActions<T>;
     query: UseApiQuery;
 }
@@ -488,4 +573,4 @@ interface UseApiResourceReturn<T, TCreate, TUpdate, TPathParams> {
     setQuery: React.Dispatch<React.SetStateAction<QueryOptions>>;
 }
 
-export { type ActionConfig, type ActionConfigModule, type ActionOptions, type ActionState, type ApiClientConfig, type ApiError, type ApiModuleConfig, type ApiResourceStatus, type ExecutableAction, type LogLevel, type Middleware, type MiddlewareContext, type ModuleActions, type PaginationMeta, type QueryOptions, type RefreshTokenConfig, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiActions, type UseApiConfig, type UseApiModuleOptions, type UseApiQuery, type UseApiRecordActions, type UseApiRecordConfig, type UseApiRecordReturn, type UseApiRecordState, type UseApiResourceActions, type UseApiResourceConfig, type UseApiResourceReturn, type UseApiResourceState, type UseApiReturn, type UseApiState, type ValidationError, buildPaginateQuery, cacheManager, createApiActions, createApiClient, createApiServices, processResponse, useApi, useApiModule, useApiRecord, useDeepCompareEffect };
+export { type ActionConfig, type ActionConfigModule, type ActionOptions, type ActionState, type ActionStateModule, type ApiClientConfig, type ApiError, type ApiModuleConfig, ApiModuleProvider, type ApiResourceStatus, type ExecutableAction, type ExecuteOptions, type InputOf, type LogLevel, type Middleware, type MiddlewareContext, type ModuleActions, type ModuleStates, type OutputOf, type PaginationMeta, type QueryOptions, type RefreshTokenConfig, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiActions, type UseApiConfig, type UseApiModuleOptions, type UseApiModuleReturn, type UseApiQuery, type UseApiRecordActions, type UseApiRecordConfig, type UseApiRecordReturn, type UseApiRecordState, type UseApiResourceActions, type UseApiResourceConfig, type UseApiResourceReturn, type UseApiResourceState, type UseApiReturn, type UseApiState, type ValidationError, buildPaginateQuery, cacheManager, callDynamicApi, createApiActions, createApiClient, createApiServices, globalStateManager, processResponse, useApi, useApiModule, useApiRecord, useDeepCompareEffect, useModuleContext };