@stackcraftmx/calcita 0.53.0 → 0.55.0

package/README.md

@@ -509,7 +509,7 @@ Para hacer lo mismo en un componente propio: `sx={[{p: 2}, ...sxListOf(sx)]}` (u
 | `CalcitaTopMenu` | `link`, `root` |
 | `CalcitaTransferListInput` | `root`, `list`, `actions` |
 | `CalcitaTwoStepVerification` | `qr`, `secret`, `secretCode`, `header`, `headerTitle`, `headerText`, `menuIcon` |
-| `CalcitaWizardLayout` | `stepper`, `phoneSteps`, `actions` |
+| `CalcitaWizardLayout` | `stepper`, `phoneSteps`, `actions`, `nextReason` |
 | `CalcitaWordmark` | `root`, `mode` |
 
 </details>
@@ -807,6 +807,8 @@ export const api = createApiClient({
 const orders = await api.get('/orders', {params: {page: 2}, signal});
 await api.post('/orders', {customerId: 7});
 const {blob, fileName} = await api.download('/orders/export', {onDownloadProgress});
+// un archivo que el servidor arma con datos de la pantalla (una plantilla con de quién es): POST con su cuerpo
+const template = await api.download('/documents/template', {method: 'POST', body: {companyId: 7}, onDownloadProgress});
 ```
 
 - Cada petición lleva el idioma vigente (`Accept-Language`): el servidor responde sus mensajes ya traducidos.
@@ -814,7 +816,7 @@ const {blob, fileName} = await api.download('/orders/export', {onDownloadProgres
   `requestId` para soporte y los errores por campo de un 422 (los formularios los ponen en su campo). Sin red es la misma
   forma (status 0); cancelar no es un error.
 - Cada respuesta le avisa al aviso de versión nueva qué compilación está publicada (header `X-Frontend-Build`).
-- Un Excel que llegó cortado no se entrega.
+- Un Excel que llegó cortado no se entrega (también en una descarga con POST).
 
 Si se publica otra versión con la pestaña abierta, la pantalla que no se había abierto pide un archivo que ya no existe.
 `withChunkRecovery` (de `/react-router`) recarga una vez y `RouteErrorScreen` dice «Hay una versión nueva» con su botón;
@@ -1003,6 +1005,21 @@ campos, para lo obligatorio). `FormWizard` parte un formulario en pasos, con pas
 react-hook-form); los ejemplos traen los dos. `hideBackOnFirstStep` no pinta «Anterior» en el primer paso (por omisión sale
 apagado, como antes).
 
+Un paso que todavía no se puede dejar (faltan documentos obligatorios) lo dice con `steps[].nextDisabledReason`, ya traducido:
+«Siguiente» se ve apagado y no avanza, y el motivo sale en un aviso al pasar el cursor o al llegar con Tab; en el teléfono va
+escrito arriba de los botones. En el último paso se apaga el de enviar, y con `stepSelection` `checked` tampoco se salta a un
+paso de adelante. Con `null`, como siempre. `WizardLayout` suelto lo recibe como `nextDisabledReason` (en el último paso el
+botón de enviar es suyo: apáguelo usted).
+
+```jsx
+const missing = DOCUMENTS.filter(({field, required}) => required && !values[field]).length;
+const steps = [
+    {key: 'documents', label: 'Documentos', content: <DocumentsSection />,
+     nextDisabledReason: missing > 0 ? `Faltan ${missing} documentos obligatorios` : null},
+    …
+];
+```
+
 El `onChange` y el `onBlur` que la pantalla le pase a un campo de formik o de react-hook-form también corren, después de los
 del formulario y con el valor nuevo: `<FormSelectField name="kind" … onChange={(kind) => loadRatesFor(kind)} />`. Antes los
 del formulario los pisaban sin avisar.
@@ -1044,6 +1061,18 @@ En el teléfono la etiqueta se lleva el 38 % del renglón y un nombre largo se p
 anchas sigue a la izquierda. Por omisión `side`, como antes. Para todos los formularios, una vez en el tema:
 `components: {CalcitaFormSection: {defaultProps: {labelPlacement: 'topOnPhone'}}}`.
 
+La columna de las etiquetas mide el 38 % del renglón hasta 200 px. Una lista de documentos lleva nombres largos y a la derecha
+solo los botones del cargador: con `labelWidth={FORM_LABEL_WIDTH.auto}` el nombre se lleva lo que sobre y el campo solo lo que
+ocupa. También acepta un ancho (`'320px'`, `'50%'` o un número en px). Va por sección: las demás de la pantalla no cambian.
+En el teléfono lo que sobra es poco: con `auto`, mejor junto con `labelPlacement={FORM_LABEL_PLACEMENT.topOnPhone}`.
+Como las demás piezas, `FormSection` acepta `sx`.
+
+```jsx
+<FormSection title="Expediente" labelWidth={FORM_LABEL_WIDTH.auto} labelPlacement={FORM_LABEL_PLACEMENT.topOnPhone}>
+    {DOCUMENTS.map(({field, label}) => <FormFileUploadField key={field} name={field} label={label} upload={uploadDocument} />)}
+</FormSection>
+```
+
 ### Lo obligatorio, a la vista
 
 Un campo con `required` lleva un asterisco en su etiqueta, en los 17 campos de la casa (texto, número, listas, catálogo,
@@ -1259,6 +1288,62 @@ import {FormFileUploadField} from '@stackcraftmx/calcita/forms';
 omisión `result.id`). Lo del negocio (Aprobado, Falta información) va junto al estado con `actions`, y `onStatusChange`
 dice en qué va cada renglón para contar «2 de 3 cargados».
 
+### Por trozos, con FilePond
+
+Para archivos grandes o servidores que solo reciben por trozos: la zona de `/filepond` con `createPondServer` sube cada
+archivo con el protocolo de trozos de FilePond (un POST da el folio, cada trozo va en su PATCH a `patchUrl` + folio, uno
+detrás de otro, y un HEAD dice hasta dónde llegó para retomar). Las opciones llevan los nombres de FilePond, así que un
+backend que ya recibía trozos de FilePond no cambia.
+
+```jsx
+import {FileDropzone, createPondServer} from '@stackcraftmx/calcita/filepond';
+
+const backupServer = createPondServer({
+    url: '/upload',
+    patchUrl: '/upload?patch=',
+    headers: {Authorization: `Bearer ${token}`, 'X-Upload-Context': JSON.stringify({branch: 'Querétaro'})},
+    // un backend que contesta {message, errors} en lugar de RFC 9457: la tarjeta enseña el title
+    toProblem: (body) => ({title: body.message, detail: body.message, errors: body.errors}),
+});
+
+<FileDropzone value={file} onChange={setFile} server={backupServer} apiRef={pondApi}
+              chunkUploads chunkForce chunkSize="1 MB" chunkRetryDelays={[500, 1000, 3000]}
+              pondProps={{maxParallelUploads: 1}} />
+```
+
+- La barra es honesta: cuenta lo que el servidor ya guardó y no dice 100 % hasta que guardó el último trozo (hay servidores
+  que esperan medio segundo por trozo). Nunca regresa, ni cuando un trozo se reintenta.
+- Un trozo sin respuesta o con 5xx se reintenta con las esperas de `chunkRetryDelays` (`null` o `[]`, sin reintentos); un 4xx
+  es el servidor diciendo que no y su motivo sale en la tarjeta en seguida. Con el botón de reintentar de la tarjeta, sigue
+  desde el último trozo completo, con el mismo folio.
+- `chunkSize` va en bytes o con unidades, como `maxSize` (por omisión 5 MB, el de FilePond); `chunkForce` manda por trozos
+  también lo chico.
+- Los headers van en las tres peticiones y por trozos viajan en UTF-8 (el nombre del archivo también): páselos como texto
+  normal. Un sistema que los convertía a mano para una versión vieja de FilePond (`unescape(encodeURIComponent(...))`) ya no
+  debe hacerlo: convertidos dos veces, los acentos llegan rotos.
+- `sendRequest` cambia por dónde viaja cada petición (su cliente, o uno de mentira para probar sin servidor); por omisión es
+  `uploadWithProgress`, que ahora también acepta `method`.
+- `pondProps` pasa cualquier otra opción de FilePond tal cual. Lo que la zona ya maneja gana (los tipos y pesos, los textos,
+  el candado de `disabled`/`busy`), y sus eventos (`onupdatefiles`, `onprocessfile`, `onwarning`, `onerror`, `beforeAddFile`)
+  corren después de los de la zona.
+
+El cargador mini también sube por trozos: `createChunkedUpload` arma la función `upload` de `FileUploadInput` y
+`FormFileUploadField` con el mismo protocolo, las mismas opciones (`patchUrl`, `chunkSize`, `chunkRetryDelays`, `headers`,
+`toProblem`, `sendRequest`) y sus estados de siempre. Con el último byte enviado la barra llega a 100 % y el renglón dice
+«Procesando» hasta que el servidor guardó el último trozo; al renglón llega el folio como id.
+
+```jsx
+import {FileUploadInput, createChunkedUpload} from '@stackcraftmx/calcita';
+
+const uploadBackup = createChunkedUpload({url: '/upload', patchUrl: '/upload?patch=', chunkSize: '1 MB',
+    toProblem: (body) => ({title: body.message, detail: body.message, errors: body.errors})});
+
+<FileUploadInput label="Respaldo de la base" value={backupId} onChange={setBackupId} upload={uploadBackup} />
+```
+
+Todo va por trozos (uno chico, en un solo trozo). Si solo los grandes deben ir así, la pantalla elige:
+`upload={(file, options) => (file.size > LIMITE ? uploadBackup : subidaNormal)(file, options)}`.
+
 ## Documentos, avisos legales y cuenta regresiva
 
 - `PdfViewerDialog`: un PDF en una ventana con el visor del navegador (sin librerías), con «Abrir en otra pestaña» y

package/dist/api/createApiClient.js

@@ -229,14 +229,22 @@ function createApiClient({
     }
     return mapResponse(json, { method, url });
   };
-  const download = async (path, { params, signal, onDownloadProgress, fallbackFileName = "descarga", timeoutMilliseconds = NO_TIMEOUT } = {}) => {
-    const response = await request("GET", path, { params, signal, parse: API_RESPONSE_PARSE.response, timeoutMilliseconds });
+  const download = async (path, {
+    method = "GET",
+    body,
+    params,
+    signal,
+    onDownloadProgress,
+    fallbackFileName = "descarga",
+    timeoutMilliseconds = NO_TIMEOUT
+  } = {}) => {
+    const response = await request(method, path, { body, params, signal, parse: API_RESPONSE_PARSE.response, timeoutMilliseconds });
     const blob = await readBlobWithProgress(response, onDownloadProgress);
     const fileName = fileNameFromContentDisposition(response.headers.get("content-disposition"), fallbackFileName);
     const contentType = String(response.headers.get("content-type") ?? "").split(";")[0].trim();
     if (contentType === XLSX_CONTENT_TYPE && !await isCompleteZip(blob)) {
       const requestId = response.headers.get("x-request-id");
-      log.error(`GET ${path} → el Excel llegó incompleto: el servidor falló a media escritura`, { requestId, fileName });
+      log.error(`${method} ${path} → el Excel llegó incompleto: el servidor falló a media escritura`, { requestId, fileName });
       throw new ApiError({ status: SERVER_ERROR_STATUS, problem: { request_id: requestId } });
     }
     return { blob, fileName };

package/dist/api/createApiClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"createApiClient.js","sources":["../../src/api/createApiClient.js"],"sourcesContent":["// La petición de la casa: TODO lo que habla con el servidor pasa por un cliente armado aquí, con fetch del navegador (sin\n// axios ni otra librería). Lo que resuelve UNA vez y no en cada pantalla:\n//   - Accept-Language con el idioma vigente de ToolkitProvider en CADA petición: el servidor responde title y detail ya\n//     traducidos. Cambiar el idioma aplica a la siguiente petición sin recargar.\n//   - errores como ApiError (ApiError.js): el problema RFC 9457 del servidor con el mensaje ya traducido; si la\n//     respuesta llegó en otro idioma (un error que armó nginx), el texto genérico del paquete. Sin red o se acabó el\n//     tiempo: un ApiError con status 0, la misma forma, para que la pantalla no tenga dos formas de error.\n//   - cancelar NO es un error: el AbortError se relanza intacto (quien canceló ya sabe por qué).\n//   - 401 (la sesión se venció a media consulta): avisa a onUnauthenticated, que normalmente lleva a iniciar sesión. Una\n//     petición que espera el 401 (preguntar si hay sesión al arrancar, el login) pasa skipUnauthenticatedHandler.\n//   - el aviso «Hay una versión nueva»: cada respuesta trae en un header qué compilación del front está publicada y se\n//     le entrega a reportPublishedBuild.\n//   - Laravel (Sanctum): con csrf, manda la cookie XSRF-TOKEN en su header (solo al mismo origen) y ante un 419 pide una\n//     cookie nueva y repite la petición UNA vez.\n//   - cuerpo objeto → JSON; FormData, Blob y URLSearchParams van tal cual (el navegador pone su boundary).\n//   - descargas: el Blob y el nombre que mandó el servidor, con avance; un Excel que llegó cortado (el servidor falló a\n//     media escritura después de responder 200) no se entrega.\n//   - eventos hacia afuera, para lo que cada proyecto haga a su manera: onRequest (sale), onResponse (llegó, con su status\n//     y cuánto tardó) y onError (CADA error en un solo lugar: Sentry, un aviso propio, una métrica). Cancelar no es error.\n//     Si un evento del proyecto truena, la petición sigue y se anota en el registro.\n//   - un backend que ya existe y contesta a su manera, sin cambiarlo: toProblem convierte su error a la forma RFC 9457\n//     (Laravel manda {message, errors}) y mapResponse desenvuelve sus respuestas buenas ({data: …}).\n//\n//   const api = createApiClient({baseUrl: '/api/v1', onUnauthenticated: () => navigate('/sign-in')});\n//   const orders = await api.get('/orders', {params: {page: 2}, signal});\n//   await api.post('/orders', {customerId: 7});\n//\n// Se arma uno por proyecto (en su core) y las pantallas lo usan desde su *Api.js.\n//\n// Funciones puras, no renderizan: function (regla de la casa).\nimport {ApiError, API_ERROR_STATUS} from '@/api/ApiError.js';\nimport {XLSX_CONTENT_TYPE, fileNameFromContentDisposition, isCompleteZip} from '@/files.js';\nimport {CSRF_TOKEN_MISMATCH_STATUS} from '@/laravel/csrfRetry.js';\nimport {createLogger} from '@/observability/logger.js';\nimport {reportPublishedBuild} from '@/observability/publishedBuild.js';\nimport {DEFAULT_LANGUAGE, toolkitSettings} from '@/toolkit/toolkitSettings.js';\n\nconst log = createLogger('api');\n\n/** Cómo se lee una respuesta que salió bien. */\nexport const API_RESPONSE_PARSE = Object.freeze({json: 'json', blob: 'blob', response: 'response'});\n\n// Las consultas se cortan a los 60 s; las descargas van sin límite (0): el servidor arma el archivo mientras lo manda y\n// uno grande no cabe en 60 s. No se queda colgada: se cancela desde el panel de descargas.\nconst DEFAULT_TIMEOUT_MILLISECONDS = 60_000;\nconst NO_TIMEOUT = 0;\nconst DEFAULT_PUBLISHED_BUILD_HEADER = 'X-Frontend-Build';\nconst NO_CONTENT_STATUS = 204;\nconst SERVER_ERROR_STATUS = 500;\n\n/**\n * La dirección completa: la base del cliente más el camino, con los parámetros. Un camino que ya trae http(s) va tal cual.\n * Los parámetros vacíos (undefined, null) no viajan; una lista viaja repetida (estado=a&estado=b).\n *\n * @param {string} baseUrl\n * @param {string} path\n * @param {Record<string, unknown>} [params]\n * @returns {string}\n */\nexport function apiUrlOf(baseUrl, path, params) {\n    const url = /^https?:/i.test(path) ? path : `${baseUrl}${path}`;\n    const query = new URLSearchParams();\n    for (const [name, value] of Object.entries(params ?? {})) {\n        for (const item of [].concat(value)) {\n            if (item !== undefined && item !== null) {\n                query.append(name, String(item));\n            }\n        }\n    }\n    const queryText = query.toString();\n    if (!queryText) {\n        return url;\n    }\n    return `${url}${url.includes('?') ? '&' : '?'}${queryText}`;\n}\n\n/**\n * ¿El cuerpo va tal cual? FormData (archivos), Blob y URLSearchParams los arma el navegador con su propio tipo.\n *\n * @param {unknown} body\n * @returns {boolean}\n */\nfunction isRawBody(body) {\n    return (typeof FormData !== 'undefined' && body instanceof FormData)\n        || (typeof Blob !== 'undefined' && body instanceof Blob)\n        || body instanceof URLSearchParams\n        || body instanceof ArrayBuffer;\n}\n\n/**\n * El valor de una cookie del navegador (la XSRF-TOKEN de Laravel), o null.\n *\n * @param {string} cookieName\n * @returns {string|null}\n */\nfunction readCookie(cookieName) {\n    if (typeof document === 'undefined') {\n        return null;\n    }\n    const prefix = `${cookieName}=`;\n    const cookie = document.cookie.split(';').map((part) => part.trim()).find((part) => part.startsWith(prefix));\n    return cookie ? decodeURIComponent(cookie.slice(prefix.length)) : null;\n}\n\n/**\n * ¿La dirección es del mismo origen que la página? El token CSRF solo viaja al servidor propio: mandarlo a otro dominio\n * se lo regalaría.\n *\n * @param {string} url\n * @returns {boolean}\n */\nfunction isSameOrigin(url) {\n    if (typeof window === 'undefined' || !/^https?:/i.test(url)) {\n        return true;\n    }\n    return new URL(url).origin === window.location.origin;\n}\n\n/**\n * Retry-After en segundos: el estándar admite segundos o una fecha HTTP.\n *\n * @param {string|null} retryAfterHeader\n * @returns {number|null}\n */\nexport function retryAfterSecondsOf(retryAfterHeader) {\n    if (!retryAfterHeader) {\n        return null;\n    }\n    if (/^\\d+$/.test(retryAfterHeader.trim())) {\n        return Number(retryAfterHeader.trim());\n    }\n    const retryAt = Date.parse(retryAfterHeader);\n    return Number.isNaN(retryAt) ? null : Math.max(0, Math.ceil((retryAt - Date.now()) / 1000));\n}\n\n/**\n * El cuerpo RFC 9457 de una respuesta de error, o null si no es JSON (un 502 del proxy en HTML).\n *\n * @param {Response} response\n * @returns {Promise<object|null>}\n */\n/**\n * El problema RFC 9457 del cuerpo de error, pasado por el adaptador del proyecto (toProblem). Lo que no sea un objeto\n * cuenta como sin problema (se usa el texto genérico del paquete).\n *\n * @param {(body: any, response: Response) => any} toProblem\n * @param {object|null} body\n * @param {Response} response\n * @returns {object|null}\n */\nfunction toProblemOrNull(toProblem, body, response) {\n    const problem = body === null ? null : toProblem(body, response);\n    return problem && typeof problem === 'object' && !Array.isArray(problem) ? problem : null;\n}\n\nasync function readProblem(response) {\n    try {\n        const body = JSON.parse(await response.text());\n        return body && typeof body === 'object' && !Array.isArray(body) ? body : null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * El ApiError de una respuesta que salió mal, para lo que no pasa por createApiClient: la subida con avance\n * (uploadWithProgress regresa la respuesta tal cual) o un fetch propio. Es el mismo error que da el cliente: el problema RFC\n * 9457 del servidor ({title, detail, errors}), su status (401 = sesión vencida, 422 = errores por campo) y el texto del\n * paquete si el cuerpo no es JSON (un 502 del proxy). Así la pantalla no lee el error a mano.\n *\n *   const response = await uploadWithProgress(url, form, {headers, onProgress, signal});\n *   if (!response.ok) throw await apiErrorOf(response);\n *\n * @param {Response} response\n * @param {{toProblem?: (body: any, response: Response) => any}} [options] el mismo adaptador de createApiClient, para un\n *     backend que contesta a su manera (Laravel manda {message, errors})\n * @returns {Promise<ApiError>}\n */\nexport async function apiErrorOf(response, {toProblem = (body) => body} = {}) {\n    const problem = toProblemOrNull(toProblem, await readProblem(response), response);\n    return new ApiError({status: response.status, problem, retryAfterSeconds: retryAfterSecondsOf(response.headers.get('retry-after'))});\n}\n\n/**\n * La señal de la petición: la de quien la pidió (para cancelar) y la del tiempo máximo, juntas.\n *\n * @param {AbortSignal|undefined} signal\n * @param {number} timeoutMilliseconds 0 = sin límite\n * @returns {AbortSignal|undefined}\n */\nfunction combinedSignalOf(signal, timeoutMilliseconds) {\n    const signals = [signal, timeoutMilliseconds > 0 ? AbortSignal.timeout(timeoutMilliseconds) : null].filter(Boolean);\n    if (signals.length < 2) {\n        return signals[0];\n    }\n    return AbortSignal.any(signals);\n}\n\n/**\n * Lee el cuerpo de una descarga avisando cuánto lleva. total viene en null cuando el servidor arma el archivo al vuelo\n * (sin Content-Length).\n *\n * @param {Response} response\n * @param {((progress: {loaded: number, total: number|null}) => void)|undefined} onDownloadProgress\n * @returns {Promise<Blob>}\n */\nasync function readBlobWithProgress(response, onDownloadProgress) {\n    if (!onDownloadProgress || !response.body) {\n        return response.blob();\n    }\n    const total = Number(response.headers.get('content-length')) || null;\n    const reader = response.body.getReader();\n    const chunks = [];\n    let loaded = 0;\n    for (let part = await reader.read(); !part.done; part = await reader.read()) {\n        chunks.push(part.value);\n        loaded += part.value.byteLength;\n        onDownloadProgress({loaded, total});\n    }\n    return new Blob(chunks, {type: response.headers.get('content-type') ?? ''});\n}\n\n/**\n * Lo que acepta cada petición.\n *\n * @typedef {object} ApiRequestOptions\n * @property {unknown} [body] objeto → JSON; FormData, Blob o URLSearchParams tal cual\n * @property {Record<string, unknown>} [params] los de la dirección (?page=2)\n * @property {AbortSignal} [signal] para cancelar\n * @property {Record<string, string>} [headers]\n * @property {'json'|'blob'|'response'} [parse] cómo se lee la respuesta (API_RESPONSE_PARSE); por omisión JSON\n * @property {boolean} [skipUnauthenticatedHandler] un 401 que se espera (¿hay sesión?, el login)\n * @property {number} [timeoutMilliseconds] el de esta petición\n */\n\n/**\n * Lo que acepta una descarga.\n *\n * @typedef {object} ApiDownloadOptions\n * @property {Record<string, unknown>} [params]\n * @property {AbortSignal} [signal]\n * @property {(progress: {loaded: number, total: number|null}) => void} [onDownloadProgress]\n * @property {string} [fallbackFileName] si el servidor no manda el nombre\n * @property {number} [timeoutMilliseconds] por omisión sin límite\n */\n\n/**\n * El cliente del proyecto: cada método regresa el JSON de la respuesta (null si vino vacía) o truena con un ApiError.\n *\n * @typedef {object} ApiClient\n * @property {(method: string, path: string, options?: ApiRequestOptions) => Promise<any>} request\n * @property {(path: string, options?: ApiRequestOptions) => Promise<any>} get\n * @property {(path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>} post\n * @property {(path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>} put\n * @property {(path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>} patch\n * @property {(path: string, options?: ApiRequestOptions) => Promise<any>} delete\n * @property {(path: string, options?: ApiDownloadOptions) => Promise<{blob: Blob, fileName: string}>} download\n */\n\n/**\n * Arma el cliente del proyecto.\n *\n * @param {object} [options]\n * @param {string} [options.baseUrl] lo que va antes de cada camino, p. ej. '/api/v1'\n * @param {RequestCredentials} [options.credentials] 'same-origin' (por omisión, la cookie de sesión del mismo dominio) o\n *     'include' (un API en otro dominio con cookies)\n * @param {() => string|null|undefined} [options.getToken] con él cada petición lleva Authorization: Bearer; sin token, va\n *     sin el header (el servidor responde 401)\n * @param {Record<string, string>} [options.headers] los que van en todas las peticiones\n * @param {string|null} [options.publishedBuildHeader] el header con la compilación publicada; null para no leerlo\n * @param {{cookieName?: string, headerName?: string, refreshPath?: string}|null} [options.csrf] Laravel Sanctum:\n *     {refreshPath: '/auth/csrf-token'}; por omisión la cookie XSRF-TOKEN y el header X-XSRF-TOKEN\n * @param {number} [options.timeoutMilliseconds] el tiempo máximo de una consulta (0 = sin límite); por omisión 60 s\n * @param {(error: ApiError) => void} [options.onUnauthenticated] qué hacer con un 401 (normalmente ir a iniciar sesión)\n * @param {(request: {method: string, url: string}) => void} [options.onRequest] cada petición, al salir\n * @param {(response: {method: string, url: string, status: number, durationMilliseconds: number}) => void} [options.onResponse]\n *     cada respuesta, buena o mala, al llegar\n * @param {(error: ApiError, request: {method: string, url: string}) => void} [options.onError] cada error (sin red, 4xx, 5xx,\n *     una respuesta que no es JSON), en un solo lugar: Sentry, un aviso propio. Cancelar no es error\n * @param {(body: any, response: Response) => object|null} [options.toProblem] el error de un backend que no contesta en\n *     RFC 9457, a esa forma: (body) => ({title: body.message, errors: body.errors}). Por omisión el cuerpo tal cual\n * @param {(body: any, request: {method: string, url: string}) => any} [options.mapResponse] la respuesta buena de un backend\n *     que la envuelve: (body) => body.data. Por omisión tal cual\n * @param {typeof fetch} [options.fetch] para un servidor de mentira o para las pruebas; por omisión el del navegador\n * @returns {ApiClient}\n */\nexport function createApiClient({\n    baseUrl = '',\n    credentials = 'same-origin',\n    getToken,\n    headers: commonHeaders = {},\n    publishedBuildHeader = DEFAULT_PUBLISHED_BUILD_HEADER,\n    csrf = null,\n    timeoutMilliseconds: defaultTimeoutMilliseconds = DEFAULT_TIMEOUT_MILLISECONDS,\n    onUnauthenticated,\n    onRequest,\n    onResponse,\n    onError,\n    toProblem = (body) => body,\n    mapResponse = (body) => body,\n    fetch: fetchImplementation,\n} = {}) {\n    // un evento del proyecto que truena no tumba la petición: se anota y se sigue (nunca en silencio)\n    const notify = (eventName, handler, ...eventArguments) => {\n        try {\n            handler?.(...eventArguments);\n        } catch (error) {\n            log.error(`el evento ${eventName} del proyecto tronó`, {message: error?.message});\n        }\n    };\n    // OJO: se lee al pedir, no al armar el cliente: así un servidor de mentira que se conecta después también sirve\n    const fetchOf = () => fetchImplementation ?? globalThis.fetch;\n    const csrfCookieName = csrf?.cookieName ?? 'XSRF-TOKEN';\n    const csrfHeaderName = csrf?.headerName ?? 'X-XSRF-TOKEN';\n\n    /** Los headers de una petición: los comunes, el idioma vigente, el token y el CSRF. */\n    const headersOf = (url, body, extraHeaders) => {\n        const headers = {\n            Accept: 'application/json',\n            'Accept-Language': toolkitSettings().language ?? DEFAULT_LANGUAGE,\n            ...commonHeaders,\n            ...extraHeaders,\n        };\n        if (body !== undefined && !isRawBody(body)) {\n            headers['Content-Type'] = 'application/json';\n        }\n        const token = getToken?.();\n        if (token) {\n            headers.Authorization = `Bearer ${token}`;\n        }\n        const csrfToken = csrf && isSameOrigin(url) ? readCookie(csrfCookieName) : null;\n        if (csrfToken) {\n            headers[csrfHeaderName] = csrfToken;\n        }\n        return headers;\n    };\n\n    /** La petición al servidor, ya con su respuesta o con el ApiError de «sin respuesta». */\n    const send = async (method, url, {body, signal, headers, timeoutMilliseconds}) => {\n        const finalHeaders = headersOf(url, body, headers);\n        try {\n            return await fetchOf()(url, {\n                method,\n                headers: finalHeaders,\n                body: body === undefined || isRawBody(body) ? body : JSON.stringify(body),\n                credentials,\n                signal: combinedSignalOf(signal, timeoutMilliseconds),\n            });\n        } catch (error) {\n            // cancelar no es un error de negocio: quien canceló ya sabe por qué\n            if (signal?.aborted) {\n                throw error;\n            }\n            const reason = error?.name === 'TimeoutError' ? 'se acabó el tiempo' : 'la petición no llegó al servidor';\n            log.error(reason, {method, url, cause: error?.name});\n            throw new ApiError({status: API_ERROR_STATUS.offline});\n        }\n    };\n\n    /**\n     * Cualquier petición.\n     *\n     * @param {string} method 'GET', 'POST', 'PUT', 'PATCH' o 'DELETE'\n     * @param {string} path relativo a baseUrl (o completo con http)\n     * @param {object} [options]\n     * @param {unknown} [options.body] objeto → JSON; FormData, Blob o URLSearchParams tal cual\n     * @param {Record<string, unknown>} [options.params] los de la dirección (?page=2)\n     * @param {AbortSignal} [options.signal] para cancelar\n     * @param {Record<string, string>} [options.headers]\n     * @param {'json'|'blob'|'response'} [options.parse] cómo se lee la respuesta (API_RESPONSE_PARSE); por omisión JSON\n     * @param {boolean} [options.skipUnauthenticatedHandler] un 401 que se espera (¿hay sesión?, el login)\n     * @param {number} [options.timeoutMilliseconds] el de esta petición\n     * @returns {Promise<any>} el JSON (null si vino vacío o 204), el Blob o la Response\n     */\n    const request = async (method, path, options = {}) => {\n        const url = apiUrlOf(baseUrl, path, options.params);\n        try {\n            return await requestOnce(method, url, options);\n        } catch (error) {\n            // cada error del servidor (o sin red) sale por onError; cancelar no es error\n            if (error instanceof ApiError) {\n                notify('onError', onError, error, {method, url});\n            }\n            throw error;\n        }\n    };\n\n    const requestOnce = async (method, url, {\n        body, signal, headers, parse = API_RESPONSE_PARSE.json, skipUnauthenticatedHandler = false,\n        timeoutMilliseconds = defaultTimeoutMilliseconds,\n    } = {}) => {\n        notify('onRequest', onRequest, {method, url});\n        const startedAt = Date.now();\n        let response = await send(method, url, {body, signal, headers, timeoutMilliseconds});\n\n        // 419 de Laravel: la cookie CSRF venció; se pide una nueva y se repite la MISMA petición una sola vez\n        if (response.status === CSRF_TOKEN_MISMATCH_STATUS && csrf?.refreshPath) {\n            log.info('token CSRF vencido: se renueva y se reintenta', {method, url});\n            await send('GET', apiUrlOf(baseUrl, csrf.refreshPath), {signal, timeoutMilliseconds});\n            response = await send(method, url, {body, signal, headers, timeoutMilliseconds});\n        }\n\n        notify('onResponse', onResponse, {method, url, status: response.status, durationMilliseconds: Date.now() - startedAt});\n\n        // cada respuesta (también las de error) dice qué compilación del front está publicada\n        if (publishedBuildHeader) {\n            reportPublishedBuild(response.headers.get(publishedBuildHeader));\n        }\n\n        if (!response.ok) {\n            const problem = toProblemOrNull(toProblem, await readProblem(response), response);\n            // un error que armó otro (nginx) puede llegar en otro idioma: ahí se usa el texto genérico del paquete\n            const requestedLanguage = headersOf(url, undefined, headers)['Accept-Language'];\n            const responseLanguage = response.headers.get('content-language');\n            const apiError = new ApiError({\n                status: response.status,\n                problem,\n                translatedByServer: !responseLanguage || responseLanguage.startsWith(requestedLanguage),\n                retryAfterSeconds: retryAfterSecondsOf(response.headers.get('retry-after')),\n            });\n            // los 4xx son parte del flujo (un 422 es un formulario, un 401 al arrancar es «sin sesión»); los 5xx no\n            log[response.status >= SERVER_ERROR_STATUS ? 'error' : 'debug'](`${method} ${url} → ${response.status}`, {\n                code: apiError.code, requestId: apiError.requestId ?? response.headers.get('x-request-id'),\n            });\n            if (apiError.isUnauthenticated && !skipUnauthenticatedHandler) {\n                onUnauthenticated?.(apiError);\n            }\n            throw apiError;\n        }\n\n        if (parse === API_RESPONSE_PARSE.response) {\n            return response;\n        }\n        if (parse === API_RESPONSE_PARSE.blob) {\n            return response.blob();\n        }\n        if (response.status === NO_CONTENT_STATUS) {\n            return null;\n        }\n        // un 200 con el cuerpo vacío pasa de verdad; JSON.parse('') tronaría\n        const text = await response.text();\n        if (!text) {\n            return null;\n        }\n        let json;\n        try {\n            json = JSON.parse(text);\n        } catch {\n            // un 200 que no es JSON: casi siempre la página de la app que respondió en lugar del API (el camino está mal)\n            log.error(`${method} ${url} respondió algo que no es JSON`, {contentType: response.headers.get('content-type')});\n            throw new ApiError({status: SERVER_ERROR_STATUS});\n        }\n        return mapResponse(json, {method, url});\n    };\n\n    /**\n     * Descarga un archivo: el Blob y el nombre que mandó el servidor, con avance. Un Excel cortado no se entrega.\n     *\n     * @param {string} path\n     * @param {object} [options]\n     * @param {Record<string, unknown>} [options.params]\n     * @param {AbortSignal} [options.signal]\n     * @param {(progress: {loaded: number, total: number|null}) => void} [options.onDownloadProgress]\n     * @param {string} [options.fallbackFileName] si el servidor no manda el nombre\n     * @param {number} [options.timeoutMilliseconds] por omisión sin límite\n     * @returns {Promise<{blob: Blob, fileName: string}>}\n     * @throws {ApiError} status 500 si un Excel llegó incompleto\n     */\n    const download = async (path, {params, signal, onDownloadProgress, fallbackFileName = 'descarga', timeoutMilliseconds = NO_TIMEOUT} = {}) => {\n        const response = await request('GET', path, {params, signal, parse: API_RESPONSE_PARSE.response, timeoutMilliseconds});\n        const blob = await readBlobWithProgress(response, onDownloadProgress);\n        const fileName = fileNameFromContentDisposition(response.headers.get('content-disposition'), fallbackFileName);\n        // el tipo puede traer parámetros después del «;» (charset): solo cuenta lo de antes\n        const contentType = String(response.headers.get('content-type') ?? '').split(';')[0].trim();\n        if (contentType === XLSX_CONTENT_TYPE && !(await isCompleteZip(blob))) {\n            const requestId = response.headers.get('x-request-id');\n            log.error(`GET ${path} → el Excel llegó incompleto: el servidor falló a media escritura`, {requestId, fileName});\n            throw new ApiError({status: SERVER_ERROR_STATUS, problem: {request_id: requestId}});\n        }\n        return {blob, fileName};\n    };\n\n    return {\n        request,\n        get: (path, options) => request('GET', path, options),\n        post: (path, body, options) => request('POST', path, {...options, body}),\n        put: (path, body, options) => request('PUT', path, {...options, body}),\n        patch: (path, body, options) => request('PATCH', path, {...options, body}),\n        delete: (path, options) => request('DELETE', path, options),\n        download,\n    };\n}\n"],"names":[],"mappings":";;;;;;AAqCA,MAAM,MAAM,aAAa,KAAK;AAGlB,MAAC,qBAAqB,OAAO,OAAO,EAAC,MAAM,QAAQ,MAAM,QAAQ,UAAU,WAAU,CAAC;AAIlG,MAAM,+BAA+B;AACrC,MAAM,aAAa;AACnB,MAAM,iCAAiC;AACvC,MAAM,oBAAoB;AAC1B,MAAM,sBAAsB;AAWrB,SAAS,SAAS,SAAS,MAAM,QAAQ;AAC5C,QAAM,MAAM,YAAY,KAAK,IAAI,IAAI,OAAO,GAAG,OAAO,GAAG,IAAI;AAC7D,QAAM,QAAQ,IAAI,gBAAe;AACjC,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,UAAU,CAAA,CAAE,GAAG;AACtD,eAAW,QAAQ,CAAA,EAAG,OAAO,KAAK,GAAG;AACjC,UAAI,SAAS,UAAa,SAAS,MAAM;AACrC,cAAM,OAAO,MAAM,OAAO,IAAI,CAAC;AAAA,MACnC;AAAA,IACJ;AAAA,EACJ;AACA,QAAM,YAAY,MAAM,SAAQ;AAChC,MAAI,CAAC,WAAW;AACZ,WAAO;AAAA,EACX;AACA,SAAO,GAAG,GAAG,GAAG,IAAI,SAAS,GAAG,IAAI,MAAM,GAAG,GAAG,SAAS;AAC7D;AAQA,SAAS,UAAU,MAAM;AACrB,SAAQ,OAAO,aAAa,eAAe,gBAAgB,YACnD,OAAO,SAAS,eAAe,gBAAgB,QAChD,gBAAgB,mBAChB,gBAAgB;AAC3B;AAQA,SAAS,WAAW,YAAY;AAC5B,MAAI,OAAO,aAAa,aAAa;AACjC,WAAO;AAAA,EACX;AACA,QAAM,SAAS,GAAG,UAAU;AAC5B,QAAM,SAAS,SAAS,OAAO,MAAM,GAAG,EAAE,IAAI,CAAC,SAAS,KAAK,KAAI,CAAE,EAAE,KAAK,CAAC,SAAS,KAAK,WAAW,MAAM,CAAC;AAC3G,SAAO,SAAS,mBAAmB,OAAO,MAAM,OAAO,MAAM,CAAC,IAAI;AACtE;AASA,SAAS,aAAa,KAAK;AACvB,MAAI,OAAO,WAAW,eAAe,CAAC,YAAY,KAAK,GAAG,GAAG;AACzD,WAAO;AAAA,EACX;AACA,SAAO,IAAI,IAAI,GAAG,EAAE,WAAW,OAAO,SAAS;AACnD;AAQO,SAAS,oBAAoB,kBAAkB;AAClD,MAAI,CAAC,kBAAkB;AACnB,WAAO;AAAA,EACX;AACA,MAAI,QAAQ,KAAK,iBAAiB,KAAI,CAAE,GAAG;AACvC,WAAO,OAAO,iBAAiB,MAAM;AAAA,EACzC;AACA,QAAM,UAAU,KAAK,MAAM,gBAAgB;AAC3C,SAAO,OAAO,MAAM,OAAO,IAAI,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,UAAU,KAAK,IAAG,KAAM,GAAI,CAAC;AAC9F;AAiBA,SAAS,gBAAgB,WAAW,MAAM,UAAU;AAChD,QAAM,UAAU,SAAS,OAAO,OAAO,UAAU,MAAM,QAAQ;AAC/D,SAAO,WAAW,OAAO,YAAY,YAAY,CAAC,MAAM,QAAQ,OAAO,IAAI,UAAU;AACzF;AAEA,eAAe,YAAY,UAAU;AACjC,MAAI;AACA,UAAM,OAAO,KAAK,MAAM,MAAM,SAAS,KAAI,CAAE;AAC7C,WAAO,QAAQ,OAAO,SAAS,YAAY,CAAC,MAAM,QAAQ,IAAI,IAAI,OAAO;AAAA,EAC7E,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;AAgBO,eAAe,WAAW,UAAU,EAAC,YAAY,CAAC,SAAS,KAAI,IAAI,IAAI;AAC1E,QAAM,UAAU,gBAAgB,WAAW,MAAM,YAAY,QAAQ,GAAG,QAAQ;AAChF,SAAO,IAAI,SAAS,EAAC,QAAQ,SAAS,QAAQ,SAAS,mBAAmB,oBAAoB,SAAS,QAAQ,IAAI,aAAa,CAAC,EAAC,CAAC;AACvI;AASA,SAAS,iBAAiB,QAAQ,qBAAqB;AACnD,QAAM,UAAU,CAAC,QAAQ,sBAAsB,IAAI,YAAY,QAAQ,mBAAmB,IAAI,IAAI,EAAE,OAAO,OAAO;AAClH,MAAI,QAAQ,SAAS,GAAG;AACpB,WAAO,QAAQ,CAAC;AAAA,EACpB;AACA,SAAO,YAAY,IAAI,OAAO;AAClC;AAUA,eAAe,qBAAqB,UAAU,oBAAoB;AAC9D,MAAI,CAAC,sBAAsB,CAAC,SAAS,MAAM;AACvC,WAAO,SAAS,KAAI;AAAA,EACxB;AACA,QAAM,QAAQ,OAAO,SAAS,QAAQ,IAAI,gBAAgB,CAAC,KAAK;AAChE,QAAM,SAAS,SAAS,KAAK,UAAS;AACtC,QAAM,SAAS,CAAA;AACf,MAAI,SAAS;AACb,WAAS,OAAO,MAAM,OAAO,KAAI,GAAI,CAAC,KAAK,MAAM,OAAO,MAAM,OAAO,KAAI,GAAI;AACzE,WAAO,KAAK,KAAK,KAAK;AACtB,cAAU,KAAK,MAAM;AACrB,uBAAmB,EAAC,QAAQ,MAAK,CAAC;AAAA,EACtC;AACA,SAAO,IAAI,KAAK,QAAQ,EAAC,MAAM,SAAS,QAAQ,IAAI,cAAc,KAAK,GAAE,CAAC;AAC9E;AAkEO,SAAS,gBAAgB;AAAA,EAC5B,UAAU;AAAA,EACV,cAAc;AAAA,EACd;AAAA,EACA,SAAS,gBAAgB,CAAA;AAAA,EACzB,uBAAuB;AAAA,EACvB,OAAO;AAAA,EACP,qBAAqB,6BAA6B;AAAA,EAClD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY,CAAC,SAAS;AAAA,EACtB,cAAc,CAAC,SAAS;AAAA,EACxB,OAAO;AACX,IAAI,IAAI;AAEJ,QAAM,SAAS,CAAC,WAAW,YAAY,mBAAmB;AACtD,QAAI;AACA,gBAAU,GAAG,cAAc;AAAA,IAC/B,SAAS,OAAO;AACZ,UAAI,MAAM,aAAa,SAAS,uBAAuB,EAAC,SAAS,OAAO,QAAO,CAAC;AAAA,IACpF;AAAA,EACJ;AAEA,QAAM,UAAU,MAAM,uBAAuB,WAAW;AACxD,QAAM,iBAAiB,MAAM,cAAc;AAC3C,QAAM,iBAAiB,MAAM,cAAc;AAG3C,QAAM,YAAY,CAAC,KAAK,MAAM,iBAAiB;AAC3C,UAAM,UAAU;AAAA,MACZ,QAAQ;AAAA,MACR,mBAAmB,kBAAkB,YAAY;AAAA,MACjD,GAAG;AAAA,MACH,GAAG;AAAA,IACf;AACQ,QAAI,SAAS,UAAa,CAAC,UAAU,IAAI,GAAG;AACxC,cAAQ,cAAc,IAAI;AAAA,IAC9B;AACA,UAAM,QAAQ,WAAQ;AACtB,QAAI,OAAO;AACP,cAAQ,gBAAgB,UAAU,KAAK;AAAA,IAC3C;AACA,UAAM,YAAY,QAAQ,aAAa,GAAG,IAAI,WAAW,cAAc,IAAI;AAC3E,QAAI,WAAW;AACX,cAAQ,cAAc,IAAI;AAAA,IAC9B;AACA,WAAO;AAAA,EACX;AAGA,QAAM,OAAO,OAAO,QAAQ,KAAK,EAAC,MAAM,QAAQ,SAAS,oBAAmB,MAAM;AAC9E,UAAM,eAAe,UAAU,KAAK,MAAM,OAAO;AACjD,QAAI;AACA,aAAO,MAAM,QAAO,EAAG,KAAK;AAAA,QACxB;AAAA,QACA,SAAS;AAAA,QACT,MAAM,SAAS,UAAa,UAAU,IAAI,IAAI,OAAO,KAAK,UAAU,IAAI;AAAA,QACxE;AAAA,QACA,QAAQ,iBAAiB,QAAQ,mBAAmB;AAAA,MACpE,CAAa;AAAA,IACL,SAAS,OAAO;AAEZ,UAAI,QAAQ,SAAS;AACjB,cAAM;AAAA,MACV;AACA,YAAM,SAAS,OAAO,SAAS,iBAAiB,uBAAuB;AACvE,UAAI,MAAM,QAAQ,EAAC,QAAQ,KAAK,OAAO,OAAO,KAAI,CAAC;AACnD,YAAM,IAAI,SAAS,EAAC,QAAQ,iBAAiB,QAAO,CAAC;AAAA,IACzD;AAAA,EACJ;AAiBA,QAAM,UAAU,OAAO,QAAQ,MAAM,UAAU,CAAA,MAAO;AAClD,UAAM,MAAM,SAAS,SAAS,MAAM,QAAQ,MAAM;AAClD,QAAI;AACA,aAAO,MAAM,YAAY,QAAQ,KAAK,OAAO;AAAA,IACjD,SAAS,OAAO;AAEZ,UAAI,iBAAiB,UAAU;AAC3B,eAAO,WAAW,SAAS,OAAO,EAAC,QAAQ,IAAG,CAAC;AAAA,MACnD;AACA,YAAM;AAAA,IACV;AAAA,EACJ;AAEA,QAAM,cAAc,OAAO,QAAQ,KAAK;AAAA,IACpC;AAAA,IAAM;AAAA,IAAQ;AAAA,IAAS,QAAQ,mBAAmB;AAAA,IAAM,6BAA6B;AAAA,IACrF,sBAAsB;AAAA,EAC9B,IAAQ,OAAO;AACP,WAAO,aAAa,WAAW,EAAC,QAAQ,IAAG,CAAC;AAC5C,UAAM,YAAY,KAAK,IAAG;AAC1B,QAAI,WAAW,MAAM,KAAK,QAAQ,KAAK,EAAC,MAAM,QAAQ,SAAS,oBAAmB,CAAC;AAGnF,QAAI,SAAS,WAAW,8BAA8B,MAAM,aAAa;AACrE,UAAI,KAAK,iDAAiD,EAAC,QAAQ,IAAG,CAAC;AACvE,YAAM,KAAK,OAAO,SAAS,SAAS,KAAK,WAAW,GAAG,EAAC,QAAQ,oBAAmB,CAAC;AACpF,iBAAW,MAAM,KAAK,QAAQ,KAAK,EAAC,MAAM,QAAQ,SAAS,oBAAmB,CAAC;AAAA,IACnF;AAEA,WAAO,cAAc,YAAY,EAAC,QAAQ,KAAK,QAAQ,SAAS,QAAQ,sBAAsB,KAAK,IAAG,IAAK,UAAS,CAAC;AAGrH,QAAI,sBAAsB;AACtB,2BAAqB,SAAS,QAAQ,IAAI,oBAAoB,CAAC;AAAA,IACnE;AAEA,QAAI,CAAC,SAAS,IAAI;AACd,YAAM,UAAU,gBAAgB,WAAW,MAAM,YAAY,QAAQ,GAAG,QAAQ;AAEhF,YAAM,oBAAoB,UAAU,KAAK,QAAW,OAAO,EAAE,iBAAiB;AAC9E,YAAM,mBAAmB,SAAS,QAAQ,IAAI,kBAAkB;AAChE,YAAM,WAAW,IAAI,SAAS;AAAA,QAC1B,QAAQ,SAAS;AAAA,QACjB;AAAA,QACA,oBAAoB,CAAC,oBAAoB,iBAAiB,WAAW,iBAAiB;AAAA,QACtF,mBAAmB,oBAAoB,SAAS,QAAQ,IAAI,aAAa,CAAC;AAAA,MAC1F,CAAa;AAED,UAAI,SAAS,UAAU,sBAAsB,UAAU,OAAO,EAAE,GAAG,MAAM,IAAI,GAAG,MAAM,SAAS,MAAM,IAAI;AAAA,QACrG,MAAM,SAAS;AAAA,QAAM,WAAW,SAAS,aAAa,SAAS,QAAQ,IAAI,cAAc;AAAA,MACzG,CAAa;AACD,UAAI,SAAS,qBAAqB,CAAC,4BAA4B;AAC3D,4BAAoB,QAAQ;AAAA,MAChC;AACA,YAAM;AAAA,IACV;AAEA,QAAI,UAAU,mBAAmB,UAAU;AACvC,aAAO;AAAA,IACX;AACA,QAAI,UAAU,mBAAmB,MAAM;AACnC,aAAO,SAAS,KAAI;AAAA,IACxB;AACA,QAAI,SAAS,WAAW,mBAAmB;AACvC,aAAO;AAAA,IACX;AAEA,UAAM,OAAO,MAAM,SAAS,KAAI;AAChC,QAAI,CAAC,MAAM;AACP,aAAO;AAAA,IACX;AACA,QAAI;AACJ,QAAI;AACA,aAAO,KAAK,MAAM,IAAI;AAAA,IAC1B,QAAQ;AAEJ,UAAI,MAAM,GAAG,MAAM,IAAI,GAAG,kCAAkC,EAAC,aAAa,SAAS,QAAQ,IAAI,cAAc,EAAC,CAAC;AAC/G,YAAM,IAAI,SAAS,EAAC,QAAQ,oBAAmB,CAAC;AAAA,IACpD;AACA,WAAO,YAAY,MAAM,EAAC,QAAQ,IAAG,CAAC;AAAA,EAC1C;AAeA,QAAM,WAAW,OAAO,MAAM,EAAC,QAAQ,QAAQ,oBAAoB,mBAAmB,YAAY,sBAAsB,WAAU,IAAI,CAAA,MAAO;AACzI,UAAM,WAAW,MAAM,QAAQ,OAAO,MAAM,EAAC,QAAQ,QAAQ,OAAO,mBAAmB,UAAU,oBAAmB,CAAC;AACrH,UAAM,OAAO,MAAM,qBAAqB,UAAU,kBAAkB;AACpE,UAAM,WAAW,+BAA+B,SAAS,QAAQ,IAAI,qBAAqB,GAAG,gBAAgB;AAE7G,UAAM,cAAc,OAAO,SAAS,QAAQ,IAAI,cAAc,KAAK,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC,EAAE,KAAI;AACzF,QAAI,gBAAgB,qBAAqB,CAAE,MAAM,cAAc,IAAI,GAAI;AACnE,YAAM,YAAY,SAAS,QAAQ,IAAI,cAAc;AACrD,UAAI,MAAM,OAAO,IAAI,qEAAqE,EAAC,WAAW,SAAQ,CAAC;AAC/G,YAAM,IAAI,SAAS,EAAC,QAAQ,qBAAqB,SAAS,EAAC,YAAY,UAAS,EAAC,CAAC;AAAA,IACtF;AACA,WAAO,EAAC,MAAM,SAAQ;AAAA,EAC1B;AAEA,SAAO;AAAA,IACH;AAAA,IACA,KAAK,CAAC,MAAM,YAAY,QAAQ,OAAO,MAAM,OAAO;AAAA,IACpD,MAAM,CAAC,MAAM,MAAM,YAAY,QAAQ,QAAQ,MAAM,EAAC,GAAG,SAAS,KAAI,CAAC;AAAA,IACvE,KAAK,CAAC,MAAM,MAAM,YAAY,QAAQ,OAAO,MAAM,EAAC,GAAG,SAAS,KAAI,CAAC;AAAA,IACrE,OAAO,CAAC,MAAM,MAAM,YAAY,QAAQ,SAAS,MAAM,EAAC,GAAG,SAAS,KAAI,CAAC;AAAA,IACzE,QAAQ,CAAC,MAAM,YAAY,QAAQ,UAAU,MAAM,OAAO;AAAA,IAC1D;AAAA,EACR;AACA;"}
+{"version":3,"file":"createApiClient.js","sources":["../../src/api/createApiClient.js"],"sourcesContent":["// La petición de la casa: TODO lo que habla con el servidor pasa por un cliente armado aquí, con fetch del navegador (sin\n// axios ni otra librería). Lo que resuelve UNA vez y no en cada pantalla:\n//   - Accept-Language con el idioma vigente de ToolkitProvider en CADA petición: el servidor responde title y detail ya\n//     traducidos. Cambiar el idioma aplica a la siguiente petición sin recargar.\n//   - errores como ApiError (ApiError.js): el problema RFC 9457 del servidor con el mensaje ya traducido; si la\n//     respuesta llegó en otro idioma (un error que armó nginx), el texto genérico del paquete. Sin red o se acabó el\n//     tiempo: un ApiError con status 0, la misma forma, para que la pantalla no tenga dos formas de error.\n//   - cancelar NO es un error: el AbortError se relanza intacto (quien canceló ya sabe por qué).\n//   - 401 (la sesión se venció a media consulta): avisa a onUnauthenticated, que normalmente lleva a iniciar sesión. Una\n//     petición que espera el 401 (preguntar si hay sesión al arrancar, el login) pasa skipUnauthenticatedHandler.\n//   - el aviso «Hay una versión nueva»: cada respuesta trae en un header qué compilación del front está publicada y se\n//     le entrega a reportPublishedBuild.\n//   - Laravel (Sanctum): con csrf, manda la cookie XSRF-TOKEN en su header (solo al mismo origen) y ante un 419 pide una\n//     cookie nueva y repite la petición UNA vez.\n//   - cuerpo objeto → JSON; FormData, Blob y URLSearchParams van tal cual (el navegador pone su boundary).\n//   - descargas: el Blob y el nombre que mandó el servidor, con avance; un Excel que llegó cortado (el servidor falló a\n//     media escritura después de responder 200) no se entrega.\n//   - eventos hacia afuera, para lo que cada proyecto haga a su manera: onRequest (sale), onResponse (llegó, con su status\n//     y cuánto tardó) y onError (CADA error en un solo lugar: Sentry, un aviso propio, una métrica). Cancelar no es error.\n//     Si un evento del proyecto truena, la petición sigue y se anota en el registro.\n//   - un backend que ya existe y contesta a su manera, sin cambiarlo: toProblem convierte su error a la forma RFC 9457\n//     (Laravel manda {message, errors}) y mapResponse desenvuelve sus respuestas buenas ({data: …}).\n//\n//   const api = createApiClient({baseUrl: '/api/v1', onUnauthenticated: () => navigate('/sign-in')});\n//   const orders = await api.get('/orders', {params: {page: 2}, signal});\n//   await api.post('/orders', {customerId: 7});\n//\n// Se arma uno por proyecto (en su core) y las pantallas lo usan desde su *Api.js.\n//\n// Funciones puras, no renderizan: function (regla de la casa).\nimport {ApiError, API_ERROR_STATUS} from '@/api/ApiError.js';\nimport {XLSX_CONTENT_TYPE, fileNameFromContentDisposition, isCompleteZip} from '@/files.js';\nimport {CSRF_TOKEN_MISMATCH_STATUS} from '@/laravel/csrfRetry.js';\nimport {createLogger} from '@/observability/logger.js';\nimport {reportPublishedBuild} from '@/observability/publishedBuild.js';\nimport {DEFAULT_LANGUAGE, toolkitSettings} from '@/toolkit/toolkitSettings.js';\n\nconst log = createLogger('api');\n\n/** Cómo se lee una respuesta que salió bien. */\nexport const API_RESPONSE_PARSE = Object.freeze({json: 'json', blob: 'blob', response: 'response'});\n\n// Las consultas se cortan a los 60 s; las descargas van sin límite (0): el servidor arma el archivo mientras lo manda y\n// uno grande no cabe en 60 s. No se queda colgada: se cancela desde el panel de descargas.\nconst DEFAULT_TIMEOUT_MILLISECONDS = 60_000;\nconst NO_TIMEOUT = 0;\nconst DEFAULT_PUBLISHED_BUILD_HEADER = 'X-Frontend-Build';\nconst NO_CONTENT_STATUS = 204;\nconst SERVER_ERROR_STATUS = 500;\n\n/**\n * La dirección completa: la base del cliente más el camino, con los parámetros. Un camino que ya trae http(s) va tal cual.\n * Los parámetros vacíos (undefined, null) no viajan; una lista viaja repetida (estado=a&estado=b).\n *\n * @param {string} baseUrl\n * @param {string} path\n * @param {Record<string, unknown>} [params]\n * @returns {string}\n */\nexport function apiUrlOf(baseUrl, path, params) {\n    const url = /^https?:/i.test(path) ? path : `${baseUrl}${path}`;\n    const query = new URLSearchParams();\n    for (const [name, value] of Object.entries(params ?? {})) {\n        for (const item of [].concat(value)) {\n            if (item !== undefined && item !== null) {\n                query.append(name, String(item));\n            }\n        }\n    }\n    const queryText = query.toString();\n    if (!queryText) {\n        return url;\n    }\n    return `${url}${url.includes('?') ? '&' : '?'}${queryText}`;\n}\n\n/**\n * ¿El cuerpo va tal cual? FormData (archivos), Blob y URLSearchParams los arma el navegador con su propio tipo.\n *\n * @param {unknown} body\n * @returns {boolean}\n */\nfunction isRawBody(body) {\n    return (typeof FormData !== 'undefined' && body instanceof FormData)\n        || (typeof Blob !== 'undefined' && body instanceof Blob)\n        || body instanceof URLSearchParams\n        || body instanceof ArrayBuffer;\n}\n\n/**\n * El valor de una cookie del navegador (la XSRF-TOKEN de Laravel), o null.\n *\n * @param {string} cookieName\n * @returns {string|null}\n */\nfunction readCookie(cookieName) {\n    if (typeof document === 'undefined') {\n        return null;\n    }\n    const prefix = `${cookieName}=`;\n    const cookie = document.cookie.split(';').map((part) => part.trim()).find((part) => part.startsWith(prefix));\n    return cookie ? decodeURIComponent(cookie.slice(prefix.length)) : null;\n}\n\n/**\n * ¿La dirección es del mismo origen que la página? El token CSRF solo viaja al servidor propio: mandarlo a otro dominio\n * se lo regalaría.\n *\n * @param {string} url\n * @returns {boolean}\n */\nfunction isSameOrigin(url) {\n    if (typeof window === 'undefined' || !/^https?:/i.test(url)) {\n        return true;\n    }\n    return new URL(url).origin === window.location.origin;\n}\n\n/**\n * Retry-After en segundos: el estándar admite segundos o una fecha HTTP.\n *\n * @param {string|null} retryAfterHeader\n * @returns {number|null}\n */\nexport function retryAfterSecondsOf(retryAfterHeader) {\n    if (!retryAfterHeader) {\n        return null;\n    }\n    if (/^\\d+$/.test(retryAfterHeader.trim())) {\n        return Number(retryAfterHeader.trim());\n    }\n    const retryAt = Date.parse(retryAfterHeader);\n    return Number.isNaN(retryAt) ? null : Math.max(0, Math.ceil((retryAt - Date.now()) / 1000));\n}\n\n/**\n * El cuerpo RFC 9457 de una respuesta de error, o null si no es JSON (un 502 del proxy en HTML).\n *\n * @param {Response} response\n * @returns {Promise<object|null>}\n */\n/**\n * El problema RFC 9457 del cuerpo de error, pasado por el adaptador del proyecto (toProblem). Lo que no sea un objeto\n * cuenta como sin problema (se usa el texto genérico del paquete).\n *\n * @param {(body: any, response: Response) => any} toProblem\n * @param {object|null} body\n * @param {Response} response\n * @returns {object|null}\n */\nfunction toProblemOrNull(toProblem, body, response) {\n    const problem = body === null ? null : toProblem(body, response);\n    return problem && typeof problem === 'object' && !Array.isArray(problem) ? problem : null;\n}\n\nasync function readProblem(response) {\n    try {\n        const body = JSON.parse(await response.text());\n        return body && typeof body === 'object' && !Array.isArray(body) ? body : null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * El ApiError de una respuesta que salió mal, para lo que no pasa por createApiClient: la subida con avance\n * (uploadWithProgress regresa la respuesta tal cual) o un fetch propio. Es el mismo error que da el cliente: el problema RFC\n * 9457 del servidor ({title, detail, errors}), su status (401 = sesión vencida, 422 = errores por campo) y el texto del\n * paquete si el cuerpo no es JSON (un 502 del proxy). Así la pantalla no lee el error a mano.\n *\n *   const response = await uploadWithProgress(url, form, {headers, onProgress, signal});\n *   if (!response.ok) throw await apiErrorOf(response);\n *\n * @param {Response} response\n * @param {{toProblem?: (body: any, response: Response) => any}} [options] el mismo adaptador de createApiClient, para un\n *     backend que contesta a su manera (Laravel manda {message, errors})\n * @returns {Promise<ApiError>}\n */\nexport async function apiErrorOf(response, {toProblem = (body) => body} = {}) {\n    const problem = toProblemOrNull(toProblem, await readProblem(response), response);\n    return new ApiError({status: response.status, problem, retryAfterSeconds: retryAfterSecondsOf(response.headers.get('retry-after'))});\n}\n\n/**\n * La señal de la petición: la de quien la pidió (para cancelar) y la del tiempo máximo, juntas.\n *\n * @param {AbortSignal|undefined} signal\n * @param {number} timeoutMilliseconds 0 = sin límite\n * @returns {AbortSignal|undefined}\n */\nfunction combinedSignalOf(signal, timeoutMilliseconds) {\n    const signals = [signal, timeoutMilliseconds > 0 ? AbortSignal.timeout(timeoutMilliseconds) : null].filter(Boolean);\n    if (signals.length < 2) {\n        return signals[0];\n    }\n    return AbortSignal.any(signals);\n}\n\n/**\n * Lee el cuerpo de una descarga avisando cuánto lleva. total viene en null cuando el servidor arma el archivo al vuelo\n * (sin Content-Length).\n *\n * @param {Response} response\n * @param {((progress: {loaded: number, total: number|null}) => void)|undefined} onDownloadProgress\n * @returns {Promise<Blob>}\n */\nasync function readBlobWithProgress(response, onDownloadProgress) {\n    if (!onDownloadProgress || !response.body) {\n        return response.blob();\n    }\n    const total = Number(response.headers.get('content-length')) || null;\n    const reader = response.body.getReader();\n    const chunks = [];\n    let loaded = 0;\n    for (let part = await reader.read(); !part.done; part = await reader.read()) {\n        chunks.push(part.value);\n        loaded += part.value.byteLength;\n        onDownloadProgress({loaded, total});\n    }\n    return new Blob(chunks, {type: response.headers.get('content-type') ?? ''});\n}\n\n/**\n * Lo que acepta cada petición.\n *\n * @typedef {object} ApiRequestOptions\n * @property {unknown} [body] objeto → JSON; FormData, Blob o URLSearchParams tal cual\n * @property {Record<string, unknown>} [params] los de la dirección (?page=2)\n * @property {AbortSignal} [signal] para cancelar\n * @property {Record<string, string>} [headers]\n * @property {'json'|'blob'|'response'} [parse] cómo se lee la respuesta (API_RESPONSE_PARSE); por omisión JSON\n * @property {boolean} [skipUnauthenticatedHandler] un 401 que se espera (¿hay sesión?, el login)\n * @property {number} [timeoutMilliseconds] el de esta petición\n */\n\n/**\n * Lo que acepta una descarga.\n *\n * @typedef {object} ApiDownloadOptions\n * @property {string} [method] por omisión 'GET'; 'POST' para un archivo que se arma con lo que va en `body`\n * @property {unknown} [body] lo que va en la petición, como en post: objeto → JSON; FormData, Blob o URLSearchParams tal cual\n * @property {Record<string, unknown>} [params]\n * @property {AbortSignal} [signal]\n * @property {(progress: {loaded: number, total: number|null}) => void} [onDownloadProgress]\n * @property {string} [fallbackFileName] si el servidor no manda el nombre\n * @property {number} [timeoutMilliseconds] por omisión sin límite\n */\n\n/**\n * El cliente del proyecto: cada método regresa el JSON de la respuesta (null si vino vacía) o truena con un ApiError.\n *\n * @typedef {object} ApiClient\n * @property {(method: string, path: string, options?: ApiRequestOptions) => Promise<any>} request\n * @property {(path: string, options?: ApiRequestOptions) => Promise<any>} get\n * @property {(path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>} post\n * @property {(path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>} put\n * @property {(path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>} patch\n * @property {(path: string, options?: ApiRequestOptions) => Promise<any>} delete\n * @property {(path: string, options?: ApiDownloadOptions) => Promise<{blob: Blob, fileName: string}>} download\n */\n\n/**\n * Arma el cliente del proyecto.\n *\n * @param {object} [options]\n * @param {string} [options.baseUrl] lo que va antes de cada camino, p. ej. '/api/v1'\n * @param {RequestCredentials} [options.credentials] 'same-origin' (por omisión, la cookie de sesión del mismo dominio) o\n *     'include' (un API en otro dominio con cookies)\n * @param {() => string|null|undefined} [options.getToken] con él cada petición lleva Authorization: Bearer; sin token, va\n *     sin el header (el servidor responde 401)\n * @param {Record<string, string>} [options.headers] los que van en todas las peticiones\n * @param {string|null} [options.publishedBuildHeader] el header con la compilación publicada; null para no leerlo\n * @param {{cookieName?: string, headerName?: string, refreshPath?: string}|null} [options.csrf] Laravel Sanctum:\n *     {refreshPath: '/auth/csrf-token'}; por omisión la cookie XSRF-TOKEN y el header X-XSRF-TOKEN\n * @param {number} [options.timeoutMilliseconds] el tiempo máximo de una consulta (0 = sin límite); por omisión 60 s\n * @param {(error: ApiError) => void} [options.onUnauthenticated] qué hacer con un 401 (normalmente ir a iniciar sesión)\n * @param {(request: {method: string, url: string}) => void} [options.onRequest] cada petición, al salir\n * @param {(response: {method: string, url: string, status: number, durationMilliseconds: number}) => void} [options.onResponse]\n *     cada respuesta, buena o mala, al llegar\n * @param {(error: ApiError, request: {method: string, url: string}) => void} [options.onError] cada error (sin red, 4xx, 5xx,\n *     una respuesta que no es JSON), en un solo lugar: Sentry, un aviso propio. Cancelar no es error\n * @param {(body: any, response: Response) => object|null} [options.toProblem] el error de un backend que no contesta en\n *     RFC 9457, a esa forma: (body) => ({title: body.message, errors: body.errors}). Por omisión el cuerpo tal cual\n * @param {(body: any, request: {method: string, url: string}) => any} [options.mapResponse] la respuesta buena de un backend\n *     que la envuelve: (body) => body.data. Por omisión tal cual\n * @param {typeof fetch} [options.fetch] para un servidor de mentira o para las pruebas; por omisión el del navegador\n * @returns {ApiClient}\n */\nexport function createApiClient({\n    baseUrl = '',\n    credentials = 'same-origin',\n    getToken,\n    headers: commonHeaders = {},\n    publishedBuildHeader = DEFAULT_PUBLISHED_BUILD_HEADER,\n    csrf = null,\n    timeoutMilliseconds: defaultTimeoutMilliseconds = DEFAULT_TIMEOUT_MILLISECONDS,\n    onUnauthenticated,\n    onRequest,\n    onResponse,\n    onError,\n    toProblem = (body) => body,\n    mapResponse = (body) => body,\n    fetch: fetchImplementation,\n} = {}) {\n    // un evento del proyecto que truena no tumba la petición: se anota y se sigue (nunca en silencio)\n    const notify = (eventName, handler, ...eventArguments) => {\n        try {\n            handler?.(...eventArguments);\n        } catch (error) {\n            log.error(`el evento ${eventName} del proyecto tronó`, {message: error?.message});\n        }\n    };\n    // OJO: se lee al pedir, no al armar el cliente: así un servidor de mentira que se conecta después también sirve\n    const fetchOf = () => fetchImplementation ?? globalThis.fetch;\n    const csrfCookieName = csrf?.cookieName ?? 'XSRF-TOKEN';\n    const csrfHeaderName = csrf?.headerName ?? 'X-XSRF-TOKEN';\n\n    /** Los headers de una petición: los comunes, el idioma vigente, el token y el CSRF. */\n    const headersOf = (url, body, extraHeaders) => {\n        const headers = {\n            Accept: 'application/json',\n            'Accept-Language': toolkitSettings().language ?? DEFAULT_LANGUAGE,\n            ...commonHeaders,\n            ...extraHeaders,\n        };\n        if (body !== undefined && !isRawBody(body)) {\n            headers['Content-Type'] = 'application/json';\n        }\n        const token = getToken?.();\n        if (token) {\n            headers.Authorization = `Bearer ${token}`;\n        }\n        const csrfToken = csrf && isSameOrigin(url) ? readCookie(csrfCookieName) : null;\n        if (csrfToken) {\n            headers[csrfHeaderName] = csrfToken;\n        }\n        return headers;\n    };\n\n    /** La petición al servidor, ya con su respuesta o con el ApiError de «sin respuesta». */\n    const send = async (method, url, {body, signal, headers, timeoutMilliseconds}) => {\n        const finalHeaders = headersOf(url, body, headers);\n        try {\n            return await fetchOf()(url, {\n                method,\n                headers: finalHeaders,\n                body: body === undefined || isRawBody(body) ? body : JSON.stringify(body),\n                credentials,\n                signal: combinedSignalOf(signal, timeoutMilliseconds),\n            });\n        } catch (error) {\n            // cancelar no es un error de negocio: quien canceló ya sabe por qué\n            if (signal?.aborted) {\n                throw error;\n            }\n            const reason = error?.name === 'TimeoutError' ? 'se acabó el tiempo' : 'la petición no llegó al servidor';\n            log.error(reason, {method, url, cause: error?.name});\n            throw new ApiError({status: API_ERROR_STATUS.offline});\n        }\n    };\n\n    /**\n     * Cualquier petición.\n     *\n     * @param {string} method 'GET', 'POST', 'PUT', 'PATCH' o 'DELETE'\n     * @param {string} path relativo a baseUrl (o completo con http)\n     * @param {object} [options]\n     * @param {unknown} [options.body] objeto → JSON; FormData, Blob o URLSearchParams tal cual\n     * @param {Record<string, unknown>} [options.params] los de la dirección (?page=2)\n     * @param {AbortSignal} [options.signal] para cancelar\n     * @param {Record<string, string>} [options.headers]\n     * @param {'json'|'blob'|'response'} [options.parse] cómo se lee la respuesta (API_RESPONSE_PARSE); por omisión JSON\n     * @param {boolean} [options.skipUnauthenticatedHandler] un 401 que se espera (¿hay sesión?, el login)\n     * @param {number} [options.timeoutMilliseconds] el de esta petición\n     * @returns {Promise<any>} el JSON (null si vino vacío o 204), el Blob o la Response\n     */\n    const request = async (method, path, options = {}) => {\n        const url = apiUrlOf(baseUrl, path, options.params);\n        try {\n            return await requestOnce(method, url, options);\n        } catch (error) {\n            // cada error del servidor (o sin red) sale por onError; cancelar no es error\n            if (error instanceof ApiError) {\n                notify('onError', onError, error, {method, url});\n            }\n            throw error;\n        }\n    };\n\n    const requestOnce = async (method, url, {\n        body, signal, headers, parse = API_RESPONSE_PARSE.json, skipUnauthenticatedHandler = false,\n        timeoutMilliseconds = defaultTimeoutMilliseconds,\n    } = {}) => {\n        notify('onRequest', onRequest, {method, url});\n        const startedAt = Date.now();\n        let response = await send(method, url, {body, signal, headers, timeoutMilliseconds});\n\n        // 419 de Laravel: la cookie CSRF venció; se pide una nueva y se repite la MISMA petición una sola vez\n        if (response.status === CSRF_TOKEN_MISMATCH_STATUS && csrf?.refreshPath) {\n            log.info('token CSRF vencido: se renueva y se reintenta', {method, url});\n            await send('GET', apiUrlOf(baseUrl, csrf.refreshPath), {signal, timeoutMilliseconds});\n            response = await send(method, url, {body, signal, headers, timeoutMilliseconds});\n        }\n\n        notify('onResponse', onResponse, {method, url, status: response.status, durationMilliseconds: Date.now() - startedAt});\n\n        // cada respuesta (también las de error) dice qué compilación del front está publicada\n        if (publishedBuildHeader) {\n            reportPublishedBuild(response.headers.get(publishedBuildHeader));\n        }\n\n        if (!response.ok) {\n            const problem = toProblemOrNull(toProblem, await readProblem(response), response);\n            // un error que armó otro (nginx) puede llegar en otro idioma: ahí se usa el texto genérico del paquete\n            const requestedLanguage = headersOf(url, undefined, headers)['Accept-Language'];\n            const responseLanguage = response.headers.get('content-language');\n            const apiError = new ApiError({\n                status: response.status,\n                problem,\n                translatedByServer: !responseLanguage || responseLanguage.startsWith(requestedLanguage),\n                retryAfterSeconds: retryAfterSecondsOf(response.headers.get('retry-after')),\n            });\n            // los 4xx son parte del flujo (un 422 es un formulario, un 401 al arrancar es «sin sesión»); los 5xx no\n            log[response.status >= SERVER_ERROR_STATUS ? 'error' : 'debug'](`${method} ${url} → ${response.status}`, {\n                code: apiError.code, requestId: apiError.requestId ?? response.headers.get('x-request-id'),\n            });\n            if (apiError.isUnauthenticated && !skipUnauthenticatedHandler) {\n                onUnauthenticated?.(apiError);\n            }\n            throw apiError;\n        }\n\n        if (parse === API_RESPONSE_PARSE.response) {\n            return response;\n        }\n        if (parse === API_RESPONSE_PARSE.blob) {\n            return response.blob();\n        }\n        if (response.status === NO_CONTENT_STATUS) {\n            return null;\n        }\n        // un 200 con el cuerpo vacío pasa de verdad; JSON.parse('') tronaría\n        const text = await response.text();\n        if (!text) {\n            return null;\n        }\n        let json;\n        try {\n            json = JSON.parse(text);\n        } catch {\n            // un 200 que no es JSON: casi siempre la página de la app que respondió en lugar del API (el camino está mal)\n            log.error(`${method} ${url} respondió algo que no es JSON`, {contentType: response.headers.get('content-type')});\n            throw new ApiError({status: SERVER_ERROR_STATUS});\n        }\n        return mapResponse(json, {method, url});\n    };\n\n    /**\n     * Descarga un archivo: el Blob y el nombre que mandó el servidor, con avance. Un Excel cortado no se entrega.\n     *\n     * Por omisión con GET. Un archivo que el servidor arma con datos de la pantalla (una plantilla con de quién es, el borrador\n     * de un contrato) va con method 'POST' y su body: el avance, el nombre y la revisión del Excel son los mismos.\n     *\n     * @param {string} path\n     * @param {object} [options]\n     * @param {string} [options.method] por omisión 'GET'\n     * @param {unknown} [options.body] objeto → JSON; FormData, Blob o URLSearchParams tal cual\n     * @param {Record<string, unknown>} [options.params]\n     * @param {AbortSignal} [options.signal]\n     * @param {(progress: {loaded: number, total: number|null}) => void} [options.onDownloadProgress]\n     * @param {string} [options.fallbackFileName] si el servidor no manda el nombre\n     * @param {number} [options.timeoutMilliseconds] por omisión sin límite\n     * @returns {Promise<{blob: Blob, fileName: string}>}\n     * @throws {ApiError} status 500 si un Excel llegó incompleto\n     */\n    const download = async (path, {\n        method = 'GET', body, params, signal, onDownloadProgress, fallbackFileName = 'descarga', timeoutMilliseconds = NO_TIMEOUT,\n    } = {}) => {\n        const response = await request(method, path, {body, params, signal, parse: API_RESPONSE_PARSE.response, timeoutMilliseconds});\n        const blob = await readBlobWithProgress(response, onDownloadProgress);\n        const fileName = fileNameFromContentDisposition(response.headers.get('content-disposition'), fallbackFileName);\n        // el tipo puede traer parámetros después del «;» (charset): solo cuenta lo de antes\n        const contentType = String(response.headers.get('content-type') ?? '').split(';')[0].trim();\n        if (contentType === XLSX_CONTENT_TYPE && !(await isCompleteZip(blob))) {\n            const requestId = response.headers.get('x-request-id');\n            log.error(`${method} ${path} → el Excel llegó incompleto: el servidor falló a media escritura`, {requestId, fileName});\n            throw new ApiError({status: SERVER_ERROR_STATUS, problem: {request_id: requestId}});\n        }\n        return {blob, fileName};\n    };\n\n    return {\n        request,\n        get: (path, options) => request('GET', path, options),\n        post: (path, body, options) => request('POST', path, {...options, body}),\n        put: (path, body, options) => request('PUT', path, {...options, body}),\n        patch: (path, body, options) => request('PATCH', path, {...options, body}),\n        delete: (path, options) => request('DELETE', path, options),\n        download,\n    };\n}\n"],"names":[],"mappings":"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"}

package/dist/filepond/FileDropzone.js

@@ -34,6 +34,30 @@ function detectFileType(file) {
   const dotPosition = file.name.lastIndexOf(".");
   return Promise.resolve(dotPosition >= 0 ? file.name.slice(dotPosition).toLowerCase() : mimeType);
 }
+function stablePondPropsOf(pondProps, stableFunctions, latest) {
+  const { files: ignoredFiles, ...pondOptions } = pondProps ?? {};
+  if (ignoredFiles !== void 0) {
+    warnUnknownProps(THEME_NAME, { "pondProps.files": ignoredFiles });
+  }
+  return Object.fromEntries(Object.entries(pondOptions).map(([option, value]) => {
+    if (typeof value !== "function") {
+      return [option, value];
+    }
+    if (!stableFunctions.current.has(option)) {
+      stableFunctions.current.set(option, (...args) => latest.current.pondProps?.[option]?.(...args));
+    }
+    return [option, stableFunctions.current.get(option)];
+  }));
+}
+function chunkOptionsOf({ chunkUploads, chunkForce, chunkSize, chunkRetryDelays }) {
+  return {
+    ...chunkUploads !== void 0 && { chunkUploads },
+    ...chunkForce !== void 0 && { chunkForce },
+    ...chunkSize !== void 0 && { chunkSize: parseFileSize(chunkSize) },
+    // FilePond truena con null: sin reintentos es una lista vacía
+    ...chunkRetryDelays !== void 0 && { chunkRetryDelays: chunkRetryDelays ?? [] }
+  };
+}
 function sameFiles(firstFiles, secondFiles) {
   return firstFiles.length === secondFiles.length && firstFiles.every((file, position) => file === secondFiles[position]);
 }
@@ -102,6 +126,11 @@ function FileDropzoneContent(props) {
     apiRef = null,
     onProcessProgress,
     onReject,
+    chunkUploads,
+    chunkForce,
+    chunkSize,
+    chunkRetryDelays,
+    pondProps = null,
     actions,
     children,
     sx,
@@ -123,7 +152,10 @@ function FileDropzoneContent(props) {
   const files = useMemo(() => filesOf(value, multiple), [value, multiple]);
   const pondRef = useRef(null);
   const latest = useRef({});
-  latest.current = { files, multiple, onChange, onReject, autoReject, validate, onProcessProgress, maxFiles, typeErrorLabel, totalErrorLabel, t };
+  latest.current = { files, multiple, onChange, onReject, autoReject, validate, onProcessProgress, maxFiles, typeErrorLabel, totalErrorLabel, t, pondProps };
+  const stableFunctions = useRef(/* @__PURE__ */ new Map());
+  const pondOptions = stablePondPropsOf(pondProps, stableFunctions, latest);
+  const pondAllows = (option) => !isLocked && (pondProps?.[option] ?? true);
   useEffect(() => {
     if (apiRef) {
       apiRef.current = pondRef.current;
@@ -144,7 +176,7 @@ function FileDropzoneContent(props) {
       emitChange(nextFile);
     }
   }, []);
-  const handleError = useCallback((error, item) => {
+  const handleError = useCallback((error, item, status) => {
     syncFromPond();
     const { onReject: reject, autoReject: shouldAutoReject, typeErrorLabel: typeLabel, totalErrorLabel: totalLabel } = latest.current;
     let reason = FILE_REJECTION.size;
@@ -163,11 +195,13 @@ function FileDropzoneContent(props) {
     if (reject && item?.file) {
       reject(item.file, reason);
     }
+    latest.current.pondProps?.onerror?.(error, item, status);
   }, [syncFromPond]);
   const handleBeforeAdd = useCallback(async (item) => {
-    const { validate: judge, onReject: reject, typeErrorLabel: fallbackMessage } = latest.current;
+    const { validate: judge, onReject: reject, typeErrorLabel: fallbackMessage, pondProps: projectOptions } = latest.current;
+    const projectAccepts = async () => projectOptions?.beforeAddFile ? await projectOptions.beforeAddFile(item) !== false : true;
     if (!judge) {
-      return true;
+      return projectAccepts();
     }
     let verdict;
     try {
@@ -176,7 +210,7 @@ function FileDropzoneContent(props) {
       verdict = false;
     }
     if (verdict === true) {
-      return true;
+      return projectAccepts();
     }
     const message = typeof verdict === "string" ? verdict : fallbackMessage;
     if (reject) {
@@ -186,16 +220,16 @@ function FileDropzoneContent(props) {
     }
     return false;
   }, []);
-  const handleProcessed = useCallback(() => {
-    const report = latest.current.onProcessProgress;
-    if (!report) {
-      return;
+  const handleProcessed = useCallback((error, processedItem) => {
+    const { onProcessProgress: report, pondProps: projectOptions } = latest.current;
+    if (report) {
+      const pondItems = pondRef.current?.getFiles?.() ?? [];
+      report({ done: pondItems.filter((item) => item.status === FileStatus.PROCESSING_COMPLETE).length, total: pondItems.length });
     }
-    const pondItems = pondRef.current?.getFiles?.() ?? [];
-    report({ done: pondItems.filter((item) => item.status === FileStatus.PROCESSING_COMPLETE).length, total: pondItems.length });
+    projectOptions?.onprocessfile?.(error, processedItem);
   }, []);
-  const handleWarning = useCallback((warning) => {
-    const { maxFiles: maxFileCount, onReject: reject, t: translate } = latest.current;
+  const handleWarning = useCallback((warning, file, status) => {
+    const { maxFiles: maxFileCount, onReject: reject, t: translate, pondProps: projectOptions } = latest.current;
     if (maxFileCount && String(warning?.body ?? "").toLowerCase().includes(MAX_FILES_WARNING)) {
       if (reject) {
         reject(null, FILE_REJECTION.count);
@@ -203,7 +237,12 @@ function FileDropzoneContent(props) {
         toastError(translate("upload.tooManyFiles", { count: maxFileCount }));
       }
     }
+    projectOptions?.onwarning?.(warning, file, status);
   }, []);
+  const handleUpdateFiles = useCallback((items) => {
+    syncFromPond();
+    latest.current.pondProps?.onupdatefiles?.(items);
+  }, [syncFromPond]);
   useEffect(() => {
     const pondItems = pondRef.current?.getFiles?.() ?? [];
     if (files.length === 0 && pondItems.length > 0) {
@@ -222,21 +261,23 @@ function FileDropzoneContent(props) {
     /* @__PURE__ */ jsx(
       FilePond,
       {
+        ...pondOptions,
+        ...chunkOptionsOf({ chunkUploads, chunkForce, chunkSize, chunkRetryDelays }),
         ref: pondRef,
         name: pondName,
         server,
         instantUpload,
         beforeAddFile: handleBeforeAdd,
         onprocessfile: handleProcessed,
-        onupdatefiles: syncFromPond,
+        onupdatefiles: handleUpdateFiles,
         allowMultiple: multiple,
         maxFiles: multiple ? maxFiles ?? null : 1,
         disabled: isLocked,
-        allowDrop: !isLocked,
-        allowBrowse: !isLocked,
-        allowPaste: !isLocked,
-        allowRemove: !isLocked,
-        allowReplace: !isLocked,
+        allowDrop: pondAllows("allowDrop"),
+        allowBrowse: pondAllows("allowBrowse"),
+        allowPaste: pondAllows("allowPaste"),
+        allowRemove: pondAllows("allowRemove"),
+        allowReplace: pondAllows("allowReplace"),
         credits: false,
         acceptedFileTypes: acceptedTypes,
         fileValidateTypeDetectType: detectFileType,