@djangocfg/nextjs 2.1.36 → 2.1.37

package/dist/pwa/server/routes.d.mts

@@ -0,0 +1,2 @@
+import 'next/server';
+export { G as GET, P as POST, a as handleGetSubscriptions, b as handleSend, h as handleSubscribe } from '../../routes-DXA29sS_.mjs';

package/dist/pwa/server/routes.mjs

@@ -0,0 +1,149 @@
+// src/pwa/server/routes.ts
+import { NextResponse } from "next/server";
+
+// src/pwa/server/push.ts
+import webpush from "web-push";
+import { consola } from "consola";
+var vapidConfigured = false;
+function getVapidKeys() {
+  const publicKey = process.env.NEXT_PUBLIC_VAPID_PUBLIC_KEY;
+  const privateKey = process.env.VAPID_PRIVATE_KEY;
+  const mailto = process.env.VAPID_MAILTO || "mailto:noreply@example.com";
+  return { publicKey, privateKey, mailto };
+}
+function configureVapid(options) {
+  const { publicKey, privateKey, mailto } = options || getVapidKeys();
+  if (!publicKey || !privateKey) {
+    consola.warn(
+      "\u26A0\uFE0F  VAPID keys not configured!\n   Generate keys: npx web-push generate-vapid-keys\n   Add to .env.local:\n     NEXT_PUBLIC_VAPID_PUBLIC_KEY=your_public_key\n     VAPID_PRIVATE_KEY=your_private_key\n   Push notifications will not work without VAPID keys."
+    );
+    return false;
+  }
+  try {
+    webpush.setVapidDetails(mailto, publicKey, privateKey);
+    vapidConfigured = true;
+    consola.success("\u2705 VAPID keys configured for push notifications");
+    return true;
+  } catch (error) {
+    consola.error("Failed to configure VAPID keys:", error.message);
+    return false;
+  }
+}
+async function sendPushNotification(subscription, notification) {
+  if (!vapidConfigured) {
+    const configured = configureVapid();
+    if (!configured) {
+      throw new Error("VAPID keys not configured. Cannot send push notification.");
+    }
+  }
+  const payload = JSON.stringify({
+    title: notification.title,
+    body: notification.body || "",
+    icon: notification.icon,
+    badge: notification.badge,
+    data: notification.data,
+    tag: notification.tag,
+    requireInteraction: notification.requireInteraction
+  });
+  const result = await webpush.sendNotification(subscription, payload);
+  console.log("\u2705 Push Sent to FCM:", {
+    statusCode: result.statusCode,
+    headers: result.headers,
+    bodyLength: result.body?.length
+  });
+}
+function validateSubscription(subscription) {
+  return subscription && typeof subscription === "object" && typeof subscription.endpoint === "string" && subscription.keys && typeof subscription.keys.p256dh === "string" && typeof subscription.keys.auth === "string";
+}
+
+// src/pwa/server/routes.ts
+var subscriptions = /* @__PURE__ */ new Set();
+async function handleSubscribe(request) {
+  try {
+    const subscription = await request.json();
+    if (!validateSubscription(subscription)) {
+      return NextResponse.json(
+        { error: "Invalid subscription format" },
+        { status: 400 }
+      );
+    }
+    subscriptions.add(JSON.stringify(subscription));
+    console.log("\u2705 Push subscription saved:", {
+      endpoint: subscription.endpoint.substring(0, 50) + "...",
+      total: subscriptions.size
+    });
+    return NextResponse.json({
+      success: true,
+      message: "Subscription saved",
+      totalSubscriptions: subscriptions.size
+    });
+  } catch (error) {
+    console.error("Subscription error:", error);
+    return NextResponse.json(
+      {
+        error: "Failed to save subscription",
+        details: error.message
+      },
+      { status: 500 }
+    );
+  }
+}
+async function handleGetSubscriptions() {
+  return NextResponse.json({
+    totalSubscriptions: subscriptions.size,
+    subscriptions: Array.from(subscriptions).map((sub) => {
+      const parsed = JSON.parse(sub);
+      return {
+        endpoint: parsed.endpoint.substring(0, 50) + "..."
+      };
+    })
+  });
+}
+async function handleSend(request) {
+  try {
+    const { subscription, notification } = await request.json();
+    if (!subscription) {
+      return NextResponse.json(
+        { error: "Subscription is required" },
+        { status: 400 }
+      );
+    }
+    if (!validateSubscription(subscription)) {
+      return NextResponse.json(
+        { error: "Invalid subscription format" },
+        { status: 400 }
+      );
+    }
+    configureVapid();
+    await sendPushNotification(subscription, {
+      title: notification?.title || "Test Notification",
+      body: notification?.body || "This is a test push notification",
+      icon: notification?.icon,
+      badge: notification?.badge,
+      data: notification?.data
+    });
+    return NextResponse.json({
+      success: true,
+      message: "Push notification sent"
+    });
+  } catch (error) {
+    console.error("Push notification error:", error);
+    return NextResponse.json(
+      {
+        error: "Failed to send push notification",
+        details: error.message
+      },
+      { status: 500 }
+    );
+  }
+}
+var POST = handleSubscribe;
+var GET = handleGetSubscriptions;
+export {
+  GET,
+  POST,
+  handleGetSubscriptions,
+  handleSend,
+  handleSubscribe
+};
+//# sourceMappingURL=routes.mjs.map

package/dist/pwa/server/routes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/pwa/server/routes.ts","../../../src/pwa/server/push.ts"],"sourcesContent":["/**\n * Ready-to-use Push Notification Route Handlers\n *\n * Import these in your app/api/push/ routes\n */\n\nimport { NextRequest, NextResponse } from 'next/server';\nimport { configureVapid, sendPushNotification, validateSubscription } from './push';\n\n// In-memory storage для demo (в production используй БД)\nconst subscriptions = new Set<string>();\n\n/**\n * POST /api/push/subscribe\n * Save push subscription\n *\n * @example\n * ```typescript\n * // app/api/push/subscribe/route.ts\n * export { POST } from '@djangocfg/nextjs/pwa/server/routes';\n * ```\n */\nexport async function handleSubscribe(request: NextRequest) {\n  try {\n    const subscription = await request.json();\n\n    if (!validateSubscription(subscription)) {\n      return NextResponse.json(\n        { error: 'Invalid subscription format' },\n        { status: 400 }\n      );\n    }\n\n    // Сохраняем subscription (в demo просто в памяти)\n    subscriptions.add(JSON.stringify(subscription));\n\n    console.log('✅ Push subscription saved:', {\n      endpoint: subscription.endpoint.substring(0, 50) + '...',\n      total: subscriptions.size,\n    });\n\n    return NextResponse.json({\n      success: true,\n      message: 'Subscription saved',\n      totalSubscriptions: subscriptions.size,\n    });\n  } catch (error: any) {\n    console.error('Subscription error:', error);\n\n    return NextResponse.json(\n      {\n        error: 'Failed to save subscription',\n        details: error.message,\n      },\n      { status: 500 }\n    );\n  }\n}\n\n/**\n * GET /api/push/subscribe\n * Get all subscriptions (for testing)\n */\nexport async function handleGetSubscriptions() {\n  return NextResponse.json({\n    totalSubscriptions: subscriptions.size,\n    subscriptions: Array.from(subscriptions).map((sub) => {\n      const parsed = JSON.parse(sub);\n      return {\n        endpoint: parsed.endpoint.substring(0, 50) + '...',\n      };\n    }),\n  });\n}\n\n/**\n * POST /api/push/send\n * Send push notification\n *\n * @example\n * ```typescript\n * // app/api/push/send/route.ts\n * export { POST as handleSend as POST } from '@djangocfg/nextjs/pwa/server/routes';\n * ```\n */\nexport async function handleSend(request: NextRequest) {\n  try {\n    const { subscription, notification } = await request.json();\n\n    if (!subscription) {\n      return NextResponse.json(\n        { error: 'Subscription is required' },\n        { status: 400 }\n      );\n    }\n\n    if (!validateSubscription(subscription)) {\n      return NextResponse.json(\n        { error: 'Invalid subscription format' },\n        { status: 400 }\n      );\n    }\n\n    // Configure VAPID if not already configured\n    configureVapid();\n\n    await sendPushNotification(subscription, {\n      title: notification?.title || 'Test Notification',\n      body: notification?.body || 'This is a test push notification',\n      icon: notification?.icon,\n      badge: notification?.badge,\n      data: notification?.data,\n    });\n\n    return NextResponse.json({\n      success: true,\n      message: 'Push notification sent',\n    });\n  } catch (error: any) {\n    console.error('Push notification error:', error);\n\n    return NextResponse.json(\n      {\n        error: 'Failed to send push notification',\n        details: error.message,\n      },\n      { status: 500 }\n    );\n  }\n}\n\n/**\n * Combined route handlers\n * Use like: export { POST, GET } from '@djangocfg/nextjs/pwa/server/routes'\n */\nexport const POST = handleSubscribe;\nexport const GET = handleGetSubscriptions;\n","/**\n * Server-side Push Notification Utilities\n *\n * VAPID-based Web Push notifications using web-push library\n */\n\nimport webpush, { PushSubscription } from 'web-push';\nimport { consola } from 'consola';\n\nlet vapidConfigured = false;\n\n/**\n * Check if VAPID keys are configured\n */\nexport function isVapidConfigured(): boolean {\n  return vapidConfigured;\n}\n\n/**\n * Get VAPID keys from environment\n */\nexport function getVapidKeys() {\n  const publicKey = process.env.NEXT_PUBLIC_VAPID_PUBLIC_KEY;\n  const privateKey = process.env.VAPID_PRIVATE_KEY;\n  const mailto = process.env.VAPID_MAILTO || 'mailto:noreply@example.com';\n\n  return { publicKey, privateKey, mailto };\n}\n\n/**\n * Configure VAPID keys for web-push\n * Call this once at app startup\n *\n * @example\n * ```typescript\n * // In your API route or middleware\n * import { configureVapid } from '@djangocfg/nextjs/pwa/server';\n *\n * configureVapid(); // Uses env vars automatically\n * ```\n */\nexport function configureVapid(options?: {\n  publicKey?: string;\n  privateKey?: string;\n  mailto?: string;\n}): boolean {\n  const { publicKey, privateKey, mailto } = options || getVapidKeys();\n\n  if (!publicKey || !privateKey) {\n    consola.warn(\n      '⚠️  VAPID keys not configured!\\n' +\n      '   Generate keys: npx web-push generate-vapid-keys\\n' +\n      '   Add to .env.local:\\n' +\n      '     NEXT_PUBLIC_VAPID_PUBLIC_KEY=your_public_key\\n' +\n      '     VAPID_PRIVATE_KEY=your_private_key\\n' +\n      '   Push notifications will not work without VAPID keys.'\n    );\n    return false;\n  }\n\n  try {\n    webpush.setVapidDetails(mailto, publicKey, privateKey);\n    vapidConfigured = true;\n    consola.success('✅ VAPID keys configured for push notifications');\n    return true;\n  } catch (error: any) {\n    consola.error('Failed to configure VAPID keys:', error.message);\n    return false;\n  }\n}\n\n/**\n * Send push notification to a subscription\n *\n * @example\n * ```typescript\n * await sendPushNotification(subscription, {\n *   title: 'Hello!',\n *   body: 'Test notification',\n *   data: { url: '/page' },\n * });\n * ```\n */\nexport async function sendPushNotification(\n  subscription: PushSubscription,\n  notification: {\n    title: string;\n    body?: string;\n    icon?: string;\n    badge?: string;\n    data?: any;\n    tag?: string;\n    requireInteraction?: boolean;\n  }\n): Promise<void> {\n  if (!vapidConfigured) {\n    const configured = configureVapid();\n    if (!configured) {\n      throw new Error('VAPID keys not configured. Cannot send push notification.');\n    }\n  }\n\n  const payload = JSON.stringify({\n    title: notification.title,\n    body: notification.body || '',\n    icon: notification.icon,\n    badge: notification.badge,\n    data: notification.data,\n    tag: notification.tag,\n    requireInteraction: notification.requireInteraction,\n  });\n\n  const result = await webpush.sendNotification(subscription, payload);\n  console.log('✅ Push Sent to FCM:', {\n    statusCode: result.statusCode,\n    headers: result.headers,\n    bodyLength: result.body?.length\n  });\n}\n\n/**\n * Send push notification to multiple subscriptions\n *\n * @example\n * ```typescript\n * const results = await sendPushToMultiple(subscriptions, {\n *   title: 'Broadcast message',\n *   body: 'Sent to all users',\n * });\n * console.log(`Sent: ${results.successful}, Failed: ${results.failed}`);\n * ```\n */\nexport async function sendPushToMultiple(\n  subscriptions: PushSubscription[],\n  notification: Parameters<typeof sendPushNotification>[1]\n): Promise<{\n  successful: number;\n  failed: number;\n  errors: Array<{ subscription: PushSubscription; error: Error }>;\n}> {\n  const results = await Promise.allSettled(\n    subscriptions.map((sub) => sendPushNotification(sub, notification))\n  );\n\n  const successful = results.filter((r) => r.status === 'fulfilled').length;\n  const failed = results.filter((r) => r.status === 'rejected').length;\n  const errors = results\n    .map((r, i) => (r.status === 'rejected' ? { subscription: subscriptions[i], error: r.reason } : null))\n    .filter((e): e is NonNullable<typeof e> => e !== null);\n\n  return { successful, failed, errors };\n}\n\n/**\n * Validate push subscription format\n */\nexport function validateSubscription(subscription: any): subscription is PushSubscription {\n  return (\n    subscription &&\n    typeof subscription === 'object' &&\n    typeof subscription.endpoint === 'string' &&\n    subscription.keys &&\n    typeof subscription.keys.p256dh === 'string' &&\n    typeof subscription.keys.auth === 'string'\n  );\n}\n"],"mappings":"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","names":[]}

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

@@ -0,0 +1,56 @@
+/**
+ * Service Worker Utilities
+ *
+ * Ready-to-use Serwist configuration for Next.js PWA
+ */
+interface ServiceWorkerOptions {
+    /**
+     * Offline fallback URL
+     * @default '/_offline'
+     */
+    offlineFallback?: string;
+    /**
+     * Skip waiting - activate new SW immediately
+     * @default true
+     */
+    skipWaiting?: boolean;
+    /**
+     * Take control of all clients immediately
+     * @default true
+     */
+    clientsClaim?: boolean;
+    /**
+     * Enable navigation preload for faster loads
+     * @default true
+     */
+    navigationPreload?: boolean;
+    /**
+     * Enable push notifications
+     * @default false
+     */
+    enablePushNotifications?: boolean;
+    /**
+     * Default notification icon
+     */
+    notificationIcon?: string;
+    /**
+     * Default notification badge
+     */
+    notificationBadge?: string;
+}
+/**
+ * Create and initialize Serwist service worker
+ *
+ * @example
+ * ```ts
+ * // app/sw.ts
+ * import { createServiceWorker } from '@djangocfg/nextjs/worker';
+ *
+ * createServiceWorker({
+ *   offlineFallback: '/_offline',
+ * });
+ * ```
+ */
+declare function createServiceWorker(options?: ServiceWorkerOptions): void;
+
+export { type ServiceWorkerOptions, createServiceWorker };

package/dist/pwa/worker/index.mjs

@@ -0,0 +1,97 @@
+// src/pwa/worker/index.ts
+import { defaultCache } from "@serwist/next/worker";
+import { Serwist } from "serwist";
+function createServiceWorker(options = {}) {
+  const {
+    offlineFallback = "/_offline",
+    skipWaiting = true,
+    clientsClaim = true,
+    navigationPreload = true,
+    enablePushNotifications = false,
+    notificationIcon,
+    notificationBadge
+  } = 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";
+          }
+        }
+      ]
+    }
+  });
+  serwist.addEventListeners();
+  if (enablePushNotifications) {
+    self.addEventListener("push", (event) => {
+      let data;
+      try {
+        data = event.data?.json() || {};
+        console.log("SW: Push Received (JSON)", data);
+      } catch (err) {
+        console.log("SW: Push Received (Raw)", event.data?.text());
+        data = {};
+      }
+      const {
+        title = "Notification",
+        body = "",
+        icon = notificationIcon,
+        badge = notificationBadge,
+        data: notificationData = {},
+        tag,
+        requireInteraction = false,
+        vibrate = [200, 100, 200],
+        // Default vibration pattern
+        silent = false
+        // Default to playing sound
+      } = data;
+      event.waitUntil(
+        self.registration.showNotification(title, {
+          body,
+          icon,
+          badge,
+          data: notificationData,
+          tag,
+          requireInteraction,
+          vibrate,
+          silent
+        })
+      );
+    });
+    self.addEventListener("notificationclick", (event) => {
+      event.notification.close();
+      const urlToOpen = event.notification.data?.url || "/";
+      event.waitUntil(
+        self.clients.matchAll({ type: "window", includeUncontrolled: true }).then((clientList) => {
+          for (const client of clientList) {
+            if (client.url === urlToOpen && "focus" in client) {
+              return client.focus();
+            }
+          }
+          if (self.clients.openWindow) {
+            return self.clients.openWindow(urlToOpen);
+          }
+        })
+      );
+    });
+  }
+}
+export {
+  createServiceWorker
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +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 { defaultCache } from '@serwist/next/worker';\nimport { Serwist } from 'serwist';\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   * Enable push notifications\n   * @default false\n   */\n  enablePushNotifications?: boolean;\n\n  /**\n   * Default notification icon\n   */\n  notificationIcon?: string;\n\n  /**\n   * Default notification badge\n   */\n  notificationBadge?: string;\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    enablePushNotifications = false,\n    notificationIcon,\n    notificationBadge,\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  // Push notification support\n  if (enablePushNotifications) {\n    // Handle push events\n    self.addEventListener('push', (event: PushEvent) => {\n      let data;\n      try {\n        data = event.data?.json() || {};\n        console.log('SW: Push Received (JSON)', data);\n      } catch (err) {\n        console.log('SW: Push Received (Raw)', event.data?.text());\n        data = {};\n      }\n\n      const {\n        title = 'Notification',\n        body = '',\n        icon = notificationIcon,\n        badge = notificationBadge,\n        data: notificationData = {},\n        tag,\n        requireInteraction = false,\n        vibrate = [200, 100, 200], // Default vibration pattern\n        silent = false,            // Default to playing sound\n      } = data;\n\n      event.waitUntil(\n        self.registration.showNotification(title, {\n          body,\n          icon,\n          badge,\n          data: notificationData,\n          tag,\n          requireInteraction,\n          vibrate,\n          silent,\n        })\n      );\n    });\n\n    // Handle notification clicks\n    self.addEventListener('notificationclick', (event: NotificationEvent) => {\n      event.notification.close();\n\n      const urlToOpen = event.notification.data?.url || '/';\n\n      event.waitUntil(\n        self.clients.matchAll({ type: 'window', includeUncontrolled: true }).then((clientList: readonly WindowClient[]) => {\n          // Check if there's already a window open with the URL\n          for (const client of clientList) {\n            if (client.url === urlToOpen && 'focus' in client) {\n              return client.focus();\n            }\n          }\n          // If not, open a new window\n          if (self.clients.openWindow) {\n            return self.clients.openWindow(urlToOpen);\n          }\n        })\n      );\n    });\n  }\n}\n"],"mappings":";AAQA,SAAS,oBAAoB;AAC7B,SAAS,eAAe;AAyDjB,SAAS,oBAAoB,UAAgC,CAAC,GAAG;AACtE,QAAM;AAAA,IACJ,kBAAkB;AAAA,IAClB,cAAc;AAAA,IACd,eAAe;AAAA,IACf,oBAAoB;AAAA,IACpB,0BAA0B;AAAA,IAC1B;AAAA,IACA;AAAA,EACF,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;AAG1B,MAAI,yBAAyB;AAE3B,SAAK,iBAAiB,QAAQ,CAAC,UAAqB;AAClD,UAAI;AACJ,UAAI;AACF,eAAO,MAAM,MAAM,KAAK,KAAK,CAAC;AAC9B,gBAAQ,IAAI,4BAA4B,IAAI;AAAA,MAC9C,SAAS,KAAK;AACZ,gBAAQ,IAAI,2BAA2B,MAAM,MAAM,KAAK,CAAC;AACzD,eAAO,CAAC;AAAA,MACV;AAEA,YAAM;AAAA,QACJ,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,OAAO;AAAA,QACP,QAAQ;AAAA,QACR,MAAM,mBAAmB,CAAC;AAAA,QAC1B;AAAA,QACA,qBAAqB;AAAA,QACrB,UAAU,CAAC,KAAK,KAAK,GAAG;AAAA;AAAA,QACxB,SAAS;AAAA;AAAA,MACX,IAAI;AAEJ,YAAM;AAAA,QACJ,KAAK,aAAa,iBAAiB,OAAO;AAAA,UACxC;AAAA,UACA;AAAA,UACA;AAAA,UACA,MAAM;AAAA,UACN;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAGD,SAAK,iBAAiB,qBAAqB,CAAC,UAA6B;AACvE,YAAM,aAAa,MAAM;AAEzB,YAAM,YAAY,MAAM,aAAa,MAAM,OAAO;AAElD,YAAM;AAAA,QACJ,KAAK,QAAQ,SAAS,EAAE,MAAM,UAAU,qBAAqB,KAAK,CAAC,EAAE,KAAK,CAAC,eAAwC;AAEjH,qBAAW,UAAU,YAAY;AAC/B,gBAAI,OAAO,QAAQ,aAAa,WAAW,QAAQ;AACjD,qBAAO,OAAO,MAAM;AAAA,YACtB;AAAA,UACF;AAEA,cAAI,KAAK,QAAQ,YAAY;AAC3B,mBAAO,KAAK,QAAQ,WAAW,SAAS;AAAA,UAC1C;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/routes-DXA29sS_.d.mts

@@ -0,0 +1,68 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+/**
+ * Ready-to-use Push Notification Route Handlers
+ *
+ * Import these in your app/api/push/ routes
+ */
+
+/**
+ * POST /api/push/subscribe
+ * Save push subscription
+ *
+ * @example
+ * ```typescript
+ * // app/api/push/subscribe/route.ts
+ * export { POST } from '@djangocfg/nextjs/pwa/server/routes';
+ * ```
+ */
+declare function handleSubscribe(request: NextRequest): Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    message: string;
+    totalSubscriptions: number;
+}>>;
+/**
+ * GET /api/push/subscribe
+ * Get all subscriptions (for testing)
+ */
+declare function handleGetSubscriptions(): Promise<NextResponse<{
+    totalSubscriptions: number;
+    subscriptions: {
+        endpoint: string;
+    }[];
+}>>;
+/**
+ * POST /api/push/send
+ * Send push notification
+ *
+ * @example
+ * ```typescript
+ * // app/api/push/send/route.ts
+ * export { POST as handleSend as POST } from '@djangocfg/nextjs/pwa/server/routes';
+ * ```
+ */
+declare function handleSend(request: NextRequest): Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    success: boolean;
+    message: string;
+}>>;
+/**
+ * Combined route handlers
+ * Use like: export { POST, GET } from '@djangocfg/nextjs/pwa/server/routes'
+ */
+declare const POST: typeof handleSubscribe;
+declare const GET: typeof handleGetSubscriptions;
+
+declare const routes_GET: typeof GET;
+declare const routes_POST: typeof POST;
+declare const routes_handleGetSubscriptions: typeof handleGetSubscriptions;
+declare const routes_handleSend: typeof handleSend;
+declare const routes_handleSubscribe: typeof handleSubscribe;
+declare namespace routes {
+  export { routes_GET as GET, routes_POST as POST, routes_handleGetSubscriptions as handleGetSubscriptions, routes_handleSend as handleSend, routes_handleSubscribe as handleSubscribe };
+}
+
+export { GET as G, POST as P, handleGetSubscriptions as a, handleSend as b, handleSubscribe as h, routes as r };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/nextjs",
-  "version": "2.1.36",
+  "version": "2.1.37",
   "description": "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
   "keywords": [
     "nextjs",
@@ -78,6 +78,31 @@
       "types": "./dist/scripts/index.d.mts",
       "import": "./dist/scripts/index.mjs",
       "default": "./dist/scripts/index.mjs"
+    },
+    "./pwa": {
+      "types": "./dist/pwa/index.d.mts",
+      "import": "./dist/pwa/index.mjs",
+      "default": "./dist/pwa/index.mjs"
+    },
+    "./pwa/worker": {
+      "types": "./dist/pwa/worker/index.d.mts",
+      "import": "./dist/pwa/worker/index.mjs",
+      "default": "./dist/pwa/worker/index.mjs"
+    },
+    "./worker": {
+      "types": "./dist/pwa/worker/index.d.mts",
+      "import": "./dist/pwa/worker/index.mjs",
+      "default": "./dist/pwa/worker/index.mjs"
+    },
+    "./pwa/server": {
+      "types": "./dist/pwa/server/index.d.mts",
+      "import": "./dist/pwa/server/index.mjs",
+      "default": "./dist/pwa/server/index.mjs"
+    },
+    "./pwa/server/routes": {
+      "types": "./dist/pwa/server/routes.d.mts",
+      "import": "./dist/pwa/server/routes.mjs",
+      "default": "./dist/pwa/server/routes.mjs"
     }
   },
   "files": [
@@ -87,7 +112,8 @@
     "LICENSE"
   ],
   "bin": {
-    "djangocfg-docs": "./dist/ai/cli.mjs"
+    "djangocfg-docs": "./dist/ai/cli.mjs",
+    "djangocfg-pwa": "./dist/pwa/cli.mjs"
   },
   "scripts": {
     "build": "tsup",
@@ -96,26 +122,31 @@
     "lint": "eslint .",
     "check": "tsc --noEmit",
     "check-links": "tsx src/scripts/check-links.ts",
-    "ai-docs": "tsx src/ai/cli.ts"
+    "ai-docs": "tsx src/ai/cli.ts",
+    "pwa": "tsx src/pwa/cli.ts"
   },
   "peerDependencies": {
     "next": "^16.0.10"
   },
   "dependencies": {
-    "@ducanh2912/next-pwa": "^10.2.9",
+    "@serwist/next": "^9.2.3",
+    "@serwist/sw": "^9.2.3",
     "chalk": "^5.3.0",
     "conf": "^15.0.2",
     "consola": "^3.4.2",
-    "semver": "^7.7.3"
+    "semver": "^7.7.3",
+    "serwist": "^9.2.3",
+    "web-push": "^3.6.7"
   },
   "devDependencies": {
-    "@djangocfg/imgai": "^2.1.36",
-    "@djangocfg/layouts": "^2.1.36",
-    "@djangocfg/typescript-config": "^2.1.36",
+    "@djangocfg/imgai": "^2.1.37",
+    "@djangocfg/layouts": "^2.1.37",
+    "@djangocfg/typescript-config": "^2.1.37",
     "@types/node": "^24.7.2",
     "@types/react": "19.2.2",
     "@types/react-dom": "19.2.1",
     "@types/semver": "^7.7.1",
+    "@types/web-push": "^3.6.4",
     "@types/webpack": "^5.28.5",
     "@vercel/og": "^0.8.5",
     "eslint": "^9.37.0",

package/src/config/createNextConfig.ts

@@ -29,7 +29,7 @@ import { deepMerge } from './utils/deepMerge';
 import { isStaticBuild, isDev, getBasePath, getApiUrl, getSiteUrl } from './utils/env';
 import { DevStartupPlugin } from './plugins/devStartup';
 import { addCompressionPlugins } from './plugins/compression';
-import { withPWA, type PWAPluginOptions } from './plugins/pwa';
+import { withPWA, type PWAPluginOptions } from '../pwa/plugin';
 
 // ─────────────────────────────────────────────────────────────────────────
 // Configuration Options
@@ -42,12 +42,6 @@ export interface BaseNextConfigOptions {
   transpilePackages?: string[];
   /** Additional optimize package imports (merged with defaults) */
   optimizePackageImports?: string[];
-  /**
-   * Automatically open browser in dev mode (default: false)
-   * NOTE: Only works with webpack mode in Next.js 16+ (Turbopack doesn't support webpack plugins)
-   * For Turbopack compatibility, use a custom dev script instead of this option
-   */
-  openBrowser?: boolean;
   /** Check for @djangocfg/* package updates on startup (default: true) */
   checkUpdates?: boolean;
   /** Auto-update outdated packages without prompting (default: false) */
@@ -69,6 +63,8 @@ export interface BaseNextConfigOptions {
    * @default { enabled: true (in production), disable: true (in development) }
    */
   pwa?: PWAPluginOptions | false;
+  /** Turbopack configuration (Next.js 16+ default bundler) */
+  turbopack?: NextConfig['turbopack'];
   /** Custom webpack configuration function (called after base webpack logic) */
   webpack?: (
     config: WebpackConfig,
@@ -179,6 +175,10 @@ export function createBaseNextConfig(
       ...(options.transpilePackages || []),
     ],
 
+    // Turbopack configuration (Next.js 16+ default bundler)
+    // Always set turbopack config to silence Next.js 16 warning about webpack config
+    turbopack: options.turbopack || {},
+
     // Experimental features
     experimental: {
       // Optimize package imports (only in production)
@@ -197,20 +197,16 @@ export function createBaseNextConfig(
     },
 
     // Webpack configuration
-    // NOTE: Next.js 16 uses Turbopack by default in dev mode, which doesn't support webpack plugins.
-    // DevStartupPlugin only runs in webpack mode (next dev --webpack).
-    // For Turbopack compatibility, consider using a custom dev script for browser auto-open.
     webpack: (config: WebpackConfig, webpackOptions: { isServer: boolean; dev: boolean; [key: string]: any }) => {
       const { isServer, dev } = webpackOptions;
 
-      // Add dev startup plugin (client-side only in dev, webpack mode only)
+      // Add dev startup plugin (client-side only in dev)
       if (dev && !isServer) {
         if (!config.plugins) {
           config.plugins = [];
         }
         config.plugins.push(
           new DevStartupPlugin({
-            openBrowser: options.openBrowser,
             checkUpdates: options.checkUpdates,
             autoUpdate: options.autoUpdate,
             forceCheckWorkspace: options.forceCheckWorkspace,
@@ -256,13 +252,13 @@ export function createBaseNextConfig(
   // Cleanup: Remove custom options that are not part of NextConfig
   delete (finalConfig as any).optimizePackageImports;
   delete (finalConfig as any).isDefaultCfgAdmin;
-  delete (finalConfig as any).openBrowser;
   delete (finalConfig as any).checkUpdates;
   delete (finalConfig as any).autoUpdate;
   delete (finalConfig as any).forceCheckWorkspace;
   delete (finalConfig as any).checkPackages;
   delete (finalConfig as any).autoInstall;
   delete (finalConfig as any).allowIframeFrom;
+  // Note: turbopack is a valid NextConfig option, don't delete it
 
   // Apply PWA wrapper if enabled
   if (options.pwa !== false) {

package/src/config/index.ts

@@ -6,8 +6,8 @@
  * import { createBaseNextConfig } from '@djangocfg/nextjs/config';
  *
  * export default createBaseNextConfig({
- *   openBrowser: true,
  *   checkPackages: true,
+ *   checkUpdates: true,
  * });
  * ```
  */
@@ -97,22 +97,4 @@ export {
   isCompressionAvailable,
   type CompressionPluginOptions,
 } from './plugins/compression';
-export {
-  withPWA,
-  isPWAAvailable,
-  defaultRuntimeCaching,
-  createApiCacheRule,
-  createStaticAssetRule,
-  createCdnCacheRule,
-  type PWAPluginOptions,
-  type CacheStrategy,
-  type RuntimeCacheEntry,
-} from './plugins/pwa';
-export {
-  createManifestMetadata,
-  createViewport,
-  generateManifest,
-  createManifest,
-  type ManifestConfig,
-  type IconPaths,
-} from './utils/manifest';
+