tempest-react-sdk 0.49.0 → 0.51.0

package/dist/tempest-react-sdk.d.ts

@@ -566,7 +566,7 @@ export declare interface ApiClient {
     put<T>(path: string, options?: RequestOptions): Promise<T>;
     patch<T>(path: string, options?: RequestOptions): Promise<T>;
     delete<T>(path: string, options?: RequestOptions): Promise<T>;
-    upload<T>(path: string, formData: FormData, method?: "POST" | "PUT" | "PATCH"): Promise<T>;
+    upload<T>(path: string, formData: FormData, method?: "POST" | "PUT" | "PATCH", options?: Omit<RequestOptions, "body" | "method">): Promise<T>;
 }
 
 export declare interface ApiClientConfig {
@@ -652,6 +652,35 @@ export declare interface ApiClientConfig {
      */
     retry?: boolean | RetryOptions;
     /** Whether to send cookies on cross-origin requests (default: false). */
+    /**
+     * Milliseconds before a request is abandoned. Default `15_000`. `null` turns
+     * it off.
+     *
+     * There was no timeout at all before, and the failure it leaves open is not
+     * an error: a TCP connection that dies without a FIN never answers, so the
+     * browser can hold the request for minutes or forever. In an offline-first
+     * SDK that is the wrong place to have no floor — the eternal spinner lands
+     * exactly on the bad network this package exists to survive.
+     *
+     * A timeout surfaces as an {@link ApiError} with `status: 0`, the same shape
+     * the client already uses for "never reached the server", so the built-in
+     * retry policy replays it without a special case.
+     */
+    timeout?: number | null;
+    /**
+     * Milliseconds before a `FormData` request is abandoned. Default `300_000`.
+     * `null` turns it off.
+     *
+     * A binary upload is not a slow request, it is a different kind of request. A
+     * single timeout forces a choice between one short enough to protect a normal
+     * call and one long enough to finish a file, and 15 seconds cuts an upload
+     * mid-body — which the server then has to interpret as a truncated payload.
+     *
+     * Detected from the body being `FormData`, the same test that already decides
+     * the `Content-Type`. Override per request with `options.timeout` when a
+     * particular call does not fit either default.
+     */
+    uploadTimeout?: number | null;
     withCredentials?: boolean;
     /** Default headers merged into every request. */
     headers?: Record<string, string>;
@@ -1838,13 +1867,22 @@ export declare interface BuildApiUrlOptions {
  * negative width does not exist) and reports 0%, but its number is still shown —
  * hiding the row would be worse than showing an odd one.
  *
- * @param items - The rows as given.
- * @param sort - Ordering to apply. `"none"` keeps the caller's order.
- * @param max - Keep at most this many rows.
- * @param otherLabel - Aggregate what `max` cut into one row with this label.
+ * @param options - The rows and how to reduce them.
  * @returns The rows to draw, in order.
  */
-export declare function buildBarListRows(items: readonly BarListItem[], sort: BarListSort, max: number | undefined, otherLabel: string | undefined): BarListRow[];
+export declare function buildBarListRows(options: BuildBarListRowsOptions): BarListRow[];
+
+/** What {@link buildBarListRows} needs to reduce a list into rows. */
+export declare interface BuildBarListRowsOptions {
+    /** The rows as given. */
+    items: readonly BarListItem[];
+    /** Ordering to apply. `"none"` keeps the caller's order. Default `"desc"`. */
+    sort?: BarListSort;
+    /** Keep at most this many rows. */
+    max?: number;
+    /** Aggregate what `max` cut into one row with this label. */
+    otherLabel?: string;
+}
 
 /**
  * Builds an `intent://` URL that re-opens the current page inside Chrome on
@@ -3975,6 +4013,12 @@ export declare interface CredentialsContainerLike {
     }): Promise<Credential | null>;
 }
 
+/**
+ * @tempest-limits param-count — `downloadCsv(rows, columns, "usuarios.csv")` reads
+ * in the order the sentence does, and its two trailing parameters have defaults,
+ * so the common call passes three. Wrapping them in an object would break every
+ * caller of a published export for no gain in what the call site says.
+ */
 /** One column of the exported file. */
 export declare interface CsvColumn<T> {
     /** Property of the row this column reads from. Doubles as the column key. */
@@ -4200,17 +4244,6 @@ export declare interface DataTableBaseProps<T> extends HTMLAttributes<HTMLDivEle
     onCellChange?: (change: DataTableCellChange<T>) => void | Promise<void>;
     /** Override the PT-BR copy of the editing affordances. */
     editLabels?: Partial<DataTableEditLabels>;
-    /**
-     * Searching is the caller's job: typing reports through `onSearchChange` and
-     * the rows are left as they arrived.
-     *
-     * Implied by `totalItems`. Filtering the current page would hide the rows
-     * that do not match *on this page* and show nothing for a term that only
-     * matches on page three — an empty table that looks like "no results".
-     */
-    manualSearch?: boolean;
-    /** Called with the current search term (debouncing, if any, is the caller's). */
-    onSearchChange?: (term: string) => void;
     /**
      * A fetch is in flight.
      *
@@ -4354,7 +4387,42 @@ export declare type DataTablePagingProps = {
  * The table's props: the shared half, plus one valid paging shape and one valid
  * sorting shape.
  */
-export declare type DataTableProps<T> = DataTableBaseProps<T> & DataTablePagingProps & DataTableSortProps<T>;
+export declare type DataTableProps<T> = DataTableBaseProps<T> & DataTablePagingProps & DataTableSortProps<T> & DataTableSearchProps;
+
+/**
+ * Searching: delegated, and therefore reported, or neither.
+ *
+ * `manualSearch` without `onSearchChange` renders a search box that filters
+ * nothing and tells nobody — the same shape of lie as a header arrow that turns
+ * without sorting.
+ *
+ * Independent of the paging axis on purpose, and that leaves one gap this type
+ * does not close: `totalItems` *implies* `manualSearch`, so a server-mode table
+ * with `searchable` and no `onSearchChange` falls into the same hole without ever
+ * writing `manualSearch`. Closing it means the search axis has to read the paging
+ * axis, which crosses two three-member unions into nine and turns every mismatch
+ * into a wall of candidate shapes. That case is a dev warning instead — the one
+ * spot where runtime really is the cheaper check, and `use-dev-warnings.ts` says
+ * so at the call site.
+ */
+export declare type DataTableSearchProps = {
+    /** The table filters the rows it has. */
+    manualSearch?: false;
+    /** Called with the current search term (debouncing, if any, is the caller's). */
+    onSearchChange?: (term: string) => void;
+} | {
+    /**
+     * Searching is the caller's job: typing reports through `onSearchChange`
+     * and the rows are left as they arrived.
+     *
+     * Implied by `totalItems`. Filtering the current page would hide the rows
+     * that do not match *on this page* and show nothing for a term that only
+     * matches on page three — an empty table that looks like "no results".
+     */
+    manualSearch: true;
+    /** Where the typing goes. Required, since nothing else acts on it. */
+    onSearchChange: (term: string) => void;
+};
 
 export declare interface DataTableSort<T> {
     key: keyof T;
@@ -9659,6 +9727,24 @@ export declare interface ReorderPayload {
 export declare interface RequestOptions extends Omit<RequestInit, "body"> {
     body?: unknown;
     params?: Record<string, string | number | boolean | undefined | null>;
+    /**
+     * Abort this request.
+     *
+     * Inherited from `RequestInit` and forwarded to `fetch`, so it has always
+     * worked — but nothing said so, which made it a capability nobody could find.
+     * Declared here for that reason alone. Pass the `signal` react-query hands to
+     * a `queryFn` and the request is cancelled on unmount and on refetch.
+     */
+    signal?: AbortSignal | null;
+    /**
+     * Override the client's timeout for this request, in milliseconds. `null`
+     * disables it, which is the escape hatch for a stream or a long poll.
+     *
+     * Composed with `signal`, not replacing it: whichever fires first wins, and
+     * the two are told apart — a timeout surfaces as an {@link ApiError} with
+     * `status: 0`, while an abort you asked for propagates as an abort.
+     */
+    timeout?: number | null;
 }
 
 /**

package/dist/utils/csv.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"csv.cjs","names":[],"sources":["../../src/utils/csv.ts"],"sourcesContent":["// CSV that survives contact with real data. Every app writes this by hand and\n// every hand-written version gets the same two things wrong: a value containing\n// the delimiter splits the row, and a value containing a quote breaks the quoting\n// it was supposed to be protected by. Both are one-liners in RFC 4180 and neither\n// is obvious until a customer's name has a comma in it.\n\nimport { shareOrDownloadBlob } from \"../share/share-or-download\";\n\n/**\n * Byte order mark, as the character `String.prototype` sees it.\n *\n * Excel on a pt-BR install reads a BOM-less UTF-8 file as Latin-1 and turns\n * every accented name into mojibake. It is three bytes to avoid a support\n * ticket, so it is on by default.\n */\nconst BOM = \"\\uFEFF\";\n\n/** One column of the exported file. */\nexport interface CsvColumn<T> {\n    /** Property of the row this column reads from. Doubles as the column key. */\n    key: keyof T;\n    /** Column heading, written to the first line. */\n    header: string;\n    /**\n     * Value for the file. Defaults to `String(row[key])`, with nullish becoming an\n     * empty field.\n     *\n     * A `DataTableColumn` renders cells to `ReactNode`, which cannot be written to\n     * a text file — a badge or a link would serialize as `[object Object]`. Give\n     * the column this accessor and the export says what the badge said.\n     */\n    csv?: (row: T) => string | number | boolean | null | undefined;\n}\n\n/** Options for {@link toCsv}. */\nexport interface CsvOptions {\n    /**\n     * Field separator. Default `\",\"`.\n     *\n     * Use `\";\"` for Excel on a locale whose decimal separator is the comma —\n     * which is every pt-BR install — otherwise it opens the file in one column.\n     */\n    delimiter?: \",\" | \";\";\n    /** Prefix the output with a UTF-8 BOM. Default `true`. */\n    bom?: boolean;\n}\n\n/**\n * Quote one field per RFC 4180.\n *\n * A field is quoted when it contains the delimiter, a double quote, or a line\n * break; inside a quoted field, each double quote is doubled. Fields that need\n * none of this are written bare, which keeps the common file readable.\n *\n * @param value - The already-stringified field.\n * @param delimiter - The separator in use, which decides part of the quoting.\n * @returns The field, quoted if it has to be.\n */\nfunction escapeField(value: string, delimiter: string): string {\n    const mustQuote =\n        value.includes(delimiter) ||\n        value.includes('\"') ||\n        value.includes(\"\\n\") ||\n        value.includes(\"\\r\");\n    if (!mustQuote) return value;\n    return `\"${value.replaceAll('\"', '\"\"')}\"`;\n}\n\n/**\n * Stringify one cell, keeping the difference between \"no value\" and \"zero\".\n *\n * `null` and `undefined` become an empty field; `0` and `false` are values\n * somebody chose and are written out. Getting this backwards is how an export\n * ends up under-reporting every row that legitimately holds a zero.\n *\n * @param value - The raw cell value.\n * @returns The text to write.\n */\nfunction cellText(value: unknown): string {\n    if (value === null || value === undefined) return \"\";\n    if (value instanceof Date) return value.toISOString();\n    return String(value);\n}\n\n/**\n * Serialize rows to CSV text, RFC 4180 style.\n *\n * Rows are separated by `\\r\\n` — the RFC's terminator and the one Excel is least\n * surprised by. A row is emitted for the header even when `rows` is empty, so the\n * person who opens the file sees which columns they asked for instead of a blank\n * document.\n *\n * @example\n * const csv = toCsv(users, [\n *     { key: \"name\", header: \"Nome\" },\n *     { key: \"email\", header: \"E-mail\" },\n *     { key: \"plan\", header: \"Plano\", csv: (user) => user.plan.label },\n * ]);\n *\n * @param rows - The rows to export.\n * @param columns - Columns, in the order they should appear.\n * @param options - Delimiter and BOM.\n * @returns The complete file contents.\n */\nexport function toCsv<T>(\n    rows: readonly T[],\n    columns: readonly CsvColumn<T>[],\n    options: CsvOptions = {},\n): string {\n    const { delimiter = \",\", bom = true } = options;\n\n    const lines = [columns.map((column) => escapeField(column.header, delimiter)).join(delimiter)];\n\n    for (const row of rows) {\n        const cells = columns.map((column) => {\n            const raw = column.csv\n                ? column.csv(row)\n                : (row as Record<string, unknown>)[column.key as string];\n            return escapeField(cellText(raw), delimiter);\n        });\n        lines.push(cells.join(delimiter));\n    }\n\n    return `${bom ? BOM : \"\"}${lines.join(\"\\r\\n\")}`;\n}\n\n/**\n * Build a CSV and hand it to the user.\n *\n * Goes through {@link shareOrDownloadBlob}, so on a phone it opens the native\n * share sheet and everywhere else it downloads — the same path every other\n * generated artifact in the SDK takes, instead of a fourth hand-rolled `<a\n * download>`.\n *\n * @example\n * await downloadCsv(users, COLUMNS, \"usuarios.csv\");\n *\n * @param rows - The rows to export.\n * @param columns - Columns, in the order they should appear.\n * @param fileName - File name offered to the user. Default `\"export.csv\"`.\n * @param options - Delimiter and BOM, forwarded to {@link toCsv}.\n * @returns A promise that resolves once the share or download completes.\n */\nexport async function downloadCsv<T>(\n    rows: readonly T[],\n    columns: readonly CsvColumn<T>[],\n    fileName = \"export.csv\",\n    options: CsvOptions = {},\n): Promise<void> {\n    const blob = new Blob([toCsv(rows, columns, options)], {\n        type: \"text/csv;charset=utf-8\",\n    });\n    await shareOrDownloadBlob(blob, fileName);\n}\n"],"mappings":"kDAeA,IAAM,EAAM,IA2CZ,SAAS,EAAY,EAAe,EAA2B,CAO3D,OALI,EAAM,SAAS,CAAS,GACxB,EAAM,SAAS,GAAG,GAClB,EAAM,SAAS;CAAI,GACnB,EAAM,SAAS,IAAI,EAEhB,IAAI,EAAM,WAAW,IAAK,IAAI,EAAE,GADhB,CAE3B,CAYA,SAAS,EAAS,EAAwB,CAGtC,OAFI,GAAU,KAAoC,GAC9C,aAAiB,KAAa,EAAM,YAAY,EAC7C,OAAO,CAAK,CACvB,CAsBA,SAAgB,EACZ,EACA,EACA,EAAsB,CAAC,EACjB,CACN,GAAM,CAAE,YAAY,IAAK,MAAM,IAAS,EAElC,EAAQ,CAAC,EAAQ,IAAK,GAAW,EAAY,EAAO,OAAQ,CAAS,CAAC,CAAC,CAAC,KAAK,CAAS,CAAC,EAE7F,IAAK,IAAM,KAAO,EAAM,CACpB,IAAM,EAAQ,EAAQ,IAAK,GAIhB,EAAY,EAHP,EAAO,IACb,EAAO,IAAI,CAAG,EACb,EAAgC,EAAO,IACf,EAAG,CAAS,CAC9C,EACD,EAAM,KAAK,EAAM,KAAK,CAAS,CAAC,CACpC,CAEA,MAAO,GAAG,EAAM,EAAM,KAAK,EAAM,KAAK;CAAM,GAChD,CAmBA,eAAsB,EAClB,EACA,EACA,EAAW,aACX,EAAsB,CAAC,EACV,CACb,IAAM,EAAO,IAAI,KAAK,CAAC,EAAM,EAAM,EAAS,CAAO,CAAC,EAAG,CACnD,KAAM,wBACV,CAAC,EACD,MAAM,EAAA,oBAAoB,EAAM,CAAQ,CAC5C"}
+{"version":3,"file":"csv.cjs","names":[],"sources":["../../src/utils/csv.ts"],"sourcesContent":["/**\n * @tempest-limits param-count — `downloadCsv(rows, columns, \"usuarios.csv\")` reads\n * in the order the sentence does, and its two trailing parameters have defaults,\n * so the common call passes three. Wrapping them in an object would break every\n * caller of a published export for no gain in what the call site says.\n */\n// CSV that survives contact with real data. Every app writes this by hand and\n// every hand-written version gets the same two things wrong: a value containing\n// the delimiter splits the row, and a value containing a quote breaks the quoting\n// it was supposed to be protected by. Both are one-liners in RFC 4180 and neither\n// is obvious until a customer's name has a comma in it.\n\nimport { shareOrDownloadBlob } from \"../share/share-or-download\";\n\n/**\n * Byte order mark, as the character `String.prototype` sees it.\n *\n * Excel on a pt-BR install reads a BOM-less UTF-8 file as Latin-1 and turns\n * every accented name into mojibake. It is three bytes to avoid a support\n * ticket, so it is on by default.\n */\nconst BOM = \"\\uFEFF\";\n\n/** One column of the exported file. */\nexport interface CsvColumn<T> {\n    /** Property of the row this column reads from. Doubles as the column key. */\n    key: keyof T;\n    /** Column heading, written to the first line. */\n    header: string;\n    /**\n     * Value for the file. Defaults to `String(row[key])`, with nullish becoming an\n     * empty field.\n     *\n     * A `DataTableColumn` renders cells to `ReactNode`, which cannot be written to\n     * a text file — a badge or a link would serialize as `[object Object]`. Give\n     * the column this accessor and the export says what the badge said.\n     */\n    csv?: (row: T) => string | number | boolean | null | undefined;\n}\n\n/** Options for {@link toCsv}. */\nexport interface CsvOptions {\n    /**\n     * Field separator. Default `\",\"`.\n     *\n     * Use `\";\"` for Excel on a locale whose decimal separator is the comma —\n     * which is every pt-BR install — otherwise it opens the file in one column.\n     */\n    delimiter?: \",\" | \";\";\n    /** Prefix the output with a UTF-8 BOM. Default `true`. */\n    bom?: boolean;\n}\n\n/**\n * Quote one field per RFC 4180.\n *\n * A field is quoted when it contains the delimiter, a double quote, or a line\n * break; inside a quoted field, each double quote is doubled. Fields that need\n * none of this are written bare, which keeps the common file readable.\n *\n * @param value - The already-stringified field.\n * @param delimiter - The separator in use, which decides part of the quoting.\n * @returns The field, quoted if it has to be.\n */\nfunction escapeField(value: string, delimiter: string): string {\n    const mustQuote =\n        value.includes(delimiter) ||\n        value.includes('\"') ||\n        value.includes(\"\\n\") ||\n        value.includes(\"\\r\");\n    if (!mustQuote) return value;\n    return `\"${value.replaceAll('\"', '\"\"')}\"`;\n}\n\n/**\n * Stringify one cell, keeping the difference between \"no value\" and \"zero\".\n *\n * `null` and `undefined` become an empty field; `0` and `false` are values\n * somebody chose and are written out. Getting this backwards is how an export\n * ends up under-reporting every row that legitimately holds a zero.\n *\n * @param value - The raw cell value.\n * @returns The text to write.\n */\nfunction cellText(value: unknown): string {\n    if (value === null || value === undefined) return \"\";\n    if (value instanceof Date) return value.toISOString();\n    return String(value);\n}\n\n/**\n * Serialize rows to CSV text, RFC 4180 style.\n *\n * Rows are separated by `\\r\\n` — the RFC's terminator and the one Excel is least\n * surprised by. A row is emitted for the header even when `rows` is empty, so the\n * person who opens the file sees which columns they asked for instead of a blank\n * document.\n *\n * @example\n * const csv = toCsv(users, [\n *     { key: \"name\", header: \"Nome\" },\n *     { key: \"email\", header: \"E-mail\" },\n *     { key: \"plan\", header: \"Plano\", csv: (user) => user.plan.label },\n * ]);\n *\n * @param rows - The rows to export.\n * @param columns - Columns, in the order they should appear.\n * @param options - Delimiter and BOM.\n * @returns The complete file contents.\n */\nexport function toCsv<T>(\n    rows: readonly T[],\n    columns: readonly CsvColumn<T>[],\n    options: CsvOptions = {},\n): string {\n    const { delimiter = \",\", bom = true } = options;\n\n    const lines = [columns.map((column) => escapeField(column.header, delimiter)).join(delimiter)];\n\n    for (const row of rows) {\n        const cells = columns.map((column) => {\n            const raw = column.csv\n                ? column.csv(row)\n                : (row as Record<string, unknown>)[column.key as string];\n            return escapeField(cellText(raw), delimiter);\n        });\n        lines.push(cells.join(delimiter));\n    }\n\n    return `${bom ? BOM : \"\"}${lines.join(\"\\r\\n\")}`;\n}\n\n/**\n * Build a CSV and hand it to the user.\n *\n * Goes through {@link shareOrDownloadBlob}, so on a phone it opens the native\n * share sheet and everywhere else it downloads — the same path every other\n * generated artifact in the SDK takes, instead of a fourth hand-rolled `<a\n * download>`.\n *\n * @example\n * await downloadCsv(users, COLUMNS, \"usuarios.csv\");\n *\n * @param rows - The rows to export.\n * @param columns - Columns, in the order they should appear.\n * @param fileName - File name offered to the user. Default `\"export.csv\"`.\n * @param options - Delimiter and BOM, forwarded to {@link toCsv}.\n * @returns A promise that resolves once the share or download completes.\n */\nexport async function downloadCsv<T>(\n    rows: readonly T[],\n    columns: readonly CsvColumn<T>[],\n    fileName = \"export.csv\",\n    options: CsvOptions = {},\n): Promise<void> {\n    const blob = new Blob([toCsv(rows, columns, options)], {\n        type: \"text/csv;charset=utf-8\",\n    });\n    await shareOrDownloadBlob(blob, fileName);\n}\n"],"mappings":"kDAqBA,IAAM,EAAM,IA2CZ,SAAS,EAAY,EAAe,EAA2B,CAO3D,OALI,EAAM,SAAS,CAAS,GACxB,EAAM,SAAS,GAAG,GAClB,EAAM,SAAS;CAAI,GACnB,EAAM,SAAS,IAAI,EAEhB,IAAI,EAAM,WAAW,IAAK,IAAI,EAAE,GADhB,CAE3B,CAYA,SAAS,EAAS,EAAwB,CAGtC,OAFI,GAAU,KAAoC,GAC9C,aAAiB,KAAa,EAAM,YAAY,EAC7C,OAAO,CAAK,CACvB,CAsBA,SAAgB,EACZ,EACA,EACA,EAAsB,CAAC,EACjB,CACN,GAAM,CAAE,YAAY,IAAK,MAAM,IAAS,EAElC,EAAQ,CAAC,EAAQ,IAAK,GAAW,EAAY,EAAO,OAAQ,CAAS,CAAC,CAAC,CAAC,KAAK,CAAS,CAAC,EAE7F,IAAK,IAAM,KAAO,EAAM,CACpB,IAAM,EAAQ,EAAQ,IAAK,GAIhB,EAAY,EAHP,EAAO,IACb,EAAO,IAAI,CAAG,EACb,EAAgC,EAAO,IACf,EAAG,CAAS,CAC9C,EACD,EAAM,KAAK,EAAM,KAAK,CAAS,CAAC,CACpC,CAEA,MAAO,GAAG,EAAM,EAAM,KAAK,EAAM,KAAK;CAAM,GAChD,CAmBA,eAAsB,EAClB,EACA,EACA,EAAW,aACX,EAAsB,CAAC,EACV,CACb,IAAM,EAAO,IAAI,KAAK,CAAC,EAAM,EAAM,EAAS,CAAO,CAAC,EAAG,CACnD,KAAM,wBACV,CAAC,EACD,MAAM,EAAA,oBAAoB,EAAM,CAAQ,CAC5C"}

package/dist/utils/csv.js.map

@@ -1 +1 @@
-{"version":3,"file":"csv.js","names":[],"sources":["../../src/utils/csv.ts"],"sourcesContent":["// CSV that survives contact with real data. Every app writes this by hand and\n// every hand-written version gets the same two things wrong: a value containing\n// the delimiter splits the row, and a value containing a quote breaks the quoting\n// it was supposed to be protected by. Both are one-liners in RFC 4180 and neither\n// is obvious until a customer's name has a comma in it.\n\nimport { shareOrDownloadBlob } from \"../share/share-or-download\";\n\n/**\n * Byte order mark, as the character `String.prototype` sees it.\n *\n * Excel on a pt-BR install reads a BOM-less UTF-8 file as Latin-1 and turns\n * every accented name into mojibake. It is three bytes to avoid a support\n * ticket, so it is on by default.\n */\nconst BOM = \"\\uFEFF\";\n\n/** One column of the exported file. */\nexport interface CsvColumn<T> {\n    /** Property of the row this column reads from. Doubles as the column key. */\n    key: keyof T;\n    /** Column heading, written to the first line. */\n    header: string;\n    /**\n     * Value for the file. Defaults to `String(row[key])`, with nullish becoming an\n     * empty field.\n     *\n     * A `DataTableColumn` renders cells to `ReactNode`, which cannot be written to\n     * a text file — a badge or a link would serialize as `[object Object]`. Give\n     * the column this accessor and the export says what the badge said.\n     */\n    csv?: (row: T) => string | number | boolean | null | undefined;\n}\n\n/** Options for {@link toCsv}. */\nexport interface CsvOptions {\n    /**\n     * Field separator. Default `\",\"`.\n     *\n     * Use `\";\"` for Excel on a locale whose decimal separator is the comma —\n     * which is every pt-BR install — otherwise it opens the file in one column.\n     */\n    delimiter?: \",\" | \";\";\n    /** Prefix the output with a UTF-8 BOM. Default `true`. */\n    bom?: boolean;\n}\n\n/**\n * Quote one field per RFC 4180.\n *\n * A field is quoted when it contains the delimiter, a double quote, or a line\n * break; inside a quoted field, each double quote is doubled. Fields that need\n * none of this are written bare, which keeps the common file readable.\n *\n * @param value - The already-stringified field.\n * @param delimiter - The separator in use, which decides part of the quoting.\n * @returns The field, quoted if it has to be.\n */\nfunction escapeField(value: string, delimiter: string): string {\n    const mustQuote =\n        value.includes(delimiter) ||\n        value.includes('\"') ||\n        value.includes(\"\\n\") ||\n        value.includes(\"\\r\");\n    if (!mustQuote) return value;\n    return `\"${value.replaceAll('\"', '\"\"')}\"`;\n}\n\n/**\n * Stringify one cell, keeping the difference between \"no value\" and \"zero\".\n *\n * `null` and `undefined` become an empty field; `0` and `false` are values\n * somebody chose and are written out. Getting this backwards is how an export\n * ends up under-reporting every row that legitimately holds a zero.\n *\n * @param value - The raw cell value.\n * @returns The text to write.\n */\nfunction cellText(value: unknown): string {\n    if (value === null || value === undefined) return \"\";\n    if (value instanceof Date) return value.toISOString();\n    return String(value);\n}\n\n/**\n * Serialize rows to CSV text, RFC 4180 style.\n *\n * Rows are separated by `\\r\\n` — the RFC's terminator and the one Excel is least\n * surprised by. A row is emitted for the header even when `rows` is empty, so the\n * person who opens the file sees which columns they asked for instead of a blank\n * document.\n *\n * @example\n * const csv = toCsv(users, [\n *     { key: \"name\", header: \"Nome\" },\n *     { key: \"email\", header: \"E-mail\" },\n *     { key: \"plan\", header: \"Plano\", csv: (user) => user.plan.label },\n * ]);\n *\n * @param rows - The rows to export.\n * @param columns - Columns, in the order they should appear.\n * @param options - Delimiter and BOM.\n * @returns The complete file contents.\n */\nexport function toCsv<T>(\n    rows: readonly T[],\n    columns: readonly CsvColumn<T>[],\n    options: CsvOptions = {},\n): string {\n    const { delimiter = \",\", bom = true } = options;\n\n    const lines = [columns.map((column) => escapeField(column.header, delimiter)).join(delimiter)];\n\n    for (const row of rows) {\n        const cells = columns.map((column) => {\n            const raw = column.csv\n                ? column.csv(row)\n                : (row as Record<string, unknown>)[column.key as string];\n            return escapeField(cellText(raw), delimiter);\n        });\n        lines.push(cells.join(delimiter));\n    }\n\n    return `${bom ? BOM : \"\"}${lines.join(\"\\r\\n\")}`;\n}\n\n/**\n * Build a CSV and hand it to the user.\n *\n * Goes through {@link shareOrDownloadBlob}, so on a phone it opens the native\n * share sheet and everywhere else it downloads — the same path every other\n * generated artifact in the SDK takes, instead of a fourth hand-rolled `<a\n * download>`.\n *\n * @example\n * await downloadCsv(users, COLUMNS, \"usuarios.csv\");\n *\n * @param rows - The rows to export.\n * @param columns - Columns, in the order they should appear.\n * @param fileName - File name offered to the user. Default `\"export.csv\"`.\n * @param options - Delimiter and BOM, forwarded to {@link toCsv}.\n * @returns A promise that resolves once the share or download completes.\n */\nexport async function downloadCsv<T>(\n    rows: readonly T[],\n    columns: readonly CsvColumn<T>[],\n    fileName = \"export.csv\",\n    options: CsvOptions = {},\n): Promise<void> {\n    const blob = new Blob([toCsv(rows, columns, options)], {\n        type: \"text/csv;charset=utf-8\",\n    });\n    await shareOrDownloadBlob(blob, fileName);\n}\n"],"mappings":";;AAeA,IAAM,IAAM;AA2CZ,SAAS,EAAY,GAAe,GAA2B;CAO3D,OALI,EAAM,SAAS,CAAS,KACxB,EAAM,SAAS,IAAG,KAClB,EAAM,SAAS,IAAI,KACnB,EAAM,SAAS,IAAI,IAEhB,IAAI,EAAM,WAAW,MAAK,MAAI,EAAE,KADhB;AAE3B;AAYA,SAAS,EAAS,GAAwB;CAGtC,OAFI,KAAU,OAAoC,KAC9C,aAAiB,OAAa,EAAM,YAAY,IAC7C,OAAO,CAAK;AACvB;AAsBA,SAAgB,EACZ,GACA,GACA,IAAsB,CAAC,GACjB;CACN,IAAM,EAAE,eAAY,KAAK,SAAM,OAAS,GAElC,IAAQ,CAAC,EAAQ,KAAK,MAAW,EAAY,EAAO,QAAQ,CAAS,CAAC,CAAC,CAAC,KAAK,CAAS,CAAC;CAE7F,KAAK,IAAM,KAAO,GAAM;EACpB,IAAM,IAAQ,EAAQ,KAAK,MAIhB,EAAY,EAHP,EAAO,MACb,EAAO,IAAI,CAAG,IACb,EAAgC,EAAO,IACf,GAAG,CAAS,CAC9C;EACD,EAAM,KAAK,EAAM,KAAK,CAAS,CAAC;CACpC;CAEA,OAAO,GAAG,IAAM,IAAM,KAAK,EAAM,KAAK,MAAM;AAChD;AAmBA,eAAsB,EAClB,GACA,GACA,IAAW,cACX,IAAsB,CAAC,GACV;CACb,IAAM,IAAO,IAAI,KAAK,CAAC,EAAM,GAAM,GAAS,CAAO,CAAC,GAAG,EACnD,MAAM,yBACV,CAAC;CACD,MAAM,EAAoB,GAAM,CAAQ;AAC5C"}
+{"version":3,"file":"csv.js","names":[],"sources":["../../src/utils/csv.ts"],"sourcesContent":["/**\n * @tempest-limits param-count — `downloadCsv(rows, columns, \"usuarios.csv\")` reads\n * in the order the sentence does, and its two trailing parameters have defaults,\n * so the common call passes three. Wrapping them in an object would break every\n * caller of a published export for no gain in what the call site says.\n */\n// CSV that survives contact with real data. Every app writes this by hand and\n// every hand-written version gets the same two things wrong: a value containing\n// the delimiter splits the row, and a value containing a quote breaks the quoting\n// it was supposed to be protected by. Both are one-liners in RFC 4180 and neither\n// is obvious until a customer's name has a comma in it.\n\nimport { shareOrDownloadBlob } from \"../share/share-or-download\";\n\n/**\n * Byte order mark, as the character `String.prototype` sees it.\n *\n * Excel on a pt-BR install reads a BOM-less UTF-8 file as Latin-1 and turns\n * every accented name into mojibake. It is three bytes to avoid a support\n * ticket, so it is on by default.\n */\nconst BOM = \"\\uFEFF\";\n\n/** One column of the exported file. */\nexport interface CsvColumn<T> {\n    /** Property of the row this column reads from. Doubles as the column key. */\n    key: keyof T;\n    /** Column heading, written to the first line. */\n    header: string;\n    /**\n     * Value for the file. Defaults to `String(row[key])`, with nullish becoming an\n     * empty field.\n     *\n     * A `DataTableColumn` renders cells to `ReactNode`, which cannot be written to\n     * a text file — a badge or a link would serialize as `[object Object]`. Give\n     * the column this accessor and the export says what the badge said.\n     */\n    csv?: (row: T) => string | number | boolean | null | undefined;\n}\n\n/** Options for {@link toCsv}. */\nexport interface CsvOptions {\n    /**\n     * Field separator. Default `\",\"`.\n     *\n     * Use `\";\"` for Excel on a locale whose decimal separator is the comma —\n     * which is every pt-BR install — otherwise it opens the file in one column.\n     */\n    delimiter?: \",\" | \";\";\n    /** Prefix the output with a UTF-8 BOM. Default `true`. */\n    bom?: boolean;\n}\n\n/**\n * Quote one field per RFC 4180.\n *\n * A field is quoted when it contains the delimiter, a double quote, or a line\n * break; inside a quoted field, each double quote is doubled. Fields that need\n * none of this are written bare, which keeps the common file readable.\n *\n * @param value - The already-stringified field.\n * @param delimiter - The separator in use, which decides part of the quoting.\n * @returns The field, quoted if it has to be.\n */\nfunction escapeField(value: string, delimiter: string): string {\n    const mustQuote =\n        value.includes(delimiter) ||\n        value.includes('\"') ||\n        value.includes(\"\\n\") ||\n        value.includes(\"\\r\");\n    if (!mustQuote) return value;\n    return `\"${value.replaceAll('\"', '\"\"')}\"`;\n}\n\n/**\n * Stringify one cell, keeping the difference between \"no value\" and \"zero\".\n *\n * `null` and `undefined` become an empty field; `0` and `false` are values\n * somebody chose and are written out. Getting this backwards is how an export\n * ends up under-reporting every row that legitimately holds a zero.\n *\n * @param value - The raw cell value.\n * @returns The text to write.\n */\nfunction cellText(value: unknown): string {\n    if (value === null || value === undefined) return \"\";\n    if (value instanceof Date) return value.toISOString();\n    return String(value);\n}\n\n/**\n * Serialize rows to CSV text, RFC 4180 style.\n *\n * Rows are separated by `\\r\\n` — the RFC's terminator and the one Excel is least\n * surprised by. A row is emitted for the header even when `rows` is empty, so the\n * person who opens the file sees which columns they asked for instead of a blank\n * document.\n *\n * @example\n * const csv = toCsv(users, [\n *     { key: \"name\", header: \"Nome\" },\n *     { key: \"email\", header: \"E-mail\" },\n *     { key: \"plan\", header: \"Plano\", csv: (user) => user.plan.label },\n * ]);\n *\n * @param rows - The rows to export.\n * @param columns - Columns, in the order they should appear.\n * @param options - Delimiter and BOM.\n * @returns The complete file contents.\n */\nexport function toCsv<T>(\n    rows: readonly T[],\n    columns: readonly CsvColumn<T>[],\n    options: CsvOptions = {},\n): string {\n    const { delimiter = \",\", bom = true } = options;\n\n    const lines = [columns.map((column) => escapeField(column.header, delimiter)).join(delimiter)];\n\n    for (const row of rows) {\n        const cells = columns.map((column) => {\n            const raw = column.csv\n                ? column.csv(row)\n                : (row as Record<string, unknown>)[column.key as string];\n            return escapeField(cellText(raw), delimiter);\n        });\n        lines.push(cells.join(delimiter));\n    }\n\n    return `${bom ? BOM : \"\"}${lines.join(\"\\r\\n\")}`;\n}\n\n/**\n * Build a CSV and hand it to the user.\n *\n * Goes through {@link shareOrDownloadBlob}, so on a phone it opens the native\n * share sheet and everywhere else it downloads — the same path every other\n * generated artifact in the SDK takes, instead of a fourth hand-rolled `<a\n * download>`.\n *\n * @example\n * await downloadCsv(users, COLUMNS, \"usuarios.csv\");\n *\n * @param rows - The rows to export.\n * @param columns - Columns, in the order they should appear.\n * @param fileName - File name offered to the user. Default `\"export.csv\"`.\n * @param options - Delimiter and BOM, forwarded to {@link toCsv}.\n * @returns A promise that resolves once the share or download completes.\n */\nexport async function downloadCsv<T>(\n    rows: readonly T[],\n    columns: readonly CsvColumn<T>[],\n    fileName = \"export.csv\",\n    options: CsvOptions = {},\n): Promise<void> {\n    const blob = new Blob([toCsv(rows, columns, options)], {\n        type: \"text/csv;charset=utf-8\",\n    });\n    await shareOrDownloadBlob(blob, fileName);\n}\n"],"mappings":";;AAqBA,IAAM,IAAM;AA2CZ,SAAS,EAAY,GAAe,GAA2B;CAO3D,OALI,EAAM,SAAS,CAAS,KACxB,EAAM,SAAS,IAAG,KAClB,EAAM,SAAS,IAAI,KACnB,EAAM,SAAS,IAAI,IAEhB,IAAI,EAAM,WAAW,MAAK,MAAI,EAAE,KADhB;AAE3B;AAYA,SAAS,EAAS,GAAwB;CAGtC,OAFI,KAAU,OAAoC,KAC9C,aAAiB,OAAa,EAAM,YAAY,IAC7C,OAAO,CAAK;AACvB;AAsBA,SAAgB,EACZ,GACA,GACA,IAAsB,CAAC,GACjB;CACN,IAAM,EAAE,eAAY,KAAK,SAAM,OAAS,GAElC,IAAQ,CAAC,EAAQ,KAAK,MAAW,EAAY,EAAO,QAAQ,CAAS,CAAC,CAAC,CAAC,KAAK,CAAS,CAAC;CAE7F,KAAK,IAAM,KAAO,GAAM;EACpB,IAAM,IAAQ,EAAQ,KAAK,MAIhB,EAAY,EAHP,EAAO,MACb,EAAO,IAAI,CAAG,IACb,EAAgC,EAAO,IACf,GAAG,CAAS,CAC9C;EACD,EAAM,KAAK,EAAM,KAAK,CAAS,CAAC;CACpC;CAEA,OAAO,GAAG,IAAM,IAAM,KAAK,EAAM,KAAK,MAAM;AAChD;AAmBA,eAAsB,EAClB,GACA,GACA,IAAW,cACX,IAAsB,CAAC,GACV;CACb,IAAM,IAAO,IAAI,KAAK,CAAC,EAAM,GAAM,GAAS,CAAO,CAAC,GAAG,EACnD,MAAM,yBACV,CAAC;CACD,MAAM,EAAoB,GAAM,CAAQ;AAC5C"}

package/dist/vite/tempest-pwa-dev-sw.cjs

@@ -1,2 +1,2 @@
-const e=require("./base-url.cjs");let t=require("node:path");function n(n={}){let{swSrc:r=`src/sw.ts`,swUrl:i=`/sw.js`,manifestUrl:a=`/precache-manifest.json`,enabled:o=!0}=n,s=process.cwd(),c=`/`;function l(t,n){if(t===n)return!0;let r=e.basePrefix(c);return r!==`/`&&t===`${r}${n.replace(/^\//,``)}`}let u=null,d=null;async function f(){return u||(u=await(await import(`esbuild`)).context({entryPoints:[(0,t.resolve)(s,r)],bundle:!0,format:`iife`,platform:`browser`,target:`es2020`,write:!1,absWorkingDir:s,logLevel:`silent`}),u)}function p(){if(d)return d;let e=(async()=>{let e=(await(await f()).rebuild()).outputFiles?.[0]?.text;if(e===void 0)throw Error(`esbuild produced no service-worker output`);return e})();d=e;let t=()=>{d=null};return e.then(t,t),e}async function m(){let e=u;u=null,d=null,await e?.dispose()}return{name:`tempest-pwa-dev-sw`,apply:`serve`,async buildEnd(){await m()},configResolved(e){s=e.root??process.cwd(),c=e.base??`/`},configureServer(e){o&&(e.httpServer?.once(`close`,()=>void m()),e.middlewares.use(async(e,t,n)=>{let r=(e.url??``).split(`?`)[0];if(l(r,i)){try{let e=await p();t.setHeader(`Content-Type`,`application/javascript`),t.setHeader(`Service-Worker-Allowed`,`/`),t.setHeader(`Cache-Control`,`no-cache`),t.end(e)}catch(e){t.statusCode=500,t.end(`// SW dev build failed:\n// ${String(e)}`)}return}if(l(r,a)){t.setHeader(`Content-Type`,`application/json`),t.setHeader(`Cache-Control`,`no-cache`),t.end(JSON.stringify({version:`dev`,urls:[]}));return}n()}))}}}exports.tempestPwaDevSw=n;
+const e=require("./base-url.cjs");let t=require("node:path");function n(e){return async(t,n,r)=>{let i=(t.url??``).split(`?`)[0];if(e.matches(i,e.swUrl)){try{let t=await e.buildWorker();n.setHeader(`Content-Type`,`application/javascript`),n.setHeader(`Service-Worker-Allowed`,`/`),n.setHeader(`Cache-Control`,`no-cache`),n.end(t)}catch(e){n.statusCode=500,n.end(`// SW dev build failed:\n// ${String(e)}`)}return}if(e.matches(i,e.manifestUrl)){n.setHeader(`Content-Type`,`application/json`),n.setHeader(`Cache-Control`,`no-cache`),n.end(JSON.stringify({version:`dev`,urls:[]}));return}r()}}function r(r={}){let{swSrc:i=`src/sw.ts`,swUrl:a=`/sw.js`,manifestUrl:o=`/precache-manifest.json`,enabled:s=!0}=r,c=process.cwd(),l=`/`;function u(t,n){if(t===n)return!0;let r=e.basePrefix(l);return r!==`/`&&t===`${r}${n.replace(/^\//,``)}`}let d=null,f=null;async function p(){return d||(d=await(await import(`esbuild`)).context({entryPoints:[(0,t.resolve)(c,i)],bundle:!0,format:`iife`,platform:`browser`,target:`es2020`,write:!1,absWorkingDir:c,logLevel:`silent`}),d)}function m(){if(f)return f;let e=(async()=>{let e=(await(await p()).rebuild()).outputFiles?.[0]?.text;if(e===void 0)throw Error(`esbuild produced no service-worker output`);return e})();f=e;let t=()=>{f=null};return e.then(t,t),e}async function h(){let e=d;d=null,f=null,await e?.dispose()}return{name:`tempest-pwa-dev-sw`,apply:`serve`,async buildEnd(){await h()},configResolved(e){c=e.root??process.cwd(),l=e.base??`/`},configureServer(e){s&&(e.httpServer?.once(`close`,()=>void h()),e.middlewares.use(n({swUrl:a,manifestUrl:o,matches:u,buildWorker:m})))}}}exports.tempestPwaDevSw=r;
 //# sourceMappingURL=tempest-pwa-dev-sw.cjs.map

package/dist/vite/tempest-pwa-dev-sw.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tempest-pwa-dev-sw.cjs","names":[],"sources":["../../src/vite/tempest-pwa-dev-sw.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport { basePrefix } from \"./base-url\";\nimport type { TempestVitePlugin } from \"./tempest-pwa-manifest\";\n\n/** Options for {@link tempestPwaDevSw}. */\nexport interface TempestPwaDevSwOptions {\n    /** Service-worker entry, relative to the project root. Default `src/sw.ts`. */\n    swSrc?: string;\n    /**\n     * URL the worker is served at (must match `registerServiceWorker`).\n     * Default `/sw.js`.\n     *\n     * Write it relative to the site root; requests are matched against both the\n     * bare path and the path prefixed with the resolved Vite `base`, so a\n     * project served from a subpath is handled without extra configuration.\n     */\n    swUrl?: string;\n    /**\n     * Dev URL of the precache manifest. Default `/precache-manifest.json`.\n     * Matched the same way as {@link TempestPwaDevSwOptions.swUrl}.\n     */\n    manifestUrl?: string;\n    /** Serve the worker in dev. Default `true`; set `false` to opt out. */\n    enabled?: boolean;\n}\n\n/**\n * Dev-server plugin that makes the service worker available under `npm run dev`.\n *\n * The production worker is bundled at build time (`vite.sw.config.ts`), so in\n * dev there is no `/sw.js` to register. This plugin compiles `swSrc` on the fly\n * with esbuild — through one incremental context, not a cold build per request —\n * and serves it as a classic worker, plus an empty `precache-manifest.json` (there are no hashed build assets to precache in\n * dev — push and runtime caching still work). It closes the \"SW in dev\" gap\n * that otherwise only `vite-plugin-pwa`'s `devOptions` covered.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaDevSw } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({ plugins: [tempestPwaDevSw()] });\n */\nexport function tempestPwaDevSw(options: TempestPwaDevSwOptions = {}): TempestVitePlugin {\n    const {\n        swSrc = \"src/sw.ts\",\n        swUrl = \"/sw.js\",\n        manifestUrl = \"/precache-manifest.json\",\n        enabled = true,\n    } = options;\n\n    let root = process.cwd();\n    let base = \"/\";\n\n    /**\n     * Whether a request path addresses `target`.\n     *\n     * Both the bare path and the base-prefixed one are accepted. Which of the\n     * two arrives depends on where this middleware lands relative to Vite's own\n     * base handling, and a project served from a subpath would otherwise never\n     * match — the browser asks for `/app/sw.js` while the option says `/sw.js`.\n     */\n    function matches(url: string, target: string): boolean {\n        if (url === target) return true;\n        const prefix = basePrefix(base);\n        if (prefix === \"/\") return false;\n        return url === `${prefix}${target.replace(/^\\//, \"\")}`;\n    }\n\n    /**\n     * The slice of esbuild's incremental API this plugin uses.\n     *\n     * Typed structurally rather than imported: `esbuild` is not a dependency of\n     * this package. It is resolved at runtime from the app's own tree, where Vite\n     * already brings it, so importing its types would add a build-time dependency\n     * the runtime does not have.\n     */\n    interface BuildContext {\n        rebuild(): Promise<{ outputFiles?: readonly { text: string }[] }>;\n        dispose(): Promise<void>;\n    }\n\n    let context: BuildContext | null = null;\n    let pending: Promise<string> | null = null;\n\n    /**\n     * The incremental build context, created on the first request that needs it.\n     *\n     * Lazy because a project that never registers a worker should not pay for an\n     * esbuild child process, and because `apply: \"serve\"` still loads this module\n     * in a build.\n     *\n     * @returns The context, reused across requests.\n     */\n    async function ensureContext(): Promise<BuildContext> {\n        if (context) return context;\n        const esbuild = (await import(\"esbuild\")) as unknown as {\n            context(options: Record<string, unknown>): Promise<BuildContext>;\n        };\n        context = await esbuild.context({\n            entryPoints: [resolve(root, swSrc)],\n            bundle: true,\n            format: \"iife\",\n            platform: \"browser\",\n            target: \"es2020\",\n            write: false,\n            absWorkingDir: root,\n            logLevel: \"silent\",\n        });\n        return context;\n    }\n\n    /**\n     * Bundle the worker, reusing the previous graph.\n     *\n     * `esbuild.build()` per request was a cold bundle every time, and the request\n     * count is not one per session: `Cache-Control: no-cache` guarantees one per\n     * page load, and Chrome re-fetches the worker script on every navigation and\n     * on its own update checks. `rebuild()` reuses the graph and only redoes what\n     * changed on disk.\n     *\n     * Single-flight, because those requests arrive in bursts and esbuild does not\n     * promise anything about concurrent `rebuild()` calls on one context. Callers\n     * that land while a bundle is in flight share its result, which is the right\n     * answer anyway — they asked for the same file at the same moment.\n     *\n     * @returns The bundled worker source.\n     */\n    function buildWorker(): Promise<string> {\n        if (pending) return pending;\n\n        const run = (async (): Promise<string> => {\n            const ctx = await ensureContext();\n            const result = await ctx.rebuild();\n            const text = result.outputFiles?.[0]?.text;\n            if (text === undefined) throw new Error(\"esbuild produced no service-worker output\");\n            return text;\n        })();\n\n        pending = run;\n        const clear = (): void => {\n            pending = null;\n        };\n        run.then(clear, clear);\n        return run;\n    }\n\n    /**\n     * Tear the context down, releasing esbuild's child process.\n     *\n     * Idempotent, because it is wired to both the dev server closing and the\n     * plugin's `buildEnd`. Without it, restarting the dev server leaks one esbuild\n     * process per restart.\n     */\n    async function disposeContext(): Promise<void> {\n        const current = context;\n        context = null;\n        pending = null;\n        await current?.dispose();\n    }\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-dev-sw\",\n        apply: \"serve\",\n        async buildEnd() {\n            await disposeContext();\n        },\n        configResolved(config) {\n            root = config.root ?? process.cwd();\n            base = config.base ?? \"/\";\n        },\n        configureServer(server) {\n            if (!enabled) return;\n\n            server.httpServer?.once(\"close\", () => void disposeContext());\n\n            server.middlewares.use(async (req, res, next) => {\n                const url = (req.url ?? \"\").split(\"?\")[0];\n\n                if (matches(url, swUrl)) {\n                    try {\n                        const source = await buildWorker();\n                        res.setHeader(\"Content-Type\", \"application/javascript\");\n                        res.setHeader(\"Service-Worker-Allowed\", \"/\");\n                        res.setHeader(\"Cache-Control\", \"no-cache\");\n                        res.end(source);\n                    } catch (error) {\n                        res.statusCode = 500;\n                        res.end(`// SW dev build failed:\\n// ${String(error)}`);\n                    }\n                    return;\n                }\n\n                if (matches(url, manifestUrl)) {\n                    res.setHeader(\"Content-Type\", \"application/json\");\n                    res.setHeader(\"Cache-Control\", \"no-cache\");\n                    res.end(JSON.stringify({ version: \"dev\", urls: [] }));\n                    return;\n                }\n\n                next();\n            });\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n"],"mappings":"6DA2CA,SAAgB,EAAgB,EAAkC,CAAC,EAAsB,CACrF,GAAM,CACF,QAAQ,YACR,QAAQ,SACR,cAAc,0BACd,UAAU,IACV,EAEA,EAAO,QAAQ,IAAI,EACnB,EAAO,IAUX,SAAS,EAAQ,EAAa,EAAyB,CACnD,GAAI,IAAQ,EAAQ,MAAO,GAC3B,IAAM,EAAS,EAAA,WAAW,CAAI,EAE9B,OADI,IAAW,KACR,IAAQ,GAAG,IAAS,EAAO,QAAQ,MAAO,EAAE,GACvD,CAeA,IAAI,EAA+B,KAC/B,EAAkC,KAWtC,eAAe,GAAuC,CAelD,OAdI,IAIJ,EAAU,MAAM,MAHO,OAAO,WAAA,CAGN,QAAQ,CAC5B,YAAa,EAAA,EAAC,EAAA,QAAA,CAAQ,EAAM,CAAK,CAAC,EAClC,OAAQ,GACR,OAAQ,OACR,SAAU,UACV,OAAQ,SACR,MAAO,GACP,cAAe,EACf,SAAU,QACd,CAAC,EACM,EACX,CAkBA,SAAS,GAA+B,CACpC,GAAI,EAAS,OAAO,EAEpB,IAAM,GAAO,SAA6B,CAGtC,IAAM,GAAO,MADQ,MADH,EAAc,EAAA,CACP,QAAQ,EAAA,CACb,cAAc,EAAE,EAAE,KACtC,GAAI,IAAS,IAAA,GAAW,MAAU,MAAM,2CAA2C,EACnF,OAAO,CACX,EAAA,CAAG,EAEH,EAAU,EACV,IAAM,MAAoB,CACtB,EAAU,IACd,EAEA,OADA,EAAI,KAAK,EAAO,CAAK,EACd,CACX,CASA,eAAe,GAAgC,CAC3C,IAAM,EAAU,EAChB,EAAU,KACV,EAAU,KACV,MAAM,GAAS,QAAQ,CAC3B,CA8CA,MAAO,CA3CH,KAAM,qBACN,MAAO,QACP,MAAM,UAAW,CACb,MAAM,EAAe,CACzB,EACA,eAAe,EAAQ,CACnB,EAAO,EAAO,MAAQ,QAAQ,IAAI,EAClC,EAAO,EAAO,MAAQ,GAC1B,EACA,gBAAgB,EAAQ,CACf,IAEL,EAAO,YAAY,KAAK,YAAe,KAAK,EAAe,CAAC,EAE5D,EAAO,YAAY,IAAI,MAAO,EAAK,EAAK,IAAS,CAC7C,IAAM,GAAO,EAAI,KAAO,GAAA,CAAI,MAAM,GAAG,CAAC,CAAC,GAEvC,GAAI,EAAQ,EAAK,CAAK,EAAG,CACrB,GAAI,CACA,IAAM,EAAS,MAAM,EAAY,EACjC,EAAI,UAAU,eAAgB,wBAAwB,EACtD,EAAI,UAAU,yBAA0B,GAAG,EAC3C,EAAI,UAAU,gBAAiB,UAAU,EACzC,EAAI,IAAI,CAAM,CAClB,OAAS,EAAO,CACZ,EAAI,WAAa,IACjB,EAAI,IAAI,+BAA+B,OAAO,CAAK,GAAG,CAC1D,CACA,MACJ,CAEA,GAAI,EAAQ,EAAK,CAAW,EAAG,CAC3B,EAAI,UAAU,eAAgB,kBAAkB,EAChD,EAAI,UAAU,gBAAiB,UAAU,EACzC,EAAI,IAAI,KAAK,UAAU,CAAE,QAAS,MAAO,KAAM,CAAC,CAAE,CAAC,CAAC,EACpD,MACJ,CAEA,EAAK,CACT,CAAC,EACL,CAGG,CACX"}
+{"version":3,"file":"tempest-pwa-dev-sw.cjs","names":[],"sources":["../../src/vite/tempest-pwa-dev-sw.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport { basePrefix } from \"./base-url\";\nimport type { TempestVitePlugin } from \"./tempest-pwa-manifest\";\n\n/** Options for {@link tempestPwaDevSw}. */\nexport interface TempestPwaDevSwOptions {\n    /** Service-worker entry, relative to the project root. Default `src/sw.ts`. */\n    swSrc?: string;\n    /**\n     * URL the worker is served at (must match `registerServiceWorker`).\n     * Default `/sw.js`.\n     *\n     * Write it relative to the site root; requests are matched against both the\n     * bare path and the path prefixed with the resolved Vite `base`, so a\n     * project served from a subpath is handled without extra configuration.\n     */\n    swUrl?: string;\n    /**\n     * Dev URL of the precache manifest. Default `/precache-manifest.json`.\n     * Matched the same way as {@link TempestPwaDevSwOptions.swUrl}.\n     */\n    manifestUrl?: string;\n    /** Serve the worker in dev. Default `true`; set `false` to opt out. */\n    enabled?: boolean;\n}\n\n/**\n * The dev middleware: serve the compiled worker, and a placeholder manifest.\n *\n * Extracted from the plugin so the request handling reads on its own — the\n * plugin body is then only wiring. The manifest is deliberately empty in dev:\n * precaching a set of URLs Vite rewrites on every change would serve stale\n * modules, and the worker's runtime routes still work without it.\n *\n * @param deps - The two URLs, the path matcher and the incremental build.\n * @returns A connect-style middleware.\n */\nfunction createDevSwMiddleware(deps: {\n    swUrl: string;\n    manifestUrl: string;\n    matches: (url: string, target: string) => boolean;\n    buildWorker: () => Promise<string>;\n}): (\n    req: { url?: string },\n    res: {\n        statusCode?: number;\n        setHeader: (name: string, value: string) => void;\n        end: (body: string) => void;\n    },\n    next: () => void,\n) => Promise<void> {\n    return async (req, res, next) => {\n        const url = (req.url ?? \"\").split(\"?\")[0];\n\n        if (deps.matches(url, deps.swUrl)) {\n            try {\n                const source = await deps.buildWorker();\n                res.setHeader(\"Content-Type\", \"application/javascript\");\n                res.setHeader(\"Service-Worker-Allowed\", \"/\");\n                res.setHeader(\"Cache-Control\", \"no-cache\");\n                res.end(source);\n            } catch (error) {\n                res.statusCode = 500;\n                res.end(`// SW dev build failed:\\n// ${String(error)}`);\n            }\n            return;\n        }\n\n        if (deps.matches(url, deps.manifestUrl)) {\n            res.setHeader(\"Content-Type\", \"application/json\");\n            res.setHeader(\"Cache-Control\", \"no-cache\");\n            res.end(JSON.stringify({ version: \"dev\", urls: [] }));\n            return;\n        }\n\n        next();\n    };\n}\n\n/**\n * Dev-server plugin that makes the service worker available under `npm run dev`.\n *\n * The production worker is bundled at build time (`vite.sw.config.ts`), so in\n * dev there is no `/sw.js` to register. This plugin compiles `swSrc` on the fly\n * with esbuild — through one incremental context, not a cold build per request —\n * and serves it as a classic worker, plus an empty `precache-manifest.json` (there are no hashed build assets to precache in\n * dev — push and runtime caching still work). It closes the \"SW in dev\" gap\n * that otherwise only `vite-plugin-pwa`'s `devOptions` covered.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaDevSw } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({ plugins: [tempestPwaDevSw()] });\n */\nexport function tempestPwaDevSw(options: TempestPwaDevSwOptions = {}): TempestVitePlugin {\n    const {\n        swSrc = \"src/sw.ts\",\n        swUrl = \"/sw.js\",\n        manifestUrl = \"/precache-manifest.json\",\n        enabled = true,\n    } = options;\n\n    let root = process.cwd();\n    let base = \"/\";\n\n    /**\n     * Whether a request path addresses `target`.\n     *\n     * Both the bare path and the base-prefixed one are accepted. Which of the\n     * two arrives depends on where this middleware lands relative to Vite's own\n     * base handling, and a project served from a subpath would otherwise never\n     * match — the browser asks for `/app/sw.js` while the option says `/sw.js`.\n     */\n    function matches(url: string, target: string): boolean {\n        if (url === target) return true;\n        const prefix = basePrefix(base);\n        if (prefix === \"/\") return false;\n        return url === `${prefix}${target.replace(/^\\//, \"\")}`;\n    }\n\n    /**\n     * The slice of esbuild's incremental API this plugin uses.\n     *\n     * Typed structurally rather than imported: `esbuild` is not a dependency of\n     * this package. It is resolved at runtime from the app's own tree, where Vite\n     * already brings it, so importing its types would add a build-time dependency\n     * the runtime does not have.\n     */\n    interface BuildContext {\n        rebuild(): Promise<{ outputFiles?: readonly { text: string }[] }>;\n        dispose(): Promise<void>;\n    }\n\n    let context: BuildContext | null = null;\n    let pending: Promise<string> | null = null;\n\n    /**\n     * The incremental build context, created on the first request that needs it.\n     *\n     * Lazy because a project that never registers a worker should not pay for an\n     * esbuild child process, and because `apply: \"serve\"` still loads this module\n     * in a build.\n     *\n     * @returns The context, reused across requests.\n     */\n    async function ensureContext(): Promise<BuildContext> {\n        if (context) return context;\n        const esbuild = (await import(\"esbuild\")) as unknown as {\n            context(options: Record<string, unknown>): Promise<BuildContext>;\n        };\n        context = await esbuild.context({\n            entryPoints: [resolve(root, swSrc)],\n            bundle: true,\n            format: \"iife\",\n            platform: \"browser\",\n            target: \"es2020\",\n            write: false,\n            absWorkingDir: root,\n            logLevel: \"silent\",\n        });\n        return context;\n    }\n\n    /**\n     * Bundle the worker, reusing the previous graph.\n     *\n     * `esbuild.build()` per request was a cold bundle every time, and the request\n     * count is not one per session: `Cache-Control: no-cache` guarantees one per\n     * page load, and Chrome re-fetches the worker script on every navigation and\n     * on its own update checks. `rebuild()` reuses the graph and only redoes what\n     * changed on disk.\n     *\n     * Single-flight, because those requests arrive in bursts and esbuild does not\n     * promise anything about concurrent `rebuild()` calls on one context. Callers\n     * that land while a bundle is in flight share its result, which is the right\n     * answer anyway — they asked for the same file at the same moment.\n     *\n     * @returns The bundled worker source.\n     */\n    function buildWorker(): Promise<string> {\n        if (pending) return pending;\n\n        const run = (async (): Promise<string> => {\n            const ctx = await ensureContext();\n            const result = await ctx.rebuild();\n            const text = result.outputFiles?.[0]?.text;\n            if (text === undefined) throw new Error(\"esbuild produced no service-worker output\");\n            return text;\n        })();\n\n        pending = run;\n        const clear = (): void => {\n            pending = null;\n        };\n        run.then(clear, clear);\n        return run;\n    }\n\n    /**\n     * Tear the context down, releasing esbuild's child process.\n     *\n     * Idempotent, because it is wired to both the dev server closing and the\n     * plugin's `buildEnd`. Without it, restarting the dev server leaks one esbuild\n     * process per restart.\n     */\n    async function disposeContext(): Promise<void> {\n        const current = context;\n        context = null;\n        pending = null;\n        await current?.dispose();\n    }\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-dev-sw\",\n        apply: \"serve\",\n        async buildEnd() {\n            await disposeContext();\n        },\n        configResolved(config) {\n            root = config.root ?? process.cwd();\n            base = config.base ?? \"/\";\n        },\n        configureServer(server) {\n            if (!enabled) return;\n\n            server.httpServer?.once(\"close\", () => void disposeContext());\n\n            server.middlewares.use(\n                createDevSwMiddleware({ swUrl, manifestUrl, matches, buildWorker }),\n            );\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n"],"mappings":"6DAsCA,SAAS,EAAsB,EAaZ,CACf,OAAO,MAAO,EAAK,EAAK,IAAS,CAC7B,IAAM,GAAO,EAAI,KAAO,GAAA,CAAI,MAAM,GAAG,CAAC,CAAC,GAEvC,GAAI,EAAK,QAAQ,EAAK,EAAK,KAAK,EAAG,CAC/B,GAAI,CACA,IAAM,EAAS,MAAM,EAAK,YAAY,EACtC,EAAI,UAAU,eAAgB,wBAAwB,EACtD,EAAI,UAAU,yBAA0B,GAAG,EAC3C,EAAI,UAAU,gBAAiB,UAAU,EACzC,EAAI,IAAI,CAAM,CAClB,OAAS,EAAO,CACZ,EAAI,WAAa,IACjB,EAAI,IAAI,+BAA+B,OAAO,CAAK,GAAG,CAC1D,CACA,MACJ,CAEA,GAAI,EAAK,QAAQ,EAAK,EAAK,WAAW,EAAG,CACrC,EAAI,UAAU,eAAgB,kBAAkB,EAChD,EAAI,UAAU,gBAAiB,UAAU,EACzC,EAAI,IAAI,KAAK,UAAU,CAAE,QAAS,MAAO,KAAM,CAAC,CAAE,CAAC,CAAC,EACpD,MACJ,CAEA,EAAK,CACT,CACJ,CAkBA,SAAgB,EAAgB,EAAkC,CAAC,EAAsB,CACrF,GAAM,CACF,QAAQ,YACR,QAAQ,SACR,cAAc,0BACd,UAAU,IACV,EAEA,EAAO,QAAQ,IAAI,EACnB,EAAO,IAUX,SAAS,EAAQ,EAAa,EAAyB,CACnD,GAAI,IAAQ,EAAQ,MAAO,GAC3B,IAAM,EAAS,EAAA,WAAW,CAAI,EAE9B,OADI,IAAW,KACR,IAAQ,GAAG,IAAS,EAAO,QAAQ,MAAO,EAAE,GACvD,CAeA,IAAI,EAA+B,KAC/B,EAAkC,KAWtC,eAAe,GAAuC,CAelD,OAdI,IAIJ,EAAU,MAAM,MAHO,OAAO,WAAA,CAGN,QAAQ,CAC5B,YAAa,EAAA,EAAC,EAAA,QAAA,CAAQ,EAAM,CAAK,CAAC,EAClC,OAAQ,GACR,OAAQ,OACR,SAAU,UACV,OAAQ,SACR,MAAO,GACP,cAAe,EACf,SAAU,QACd,CAAC,EACM,EACX,CAkBA,SAAS,GAA+B,CACpC,GAAI,EAAS,OAAO,EAEpB,IAAM,GAAO,SAA6B,CAGtC,IAAM,GAAO,MADQ,MADH,EAAc,EAAA,CACP,QAAQ,EAAA,CACb,cAAc,EAAE,EAAE,KACtC,GAAI,IAAS,IAAA,GAAW,MAAU,MAAM,2CAA2C,EACnF,OAAO,CACX,EAAA,CAAG,EAEH,EAAU,EACV,IAAM,MAAoB,CACtB,EAAU,IACd,EAEA,OADA,EAAI,KAAK,EAAO,CAAK,EACd,CACX,CASA,eAAe,GAAgC,CAC3C,IAAM,EAAU,EAChB,EAAU,KACV,EAAU,KACV,MAAM,GAAS,QAAQ,CAC3B,CAuBA,MAAO,CApBH,KAAM,qBACN,MAAO,QACP,MAAM,UAAW,CACb,MAAM,EAAe,CACzB,EACA,eAAe,EAAQ,CACnB,EAAO,EAAO,MAAQ,QAAQ,IAAI,EAClC,EAAO,EAAO,MAAQ,GAC1B,EACA,gBAAgB,EAAQ,CACf,IAEL,EAAO,YAAY,KAAK,YAAe,KAAK,EAAe,CAAC,EAE5D,EAAO,YAAY,IACf,EAAsB,CAAE,QAAO,cAAa,UAAS,aAAY,CAAC,CACtE,EACJ,CAGG,CACX"}

package/dist/vite/tempest-pwa-dev-sw.js

@@ -1,77 +1,85 @@
 import { basePrefix as e } from "./base-url.js";
 import { resolve as t } from "node:path";
 //#region src/vite/tempest-pwa-dev-sw.ts
-function n(n = {}) {
-	let { swSrc: r = "src/sw.ts", swUrl: i = "/sw.js", manifestUrl: a = "/precache-manifest.json", enabled: o = !0 } = n, s = process.cwd(), c = "/";
-	function l(t, n) {
+function n(e) {
+	return async (t, n, r) => {
+		let i = (t.url ?? "").split("?")[0];
+		if (e.matches(i, e.swUrl)) {
+			try {
+				let t = await e.buildWorker();
+				n.setHeader("Content-Type", "application/javascript"), n.setHeader("Service-Worker-Allowed", "/"), n.setHeader("Cache-Control", "no-cache"), n.end(t);
+			} catch (e) {
+				n.statusCode = 500, n.end(`// SW dev build failed:\n// ${String(e)}`);
+			}
+			return;
+		}
+		if (e.matches(i, e.manifestUrl)) {
+			n.setHeader("Content-Type", "application/json"), n.setHeader("Cache-Control", "no-cache"), n.end(JSON.stringify({
+				version: "dev",
+				urls: []
+			}));
+			return;
+		}
+		r();
+	};
+}
+function r(r = {}) {
+	let { swSrc: i = "src/sw.ts", swUrl: a = "/sw.js", manifestUrl: o = "/precache-manifest.json", enabled: s = !0 } = r, c = process.cwd(), l = "/";
+	function u(t, n) {
 		if (t === n) return !0;
-		let r = e(c);
+		let r = e(l);
 		return r !== "/" && t === `${r}${n.replace(/^\//, "")}`;
 	}
-	let u = null, d = null;
-	async function f() {
-		return u || (u = await (await import("esbuild")).context({
-			entryPoints: [t(s, r)],
+	let d = null, f = null;
+	async function p() {
+		return d || (d = await (await import("esbuild")).context({
+			entryPoints: [t(c, i)],
 			bundle: !0,
 			format: "iife",
 			platform: "browser",
 			target: "es2020",
 			write: !1,
-			absWorkingDir: s,
+			absWorkingDir: c,
 			logLevel: "silent"
-		}), u);
+		}), d);
 	}
-	function p() {
-		if (d) return d;
+	function m() {
+		if (f) return f;
 		let e = (async () => {
-			let e = (await (await f()).rebuild()).outputFiles?.[0]?.text;
+			let e = (await (await p()).rebuild()).outputFiles?.[0]?.text;
 			if (e === void 0) throw Error("esbuild produced no service-worker output");
 			return e;
 		})();
-		d = e;
+		f = e;
 		let t = () => {
-			d = null;
+			f = null;
 		};
 		return e.then(t, t), e;
 	}
-	async function m() {
-		let e = u;
-		u = null, d = null, await e?.dispose();
+	async function h() {
+		let e = d;
+		d = null, f = null, await e?.dispose();
 	}
 	return {
 		name: "tempest-pwa-dev-sw",
 		apply: "serve",
 		async buildEnd() {
-			await m();
+			await h();
 		},
 		configResolved(e) {
-			s = e.root ?? process.cwd(), c = e.base ?? "/";
+			c = e.root ?? process.cwd(), l = e.base ?? "/";
 		},
 		configureServer(e) {
-			o && (e.httpServer?.once("close", () => void m()), e.middlewares.use(async (e, t, n) => {
-				let r = (e.url ?? "").split("?")[0];
-				if (l(r, i)) {
-					try {
-						let e = await p();
-						t.setHeader("Content-Type", "application/javascript"), t.setHeader("Service-Worker-Allowed", "/"), t.setHeader("Cache-Control", "no-cache"), t.end(e);
-					} catch (e) {
-						t.statusCode = 500, t.end(`// SW dev build failed:\n// ${String(e)}`);
-					}
-					return;
-				}
-				if (l(r, a)) {
-					t.setHeader("Content-Type", "application/json"), t.setHeader("Cache-Control", "no-cache"), t.end(JSON.stringify({
-						version: "dev",
-						urls: []
-					}));
-					return;
-				}
-				n();
-			}));
+			s && (e.httpServer?.once("close", () => void h()), e.middlewares.use(n({
+				swUrl: a,
+				manifestUrl: o,
+				matches: u,
+				buildWorker: m
+			})));
 		}
 	};
 }
 //#endregion
-export { n as tempestPwaDevSw };
+export { r as tempestPwaDevSw };
 
 //# sourceMappingURL=tempest-pwa-dev-sw.js.map

package/dist/vite/tempest-pwa-dev-sw.js.map

@@ -1 +1 @@
-{"version":3,"file":"tempest-pwa-dev-sw.js","names":[],"sources":["../../src/vite/tempest-pwa-dev-sw.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport { basePrefix } from \"./base-url\";\nimport type { TempestVitePlugin } from \"./tempest-pwa-manifest\";\n\n/** Options for {@link tempestPwaDevSw}. */\nexport interface TempestPwaDevSwOptions {\n    /** Service-worker entry, relative to the project root. Default `src/sw.ts`. */\n    swSrc?: string;\n    /**\n     * URL the worker is served at (must match `registerServiceWorker`).\n     * Default `/sw.js`.\n     *\n     * Write it relative to the site root; requests are matched against both the\n     * bare path and the path prefixed with the resolved Vite `base`, so a\n     * project served from a subpath is handled without extra configuration.\n     */\n    swUrl?: string;\n    /**\n     * Dev URL of the precache manifest. Default `/precache-manifest.json`.\n     * Matched the same way as {@link TempestPwaDevSwOptions.swUrl}.\n     */\n    manifestUrl?: string;\n    /** Serve the worker in dev. Default `true`; set `false` to opt out. */\n    enabled?: boolean;\n}\n\n/**\n * Dev-server plugin that makes the service worker available under `npm run dev`.\n *\n * The production worker is bundled at build time (`vite.sw.config.ts`), so in\n * dev there is no `/sw.js` to register. This plugin compiles `swSrc` on the fly\n * with esbuild — through one incremental context, not a cold build per request —\n * and serves it as a classic worker, plus an empty `precache-manifest.json` (there are no hashed build assets to precache in\n * dev — push and runtime caching still work). It closes the \"SW in dev\" gap\n * that otherwise only `vite-plugin-pwa`'s `devOptions` covered.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaDevSw } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({ plugins: [tempestPwaDevSw()] });\n */\nexport function tempestPwaDevSw(options: TempestPwaDevSwOptions = {}): TempestVitePlugin {\n    const {\n        swSrc = \"src/sw.ts\",\n        swUrl = \"/sw.js\",\n        manifestUrl = \"/precache-manifest.json\",\n        enabled = true,\n    } = options;\n\n    let root = process.cwd();\n    let base = \"/\";\n\n    /**\n     * Whether a request path addresses `target`.\n     *\n     * Both the bare path and the base-prefixed one are accepted. Which of the\n     * two arrives depends on where this middleware lands relative to Vite's own\n     * base handling, and a project served from a subpath would otherwise never\n     * match — the browser asks for `/app/sw.js` while the option says `/sw.js`.\n     */\n    function matches(url: string, target: string): boolean {\n        if (url === target) return true;\n        const prefix = basePrefix(base);\n        if (prefix === \"/\") return false;\n        return url === `${prefix}${target.replace(/^\\//, \"\")}`;\n    }\n\n    /**\n     * The slice of esbuild's incremental API this plugin uses.\n     *\n     * Typed structurally rather than imported: `esbuild` is not a dependency of\n     * this package. It is resolved at runtime from the app's own tree, where Vite\n     * already brings it, so importing its types would add a build-time dependency\n     * the runtime does not have.\n     */\n    interface BuildContext {\n        rebuild(): Promise<{ outputFiles?: readonly { text: string }[] }>;\n        dispose(): Promise<void>;\n    }\n\n    let context: BuildContext | null = null;\n    let pending: Promise<string> | null = null;\n\n    /**\n     * The incremental build context, created on the first request that needs it.\n     *\n     * Lazy because a project that never registers a worker should not pay for an\n     * esbuild child process, and because `apply: \"serve\"` still loads this module\n     * in a build.\n     *\n     * @returns The context, reused across requests.\n     */\n    async function ensureContext(): Promise<BuildContext> {\n        if (context) return context;\n        const esbuild = (await import(\"esbuild\")) as unknown as {\n            context(options: Record<string, unknown>): Promise<BuildContext>;\n        };\n        context = await esbuild.context({\n            entryPoints: [resolve(root, swSrc)],\n            bundle: true,\n            format: \"iife\",\n            platform: \"browser\",\n            target: \"es2020\",\n            write: false,\n            absWorkingDir: root,\n            logLevel: \"silent\",\n        });\n        return context;\n    }\n\n    /**\n     * Bundle the worker, reusing the previous graph.\n     *\n     * `esbuild.build()` per request was a cold bundle every time, and the request\n     * count is not one per session: `Cache-Control: no-cache` guarantees one per\n     * page load, and Chrome re-fetches the worker script on every navigation and\n     * on its own update checks. `rebuild()` reuses the graph and only redoes what\n     * changed on disk.\n     *\n     * Single-flight, because those requests arrive in bursts and esbuild does not\n     * promise anything about concurrent `rebuild()` calls on one context. Callers\n     * that land while a bundle is in flight share its result, which is the right\n     * answer anyway — they asked for the same file at the same moment.\n     *\n     * @returns The bundled worker source.\n     */\n    function buildWorker(): Promise<string> {\n        if (pending) return pending;\n\n        const run = (async (): Promise<string> => {\n            const ctx = await ensureContext();\n            const result = await ctx.rebuild();\n            const text = result.outputFiles?.[0]?.text;\n            if (text === undefined) throw new Error(\"esbuild produced no service-worker output\");\n            return text;\n        })();\n\n        pending = run;\n        const clear = (): void => {\n            pending = null;\n        };\n        run.then(clear, clear);\n        return run;\n    }\n\n    /**\n     * Tear the context down, releasing esbuild's child process.\n     *\n     * Idempotent, because it is wired to both the dev server closing and the\n     * plugin's `buildEnd`. Without it, restarting the dev server leaks one esbuild\n     * process per restart.\n     */\n    async function disposeContext(): Promise<void> {\n        const current = context;\n        context = null;\n        pending = null;\n        await current?.dispose();\n    }\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-dev-sw\",\n        apply: \"serve\",\n        async buildEnd() {\n            await disposeContext();\n        },\n        configResolved(config) {\n            root = config.root ?? process.cwd();\n            base = config.base ?? \"/\";\n        },\n        configureServer(server) {\n            if (!enabled) return;\n\n            server.httpServer?.once(\"close\", () => void disposeContext());\n\n            server.middlewares.use(async (req, res, next) => {\n                const url = (req.url ?? \"\").split(\"?\")[0];\n\n                if (matches(url, swUrl)) {\n                    try {\n                        const source = await buildWorker();\n                        res.setHeader(\"Content-Type\", \"application/javascript\");\n                        res.setHeader(\"Service-Worker-Allowed\", \"/\");\n                        res.setHeader(\"Cache-Control\", \"no-cache\");\n                        res.end(source);\n                    } catch (error) {\n                        res.statusCode = 500;\n                        res.end(`// SW dev build failed:\\n// ${String(error)}`);\n                    }\n                    return;\n                }\n\n                if (matches(url, manifestUrl)) {\n                    res.setHeader(\"Content-Type\", \"application/json\");\n                    res.setHeader(\"Cache-Control\", \"no-cache\");\n                    res.end(JSON.stringify({ version: \"dev\", urls: [] }));\n                    return;\n                }\n\n                next();\n            });\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n"],"mappings":";;;AA2CA,SAAgB,EAAgB,IAAkC,CAAC,GAAsB;CACrF,IAAM,EACF,WAAQ,aACR,WAAQ,UACR,iBAAc,2BACd,aAAU,OACV,GAEA,IAAO,QAAQ,IAAI,GACnB,IAAO;CAUX,SAAS,EAAQ,GAAa,GAAyB;EACnD,IAAI,MAAQ,GAAQ,OAAO;EAC3B,IAAM,IAAS,EAAW,CAAI;EAE9B,OADI,MAAW,OACR,MAAQ,GAAG,IAAS,EAAO,QAAQ,OAAO,EAAE;CACvD;CAeA,IAAI,IAA+B,MAC/B,IAAkC;CAWtC,eAAe,IAAuC;EAelD,OAdI,MAIJ,IAAU,OAAM,MAHO,OAAO,WAAA,CAGN,QAAQ;GAC5B,aAAa,CAAC,EAAQ,GAAM,CAAK,CAAC;GAClC,QAAQ;GACR,QAAQ;GACR,UAAU;GACV,QAAQ;GACR,OAAO;GACP,eAAe;GACf,UAAU;EACd,CAAC,GACM;CACX;CAkBA,SAAS,IAA+B;EACpC,IAAI,GAAS,OAAO;EAEpB,IAAM,KAAO,YAA6B;GAGtC,IAAM,KAAO,OADQ,MADH,EAAc,EAAA,CACP,QAAQ,EAAA,CACb,cAAc,EAAE,EAAE;GACtC,IAAI,MAAS,KAAA,GAAW,MAAU,MAAM,2CAA2C;GACnF,OAAO;EACX,EAAA,CAAG;EAEH,IAAU;EACV,IAAM,UAAoB;GACtB,IAAU;EACd;EAEA,OADA,EAAI,KAAK,GAAO,CAAK,GACd;CACX;CASA,eAAe,IAAgC;EAC3C,IAAM,IAAU;EAGhB,AAFA,IAAU,MACV,IAAU,MACV,MAAM,GAAS,QAAQ;CAC3B;CA8CA,OAAO;EA3CH,MAAM;EACN,OAAO;EACP,MAAM,WAAW;GACb,MAAM,EAAe;EACzB;EACA,eAAe,GAAQ;GAEnB,AADA,IAAO,EAAO,QAAQ,QAAQ,IAAI,GAClC,IAAO,EAAO,QAAQ;EAC1B;EACA,gBAAgB,GAAQ;GACf,MAEL,EAAO,YAAY,KAAK,eAAe,KAAK,EAAe,CAAC,GAE5D,EAAO,YAAY,IAAI,OAAO,GAAK,GAAK,MAAS;IAC7C,IAAM,KAAO,EAAI,OAAO,GAAA,CAAI,MAAM,GAAG,CAAC,CAAC;IAEvC,IAAI,EAAQ,GAAK,CAAK,GAAG;KACrB,IAAI;MACA,IAAM,IAAS,MAAM,EAAY;MAIjC,AAHA,EAAI,UAAU,gBAAgB,wBAAwB,GACtD,EAAI,UAAU,0BAA0B,GAAG,GAC3C,EAAI,UAAU,iBAAiB,UAAU,GACzC,EAAI,IAAI,CAAM;KAClB,SAAS,GAAO;MAEZ,AADA,EAAI,aAAa,KACjB,EAAI,IAAI,+BAA+B,OAAO,CAAK,GAAG;KAC1D;KACA;IACJ;IAEA,IAAI,EAAQ,GAAK,CAAW,GAAG;KAG3B,AAFA,EAAI,UAAU,gBAAgB,kBAAkB,GAChD,EAAI,UAAU,iBAAiB,UAAU,GACzC,EAAI,IAAI,KAAK,UAAU;MAAE,SAAS;MAAO,MAAM,CAAC;KAAE,CAAC,CAAC;KACpD;IACJ;IAEA,EAAK;GACT,CAAC;EACL;CAGG;AACX"}
+{"version":3,"file":"tempest-pwa-dev-sw.js","names":[],"sources":["../../src/vite/tempest-pwa-dev-sw.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport { basePrefix } from \"./base-url\";\nimport type { TempestVitePlugin } from \"./tempest-pwa-manifest\";\n\n/** Options for {@link tempestPwaDevSw}. */\nexport interface TempestPwaDevSwOptions {\n    /** Service-worker entry, relative to the project root. Default `src/sw.ts`. */\n    swSrc?: string;\n    /**\n     * URL the worker is served at (must match `registerServiceWorker`).\n     * Default `/sw.js`.\n     *\n     * Write it relative to the site root; requests are matched against both the\n     * bare path and the path prefixed with the resolved Vite `base`, so a\n     * project served from a subpath is handled without extra configuration.\n     */\n    swUrl?: string;\n    /**\n     * Dev URL of the precache manifest. Default `/precache-manifest.json`.\n     * Matched the same way as {@link TempestPwaDevSwOptions.swUrl}.\n     */\n    manifestUrl?: string;\n    /** Serve the worker in dev. Default `true`; set `false` to opt out. */\n    enabled?: boolean;\n}\n\n/**\n * The dev middleware: serve the compiled worker, and a placeholder manifest.\n *\n * Extracted from the plugin so the request handling reads on its own — the\n * plugin body is then only wiring. The manifest is deliberately empty in dev:\n * precaching a set of URLs Vite rewrites on every change would serve stale\n * modules, and the worker's runtime routes still work without it.\n *\n * @param deps - The two URLs, the path matcher and the incremental build.\n * @returns A connect-style middleware.\n */\nfunction createDevSwMiddleware(deps: {\n    swUrl: string;\n    manifestUrl: string;\n    matches: (url: string, target: string) => boolean;\n    buildWorker: () => Promise<string>;\n}): (\n    req: { url?: string },\n    res: {\n        statusCode?: number;\n        setHeader: (name: string, value: string) => void;\n        end: (body: string) => void;\n    },\n    next: () => void,\n) => Promise<void> {\n    return async (req, res, next) => {\n        const url = (req.url ?? \"\").split(\"?\")[0];\n\n        if (deps.matches(url, deps.swUrl)) {\n            try {\n                const source = await deps.buildWorker();\n                res.setHeader(\"Content-Type\", \"application/javascript\");\n                res.setHeader(\"Service-Worker-Allowed\", \"/\");\n                res.setHeader(\"Cache-Control\", \"no-cache\");\n                res.end(source);\n            } catch (error) {\n                res.statusCode = 500;\n                res.end(`// SW dev build failed:\\n// ${String(error)}`);\n            }\n            return;\n        }\n\n        if (deps.matches(url, deps.manifestUrl)) {\n            res.setHeader(\"Content-Type\", \"application/json\");\n            res.setHeader(\"Cache-Control\", \"no-cache\");\n            res.end(JSON.stringify({ version: \"dev\", urls: [] }));\n            return;\n        }\n\n        next();\n    };\n}\n\n/**\n * Dev-server plugin that makes the service worker available under `npm run dev`.\n *\n * The production worker is bundled at build time (`vite.sw.config.ts`), so in\n * dev there is no `/sw.js` to register. This plugin compiles `swSrc` on the fly\n * with esbuild — through one incremental context, not a cold build per request —\n * and serves it as a classic worker, plus an empty `precache-manifest.json` (there are no hashed build assets to precache in\n * dev — push and runtime caching still work). It closes the \"SW in dev\" gap\n * that otherwise only `vite-plugin-pwa`'s `devOptions` covered.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaDevSw } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({ plugins: [tempestPwaDevSw()] });\n */\nexport function tempestPwaDevSw(options: TempestPwaDevSwOptions = {}): TempestVitePlugin {\n    const {\n        swSrc = \"src/sw.ts\",\n        swUrl = \"/sw.js\",\n        manifestUrl = \"/precache-manifest.json\",\n        enabled = true,\n    } = options;\n\n    let root = process.cwd();\n    let base = \"/\";\n\n    /**\n     * Whether a request path addresses `target`.\n     *\n     * Both the bare path and the base-prefixed one are accepted. Which of the\n     * two arrives depends on where this middleware lands relative to Vite's own\n     * base handling, and a project served from a subpath would otherwise never\n     * match — the browser asks for `/app/sw.js` while the option says `/sw.js`.\n     */\n    function matches(url: string, target: string): boolean {\n        if (url === target) return true;\n        const prefix = basePrefix(base);\n        if (prefix === \"/\") return false;\n        return url === `${prefix}${target.replace(/^\\//, \"\")}`;\n    }\n\n    /**\n     * The slice of esbuild's incremental API this plugin uses.\n     *\n     * Typed structurally rather than imported: `esbuild` is not a dependency of\n     * this package. It is resolved at runtime from the app's own tree, where Vite\n     * already brings it, so importing its types would add a build-time dependency\n     * the runtime does not have.\n     */\n    interface BuildContext {\n        rebuild(): Promise<{ outputFiles?: readonly { text: string }[] }>;\n        dispose(): Promise<void>;\n    }\n\n    let context: BuildContext | null = null;\n    let pending: Promise<string> | null = null;\n\n    /**\n     * The incremental build context, created on the first request that needs it.\n     *\n     * Lazy because a project that never registers a worker should not pay for an\n     * esbuild child process, and because `apply: \"serve\"` still loads this module\n     * in a build.\n     *\n     * @returns The context, reused across requests.\n     */\n    async function ensureContext(): Promise<BuildContext> {\n        if (context) return context;\n        const esbuild = (await import(\"esbuild\")) as unknown as {\n            context(options: Record<string, unknown>): Promise<BuildContext>;\n        };\n        context = await esbuild.context({\n            entryPoints: [resolve(root, swSrc)],\n            bundle: true,\n            format: \"iife\",\n            platform: \"browser\",\n            target: \"es2020\",\n            write: false,\n            absWorkingDir: root,\n            logLevel: \"silent\",\n        });\n        return context;\n    }\n\n    /**\n     * Bundle the worker, reusing the previous graph.\n     *\n     * `esbuild.build()` per request was a cold bundle every time, and the request\n     * count is not one per session: `Cache-Control: no-cache` guarantees one per\n     * page load, and Chrome re-fetches the worker script on every navigation and\n     * on its own update checks. `rebuild()` reuses the graph and only redoes what\n     * changed on disk.\n     *\n     * Single-flight, because those requests arrive in bursts and esbuild does not\n     * promise anything about concurrent `rebuild()` calls on one context. Callers\n     * that land while a bundle is in flight share its result, which is the right\n     * answer anyway — they asked for the same file at the same moment.\n     *\n     * @returns The bundled worker source.\n     */\n    function buildWorker(): Promise<string> {\n        if (pending) return pending;\n\n        const run = (async (): Promise<string> => {\n            const ctx = await ensureContext();\n            const result = await ctx.rebuild();\n            const text = result.outputFiles?.[0]?.text;\n            if (text === undefined) throw new Error(\"esbuild produced no service-worker output\");\n            return text;\n        })();\n\n        pending = run;\n        const clear = (): void => {\n            pending = null;\n        };\n        run.then(clear, clear);\n        return run;\n    }\n\n    /**\n     * Tear the context down, releasing esbuild's child process.\n     *\n     * Idempotent, because it is wired to both the dev server closing and the\n     * plugin's `buildEnd`. Without it, restarting the dev server leaks one esbuild\n     * process per restart.\n     */\n    async function disposeContext(): Promise<void> {\n        const current = context;\n        context = null;\n        pending = null;\n        await current?.dispose();\n    }\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-dev-sw\",\n        apply: \"serve\",\n        async buildEnd() {\n            await disposeContext();\n        },\n        configResolved(config) {\n            root = config.root ?? process.cwd();\n            base = config.base ?? \"/\";\n        },\n        configureServer(server) {\n            if (!enabled) return;\n\n            server.httpServer?.once(\"close\", () => void disposeContext());\n\n            server.middlewares.use(\n                createDevSwMiddleware({ swUrl, manifestUrl, matches, buildWorker }),\n            );\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n"],"mappings":";;;AAsCA,SAAS,EAAsB,GAaZ;CACf,OAAO,OAAO,GAAK,GAAK,MAAS;EAC7B,IAAM,KAAO,EAAI,OAAO,GAAA,CAAI,MAAM,GAAG,CAAC,CAAC;EAEvC,IAAI,EAAK,QAAQ,GAAK,EAAK,KAAK,GAAG;GAC/B,IAAI;IACA,IAAM,IAAS,MAAM,EAAK,YAAY;IAItC,AAHA,EAAI,UAAU,gBAAgB,wBAAwB,GACtD,EAAI,UAAU,0BAA0B,GAAG,GAC3C,EAAI,UAAU,iBAAiB,UAAU,GACzC,EAAI,IAAI,CAAM;GAClB,SAAS,GAAO;IAEZ,AADA,EAAI,aAAa,KACjB,EAAI,IAAI,+BAA+B,OAAO,CAAK,GAAG;GAC1D;GACA;EACJ;EAEA,IAAI,EAAK,QAAQ,GAAK,EAAK,WAAW,GAAG;GAGrC,AAFA,EAAI,UAAU,gBAAgB,kBAAkB,GAChD,EAAI,UAAU,iBAAiB,UAAU,GACzC,EAAI,IAAI,KAAK,UAAU;IAAE,SAAS;IAAO,MAAM,CAAC;GAAE,CAAC,CAAC;GACpD;EACJ;EAEA,EAAK;CACT;AACJ;AAkBA,SAAgB,EAAgB,IAAkC,CAAC,GAAsB;CACrF,IAAM,EACF,WAAQ,aACR,WAAQ,UACR,iBAAc,2BACd,aAAU,OACV,GAEA,IAAO,QAAQ,IAAI,GACnB,IAAO;CAUX,SAAS,EAAQ,GAAa,GAAyB;EACnD,IAAI,MAAQ,GAAQ,OAAO;EAC3B,IAAM,IAAS,EAAW,CAAI;EAE9B,OADI,MAAW,OACR,MAAQ,GAAG,IAAS,EAAO,QAAQ,OAAO,EAAE;CACvD;CAeA,IAAI,IAA+B,MAC/B,IAAkC;CAWtC,eAAe,IAAuC;EAelD,OAdI,MAIJ,IAAU,OAAM,MAHO,OAAO,WAAA,CAGN,QAAQ;GAC5B,aAAa,CAAC,EAAQ,GAAM,CAAK,CAAC;GAClC,QAAQ;GACR,QAAQ;GACR,UAAU;GACV,QAAQ;GACR,OAAO;GACP,eAAe;GACf,UAAU;EACd,CAAC,GACM;CACX;CAkBA,SAAS,IAA+B;EACpC,IAAI,GAAS,OAAO;EAEpB,IAAM,KAAO,YAA6B;GAGtC,IAAM,KAAO,OADQ,MADH,EAAc,EAAA,CACP,QAAQ,EAAA,CACb,cAAc,EAAE,EAAE;GACtC,IAAI,MAAS,KAAA,GAAW,MAAU,MAAM,2CAA2C;GACnF,OAAO;EACX,EAAA,CAAG;EAEH,IAAU;EACV,IAAM,UAAoB;GACtB,IAAU;EACd;EAEA,OADA,EAAI,KAAK,GAAO,CAAK,GACd;CACX;CASA,eAAe,IAAgC;EAC3C,IAAM,IAAU;EAGhB,AAFA,IAAU,MACV,IAAU,MACV,MAAM,GAAS,QAAQ;CAC3B;CAuBA,OAAO;EApBH,MAAM;EACN,OAAO;EACP,MAAM,WAAW;GACb,MAAM,EAAe;EACzB;EACA,eAAe,GAAQ;GAEnB,AADA,IAAO,EAAO,QAAQ,QAAQ,IAAI,GAClC,IAAO,EAAO,QAAQ;EAC1B;EACA,gBAAgB,GAAQ;GACf,MAEL,EAAO,YAAY,KAAK,eAAe,KAAK,EAAe,CAAC,GAE5D,EAAO,YAAY,IACf,EAAsB;IAAE;IAAO;IAAa;IAAS;GAAY,CAAC,CACtE;EACJ;CAGG;AACX"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-react-sdk",
-  "version": "0.49.0",
+  "version": "0.51.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",