flysoft-react-ui 0.2.0 → 0.2.2

package/dist/services/apiClient.d.ts

@@ -1,46 +1,92 @@
-import type { AxiosRequestConfig } from "axios";
-export type HttpMethod = "get" | "post" | "put" | "delete" | "patch";
-export interface AppApiError {
-    message: string;
-    code?: string;
-    status?: number;
-    details?: unknown;
-    originalError?: unknown;
-}
+import { type AxiosResponse } from "axios";
 export interface ApiClientConfig {
     baseURL?: string;
     timeout?: number;
     headers?: Record<string, string>;
 }
-export interface RequestOptions<TBody = unknown, TParams = Record<string, unknown>> {
-    url: string;
-    params?: TParams;
-    data?: TBody;
-    headers?: Record<string, string>;
-    config?: AxiosRequestConfig;
-}
 type TokenProvider = () => string | undefined;
-export declare class ApiClient {
-    private readonly instance;
+interface FileResponse {
+    data: Blob;
+    headers: AxiosResponse["headers"];
+}
+interface UploadFileOptions {
+    paramName?: string;
+    [key: string]: unknown;
+}
+declare class ApiClientService {
+    private instance;
     private tokenProvider?;
     constructor(config?: ApiClientConfig);
     private setupInterceptors;
+    /**
+     * Establece el proveedor de token que se usará en todas las peticiones
+     * @param provider Función que retorna el token de autorización
+     */
     setTokenProvider(provider: TokenProvider | undefined): void;
+    /**
+     * Limpia el proveedor de token
+     */
     clearTokenProvider(): void;
+    /**
+     * Actualiza la configuración por defecto del cliente
+     */
     updateDefaults(config: ApiClientConfig): void;
-    get<TResponse, TParams = Record<string, unknown>>(options: RequestOptions<never, TParams>): Promise<TResponse>;
-    delete<TResponse, TParams = Record<string, unknown>>(options: RequestOptions<never, TParams>): Promise<TResponse>;
-    post<TResponse, TBody = unknown, TParams = Record<string, unknown>>(options: RequestOptions<TBody, TParams>): Promise<TResponse>;
-    put<TResponse, TBody = unknown, TParams = Record<string, unknown>>(options: RequestOptions<TBody, TParams>): Promise<TResponse>;
-    patch<TResponse, TBody = unknown, TParams = Record<string, unknown>>(options: RequestOptions<TBody, TParams>): Promise<TResponse>;
-    private transformResponse;
-    private ensureAppApiError;
-    private isAppApiError;
-    private toAppApiError;
+    private axiosRequest;
+    /**
+     * Realiza una petición GET
+     * @param url URL del endpoint
+     * @param params Parámetros opcionales que se enviarán como query string
+     * @param headers Headers opcionales de la petición
+     */
+    get<T = unknown>(url: string, params?: Record<string, unknown>, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Realiza una petición POST
+     */
+    post<T = unknown>(url: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Realiza una petición PUT
+     */
+    put<T = unknown>(url: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Realiza una petición DELETE
+     */
+    del<T = unknown>(url: string, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Obtiene un archivo como Blob
+     */
+    getFile(url: string, headers?: Record<string, string>): Promise<FileResponse>;
+    /**
+     * Obtiene un archivo y retorna su URL como objeto
+     */
+    getFileAsUrl(url: string, headers?: Record<string, string>): Promise<string>;
+    /**
+     * Abre un archivo en una nueva ventana
+     */
+    openFile(url: string, headers?: Record<string, string>): Promise<void>;
+    /**
+     * Descarga un archivo
+     */
+    downloadFile(url: string, headers?: Record<string, string>): Promise<void>;
+    /**
+     * Sube uno o más archivos usando FormData
+     */
+    uploadFile<T = unknown>(url: string, files: FileList | File[], headers?: UploadFileOptions): Promise<T>;
 }
-export declare const apiClient: ApiClient;
-export declare const createApiClient: (config?: ApiClientConfig) => ApiClient;
+/**
+ * Cliente de API compartido con todas las funciones de HTTP
+ */
+export declare const apiClient: ApiClientService;
+/**
+ * Crea una nueva instancia del cliente de API
+ */
+export declare const createApiClient: (config?: ApiClientConfig) => ApiClientService;
+/**
+ * Establece el proveedor de token global para el cliente compartido
+ */
 export declare const setApiClientTokenProvider: (provider: TokenProvider | undefined) => void;
+/**
+ * Limpia el proveedor de token global
+ */
 export declare const clearApiClientTokenProvider: () => void;
 export {};
 //# sourceMappingURL=apiClient.d.ts.map

package/dist/services/apiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../src/services/apiClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,kBAAkB,EAGnB,MAAM,OAAO,CAAC;AAEf,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc,CAC7B,KAAK,GAAG,OAAO,EACf,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,KAAK,aAAa,GAAG,MAAM,MAAM,GAAG,SAAS,CAAC;AAoB9C,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAE1B,MAAM,CAAC,EAAE,eAAe;IAcpC,OAAO,CAAC,iBAAiB;IAwBzB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS;IAIpD,kBAAkB;IAIlB,cAAc,CAAC,MAAM,EAAE,eAAe;IAehC,GAAG,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,GACtC,OAAO,CAAC,SAAS,CAAC;IAaf,MAAM,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,GACtC,OAAO,CAAC,SAAS,CAAC;IAaf,IAAI,CACR,SAAS,EACT,KAAK,GAAG,OAAO,EACf,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAaxD,GAAG,CACP,SAAS,EACT,KAAK,GAAG,OAAO,EACf,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAaxD,KAAK,CACT,SAAS,EACT,KAAK,GAAG,OAAO,EACf,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAa9D,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,aAAa;CAiCtB;AAID,eAAO,MAAM,SAAS,WAAe,CAAC;AAEtC,eAAO,MAAM,eAAe,GAAI,SAAS,eAAe,cAA0B,CAAC;AAEnF,eAAO,MAAM,yBAAyB,GAAI,UAAU,aAAa,GAAG,SAAS,SAE5E,CAAC;AAEF,eAAO,MAAM,2BAA2B,YAEvC,CAAC"}
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../src/services/apiClient.ts"],"names":[],"mappings":"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"}

package/dist/services/apiClient.js

@@ -1,58 +1,58 @@
-import axios from "axios";
-const DEFAULT_CONFIG = {
-    baseURL: "/api",
-    timeout: 15000,
-};
-const isObject = (value) => typeof value === "object" && value !== null;
-const extractErrorData = (error) => {
-    if (isObject(error.response?.data)) {
-        return error.response?.data;
-    }
-    if (typeof error.response?.data === "string") {
-        return { message: error.response?.data };
-    }
-    return {};
-};
-export class ApiClient {
+import axios, {} from "axios";
+class ApiClientService {
     instance;
     tokenProvider;
     constructor(config) {
         this.instance = axios.create({
-            baseURL: config?.baseURL ?? DEFAULT_CONFIG.baseURL,
-            timeout: config?.timeout ?? DEFAULT_CONFIG.timeout,
+            baseURL: config?.baseURL ?? "",
+            timeout: config?.timeout ?? 15000,
             headers: {
                 "Content-Type": "application/json",
-                Accept: "application/json",
                 ...config?.headers,
             },
         });
         this.setupInterceptors();
     }
     setupInterceptors() {
-        this.instance.interceptors.request.use((requestConfig) => {
+        // Request interceptor para inyectar el token automáticamente
+        this.instance.interceptors.request.use((config) => {
             const token = this.tokenProvider?.();
-            if (token) {
-                if (requestConfig.headers && "set" in requestConfig.headers) {
-                    requestConfig.headers.set?.("Authorization", `Bearer ${token}`);
+            if (token && config.headers) {
+                // Manejo compatible con diferentes versiones de axios
+                if ("set" in config.headers &&
+                    typeof config.headers.set === "function") {
+                    config.headers.set("Authorization", `Bearer ${token}`);
                 }
                 else {
-                    const existingHeaders = requestConfig.headers ?? {};
-                    requestConfig.headers = {
-                        ...existingHeaders,
-                        Authorization: `Bearer ${token}`,
-                    };
+                    const headers = config.headers;
+                    headers.Authorization = `Bearer ${token}`;
                 }
             }
-            return requestConfig;
+            return config;
+        }, (error) => {
+            return Promise.reject(error);
+        });
+        // Response interceptor para manejo de errores (opcional, puede extenderse)
+        this.instance.interceptors.response.use((response) => response, (error) => {
+            return Promise.reject(error);
         });
-        this.instance.interceptors.response.use((response) => response, (error) => Promise.reject(this.toAppApiError(error)));
     }
+    /**
+     * Establece el proveedor de token que se usará en todas las peticiones
+     * @param provider Función que retorna el token de autorización
+     */
     setTokenProvider(provider) {
         this.tokenProvider = provider;
     }
+    /**
+     * Limpia el proveedor de token
+     */
     clearTokenProvider() {
         this.tokenProvider = undefined;
     }
+    /**
+     * Actualiza la configuración por defecto del cliente
+     */
     updateDefaults(config) {
         if (config.baseURL) {
             this.instance.defaults.baseURL = config.baseURL;
@@ -61,127 +61,153 @@ export class ApiClient {
             this.instance.defaults.timeout = config.timeout;
         }
         if (config.headers) {
-            this.instance.defaults.headers = {
-                ...this.instance.defaults.headers,
-                ...config.headers,
-            };
+            // Actualizar headers comunes de forma segura
+            Object.assign(this.instance.defaults.headers.common || {}, config.headers);
         }
     }
-    async get(options) {
-        try {
-            const response = await this.instance.get(options.url, {
-                params: options.params,
-                headers: options.headers,
-                ...options.config,
-            });
-            return this.transformResponse(response);
-        }
-        catch (error) {
-            throw this.ensureAppApiError(error);
-        }
-    }
-    async delete(options) {
-        try {
-            const response = await this.instance.delete(options.url, {
-                params: options.params,
-                headers: options.headers,
-                ...options.config,
-            });
-            return this.transformResponse(response);
-        }
-        catch (error) {
-            throw this.ensureAppApiError(error);
-        }
-    }
-    async post(options) {
-        try {
-            const response = await this.instance.post(options.url, options.data, {
-                params: options.params,
-                headers: options.headers,
-                ...options.config,
-            });
-            return this.transformResponse(response);
-        }
-        catch (error) {
-            throw this.ensureAppApiError(error);
-        }
-    }
-    async put(options) {
-        try {
-            const response = await this.instance.put(options.url, options.data, {
-                params: options.params,
-                headers: options.headers,
-                ...options.config,
-            });
-            return this.transformResponse(response);
-        }
-        catch (error) {
-            throw this.ensureAppApiError(error);
-        }
+    async axiosRequest({ method, url, headers, body, params, }) {
+        return await this.instance({
+            method,
+            headers,
+            url,
+            data: body,
+            params,
+        });
     }
-    async patch(options) {
-        try {
-            const response = await this.instance.patch(options.url, options.data, {
-                params: options.params,
-                headers: options.headers,
-                ...options.config,
-            });
-            return this.transformResponse(response);
-        }
-        catch (error) {
-            throw this.ensureAppApiError(error);
-        }
+    /**
+     * Realiza una petición GET
+     * @param url URL del endpoint
+     * @param params Parámetros opcionales que se enviarán como query string
+     * @param headers Headers opcionales de la petición
+     */
+    async get(url, params, headers) {
+        const response = await this.axiosRequest({
+            method: "GET",
+            url,
+            params,
+            headers,
+        });
+        return response.data;
     }
-    transformResponse(response) {
+    /**
+     * Realiza una petición POST
+     */
+    async post(url, body, headers) {
+        const response = await this.axiosRequest({
+            method: "POST",
+            url,
+            headers,
+            body,
+        });
         return response.data;
     }
-    ensureAppApiError(error) {
-        if (this.isAppApiError(error)) {
-            return error;
-        }
-        return this.toAppApiError(error);
+    /**
+     * Realiza una petición PUT
+     */
+    async put(url, body, headers) {
+        const response = await this.axiosRequest({
+            method: "PUT",
+            url,
+            headers,
+            body,
+        });
+        return response.data;
     }
-    isAppApiError(error) {
-        return (isObject(error) &&
-            typeof error.message === "string" &&
-            ("code" in error || "status" in error || "details" in error));
+    /**
+     * Realiza una petición DELETE
+     */
+    async del(url, headers) {
+        const response = await this.axiosRequest({
+            method: "DELETE",
+            url,
+            headers,
+        });
+        return response.data;
     }
-    toAppApiError(error) {
-        if (axios.isAxiosError(error)) {
-            const extracted = extractErrorData(error);
-            return {
-                message: extracted.message ??
-                    error.message ??
-                    "Unexpected API error",
-                code: extracted.code ??
-                    error.code ??
-                    "API_ERROR",
-                status: error.response?.status ?? error.status,
-                details: extracted,
-                originalError: error,
-            };
-        }
-        if (error instanceof Error) {
-            return {
-                message: error.message,
-                code: "UNKNOWN_ERROR",
-                details: undefined,
-                originalError: error,
-            };
-        }
+    /**
+     * Obtiene un archivo como Blob
+     */
+    async getFile(url, headers = {}) {
+        const response = await this.instance.get(url, {
+            responseType: "blob",
+            headers,
+        });
         return {
-            message: "Unexpected error",
-            code: "UNKNOWN_ERROR",
-            details: error,
+            data: response.data,
+            headers: response.headers,
         };
     }
+    /**
+     * Obtiene un archivo y retorna su URL como objeto
+     */
+    async getFileAsUrl(url, headers = {}) {
+        const { data } = await this.getFile(url, headers);
+        const blob = new Blob([data], { type: data.type });
+        return URL.createObjectURL(blob);
+    }
+    /**
+     * Abre un archivo en una nueva ventana
+     */
+    async openFile(url, headers) {
+        const { data } = await this.getFile(url, headers);
+        const urlData = URL.createObjectURL(data);
+        window.open(urlData);
+    }
+    /**
+     * Descarga un archivo
+     */
+    async downloadFile(url, headers) {
+        const { data, headers: dataHeaders } = await this.getFile(url, headers);
+        const contentDisposition = dataHeaders["content-disposition"] || dataHeaders["Content-Disposition"];
+        const fileName = contentDisposition
+            ?.split("filename=")[1]
+            ?.split(";")[0]
+            .replaceAll('"', "");
+        const blob = new Blob([data], { type: data.type });
+        const link = document.createElement("a");
+        link.href = window.URL.createObjectURL(blob);
+        link.setAttribute("download", fileName || "");
+        document.body.appendChild(link);
+        link.click();
+        link.parentNode?.removeChild(link);
+    }
+    /**
+     * Sube uno o más archivos usando FormData
+     */
+    async uploadFile(url, files, headers) {
+        const formData = new FormData();
+        const { paramName = "file", ...newHeaders } = headers || {};
+        const fileArray = Array.from(files);
+        for (const file of fileArray) {
+            formData.append(paramName, file, file.name);
+        }
+        const response = await this.instance.post(url, formData, {
+            headers: newHeaders,
+        });
+        return response.data;
+    }
 }
-const sharedClient = new ApiClient();
+// Instancia compartida del cliente
+const sharedClient = new ApiClientService();
+/**
+ * Cliente de API compartido con todas las funciones de HTTP
+ */
 export const apiClient = sharedClient;
-export const createApiClient = (config) => new ApiClient(config);
+/**
+ * Crea una nueva instancia del cliente de API
+ */
+export const createApiClient = (config) => {
+    return new ApiClientService(config);
+};
+/**
+ * Establece el proveedor de token global para el cliente compartido
+ */
 export const setApiClientTokenProvider = (provider) => {
     sharedClient.setTokenProvider(provider);
 };
+/**
+ * Limpia el proveedor de token global
+ */
 export const clearApiClientTokenProvider = () => {
     sharedClient.clearTokenProvider();
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "flysoft-react-ui",
   "private": false,
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "description": "A modern React UI component library with Tailwind CSS, TypeScript, and FontAwesome 5. Includes forms, layouts, themes, and templates for rapid development.",
   "keywords": [

package/dist/docs/ApiClientDocs.d.ts

@@ -1,4 +0,0 @@
-import React from "react";
-declare const ApiClientDocs: React.FC;
-export default ApiClientDocs;
-//# sourceMappingURL=ApiClientDocs.d.ts.map

package/dist/docs/ApiClientDocs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ApiClientDocs.d.ts","sourceRoot":"","sources":["../../src/docs/ApiClientDocs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAgC,MAAM,OAAO,CAAC;AAarD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAiO1B,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/docs/ApiClientDocs.js

@@ -1,66 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import React, { useCallback, useState } from "react";
-import { Badge, Button, Card, Input, useApi, useApiMutation, } from "../index";
-const API_BASE = "https://jsonplaceholder.typicode.com";
-const ApiClientDocs = () => {
-    const [postId, setPostId] = useState("1");
-    const [formState, setFormState] = useState({
-        title: "",
-        body: "",
-    });
-    const { data: postData, loading: loadingPost, error: postError, refetch: refetchPost, } = useApi({
-        url: `${API_BASE}/posts/${postId || 1}`,
-        method: "get",
-        enabled: false,
-        queryKey: "docs.posts.detail",
-        onError: (error) => {
-            console.warn("Example query error", error);
-        },
-    });
-    const { data: createdPost, loading: creatingPost, error: createError, mutateAsync: createPost, reset: resetMutation, } = useApiMutation({
-        url: `${API_BASE}/posts`,
-        method: "post",
-        invalidateKeys: ["docs.posts.detail"],
-        onSuccess: () => {
-            // Invalidate re-executes the query registered under the same key.
-            setFormState({ title: "", body: "" });
-        },
-    });
-    const handleFetchPost = useCallback(() => {
-        void refetchPost();
-    }, [refetchPost]);
-    const handleSubmit = useCallback(async (event) => {
-        event.preventDefault();
-        try {
-            await createPost({
-                data: {
-                    title: formState.title,
-                    body: formState.body,
-                    userId: 1,
-                },
-            });
-        }
-        catch (error) {
-            console.info("Example mutation error", error);
-        }
-    }, [createPost, formState.body, formState.title]);
-    const renderErrorBadge = (error) => {
-        if (!error)
-            return null;
-        return (_jsx(Badge, { variant: "danger", icon: "fa-exclamation-triangle", children: error.message }));
-    };
-    return (_jsxs("div", { className: "max-w-5xl mx-auto space-y-8", children: [_jsx(Card, { title: "ApiClient - Resumen", children: _jsxs("div", { className: "space-y-4", children: [_jsxs("p", { style: { color: "var(--flysoft-text-secondary)" }, children: ["La capa de networking usa ", _jsx("code", { children: "axios" }), " con interceptores listos para inyectar tokens y normalizar errores en", _jsx("code", { children: "AppApiError" }), ". Importa los estilos con", _jsx("code", { children: "import \"flysoft-react-ui/styles\";" }), " y consume", _jsx("code", { children: "apiClient" }), ",", _jsx("code", { children: "useApi" }), " y ", _jsx("code", { children: "useApiMutation" }), " directamente desde la librer\u00EDa."] }), _jsxs("ul", { className: "list-disc list-inside space-y-2 text-sm", children: [_jsxs("li", { children: ["M\u00E9todos disponibles: ", _jsx("code", { children: "get" }), ", ", _jsx("code", { children: "post" }), ",", _jsx("code", { children: "put" }), ", ", _jsx("code", { children: "delete" }), " y ", _jsx("code", { children: "patch" }), " con opciones tipadas."] }), _jsxs("li", { children: ["Los errores se entregan como ", _jsx("code", { children: "AppApiError" }), " para que los componentes usen badges, alerts u otros patrones ya disponibles sin tocar los hooks."] }), _jsxs("li", { children: ["Usa ", _jsx("code", { children: "setApiClientTokenProvider" }), " para inyectar tokens (placeholder listo para integrarse con tu ThemeProvider o contextos existentes)."] })] })] }) }), _jsx(Card, { title: "Consulta simple con useApi", children: _jsxs("div", { className: "space-y-6", children: [_jsxs("form", { className: "grid grid-cols-1 sm:grid-cols-[1fr_auto] gap-4 items-end", onSubmit: (event) => {
-                                event.preventDefault();
-                                handleFetchPost();
-                            }, children: [_jsx(Input, { label: "ID del post", icon: "fa-hashtag", value: postId, onChange: (event) => setPostId(event.target.value) }), _jsx(Button, { type: "submit", variant: "primary", icon: "fa-search", loading: loadingPost, children: "Consultar" })] }), _jsxs("div", { className: "space-y-3", children: [loadingPost && (_jsx(Badge, { variant: "info", icon: "fa-spinner", className: "animate-pulse", children: "Cargando post..." })), renderErrorBadge(postError), postData && !loadingPost && (_jsx(Card, { title: `Post ${postData.id}`, children: _jsxs("div", { className: "space-y-2", children: [_jsx("h4", { className: "text-lg font-semibold", style: { color: "var(--flysoft-text-primary)" }, children: postData.title }), _jsx("p", { style: { color: "var(--flysoft-text-secondary)" }, children: postData.body })] }) }))] })] }) }), _jsx(Card, { title: "Mutaci\u00F3n con useApiMutation", children: _jsxs("form", { className: "space-y-6", onSubmit: handleSubmit, children: [_jsxs("div", { className: "grid grid-cols-1 sm:grid-cols-2 gap-4", children: [_jsx(Input, { label: "T\u00EDtulo", icon: "fa-heading", value: formState.title, onChange: (event) => setFormState((prev) => ({
-                                        ...prev,
-                                        title: event.target.value,
-                                    })) }), _jsx(Input, { label: "Contenido", icon: "fa-align-left", value: formState.body, onChange: (event) => setFormState((prev) => ({
-                                        ...prev,
-                                        body: event.target.value,
-                                    })) })] }), _jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [_jsx(Button, { type: "submit", variant: "primary", icon: "fa-paper-plane", loading: creatingPost, children: "Enviar datos" }), _jsx(Button, { type: "button", variant: "outline", icon: "fa-undo", onClick: () => {
-                                        setFormState({ title: "", body: "" });
-                                        resetMutation();
-                                    }, children: "Reiniciar" })] }), _jsxs("div", { className: "space-y-3", children: [creatingPost && (_jsx(Badge, { variant: "info", icon: "fa-spinner", className: "animate-pulse", children: "Enviando..." })), renderErrorBadge(createError), createdPost && !creatingPost && (_jsxs(Badge, { variant: "success", icon: "fa-check-circle", children: ["Post #", createdPost.id, " creado (ejemplo)."] })), _jsxs("p", { className: "text-sm", style: { color: "var(--flysoft-text-secondary)" }, children: ["Usa ", _jsx("code", { children: "invalidateKeys" }), " para refrescar queries que hayan sido registradas con ", _jsx("code", { children: "queryKey" }), " en ", _jsx("code", { children: "useApi" }), ". Esto permite mantener badges y alerts sincronizados con el estado de la UI sin alterar los hooks."] })] })] }) })] }));
-};
-export default ApiClientDocs;

package/dist/hooks/useApi.d.ts

@@ -1,27 +0,0 @@
-import type { AxiosRequestConfig } from "axios";
-import { type AppApiError, type HttpMethod, type RequestOptions } from "../services/apiClient";
-type AnyRequestOptions = RequestOptions<unknown, Record<string, unknown>>;
-type QueryRefetcher = (override?: Partial<AnyRequestOptions>) => Promise<unknown>;
-export declare const registerQuery: (key: string, refetcher: QueryRefetcher) => void;
-export declare const unregisterQuery: (key: string, refetcher: QueryRefetcher) => void;
-export declare const invalidateQueries: (keys: string[]) => Promise<void>;
-type CleanHttpMethod = HttpMethod;
-export interface UseApiOptions<TResponse, TParams = Record<string, unknown>, TBody = unknown, TTransformed = TResponse> extends Omit<RequestOptions<TBody, TParams>, "config"> {
-    method?: CleanHttpMethod;
-    transform?: (response: TResponse) => TTransformed;
-    enabled?: boolean;
-    queryKey?: string;
-    config?: AxiosRequestConfig;
-    onSuccess?: (data: TTransformed) => void;
-    onError?: (error: AppApiError) => void;
-}
-export interface UseApiResult<TData, TBody = unknown, TParams = Record<string, unknown>> {
-    data: TData | undefined;
-    loading: boolean;
-    error: AppApiError | undefined;
-    refetch: (override?: Partial<RequestOptions<TBody, TParams>>) => Promise<TData>;
-    reset: () => void;
-}
-export declare const useApi: <TResponse, TParams = Record<string, unknown>, TBody = unknown, TTransformed = TResponse>(options: UseApiOptions<TResponse, TParams, TBody, TTransformed>) => UseApiResult<TTransformed, TBody, TParams>;
-export {};
-//# sourceMappingURL=useApi.d.ts.map

package/dist/hooks/useApi.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useApi.d.ts","sourceRoot":"","sources":["../../src/hooks/useApi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,KAAK,iBAAiB,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE1E,KAAK,cAAc,GAAG,CACpB,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAClC,OAAO,CAAC,OAAO,CAAC,CAAC;AAStB,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,WAAW,cAAc,SAKnE,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,WAAW,cAAc,SAOrE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,MAAM,MAAM,EAAE,kBAgBrD,CAAC;AAEF,KAAK,eAAe,GAAG,UAAU,CAAC;AAElC,MAAM,WAAW,aAAa,CAC5B,SAAS,EACT,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,KAAK,GAAG,OAAO,EACf,YAAY,GAAG,SAAS,CACxB,SAAQ,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC;IACtD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,YAAY,CAAC;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,YAAY,CAC3B,KAAK,EACL,KAAK,GAAG,OAAO,EACf,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjC,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,CACP,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,KAC/C,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAqDD,eAAO,MAAM,MAAM,GACjB,SAAS,EACT,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,KAAK,GAAG,OAAO,EACf,YAAY,GAAG,SAAS,EAExB,SAAS,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,KAC9D,YAAY,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAyG3C,CAAC"}