tempest-react-sdk 0.82.0 → 0.83.0

package/dist/vite/tempest-pwa-manifest.js

@@ -1,42 +1,58 @@
-import { basePrefix as e } from "./base-url.js";
+import { basePrefix as e, toOutputFile as t } from "./base-url.js";
+import { PWA_WORKER_PLUGIN_NAME as n } from "./tempest-pwa-dev-sw.js";
+import { join as r } from "node:path";
+import { existsSync as i, statSync as a } from "node:fs";
 //#region src/vite/tempest-pwa-manifest.ts
-function t(t, n) {
+function o(e, n, o, s) {
+	let c = t(n, e);
+	if (c in o) return !0;
+	if (!s) return !1;
+	let l = r(s, c);
+	return i(l) && a(l).isFile();
+}
+function s(t, n) {
 	return `${e(t)}${n}`.replace(/([^:]\/)\/+/g, "$1");
 }
-function n(t, n) {
+function c(t, n) {
 	let r = e(t);
 	return r === "/" ? n.startsWith("/") ? n : `/${n}` : n.startsWith(r) ? n : `${r}${n.replace(/^\//, "")}`;
 }
-function r(e) {
+function l(e) {
 	let t = 5381;
 	for (let n = 0; n < e.length; n++) t = (t << 5) + t + e.charCodeAt(n) >>> 0;
 	return t.toString(16);
 }
-function i(e = {}) {
-	let { fileName: i = "precache-manifest.json", additionalUrls: a = [], exclude: o = /\.map$/, includeHtml: s = !0, appShell: c = "/index.html" } = e, l = "/";
+function u(e = {}) {
+	let { fileName: r = "precache-manifest.json", additionalUrls: i = [], exclude: a = /\.map$/, includeHtml: u = !0, appShell: d = "/index.html", serviceWorker: f } = e, p = "/", m = "", h = "/sw.js";
 	return {
 		name: "tempest-pwa-manifest",
 		apply: "build",
 		configResolved(e) {
-			l = e.base ?? "/";
+			p = e.base ?? "/", m = e.publicDir ?? "";
+			let t = (e.plugins ?? []).find((e) => e.name === n)?.api;
+			h = f === void 0 ? t ? t.build ? t.swUrl : !1 : "/sw.js" : f;
 		},
-		generateBundle(e, u) {
-			let d = new Set(a.map((e) => n(l, e)));
-			c && d.add(n(l, c));
-			for (let e of Object.keys(u)) e !== i && (o.test(e) || (s || !e.endsWith(".html")) && d.add(t(l, e)));
-			let f = [...d].sort(), p = r(f.join("\n"));
+		generateBundle(e, t) {
+			let n = new Set(i.map((e) => c(p, e)));
+			d && n.add(c(p, d));
+			for (let e of Object.keys(t)) e !== r && (a.test(e) || (u || !e.endsWith(".html")) && n.add(s(p, e)));
+			let o = [...n].sort(), f = l(o.join("\n"));
 			this.emitFile({
 				type: "asset",
-				fileName: i,
+				fileName: r,
 				source: JSON.stringify({
-					version: p,
-					urls: f
+					version: f,
+					urls: o
 				})
 			});
+		},
+		writeBundle(e, n) {
+			let a = i.filter((e) => !/^[a-z][a-z\d+.-]*:/i.test(e) && !o(e, p, n, m));
+			a.length > 0 && this.error(`[tempest-pwa-manifest] additionalUrls lists ${a.join(", ")}, which is neither in public/ nor in the build output. In production that URL answers with the SPA fallback or a 404, so the precache would store index.html under its name or fail the worker install. Move the file into public/, or drop the entry — a file Vite hashes into assets/ (a web manifest linked from index.html) is already precached.`), h !== !1 && (t(p, h) in n || this.error(`[tempest-pwa-manifest] the build emitted ${r} but no service worker at ${h}. In production the registration 404s and navigator.serviceWorker.ready never resolves (push, updates and offline hang without an error). Add tempestPwaDevSw() — it bundles src/sw.ts into this build — or, if a separate step bundles the worker after this one, pass tempestPwaManifest({ serviceWorker: false }) or tempestPwaDevSw({ build: false }).`));
 		}
 	};
 }
 //#endregion
-export { i as tempestPwaManifest };
+export { u as tempestPwaManifest };
 
 //# sourceMappingURL=tempest-pwa-manifest.js.map

package/dist/vite/tempest-pwa-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"tempest-pwa-manifest.js","names":["joinBase","basePrefix","base","file","withBase","prefix","url","hash","h","i","input","tempestPwaManifest","options","config","urls","additionalUrls","appShell","bundle","fileName","exclude","includeHtml","list","version"],"sources":["../../src/vite/tempest-pwa-manifest.ts"],"sourcesContent":["import type { Plugin } from \"vite\";\nimport { basePrefix } from \"./base-url\";\n\n/**\n * A Vite plugin object. Typed loosely so the SDK's published declarations stay\n * free of `vite`'s internal types (which the `.d.ts` rollup can't analyze);\n * assign the result straight into a `plugins: [...]` array.\n */\nexport type TempestVitePlugin = { name: string } & Record<string, unknown>;\n\n/** Options for {@link tempestPwaManifest}. */\nexport interface TempestPwaManifestOptions {\n    /** Output file name (under the build root). Default `precache-manifest.json`. */\n    fileName?: string;\n    /**\n     * Extra URLs to precache that Vite doesn't emit into the bundle — typically\n     * `public/` assets like the web manifest and icons. Default `[]`.\n     *\n     * Write these relative to the site root (`/icon.svg`); the resolved Vite\n     * `base` is prefixed for you. An entry that already carries the base is\n     * left alone, so spelling it out by hand is still correct.\n     */\n    additionalUrls?: string[];\n    /** Emitted files matching this are skipped. Default `/\\.map$/` (source maps). */\n    exclude?: RegExp;\n    /** Include emitted `.html` documents (the app shell). Default `true`. */\n    includeHtml?: boolean;\n    /**\n     * App-shell document always added to the manifest, even if Vite emits it\n     * after this plugin runs. Must match `installPrecache`'s `navigateFallback`\n     * so offline navigations resolve. Pass `false` to disable. Default `/index.html`.\n     *\n     * Like {@link TempestPwaManifestOptions.additionalUrls}, this is prefixed\n     * with the resolved Vite `base`.\n     */\n    appShell?: string | false;\n}\n\nfunction joinBase(base: string, file: string): string {\n    return `${basePrefix(base)}${file}`.replace(/([^:]\\/)\\/+/g, \"$1\");\n}\n\n/**\n * Prefix a caller-supplied, root-absolute URL with the resolved Vite `base`.\n *\n * Idempotent: a URL that already starts with the base is returned untouched,\n * so configs written before this was applied — spelling the base out by hand —\n * keep producing the same manifest instead of gaining a doubled prefix.\n */\nfunction withBase(base: string, url: string): string {\n    const prefix = basePrefix(base);\n    if (prefix === \"/\") return url.startsWith(\"/\") ? url : `/${url}`;\n    if (url.startsWith(prefix)) return url;\n    return `${prefix}${url.replace(/^\\//, \"\")}`;\n}\n\n/** Deterministic djb2 hash → hex. Stable across rebuilds with the same assets. */\nfunction hash(input: string): string {\n    let h = 5381;\n    for (let i = 0; i < input.length; i++) {\n        h = ((h << 5) + h + input.charCodeAt(i)) >>> 0;\n    }\n    return h.toString(16);\n}\n\n/**\n * Vite build plugin that emits a `precache-manifest.json` listing every built\n * asset (plus any `additionalUrls`) as root-absolute URLs, with a content-based\n * `version`. It is the dependency-free counterpart to Workbox's `__WB_MANIFEST`:\n * `installPrecache` (from `tempest-react-sdk/sw`) reads this file at the service\n * worker's `install` event to cache the app shell for offline use.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaManifest } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *   plugins: [tempestPwaManifest({ additionalUrls: [\"/manifest.webmanifest\", \"/icon.svg\"] })],\n * });\n */\nexport function tempestPwaManifest(options: TempestPwaManifestOptions = {}): TempestVitePlugin {\n    const {\n        fileName = \"precache-manifest.json\",\n        additionalUrls = [],\n        exclude = /\\.map$/,\n        includeHtml = true,\n        appShell = \"/index.html\",\n    } = options;\n\n    let base = \"/\";\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-manifest\",\n        apply: \"build\",\n        configResolved(config) {\n            base = config.base ?? \"/\";\n        },\n        generateBundle(_outputOptions, bundle) {\n            const urls = new Set<string>(additionalUrls.map((url) => withBase(base, url)));\n            // Vite may emit index.html after this hook, so guarantee the shell.\n            if (appShell) urls.add(withBase(base, appShell));\n            for (const file of Object.keys(bundle)) {\n                if (file === fileName) continue;\n                if (exclude.test(file)) continue;\n                if (!includeHtml && file.endsWith(\".html\")) continue;\n                urls.add(joinBase(base, file));\n            }\n\n            const list = [...urls].sort();\n            const version = hash(list.join(\"\\n\"));\n            this.emitFile({\n                type: \"asset\",\n                fileName,\n                source: JSON.stringify({ version, urls: list }),\n            });\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n"],"mappings":";;AAsCA,SAASA,EAAS,GAAc,GAAsB;CAClD,OAAO,GAAGC,EAAWC,CAAI,IAAIC,IAAO,QAAQ,gBAAgB,IAAI;AACpE;AASA,SAASC,EAAS,GAAc,GAAqB;CACjD,IAAMC,IAASJ,EAAWC,CAAI;CAG9B,OAFIG,MAAW,MAAYC,EAAI,WAAW,GAAG,IAAIA,IAAM,IAAIA,MACvDA,EAAI,WAAWD,CAAM,IAAUC,IAC5B,GAAGD,IAASC,EAAI,QAAQ,OAAO,EAAE;AAC5C;AAGA,SAASC,EAAK,GAAuB;CACjC,IAAIC,IAAI;CACR,KAAK,IAAIC,IAAI,GAAGA,IAAIC,EAAM,QAAQ,KAC9B,KAAMF,KAAK,KAAKA,IAAIE,EAAM,WAAWD,CAAC,MAAO;CAEjD,OAAOD,EAAE,SAAS,EAAE;AACxB;AAiBA,SAAgBG,EAAmB,IAAqC,CAAC,GAAsB;CAC3F,IAAM,EACF,cAAW,0BACX,oBAAiB,CAAC,GAClB,aAAU,UACV,iBAAc,IACd,cAAW,kBACXC,GAEAV,IAAO;CA6BX,OAAO;EA1BH,MAAM;EACN,OAAO;EACP,eAAe,GAAQ;GACnB,IAAOW,EAAO,QAAQ;EAC1B;EACA,eAAe,GAAgB,GAAQ;GACnC,IAAMC,IAAO,IAAI,IAAYC,EAAe,KAAK,MAAQX,EAASF,GAAMI,CAAG,CAAC,CAAC;GAE7E,AAAIU,KAAUF,EAAK,IAAIV,EAASF,GAAMc,CAAQ,CAAC;GAC/C,KAAK,IAAMb,KAAQ,OAAO,KAAKc,CAAM,GACjC,AAAId,MAASe,MACTC,EAAQ,KAAKhB,CAAI,MAChBiB,KAAe,GAAK,SAAS,OAAO,MACzCN,EAAK,IAAId,EAASE,GAAMC,CAAI,CAAC;GAGjC,IAAMkB,IAAO,CAAC,GAAGP,CAAI,CAAC,CAAC,KAAK,GACtBQ,IAAUf,EAAKc,EAAK,KAAK,IAAI,CAAC;GACpC,KAAK,SAAS;IACV,MAAM;IACN;IACA,QAAQ,KAAK,UAAU;KAAE;KAAS,MAAMA;IAAK,CAAC;GAClD,CAAC;EACL;CAGG;AACX"}
+{"version":3,"file":"tempest-pwa-manifest.js","names":["resolvesToFile","file","toOutputFile","base","url","bundle","publicDir","path","join","existsSync","statSync","joinBase","basePrefix","withBase","prefix","hash","h","i","input","tempestPwaManifest","options","expectedWorker","config","worker","item","PWA_WORKER_PLUGIN_NAME","serviceWorker","urls","additionalUrls","appShell","fileName","exclude","includeHtml","list","version","missing"],"sources":["../../src/vite/tempest-pwa-manifest.ts"],"sourcesContent":["import { existsSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport { basePrefix, toOutputFile } from \"./base-url\";\nimport { PWA_WORKER_PLUGIN_NAME } from \"./tempest-pwa-dev-sw\";\nimport type { TempestPwaWorkerApi } from \"./tempest-pwa-dev-sw\";\n\n/**\n * A Vite plugin object. Typed loosely so the SDK's published declarations stay\n * free of `vite`'s internal types (which the `.d.ts` rollup can't analyze);\n * assign the result straight into a `plugins: [...]` array.\n */\nexport type TempestVitePlugin = { name: string } & Record<string, unknown>;\n\n/** Options for {@link tempestPwaManifest}. */\nexport interface TempestPwaManifestOptions {\n    /** Output file name (under the build root). Default `precache-manifest.json`. */\n    fileName?: string;\n    /**\n     * Extra URLs to precache that Vite doesn't emit into the bundle — typically\n     * `public/` assets like the web manifest and icons. Default `[]`.\n     *\n     * Write these relative to the site root (`/icon.svg`); the resolved Vite\n     * `base` is prefixed for you. An entry that already carries the base is\n     * left alone, so spelling it out by hand is still correct.\n     *\n     * Every same-origin entry must be a file in `public/` or in the bundle, or\n     * the build fails. A URL that resolves to nothing is answered in production\n     * by the SPA fallback (`index.html`) or a 404, so the precache would store\n     * the app shell under that name, or fail the worker's install outright. The\n     * usual culprit is a web manifest linked from `index.html` but kept outside\n     * `public/`: Vite hashes it into `assets/`, where it is already precached.\n     * Absolute `http(s):` URLs are not checked.\n     */\n    additionalUrls?: string[];\n    /** Emitted files matching this are skipped. Default `/\\.map$/` (source maps). */\n    exclude?: RegExp;\n    /** Include emitted `.html` documents (the app shell). Default `true`. */\n    includeHtml?: boolean;\n    /**\n     * App-shell document always added to the manifest, even if Vite emits it\n     * after this plugin runs. Must match `installPrecache`'s `navigateFallback`\n     * so offline navigations resolve. Pass `false` to disable. Default `/index.html`.\n     *\n     * Like {@link TempestPwaManifestOptions.additionalUrls}, this is prefixed\n     * with the resolved Vite `base`.\n     */\n    appShell?: string | false;\n    /**\n     * URL of the service worker that reads this manifest. The build fails when\n     * no file is emitted at that URL. Default: the `swUrl` of\n     * {@link tempestPwaDevSw} when it is in the plugin list, `/sw.js` otherwise.\n     *\n     * A precache manifest is only read by a worker, and a build that ships the\n     * manifest without the worker exits 0 while registration 404s in\n     * production — `navigator.serviceWorker.ready` never resolves and push,\n     * updates and offline all hang without a message. Pass `false` when the\n     * worker is bundled by a separate step after this build (a second\n     * `vite build --config vite.sw.config.ts`); `tempestPwaDevSw({ build: false })`\n     * already says the same and needs nothing here.\n     */\n    serviceWorker?: string | false;\n}\n\n/**\n * Whether `url` names something the build can serve: a bundle entry or a file\n * in the public directory.\n *\n * @param url - The URL as written in `additionalUrls`.\n * @param base - Vite's resolved `base`.\n * @param bundle - The final output bundle.\n * @param publicDir - The resolved public directory, or `\"\"` when disabled.\n * @returns `true` when the URL resolves to a real file.\n */\nfunction resolvesToFile(\n    url: string,\n    base: string,\n    bundle: Record<string, unknown>,\n    publicDir: string,\n): boolean {\n    const file = toOutputFile(base, url);\n    if (file in bundle) return true;\n    if (!publicDir) return false;\n    const path = join(publicDir, file);\n    return existsSync(path) && statSync(path).isFile();\n}\n\nfunction joinBase(base: string, file: string): string {\n    return `${basePrefix(base)}${file}`.replace(/([^:]\\/)\\/+/g, \"$1\");\n}\n\n/**\n * Prefix a caller-supplied, root-absolute URL with the resolved Vite `base`.\n *\n * Idempotent: a URL that already starts with the base is returned untouched,\n * so configs written before this was applied — spelling the base out by hand —\n * keep producing the same manifest instead of gaining a doubled prefix.\n */\nfunction withBase(base: string, url: string): string {\n    const prefix = basePrefix(base);\n    if (prefix === \"/\") return url.startsWith(\"/\") ? url : `/${url}`;\n    if (url.startsWith(prefix)) return url;\n    return `${prefix}${url.replace(/^\\//, \"\")}`;\n}\n\n/** Deterministic djb2 hash → hex. Stable across rebuilds with the same assets. */\nfunction hash(input: string): string {\n    let h = 5381;\n    for (let i = 0; i < input.length; i++) {\n        h = ((h << 5) + h + input.charCodeAt(i)) >>> 0;\n    }\n    return h.toString(16);\n}\n\n/**\n * Vite build plugin that emits a `precache-manifest.json` listing every built\n * asset (plus any `additionalUrls`) as root-absolute URLs, with a content-based\n * `version`. It is the dependency-free counterpart to Workbox's `__WB_MANIFEST`:\n * `installPrecache` (from `tempest-react-sdk/sw`) reads this file at the service\n * worker's `install` event to cache the app shell for offline use.\n *\n * Two mistakes that used to ship in silence now fail the build, after the bundle\n * is written: no service worker emitted at\n * {@link TempestPwaManifestOptions.serviceWorker}, and an `additionalUrls`\n * entry that is neither in `public/` nor in the bundle. Pair it with\n * {@link tempestPwaDevSw}, which bundles `src/sw.ts` into the same build.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaDevSw, tempestPwaManifest } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *   plugins: [\n *     tempestPwaManifest({ additionalUrls: [\"/manifest.webmanifest\", \"/icon.svg\"] }),\n *     tempestPwaDevSw(),\n *   ],\n * });\n */\nexport function tempestPwaManifest(options: TempestPwaManifestOptions = {}): TempestVitePlugin {\n    const {\n        fileName = \"precache-manifest.json\",\n        additionalUrls = [],\n        exclude = /\\.map$/,\n        includeHtml = true,\n        appShell = \"/index.html\",\n        serviceWorker,\n    } = options;\n\n    let base = \"/\";\n    let publicDir = \"\";\n    let expectedWorker: string | false = \"/sw.js\";\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-manifest\",\n        apply: \"build\",\n        configResolved(config) {\n            base = config.base ?? \"/\";\n            publicDir = config.publicDir ?? \"\";\n            const worker = (config.plugins ?? []).find(\n                (item) => item.name === PWA_WORKER_PLUGIN_NAME,\n            )?.api as TempestPwaWorkerApi | undefined;\n            if (serviceWorker !== undefined) expectedWorker = serviceWorker;\n            else if (worker) expectedWorker = worker.build ? worker.swUrl : false;\n            else expectedWorker = \"/sw.js\";\n        },\n        generateBundle(_outputOptions, bundle) {\n            const urls = new Set<string>(additionalUrls.map((url) => withBase(base, url)));\n            // Vite may emit index.html after this hook, so guarantee the shell.\n            if (appShell) urls.add(withBase(base, appShell));\n            for (const file of Object.keys(bundle)) {\n                if (file === fileName) continue;\n                if (exclude.test(file)) continue;\n                if (!includeHtml && file.endsWith(\".html\")) continue;\n                urls.add(joinBase(base, file));\n            }\n\n            const list = [...urls].sort();\n            const version = hash(list.join(\"\\n\"));\n            this.emitFile({\n                type: \"asset\",\n                fileName,\n                source: JSON.stringify({ version, urls: list }),\n            });\n        },\n        writeBundle(_outputOptions, bundle) {\n            const missing = additionalUrls.filter(\n                (url) =>\n                    !/^[a-z][a-z\\d+.-]*:/i.test(url) &&\n                    !resolvesToFile(url, base, bundle, publicDir),\n            );\n            if (missing.length > 0) {\n                this.error(\n                    `[tempest-pwa-manifest] additionalUrls lists ${missing.join(\", \")}, which is ` +\n                        \"neither in public/ nor in the build output. In production that URL \" +\n                        \"answers with the SPA fallback or a 404, so the precache would store \" +\n                        \"index.html under its name or fail the worker install. Move the file \" +\n                        \"into public/, or drop the entry — a file Vite hashes into assets/ \" +\n                        \"(a web manifest linked from index.html) is already precached.\",\n                );\n            }\n\n            if (expectedWorker === false) return;\n            if (toOutputFile(base, expectedWorker) in bundle) return;\n            this.error(\n                `[tempest-pwa-manifest] the build emitted ${fileName} but no service worker ` +\n                    `at ${expectedWorker}. In production the registration 404s and ` +\n                    \"navigator.serviceWorker.ready never resolves (push, updates and offline \" +\n                    \"hang without an error). Add tempestPwaDevSw() — it bundles src/sw.ts into \" +\n                    \"this build — or, if a separate step bundles the worker after this one, \" +\n                    \"pass tempestPwaManifest({ serviceWorker: false }) or \" +\n                    \"tempestPwaDevSw({ build: false }).\",\n            );\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n"],"mappings":";;;;;AA0EA,SAASA,EACL,GACA,GACA,GACA,GACO;CACP,IAAMC,IAAOC,EAAaC,GAAMC,CAAG;CACnC,IAAIH,KAAQI,GAAQ,OAAO;CAC3B,IAAI,CAACC,GAAW,OAAO;CACvB,IAAMC,IAAOC,EAAKF,GAAWL,CAAI;CACjC,OAAOQ,EAAWF,CAAI,KAAKG,EAASH,CAAI,CAAC,CAAC,OAAO;AACrD;AAEA,SAASI,EAAS,GAAc,GAAsB;CAClD,OAAO,GAAGC,EAAWT,CAAI,IAAIF,IAAO,QAAQ,gBAAgB,IAAI;AACpE;AASA,SAASY,EAAS,GAAc,GAAqB;CACjD,IAAMC,IAASF,EAAWT,CAAI;CAG9B,OAFIW,MAAW,MAAYV,EAAI,WAAW,GAAG,IAAIA,IAAM,IAAIA,MACvDA,EAAI,WAAWU,CAAM,IAAUV,IAC5B,GAAGU,IAASV,EAAI,QAAQ,OAAO,EAAE;AAC5C;AAGA,SAASW,EAAK,GAAuB;CACjC,IAAIC,IAAI;CACR,KAAK,IAAIC,IAAI,GAAGA,IAAIC,EAAM,QAAQ,KAC9B,KAAMF,KAAK,KAAKA,IAAIE,EAAM,WAAWD,CAAC,MAAO;CAEjD,OAAOD,EAAE,SAAS,EAAE;AACxB;AA0BA,SAAgBG,EAAmB,IAAqC,CAAC,GAAsB;CAC3F,IAAM,EACF,cAAW,0BACX,oBAAiB,CAAC,GAClB,aAAU,UACV,iBAAc,IACd,cAAW,eACX,qBACAC,GAEAjB,IAAO,KACPG,IAAY,IACZe,IAAiC;CAiErC,OAAO;EA9DH,MAAM;EACN,OAAO;EACP,eAAe,GAAQ;GAEnB,AADA,IAAOC,EAAO,QAAQ,KACtB,IAAYA,EAAO,aAAa;GAChC,IAAMC,KAAUD,EAAO,WAAW,CAAC,EAAA,CAAG,MACjC,MAASE,EAAK,SAASC,CAC5B,CAAC,EAAE;GACH,AAAiCJ,IAA7BK,MAAkB,KAAA,IACbH,IAAyBA,EAAO,QAAQA,EAAO,QAAQ,KAC1C,WAF4BG;EAGtD;EACA,eAAe,GAAgB,GAAQ;GACnC,IAAMC,IAAO,IAAI,IAAYC,EAAe,KAAK,MAAQf,EAASV,GAAMC,CAAG,CAAC,CAAC;GAE7E,AAAIyB,KAAUF,EAAK,IAAId,EAASV,GAAM0B,CAAQ,CAAC;GAC/C,KAAK,IAAM5B,KAAQ,OAAO,KAAKI,CAAM,GACjC,AAAIJ,MAAS6B,MACTC,EAAQ,KAAK9B,CAAI,MAChB+B,KAAe,GAAK,SAAS,OAAO,MACzCL,EAAK,IAAIhB,EAASR,GAAMF,CAAI,CAAC;GAGjC,IAAMgC,IAAO,CAAC,GAAGN,CAAI,CAAC,CAAC,KAAK,GACtBO,IAAUnB,EAAKkB,EAAK,KAAK,IAAI,CAAC;GACpC,KAAK,SAAS;IACV,MAAM;IACN;IACA,QAAQ,KAAK,UAAU;KAAE;KAAS,MAAMA;IAAK,CAAC;GAClD,CAAC;EACL;EACA,YAAY,GAAgB,GAAQ;GAChC,IAAME,IAAUP,EAAe,QAC1B,MACG,CAAC,sBAAsB,KAAKxB,CAAG,KAC/B,CAACJ,EAAeI,GAAKD,GAAME,GAAQC,CAAS,CACpD;GAYA,AAXI6B,EAAQ,SAAS,KACjB,KAAK,MACD,+CAA+CA,EAAQ,KAAK,IAAI,EAAE,sVAMtE,GAGAd,MAAmB,OACnBnB,EAAaC,GAAMkB,CAAc,KAAKhB,KAC1C,KAAK,MACD,4CAA4CyB,EAAS,4BAC3CT,EAAe,2VAM7B;EACJ;CAGG;AACX"}

package/dist/vite.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./vite/tempest-icons.cjs"),t=require("./vite/tempest-vitest.cjs"),n=require("./vite/create-vite-config.cjs"),r=require("./vite/tempest-pwa-manifest.cjs"),i=require("./vite/tempest-pwa-icons.cjs"),a=require("./vite/tempest-pwa-dev-sw.cjs"),o=require("./vite/tempest-styles.cjs"),s=require("./vite/tempest-csp.cjs");exports.createViteConfig=n.createViteConfig,exports.tempestCsp=s.tempestCsp,exports.tempestIcons=e.tempestIcons,exports.tempestPwaDevSw=a.tempestPwaDevSw,exports.tempestPwaIcons=i.tempestPwaIcons,exports.tempestPwaManifest=r.tempestPwaManifest,exports.tempestStyles=o.tempestStyles,exports.tempestVitest=t.tempestVitest;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./vite/tempest-icons.cjs"),t=require("./vite/tempest-vitest.cjs"),n=require("./vite/create-vite-config.cjs"),r=require("./vite/tempest-pwa-dev-sw.cjs"),i=require("./vite/tempest-pwa-manifest.cjs"),a=require("./vite/tempest-pwa-icons.cjs"),o=require("./vite/tempest-styles.cjs"),s=require("./vite/tempest-csp.cjs");exports.createViteConfig=n.createViteConfig,exports.tempestCsp=s.tempestCsp,exports.tempestIcons=e.tempestIcons,exports.tempestPwaDevSw=r.tempestPwaDevSw,exports.tempestPwaIcons=a.tempestPwaIcons,exports.tempestPwaManifest=i.tempestPwaManifest,exports.tempestStyles=o.tempestStyles,exports.tempestVitest=t.tempestVitest;

package/dist/vite.d.ts

@@ -300,20 +300,31 @@ export declare interface TempestIconsOptions {
 }
 
 /**
- * Dev-server plugin that makes the service worker available under `npm run dev`.
- *
- * The production worker is bundled at build time (`vite.sw.config.ts`), so in
- * dev there is no `/sw.js` to register. This plugin compiles `swSrc` on the fly
- * with esbuild — through one incremental context, not a cold build per request —
- * and serves it as a classic worker, plus an empty `precache-manifest.json` (there are no hashed build assets to precache in
- * dev — push and runtime caching still work). It closes the "SW in dev" gap
- * that otherwise only `vite-plugin-pwa`'s `devOptions` covered.
+ * Service-worker plugin: serves `swSrc` under `npm run dev` and bundles it into
+ * the production build.
+ *
+ * In dev there is no `/sw.js` to register. This plugin compiles `swSrc` on the
+ * fly with esbuild — through one incremental context, not a cold build per
+ * request — and serves it as a classic worker, plus an empty
+ * `precache-manifest.json` (there are no hashed build assets to precache in
+ * dev — push and runtime caching still work).
+ *
+ * In `vite build` it bundles the same entry with Vite's own `build()` (IIFE, so
+ * it registers as a classic worker, exactly what the old `vite.sw.config.ts`
+ * produced) and emits it at `swUrl`. Before 0.83.0 it was serve-only: an app
+ * with this plugin and {@link tempestPwaManifest} worked in dev and shipped a
+ * production build with no `sw.js` and a zero exit code, so registration
+ * 404'd and `navigator.serviceWorker.ready` never resolved. The emitted worker
+ * starts with the precache `version` (see {@link precacheVersionBanner}), so
+ * every deploy that changes the precache changes the worker bytes and the
+ * browser installs it. Pass `build: false` when another step bundles the
+ * worker.
  *
  * @example
  * // vite.config.ts
- * import { createViteConfig, tempestPwaDevSw } from "tempest-react-sdk/vite";
+ * import { createViteConfig, tempestPwaDevSw, tempestPwaManifest } from "tempest-react-sdk/vite";
  *
- * export default createViteConfig({ plugins: [tempestPwaDevSw()] });
+ * export default createViteConfig({ plugins: [tempestPwaManifest(), tempestPwaDevSw()] });
  */
 export declare function tempestPwaDevSw(options?: TempestPwaDevSwOptions): TempestVitePlugin;
 
@@ -337,6 +348,15 @@ export declare interface TempestPwaDevSwOptions {
     manifestUrl?: string;
     /** Serve the worker in dev. Default `true`; set `false` to opt out. */
     enabled?: boolean;
+    /**
+     * Bundle `swSrc` into the production build as `swUrl`. Default `true`.
+     *
+     * Set `false` only when another step bundles the worker (a second
+     * `vite build --config vite.sw.config.ts`, `vite-plugin-pwa`). That is also
+     * what tells {@link tempestPwaManifest} the worker is external, so its
+     * missing-worker check stands down.
+     */
+    build?: boolean;
 }
 
 /**
@@ -395,12 +415,21 @@ export declare interface TempestPwaIconsOptions {
  * `installPrecache` (from `tempest-react-sdk/sw`) reads this file at the service
  * worker's `install` event to cache the app shell for offline use.
  *
+ * Two mistakes that used to ship in silence now fail the build, after the bundle
+ * is written: no service worker emitted at
+ * {@link TempestPwaManifestOptions.serviceWorker}, and an `additionalUrls`
+ * entry that is neither in `public/` nor in the bundle. Pair it with
+ * {@link tempestPwaDevSw}, which bundles `src/sw.ts` into the same build.
+ *
  * @example
  * // vite.config.ts
- * import { createViteConfig, tempestPwaManifest } from "tempest-react-sdk/vite";
+ * import { createViteConfig, tempestPwaDevSw, tempestPwaManifest } from "tempest-react-sdk/vite";
  *
  * export default createViteConfig({
- *   plugins: [tempestPwaManifest({ additionalUrls: ["/manifest.webmanifest", "/icon.svg"] })],
+ *   plugins: [
+ *     tempestPwaManifest({ additionalUrls: ["/manifest.webmanifest", "/icon.svg"] }),
+ *     tempestPwaDevSw(),
+ *   ],
  * });
  */
 export declare function tempestPwaManifest(options?: TempestPwaManifestOptions): TempestVitePlugin;
@@ -416,6 +445,14 @@ export declare interface TempestPwaManifestOptions {
      * Write these relative to the site root (`/icon.svg`); the resolved Vite
      * `base` is prefixed for you. An entry that already carries the base is
      * left alone, so spelling it out by hand is still correct.
+     *
+     * Every same-origin entry must be a file in `public/` or in the bundle, or
+     * the build fails. A URL that resolves to nothing is answered in production
+     * by the SPA fallback (`index.html`) or a 404, so the precache would store
+     * the app shell under that name, or fail the worker's install outright. The
+     * usual culprit is a web manifest linked from `index.html` but kept outside
+     * `public/`: Vite hashes it into `assets/`, where it is already precached.
+     * Absolute `http(s):` URLs are not checked.
      */
     additionalUrls?: string[];
     /** Emitted files matching this are skipped. Default `/\.map$/` (source maps). */
@@ -431,6 +468,20 @@ export declare interface TempestPwaManifestOptions {
      * with the resolved Vite `base`.
      */
     appShell?: string | false;
+    /**
+     * URL of the service worker that reads this manifest. The build fails when
+     * no file is emitted at that URL. Default: the `swUrl` of
+     * {@link tempestPwaDevSw} when it is in the plugin list, `/sw.js` otherwise.
+     *
+     * A precache manifest is only read by a worker, and a build that ships the
+     * manifest without the worker exits 0 while registration 404s in
+     * production — `navigator.serviceWorker.ready` never resolves and push,
+     * updates and offline all hang without a message. Pass `false` when the
+     * worker is bundled by a separate step after this build (a second
+     * `vite build --config vite.sw.config.ts`); `tempestPwaDevSw({ build: false })`
+     * already says the same and needs nothing here.
+     */
+    serviceWorker?: string | false;
 }
 
 /**

package/dist/vite.js

@@ -1,9 +1,9 @@
 import { tempestIcons as e } from "./vite/tempest-icons.js";
 import { tempestVitest as t } from "./vite/tempest-vitest.js";
 import { createViteConfig as n } from "./vite/create-vite-config.js";
-import { tempestPwaManifest as r } from "./vite/tempest-pwa-manifest.js";
-import { tempestPwaIcons as i } from "./vite/tempest-pwa-icons.js";
-import { tempestPwaDevSw as a } from "./vite/tempest-pwa-dev-sw.js";
+import { tempestPwaDevSw as r } from "./vite/tempest-pwa-dev-sw.js";
+import { tempestPwaManifest as i } from "./vite/tempest-pwa-manifest.js";
+import { tempestPwaIcons as a } from "./vite/tempest-pwa-icons.js";
 import { tempestStyles as o } from "./vite/tempest-styles.js";
 import { tempestCsp as s } from "./vite/tempest-csp.js";
-export { n as createViteConfig, s as tempestCsp, e as tempestIcons, a as tempestPwaDevSw, i as tempestPwaIcons, r as tempestPwaManifest, o as tempestStyles, t as tempestVitest };
+export { n as createViteConfig, s as tempestCsp, e as tempestIcons, r as tempestPwaDevSw, a as tempestPwaIcons, i as tempestPwaManifest, o as tempestStyles, t as tempestVitest };

package/package.json

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