@djangocfg/nextjs 2.1.138 → 2.1.140

package/dist/routes-DXA29sS_.d.mts

@@ -1,68 +0,0 @@
-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/src/pwa/cli.ts

@@ -1,171 +0,0 @@
-#!/usr/bin/env node
-/**
- * DjangoCFG PWA CLI
- *
- * Usage:
- *   pnpm pwa vapid              # Generate VAPID keys
- *   pnpm pwa send               # Send test push notification
- *   pnpm pwa status             # Show PWA status
- *   pnpm pwa info               # Show help
- */
-
-import { consola } from 'consola';
-import webpush from 'web-push';
-
-const args = process.argv.slice(2);
-const command = args[0];
-
-async function generateVapidKeys() {
-  consola.box('VAPID Keys Generator');
-  consola.info('Generating new VAPID key pair...\n');
-
-  const vapidKeys = webpush.generateVAPIDKeys();
-
-  consola.success('✅ VAPID keys generated!\n');
-  consola.log('Add these to your .env.local:\n');
-  consola.log(`NEXT_PUBLIC_VAPID_PUBLIC_KEY=${vapidKeys.publicKey}`);
-  consola.log(`VAPID_PRIVATE_KEY=${vapidKeys.privateKey}`);
-  consola.log(`VAPID_MAILTO=mailto:your-email@example.com\n`);
-
-  consola.info('Public key (share with clients):');
-  consola.log(`  ${vapidKeys.publicKey}\n`);
-  consola.info('Private key (keep secret):');
-  consola.log(`  ${vapidKeys.privateKey}\n`);
-}
-
-async function sendTestPush() {
-  consola.box('Send Test Push Notification');
-
-  const publicKey = process.env.NEXT_PUBLIC_VAPID_PUBLIC_KEY;
-  const privateKey = process.env.VAPID_PRIVATE_KEY;
-  const mailto = process.env.VAPID_MAILTO || 'mailto:test@example.com';
-
-  if (!publicKey || !privateKey) {
-    consola.error('❌ VAPID keys not configured!');
-    consola.info('\nGenerate keys with:');
-    consola.log('  pnpm pwa vapid\n');
-    consola.info('Then add to .env.local:');
-    consola.log('  NEXT_PUBLIC_VAPID_PUBLIC_KEY=...');
-    consola.log('  VAPID_PRIVATE_KEY=...');
-    process.exit(1);
-  }
-
-  // Get subscription from args or use example
-  const subscriptionArg = args[1];
-  if (!subscriptionArg) {
-    consola.error('❌ Subscription required!\n');
-    consola.info('Usage:');
-    consola.log('  pnpm pwa send \'{"endpoint":"...","keys":{...}}\'\n');
-    consola.info('To subscribe and get the JSON, visit the playground:');
-    consola.log('  http://djangocfg.com/layouts/a2hs-hint\n');
-    consola.info('Or use the helper command:');
-    consola.log('  pnpm exec djangocfg-pwa status\n');
-    process.exit(1);
-  }
-
-  try {
-    const subscription = JSON.parse(subscriptionArg);
-
-    webpush.setVapidDetails(mailto, publicKey, privateKey);
-
-    const payload = JSON.stringify({
-      title: 'Test Push from CLI',
-      body: 'This is a test notification sent from @djangocfg/nextjs CLI',
-      icon: '/static/logos/192x192.png',
-      badge: '/static/logos/192x192.png',
-    });
-
-    consola.info('Sending push notification...\n');
-    await webpush.sendNotification(subscription, payload);
-    consola.success('✅ Push notification sent successfully!');
-  } catch (err) {
-    consola.error('❌ Failed to send push:', err instanceof Error ? err.message : err);
-    process.exit(1);
-  }
-}
-
-async function showStatus() {
-  consola.box('PWA Status');
-
-  const publicKey = process.env.NEXT_PUBLIC_VAPID_PUBLIC_KEY;
-  const privateKey = process.env.VAPID_PRIVATE_KEY;
-  const mailto = process.env.VAPID_MAILTO;
-
-  consola.log('Environment Variables:');
-  consola.log(`  NEXT_PUBLIC_VAPID_PUBLIC_KEY: ${publicKey ? '✅ Set' : '❌ Not set'}`);
-  consola.log(`  VAPID_PRIVATE_KEY:            ${privateKey ? '✅ Set' : '❌ Not set'}`);
-  consola.log(`  VAPID_MAILTO:                 ${mailto || '⚠️  Not set (optional)'}\n`);
-
-  if (!publicKey || !privateKey) {
-    consola.warn('⚠️  VAPID keys not configured. Run: pnpm pwa vapid\n');
-  } else {
-    consola.success('✅ VAPID keys configured\n');
-    consola.log('Public Key:');
-    consola.log(`  ${publicKey.slice(0, 40)}...\n`);
-  }
-
-  consola.log('Quick Start:');
-  consola.log('  1. Generate VAPID keys:  pnpm pwa vapid');
-  consola.log('  2. Add to .env.local');
-  consola.log('  3. Visit playground:     http://djangocfg.com/layouts/a2hs-hint');
-  consola.log('  4. Send test push:       pnpm pwa send \'<subscription>\'\n');
-}
-
-async function showInfo() {
-  consola.box('DjangoCFG PWA CLI');
-  consola.log('Commands:');
-  consola.log('  vapid               Generate VAPID keys');
-  consola.log('  send <subscription> Send test push notification');
-  consola.log('  status              Show PWA configuration status');
-  consola.log('  info                Show this help\n');
-
-  consola.log('Examples:');
-  consola.log('  # Generate VAPID keys');
-  consola.log('  pnpm pwa vapid\n');
-
-  consola.log('  # Check status');
-  consola.log('  pnpm pwa status\n');
-
-  consola.log('  # Subscribe');
-  consola.log('  Visit: http://djangocfg.com/layouts/a2hs-hint\n');
-
-  consola.log('  # Send test push');
-  consola.log('  pnpm pwa send \'{"endpoint":"...","keys":{"p256dh":"...","auth":"..."}}\'\n');
-
-  consola.log('Documentation:');
-  consola.log('  https://djangocfg.com/docs/pwa');
-}
-
-async function main() {
-  switch (command) {
-    case 'vapid':
-    case 'v':
-    case 'keys':
-      await generateVapidKeys();
-      break;
-
-    case 'send':
-    case 's':
-    case 'push':
-      await sendTestPush();
-      break;
-
-    case 'status':
-    case 'st':
-      await showStatus();
-      break;
-
-    case 'info':
-    case 'i':
-    case 'help':
-    case 'h':
-      await showInfo();
-      break;
-
-    default:
-      await showInfo();
-      break;
-  }
-}
-
-main();

package/src/pwa/notifications.ts

@@ -1,192 +0,0 @@
-/**
- * PWA Push Notifications Client Utilities
- *
- * Functions for requesting permission, subscribing to push notifications,
- * and sending test notifications
- */
-
-/**
- * Check if push notifications are supported
- */
-export function isPushNotificationSupported(): boolean {
-  return (
-    'serviceWorker' in navigator &&
-    'PushManager' in window &&
-    'Notification' in window
-  );
-}
-
-/**
- * Get current notification permission status
- */
-export function getNotificationPermission(): NotificationPermission {
-  if (!('Notification' in window)) {
-    return 'denied';
-  }
-  return Notification.permission;
-}
-
-/**
- * Request notification permission from user
- */
-export async function requestNotificationPermission(): Promise<NotificationPermission> {
-  if (!('Notification' in window)) {
-    throw new Error('Notifications are not supported');
-  }
-
-  const permission = await Notification.requestPermission();
-  return permission;
-}
-
-/**
- * Convert base64 VAPID key to Uint8Array
- */
-function urlBase64ToUint8Array(base64String: string): Uint8Array {
-  const padding = '='.repeat((4 - (base64String.length % 4)) % 4);
-  const base64 = (base64String + padding).replace(/-/g, '+').replace(/_/g, '/');
-
-  const rawData = window.atob(base64);
-  const outputArray = new Uint8Array(rawData.length);
-
-  for (let i = 0; i < rawData.length; ++i) {
-    outputArray[i] = rawData.charCodeAt(i);
-  }
-  return outputArray;
-}
-
-export interface PushSubscriptionOptions {
-  /**
-   * VAPID public key (base64 encoded)
-   * Generate with: npx web-push generate-vapid-keys
-   */
-  vapidPublicKey: string;
-
-  /**
-   * User visible only (required for Chrome)
-   * @default true
-   */
-  userVisibleOnly?: boolean;
-}
-
-/**
- * Subscribe to push notifications
- *
- * @example
- * ```ts
- * const subscription = await subscribeToPushNotifications({
- *   vapidPublicKey: process.env.NEXT_PUBLIC_VAPID_PUBLIC_KEY!,
- * });
- *
- * // Send subscription to your backend
- * await fetch('/api/push/subscribe', {
- *   method: 'POST',
- *   headers: { 'Content-Type': 'application/json' },
- *   body: JSON.stringify(subscription),
- * });
- * ```
- */
-export async function subscribeToPushNotifications(
-  options: PushSubscriptionOptions
-): Promise<PushSubscription> {
-  if (!isPushNotificationSupported()) {
-    throw new Error('Push notifications are not supported');
-  }
-
-  // Request permission first
-  const permission = await requestNotificationPermission();
-  if (permission !== 'granted') {
-    throw new Error(`Notification permission ${permission}`);
-  }
-
-  // Get service worker registration
-  const registration = await navigator.serviceWorker.ready;
-
-  // Check if already subscribed
-  let subscription = await registration.pushManager.getSubscription();
-
-  if (subscription) {
-    return subscription;
-  }
-
-  // Subscribe to push notifications
-  const convertedVapidKey = urlBase64ToUint8Array(options.vapidPublicKey);
-
-  subscription = await registration.pushManager.subscribe({
-    userVisibleOnly: options.userVisibleOnly ?? true,
-    applicationServerKey: convertedVapidKey as BufferSource,
-  });
-
-  return subscription;
-}
-
-/**
- * Unsubscribe from push notifications
- */
-export async function unsubscribeFromPushNotifications(): Promise<boolean> {
-  if (!isPushNotificationSupported()) {
-    return false;
-  }
-
-  const registration = await navigator.serviceWorker.ready;
-  const subscription = await registration.pushManager.getSubscription();
-
-  if (subscription) {
-    return await subscription.unsubscribe();
-  }
-
-  return false;
-}
-
-/**
- * Get current push subscription
- */
-export async function getPushSubscription(): Promise<PushSubscription | null> {
-  if (!isPushNotificationSupported()) {
-    return null;
-  }
-
-  const registration = await navigator.serviceWorker.ready;
-  return await registration.pushManager.getSubscription();
-}
-
-/**
- * Show a local notification (doesn't require push)
- *
- * @example
- * ```ts
- * await showLocalNotification({
- *   title: 'Hello!',
- *   body: 'This is a test notification',
- *   icon: '/icon.png',
- *   data: { url: '/some-page' },
- * });
- * ```
- */
-export async function showLocalNotification(options: {
-  title: string;
-  body?: string;
-  icon?: string;
-  badge?: string;
-  tag?: string;
-  data?: any;
-  requireInteraction?: boolean;
-}): Promise<void> {
-  if (!('Notification' in window)) {
-    throw new Error('Notifications are not supported');
-  }
-
-  const permission = await requestNotificationPermission();
-  if (permission !== 'granted') {
-    throw new Error(`Notification permission ${permission}`);
-  }
-
-  const registration = await navigator.serviceWorker.ready;
-  await registration.showNotification(options.title, {
-    body: options.body,
-    icon: options.icon,
-    badge: options.badge,
-    tag: options.tag,
-    data: options.data,
-    requireInteraction: options.requireInteraction,
-  });
-}

package/src/pwa/server/index.ts

@@ -1,23 +0,0 @@
-/**
- * Server-side PWA Utilities
- *
- * Push notifications, VAPID configuration, and route handlers
- *
- * @example
- * ```typescript
- * // Configure VAPID keys
- * import { configureVapid } from '@djangocfg/nextjs/pwa/server';
- * configureVapid();
- *
- * // Use ready-made route handlers
- * // app/api/push/subscribe/route.ts
- * export { POST, GET } from '@djangocfg/nextjs/pwa/server/routes';
- *
- * // Or use utilities directly
- * import { sendPushNotification } from '@djangocfg/nextjs/pwa/server';
- * await sendPushNotification(subscription, { title: 'Hello!' });
- * ```
- */
-
-export * from './push';
-export * as routes from './routes';

package/src/pwa/server/push.ts

@@ -1,166 +0,0 @@
-/**
- * Server-side Push Notification Utilities
- *
- * VAPID-based Web Push notifications using web-push library
- */
-
-import { consola } from 'consola';
-import webpush, { PushSubscription } from 'web-push';
-
-let vapidConfigured = false;
-
-/**
- * Check if VAPID keys are configured
- */
-export function isVapidConfigured(): boolean {
-  return vapidConfigured;
-}
-
-/**
- * Get VAPID keys from environment
- */
-export 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 };
-}
-
-/**
- * Configure VAPID keys for web-push
- * Call this once at app startup
- *
- * @example
- * ```typescript
- * // In your API route or middleware
- * import { configureVapid } from '@djangocfg/nextjs/pwa/server';
- *
- * configureVapid(); // Uses env vars automatically
- * ```
- */
-export function configureVapid(options?: {
-  publicKey?: string;
-  privateKey?: string;
-  mailto?: string;
-}): boolean {
-  const { publicKey, privateKey, mailto } = options || getVapidKeys();
-
-  if (!publicKey || !privateKey) {
-    consola.warn(
-      '⚠️  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('✅ VAPID keys configured for push notifications');
-    return true;
-  } catch (error: any) {
-    consola.error('Failed to configure VAPID keys:', error.message);
-    return false;
-  }
-}
-
-/**
- * Send push notification to a subscription
- *
- * @example
- * ```typescript
- * await sendPushNotification(subscription, {
- *   title: 'Hello!',
- *   body: 'Test notification',
- *   data: { url: '/page' },
- * });
- * ```
- */
-export async function sendPushNotification(
-  subscription: PushSubscription,
-  notification: {
-    title: string;
-    body?: string;
-    icon?: string;
-    badge?: string;
-    data?: any;
-    tag?: string;
-    requireInteraction?: boolean;
-  }
-): Promise<void> {
-  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('✅ Push Sent to FCM:', {
-    statusCode: result.statusCode,
-    headers: result.headers,
-    bodyLength: result.body?.length
-  });
-}
-
-/**
- * Send push notification to multiple subscriptions
- *
- * @example
- * ```typescript
- * const results = await sendPushToMultiple(subscriptions, {
- *   title: 'Broadcast message',
- *   body: 'Sent to all users',
- * });
- * console.log(`Sent: ${results.successful}, Failed: ${results.failed}`);
- * ```
- */
-export async function sendPushToMultiple(
-  subscriptions: PushSubscription[],
-  notification: Parameters<typeof sendPushNotification>[1]
-): Promise<{
-  successful: number;
-  failed: number;
-  errors: Array<{ subscription: PushSubscription; error: Error }>;
-}> {
-  const results = await Promise.allSettled(
-    subscriptions.map((sub) => sendPushNotification(sub, notification))
-  );
-
-  const successful = results.filter((r) => r.status === 'fulfilled').length;
-  const failed = results.filter((r) => r.status === 'rejected').length;
-  const errors = results
-    .map((r, i) => (r.status === 'rejected' ? { subscription: subscriptions[i], error: r.reason } : null))
-    .filter((e): e is NonNullable<typeof e> => e !== null);
-
-  return { successful, failed, errors };
-}
-
-/**
- * Validate push subscription format
- */
-export function validateSubscription(subscription: any): subscription is PushSubscription {
-  return (
-    subscription &&
-    typeof subscription === 'object' &&
-    typeof subscription.endpoint === 'string' &&
-    subscription.keys &&
-    typeof subscription.keys.p256dh === 'string' &&
-    typeof subscription.keys.auth === 'string'
-  );
-}