tempest-react-sdk 0.22.0 → 0.23.0

package/dist/http/parse-response.js

@@ -0,0 +1,20 @@
+function a(n, e, o) {
+  const s = n.safeParse(e);
+  if (s.success)
+    return s.data;
+  if (typeof process < "u" && (process.env?.NODE_ENV === "development" || process.env?.NODE_ENV === "test")) {
+    const t = s.error.issues.map((r) => `  - ${r.path.join(".") || "<root>"}: ${r.message}`).join(`
+`);
+    throw new Error(
+      `[parseResponse] Contract drift on ${o}:
+${t}
+
+Raw payload: ${JSON.stringify(e, null, 2)}`
+    );
+  }
+  throw new Error(`Resposta inválida do servidor (${o}).`);
+}
+export {
+  a as parseResponse
+};
+//# sourceMappingURL=parse-response.js.map

package/dist/http/parse-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-response.js","sources":["../../src/http/parse-response.ts"],"sourcesContent":["import type { z } from \"zod\";\n\n/**\n * Validate an unknown response payload against a zod schema.\n *\n * In development, throws a detailed error pointing at the divergent field.\n * In production, throws a generic error so internals do not leak to users.\n *\n * @param schema - The zod schema to parse against.\n * @param raw - The raw response payload.\n * @param context - A label used in error messages, e.g. \"POST /auth/login\".\n * @returns The parsed, typed payload.\n */\nexport function parseResponse<TSchema extends z.ZodTypeAny>(\n    schema: TSchema,\n    raw: unknown,\n    context: string,\n): z.infer<TSchema> {\n    const result = schema.safeParse(raw);\n    if (result.success) {\n        return result.data;\n    }\n\n    const isDev =\n        typeof process !== \"undefined\" &&\n        (process.env?.NODE_ENV === \"development\" || process.env?.NODE_ENV === \"test\");\n\n    if (isDev) {\n        const issues = result.error.issues\n            .map((i) => `  - ${i.path.join(\".\") || \"<root>\"}: ${i.message}`)\n            .join(\"\\n\");\n        throw new Error(\n            `[parseResponse] Contract drift on ${context}:\\n${issues}\\n\\nRaw payload: ${JSON.stringify(raw, null, 2)}`,\n        );\n    }\n    throw new Error(`Resposta inválida do servidor (${context}).`);\n}\n"],"names":["parseResponse","schema","raw","context","result","issues","i"],"mappings":"AAaO,SAASA,EACZC,GACAC,GACAC,GACgB;AAChB,QAAMC,IAASH,EAAO,UAAUC,CAAG;AACnC,MAAIE,EAAO;AACP,WAAOA,EAAO;AAOlB,MAHI,OAAO,UAAY,QAClB,QAAQ,KAAK,aAAa,iBAAiB,QAAQ,KAAK,aAAa,SAE/D;AACP,UAAMC,IAASD,EAAO,MAAM,OACvB,IAAI,CAACE,MAAM,OAAOA,EAAE,KAAK,KAAK,GAAG,KAAK,QAAQ,KAAKA,EAAE,OAAO,EAAE,EAC9D,KAAK;AAAA,CAAI;AACd,UAAM,IAAI;AAAA,MACN,qCAAqCH,CAAO;AAAA,EAAME,CAAM;AAAA;AAAA,eAAoB,KAAK,UAAUH,GAAK,MAAM,CAAC,CAAC;AAAA,IAAA;AAAA,EAEhH;AACA,QAAM,IAAI,MAAM,kCAAkCC,CAAO,IAAI;AACjE;"}

package/dist/http/retry.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function f(a,e){return new Promise((o,n)=>{if(e?.aborted){n(new DOMException("Aborted","AbortError"));return}const i=setTimeout(o,a);e?.addEventListener("abort",()=>{clearTimeout(i),n(new DOMException("Aborted","AbortError"))},{once:!0})})}async function w(a,e={}){const{retries:o=3,initialDelay:n=300,maxDelay:i=1e4,respectRetryAfter:s=!0,shouldRetry:b=()=>!0,onRetry:d,signal:l}=e;let t=0,u;for(;t<o;){if(l?.aborted)throw new DOMException("Aborted","AbortError");try{return await a()}catch(r){if(u=r,t+=1,t>=o||!b(r,t))throw r;const c=s&&typeof r?.retryAfter=="number"?r.retryAfter*1e3:null,y=Math.min(c!==null?c:n*2**(t-1),i);d?.({attempt:t,delay:y,error:r}),await f(y,l)}}throw u}exports.retry=w;
+//# sourceMappingURL=retry.cjs.map

package/dist/http/retry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.cjs","sources":["../../src/http/retry.ts"],"sourcesContent":["export interface RetryOptions {\n    /** Max attempts (including the first). Default: 3. */\n    retries?: number;\n    /** Initial backoff in ms. Doubles each attempt, capped at `maxDelay`. Default: 300. */\n    initialDelay?: number;\n    /** Maximum delay between attempts. Default: 10_000. */\n    maxDelay?: number;\n    /**\n     * Honor a `Retry-After` hint on the thrown error (`error.retryAfter`, in\n     * seconds — populated by {@link createApiClient} on `429`/`503`). When\n     * present it overrides the exponential backoff for that attempt. The value\n     * is capped at `maxDelay`. Default: true.\n     */\n    respectRetryAfter?: boolean;\n    /**\n     * Return false to stop retrying for a specific error.\n     * Default: retry on any thrown error.\n     */\n    shouldRetry?: (error: unknown, attempt: number) => boolean;\n    /** Called before each retry with the upcoming delay. */\n    onRetry?: (info: { attempt: number; delay: number; error: unknown }) => void;\n    /** Cancel pending retries. */\n    signal?: AbortSignal;\n}\n\nfunction wait(ms: number, signal?: AbortSignal): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n        if (signal?.aborted) {\n            reject(new DOMException(\"Aborted\", \"AbortError\"));\n            return;\n        }\n        const timer = setTimeout(resolve, ms);\n        signal?.addEventListener(\n            \"abort\",\n            () => {\n                clearTimeout(timer);\n                reject(new DOMException(\"Aborted\", \"AbortError\"));\n            },\n            { once: true },\n        );\n    });\n}\n\n/**\n * Run `factory()` with exponential backoff. Each attempt awaits an\n * increasing delay capped at `maxDelay`. Throws the last error if every\n * attempt fails.\n *\n * @example\n * const data = await retry(() => api.get(\"/flaky\"), { retries: 5 });\n */\nexport async function retry<T>(factory: () => Promise<T>, options: RetryOptions = {}): Promise<T> {\n    const {\n        retries = 3,\n        initialDelay = 300,\n        maxDelay = 10_000,\n        respectRetryAfter = true,\n        shouldRetry = () => true,\n        onRetry,\n        signal,\n    } = options;\n\n    let attempt = 0;\n    let lastError: unknown;\n\n    while (attempt < retries) {\n        if (signal?.aborted) throw new DOMException(\"Aborted\", \"AbortError\");\n        try {\n            return await factory();\n        } catch (error) {\n            lastError = error;\n            attempt += 1;\n            if (attempt >= retries || !shouldRetry(error, attempt)) {\n                throw error;\n            }\n            const retryAfter =\n                respectRetryAfter &&\n                typeof (error as { retryAfter?: unknown })?.retryAfter === \"number\"\n                    ? (error as { retryAfter: number }).retryAfter * 1000\n                    : null;\n            const delay =\n                retryAfter !== null\n                    ? Math.min(retryAfter, maxDelay)\n                    : Math.min(initialDelay * 2 ** (attempt - 1), maxDelay);\n            onRetry?.({ attempt, delay, error });\n            await wait(delay, signal);\n        }\n    }\n\n    throw lastError;\n}\n"],"names":["wait","ms","signal","resolve","reject","timer","retry","factory","options","retries","initialDelay","maxDelay","respectRetryAfter","shouldRetry","onRetry","attempt","lastError","error","retryAfter","delay"],"mappings":"gFAyBA,SAASA,EAAKC,EAAYC,EAAqC,CAC3D,OAAO,IAAI,QAAc,CAACC,EAASC,IAAW,CAC1C,GAAIF,GAAQ,QAAS,CACjBE,EAAO,IAAI,aAAa,UAAW,YAAY,CAAC,EAChD,MACJ,CACA,MAAMC,EAAQ,WAAWF,EAASF,CAAE,EACpCC,GAAQ,iBACJ,QACA,IAAM,CACF,aAAaG,CAAK,EAClBD,EAAO,IAAI,aAAa,UAAW,YAAY,CAAC,CACpD,EACA,CAAE,KAAM,EAAA,CAAK,CAErB,CAAC,CACL,CAUA,eAAsBE,EAASC,EAA2BC,EAAwB,GAAgB,CAC9F,KAAM,CACF,QAAAC,EAAU,EACV,aAAAC,EAAe,IACf,SAAAC,EAAW,IACX,kBAAAC,EAAoB,GACpB,YAAAC,EAAc,IAAM,GACpB,QAAAC,EACA,OAAAZ,CAAA,EACAM,EAEJ,IAAIO,EAAU,EACVC,EAEJ,KAAOD,EAAUN,GAAS,CACtB,GAAIP,GAAQ,QAAS,MAAM,IAAI,aAAa,UAAW,YAAY,EACnE,GAAI,CACA,OAAO,MAAMK,EAAA,CACjB,OAASU,EAAO,CAGZ,GAFAD,EAAYC,EACZF,GAAW,EACPA,GAAWN,GAAW,CAACI,EAAYI,EAAOF,CAAO,EACjD,MAAME,EAEV,MAAMC,EACFN,GACA,OAAQK,GAAoC,YAAe,SACpDA,EAAiC,WAAa,IAC/C,KACJE,EAEI,KAAK,IADXD,IAAe,KACAA,EACAR,EAAe,IAAMK,EAAU,GADnBJ,CAAQ,EAEvCG,IAAU,CAAE,QAAAC,EAAS,MAAAI,EAAO,MAAAF,CAAA,CAAO,EACnC,MAAMjB,EAAKmB,EAAOjB,CAAM,CAC5B,CACJ,CAEA,MAAMc,CACV"}

package/dist/http/retry.js

@@ -0,0 +1,44 @@
+function f(a, e) {
+  return new Promise((o, n) => {
+    if (e?.aborted) {
+      n(new DOMException("Aborted", "AbortError"));
+      return;
+    }
+    const i = setTimeout(o, a);
+    e?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(i), n(new DOMException("Aborted", "AbortError"));
+      },
+      { once: !0 }
+    );
+  });
+}
+async function A(a, e = {}) {
+  const {
+    retries: o = 3,
+    initialDelay: n = 300,
+    maxDelay: i = 1e4,
+    respectRetryAfter: s = !0,
+    shouldRetry: w = () => !0,
+    onRetry: b,
+    signal: c
+  } = e;
+  let t = 0, l;
+  for (; t < o; ) {
+    if (c?.aborted) throw new DOMException("Aborted", "AbortError");
+    try {
+      return await a();
+    } catch (r) {
+      if (l = r, t += 1, t >= o || !w(r, t))
+        throw r;
+      const u = s && typeof r?.retryAfter == "number" ? r.retryAfter * 1e3 : null, y = Math.min(u !== null ? u : n * 2 ** (t - 1), i);
+      b?.({ attempt: t, delay: y, error: r }), await f(y, c);
+    }
+  }
+  throw l;
+}
+export {
+  A as retry
+};
+//# sourceMappingURL=retry.js.map

package/dist/http/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sources":["../../src/http/retry.ts"],"sourcesContent":["export interface RetryOptions {\n    /** Max attempts (including the first). Default: 3. */\n    retries?: number;\n    /** Initial backoff in ms. Doubles each attempt, capped at `maxDelay`. Default: 300. */\n    initialDelay?: number;\n    /** Maximum delay between attempts. Default: 10_000. */\n    maxDelay?: number;\n    /**\n     * Honor a `Retry-After` hint on the thrown error (`error.retryAfter`, in\n     * seconds — populated by {@link createApiClient} on `429`/`503`). When\n     * present it overrides the exponential backoff for that attempt. The value\n     * is capped at `maxDelay`. Default: true.\n     */\n    respectRetryAfter?: boolean;\n    /**\n     * Return false to stop retrying for a specific error.\n     * Default: retry on any thrown error.\n     */\n    shouldRetry?: (error: unknown, attempt: number) => boolean;\n    /** Called before each retry with the upcoming delay. */\n    onRetry?: (info: { attempt: number; delay: number; error: unknown }) => void;\n    /** Cancel pending retries. */\n    signal?: AbortSignal;\n}\n\nfunction wait(ms: number, signal?: AbortSignal): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n        if (signal?.aborted) {\n            reject(new DOMException(\"Aborted\", \"AbortError\"));\n            return;\n        }\n        const timer = setTimeout(resolve, ms);\n        signal?.addEventListener(\n            \"abort\",\n            () => {\n                clearTimeout(timer);\n                reject(new DOMException(\"Aborted\", \"AbortError\"));\n            },\n            { once: true },\n        );\n    });\n}\n\n/**\n * Run `factory()` with exponential backoff. Each attempt awaits an\n * increasing delay capped at `maxDelay`. Throws the last error if every\n * attempt fails.\n *\n * @example\n * const data = await retry(() => api.get(\"/flaky\"), { retries: 5 });\n */\nexport async function retry<T>(factory: () => Promise<T>, options: RetryOptions = {}): Promise<T> {\n    const {\n        retries = 3,\n        initialDelay = 300,\n        maxDelay = 10_000,\n        respectRetryAfter = true,\n        shouldRetry = () => true,\n        onRetry,\n        signal,\n    } = options;\n\n    let attempt = 0;\n    let lastError: unknown;\n\n    while (attempt < retries) {\n        if (signal?.aborted) throw new DOMException(\"Aborted\", \"AbortError\");\n        try {\n            return await factory();\n        } catch (error) {\n            lastError = error;\n            attempt += 1;\n            if (attempt >= retries || !shouldRetry(error, attempt)) {\n                throw error;\n            }\n            const retryAfter =\n                respectRetryAfter &&\n                typeof (error as { retryAfter?: unknown })?.retryAfter === \"number\"\n                    ? (error as { retryAfter: number }).retryAfter * 1000\n                    : null;\n            const delay =\n                retryAfter !== null\n                    ? Math.min(retryAfter, maxDelay)\n                    : Math.min(initialDelay * 2 ** (attempt - 1), maxDelay);\n            onRetry?.({ attempt, delay, error });\n            await wait(delay, signal);\n        }\n    }\n\n    throw lastError;\n}\n"],"names":["wait","ms","signal","resolve","reject","timer","retry","factory","options","retries","initialDelay","maxDelay","respectRetryAfter","shouldRetry","onRetry","attempt","lastError","error","retryAfter","delay"],"mappings":"AAyBA,SAASA,EAAKC,GAAYC,GAAqC;AAC3D,SAAO,IAAI,QAAc,CAACC,GAASC,MAAW;AAC1C,QAAIF,GAAQ,SAAS;AACjB,MAAAE,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;AAChD;AAAA,IACJ;AACA,UAAMC,IAAQ,WAAWF,GAASF,CAAE;AACpC,IAAAC,GAAQ;AAAA,MACJ;AAAA,MACA,MAAM;AACF,qBAAaG,CAAK,GAClBD,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;AAAA,MACpD;AAAA,MACA,EAAE,MAAM,GAAA;AAAA,IAAK;AAAA,EAErB,CAAC;AACL;AAUA,eAAsBE,EAASC,GAA2BC,IAAwB,IAAgB;AAC9F,QAAM;AAAA,IACF,SAAAC,IAAU;AAAA,IACV,cAAAC,IAAe;AAAA,IACf,UAAAC,IAAW;AAAA,IACX,mBAAAC,IAAoB;AAAA,IACpB,aAAAC,IAAc,MAAM;AAAA,IACpB,SAAAC;AAAA,IACA,QAAAZ;AAAA,EAAA,IACAM;AAEJ,MAAIO,IAAU,GACVC;AAEJ,SAAOD,IAAUN,KAAS;AACtB,QAAIP,GAAQ,QAAS,OAAM,IAAI,aAAa,WAAW,YAAY;AACnE,QAAI;AACA,aAAO,MAAMK,EAAA;AAAA,IACjB,SAASU,GAAO;AAGZ,UAFAD,IAAYC,GACZF,KAAW,GACPA,KAAWN,KAAW,CAACI,EAAYI,GAAOF,CAAO;AACjD,cAAME;AAEV,YAAMC,IACFN,KACA,OAAQK,GAAoC,cAAe,WACpDA,EAAiC,aAAa,MAC/C,MACJE,IAEI,KAAK,IADXD,MAAe,OACAA,IACAR,IAAe,MAAMK,IAAU,IADnBJ,CAAQ;AAEvC,MAAAG,IAAU,EAAE,SAAAC,GAAS,OAAAI,GAAO,OAAAF,EAAA,CAAO,GACnC,MAAMjB,EAAKmB,GAAOjB,CAAM;AAAA,IAC5B;AAAA,EACJ;AAEA,QAAMc;AACV;"}

package/dist/http/upload-with-progress.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("./errors.cjs"),x=require("../utils/ids.cjs");function O(r){if(!r)return null;try{return JSON.parse(r)}catch{return r}}function R(r){const{url:h,body:g,method:m="POST",headers:E={},getToken:y,withCredentials:A=!1,onProgress:c,signal:o,parser:T=JSON.parse,requestId:b}=r;return new Promise((d,n)=>{if(o?.aborted){n(new DOMException("Aborted","AbortError"));return}const e=new XMLHttpRequest;e.open(m,h),e.withCredentials=A;const f=y?.(),a=b?b():x.randomId(),s={...E};f&&!("Authorization"in s)&&(s.Authorization=`Bearer ${f}`),a&&!("X-Request-ID"in s)&&(s["X-Request-ID"]=a);for(const[t,u]of Object.entries(s))e.setRequestHeader(t,u);c&&(e.upload.onprogress=t=>{c({loaded:t.loaded,total:t.total,fraction:t.lengthComputable?t.loaded/t.total:null,lengthComputable:t.lengthComputable})});function i(){e.abort()}o?.addEventListener("abort",i),e.onload=()=>{o?.removeEventListener("abort",i);const t=e.status>=200&&e.status<300,u=e.getResponseHeader("content-type")??"";if(!t){const l=O(e.responseText);n(new p.TempestApiError(p.buildApiError(e.status,l,{get:q=>e.getResponseHeader(q)},a)));return}if(e.status===204||!e.responseText){d(void 0);return}if(u.includes("application/json"))try{d(T(e.responseText))}catch(l){n(l)}else d(e.responseText)},e.onerror=()=>{o?.removeEventListener("abort",i),n(new p.TempestApiError({status:0,detail:"Falha de rede no upload.",requestId:a||void 0}))},e.onabort=()=>{o?.removeEventListener("abort",i),n(new DOMException("Aborted","AbortError"))},e.send(g)})}exports.uploadWithProgress=R;
+//# sourceMappingURL=upload-with-progress.cjs.map

package/dist/http/upload-with-progress.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-with-progress.cjs","sources":["../../src/http/upload-with-progress.ts"],"sourcesContent":["import { randomId } from \"../utils\";\nimport { buildApiError, TempestApiError } from \"./errors\";\n\nexport interface UploadProgressEvent {\n    /** Bytes already uploaded. */\n    loaded: number;\n    /** Total payload size in bytes — only meaningful when `lengthComputable` is true. */\n    total: number;\n    /** Fraction between 0 and 1, or null when total is unknown. */\n    fraction: number | null;\n    lengthComputable: boolean;\n}\n\nexport interface UploadWithProgressOptions {\n    url: string;\n    body: FormData | Blob | File;\n    method?: \"POST\" | \"PUT\" | \"PATCH\";\n    headers?: Record<string, string>;\n    /** Returns the current bearer token. */\n    getToken?: () => string | null | undefined;\n    /** Send cookies. Defaults to false. */\n    withCredentials?: boolean;\n    /** Called on every `progress` event from the XHR upload channel. */\n    onProgress?: (event: UploadProgressEvent) => void;\n    /** Abort the request. */\n    signal?: AbortSignal;\n    /** Override the JSON parser. Defaults to `JSON.parse`. */\n    parser?: (raw: string) => unknown;\n    /**\n     * Per-request correlation id sent as `X-Request-ID` (Tempest convention).\n     * Defaults to a generated id. Return an empty string to disable.\n     */\n    requestId?: () => string;\n}\n\nfunction parseErrorBody(raw: string): unknown {\n    if (!raw) return null;\n    try {\n        return JSON.parse(raw);\n    } catch {\n        return raw;\n    }\n}\n\n/**\n * Upload a file (or any payload) with byte-level progress reporting.\n *\n * `fetch` cannot report upload progress in browsers, so this helper falls\n * back to `XMLHttpRequest`. It mirrors the error contract used by\n * {@link createApiClient}: non-2xx responses reject with a `TempestApiError`.\n *\n * @returns The parsed JSON response, or the raw text when the response is not JSON.\n */\nexport function uploadWithProgress<T = unknown>(options: UploadWithProgressOptions): Promise<T> {\n    const {\n        url,\n        body,\n        method = \"POST\",\n        headers = {},\n        getToken,\n        withCredentials = false,\n        onProgress,\n        signal,\n        parser = JSON.parse,\n        requestId,\n    } = options;\n\n    return new Promise<T>((resolve, reject) => {\n        if (signal?.aborted) {\n            reject(new DOMException(\"Aborted\", \"AbortError\"));\n            return;\n        }\n\n        const xhr = new XMLHttpRequest();\n        xhr.open(method, url);\n        xhr.withCredentials = withCredentials;\n\n        const token = getToken?.();\n        const sentRequestId = requestId ? requestId() : randomId();\n        const finalHeaders: Record<string, string> = { ...headers };\n        if (token && !(\"Authorization\" in finalHeaders)) {\n            finalHeaders.Authorization = `Bearer ${token}`;\n        }\n        if (sentRequestId && !(\"X-Request-ID\" in finalHeaders)) {\n            finalHeaders[\"X-Request-ID\"] = sentRequestId;\n        }\n        for (const [key, value] of Object.entries(finalHeaders)) {\n            xhr.setRequestHeader(key, value);\n        }\n\n        if (onProgress) {\n            xhr.upload.onprogress = (event) => {\n                onProgress({\n                    loaded: event.loaded,\n                    total: event.total,\n                    fraction: event.lengthComputable ? event.loaded / event.total : null,\n                    lengthComputable: event.lengthComputable,\n                });\n            };\n        }\n\n        function handleAbort(): void {\n            xhr.abort();\n        }\n        signal?.addEventListener(\"abort\", handleAbort);\n\n        xhr.onload = () => {\n            signal?.removeEventListener(\"abort\", handleAbort);\n            const isSuccess = xhr.status >= 200 && xhr.status < 300;\n            const contentType = xhr.getResponseHeader(\"content-type\") ?? \"\";\n\n            if (!isSuccess) {\n                const errorBody = parseErrorBody(xhr.responseText);\n                reject(\n                    new TempestApiError(\n                        buildApiError(\n                            xhr.status,\n                            errorBody,\n                            { get: (name) => xhr.getResponseHeader(name) },\n                            sentRequestId,\n                        ),\n                    ),\n                );\n                return;\n            }\n\n            if (xhr.status === 204 || !xhr.responseText) {\n                resolve(undefined as T);\n                return;\n            }\n\n            if (contentType.includes(\"application/json\")) {\n                try {\n                    resolve(parser(xhr.responseText) as T);\n                } catch (err) {\n                    reject(err);\n                }\n            } else {\n                resolve(xhr.responseText as unknown as T);\n            }\n        };\n\n        xhr.onerror = () => {\n            signal?.removeEventListener(\"abort\", handleAbort);\n            reject(\n                new TempestApiError({\n                    status: 0,\n                    detail: \"Falha de rede no upload.\",\n                    requestId: sentRequestId || undefined,\n                }),\n            );\n        };\n\n        xhr.onabort = () => {\n            signal?.removeEventListener(\"abort\", handleAbort);\n            reject(new DOMException(\"Aborted\", \"AbortError\"));\n        };\n\n        xhr.send(body);\n    });\n}\n"],"names":["parseErrorBody","raw","uploadWithProgress","options","url","body","method","headers","getToken","withCredentials","onProgress","signal","parser","requestId","resolve","reject","xhr","token","sentRequestId","randomId","finalHeaders","key","value","event","handleAbort","isSuccess","contentType","errorBody","TempestApiError","buildApiError","name","err"],"mappings":"8IAmCA,SAASA,EAAeC,EAAsB,CAC1C,GAAI,CAACA,EAAK,OAAO,KACjB,GAAI,CACA,OAAO,KAAK,MAAMA,CAAG,CACzB,MAAQ,CACJ,OAAOA,CACX,CACJ,CAWO,SAASC,EAAgCC,EAAgD,CAC5F,KAAM,CACF,IAAAC,EACA,KAAAC,EACA,OAAAC,EAAS,OACT,QAAAC,EAAU,CAAA,EACV,SAAAC,EACA,gBAAAC,EAAkB,GAClB,WAAAC,EACA,OAAAC,EACA,OAAAC,EAAS,KAAK,MACd,UAAAC,CAAA,EACAV,EAEJ,OAAO,IAAI,QAAW,CAACW,EAASC,IAAW,CACvC,GAAIJ,GAAQ,QAAS,CACjBI,EAAO,IAAI,aAAa,UAAW,YAAY,CAAC,EAChD,MACJ,CAEA,MAAMC,EAAM,IAAI,eAChBA,EAAI,KAAKV,EAAQF,CAAG,EACpBY,EAAI,gBAAkBP,EAEtB,MAAMQ,EAAQT,IAAA,EACRU,EAAgBL,EAAYA,EAAA,EAAcM,EAAAA,SAAA,EAC1CC,EAAuC,CAAE,GAAGb,CAAA,EAC9CU,GAAS,EAAE,kBAAmBG,KAC9BA,EAAa,cAAgB,UAAUH,CAAK,IAE5CC,GAAiB,EAAE,iBAAkBE,KACrCA,EAAa,cAAc,EAAIF,GAEnC,SAAW,CAACG,EAAKC,CAAK,IAAK,OAAO,QAAQF,CAAY,EAClDJ,EAAI,iBAAiBK,EAAKC,CAAK,EAG/BZ,IACAM,EAAI,OAAO,WAAcO,GAAU,CAC/Bb,EAAW,CACP,OAAQa,EAAM,OACd,MAAOA,EAAM,MACb,SAAUA,EAAM,iBAAmBA,EAAM,OAASA,EAAM,MAAQ,KAChE,iBAAkBA,EAAM,gBAAA,CAC3B,CACL,GAGJ,SAASC,GAAoB,CACzBR,EAAI,MAAA,CACR,CACAL,GAAQ,iBAAiB,QAASa,CAAW,EAE7CR,EAAI,OAAS,IAAM,CACfL,GAAQ,oBAAoB,QAASa,CAAW,EAChD,MAAMC,EAAYT,EAAI,QAAU,KAAOA,EAAI,OAAS,IAC9CU,EAAcV,EAAI,kBAAkB,cAAc,GAAK,GAE7D,GAAI,CAACS,EAAW,CACZ,MAAME,EAAY3B,EAAegB,EAAI,YAAY,EACjDD,EACI,IAAIa,EAAAA,gBACAC,EAAAA,cACIb,EAAI,OACJW,EACA,CAAE,IAAMG,GAASd,EAAI,kBAAkBc,CAAI,CAAA,EAC3CZ,CAAA,CACJ,CACJ,EAEJ,MACJ,CAEA,GAAIF,EAAI,SAAW,KAAO,CAACA,EAAI,aAAc,CACzCF,EAAQ,MAAc,EACtB,MACJ,CAEA,GAAIY,EAAY,SAAS,kBAAkB,EACvC,GAAI,CACAZ,EAAQF,EAAOI,EAAI,YAAY,CAAM,CACzC,OAASe,EAAK,CACVhB,EAAOgB,CAAG,CACd,MAEAjB,EAAQE,EAAI,YAA4B,CAEhD,EAEAA,EAAI,QAAU,IAAM,CAChBL,GAAQ,oBAAoB,QAASa,CAAW,EAChDT,EACI,IAAIa,kBAAgB,CAChB,OAAQ,EACR,OAAQ,2BACR,UAAWV,GAAiB,MAAA,CAC/B,CAAA,CAET,EAEAF,EAAI,QAAU,IAAM,CAChBL,GAAQ,oBAAoB,QAASa,CAAW,EAChDT,EAAO,IAAI,aAAa,UAAW,YAAY,CAAC,CACpD,EAEAC,EAAI,KAAKX,CAAI,CACjB,CAAC,CACL"}

package/dist/http/upload-with-progress.js

@@ -0,0 +1,91 @@
+import { TempestApiError as f, buildApiError as q } from "./errors.js";
+import { randomId as R } from "../utils/ids.js";
+function w(r) {
+  if (!r) return null;
+  try {
+    return JSON.parse(r);
+  } catch {
+    return r;
+  }
+}
+function C(r) {
+  const {
+    url: h,
+    body: m,
+    method: g = "POST",
+    headers: E = {},
+    getToken: A,
+    withCredentials: x = !1,
+    onProgress: p,
+    signal: o,
+    parser: y = JSON.parse,
+    requestId: c
+  } = r;
+  return new Promise((d, n) => {
+    if (o?.aborted) {
+      n(new DOMException("Aborted", "AbortError"));
+      return;
+    }
+    const e = new XMLHttpRequest();
+    e.open(g, h), e.withCredentials = x;
+    const b = A?.(), a = c ? c() : R(), s = { ...E };
+    b && !("Authorization" in s) && (s.Authorization = `Bearer ${b}`), a && !("X-Request-ID" in s) && (s["X-Request-ID"] = a);
+    for (const [t, u] of Object.entries(s))
+      e.setRequestHeader(t, u);
+    p && (e.upload.onprogress = (t) => {
+      p({
+        loaded: t.loaded,
+        total: t.total,
+        fraction: t.lengthComputable ? t.loaded / t.total : null,
+        lengthComputable: t.lengthComputable
+      });
+    });
+    function i() {
+      e.abort();
+    }
+    o?.addEventListener("abort", i), e.onload = () => {
+      o?.removeEventListener("abort", i);
+      const t = e.status >= 200 && e.status < 300, u = e.getResponseHeader("content-type") ?? "";
+      if (!t) {
+        const l = w(e.responseText);
+        n(
+          new f(
+            q(
+              e.status,
+              l,
+              { get: (T) => e.getResponseHeader(T) },
+              a
+            )
+          )
+        );
+        return;
+      }
+      if (e.status === 204 || !e.responseText) {
+        d(void 0);
+        return;
+      }
+      if (u.includes("application/json"))
+        try {
+          d(y(e.responseText));
+        } catch (l) {
+          n(l);
+        }
+      else
+        d(e.responseText);
+    }, e.onerror = () => {
+      o?.removeEventListener("abort", i), n(
+        new f({
+          status: 0,
+          detail: "Falha de rede no upload.",
+          requestId: a || void 0
+        })
+      );
+    }, e.onabort = () => {
+      o?.removeEventListener("abort", i), n(new DOMException("Aborted", "AbortError"));
+    }, e.send(m);
+  });
+}
+export {
+  C as uploadWithProgress
+};
+//# sourceMappingURL=upload-with-progress.js.map

package/dist/http/upload-with-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-with-progress.js","sources":["../../src/http/upload-with-progress.ts"],"sourcesContent":["import { randomId } from \"../utils\";\nimport { buildApiError, TempestApiError } from \"./errors\";\n\nexport interface UploadProgressEvent {\n    /** Bytes already uploaded. */\n    loaded: number;\n    /** Total payload size in bytes — only meaningful when `lengthComputable` is true. */\n    total: number;\n    /** Fraction between 0 and 1, or null when total is unknown. */\n    fraction: number | null;\n    lengthComputable: boolean;\n}\n\nexport interface UploadWithProgressOptions {\n    url: string;\n    body: FormData | Blob | File;\n    method?: \"POST\" | \"PUT\" | \"PATCH\";\n    headers?: Record<string, string>;\n    /** Returns the current bearer token. */\n    getToken?: () => string | null | undefined;\n    /** Send cookies. Defaults to false. */\n    withCredentials?: boolean;\n    /** Called on every `progress` event from the XHR upload channel. */\n    onProgress?: (event: UploadProgressEvent) => void;\n    /** Abort the request. */\n    signal?: AbortSignal;\n    /** Override the JSON parser. Defaults to `JSON.parse`. */\n    parser?: (raw: string) => unknown;\n    /**\n     * Per-request correlation id sent as `X-Request-ID` (Tempest convention).\n     * Defaults to a generated id. Return an empty string to disable.\n     */\n    requestId?: () => string;\n}\n\nfunction parseErrorBody(raw: string): unknown {\n    if (!raw) return null;\n    try {\n        return JSON.parse(raw);\n    } catch {\n        return raw;\n    }\n}\n\n/**\n * Upload a file (or any payload) with byte-level progress reporting.\n *\n * `fetch` cannot report upload progress in browsers, so this helper falls\n * back to `XMLHttpRequest`. It mirrors the error contract used by\n * {@link createApiClient}: non-2xx responses reject with a `TempestApiError`.\n *\n * @returns The parsed JSON response, or the raw text when the response is not JSON.\n */\nexport function uploadWithProgress<T = unknown>(options: UploadWithProgressOptions): Promise<T> {\n    const {\n        url,\n        body,\n        method = \"POST\",\n        headers = {},\n        getToken,\n        withCredentials = false,\n        onProgress,\n        signal,\n        parser = JSON.parse,\n        requestId,\n    } = options;\n\n    return new Promise<T>((resolve, reject) => {\n        if (signal?.aborted) {\n            reject(new DOMException(\"Aborted\", \"AbortError\"));\n            return;\n        }\n\n        const xhr = new XMLHttpRequest();\n        xhr.open(method, url);\n        xhr.withCredentials = withCredentials;\n\n        const token = getToken?.();\n        const sentRequestId = requestId ? requestId() : randomId();\n        const finalHeaders: Record<string, string> = { ...headers };\n        if (token && !(\"Authorization\" in finalHeaders)) {\n            finalHeaders.Authorization = `Bearer ${token}`;\n        }\n        if (sentRequestId && !(\"X-Request-ID\" in finalHeaders)) {\n            finalHeaders[\"X-Request-ID\"] = sentRequestId;\n        }\n        for (const [key, value] of Object.entries(finalHeaders)) {\n            xhr.setRequestHeader(key, value);\n        }\n\n        if (onProgress) {\n            xhr.upload.onprogress = (event) => {\n                onProgress({\n                    loaded: event.loaded,\n                    total: event.total,\n                    fraction: event.lengthComputable ? event.loaded / event.total : null,\n                    lengthComputable: event.lengthComputable,\n                });\n            };\n        }\n\n        function handleAbort(): void {\n            xhr.abort();\n        }\n        signal?.addEventListener(\"abort\", handleAbort);\n\n        xhr.onload = () => {\n            signal?.removeEventListener(\"abort\", handleAbort);\n            const isSuccess = xhr.status >= 200 && xhr.status < 300;\n            const contentType = xhr.getResponseHeader(\"content-type\") ?? \"\";\n\n            if (!isSuccess) {\n                const errorBody = parseErrorBody(xhr.responseText);\n                reject(\n                    new TempestApiError(\n                        buildApiError(\n                            xhr.status,\n                            errorBody,\n                            { get: (name) => xhr.getResponseHeader(name) },\n                            sentRequestId,\n                        ),\n                    ),\n                );\n                return;\n            }\n\n            if (xhr.status === 204 || !xhr.responseText) {\n                resolve(undefined as T);\n                return;\n            }\n\n            if (contentType.includes(\"application/json\")) {\n                try {\n                    resolve(parser(xhr.responseText) as T);\n                } catch (err) {\n                    reject(err);\n                }\n            } else {\n                resolve(xhr.responseText as unknown as T);\n            }\n        };\n\n        xhr.onerror = () => {\n            signal?.removeEventListener(\"abort\", handleAbort);\n            reject(\n                new TempestApiError({\n                    status: 0,\n                    detail: \"Falha de rede no upload.\",\n                    requestId: sentRequestId || undefined,\n                }),\n            );\n        };\n\n        xhr.onabort = () => {\n            signal?.removeEventListener(\"abort\", handleAbort);\n            reject(new DOMException(\"Aborted\", \"AbortError\"));\n        };\n\n        xhr.send(body);\n    });\n}\n"],"names":["parseErrorBody","raw","uploadWithProgress","options","url","body","method","headers","getToken","withCredentials","onProgress","signal","parser","requestId","resolve","reject","xhr","token","sentRequestId","randomId","finalHeaders","key","value","event","handleAbort","isSuccess","contentType","errorBody","TempestApiError","buildApiError","name","err"],"mappings":";;AAmCA,SAASA,EAAeC,GAAsB;AAC1C,MAAI,CAACA,EAAK,QAAO;AACjB,MAAI;AACA,WAAO,KAAK,MAAMA,CAAG;AAAA,EACzB,QAAQ;AACJ,WAAOA;AAAA,EACX;AACJ;AAWO,SAASC,EAAgCC,GAAgD;AAC5F,QAAM;AAAA,IACF,KAAAC;AAAA,IACA,MAAAC;AAAA,IACA,QAAAC,IAAS;AAAA,IACT,SAAAC,IAAU,CAAA;AAAA,IACV,UAAAC;AAAA,IACA,iBAAAC,IAAkB;AAAA,IAClB,YAAAC;AAAA,IACA,QAAAC;AAAA,IACA,QAAAC,IAAS,KAAK;AAAA,IACd,WAAAC;AAAA,EAAA,IACAV;AAEJ,SAAO,IAAI,QAAW,CAACW,GAASC,MAAW;AACvC,QAAIJ,GAAQ,SAAS;AACjB,MAAAI,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;AAChD;AAAA,IACJ;AAEA,UAAMC,IAAM,IAAI,eAAA;AAChB,IAAAA,EAAI,KAAKV,GAAQF,CAAG,GACpBY,EAAI,kBAAkBP;AAEtB,UAAMQ,IAAQT,IAAA,GACRU,IAAgBL,IAAYA,EAAA,IAAcM,EAAA,GAC1CC,IAAuC,EAAE,GAAGb,EAAA;AAClD,IAAIU,KAAS,EAAE,mBAAmBG,OAC9BA,EAAa,gBAAgB,UAAUH,CAAK,KAE5CC,KAAiB,EAAE,kBAAkBE,OACrCA,EAAa,cAAc,IAAIF;AAEnC,eAAW,CAACG,GAAKC,CAAK,KAAK,OAAO,QAAQF,CAAY;AAClD,MAAAJ,EAAI,iBAAiBK,GAAKC,CAAK;AAGnC,IAAIZ,MACAM,EAAI,OAAO,aAAa,CAACO,MAAU;AAC/B,MAAAb,EAAW;AAAA,QACP,QAAQa,EAAM;AAAA,QACd,OAAOA,EAAM;AAAA,QACb,UAAUA,EAAM,mBAAmBA,EAAM,SAASA,EAAM,QAAQ;AAAA,QAChE,kBAAkBA,EAAM;AAAA,MAAA,CAC3B;AAAA,IACL;AAGJ,aAASC,IAAoB;AACzB,MAAAR,EAAI,MAAA;AAAA,IACR;AACA,IAAAL,GAAQ,iBAAiB,SAASa,CAAW,GAE7CR,EAAI,SAAS,MAAM;AACf,MAAAL,GAAQ,oBAAoB,SAASa,CAAW;AAChD,YAAMC,IAAYT,EAAI,UAAU,OAAOA,EAAI,SAAS,KAC9CU,IAAcV,EAAI,kBAAkB,cAAc,KAAK;AAE7D,UAAI,CAACS,GAAW;AACZ,cAAME,IAAY3B,EAAegB,EAAI,YAAY;AACjD,QAAAD;AAAA,UACI,IAAIa;AAAA,YACAC;AAAA,cACIb,EAAI;AAAA,cACJW;AAAA,cACA,EAAE,KAAK,CAACG,MAASd,EAAI,kBAAkBc,CAAI,EAAA;AAAA,cAC3CZ;AAAA,YAAA;AAAA,UACJ;AAAA,QACJ;AAEJ;AAAA,MACJ;AAEA,UAAIF,EAAI,WAAW,OAAO,CAACA,EAAI,cAAc;AACzC,QAAAF,EAAQ,MAAc;AACtB;AAAA,MACJ;AAEA,UAAIY,EAAY,SAAS,kBAAkB;AACvC,YAAI;AACA,UAAAZ,EAAQF,EAAOI,EAAI,YAAY,CAAM;AAAA,QACzC,SAASe,GAAK;AACV,UAAAhB,EAAOgB,CAAG;AAAA,QACd;AAAA;AAEA,QAAAjB,EAAQE,EAAI,YAA4B;AAAA,IAEhD,GAEAA,EAAI,UAAU,MAAM;AAChB,MAAAL,GAAQ,oBAAoB,SAASa,CAAW,GAChDT;AAAA,QACI,IAAIa,EAAgB;AAAA,UAChB,QAAQ;AAAA,UACR,QAAQ;AAAA,UACR,WAAWV,KAAiB;AAAA,QAAA,CAC/B;AAAA,MAAA;AAAA,IAET,GAEAF,EAAI,UAAU,MAAM;AAChB,MAAAL,GAAQ,oBAAoB,SAASa,CAAW,GAChDT,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;AAAA,IACpD,GAEAC,EAAI,KAAKX,CAAI;AAAA,EACjB,CAAC;AACL;"}

package/dist/http/use-poll.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react");function T(a,f){const{interval:i,disabled:n=!1,stopWhen:d,onError:m}=f,[g,p]=t.useState(null),[y,o]=t.useState(null),[S,l]=t.useState(!n),r=t.useRef(n),c=t.useRef(!1),e=t.useRef(null);async function s(){if(!(r.current||c.current)){c.current=!0;try{const u=await a();if(r.current)return;p(u),o(null),d?.(u)&&(r.current=!0)}catch(u){r.current||(o(u),m?.(u))}finally{c.current=!1,l(!1),r.current||(e.current=setTimeout(s,i))}}}return t.useEffect(()=>{if(r.current=n,n){e.current&&clearTimeout(e.current);return}return l(!0),s(),()=>{r.current=!0,e.current&&clearTimeout(e.current)}},[i,n]),{data:g,error:y,loading:S,stop:()=>{r.current=!0,e.current&&clearTimeout(e.current)},start:()=>{r.current&&(r.current=!1,s())}}}exports.usePoll=T;
+//# sourceMappingURL=use-poll.cjs.map

package/dist/http/use-poll.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-poll.cjs","sources":["../../src/http/use-poll.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\nexport interface UsePollOptions<T> {\n    /** Polling interval in ms. */\n    interval: number;\n    /** Disable polling without unmounting. Default: false. */\n    disabled?: boolean;\n    /** Stop polling once the predicate returns true. */\n    stopWhen?: (data: T) => boolean;\n    /** Called on each error. */\n    onError?: (error: unknown) => void;\n}\n\nexport interface UsePollResult<T> {\n    data: T | null;\n    error: unknown;\n    loading: boolean;\n    stop: () => void;\n    start: () => void;\n}\n\n/**\n * Poll an async factory on a fixed interval. Skips overlapping requests if a\n * prior call has not finished. Pause via `disabled` or `stopWhen`.\n */\nexport function usePoll<T>(\n    factory: () => Promise<T>,\n    options: UsePollOptions<T>,\n): UsePollResult<T> {\n    const { interval, disabled = false, stopWhen, onError } = options;\n    const [data, setData] = useState<T | null>(null);\n    const [error, setError] = useState<unknown>(null);\n    const [loading, setLoading] = useState<boolean>(!disabled);\n    const stopped = useRef<boolean>(disabled);\n    const inFlight = useRef<boolean>(false);\n    const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    async function tick(): Promise<void> {\n        if (stopped.current || inFlight.current) return;\n        inFlight.current = true;\n        try {\n            const next = await factory();\n            if (stopped.current) return;\n            setData(next);\n            setError(null);\n            if (stopWhen?.(next)) stopped.current = true;\n        } catch (err) {\n            if (!stopped.current) {\n                setError(err);\n                onError?.(err);\n            }\n        } finally {\n            inFlight.current = false;\n            setLoading(false);\n            if (!stopped.current) {\n                timer.current = setTimeout(tick, interval);\n            }\n        }\n    }\n\n    useEffect(() => {\n        stopped.current = disabled;\n        if (disabled) {\n            if (timer.current) clearTimeout(timer.current);\n            return;\n        }\n        setLoading(true);\n        void tick();\n        return () => {\n            stopped.current = true;\n            if (timer.current) clearTimeout(timer.current);\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [interval, disabled]);\n\n    return {\n        data,\n        error,\n        loading,\n        stop: () => {\n            stopped.current = true;\n            if (timer.current) clearTimeout(timer.current);\n        },\n        start: () => {\n            if (!stopped.current) return;\n            stopped.current = false;\n            void tick();\n        },\n    };\n}\n"],"names":["usePoll","factory","options","interval","disabled","stopWhen","onError","data","setData","useState","error","setError","loading","setLoading","stopped","useRef","inFlight","timer","tick","next","err","useEffect"],"mappings":"yGAyBO,SAASA,EACZC,EACAC,EACgB,CAChB,KAAM,CAAE,SAAAC,EAAU,SAAAC,EAAW,GAAO,SAAAC,EAAU,QAAAC,GAAYJ,EACpD,CAACK,EAAMC,CAAO,EAAIC,EAAAA,SAAmB,IAAI,EACzC,CAACC,EAAOC,CAAQ,EAAIF,EAAAA,SAAkB,IAAI,EAC1C,CAACG,EAASC,CAAU,EAAIJ,EAAAA,SAAkB,CAACL,CAAQ,EACnDU,EAAUC,EAAAA,OAAgBX,CAAQ,EAClCY,EAAWD,EAAAA,OAAgB,EAAK,EAChCE,EAAQF,EAAAA,OAA6C,IAAI,EAE/D,eAAeG,GAAsB,CACjC,GAAI,EAAAJ,EAAQ,SAAWE,EAAS,SAChC,CAAAA,EAAS,QAAU,GACnB,GAAI,CACA,MAAMG,EAAO,MAAMlB,EAAA,EACnB,GAAIa,EAAQ,QAAS,OACrBN,EAAQW,CAAI,EACZR,EAAS,IAAI,EACTN,IAAWc,CAAI,IAAGL,EAAQ,QAAU,GAC5C,OAASM,EAAK,CACLN,EAAQ,UACTH,EAASS,CAAG,EACZd,IAAUc,CAAG,EAErB,QAAA,CACIJ,EAAS,QAAU,GACnBH,EAAW,EAAK,EACXC,EAAQ,UACTG,EAAM,QAAU,WAAWC,EAAMf,CAAQ,EAEjD,EACJ,CAEAkB,OAAAA,EAAAA,UAAU,IAAM,CAEZ,GADAP,EAAQ,QAAUV,EACdA,EAAU,CACNa,EAAM,SAAS,aAAaA,EAAM,OAAO,EAC7C,MACJ,CACA,OAAAJ,EAAW,EAAI,EACVK,EAAA,EACE,IAAM,CACTJ,EAAQ,QAAU,GACdG,EAAM,SAAS,aAAaA,EAAM,OAAO,CACjD,CAEJ,EAAG,CAACd,EAAUC,CAAQ,CAAC,EAEhB,CACH,KAAAG,EACA,MAAAG,EACA,QAAAE,EACA,KAAM,IAAM,CACRE,EAAQ,QAAU,GACdG,EAAM,SAAS,aAAaA,EAAM,OAAO,CACjD,EACA,MAAO,IAAM,CACJH,EAAQ,UACbA,EAAQ,QAAU,GACbI,EAAA,EACT,CAAA,CAER"}

package/dist/http/use-poll.js

@@ -0,0 +1,41 @@
+import { useState as i, useRef as o, useEffect as y } from "react";
+function x(f, d) {
+  const { interval: s, disabled: e = !1, stopWhen: m, onError: p } = d, [T, g] = i(null), [h, l] = i(null), [v, a] = i(!e), r = o(e), u = o(!1), t = o(null);
+  async function c() {
+    if (!(r.current || u.current)) {
+      u.current = !0;
+      try {
+        const n = await f();
+        if (r.current) return;
+        g(n), l(null), m?.(n) && (r.current = !0);
+      } catch (n) {
+        r.current || (l(n), p?.(n));
+      } finally {
+        u.current = !1, a(!1), r.current || (t.current = setTimeout(c, s));
+      }
+    }
+  }
+  return y(() => {
+    if (r.current = e, e) {
+      t.current && clearTimeout(t.current);
+      return;
+    }
+    return a(!0), c(), () => {
+      r.current = !0, t.current && clearTimeout(t.current);
+    };
+  }, [s, e]), {
+    data: T,
+    error: h,
+    loading: v,
+    stop: () => {
+      r.current = !0, t.current && clearTimeout(t.current);
+    },
+    start: () => {
+      r.current && (r.current = !1, c());
+    }
+  };
+}
+export {
+  x as usePoll
+};
+//# sourceMappingURL=use-poll.js.map

package/dist/http/use-poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-poll.js","sources":["../../src/http/use-poll.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\nexport interface UsePollOptions<T> {\n    /** Polling interval in ms. */\n    interval: number;\n    /** Disable polling without unmounting. Default: false. */\n    disabled?: boolean;\n    /** Stop polling once the predicate returns true. */\n    stopWhen?: (data: T) => boolean;\n    /** Called on each error. */\n    onError?: (error: unknown) => void;\n}\n\nexport interface UsePollResult<T> {\n    data: T | null;\n    error: unknown;\n    loading: boolean;\n    stop: () => void;\n    start: () => void;\n}\n\n/**\n * Poll an async factory on a fixed interval. Skips overlapping requests if a\n * prior call has not finished. Pause via `disabled` or `stopWhen`.\n */\nexport function usePoll<T>(\n    factory: () => Promise<T>,\n    options: UsePollOptions<T>,\n): UsePollResult<T> {\n    const { interval, disabled = false, stopWhen, onError } = options;\n    const [data, setData] = useState<T | null>(null);\n    const [error, setError] = useState<unknown>(null);\n    const [loading, setLoading] = useState<boolean>(!disabled);\n    const stopped = useRef<boolean>(disabled);\n    const inFlight = useRef<boolean>(false);\n    const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    async function tick(): Promise<void> {\n        if (stopped.current || inFlight.current) return;\n        inFlight.current = true;\n        try {\n            const next = await factory();\n            if (stopped.current) return;\n            setData(next);\n            setError(null);\n            if (stopWhen?.(next)) stopped.current = true;\n        } catch (err) {\n            if (!stopped.current) {\n                setError(err);\n                onError?.(err);\n            }\n        } finally {\n            inFlight.current = false;\n            setLoading(false);\n            if (!stopped.current) {\n                timer.current = setTimeout(tick, interval);\n            }\n        }\n    }\n\n    useEffect(() => {\n        stopped.current = disabled;\n        if (disabled) {\n            if (timer.current) clearTimeout(timer.current);\n            return;\n        }\n        setLoading(true);\n        void tick();\n        return () => {\n            stopped.current = true;\n            if (timer.current) clearTimeout(timer.current);\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [interval, disabled]);\n\n    return {\n        data,\n        error,\n        loading,\n        stop: () => {\n            stopped.current = true;\n            if (timer.current) clearTimeout(timer.current);\n        },\n        start: () => {\n            if (!stopped.current) return;\n            stopped.current = false;\n            void tick();\n        },\n    };\n}\n"],"names":["usePoll","factory","options","interval","disabled","stopWhen","onError","data","setData","useState","error","setError","loading","setLoading","stopped","useRef","inFlight","timer","tick","next","err","useEffect"],"mappings":";AAyBO,SAASA,EACZC,GACAC,GACgB;AAChB,QAAM,EAAE,UAAAC,GAAU,UAAAC,IAAW,IAAO,UAAAC,GAAU,SAAAC,MAAYJ,GACpD,CAACK,GAAMC,CAAO,IAAIC,EAAmB,IAAI,GACzC,CAACC,GAAOC,CAAQ,IAAIF,EAAkB,IAAI,GAC1C,CAACG,GAASC,CAAU,IAAIJ,EAAkB,CAACL,CAAQ,GACnDU,IAAUC,EAAgBX,CAAQ,GAClCY,IAAWD,EAAgB,EAAK,GAChCE,IAAQF,EAA6C,IAAI;AAE/D,iBAAeG,IAAsB;AACjC,QAAI,EAAAJ,EAAQ,WAAWE,EAAS,UAChC;AAAA,MAAAA,EAAS,UAAU;AACnB,UAAI;AACA,cAAMG,IAAO,MAAMlB,EAAA;AACnB,YAAIa,EAAQ,QAAS;AACrB,QAAAN,EAAQW,CAAI,GACZR,EAAS,IAAI,GACTN,IAAWc,CAAI,MAAGL,EAAQ,UAAU;AAAA,MAC5C,SAASM,GAAK;AACV,QAAKN,EAAQ,YACTH,EAASS,CAAG,GACZd,IAAUc,CAAG;AAAA,MAErB,UAAA;AACI,QAAAJ,EAAS,UAAU,IACnBH,EAAW,EAAK,GACXC,EAAQ,YACTG,EAAM,UAAU,WAAWC,GAAMf,CAAQ;AAAA,MAEjD;AAAA;AAAA,EACJ;AAEA,SAAAkB,EAAU,MAAM;AAEZ,QADAP,EAAQ,UAAUV,GACdA,GAAU;AACV,MAAIa,EAAM,WAAS,aAAaA,EAAM,OAAO;AAC7C;AAAA,IACJ;AACA,WAAAJ,EAAW,EAAI,GACVK,EAAA,GACE,MAAM;AACT,MAAAJ,EAAQ,UAAU,IACdG,EAAM,WAAS,aAAaA,EAAM,OAAO;AAAA,IACjD;AAAA,EAEJ,GAAG,CAACd,GAAUC,CAAQ,CAAC,GAEhB;AAAA,IACH,MAAAG;AAAA,IACA,OAAAG;AAAA,IACA,SAAAE;AAAA,IACA,MAAM,MAAM;AACR,MAAAE,EAAQ,UAAU,IACdG,EAAM,WAAS,aAAaA,EAAM,OAAO;AAAA,IACjD;AAAA,IACA,OAAO,MAAM;AACT,MAAKH,EAAQ,YACbA,EAAQ,UAAU,IACbI,EAAA;AAAA,IACT;AAAA,EAAA;AAER;"}

package/dist/i18n/I18nProvider.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const w=require("react/jsx-runtime"),t=require("react"),m=require("./create-i18n.cjs"),a=t.createContext(null);function v(e,c){if(!e||typeof window>"u")return null;try{const n=window.localStorage.getItem(e);return n&&c.includes(n)?n:null}catch{return null}}function S({children:e,locale:c,fallbackLocale:n,messages:r,storageKey:o="tempest-locale"}){const i=t.useMemo(()=>Object.keys(r),[r]),[u,f]=t.useState(()=>v(o,i)??c);t.useEffect(()=>{typeof document<"u"&&document.documentElement.setAttribute("lang",u)},[u]);const s=t.useCallback(l=>{if(f(l),o&&typeof window<"u")try{window.localStorage.setItem(o,l)}catch{}},[o]),I=t.useMemo(()=>({...m.createI18n({locale:u,fallbackLocale:n,messages:r}),setLocale:s,availableLocales:i}),[u,n,r,s,i]);return w.jsx(a.Provider,{value:I,children:e})}function d(){const e=t.useContext(a);if(!e)throw new Error("useI18n must be used inside an <I18nProvider>");return e}function b(){return d().t}exports.I18nProvider=S;exports.useI18n=d;exports.useTranslate=b;
+//# sourceMappingURL=I18nProvider.cjs.map

package/dist/i18n/I18nProvider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18nProvider.cjs","sources":["../../src/i18n/I18nProvider.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { createI18n, type Catalog, type I18n } from \"./create-i18n\";\n\nexport interface I18nContextValue extends I18n {\n    /** Switch the active locale. Persisted when `storageKey` is set. */\n    setLocale: (locale: string) => void;\n    /** Locales available in the catalog. */\n    availableLocales: string[];\n}\n\nconst I18nContext = createContext<I18nContextValue | null>(null);\n\nexport interface I18nProviderProps {\n    children: ReactNode;\n    /** Initial locale. */\n    locale: string;\n    /** Fallback locale used when a key is missing. */\n    fallbackLocale?: string;\n    /** Translation catalog. */\n    messages: Catalog;\n    /** localStorage key for persisting the user choice. Pass `null` to disable. Default: `\"tempest-locale\"`. */\n    storageKey?: string | null;\n}\n\nfunction readStored(storageKey: string | null, available: string[]): string | null {\n    if (!storageKey || typeof window === \"undefined\") return null;\n    try {\n        const value = window.localStorage.getItem(storageKey);\n        if (value && available.includes(value)) return value;\n        return null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * React provider for the SDK's lightweight i18n. Exposes the translation\n * helpers and a `setLocale` setter to children.\n */\nexport function I18nProvider({\n    children,\n    locale: initialLocale,\n    fallbackLocale,\n    messages,\n    storageKey = \"tempest-locale\",\n}: I18nProviderProps) {\n    const availableLocales = useMemo(() => Object.keys(messages), [messages]);\n    const [locale, setLocaleState] = useState<string>(\n        () => readStored(storageKey, availableLocales) ?? initialLocale,\n    );\n\n    useEffect(() => {\n        if (typeof document !== \"undefined\") {\n            document.documentElement.setAttribute(\"lang\", locale);\n        }\n    }, [locale]);\n\n    const setLocale = useCallback(\n        (next: string) => {\n            setLocaleState(next);\n            if (storageKey && typeof window !== \"undefined\") {\n                try {\n                    window.localStorage.setItem(storageKey, next);\n                } catch {\n                    /* ignore quota errors */\n                }\n            }\n        },\n        [storageKey],\n    );\n\n    const value = useMemo<I18nContextValue>(() => {\n        const i18n = createI18n({ locale, fallbackLocale, messages });\n        return { ...i18n, setLocale, availableLocales };\n    }, [locale, fallbackLocale, messages, setLocale, availableLocales]);\n\n    return <I18nContext.Provider value={value}>{children}</I18nContext.Provider>;\n}\n\n/**\n * Access translation helpers. Must be used inside an {@link I18nProvider}.\n */\nexport function useI18n(): I18nContextValue {\n    const ctx = useContext(I18nContext);\n    if (!ctx) throw new Error(\"useI18n must be used inside an <I18nProvider>\");\n    return ctx;\n}\n\n/**\n * Shortcut for components that only need the `t` function — avoids destructuring.\n */\nexport function useTranslate(): I18nContextValue[\"t\"] {\n    return useI18n().t;\n}\n"],"names":["I18nContext","createContext","readStored","storageKey","available","value","I18nProvider","children","initialLocale","fallbackLocale","messages","availableLocales","useMemo","locale","setLocaleState","useState","useEffect","setLocale","useCallback","next","createI18n","jsx","useI18n","ctx","useContext","useTranslate"],"mappings":"uKAWMA,EAAcC,EAAAA,cAAuC,IAAI,EAc/D,SAASC,EAAWC,EAA2BC,EAAoC,CAC/E,GAAI,CAACD,GAAc,OAAO,OAAW,IAAa,OAAO,KACzD,GAAI,CACA,MAAME,EAAQ,OAAO,aAAa,QAAQF,CAAU,EACpD,OAAIE,GAASD,EAAU,SAASC,CAAK,EAAUA,EACxC,IACX,MAAQ,CACJ,OAAO,IACX,CACJ,CAMO,SAASC,EAAa,CACzB,SAAAC,EACA,OAAQC,EACR,eAAAC,EACA,SAAAC,EACA,WAAAP,EAAa,gBACjB,EAAsB,CAClB,MAAMQ,EAAmBC,EAAAA,QAAQ,IAAM,OAAO,KAAKF,CAAQ,EAAG,CAACA,CAAQ,CAAC,EAClE,CAACG,EAAQC,CAAc,EAAIC,EAAAA,SAC7B,IAAMb,EAAWC,EAAYQ,CAAgB,GAAKH,CAAA,EAGtDQ,EAAAA,UAAU,IAAM,CACR,OAAO,SAAa,KACpB,SAAS,gBAAgB,aAAa,OAAQH,CAAM,CAE5D,EAAG,CAACA,CAAM,CAAC,EAEX,MAAMI,EAAYC,EAAAA,YACbC,GAAiB,CAEd,GADAL,EAAeK,CAAI,EACfhB,GAAc,OAAO,OAAW,IAChC,GAAI,CACA,OAAO,aAAa,QAAQA,EAAYgB,CAAI,CAChD,MAAQ,CAER,CAER,EACA,CAAChB,CAAU,CAAA,EAGTE,EAAQO,EAAAA,QAA0B,KAE7B,CAAE,GADIQ,EAAAA,WAAW,CAAE,OAAAP,EAAQ,eAAAJ,EAAgB,SAAAC,EAAU,EAC1C,UAAAO,EAAW,iBAAAN,CAAA,GAC9B,CAACE,EAAQJ,EAAgBC,EAAUO,EAAWN,CAAgB,CAAC,EAElE,OAAOU,EAAAA,IAACrB,EAAY,SAAZ,CAAqB,MAAAK,EAAe,SAAAE,CAAA,CAAS,CACzD,CAKO,SAASe,GAA4B,CACxC,MAAMC,EAAMC,EAAAA,WAAWxB,CAAW,EAClC,GAAI,CAACuB,EAAK,MAAM,IAAI,MAAM,+CAA+C,EACzE,OAAOA,CACX,CAKO,SAASE,GAAsC,CAClD,OAAOH,IAAU,CACrB"}

package/dist/i18n/I18nProvider.js

@@ -0,0 +1,52 @@
+import { jsx as m } from "react/jsx-runtime";
+import { useMemo as d, useState as w, useEffect as p, useCallback as I, useContext as v, createContext as x } from "react";
+import { createI18n as S } from "./create-i18n.js";
+const f = x(null);
+function b(t, u) {
+  if (!t || typeof window > "u") return null;
+  try {
+    const e = window.localStorage.getItem(t);
+    return e && u.includes(e) ? e : null;
+  } catch {
+    return null;
+  }
+}
+function j({
+  children: t,
+  locale: u,
+  fallbackLocale: e,
+  messages: n,
+  storageKey: o = "tempest-locale"
+}) {
+  const c = d(() => Object.keys(n), [n]), [r, a] = w(
+    () => b(o, c) ?? u
+  );
+  p(() => {
+    typeof document < "u" && document.documentElement.setAttribute("lang", r);
+  }, [r]);
+  const l = I(
+    (i) => {
+      if (a(i), o && typeof window < "u")
+        try {
+          window.localStorage.setItem(o, i);
+        } catch {
+        }
+    },
+    [o]
+  ), s = d(() => ({ ...S({ locale: r, fallbackLocale: e, messages: n }), setLocale: l, availableLocales: c }), [r, e, n, l, c]);
+  return /* @__PURE__ */ m(f.Provider, { value: s, children: t });
+}
+function C() {
+  const t = v(f);
+  if (!t) throw new Error("useI18n must be used inside an <I18nProvider>");
+  return t;
+}
+function y() {
+  return C().t;
+}
+export {
+  j as I18nProvider,
+  C as useI18n,
+  y as useTranslate
+};
+//# sourceMappingURL=I18nProvider.js.map

package/dist/i18n/I18nProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18nProvider.js","sources":["../../src/i18n/I18nProvider.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { createI18n, type Catalog, type I18n } from \"./create-i18n\";\n\nexport interface I18nContextValue extends I18n {\n    /** Switch the active locale. Persisted when `storageKey` is set. */\n    setLocale: (locale: string) => void;\n    /** Locales available in the catalog. */\n    availableLocales: string[];\n}\n\nconst I18nContext = createContext<I18nContextValue | null>(null);\n\nexport interface I18nProviderProps {\n    children: ReactNode;\n    /** Initial locale. */\n    locale: string;\n    /** Fallback locale used when a key is missing. */\n    fallbackLocale?: string;\n    /** Translation catalog. */\n    messages: Catalog;\n    /** localStorage key for persisting the user choice. Pass `null` to disable. Default: `\"tempest-locale\"`. */\n    storageKey?: string | null;\n}\n\nfunction readStored(storageKey: string | null, available: string[]): string | null {\n    if (!storageKey || typeof window === \"undefined\") return null;\n    try {\n        const value = window.localStorage.getItem(storageKey);\n        if (value && available.includes(value)) return value;\n        return null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * React provider for the SDK's lightweight i18n. Exposes the translation\n * helpers and a `setLocale` setter to children.\n */\nexport function I18nProvider({\n    children,\n    locale: initialLocale,\n    fallbackLocale,\n    messages,\n    storageKey = \"tempest-locale\",\n}: I18nProviderProps) {\n    const availableLocales = useMemo(() => Object.keys(messages), [messages]);\n    const [locale, setLocaleState] = useState<string>(\n        () => readStored(storageKey, availableLocales) ?? initialLocale,\n    );\n\n    useEffect(() => {\n        if (typeof document !== \"undefined\") {\n            document.documentElement.setAttribute(\"lang\", locale);\n        }\n    }, [locale]);\n\n    const setLocale = useCallback(\n        (next: string) => {\n            setLocaleState(next);\n            if (storageKey && typeof window !== \"undefined\") {\n                try {\n                    window.localStorage.setItem(storageKey, next);\n                } catch {\n                    /* ignore quota errors */\n                }\n            }\n        },\n        [storageKey],\n    );\n\n    const value = useMemo<I18nContextValue>(() => {\n        const i18n = createI18n({ locale, fallbackLocale, messages });\n        return { ...i18n, setLocale, availableLocales };\n    }, [locale, fallbackLocale, messages, setLocale, availableLocales]);\n\n    return <I18nContext.Provider value={value}>{children}</I18nContext.Provider>;\n}\n\n/**\n * Access translation helpers. Must be used inside an {@link I18nProvider}.\n */\nexport function useI18n(): I18nContextValue {\n    const ctx = useContext(I18nContext);\n    if (!ctx) throw new Error(\"useI18n must be used inside an <I18nProvider>\");\n    return ctx;\n}\n\n/**\n * Shortcut for components that only need the `t` function — avoids destructuring.\n */\nexport function useTranslate(): I18nContextValue[\"t\"] {\n    return useI18n().t;\n}\n"],"names":["I18nContext","createContext","readStored","storageKey","available","value","I18nProvider","children","initialLocale","fallbackLocale","messages","availableLocales","useMemo","locale","setLocaleState","useState","useEffect","setLocale","useCallback","next","createI18n","jsx","useI18n","ctx","useContext","useTranslate"],"mappings":";;;AAWA,MAAMA,IAAcC,EAAuC,IAAI;AAc/D,SAASC,EAAWC,GAA2BC,GAAoC;AAC/E,MAAI,CAACD,KAAc,OAAO,SAAW,IAAa,QAAO;AACzD,MAAI;AACA,UAAME,IAAQ,OAAO,aAAa,QAAQF,CAAU;AACpD,WAAIE,KAASD,EAAU,SAASC,CAAK,IAAUA,IACxC;AAAA,EACX,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;AAMO,SAASC,EAAa;AAAA,EACzB,UAAAC;AAAA,EACA,QAAQC;AAAA,EACR,gBAAAC;AAAA,EACA,UAAAC;AAAA,EACA,YAAAP,IAAa;AACjB,GAAsB;AAClB,QAAMQ,IAAmBC,EAAQ,MAAM,OAAO,KAAKF,CAAQ,GAAG,CAACA,CAAQ,CAAC,GAClE,CAACG,GAAQC,CAAc,IAAIC;AAAA,IAC7B,MAAMb,EAAWC,GAAYQ,CAAgB,KAAKH;AAAA,EAAA;AAGtD,EAAAQ,EAAU,MAAM;AACZ,IAAI,OAAO,WAAa,OACpB,SAAS,gBAAgB,aAAa,QAAQH,CAAM;AAAA,EAE5D,GAAG,CAACA,CAAM,CAAC;AAEX,QAAMI,IAAYC;AAAA,IACd,CAACC,MAAiB;AAEd,UADAL,EAAeK,CAAI,GACfhB,KAAc,OAAO,SAAW;AAChC,YAAI;AACA,iBAAO,aAAa,QAAQA,GAAYgB,CAAI;AAAA,QAChD,QAAQ;AAAA,QAER;AAAA,IAER;AAAA,IACA,CAAChB,CAAU;AAAA,EAAA,GAGTE,IAAQO,EAA0B,OAE7B,EAAE,GADIQ,EAAW,EAAE,QAAAP,GAAQ,gBAAAJ,GAAgB,UAAAC,GAAU,GAC1C,WAAAO,GAAW,kBAAAN,EAAA,IAC9B,CAACE,GAAQJ,GAAgBC,GAAUO,GAAWN,CAAgB,CAAC;AAElE,SAAO,gBAAAU,EAACrB,EAAY,UAAZ,EAAqB,OAAAK,GAAe,UAAAE,EAAA,CAAS;AACzD;AAKO,SAASe,IAA4B;AACxC,QAAMC,IAAMC,EAAWxB,CAAW;AAClC,MAAI,CAACuB,EAAK,OAAM,IAAI,MAAM,+CAA+C;AACzE,SAAOA;AACX;AAKO,SAASE,IAAsC;AAClD,SAAOH,IAAU;AACrB;"}

package/dist/i18n/create-i18n.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function s(u,n){return n?u.replace(/\{(\w+)\}/g,(r,e)=>{const i=n[e];return i===void 0?`{${e}}`:String(i)}):u}function f(u,n,r,e){const i=u[n]?.[e];if(i!==void 0)return i;if(r){const c=u[r]?.[e];if(c!==void 0)return c}return null}function m(u){const{locale:n,fallbackLocale:r=null,messages:e}=u;function i(t,o){const l=f(e,n,r,t);return l===null?t:s(l,o)}function c(t,o,l){const a=f(e,n,r,`${t}${o===1?"_one":"_other"}`)??f(e,n,r,t);return a===null?t:s(a,{count:o,...l??{}})}function d(t,o){return new Intl.NumberFormat(n,o).format(t)}function b(t,o){const l=typeof t=="string"?new Date(t):t;return Number.isNaN(l.getTime())?"":new Intl.DateTimeFormat(n,o).format(l)}return{locale:n,fallbackLocale:r,t:i,plural:c,formatNumber:d,formatDate:b,withLocale:t=>m({locale:t,fallbackLocale:r??void 0,messages:e})}}exports.createI18n=m;
+//# sourceMappingURL=create-i18n.cjs.map

package/dist/i18n/create-i18n.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-i18n.cjs","sources":["../../src/i18n/create-i18n.ts"],"sourcesContent":["export type Messages = Record<string, string>;\nexport type Catalog = Record<string, Messages>;\nexport type InterpolationValues = Record<string, string | number>;\n\nexport interface CreateI18nOptions {\n    /** Initial locale. */\n    locale: string;\n    /** Fallback locale used when a key is missing in the active locale. */\n    fallbackLocale?: string;\n    /** Catalog `{ [locale]: { [key]: \"...\" } }`. */\n    messages: Catalog;\n}\n\nexport interface I18n {\n    /** Currently active locale. */\n    locale: string;\n    /** Fallback locale (or `null` when not configured). */\n    fallbackLocale: string | null;\n    /**\n     * Translate `key`, interpolating `{name}` placeholders from `params`.\n     * Falls back to the configured fallback locale, then to the key itself.\n     */\n    t: (key: string, params?: InterpolationValues) => string;\n    /**\n     * Plural-aware translation. Tries `${key}_one` for `count === 1` and\n     * `${key}_other` otherwise, with `{count}` available for interpolation.\n     */\n    plural: (key: string, count: number, params?: InterpolationValues) => string;\n    /** Format a number using `Intl.NumberFormat` on the active locale. */\n    formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;\n    /** Format a Date using `Intl.DateTimeFormat` on the active locale. */\n    formatDate: (value: Date | string, options?: Intl.DateTimeFormatOptions) => string;\n    /** Build a new `I18n` instance pointing at a different locale. */\n    withLocale: (locale: string) => I18n;\n}\n\nfunction interpolate(template: string, params?: InterpolationValues): string {\n    if (!params) return template;\n    return template.replace(/\\{(\\w+)\\}/g, (_match, name: string) => {\n        const value = params[name];\n        return value === undefined ? `{${name}}` : String(value);\n    });\n}\n\nfunction lookup(\n    catalog: Catalog,\n    locale: string,\n    fallback: string | null,\n    key: string,\n): string | null {\n    const direct = catalog[locale]?.[key];\n    if (direct !== undefined) return direct;\n    if (fallback) {\n        const fallbackValue = catalog[fallback]?.[key];\n        if (fallbackValue !== undefined) return fallbackValue;\n    }\n    return null;\n}\n\n/**\n * Create an i18n object with translation, pluralization and Intl helpers.\n *\n * The catalog is a plain `{ [locale]: { [key]: \"...\" } }` map — bring your\n * own keys, namespaces, or nested-key conventions. The SDK does not enforce\n * a schema so you can plug it into any string-loading pipeline.\n *\n * @example\n * const i18n = createI18n({\n *     locale: \"pt-BR\",\n *     fallbackLocale: \"en\",\n *     messages: {\n *         \"pt-BR\": {\n *             \"greet\": \"Olá, {name}\",\n *             \"alos_one\": \"{count} Alô\",\n *             \"alos_other\": \"{count} Alôs\",\n *         },\n *         \"en\": { greet: \"Hi, {name}\", alos_one: \"{count} Alo\", alos_other: \"{count} Alos\" },\n *     },\n * });\n * i18n.t(\"greet\", { name: \"Mau\" });          // \"Olá, Mau\"\n * i18n.plural(\"alos\", 3);                     // \"3 Alôs\"\n */\nexport function createI18n(options: CreateI18nOptions): I18n {\n    const { locale, fallbackLocale = null, messages } = options;\n\n    function t(key: string, params?: InterpolationValues): string {\n        const template = lookup(messages, locale, fallbackLocale, key);\n        if (template === null) return key;\n        return interpolate(template, params);\n    }\n\n    function plural(key: string, count: number, params?: InterpolationValues): string {\n        const suffix = count === 1 ? \"_one\" : \"_other\";\n        const template =\n            lookup(messages, locale, fallbackLocale, `${key}${suffix}`) ??\n            lookup(messages, locale, fallbackLocale, key);\n        if (template === null) return key;\n        return interpolate(template, { count, ...(params ?? {}) });\n    }\n\n    function formatNumber(value: number, opts?: Intl.NumberFormatOptions): string {\n        return new Intl.NumberFormat(locale, opts).format(value);\n    }\n\n    function formatDate(value: Date | string, opts?: Intl.DateTimeFormatOptions): string {\n        const date = typeof value === \"string\" ? new Date(value) : value;\n        if (Number.isNaN(date.getTime())) return \"\";\n        return new Intl.DateTimeFormat(locale, opts).format(date);\n    }\n\n    return {\n        locale,\n        fallbackLocale,\n        t,\n        plural,\n        formatNumber,\n        formatDate,\n        withLocale: (nextLocale) =>\n            createI18n({\n                locale: nextLocale,\n                fallbackLocale: fallbackLocale ?? undefined,\n                messages,\n            }),\n    };\n}\n"],"names":["interpolate","template","params","_match","name","value","lookup","catalog","locale","fallback","key","direct","fallbackValue","createI18n","options","fallbackLocale","messages","t","plural","count","formatNumber","opts","formatDate","date","nextLocale"],"mappings":"gFAoCA,SAASA,EAAYC,EAAkBC,EAAsC,CACzE,OAAKA,EACED,EAAS,QAAQ,aAAc,CAACE,EAAQC,IAAiB,CAC5D,MAAMC,EAAQH,EAAOE,CAAI,EACzB,OAAOC,IAAU,OAAY,IAAID,CAAI,IAAM,OAAOC,CAAK,CAC3D,CAAC,EAJmBJ,CAKxB,CAEA,SAASK,EACLC,EACAC,EACAC,EACAC,EACa,CACb,MAAMC,EAASJ,EAAQC,CAAM,IAAIE,CAAG,EACpC,GAAIC,IAAW,OAAW,OAAOA,EACjC,GAAIF,EAAU,CACV,MAAMG,EAAgBL,EAAQE,CAAQ,IAAIC,CAAG,EAC7C,GAAIE,IAAkB,OAAW,OAAOA,CAC5C,CACA,OAAO,IACX,CAyBO,SAASC,EAAWC,EAAkC,CACzD,KAAM,CAAE,OAAAN,EAAQ,eAAAO,EAAiB,KAAM,SAAAC,GAAaF,EAEpD,SAASG,EAAEP,EAAaR,EAAsC,CAC1D,MAAMD,EAAWK,EAAOU,EAAUR,EAAQO,EAAgBL,CAAG,EAC7D,OAAIT,IAAa,KAAaS,EACvBV,EAAYC,EAAUC,CAAM,CACvC,CAEA,SAASgB,EAAOR,EAAaS,EAAejB,EAAsC,CAE9E,MAAMD,EACFK,EAAOU,EAAUR,EAAQO,EAAgB,GAAGL,CAAG,GAFpCS,IAAU,EAAI,OAAS,QAEsB,EAAE,GAC1Db,EAAOU,EAAUR,EAAQO,EAAgBL,CAAG,EAChD,OAAIT,IAAa,KAAaS,EACvBV,EAAYC,EAAU,CAAE,MAAAkB,EAAO,GAAIjB,GAAU,CAAA,EAAK,CAC7D,CAEA,SAASkB,EAAaf,EAAegB,EAAyC,CAC1E,OAAO,IAAI,KAAK,aAAab,EAAQa,CAAI,EAAE,OAAOhB,CAAK,CAC3D,CAEA,SAASiB,EAAWjB,EAAsBgB,EAA2C,CACjF,MAAME,EAAO,OAAOlB,GAAU,SAAW,IAAI,KAAKA,CAAK,EAAIA,EAC3D,OAAI,OAAO,MAAMkB,EAAK,QAAA,CAAS,EAAU,GAClC,IAAI,KAAK,eAAef,EAAQa,CAAI,EAAE,OAAOE,CAAI,CAC5D,CAEA,MAAO,CACH,OAAAf,EACA,eAAAO,EACA,EAAAE,EACA,OAAAC,EACA,aAAAE,EACA,WAAAE,EACA,WAAaE,GACTX,EAAW,CACP,OAAQW,EACR,eAAgBT,GAAkB,OAClC,SAAAC,CAAA,CACH,CAAA,CAEb"}

package/dist/i18n/create-i18n.js

@@ -0,0 +1,50 @@
+function s(u, n) {
+  return n ? u.replace(/\{(\w+)\}/g, (e, r) => {
+    const i = n[r];
+    return i === void 0 ? `{${r}}` : String(i);
+  }) : u;
+}
+function c(u, n, e, r) {
+  const i = u[n]?.[r];
+  if (i !== void 0) return i;
+  if (e) {
+    const f = u[e]?.[r];
+    if (f !== void 0) return f;
+  }
+  return null;
+}
+function p(u) {
+  const { locale: n, fallbackLocale: e = null, messages: r } = u;
+  function i(t, o) {
+    const l = c(r, n, e, t);
+    return l === null ? t : s(l, o);
+  }
+  function f(t, o, l) {
+    const a = c(r, n, e, `${t}${o === 1 ? "_one" : "_other"}`) ?? c(r, n, e, t);
+    return a === null ? t : s(a, { count: o, ...l ?? {} });
+  }
+  function m(t, o) {
+    return new Intl.NumberFormat(n, o).format(t);
+  }
+  function d(t, o) {
+    const l = typeof t == "string" ? new Date(t) : t;
+    return Number.isNaN(l.getTime()) ? "" : new Intl.DateTimeFormat(n, o).format(l);
+  }
+  return {
+    locale: n,
+    fallbackLocale: e,
+    t: i,
+    plural: f,
+    formatNumber: m,
+    formatDate: d,
+    withLocale: (t) => p({
+      locale: t,
+      fallbackLocale: e ?? void 0,
+      messages: r
+    })
+  };
+}
+export {
+  p as createI18n
+};
+//# sourceMappingURL=create-i18n.js.map

package/dist/i18n/create-i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-i18n.js","sources":["../../src/i18n/create-i18n.ts"],"sourcesContent":["export type Messages = Record<string, string>;\nexport type Catalog = Record<string, Messages>;\nexport type InterpolationValues = Record<string, string | number>;\n\nexport interface CreateI18nOptions {\n    /** Initial locale. */\n    locale: string;\n    /** Fallback locale used when a key is missing in the active locale. */\n    fallbackLocale?: string;\n    /** Catalog `{ [locale]: { [key]: \"...\" } }`. */\n    messages: Catalog;\n}\n\nexport interface I18n {\n    /** Currently active locale. */\n    locale: string;\n    /** Fallback locale (or `null` when not configured). */\n    fallbackLocale: string | null;\n    /**\n     * Translate `key`, interpolating `{name}` placeholders from `params`.\n     * Falls back to the configured fallback locale, then to the key itself.\n     */\n    t: (key: string, params?: InterpolationValues) => string;\n    /**\n     * Plural-aware translation. Tries `${key}_one` for `count === 1` and\n     * `${key}_other` otherwise, with `{count}` available for interpolation.\n     */\n    plural: (key: string, count: number, params?: InterpolationValues) => string;\n    /** Format a number using `Intl.NumberFormat` on the active locale. */\n    formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;\n    /** Format a Date using `Intl.DateTimeFormat` on the active locale. */\n    formatDate: (value: Date | string, options?: Intl.DateTimeFormatOptions) => string;\n    /** Build a new `I18n` instance pointing at a different locale. */\n    withLocale: (locale: string) => I18n;\n}\n\nfunction interpolate(template: string, params?: InterpolationValues): string {\n    if (!params) return template;\n    return template.replace(/\\{(\\w+)\\}/g, (_match, name: string) => {\n        const value = params[name];\n        return value === undefined ? `{${name}}` : String(value);\n    });\n}\n\nfunction lookup(\n    catalog: Catalog,\n    locale: string,\n    fallback: string | null,\n    key: string,\n): string | null {\n    const direct = catalog[locale]?.[key];\n    if (direct !== undefined) return direct;\n    if (fallback) {\n        const fallbackValue = catalog[fallback]?.[key];\n        if (fallbackValue !== undefined) return fallbackValue;\n    }\n    return null;\n}\n\n/**\n * Create an i18n object with translation, pluralization and Intl helpers.\n *\n * The catalog is a plain `{ [locale]: { [key]: \"...\" } }` map — bring your\n * own keys, namespaces, or nested-key conventions. The SDK does not enforce\n * a schema so you can plug it into any string-loading pipeline.\n *\n * @example\n * const i18n = createI18n({\n *     locale: \"pt-BR\",\n *     fallbackLocale: \"en\",\n *     messages: {\n *         \"pt-BR\": {\n *             \"greet\": \"Olá, {name}\",\n *             \"alos_one\": \"{count} Alô\",\n *             \"alos_other\": \"{count} Alôs\",\n *         },\n *         \"en\": { greet: \"Hi, {name}\", alos_one: \"{count} Alo\", alos_other: \"{count} Alos\" },\n *     },\n * });\n * i18n.t(\"greet\", { name: \"Mau\" });          // \"Olá, Mau\"\n * i18n.plural(\"alos\", 3);                     // \"3 Alôs\"\n */\nexport function createI18n(options: CreateI18nOptions): I18n {\n    const { locale, fallbackLocale = null, messages } = options;\n\n    function t(key: string, params?: InterpolationValues): string {\n        const template = lookup(messages, locale, fallbackLocale, key);\n        if (template === null) return key;\n        return interpolate(template, params);\n    }\n\n    function plural(key: string, count: number, params?: InterpolationValues): string {\n        const suffix = count === 1 ? \"_one\" : \"_other\";\n        const template =\n            lookup(messages, locale, fallbackLocale, `${key}${suffix}`) ??\n            lookup(messages, locale, fallbackLocale, key);\n        if (template === null) return key;\n        return interpolate(template, { count, ...(params ?? {}) });\n    }\n\n    function formatNumber(value: number, opts?: Intl.NumberFormatOptions): string {\n        return new Intl.NumberFormat(locale, opts).format(value);\n    }\n\n    function formatDate(value: Date | string, opts?: Intl.DateTimeFormatOptions): string {\n        const date = typeof value === \"string\" ? new Date(value) : value;\n        if (Number.isNaN(date.getTime())) return \"\";\n        return new Intl.DateTimeFormat(locale, opts).format(date);\n    }\n\n    return {\n        locale,\n        fallbackLocale,\n        t,\n        plural,\n        formatNumber,\n        formatDate,\n        withLocale: (nextLocale) =>\n            createI18n({\n                locale: nextLocale,\n                fallbackLocale: fallbackLocale ?? undefined,\n                messages,\n            }),\n    };\n}\n"],"names":["interpolate","template","params","_match","name","value","lookup","catalog","locale","fallback","key","direct","fallbackValue","createI18n","options","fallbackLocale","messages","t","plural","count","formatNumber","opts","formatDate","date","nextLocale"],"mappings":"AAoCA,SAASA,EAAYC,GAAkBC,GAAsC;AACzE,SAAKA,IACED,EAAS,QAAQ,cAAc,CAACE,GAAQC,MAAiB;AAC5D,UAAMC,IAAQH,EAAOE,CAAI;AACzB,WAAOC,MAAU,SAAY,IAAID,CAAI,MAAM,OAAOC,CAAK;AAAA,EAC3D,CAAC,IAJmBJ;AAKxB;AAEA,SAASK,EACLC,GACAC,GACAC,GACAC,GACa;AACb,QAAMC,IAASJ,EAAQC,CAAM,IAAIE,CAAG;AACpC,MAAIC,MAAW,OAAW,QAAOA;AACjC,MAAIF,GAAU;AACV,UAAMG,IAAgBL,EAAQE,CAAQ,IAAIC,CAAG;AAC7C,QAAIE,MAAkB,OAAW,QAAOA;AAAA,EAC5C;AACA,SAAO;AACX;AAyBO,SAASC,EAAWC,GAAkC;AACzD,QAAM,EAAE,QAAAN,GAAQ,gBAAAO,IAAiB,MAAM,UAAAC,MAAaF;AAEpD,WAASG,EAAEP,GAAaR,GAAsC;AAC1D,UAAMD,IAAWK,EAAOU,GAAUR,GAAQO,GAAgBL,CAAG;AAC7D,WAAIT,MAAa,OAAaS,IACvBV,EAAYC,GAAUC,CAAM;AAAA,EACvC;AAEA,WAASgB,EAAOR,GAAaS,GAAejB,GAAsC;AAE9E,UAAMD,IACFK,EAAOU,GAAUR,GAAQO,GAAgB,GAAGL,CAAG,GAFpCS,MAAU,IAAI,SAAS,QAEsB,EAAE,KAC1Db,EAAOU,GAAUR,GAAQO,GAAgBL,CAAG;AAChD,WAAIT,MAAa,OAAaS,IACvBV,EAAYC,GAAU,EAAE,OAAAkB,GAAO,GAAIjB,KAAU,CAAA,GAAK;AAAA,EAC7D;AAEA,WAASkB,EAAaf,GAAegB,GAAyC;AAC1E,WAAO,IAAI,KAAK,aAAab,GAAQa,CAAI,EAAE,OAAOhB,CAAK;AAAA,EAC3D;AAEA,WAASiB,EAAWjB,GAAsBgB,GAA2C;AACjF,UAAME,IAAO,OAAOlB,KAAU,WAAW,IAAI,KAAKA,CAAK,IAAIA;AAC3D,WAAI,OAAO,MAAMkB,EAAK,QAAA,CAAS,IAAU,KAClC,IAAI,KAAK,eAAef,GAAQa,CAAI,EAAE,OAAOE,CAAI;AAAA,EAC5D;AAEA,SAAO;AAAA,IACH,QAAAf;AAAA,IACA,gBAAAO;AAAA,IACA,GAAAE;AAAA,IACA,QAAAC;AAAA,IACA,cAAAE;AAAA,IACA,YAAAE;AAAA,IACA,YAAY,CAACE,MACTX,EAAW;AAAA,MACP,QAAQW;AAAA,MACR,gBAAgBT,KAAkB;AAAA,MAClC,UAAAC;AAAA,IAAA,CACH;AAAA,EAAA;AAEb;"}

package/dist/logger/logger.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=["debug","info","warn","error"];function l(o,r){return i.indexOf(r)>=i.indexOf(o)}const f=({level:o,message:r,context:c})=>{const t=o==="debug"?"log":o;c?console[t](r,c):console[t](r)};function u(o={}){const r=o.level??"info",c=o.sinks??[f],t=o.namespace??"";function s(n,e,a){if(!l(r,n))return;const d={level:n,message:t?`[${t}] ${e}`:e,context:a,timestamp:Date.now()};for(const g of c)try{g(d)}catch{}}return{debug:(n,e)=>s("debug",n,e),info:(n,e)=>s("info",n,e),warn:(n,e)=>s("warn",n,e),error:(n,e)=>s("error",n,e),child:n=>u({level:r,sinks:c,namespace:t?`${t}:${n}`:n})}}exports.consoleSink=f;exports.createLogger=u;
+//# sourceMappingURL=logger.cjs.map

package/dist/logger/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.cjs","sources":["../../src/logger/logger.ts"],"sourcesContent":["export type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nexport interface LogEntry {\n    level: LogLevel;\n    message: string;\n    context?: Record<string, unknown>;\n    timestamp: number;\n}\n\nexport interface LoggerSink {\n    (entry: LogEntry): void;\n}\n\nexport interface Logger {\n    debug: (message: string, context?: Record<string, unknown>) => void;\n    info: (message: string, context?: Record<string, unknown>) => void;\n    warn: (message: string, context?: Record<string, unknown>) => void;\n    error: (message: string, context?: Record<string, unknown>) => void;\n    /** Build a child logger that prefixes the namespace to each message. */\n    child: (namespace: string) => Logger;\n}\n\nexport interface CreateLoggerOptions {\n    /** Lowest level recorded. Default: `\"info\"`. */\n    level?: LogLevel;\n    /** Output adapters. Default: a `console.*` sink. */\n    sinks?: LoggerSink[];\n    /** Initial namespace (prepended to every message). */\n    namespace?: string;\n}\n\nconst LEVELS: LogLevel[] = [\"debug\", \"info\", \"warn\", \"error\"];\n\nfunction shouldLog(threshold: LogLevel, level: LogLevel): boolean {\n    return LEVELS.indexOf(level) >= LEVELS.indexOf(threshold);\n}\n\n/** Default sink that writes to the browser console. */\nexport const consoleSink: LoggerSink = ({ level, message, context }) => {\n    const method = level === \"debug\" ? \"log\" : level;\n    if (context) {\n        console[method](message, context);\n    } else {\n        console[method](message);\n    }\n};\n\n/**\n * Create a structured leveled logger. Plug arbitrary sinks (Sentry, Datadog,\n * remote ingestion) by implementing the `LoggerSink` interface.\n */\nexport function createLogger(options: CreateLoggerOptions = {}): Logger {\n    const threshold = options.level ?? \"info\";\n    const sinks = options.sinks ?? [consoleSink];\n    const namespace = options.namespace ?? \"\";\n\n    function emit(level: LogLevel, message: string, context?: Record<string, unknown>): void {\n        if (!shouldLog(threshold, level)) return;\n        const entry: LogEntry = {\n            level,\n            message: namespace ? `[${namespace}] ${message}` : message,\n            context,\n            timestamp: Date.now(),\n        };\n        for (const sink of sinks) {\n            try {\n                sink(entry);\n            } catch {\n                /* never let a sink break the app */\n            }\n        }\n    }\n\n    return {\n        debug: (message, context) => emit(\"debug\", message, context),\n        info: (message, context) => emit(\"info\", message, context),\n        warn: (message, context) => emit(\"warn\", message, context),\n        error: (message, context) => emit(\"error\", message, context),\n        child: (childNamespace: string) =>\n            createLogger({\n                level: threshold,\n                sinks,\n                namespace: namespace ? `${namespace}:${childNamespace}` : childNamespace,\n            }),\n    };\n}\n"],"names":["LEVELS","shouldLog","threshold","level","consoleSink","message","context","method","createLogger","options","sinks","namespace","emit","entry","sink","childNamespace"],"mappings":"gFA+BA,MAAMA,EAAqB,CAAC,QAAS,OAAQ,OAAQ,OAAO,EAE5D,SAASC,EAAUC,EAAqBC,EAA0B,CAC9D,OAAOH,EAAO,QAAQG,CAAK,GAAKH,EAAO,QAAQE,CAAS,CAC5D,CAGO,MAAME,EAA0B,CAAC,CAAE,MAAAD,EAAO,QAAAE,EAAS,QAAAC,KAAc,CACpE,MAAMC,EAASJ,IAAU,QAAU,MAAQA,EACvCG,EACA,QAAQC,CAAM,EAAEF,EAASC,CAAO,EAEhC,QAAQC,CAAM,EAAEF,CAAO,CAE/B,EAMO,SAASG,EAAaC,EAA+B,GAAY,CACpE,MAAMP,EAAYO,EAAQ,OAAS,OAC7BC,EAAQD,EAAQ,OAAS,CAACL,CAAW,EACrCO,EAAYF,EAAQ,WAAa,GAEvC,SAASG,EAAKT,EAAiBE,EAAiBC,EAAyC,CACrF,GAAI,CAACL,EAAUC,EAAWC,CAAK,EAAG,OAClC,MAAMU,EAAkB,CACpB,MAAAV,EACA,QAASQ,EAAY,IAAIA,CAAS,KAAKN,CAAO,GAAKA,EACnD,QAAAC,EACA,UAAW,KAAK,IAAA,CAAI,EAExB,UAAWQ,KAAQJ,EACf,GAAI,CACAI,EAAKD,CAAK,CACd,MAAQ,CAER,CAER,CAEA,MAAO,CACH,MAAO,CAACR,EAASC,IAAYM,EAAK,QAASP,EAASC,CAAO,EAC3D,KAAM,CAACD,EAASC,IAAYM,EAAK,OAAQP,EAASC,CAAO,EACzD,KAAM,CAACD,EAASC,IAAYM,EAAK,OAAQP,EAASC,CAAO,EACzD,MAAO,CAACD,EAASC,IAAYM,EAAK,QAASP,EAASC,CAAO,EAC3D,MAAQS,GACJP,EAAa,CACT,MAAON,EACP,MAAAQ,EACA,UAAWC,EAAY,GAAGA,CAAS,IAAII,CAAc,GAAKA,CAAA,CAC7D,CAAA,CAEb"}

package/dist/logger/logger.js

@@ -0,0 +1,41 @@
+const i = ["debug", "info", "warn", "error"];
+function d(e, r) {
+  return i.indexOf(r) >= i.indexOf(e);
+}
+const g = ({ level: e, message: r, context: c }) => {
+  const t = e === "debug" ? "log" : e;
+  c ? console[t](r, c) : console[t](r);
+};
+function l(e = {}) {
+  const r = e.level ?? "info", c = e.sinks ?? [g], t = e.namespace ?? "";
+  function s(n, o, f) {
+    if (!d(r, n)) return;
+    const u = {
+      level: n,
+      message: t ? `[${t}] ${o}` : o,
+      context: f,
+      timestamp: Date.now()
+    };
+    for (const a of c)
+      try {
+        a(u);
+      } catch {
+      }
+  }
+  return {
+    debug: (n, o) => s("debug", n, o),
+    info: (n, o) => s("info", n, o),
+    warn: (n, o) => s("warn", n, o),
+    error: (n, o) => s("error", n, o),
+    child: (n) => l({
+      level: r,
+      sinks: c,
+      namespace: t ? `${t}:${n}` : n
+    })
+  };
+}
+export {
+  g as consoleSink,
+  l as createLogger
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sources":["../../src/logger/logger.ts"],"sourcesContent":["export type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nexport interface LogEntry {\n    level: LogLevel;\n    message: string;\n    context?: Record<string, unknown>;\n    timestamp: number;\n}\n\nexport interface LoggerSink {\n    (entry: LogEntry): void;\n}\n\nexport interface Logger {\n    debug: (message: string, context?: Record<string, unknown>) => void;\n    info: (message: string, context?: Record<string, unknown>) => void;\n    warn: (message: string, context?: Record<string, unknown>) => void;\n    error: (message: string, context?: Record<string, unknown>) => void;\n    /** Build a child logger that prefixes the namespace to each message. */\n    child: (namespace: string) => Logger;\n}\n\nexport interface CreateLoggerOptions {\n    /** Lowest level recorded. Default: `\"info\"`. */\n    level?: LogLevel;\n    /** Output adapters. Default: a `console.*` sink. */\n    sinks?: LoggerSink[];\n    /** Initial namespace (prepended to every message). */\n    namespace?: string;\n}\n\nconst LEVELS: LogLevel[] = [\"debug\", \"info\", \"warn\", \"error\"];\n\nfunction shouldLog(threshold: LogLevel, level: LogLevel): boolean {\n    return LEVELS.indexOf(level) >= LEVELS.indexOf(threshold);\n}\n\n/** Default sink that writes to the browser console. */\nexport const consoleSink: LoggerSink = ({ level, message, context }) => {\n    const method = level === \"debug\" ? \"log\" : level;\n    if (context) {\n        console[method](message, context);\n    } else {\n        console[method](message);\n    }\n};\n\n/**\n * Create a structured leveled logger. Plug arbitrary sinks (Sentry, Datadog,\n * remote ingestion) by implementing the `LoggerSink` interface.\n */\nexport function createLogger(options: CreateLoggerOptions = {}): Logger {\n    const threshold = options.level ?? \"info\";\n    const sinks = options.sinks ?? [consoleSink];\n    const namespace = options.namespace ?? \"\";\n\n    function emit(level: LogLevel, message: string, context?: Record<string, unknown>): void {\n        if (!shouldLog(threshold, level)) return;\n        const entry: LogEntry = {\n            level,\n            message: namespace ? `[${namespace}] ${message}` : message,\n            context,\n            timestamp: Date.now(),\n        };\n        for (const sink of sinks) {\n            try {\n                sink(entry);\n            } catch {\n                /* never let a sink break the app */\n            }\n        }\n    }\n\n    return {\n        debug: (message, context) => emit(\"debug\", message, context),\n        info: (message, context) => emit(\"info\", message, context),\n        warn: (message, context) => emit(\"warn\", message, context),\n        error: (message, context) => emit(\"error\", message, context),\n        child: (childNamespace: string) =>\n            createLogger({\n                level: threshold,\n                sinks,\n                namespace: namespace ? `${namespace}:${childNamespace}` : childNamespace,\n            }),\n    };\n}\n"],"names":["LEVELS","shouldLog","threshold","level","consoleSink","message","context","method","createLogger","options","sinks","namespace","emit","entry","sink","childNamespace"],"mappings":"AA+BA,MAAMA,IAAqB,CAAC,SAAS,QAAQ,QAAQ,OAAO;AAE5D,SAASC,EAAUC,GAAqBC,GAA0B;AAC9D,SAAOH,EAAO,QAAQG,CAAK,KAAKH,EAAO,QAAQE,CAAS;AAC5D;AAGO,MAAME,IAA0B,CAAC,EAAE,OAAAD,GAAO,SAAAE,GAAS,SAAAC,QAAc;AACpE,QAAMC,IAASJ,MAAU,UAAU,QAAQA;AAC3C,EAAIG,IACA,QAAQC,CAAM,EAAEF,GAASC,CAAO,IAEhC,QAAQC,CAAM,EAAEF,CAAO;AAE/B;AAMO,SAASG,EAAaC,IAA+B,IAAY;AACpE,QAAMP,IAAYO,EAAQ,SAAS,QAC7BC,IAAQD,EAAQ,SAAS,CAACL,CAAW,GACrCO,IAAYF,EAAQ,aAAa;AAEvC,WAASG,EAAKT,GAAiBE,GAAiBC,GAAyC;AACrF,QAAI,CAACL,EAAUC,GAAWC,CAAK,EAAG;AAClC,UAAMU,IAAkB;AAAA,MACpB,OAAAV;AAAA,MACA,SAASQ,IAAY,IAAIA,CAAS,KAAKN,CAAO,KAAKA;AAAA,MACnD,SAAAC;AAAA,MACA,WAAW,KAAK,IAAA;AAAA,IAAI;AAExB,eAAWQ,KAAQJ;AACf,UAAI;AACA,QAAAI,EAAKD,CAAK;AAAA,MACd,QAAQ;AAAA,MAER;AAAA,EAER;AAEA,SAAO;AAAA,IACH,OAAO,CAACR,GAASC,MAAYM,EAAK,SAASP,GAASC,CAAO;AAAA,IAC3D,MAAM,CAACD,GAASC,MAAYM,EAAK,QAAQP,GAASC,CAAO;AAAA,IACzD,MAAM,CAACD,GAASC,MAAYM,EAAK,QAAQP,GAASC,CAAO;AAAA,IACzD,OAAO,CAACD,GAASC,MAAYM,EAAK,SAASP,GAASC,CAAO;AAAA,IAC3D,OAAO,CAACS,MACJP,EAAa;AAAA,MACT,OAAON;AAAA,MACP,OAAAQ;AAAA,MACA,WAAWC,IAAY,GAAGA,CAAS,IAAII,CAAc,KAAKA;AAAA,IAAA,CAC7D;AAAA,EAAA;AAEb;"}

package/dist/oauth/GoogleSignIn.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("react/jsx-runtime");function v({component:r,onSuccess:n,onError:o,locale:i,theme:g,text:t,shape:l,size:d,disableOneTap:u,width:a,className:c,style:s}){return m.jsx("div",{className:c,style:s,children:r({onSuccess:e=>{if(!e.credential){o?.({provider:"google",message:"Google returned no credential",raw:e});return}return n({idToken:e.credential,provider:"google",raw:e})},onError:()=>{o?.({provider:"google",message:"Google login failed"})},locale:i,theme:g,text:t,shape:l,size:d,useOneTap:!u,width:a})})}exports.GoogleSignIn=v;
+//# sourceMappingURL=GoogleSignIn.cjs.map

package/dist/oauth/GoogleSignIn.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleSignIn.cjs","sources":["../../src/oauth/GoogleSignIn.tsx"],"sourcesContent":["import type { CSSProperties, ReactNode } from \"react\";\nimport type { OAuthCredential, OAuthError } from \"./types\";\n\nexport type GoogleSignInTheme = \"filled_blue\" | \"filled_black\" | \"outline\";\nexport type GoogleSignInText = \"signin_with\" | \"signup_with\" | \"continue_with\" | \"signin\";\nexport type GoogleSignInShape = \"rectangular\" | \"pill\" | \"circle\" | \"square\";\nexport type GoogleSignInSize = \"large\" | \"medium\" | \"small\";\n\nexport interface GoogleSignInProps {\n    /**\n     * `GoogleLogin` component from `@react-oauth/google`. The caller imports\n     * it and passes it through so the SDK doesn't take `@react-oauth/google`\n     * as a peer dep.\n     */\n    component: (props: Record<string, unknown>) => ReactNode;\n    /** Fired with the validated credential on success. */\n    onSuccess: (credential: OAuthCredential) => void | Promise<void>;\n    /** Fired with a normalised error on failure. */\n    onError?: (error: OAuthError) => void;\n    /** Optional locale override (e.g. `\"pt-BR\"`). Falls back to browser locale. */\n    locale?: string;\n    /** Visual theme — passed through to `<GoogleLogin>`. */\n    theme?: GoogleSignInTheme;\n    /** Button text variant. */\n    text?: GoogleSignInText;\n    /** Button shape. */\n    shape?: GoogleSignInShape;\n    /** Button size. */\n    size?: GoogleSignInSize;\n    /** Disable Google's \"One Tap\" auto-prompt. Default `false`. */\n    disableOneTap?: boolean;\n    /** Optional `width` override (px) — Google's button is fixed-width. */\n    width?: number;\n    /** Optional className applied to the wrapper. */\n    className?: string;\n    /** Optional inline style applied to the wrapper. */\n    style?: CSSProperties;\n}\n\n/**\n * Thin wrapper over `@react-oauth/google`'s `<GoogleLogin>` that:\n *\n * 1. Normalises the success payload into [[OAuthCredential]] (`idToken`,\n *    `provider: \"google\"`, `raw`).\n * 2. Normalises errors into [[OAuthError]].\n * 3. Lets you pass `GoogleLogin` via the `component` prop, so the SDK does\n *    not declare `@react-oauth/google` as a peer dep — apps that don't use\n *    Google never pay for it.\n *\n * @example\n * import { GoogleLogin, GoogleOAuthProvider } from \"@react-oauth/google\";\n * import { GoogleSignIn } from \"tempest-react-sdk\";\n *\n * <GoogleOAuthProvider clientId={import.meta.env.VITE_GOOGLE_CLIENT_ID}>\n *     <GoogleSignIn\n *         component={GoogleLogin}\n *         onSuccess={async ({ idToken }) => {\n *             await api.post(\"/auth/google\", { body: { id_token: idToken } });\n *         }}\n *         onError={(err) => toast.error(err.message)}\n *     />\n * </GoogleOAuthProvider>\n */\nexport function GoogleSignIn({\n    component: Component,\n    onSuccess,\n    onError,\n    locale,\n    theme,\n    text,\n    shape,\n    size,\n    disableOneTap,\n    width,\n    className,\n    style,\n}: GoogleSignInProps) {\n    return (\n        <div className={className} style={style}>\n            {Component({\n                onSuccess: (response: { credential?: string }) => {\n                    if (!response.credential) {\n                        onError?.({\n                            provider: \"google\",\n                            message: \"Google returned no credential\",\n                            raw: response,\n                        });\n                        return;\n                    }\n                    return onSuccess({\n                        idToken: response.credential,\n                        provider: \"google\",\n                        raw: response,\n                    });\n                },\n                onError: () => {\n                    onError?.({\n                        provider: \"google\",\n                        message: \"Google login failed\",\n                    });\n                },\n                locale,\n                theme,\n                text,\n                shape,\n                size,\n                useOneTap: !disableOneTap,\n                width,\n            })}\n        </div>\n    );\n}\n"],"names":["GoogleSignIn","Component","onSuccess","onError","locale","theme","text","shape","size","disableOneTap","width","className","style","jsx","response"],"mappings":"qHA+DO,SAASA,EAAa,CACzB,UAAWC,EACX,UAAAC,EACA,QAAAC,EACA,OAAAC,EACA,MAAAC,EACA,KAAAC,EACA,MAAAC,EACA,KAAAC,EACA,cAAAC,EACA,MAAAC,EACA,UAAAC,EACA,MAAAC,CACJ,EAAsB,CAClB,OACIC,EAAAA,IAAC,MAAA,CAAI,UAAAF,EAAsB,MAAAC,EACtB,SAAAX,EAAU,CACP,UAAYa,GAAsC,CAC9C,GAAI,CAACA,EAAS,WAAY,CACtBX,IAAU,CACN,SAAU,SACV,QAAS,gCACT,IAAKW,CAAA,CACR,EACD,MACJ,CACA,OAAOZ,EAAU,CACb,QAASY,EAAS,WAClB,SAAU,SACV,IAAKA,CAAA,CACR,CACL,EACA,QAAS,IAAM,CACXX,IAAU,CACN,SAAU,SACV,QAAS,qBAAA,CACZ,CACL,EACA,OAAAC,EACA,MAAAC,EACA,KAAAC,EACA,MAAAC,EACA,KAAAC,EACA,UAAW,CAACC,EACZ,MAAAC,CAAA,CACH,EACL,CAER"}