@djangocfg/nextjs 2.1.515 → 2.1.518

package/dist/pwa/manifest.d.mts

@@ -0,0 +1,194 @@
+import { MetadataRoute, Metadata, Viewport } from 'next';
+
+/**
+ * PWA Manifest Metadata Utilities
+ *
+ * Helper functions for creating Next.js metadata for PWA manifest
+ */
+
+interface ManifestConfig {
+    name: string;
+    shortName?: string;
+    description?: string;
+    themeColor?: string;
+    backgroundColor?: string;
+    display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';
+    orientation?: 'portrait' | 'landscape' | 'any';
+    startUrl?: string;
+    scope?: string;
+    lang?: string;
+    dir?: 'ltr' | 'rtl' | 'auto';
+    icons?: {
+        src: string;
+        sizes: string;
+        type?: string;
+        purpose?: string;
+    }[];
+}
+/**
+ * Icon paths configuration
+ */
+interface IconPaths {
+    logo192?: string;
+    logo384?: string;
+    logo512?: string;
+}
+/**
+ * Protocol handler configuration
+ * Allows your PWA to register as a handler for custom protocols
+ *
+ * @example
+ * ```typescript
+ * {
+ *   protocol: "web+music",
+ *   url: "/play?track=%s"
+ * }
+ * ```
+ */
+interface ProtocolHandler {
+    /** Protocol scheme (e.g., "web+music", "mailto", "magnet") */
+    protocol: string;
+    /** URL template with %s placeholder for the protocol parameter */
+    url: string;
+}
+/**
+ * Create viewport configuration for Next.js app
+ *
+ * @example
+ * ```typescript
+ * export const viewport: Viewport = createViewport({
+ *   themeColor: '#ffffff',
+ * });
+ * ```
+ */
+declare function createViewport(config: {
+    themeColor?: string;
+}): Viewport;
+/**
+ * Create manifest metadata for Next.js app
+ *
+ * Note: themeColor and viewport should be exported separately using createViewport()
+ *
+ * @example
+ * ```typescript
+ * export const metadata: Metadata = {
+ *   ...createManifestMetadata({
+ *     name: 'My App',
+ *     shortName: 'App',
+ *     description: 'My awesome app',
+ *   }),
+ * };
+ *
+ * export const viewport: Viewport = createViewport({
+ *   themeColor: '#ffffff',
+ * });
+ * ```
+ */
+declare function createManifestMetadata(config: ManifestConfig): Metadata;
+/**
+ * Create Next.js manifest function
+ *
+ * Use this in your app/manifest.ts file
+ *
+ * @example
+ * ```typescript
+ * // app/manifest.ts
+ * import { createManifest } from '@djangocfg/nextjs/config';
+ * import { settings } from '@core/settings';
+ *
+ * export default createManifest({
+ *   name: settings.app.name,
+ *   description: settings.app.description,
+ *   icons: {
+ *     logo192: settings.app.icons.logo192,
+ *     logo384: settings.app.icons.logo384,
+ *     logo512: settings.app.icons.logo512,
+ *   },
+ * });
+ * ```
+ */
+interface ScreenshotConfig {
+    src: string;
+    sizes: string;
+    type?: string;
+    form_factor?: 'narrow' | 'wide';
+    label?: string;
+}
+/**
+ * Smart screenshot configuration
+ * Automatically detects everything from path or uses defaults
+ */
+interface SmartScreenshotInput {
+    src: string;
+    /** Form factor (auto-detected from filename if contains 'desktop'/'mobile', or use default) */
+    form_factor?: 'narrow' | 'wide';
+    /** Optional label (auto-generated from form_factor) */
+    label?: string;
+    /** Optional width (defaults based on form_factor) */
+    width?: number;
+    /** Optional height (defaults based on form_factor) */
+    height?: number;
+}
+/**
+ * Create screenshot config with smart defaults
+ * Automatically detects type, sizes, form_factor from path or uses sensible defaults
+ *
+ * @example
+ * ```typescript
+ * // Minimal - everything auto-detected
+ * createScreenshot({ src: '/screenshots/desktop-view.png' })
+ * // → form_factor: 'wide', sizes: '1920x1080', type: 'image/png', label: 'Desktop screenshot'
+ *
+ * createScreenshot({ src: '/screenshots/mobile.png' })
+ * // → form_factor: 'narrow', sizes: '390x844', type: 'image/png', label: 'Mobile screenshot'
+ *
+ * // With custom dimensions
+ * createScreenshot({ src: '/screenshots/tablet.png', width: 1024, height: 768 })
+ * ```
+ */
+declare function createScreenshot(input: SmartScreenshotInput | string): ScreenshotConfig;
+/**
+ * Create multiple screenshots from array
+ * Supports string shorthand or full config objects
+ *
+ * @example
+ * ```typescript
+ * // Minimal - just paths
+ * createScreenshots([
+ *   '/screenshots/desktop.png',  // Auto: wide, 1920x1080
+ *   '/screenshots/mobile.png',   // Auto: narrow, 390x844
+ * ])
+ *
+ * // Mixed
+ * createScreenshots([
+ *   '/screenshots/desktop.png',
+ *   { src: '/screenshots/tablet.png', width: 1024, height: 768 },
+ * ])
+ * ```
+ */
+declare function createScreenshots(inputs: Array<SmartScreenshotInput | string>): ScreenshotConfig[];
+declare function createManifest(config: {
+    name: string;
+    shortName?: string;
+    description?: string;
+    themeColor?: string;
+    backgroundColor?: string;
+    display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';
+    orientation?: 'portrait' | 'landscape' | 'any';
+    id?: string;
+    startUrl?: string;
+    scope?: string;
+    lang?: string;
+    dir?: 'ltr' | 'rtl' | 'auto';
+    icons?: IconPaths | ManifestConfig['icons'];
+    screenshots?: ScreenshotConfig[];
+    protocol_handlers?: ProtocolHandler[];
+}): () => MetadataRoute.Manifest;
+/**
+ * Generate manifest.json content (legacy)
+ *
+ * @deprecated Use createManifest() instead
+ */
+declare function generateManifest(config: ManifestConfig): Record<string, any>;
+
+export { type IconPaths, type ManifestConfig, type ProtocolHandler, type ScreenshotConfig, type SmartScreenshotInput, createManifest, createManifestMetadata, createScreenshot, createScreenshots, createViewport, generateManifest };

package/dist/pwa/manifest.mjs

@@ -0,0 +1,136 @@
+// src/pwa/manifest.ts
+function createViewport(config) {
+  return {
+    width: "device-width",
+    initialScale: 1,
+    maximumScale: 1,
+    themeColor: config.themeColor || "#000000"
+  };
+}
+function createManifestMetadata(config) {
+  return {
+    manifest: "/manifest.json",
+    appleWebApp: {
+      capable: true,
+      statusBarStyle: "default",
+      title: config.shortName || config.name
+    },
+    applicationName: config.name,
+    formatDetection: {
+      telephone: false
+    }
+  };
+}
+function createScreenshot(input) {
+  const config = typeof input === "string" ? { src: input } : input;
+  let { src, width, height, label, form_factor } = config;
+  const ext = src.split(".").pop()?.toLowerCase();
+  const typeMap = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    webp: "image/webp",
+    svg: "image/svg+xml"
+  };
+  const type = ext ? typeMap[ext] || "image/png" : "image/png";
+  const filename = src.toLowerCase();
+  const dimensionMatch = filename.match(/(\d{3,4})x(\d{3,4})/);
+  if (dimensionMatch && !width && !height) {
+    width = parseInt(dimensionMatch[1], 10);
+    height = parseInt(dimensionMatch[2], 10);
+  }
+  let autoFormFactor = "wide";
+  if (filename.includes("mobile") || filename.includes("phone") || filename.includes("narrow")) {
+    autoFormFactor = "narrow";
+  } else if (filename.includes("desktop") || filename.includes("laptop") || filename.includes("wide")) {
+    autoFormFactor = "wide";
+  } else if (width && height) {
+    const aspectRatio = width / height;
+    autoFormFactor = aspectRatio > 1.2 ? "wide" : "narrow";
+  }
+  const finalFormFactor = form_factor || autoFormFactor;
+  const defaultDimensions = finalFormFactor === "wide" ? { width: 1920, height: 1080 } : { width: 390, height: 844 };
+  const finalWidth = width || defaultDimensions.width;
+  const finalHeight = height || defaultDimensions.height;
+  const autoLabel = finalFormFactor === "wide" ? "Desktop screenshot" : "Mobile screenshot";
+  return {
+    src,
+    sizes: `${finalWidth}x${finalHeight}`,
+    type,
+    form_factor: finalFormFactor,
+    label: label || autoLabel
+  };
+}
+function createScreenshots(inputs) {
+  return inputs.map(createScreenshot);
+}
+function createManifest(config) {
+  return () => {
+    let manifestIcons;
+    if (Array.isArray(config.icons)) {
+      manifestIcons = config.icons;
+    } else if (config.icons) {
+      const { logo192, logo384, logo512 } = config.icons;
+      manifestIcons = [
+        ...logo192 ? [
+          {
+            src: logo192,
+            sizes: "192x192",
+            type: "image/png",
+            purpose: "maskable"
+          }
+        ] : [],
+        ...logo384 ? [
+          {
+            src: logo384,
+            sizes: "384x384",
+            type: "image/png"
+          }
+        ] : [],
+        ...logo512 ? [
+          {
+            src: logo512,
+            sizes: "512x512",
+            type: "image/png"
+          }
+        ] : []
+      ];
+    }
+    const manifest = {
+      name: config.name,
+      short_name: config.shortName || config.name,
+      description: config.description || config.name,
+      id: config.id || config.startUrl || "/",
+      start_url: config.startUrl || "/",
+      scope: config.scope || "/",
+      display: config.display || "standalone",
+      orientation: config.orientation || "portrait",
+      background_color: config.backgroundColor || "#000000",
+      theme_color: config.themeColor || "#ffffff",
+      lang: config.lang || "en",
+      dir: config.dir || "ltr",
+      icons: manifestIcons
+      // Removed forced gcm_sender_id to avoid potential conflicts with VAPID
+      // gcm_sender_id: '103953800507',
+    };
+    if (config.screenshots && config.screenshots.length > 0) {
+      manifest.screenshots = config.screenshots;
+    }
+    if (config.protocol_handlers && config.protocol_handlers.length > 0) {
+      manifest.protocol_handlers = config.protocol_handlers;
+    }
+    return manifest;
+  };
+}
+function generateManifest(config) {
+  return createManifest(config)();
+}
+export {
+  createManifest,
+  createManifestMetadata,
+  createScreenshot,
+  createScreenshots,
+  createViewport,
+  generateManifest
+};
+//# sourceMappingURL=manifest.mjs.map

package/dist/pwa/manifest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/pwa/manifest.ts"],"sourcesContent":["/**\n * PWA Manifest Metadata Utilities\n *\n * Helper functions for creating Next.js metadata for PWA manifest\n */\n\nimport type { Metadata, MetadataRoute, Viewport } from 'next';\n\nexport interface ManifestConfig {\n  name: string;\n  shortName?: string;\n  description?: string;\n  themeColor?: string;\n  backgroundColor?: string;\n  display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';\n  orientation?: 'portrait' | 'landscape' | 'any';\n  startUrl?: string;\n  scope?: string;\n  lang?: string;\n  dir?: 'ltr' | 'rtl' | 'auto';\n  icons?: {\n    src: string;\n    sizes: string;\n    type?: string;\n    purpose?: string;\n  }[];\n}\n\n/**\n * Icon paths configuration\n */\nexport interface IconPaths {\n  logo192?: string;\n  logo384?: string;\n  logo512?: string;\n}\n\n/**\n * Protocol handler configuration\n * Allows your PWA to register as a handler for custom protocols\n *\n * @example\n * ```typescript\n * {\n *   protocol: \"web+music\",\n *   url: \"/play?track=%s\"\n * }\n * ```\n */\nexport interface ProtocolHandler {\n  /** Protocol scheme (e.g., \"web+music\", \"mailto\", \"magnet\") */\n  protocol: string;\n  /** URL template with %s placeholder for the protocol parameter */\n  url: string;\n}\n\n/**\n * Create viewport configuration for Next.js app\n *\n * @example\n * ```typescript\n * export const viewport: Viewport = createViewport({\n *   themeColor: '#ffffff',\n * });\n * ```\n */\nexport function createViewport(config: { themeColor?: string }): Viewport {\n  return {\n    width: 'device-width',\n    initialScale: 1,\n    maximumScale: 1,\n    themeColor: config.themeColor || '#000000',\n  };\n}\n\n/**\n * Create manifest metadata for Next.js app\n *\n * Note: themeColor and viewport should be exported separately using createViewport()\n *\n * @example\n * ```typescript\n * export const metadata: Metadata = {\n *   ...createManifestMetadata({\n *     name: 'My App',\n *     shortName: 'App',\n *     description: 'My awesome app',\n *   }),\n * };\n *\n * export const viewport: Viewport = createViewport({\n *   themeColor: '#ffffff',\n * });\n * ```\n */\nexport function createManifestMetadata(config: ManifestConfig): Metadata {\n  return {\n    manifest: '/manifest.json',\n    appleWebApp: {\n      capable: true,\n      statusBarStyle: 'default',\n      title: config.shortName || config.name,\n    },\n    applicationName: config.name,\n    formatDetection: {\n      telephone: false,\n    },\n  };\n}\n\n/**\n * Create Next.js manifest function\n *\n * Use this in your app/manifest.ts file\n *\n * @example\n * ```typescript\n * // app/manifest.ts\n * import { createManifest } from '@djangocfg/nextjs/config';\n * import { settings } from '@core/settings';\n *\n * export default createManifest({\n *   name: settings.app.name,\n *   description: settings.app.description,\n *   icons: {\n *     logo192: settings.app.icons.logo192,\n *     logo384: settings.app.icons.logo384,\n *     logo512: settings.app.icons.logo512,\n *   },\n * });\n * ```\n */\nexport interface ScreenshotConfig {\n  src: string;\n  sizes: string;\n  type?: string;\n  form_factor?: 'narrow' | 'wide';\n  label?: string;\n}\n\n/**\n * Smart screenshot configuration\n * Automatically detects everything from path or uses defaults\n */\nexport interface SmartScreenshotInput {\n  src: string;\n  /** Form factor (auto-detected from filename if contains 'desktop'/'mobile', or use default) */\n  form_factor?: 'narrow' | 'wide';\n  /** Optional label (auto-generated from form_factor) */\n  label?: string;\n  /** Optional width (defaults based on form_factor) */\n  width?: number;\n  /** Optional height (defaults based on form_factor) */\n  height?: number;\n}\n\n/**\n * Create screenshot config with smart defaults\n * Automatically detects type, sizes, form_factor from path or uses sensible defaults\n *\n * @example\n * ```typescript\n * // Minimal - everything auto-detected\n * createScreenshot({ src: '/screenshots/desktop-view.png' })\n * // → form_factor: 'wide', sizes: '1920x1080', type: 'image/png', label: 'Desktop screenshot'\n *\n * createScreenshot({ src: '/screenshots/mobile.png' })\n * // → form_factor: 'narrow', sizes: '390x844', type: 'image/png', label: 'Mobile screenshot'\n *\n * // With custom dimensions\n * createScreenshot({ src: '/screenshots/tablet.png', width: 1024, height: 768 })\n * ```\n */\nexport function createScreenshot(input: SmartScreenshotInput | string): ScreenshotConfig {\n  // Allow string shorthand\n  const config = typeof input === 'string' ? { src: input } : input;\n  let { src, width, height, label, form_factor } = config;\n\n  // Auto-detect image type from extension\n  const ext = src.split('.').pop()?.toLowerCase();\n  const typeMap: Record<string, string> = {\n    png: 'image/png',\n    jpg: 'image/jpeg',\n    jpeg: 'image/jpeg',\n    webp: 'image/webp',\n    svg: 'image/svg+xml',\n  };\n  const type = ext ? typeMap[ext] || 'image/png' : 'image/png';\n\n  // Try to parse dimensions from filename (e.g., \"1920x1080.png\" or \"screenshot-390x844.png\")\n  const filename = src.toLowerCase();\n  const dimensionMatch = filename.match(/(\\d{3,4})x(\\d{3,4})/);\n  if (dimensionMatch && !width && !height) {\n    width = parseInt(dimensionMatch[1], 10);\n    height = parseInt(dimensionMatch[2], 10);\n  }\n\n  // Auto-detect form_factor from filename if not provided\n  let autoFormFactor: 'narrow' | 'wide' = 'wide'; // Default to wide\n  if (filename.includes('mobile') || filename.includes('phone') || filename.includes('narrow')) {\n    autoFormFactor = 'narrow';\n  } else if (filename.includes('desktop') || filename.includes('laptop') || filename.includes('wide')) {\n    autoFormFactor = 'wide';\n  } else if (width && height) {\n    // Calculate from dimensions if provided or parsed\n    const aspectRatio = width / height;\n    autoFormFactor = aspectRatio > 1.2 ? 'wide' : 'narrow';\n  }\n\n  const finalFormFactor = form_factor || autoFormFactor;\n\n  // Default dimensions based on form_factor (only if not parsed from filename)\n  const defaultDimensions = finalFormFactor === 'wide'\n    ? { width: 1920, height: 1080 } // Desktop default\n    : { width: 390, height: 844 };  // Mobile default (iPhone 14)\n\n  const finalWidth = width || defaultDimensions.width;\n  const finalHeight = height || defaultDimensions.height;\n\n  // Auto-generate label\n  const autoLabel = finalFormFactor === 'wide'\n    ? 'Desktop screenshot'\n    : 'Mobile screenshot';\n\n  return {\n    src,\n    sizes: `${finalWidth}x${finalHeight}`,\n    type,\n    form_factor: finalFormFactor,\n    label: label || autoLabel,\n  };\n}\n\n/**\n * Create multiple screenshots from array\n * Supports string shorthand or full config objects\n *\n * @example\n * ```typescript\n * // Minimal - just paths\n * createScreenshots([\n *   '/screenshots/desktop.png',  // Auto: wide, 1920x1080\n *   '/screenshots/mobile.png',   // Auto: narrow, 390x844\n * ])\n *\n * // Mixed\n * createScreenshots([\n *   '/screenshots/desktop.png',\n *   { src: '/screenshots/tablet.png', width: 1024, height: 768 },\n * ])\n * ```\n */\nexport function createScreenshots(inputs: Array<SmartScreenshotInput | string>): ScreenshotConfig[] {\n  return inputs.map(createScreenshot);\n}\n\nexport function createManifest(config: {\n  name: string;\n  shortName?: string;\n  description?: string;\n  themeColor?: string;\n  backgroundColor?: string;\n  display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';\n  orientation?: 'portrait' | 'landscape' | 'any';\n  id?: string;\n  startUrl?: string;\n  scope?: string;\n  lang?: string;\n  dir?: 'ltr' | 'rtl' | 'auto';\n  icons?: IconPaths | ManifestConfig['icons'];\n  screenshots?: ScreenshotConfig[];\n  protocol_handlers?: ProtocolHandler[];\n}): () => MetadataRoute.Manifest {\n  return () => {\n    // Convert IconPaths to manifest icons format\n    let manifestIcons: MetadataRoute.Manifest['icons'];\n\n    if (Array.isArray(config.icons)) {\n      // Already in manifest format\n      manifestIcons = config.icons as MetadataRoute.Manifest['icons'];\n    } else if (config.icons) {\n      // Convert IconPaths to manifest icons\n      const { logo192, logo384, logo512 } = config.icons as IconPaths;\n      manifestIcons = [\n        ...(logo192\n          ? [\n              {\n                src: logo192,\n                sizes: '192x192',\n                type: 'image/png',\n                purpose: 'maskable' as const,\n              },\n            ]\n          : []),\n        ...(logo384\n          ? [\n              {\n                src: logo384,\n                sizes: '384x384',\n                type: 'image/png',\n              },\n            ]\n          : []),\n        ...(logo512\n          ? [\n              {\n                src: logo512,\n                sizes: '512x512',\n                type: 'image/png',\n              },\n            ]\n          : []),\n      ];\n    }\n\n    const manifest: MetadataRoute.Manifest = {\n      name: config.name,\n      short_name: config.shortName || config.name,\n      description: config.description || config.name,\n      id: config.id || config.startUrl || '/',\n      start_url: config.startUrl || '/',\n      scope: config.scope || '/',\n      display: config.display || 'standalone',\n      orientation: config.orientation || 'portrait',\n      background_color: config.backgroundColor || '#000000',\n      theme_color: config.themeColor || '#ffffff',\n      lang: config.lang || 'en',\n      dir: config.dir || 'ltr',\n      icons: manifestIcons,\n      // Removed forced gcm_sender_id to avoid potential conflicts with VAPID\n      // gcm_sender_id: '103953800507',\n    };\n\n    // Add screenshots if provided (for Richer PWA Install UI)\n    if (config.screenshots && config.screenshots.length > 0) {\n      (manifest as any).screenshots = config.screenshots;\n    }\n\n    // Add protocol handlers if provided\n    if (config.protocol_handlers && config.protocol_handlers.length > 0) {\n      (manifest as any).protocol_handlers = config.protocol_handlers;\n    }\n\n    return manifest;\n  };\n}\n\n/**\n * Generate manifest.json content (legacy)\n *\n * @deprecated Use createManifest() instead\n */\nexport function generateManifest(config: ManifestConfig): Record<string, any> {\n  return createManifest(config)();\n}\n"],"mappings":"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","names":[]}

package/dist/pwa/worker/index.d.mts

@@ -1,41 +1,34 @@
 /**
- * Service Worker Utilities
+ * Service Worker Utilities — vanilla, dependency-free.
  *
- * Ready-to-use Serwist configuration for Next.js PWA
+ * Was a Serwist wrapper; serwist is a webpack-only plugin incompatible with
+ * Next.js 16's Turbopack, so this is now a hand-written service worker built on
+ * the standard Service Worker + Cache APIs. Same `createServiceWorker(options)`
+ * entry point, no library, Turbopack-safe.
  */
 interface ServiceWorkerOptions {
-    /**
-     * Offline fallback URL
-     * @default '/_offline'
-     */
+    /** Offline fallback URL. @default '/_offline' */
     offlineFallback?: string;
-    /**
-     * Skip waiting - activate new SW immediately
-     * @default true
-     */
+    /** Activate a new SW immediately instead of waiting. @default true */
     skipWaiting?: boolean;
-    /**
-     * Take control of all clients immediately
-     * @default true
-     */
+    /** Take control of open clients immediately. @default true */
     clientsClaim?: boolean;
-    /**
-     * Enable navigation preload for faster loads
-     * @default true
-     */
-    navigationPreload?: boolean;
+    /** Name of the runtime cache bucket. @default 'app-cache-v1' */
+    cacheName?: string;
 }
 /**
- * Create and initialize Serwist service worker
+ * Register a minimal offline-capable service worker.
+ *
+ * Network-first for navigations with an offline fallback page; stale caches are
+ * cleared on activate. No precache manifest (that was a serwist build-time
+ * injection) — add your own `cache.addAll([...])` in the install step if you
+ * need assets precached.
  *
  * @example
  * ```ts
  * // app/sw.ts
  * import { createServiceWorker } from '@djangocfg/nextjs/worker';
- *
- * createServiceWorker({
- *   offlineFallback: '/_offline',
- * });
+ * createServiceWorker({ offlineFallback: '/_offline' });
  * ```
  */
 declare function createServiceWorker(options?: ServiceWorkerOptions): void;

package/dist/pwa/worker/index.mjs

@@ -1,39 +1,36 @@
 // src/pwa/worker/index.ts
-import { Serwist } from "serwist";
-import { defaultCache } from "@serwist/next/worker";
 function createServiceWorker(options = {}) {
   const {
     offlineFallback = "/_offline",
     skipWaiting = true,
     clientsClaim = true,
-    navigationPreload = true
+    cacheName = "app-cache-v1"
   } = options;
-  const self = globalThis;
-  console.log("SW: Worker Initialized \u{1F680}");
-  const serwist = new Serwist({
-    // Precache entries injected by Serwist build plugin
-    precacheEntries: self.__SW_MANIFEST,
-    // Skip waiting - activate new SW immediately
-    skipWaiting,
-    // Take control of all clients immediately
-    clientsClaim,
-    // Enable navigation preload for faster loads
-    navigationPreload,
-    // Use default Next.js runtime caching strategies
-    runtimeCaching: defaultCache,
-    // Fallback pages for offline
-    fallbacks: {
-      entries: [
-        {
-          url: offlineFallback,
-          matcher({ request }) {
-            return request.destination === "document";
-          }
-        }
-      ]
-    }
+  const sw = self;
+  sw.addEventListener("install", (event) => {
+    event.waitUntil(
+      caches.open(cacheName).then((cache) => cache.addAll([offlineFallback]))
+    );
+    if (skipWaiting) sw.skipWaiting();
+  });
+  sw.addEventListener("activate", (event) => {
+    event.waitUntil(
+      caches.keys().then(
+        (keys) => Promise.all(keys.filter((k) => k !== cacheName).map((k) => caches.delete(k)))
+      ).then(() => {
+        if (clientsClaim) return sw.clients.claim();
+      })
+    );
+  });
+  sw.addEventListener("fetch", (event) => {
+    const { request } = event;
+    if (request.mode !== "navigate") return;
+    event.respondWith(
+      fetch(request).catch(
+        () => caches.match(offlineFallback).then((r) => r ?? Response.error())
+      )
+    );
   });
-  serwist.addEventListeners();
 }
 export {
   createServiceWorker

package/dist/pwa/worker/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/pwa/worker/index.ts"],"sourcesContent":["/**\n * Service Worker Utilities\n *\n * Ready-to-use Serwist configuration for Next.js PWA\n */\n\n/// <reference lib=\"webworker\" />\n\nimport { Serwist } from 'serwist';\n\nimport { defaultCache } from '@serwist/next/worker';\n\nexport interface ServiceWorkerOptions {\n  /**\n   * Offline fallback URL\n   * @default '/_offline'\n   */\n  offlineFallback?: string;\n\n  /**\n   * Skip waiting - activate new SW immediately\n   * @default true\n   */\n  skipWaiting?: boolean;\n\n  /**\n   * Take control of all clients immediately\n   * @default true\n   */\n  clientsClaim?: boolean;\n\n  /**\n   * Enable navigation preload for faster loads\n   * @default true\n   */\n  navigationPreload?: boolean;\n}\n\n/**\n * Create and initialize Serwist service worker\n *\n * @example\n * ```ts\n * // app/sw.ts\n * import { createServiceWorker } from '@djangocfg/nextjs/worker';\n *\n * createServiceWorker({\n *   offlineFallback: '/_offline',\n * });\n * ```\n */\nexport function createServiceWorker(options: ServiceWorkerOptions = {}) {\n  const {\n    offlineFallback = '/_offline',\n    skipWaiting = true,\n    clientsClaim = true,\n    navigationPreload = true,\n  } = options;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const self = globalThis as any;\n  console.log('SW: Worker Initialized 🚀');\n\n  const serwist = new Serwist({\n    // Precache entries injected by Serwist build plugin\n    precacheEntries: self.__SW_MANIFEST,\n\n    // Skip waiting - activate new SW immediately\n    skipWaiting,\n\n    // Take control of all clients immediately\n    clientsClaim,\n\n    // Enable navigation preload for faster loads\n    navigationPreload,\n\n    // Use default Next.js runtime caching strategies\n    runtimeCaching: defaultCache,\n\n    // Fallback pages for offline\n    fallbacks: {\n      entries: [\n        {\n          url: offlineFallback,\n          matcher({ request }) {\n            return request.destination === 'document';\n          },\n        },\n      ],\n    },\n  });\n\n  serwist.addEventListeners();\n}\n"],"mappings":";AAQA,SAAS,eAAe;AAExB,SAAS,oBAAoB;AAyCtB,SAAS,oBAAoB,UAAgC,CAAC,GAAG;AACtE,QAAM;AAAA,IACJ,kBAAkB;AAAA,IAClB,cAAc;AAAA,IACd,eAAe;AAAA,IACf,oBAAoB;AAAA,EACtB,IAAI;AAGJ,QAAM,OAAO;AACb,UAAQ,IAAI,kCAA2B;AAEvC,QAAM,UAAU,IAAI,QAAQ;AAAA;AAAA,IAE1B,iBAAiB,KAAK;AAAA;AAAA,IAGtB;AAAA;AAAA,IAGA;AAAA;AAAA,IAGA;AAAA;AAAA,IAGA,gBAAgB;AAAA;AAAA,IAGhB,WAAW;AAAA,MACT,SAAS;AAAA,QACP;AAAA,UACE,KAAK;AAAA,UACL,QAAQ,EAAE,QAAQ,GAAG;AACnB,mBAAO,QAAQ,gBAAgB;AAAA,UACjC;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AAED,UAAQ,kBAAkB;AAC5B;","names":[]}
+{"version":3,"sources":["../../../src/pwa/worker/index.ts"],"sourcesContent":["/**\n * Service Worker Utilities — vanilla, dependency-free.\n *\n * Was a Serwist wrapper; serwist is a webpack-only plugin incompatible with\n * Next.js 16's Turbopack, so this is now a hand-written service worker built on\n * the standard Service Worker + Cache APIs. Same `createServiceWorker(options)`\n * entry point, no library, Turbopack-safe.\n */\n\n/// <reference lib=\"webworker\" />\n\nexport interface ServiceWorkerOptions {\n  /** Offline fallback URL. @default '/_offline' */\n  offlineFallback?: string;\n  /** Activate a new SW immediately instead of waiting. @default true */\n  skipWaiting?: boolean;\n  /** Take control of open clients immediately. @default true */\n  clientsClaim?: boolean;\n  /** Name of the runtime cache bucket. @default 'app-cache-v1' */\n  cacheName?: string;\n}\n\n/**\n * Register a minimal offline-capable service worker.\n *\n * Network-first for navigations with an offline fallback page; stale caches are\n * cleared on activate. No precache manifest (that was a serwist build-time\n * injection) — add your own `cache.addAll([...])` in the install step if you\n * need assets precached.\n *\n * @example\n * ```ts\n * // app/sw.ts\n * import { createServiceWorker } from '@djangocfg/nextjs/worker';\n * createServiceWorker({ offlineFallback: '/_offline' });\n * ```\n */\nexport function createServiceWorker(options: ServiceWorkerOptions = {}): void {\n  const {\n    offlineFallback = '/_offline',\n    skipWaiting = true,\n    clientsClaim = true,\n    cacheName = 'app-cache-v1',\n  } = options;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const sw = self as any;\n\n  sw.addEventListener('install', (event: any) => {\n    event.waitUntil(\n      caches.open(cacheName).then((cache: Cache) => cache.addAll([offlineFallback]))\n    );\n    if (skipWaiting) sw.skipWaiting();\n  });\n\n  sw.addEventListener('activate', (event: any) => {\n    event.waitUntil(\n      caches\n        .keys()\n        .then((keys: string[]) =>\n          Promise.all(keys.filter((k) => k !== cacheName).map((k) => caches.delete(k)))\n        )\n        .then(() => {\n          if (clientsClaim) return sw.clients.claim();\n        })\n    );\n  });\n\n  sw.addEventListener('fetch', (event: any) => {\n    const { request } = event;\n    if (request.mode !== 'navigate') return;\n    event.respondWith(\n      fetch(request).catch(() =>\n        caches\n          .match(offlineFallback)\n          .then((r: Response | undefined) => r ?? Response.error())\n      )\n    );\n  });\n}\n"],"mappings":";AAqCO,SAAS,oBAAoB,UAAgC,CAAC,GAAS;AAC5E,QAAM;AAAA,IACJ,kBAAkB;AAAA,IAClB,cAAc;AAAA,IACd,eAAe;AAAA,IACf,YAAY;AAAA,EACd,IAAI;AAGJ,QAAM,KAAK;AAEX,KAAG,iBAAiB,WAAW,CAAC,UAAe;AAC7C,UAAM;AAAA,MACJ,OAAO,KAAK,SAAS,EAAE,KAAK,CAAC,UAAiB,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;AAAA,IAC/E;AACA,QAAI,YAAa,IAAG,YAAY;AAAA,EAClC,CAAC;AAED,KAAG,iBAAiB,YAAY,CAAC,UAAe;AAC9C,UAAM;AAAA,MACJ,OACG,KAAK,EACL;AAAA,QAAK,CAAC,SACL,QAAQ,IAAI,KAAK,OAAO,CAAC,MAAM,MAAM,SAAS,EAAE,IAAI,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC,CAAC;AAAA,MAC9E,EACC,KAAK,MAAM;AACV,YAAI,aAAc,QAAO,GAAG,QAAQ,MAAM;AAAA,MAC5C,CAAC;AAAA,IACL;AAAA,EACF,CAAC;AAED,KAAG,iBAAiB,SAAS,CAAC,UAAe;AAC3C,UAAM,EAAE,QAAQ,IAAI;AACpB,QAAI,QAAQ,SAAS,WAAY;AACjC,UAAM;AAAA,MACJ,MAAM,OAAO,EAAE;AAAA,QAAM,MACnB,OACG,MAAM,eAAe,EACrB,KAAK,CAAC,MAA4B,KAAK,SAAS,MAAM,CAAC;AAAA,MAC5D;AAAA,IACF;AAAA,EACF,CAAC;AACH;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/nextjs",
-  "version": "2.1.515",
+  "version": "2.1.518",
   "description": "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
   "keywords": [
     "nextjs",
@@ -64,6 +64,11 @@
       "import": "./dist/pwa/index.mjs",
       "default": "./dist/pwa/index.mjs"
     },
+    "./pwa/manifest": {
+      "types": "./dist/pwa/manifest.d.mts",
+      "import": "./dist/pwa/manifest.mjs",
+      "default": "./dist/pwa/manifest.mjs"
+    },
     "./pwa/worker": {
       "types": "./dist/pwa/worker/index.d.mts",
       "import": "./dist/pwa/worker/index.mjs",
@@ -144,9 +149,9 @@
     "ai-docs": "tsx src/ai/cli.ts"
   },
   "peerDependencies": {
-    "@djangocfg/devtools": "^2.1.515",
-    "@djangocfg/i18n": "^2.1.515",
-    "@djangocfg/ui-core": "^2.1.515",
+    "@djangocfg/devtools": "^2.1.518",
+    "@djangocfg/i18n": "^2.1.518",
+    "@djangocfg/ui-core": "^2.1.518",
     "next": "^16.2.2"
   },
   "peerDependenciesMeta": {
@@ -158,21 +163,18 @@
     }
   },
   "dependencies": {
-    "@serwist/next": "^9.5.11",
-    "@serwist/sw": "^9.5.11",
     "chalk": "^5.6.2",
     "conf": "^15.1.0",
     "consola": "^3.4.2",
     "next-intl": "^4.13.2",
-    "semver": "^7.8.5",
-    "serwist": "^9.5.11"
+    "semver": "^7.8.5"
   },
   "devDependencies": {
-    "@djangocfg/devtools": "^2.1.515",
-    "@djangocfg/i18n": "^2.1.515",
-    "@djangocfg/layouts": "^2.1.515",
-    "@djangocfg/typescript-config": "^2.1.515",
-    "@djangocfg/ui-core": "^2.1.515",
+    "@djangocfg/devtools": "^2.1.518",
+    "@djangocfg/i18n": "^2.1.518",
+    "@djangocfg/layouts": "^2.1.518",
+    "@djangocfg/typescript-config": "^2.1.518",
+    "@djangocfg/ui-core": "^2.1.518",
     "@types/node": "^25.9.5",
     "@types/react": "19.2.15",
     "@types/react-dom": "19.2.3",

package/src/config/plugins/index.ts

@@ -4,4 +4,4 @@
 
 export { DevStartupPlugin, resetDevStartupState, type DevStartupPluginOptions } from './devStartup';
 export { addCompressionPlugins, isCompressionAvailable, type CompressionPluginOptions } from './compression';
-export { withPWA, defaultRuntimeCaching, type PWAPluginOptions } from '../../pwa/plugin';
+export { withPWA, type PWAPluginOptions } from '../../pwa/plugin';