@farm.js/pwa 0.1.0-beta.0 → 0.1.0-beta.1

package/README.md

@@ -1,7 +1,8 @@
 # @farm.js/pwa
 
 Installable, offline-aware Progressive Web Apps for Farm.js. The plugin generates a route-aware
-service worker during the production build and registers it through Farm's browser plugin lifecycle.
+service worker or copies a custom one during the production build, then registers it through Farm's
+browser plugin lifecycle.
 
 Farm.js is currently in beta.
 
@@ -21,7 +22,7 @@ export default defineConfig({
   plugins: [
     pwa({
       offline: "/offline",
-      cache: "recommended",
+      cache: "auto",
     }),
   ],
 });
@@ -33,15 +34,18 @@ does not duplicate it.
 
 ## Short cache configuration
 
-`recommended` precaches emitted static pages and uses SWR for public same-origin images:
+`auto` precaches emitted static pages and uses SWR for public same-origin images. It is the default,
+so you can omit `cache` when you want this behavior:
 
 ```ts
 pwa({
   offline: "/offline",
-  cache: "recommended",
+  cache: "auto",
 });
 ```
 
+The previous `recommended` value remains available as a compatibility alias for `auto`.
+
 The explicit short form is:
 
 ```ts
@@ -71,6 +75,25 @@ pwa({
 });
 ```
 
+## Bring your own service worker
+
+Advanced applications can replace the generated worker with a prebuilt JavaScript file:
+
+```ts
+pwa({
+  serviceWorker: {
+    source: "src/service-worker.js",
+    type: "module",
+  },
+});
+```
+
+The source path is relative to the Farm project root. Farm copies the file verbatim to the final
+`sw.js` location and keeps its production registration and update lifecycle. A custom worker owns
+all fetch, offline, and cache behavior, so `serviceWorker` cannot be combined with `offline` or
+`cache`. It must handle the `FARM_PWA_SKIP_WAITING` message for Farm's update action to activate a
+waiting worker.
+
 ## Updates
 
 `update: "prompt"` is the default. The plugin dispatches `farm:pwa:update-available` when a new

package/dist/build.d.ts

@@ -1,5 +1,6 @@
 import type { ResolvedPwaOptions } from "./config.js";
 export interface PwaBuildInput {
+    root?: string;
     outputDir: string;
     publicDir?: string;
     preset: string;
@@ -7,6 +8,7 @@ export interface PwaBuildInput {
     options: ResolvedPwaOptions;
 }
 export interface PwaBuildResult {
+    mode: "generated" | "custom";
     workerPath: string;
     workerUrl: string;
     precacheUrls: string[];

package/dist/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAcD,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CA0E1F;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7B,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;CAC/C;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAkJnF;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK7E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGnE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQpE"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAcD,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAsG1F;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7B,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;CAC/C;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAkJnF;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK7E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGnE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQpE"}

package/dist/build.js

@@ -14,10 +14,31 @@ const PRECACHE_EXTENSIONS = new Set([
 ]);
 export async function writePwaBuildArtifacts(input) {
     const publicDir = input.publicDir ?? resolvePwaPublicDir(input.outputDir, input.preset);
-    const files = await walkFiles(publicDir);
-    const staticRouteFiles = resolveStaticRouteFiles(files);
     const basePath = normalizeBasePath(input.basePath);
     const workerRelativePath = path.posix.join(basePath.replace(/^\//, ""), "sw.js");
+    const workerPath = path.join(publicDir, ...workerRelativePath.split("/"));
+    if (input.options.serviceWorker) {
+        const sourcePath = path.resolve(input.root ?? process.cwd(), input.options.serviceWorker.source);
+        let source;
+        try {
+            source = await readFile(sourcePath);
+        }
+        catch (cause) {
+            throw new Error(`[farm:pwa] Custom service worker ${JSON.stringify(input.options.serviceWorker.source)} could not be read.`, { cause });
+        }
+        await mkdir(path.dirname(workerPath), { recursive: true });
+        await writeFile(workerPath, source);
+        return {
+            mode: "custom",
+            workerPath,
+            workerUrl: withBasePath("/sw.js", basePath),
+            precacheUrls: [],
+            staticRoutes: {},
+            cacheId: createHash("sha256").update(source).digest("hex").slice(0, 16),
+        };
+    }
+    const files = await walkFiles(publicDir);
+    const staticRouteFiles = resolveStaticRouteFiles(files);
     const selectedRoutes = selectStaticRoutes(staticRouteFiles, input.options.cache.staticRoutes, basePath);
     const configuredOfflineRoute = input.options.offline;
     const offlineRoute = configuredOfflineRoute
@@ -48,7 +69,6 @@ export async function writePwaBuildArtifacts(input) {
     }))
         .digest("hex")
         .slice(0, 16);
-    const workerPath = path.join(publicDir, ...workerRelativePath.split("/"));
     await mkdir(path.dirname(workerPath), { recursive: true });
     await writeFile(workerPath, generateServiceWorker({
         cacheId,
@@ -59,6 +79,7 @@ export async function writePwaBuildArtifacts(input) {
         images: input.options.cache.images,
     }));
     return {
+        mode: "generated",
         workerPath,
         workerUrl: withBasePath("/sw.js", basePath),
         precacheUrls,

package/dist/config.d.ts

@@ -14,6 +14,12 @@ export interface PwaCacheOptions {
     /** Opt in to same-origin public image caching. */
     images?: PwaImageCache;
 }
+export interface PwaServiceWorkerOptions {
+    /** JavaScript file copied verbatim into the production output as sw.js. */
+    source: string;
+    /** Registration type for the custom worker. */
+    type?: "classic" | "module";
+}
 export interface PwaPluginOptions {
     /** Set false to keep the plugin registered without emitting or registering a worker. */
     enabled?: boolean;
@@ -21,8 +27,10 @@ export interface PwaPluginOptions {
     offline?: string | false;
     /** How a waiting service worker becomes active. */
     update?: "prompt" | "auto";
-    /** Recommended caching, custom caching, or build assets only. */
-    cache?: "recommended" | PwaCacheOptions | false;
+    /** Generated-worker caching, a custom cache policy, or build assets only. */
+    cache?: "auto" | "recommended" | PwaCacheOptions | false;
+    /** Copy and register a prebuilt service worker instead of generating one. */
+    serviceWorker?: PwaServiceWorkerOptions;
 }
 export interface ResolvedPwaImageCacheOptions {
     strategy: "swr";
@@ -33,6 +41,7 @@ export interface ResolvedPwaOptions {
     enabled: boolean;
     offline: string | false;
     update: "prompt" | "auto";
+    serviceWorker: Required<PwaServiceWorkerOptions> | false;
     cache: {
         staticRoutes: boolean | string[];
         images: ResolvedPwaImageCacheOptions | false;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;AAE7E,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,EAAE,KAAK,CAAC;IAChB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,oBAAoB,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAClC,kDAAkD;IAClD,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzB,mDAAmD;IACnD,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,iEAAiE;IACjE,KAAK,CAAC,EAAE,aAAa,GAAG,eAAe,GAAG,KAAK,CAAC;CACjD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,KAAK,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,KAAK,EAAE;QACL,YAAY,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;QACjC,MAAM,EAAE,4BAA4B,GAAG,KAAK,CAAC;KAC9C,CAAC;CACH;AAKD,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,gBAAqB,GAAG,kBAAkB,CAuBpF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA0B3D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;AAE7E,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,EAAE,KAAK,CAAC;IAChB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,oBAAoB,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAClC,kDAAkD;IAClD,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzB,mDAAmD;IACnD,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,eAAe,GAAG,KAAK,CAAC;IACzD,6EAA6E;IAC7E,aAAa,CAAC,EAAE,uBAAuB,CAAC;CACzC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,KAAK,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,aAAa,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,KAAK,CAAC;IACzD,KAAK,EAAE;QACL,YAAY,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;QACjC,MAAM,EAAE,4BAA4B,GAAG,KAAK,CAAC;KAC9C,CAAC;CACH;AAKD,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,gBAAqB,GAAG,kBAAkB,CAkCpF;AAcD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA0B3D"}

package/dist/config.js

@@ -1,26 +1,47 @@
 const DEFAULT_IMAGE_LIMIT = 100;
 const DEFAULT_IMAGE_TTL = "30d";
 export function resolvePwaOptions(options = {}) {
-    const cache = options.cache ?? "recommended";
+    const serviceWorker = resolveServiceWorker(options.serviceWorker);
+    if (serviceWorker && (options.offline !== undefined || options.cache !== undefined)) {
+        throw new TypeError("PWA serviceWorker cannot be combined with offline or cache because the custom worker owns those behaviors");
+    }
+    const cache = options.cache ?? "auto";
+    const usesAutomaticCache = cache === "auto" || cache === "recommended";
     const customCache = typeof cache === "object" ? cache : undefined;
     return {
         enabled: options.enabled !== false,
-        offline: normalizeRoute(options.offline ?? false, "offline"),
+        offline: serviceWorker ? false : normalizeRoute(options.offline ?? false, "offline"),
         update: options.update ?? "prompt",
+        serviceWorker,
         cache: {
-            staticRoutes: cache === "recommended"
-                ? true
-                : cache === false
-                    ? false
-                    : normalizeStaticRoutes(customCache?.staticRoutes ?? false),
-            images: cache === "recommended"
-                ? resolveImageCache("swr")
-                : cache === false
-                    ? false
-                    : resolveImageCache(customCache?.images ?? false),
+            staticRoutes: serviceWorker
+                ? false
+                : usesAutomaticCache
+                    ? true
+                    : cache === false
+                        ? false
+                        : normalizeStaticRoutes(customCache?.staticRoutes ?? false),
+            images: serviceWorker
+                ? false
+                : usesAutomaticCache
+                    ? resolveImageCache("swr")
+                    : cache === false
+                        ? false
+                        : resolveImageCache(customCache?.images ?? false),
         },
     };
 }
+function resolveServiceWorker(value) {
+    if (!value)
+        return false;
+    const source = value.source.trim();
+    if (!source)
+        throw new TypeError("PWA serviceWorker source must be a non-empty path");
+    if (value.type !== undefined && value.type !== "classic" && value.type !== "module") {
+        throw new TypeError('PWA serviceWorker type must be "classic" or "module"');
+    }
+    return { source, type: value.type ?? "classic" };
+}
 export function parsePwaDuration(value) {
     if (typeof value === "number") {
         if (!Number.isFinite(value) || value <= 0) {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { type PwaCacheOptions, type PwaDuration, type PwaImageCache, type PwaImageCacheOptions, type PwaPluginOptions } from "./config.js";
-export type { PwaCacheOptions, PwaDuration, PwaImageCache, PwaImageCacheOptions, PwaPluginOptions };
+import { type PwaCacheOptions, type PwaDuration, type PwaImageCache, type PwaImageCacheOptions, type PwaPluginOptions, type PwaServiceWorkerOptions } from "./config.js";
+export type { PwaCacheOptions, PwaDuration, PwaImageCache, PwaImageCacheOptions, PwaPluginOptions, PwaServiceWorkerOptions, };
 export interface FarmPwaBrowserRuntime {
     registration: ServiceWorkerRegistration;
     applyUpdate(): void;
@@ -15,9 +15,9 @@ declare global {
     }
 }
 /**
- * Generate and register a route-aware service worker for a Farm application.
- * Build assets are always precached. Optional page and image caching stays
- * constrained to safe GET navigation and same-origin image requests.
+ * Generate or copy and then register a service worker for a Farm application.
+ * In generated mode, build assets are always precached while optional page and
+ * image caching stays constrained to safe GET navigation and same-origin images.
  */
 export declare function pwa(options?: PwaPluginOptions): import("@farm.js/core/plugin").FarmPlugin<undefined, Record<string, never>, {
     cleanup(): void;
@@ -26,5 +26,6 @@ export declare function pwa(options?: PwaPluginOptions): import("@farm.js/core/p
     workerUrl: string;
     scope: string;
     update: "prompt" | "auto";
+    workerType: "classic" | "module";
 }, unknown, false>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,CAAC;AAEpG,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,yBAAyB,CAAC;IACxC,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,yBAAyB,CAAC;IACxC,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,mDAAmD;QACnD,YAAY,CAAC,EAAE,qBAAqB,CAAC;KACtC;CACF;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,OAAO,GAAE,gBAAqB;;;;;;;mBAoIjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,GACxB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,yBAAyB,CAAC;IACxC,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,yBAAyB,CAAC;IACxC,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,mDAAmD;QACnD,YAAY,CAAC,EAAE,qBAAqB,CAAC;KACtC;CACF;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,OAAO,GAAE,gBAAqB;;;;;;;;mBA6IjD"}

package/dist/index.js

@@ -2,12 +2,13 @@ import { definePlugin } from "@farm.js/core/plugin";
 import { normalizeBasePath, withBasePath, writePwaBuildArtifacts } from "./build.js";
 import { resolvePwaOptions, } from "./config.js";
 /**
- * Generate and register a route-aware service worker for a Farm application.
- * Build assets are always precached. Optional page and image caching stays
- * constrained to safe GET navigation and same-origin image requests.
+ * Generate or copy and then register a service worker for a Farm application.
+ * In generated mode, build assets are always precached while optional page and
+ * image caching stays constrained to safe GET navigation and same-origin images.
  */
 export function pwa(options = {}) {
     const resolved = resolvePwaOptions(options);
+    let configuredRoot = ".";
     let configuredBasePath = "/";
     let configuredOutputDir = ".farm/.output";
     const publicConfig = {
@@ -15,10 +16,12 @@ export function pwa(options = {}) {
         workerUrl: "/sw.js",
         scope: "/",
         update: resolved.update,
+        workerType: resolved.serviceWorker ? resolved.serviceWorker.type : "classic",
     };
     return definePlugin({
         name: "farm:pwa",
         configure(config) {
+            configuredRoot = config.root ?? ".";
             const basePath = normalizeBasePath(config.basePath);
             configuredBasePath = basePath;
             configuredOutputDir = `${config.root ?? "."}/.farm/.output`;
@@ -37,6 +40,7 @@ export function pwa(options = {}) {
                     if (generated)
                         return;
                     const built = await writePwaBuildArtifacts({
+                        root: configuredRoot,
                         outputDir: nitroConfig.output?.dir ?? configuredOutputDir,
                         publicDir: nitroConfig.output?.publicDir,
                         preset: nitroConfig.preset ?? "node-server",
@@ -44,7 +48,9 @@ export function pwa(options = {}) {
                         options: resolved,
                     });
                     generated = true;
-                    console.info(`[farm:pwa] Generated ${built.workerUrl} with ${built.precacheUrls.length} precached files`);
+                    console.info(built.mode === "custom"
+                        ? `[farm:pwa] Copied custom service worker to ${built.workerUrl}`
+                        : `[farm:pwa] Generated ${built.workerUrl} with ${built.precacheUrls.length} precached files`);
                 };
                 return {
                     ...nitroConfig,
@@ -69,9 +75,9 @@ export function pwa(options = {}) {
             async setup({ public: config, isProd }) {
                 if (!config.enabled || !isProd || !("serviceWorker" in navigator))
                     return undefined;
-                const registration = await navigator.serviceWorker.register(config.workerUrl, {
-                    scope: config.scope,
-                });
+                const registration = await navigator.serviceWorker.register(config.workerUrl, config.workerType === "module"
+                    ? { scope: config.scope, type: "module" }
+                    : { scope: config.scope });
                 const hadControllerAtSetup = Boolean(navigator.serviceWorker.controller);
                 let applyingUpdate = false;
                 let reloading = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farm.js/pwa",
-  "version": "0.1.0-beta.0",
+  "version": "0.1.0-beta.1",
   "description": "Installable, offline-aware Progressive Web Apps for Farm.js",
   "keywords": [
     "farm.js",
@@ -32,7 +32,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@farm.js/core": "0.1.0-beta.68"
+    "@farm.js/core": "0.1.0-beta.69"
   },
   "devDependencies": {
     "@types/node": "^20.10.5",