@stackcraftmx/calcita 0.0.0-stage → 0.23.0

package/dist/api/createApiClient.js

@@ -0,0 +1,226 @@
+import { ApiError, API_ERROR_STATUS } from "./ApiError.js";
+import { fileNameFromContentDisposition, XLSX_CONTENT_TYPE, isCompleteZip } from "../files.js";
+import { CSRF_TOKEN_MISMATCH_STATUS } from "../laravel/csrfRetry.js";
+import { createLogger } from "../observability/logger.js";
+import { reportPublishedBuild } from "../observability/publishedBuild.js";
+import { toolkitSettings, DEFAULT_LANGUAGE } from "../toolkit/toolkitSettings.js";
+const log = createLogger("api");
+const API_RESPONSE_PARSE = Object.freeze({ json: "json", blob: "blob", response: "response" });
+const DEFAULT_TIMEOUT_MILLISECONDS = 6e4;
+const NO_TIMEOUT = 0;
+const DEFAULT_PUBLISHED_BUILD_HEADER = "X-Frontend-Build";
+const NO_CONTENT_STATUS = 204;
+const SERVER_ERROR_STATUS = 500;
+function apiUrlOf(baseUrl, path, params) {
+  const url = /^https?:/i.test(path) ? path : `${baseUrl}${path}`;
+  const query = new URLSearchParams();
+  for (const [name, value] of Object.entries(params ?? {})) {
+    for (const item of [].concat(value)) {
+      if (item !== void 0 && item !== null) {
+        query.append(name, String(item));
+      }
+    }
+  }
+  const queryText = query.toString();
+  if (!queryText) {
+    return url;
+  }
+  return `${url}${url.includes("?") ? "&" : "?"}${queryText}`;
+}
+function isRawBody(body) {
+  return typeof FormData !== "undefined" && body instanceof FormData || typeof Blob !== "undefined" && body instanceof Blob || body instanceof URLSearchParams || body instanceof ArrayBuffer;
+}
+function readCookie(cookieName) {
+  if (typeof document === "undefined") {
+    return null;
+  }
+  const prefix = `${cookieName}=`;
+  const cookie = document.cookie.split(";").map((part) => part.trim()).find((part) => part.startsWith(prefix));
+  return cookie ? decodeURIComponent(cookie.slice(prefix.length)) : null;
+}
+function isSameOrigin(url) {
+  if (typeof window === "undefined" || !/^https?:/i.test(url)) {
+    return true;
+  }
+  return new URL(url).origin === window.location.origin;
+}
+function retryAfterSecondsOf(retryAfterHeader) {
+  if (!retryAfterHeader) {
+    return null;
+  }
+  if (/^\d+$/.test(retryAfterHeader.trim())) {
+    return Number(retryAfterHeader.trim());
+  }
+  const retryAt = Date.parse(retryAfterHeader);
+  return Number.isNaN(retryAt) ? null : Math.max(0, Math.ceil((retryAt - Date.now()) / 1e3));
+}
+async function readProblem(response) {
+  try {
+    const body = JSON.parse(await response.text());
+    return body && typeof body === "object" && !Array.isArray(body) ? body : null;
+  } catch {
+    return null;
+  }
+}
+function combinedSignalOf(signal, timeoutMilliseconds) {
+  const signals = [signal, timeoutMilliseconds > 0 ? AbortSignal.timeout(timeoutMilliseconds) : null].filter(Boolean);
+  if (signals.length < 2) {
+    return signals[0];
+  }
+  return AbortSignal.any(signals);
+}
+async function readBlobWithProgress(response, onDownloadProgress) {
+  if (!onDownloadProgress || !response.body) {
+    return response.blob();
+  }
+  const total = Number(response.headers.get("content-length")) || null;
+  const reader = response.body.getReader();
+  const chunks = [];
+  let loaded = 0;
+  for (let part = await reader.read(); !part.done; part = await reader.read()) {
+    chunks.push(part.value);
+    loaded += part.value.byteLength;
+    onDownloadProgress({ loaded, total });
+  }
+  return new Blob(chunks, { type: response.headers.get("content-type") ?? "" });
+}
+function createApiClient({
+  baseUrl = "",
+  credentials = "same-origin",
+  getToken,
+  headers: commonHeaders = {},
+  publishedBuildHeader = DEFAULT_PUBLISHED_BUILD_HEADER,
+  csrf = null,
+  timeoutMilliseconds: defaultTimeoutMilliseconds = DEFAULT_TIMEOUT_MILLISECONDS,
+  onUnauthenticated,
+  fetch: fetchImplementation
+} = {}) {
+  const fetchOf = () => fetchImplementation ?? globalThis.fetch;
+  const csrfCookieName = csrf?.cookieName ?? "XSRF-TOKEN";
+  const csrfHeaderName = csrf?.headerName ?? "X-XSRF-TOKEN";
+  const headersOf = (url, body, extraHeaders) => {
+    const headers = {
+      Accept: "application/json",
+      "Accept-Language": toolkitSettings().language ?? DEFAULT_LANGUAGE,
+      ...commonHeaders,
+      ...extraHeaders
+    };
+    if (body !== void 0 && !isRawBody(body)) {
+      headers["Content-Type"] = "application/json";
+    }
+    const token = getToken?.();
+    if (token) {
+      headers.Authorization = `Bearer ${token}`;
+    }
+    const csrfToken = csrf && isSameOrigin(url) ? readCookie(csrfCookieName) : null;
+    if (csrfToken) {
+      headers[csrfHeaderName] = csrfToken;
+    }
+    return headers;
+  };
+  const send = async (method, url, { body, signal, headers, timeoutMilliseconds }) => {
+    const finalHeaders = headersOf(url, body, headers);
+    try {
+      return await fetchOf()(url, {
+        method,
+        headers: finalHeaders,
+        body: body === void 0 || isRawBody(body) ? body : JSON.stringify(body),
+        credentials,
+        signal: combinedSignalOf(signal, timeoutMilliseconds)
+      });
+    } catch (error) {
+      if (signal?.aborted) {
+        throw error;
+      }
+      const reason = error?.name === "TimeoutError" ? "se acabó el tiempo" : "la petición no llegó al servidor";
+      log.error(reason, { method, url, cause: error?.name });
+      throw new ApiError({ status: API_ERROR_STATUS.offline });
+    }
+  };
+  const request = async (method, path, {
+    body,
+    params,
+    signal,
+    headers,
+    parse = API_RESPONSE_PARSE.json,
+    skipUnauthenticatedHandler = false,
+    timeoutMilliseconds = defaultTimeoutMilliseconds
+  } = {}) => {
+    const url = apiUrlOf(baseUrl, path, params);
+    let response = await send(method, url, { body, signal, headers, timeoutMilliseconds });
+    if (response.status === CSRF_TOKEN_MISMATCH_STATUS && csrf?.refreshPath) {
+      log.info("token CSRF vencido: se renueva y se reintenta", { method, url });
+      await send("GET", apiUrlOf(baseUrl, csrf.refreshPath), { signal, timeoutMilliseconds });
+      response = await send(method, url, { body, signal, headers, timeoutMilliseconds });
+    }
+    if (publishedBuildHeader) {
+      reportPublishedBuild(response.headers.get(publishedBuildHeader));
+    }
+    if (!response.ok) {
+      const problem = await readProblem(response);
+      const requestedLanguage = headersOf(url, void 0, headers)["Accept-Language"];
+      const responseLanguage = response.headers.get("content-language");
+      const apiError = new ApiError({
+        status: response.status,
+        problem,
+        translatedByServer: !responseLanguage || responseLanguage.startsWith(requestedLanguage),
+        retryAfterSeconds: retryAfterSecondsOf(response.headers.get("retry-after"))
+      });
+      log[response.status >= SERVER_ERROR_STATUS ? "error" : "debug"](`${method} ${url} → ${response.status}`, {
+        code: apiError.code,
+        requestId: apiError.requestId ?? response.headers.get("x-request-id")
+      });
+      if (apiError.isUnauthenticated && !skipUnauthenticatedHandler) {
+        onUnauthenticated?.(apiError);
+      }
+      throw apiError;
+    }
+    if (parse === API_RESPONSE_PARSE.response) {
+      return response;
+    }
+    if (parse === API_RESPONSE_PARSE.blob) {
+      return response.blob();
+    }
+    if (response.status === NO_CONTENT_STATUS) {
+      return null;
+    }
+    const text = await response.text();
+    if (!text) {
+      return null;
+    }
+    try {
+      return JSON.parse(text);
+    } catch {
+      log.error(`${method} ${url} respondió algo que no es JSON`, { contentType: response.headers.get("content-type") });
+      throw new ApiError({ status: SERVER_ERROR_STATUS });
+    }
+  };
+  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 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 });
+      throw new ApiError({ status: SERVER_ERROR_STATUS, problem: { request_id: requestId } });
+    }
+    return { blob, fileName };
+  };
+  return {
+    request,
+    get: (path, options) => request("GET", path, options),
+    post: (path, body, options) => request("POST", path, { ...options, body }),
+    put: (path, body, options) => request("PUT", path, { ...options, body }),
+    patch: (path, body, options) => request("PATCH", path, { ...options, body }),
+    delete: (path, options) => request("DELETE", path, options),
+    download
+  };
+}
+export {
+  API_RESPONSE_PARSE,
+  apiUrlOf,
+  createApiClient,
+  retryAfterSecondsOf
+};
+//# sourceMappingURL=createApiClient.js.map

package/dist/api/createApiClient.js.map

@@ -0,0 +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//\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 */\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 * 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 {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    fetch: fetchImplementation,\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, {\n        body, params, signal, headers, parse = API_RESPONSE_PARSE.json, skipUnauthenticatedHandler = false,\n        timeoutMilliseconds = defaultTimeoutMilliseconds,\n    } = {}) => {\n        const url = apiUrlOf(baseUrl, path, params);\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        // 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 = await readProblem(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        try {\n            return 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    };\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":"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"}

package/dist/api/staleChunks.js

@@ -0,0 +1,47 @@
+import { createLogger } from "../observability/logger.js";
+const log = createLogger("chunks");
+const RELOAD_STORAGE_KEY = "calcita:chunkReloadAt";
+const RELOAD_COOLDOWN_MILLISECONDS = 15e3;
+const STALE_CHUNK_MESSAGES = Object.freeze([
+  "failed to fetch dynamically imported module",
+  "error loading dynamically imported module",
+  "importing a module script failed",
+  "failed to load module script"
+]);
+function isStaleChunkError(error) {
+  const message = String(error?.message ?? error ?? "").toLowerCase();
+  return STALE_CHUNK_MESSAGES.some((knownMessage) => message.includes(knownMessage));
+}
+function reloadedRecently() {
+  try {
+    const reloadedAt = Number(window.sessionStorage.getItem(RELOAD_STORAGE_KEY) ?? 0);
+    return reloadedAt > 0 && Date.now() - reloadedAt < RELOAD_COOLDOWN_MILLISECONDS;
+  } catch {
+    return false;
+  }
+}
+function markReload() {
+  try {
+    window.sessionStorage.setItem(RELOAD_STORAGE_KEY, String(Date.now()));
+  } catch {
+  }
+}
+function recoverFromStaleChunk(error) {
+  if (!isStaleChunkError(error)) {
+    throw error;
+  }
+  if (reloadedRecently()) {
+    log.error("el archivo de la pantalla sigue sin cargar después de recargar", { cause: String(error) });
+    throw error;
+  }
+  log.warn("archivo de una versión anterior: se recarga la página", { cause: String(error) });
+  markReload();
+  window.location.reload();
+  return new Promise(() => {
+  });
+}
+export {
+  isStaleChunkError,
+  recoverFromStaleChunk
+};
+//# sourceMappingURL=staleChunks.js.map

package/dist/api/staleChunks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleChunks.js","sources":["../../src/api/staleChunks.js"],"sourcesContent":["// Sobrevivir a una publicación con la app abierta.\n//\n// El síntoma (Chrome): «Failed to fetch dynamically imported module: …/assets/orders-LUgRFrRF.js».\n//\n// Qué pasó: cada pantalla viaja en su propio archivo con la huella de su contenido en el nombre. Al publicar, los nombres\n// cambian y los viejos se borran. Quien tenía la app abierta sigue con el índice anterior en memoria: en cuanto entra a\n// una pantalla que no había abierto, pide un archivo que ya no existe. No es un error de red ni de la persona; le pasa a\n// cualquiera que tenga la pestaña abierta durante una publicación.\n//\n// Qué se hace: recargar UNA vez. La página nueva trae los nombres nuevos y la persona ve un parpadeo en lugar de una\n// pantalla rota. El candado contra el ciclo es la hora de la última recarga en sessionStorage: si se recargó hace menos de\n// RELOAD_COOLDOWN_MILLISECONDS, el error sigue su camino (un archivo que de verdad falta dejaría la pestaña recargándose\n// para siempre). La ventana es corta a propósito: otra publicación media hora después se tiene que poder recuperar igual.\n//\n//   lazy: () => import('./OrdersPage.jsx').catch(recoverFromStaleChunk)\n//\n// Con react-router, withChunkRecovery(routes) de /react-router lo pone en todas las rutas lazy.\n//\n// Funciones puras, no renderizan: function (regla de la casa).\nimport {createLogger} from '@/observability/logger.js';\n\nconst log = createLogger('chunks');\n\nconst RELOAD_STORAGE_KEY = 'calcita:chunkReloadAt';\nconst RELOAD_COOLDOWN_MILLISECONDS = 15_000;\n\n// Cada navegador lo redacta distinto: Chromium «Failed to fetch dynamically imported module», Firefox «error loading\n// dynamically imported module», Safari «Importing a module script failed».\nconst STALE_CHUNK_MESSAGES = Object.freeze([\n    'failed to fetch dynamically imported module',\n    'error loading dynamically imported module',\n    'importing a module script failed',\n    'failed to load module script',\n]);\n\n/**\n * ¿El error es un archivo de pantalla que ya no existe (se publicó otra versión), y no otra cosa?\n *\n * @param {unknown} error\n * @returns {boolean}\n */\nexport function isStaleChunkError(error) {\n    const message = String(error?.message ?? error ?? '').toLowerCase();\n    return STALE_CHUNK_MESSAGES.some((knownMessage) => message.includes(knownMessage));\n}\n\n/** ¿Ya se recargó por esto hace poco? Sin sessionStorage no hay candado: mejor recargar una vez que dejar la pantalla rota. */\nfunction reloadedRecently() {\n    try {\n        const reloadedAt = Number(window.sessionStorage.getItem(RELOAD_STORAGE_KEY) ?? 0);\n        return reloadedAt > 0 && Date.now() - reloadedAt < RELOAD_COOLDOWN_MILLISECONDS;\n    } catch {\n        return false;\n    }\n}\n\nfunction markReload() {\n    try {\n        window.sessionStorage.setItem(RELOAD_STORAGE_KEY, String(Date.now()));\n    } catch {\n        // almacenamiento bloqueado: se recarga igual, solo sin candado\n    }\n}\n\n/**\n * Lo que va en el .catch() de un import dinámico: si el archivo es de una versión vieja, recarga una vez; si no, deja\n * pasar el error tal cual para que lo vea quien corresponda.\n *\n * @param {unknown} error\n * @returns {Promise<never>}\n */\nexport function recoverFromStaleChunk(error) {\n    if (!isStaleChunkError(error)) {\n        throw error;\n    }\n    if (reloadedRecently()) {\n        // ya se recargó y volvió a fallar: no es una publicación, el archivo de verdad falta. Nunca fallar en silencio\n        log.error('el archivo de la pantalla sigue sin cargar después de recargar', {cause: String(error)});\n        throw error;\n    }\n    log.warn('archivo de una versión anterior: se recarga la página', {cause: String(error)});\n    markReload();\n    window.location.reload();\n    // OJO: la promesa NUNCA se resuelve, a propósito: la página ya se está yendo y resolverla haría que se pintara un error\n    // un instante antes de recargar\n    return new Promise(() => {});\n}\n"],"names":[],"mappings":";AAqBA,MAAM,MAAM,aAAa,QAAQ;AAEjC,MAAM,qBAAqB;AAC3B,MAAM,+BAA+B;AAIrC,MAAM,uBAAuB,OAAO,OAAO;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAQM,SAAS,kBAAkB,OAAO;AACrC,QAAM,UAAU,OAAO,OAAO,WAAW,SAAS,EAAE,EAAE,YAAW;AACjE,SAAO,qBAAqB,KAAK,CAAC,iBAAiB,QAAQ,SAAS,YAAY,CAAC;AACrF;AAGA,SAAS,mBAAmB;AACxB,MAAI;AACA,UAAM,aAAa,OAAO,OAAO,eAAe,QAAQ,kBAAkB,KAAK,CAAC;AAChF,WAAO,aAAa,KAAK,KAAK,IAAG,IAAK,aAAa;AAAA,EACvD,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;AAEA,SAAS,aAAa;AAClB,MAAI;AACA,WAAO,eAAe,QAAQ,oBAAoB,OAAO,KAAK,IAAG,CAAE,CAAC;AAAA,EACxE,QAAQ;AAAA,EAER;AACJ;AASO,SAAS,sBAAsB,OAAO;AACzC,MAAI,CAAC,kBAAkB,KAAK,GAAG;AAC3B,UAAM;AAAA,EACV;AACA,MAAI,iBAAgB,GAAI;AAEpB,QAAI,MAAM,kEAAkE,EAAC,OAAO,OAAO,KAAK,EAAC,CAAC;AAClG,UAAM;AAAA,EACV;AACA,MAAI,KAAK,yDAAyD,EAAC,OAAO,OAAO,KAAK,EAAC,CAAC;AACxF,aAAU;AACV,SAAO,SAAS,OAAM;AAGtB,SAAO,IAAI,QAAQ,MAAM;AAAA,EAAC,CAAC;AAC/B;"}

package/dist/appShell/AccountMenu.js

@@ -0,0 +1,86 @@
+"use client";
+import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import { useState } from "react";
+import { useToolkitTranslation } from "../toolkit/useToolkitTranslation.js";
+import { useToolkitNavigation } from "../toolkit/toolkitContext.js";
+import Avatar from "@mui/material/Avatar";
+import Box from "@mui/material/Box";
+import Divider from "@mui/material/Divider";
+import IconButton from "@mui/material/IconButton";
+import ListItemIcon from "@mui/material/ListItemIcon";
+import ListItemText from "@mui/material/ListItemText";
+import Menu from "@mui/material/Menu";
+import MenuItem from "@mui/material/MenuItem";
+import Tooltip from "@mui/material/Tooltip";
+import Typography from "@mui/material/Typography";
+import LogoutIcon from "@mui/icons-material/Logout";
+import PersonOutlineIcon from "@mui/icons-material/PersonOutline";
+import { initialsOf, menuItemLabelOf } from "./menuItemText.js";
+import { barMenuPlacementOf } from "./barMenuPlacement.js";
+function AccountMenu({ user, profilePath, accountMenuItems = [], onSignOut, isSigningOut = false, settings }) {
+  const { t } = useToolkitTranslation("layout");
+  const { Link: RouterLink } = useToolkitNavigation();
+  const [anchorElement, setAnchorElement] = useState(null);
+  const closeMenu = () => setAnchorElement(null);
+  const menuLinks = [
+    ...profilePath ? [{ to: profilePath, labelKey: "layout:account.myProfile", Icon: PersonOutlineIcon }] : [],
+    ...accountMenuItems
+  ];
+  const placement = barMenuPlacementOf(anchorElement);
+  const signOut = () => {
+    closeMenu();
+    onSignOut();
+  };
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(Tooltip, { title: t("account.open"), children: /* @__PURE__ */ jsx(IconButton, { size: "small", "aria-label": t("account.open"), "aria-haspopup": "menu", onClick: (event) => setAnchorElement(event.currentTarget), sx: { p: 0.5 }, children: /* @__PURE__ */ jsx(Avatar, { src: user.avatarUrl, alt: "", sx: { width: 32, height: 32, fontSize: "0.875rem", bgcolor: "secondary.main", color: "secondary.contrastText" }, children: initialsOf(user.name) }) }) }),
+    /* @__PURE__ */ jsxs(
+      Menu,
+      {
+        anchorEl: anchorElement,
+        open: Boolean(anchorElement),
+        onClose: closeMenu,
+        anchorOrigin: placement.anchorOrigin,
+        transformOrigin: placement.transformOrigin,
+        slotProps: { paper: { sx: { minWidth: settings ? 300 : 240, maxWidth: 360, ...placement.gapSx } } },
+        children: [
+          /* @__PURE__ */ jsxs(Box, { sx: { px: 2, py: 1.25 }, children: [
+            /* @__PURE__ */ jsx(Typography, { variant: "subtitle2", noWrap: true, sx: { fontWeight: 600 }, children: user.name }),
+            user.email && /* @__PURE__ */ jsx(Typography, { variant: "body2", color: "text.secondary", noWrap: true, children: user.email }),
+            user.subtitle && /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "text.secondary", component: "p", noWrap: true, children: user.subtitle })
+          ] }),
+          settings && /* @__PURE__ */ jsx(Divider, {}),
+          settings && /* @__PURE__ */ jsx(Box, { sx: { py: 0.5 }, children: settings }),
+          menuLinks.length > 0 && /* @__PURE__ */ jsx(Divider, {}),
+          menuLinks.map((menuLink) => {
+            const Icon = menuLink.Icon;
+            const linkProps = menuLink.to ? { component: RouterLink, to: menuLink.to } : {};
+            return /* @__PURE__ */ jsxs(
+              MenuItem,
+              {
+                ...linkProps,
+                onClick: () => {
+                  closeMenu();
+                  menuLink.onClick?.();
+                },
+                children: [
+                  Icon && /* @__PURE__ */ jsx(ListItemIcon, { children: /* @__PURE__ */ jsx(Icon, { fontSize: "small" }) }),
+                  /* @__PURE__ */ jsx(ListItemText, { primary: menuItemLabelOf(menuLink, t) })
+                ]
+              },
+              menuLink.to ?? menuItemLabelOf(menuLink, t)
+            );
+          }),
+          onSignOut && /* @__PURE__ */ jsx(Divider, {}),
+          onSignOut && /* @__PURE__ */ jsxs(MenuItem, { onClick: signOut, disabled: isSigningOut, children: [
+            /* @__PURE__ */ jsx(ListItemIcon, { children: /* @__PURE__ */ jsx(LogoutIcon, { fontSize: "small" }) }),
+            /* @__PURE__ */ jsx(ListItemText, { primary: t("signOut") })
+          ] })
+        ]
+      }
+    )
+  ] });
+}
+export {
+  AccountMenu as default
+};
+//# sourceMappingURL=AccountMenu.js.map

package/dist/appShell/AccountMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountMenu.js","sources":["../../src/appShell/AccountMenu.jsx"],"sourcesContent":["// La cuenta de quien está dentro, arriba a la derecha (como en las plantillas de MUI): un avatar con sus iniciales (o su\n// foto) que abre un menú con su nombre y correo, Mi perfil, lo que el proyecto agregue (accountMenuItems: Facturación,\n// Mis llaves…) y Salir.\n//\n// Genérico del paquete: function (regla de la casa).\nimport {useState} from 'react';\nimport {useToolkitTranslation} from '@/toolkit/useToolkitTranslation.js';\nimport {useToolkitNavigation} from '@/toolkit/toolkitContext.js';\nimport Avatar from '@mui/material/Avatar';\nimport Box from '@mui/material/Box';\nimport Divider from '@mui/material/Divider';\nimport IconButton from '@mui/material/IconButton';\nimport ListItemIcon from '@mui/material/ListItemIcon';\nimport ListItemText from '@mui/material/ListItemText';\nimport Menu from '@mui/material/Menu';\nimport MenuItem from '@mui/material/MenuItem';\nimport Tooltip from '@mui/material/Tooltip';\nimport Typography from '@mui/material/Typography';\nimport LogoutIcon from '@mui/icons-material/Logout';\nimport PersonOutlineIcon from '@mui/icons-material/PersonOutline';\n\nimport {initialsOf, menuItemLabelOf} from '@/appShell/menuItemText.js';\nimport {barMenuPlacementOf} from '@/appShell/barMenuPlacement.js';\n\n/**\n * @param {object} props\n * @param {{name: string, email?: string, subtitle?: string, avatarUrl?: string}} props.user\n * @param {string} [props.profilePath] sin ella no sale «Mi perfil»\n * @param {Array<{to?: string, onClick?: Function, label?: string, labelKey?: string, Icon?: import('react').ElementType}>} [props.accountMenuItems]\n * @param {() => void} [props.onSignOut] sin él no sale «Salir»\n * @param {boolean} [props.isSigningOut]\n * @param {import('react').ReactNode} [props.settings] los ajustes de la app, entre los datos de la persona y sus ligas\n */\nexport default function AccountMenu({user, profilePath, accountMenuItems = [], onSignOut, isSigningOut = false, settings}) {\n    const {t} = useToolkitTranslation('layout');\n    const {Link: RouterLink} = useToolkitNavigation();\n    const [anchorElement, setAnchorElement] = useState(null);\n    const closeMenu = () => setAnchorElement(null);\n    const menuLinks = [\n        ...(profilePath ? [{to: profilePath, labelKey: 'layout:account.myProfile', Icon: PersonOutlineIcon}] : []),\n        ...accountMenuItems,\n    ];\n\n    // hacia arriba si la barra está abajo (teléfono con vidrio)\n    const placement = barMenuPlacementOf(anchorElement);\n\n    const signOut = () => {\n        closeMenu();\n        onSignOut();\n    };\n\n    return (\n        <>\n            <Tooltip title={t('account.open')}>\n                <IconButton size=\"small\" aria-label={t('account.open')} aria-haspopup=\"menu\" onClick={(event) => setAnchorElement(event.currentTarget)} sx={{p: 0.5}}>\n                    <Avatar src={user.avatarUrl} alt=\"\" sx={{width: 32, height: 32, fontSize: '0.875rem', bgcolor: 'secondary.main', color: 'secondary.contrastText'}}>\n                        {initialsOf(user.name)}\n                    </Avatar>\n                </IconButton>\n            </Tooltip>\n            <Menu anchorEl={anchorElement} open={Boolean(anchorElement)} onClose={closeMenu}\n                  anchorOrigin={placement.anchorOrigin} transformOrigin={placement.transformOrigin}\n                  slotProps={{paper: {sx: {minWidth: settings ? 300 : 240, maxWidth: 360, ...placement.gapSx}}}}>\n                <Box sx={{px: 2, py: 1.25}}>\n                    <Typography variant=\"subtitle2\" noWrap sx={{fontWeight: 600}}>{user.name}</Typography>\n                    {user.email && <Typography variant=\"body2\" color=\"text.secondary\" noWrap>{user.email}</Typography>}\n                    {user.subtitle && <Typography variant=\"caption\" color=\"text.secondary\" component=\"p\" noWrap>{user.subtitle}</Typography>}\n                </Box>\n                {/* los ajustes de la app (letra, idioma, claro u oscuro y los del proyecto): en la cuenta y no sueltos en la barra */}\n                {settings && <Divider />}\n                {settings && <Box sx={{py: 0.5}}>{settings}</Box>}\n                {menuLinks.length > 0 && <Divider />}\n                {menuLinks.map((menuLink) => {\n                    const Icon = menuLink.Icon;\n                    const linkProps = menuLink.to ? {component: RouterLink, to: menuLink.to} : {};\n                    return (\n                        <MenuItem key={menuLink.to ?? menuItemLabelOf(menuLink, t)} {...linkProps}\n                                  onClick={() => {\n                                      closeMenu();\n                                      menuLink.onClick?.();\n                                  }}>\n                            {Icon && <ListItemIcon><Icon fontSize=\"small\" /></ListItemIcon>}\n                            <ListItemText primary={menuItemLabelOf(menuLink, t)} />\n                        </MenuItem>\n                    );\n                })}\n                {onSignOut && <Divider />}\n                {onSignOut && (\n                    <MenuItem onClick={signOut} disabled={isSigningOut}>\n                        <ListItemIcon><LogoutIcon fontSize=\"small\" /></ListItemIcon>\n                        <ListItemText primary={t('signOut')} />\n                    </MenuItem>\n                )}\n            </Menu>\n        </>\n    );\n}\n"],"names":[],"mappings":"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"}