@djangocfg/nextjs 2.1.36 → 2.1.38

package/dist/plugin-DuRJ_Jq6.d.mts

@@ -0,0 +1,100 @@
+import { NextConfig } from 'next';
+
+/**
+ * PWA (Progressive Web App) Plugin
+ *
+ * Configures Serwist for service worker and offline support
+ * Modern PWA solution for Next.js 15+ with App Router
+ *
+ * @see https://serwist.pages.dev/
+ */
+
+interface PWAPluginOptions {
+    /**
+     * Destination directory for service worker files
+     * @default 'public'
+     * @deprecated Use swDest instead
+     */
+    dest?: string;
+    /**
+     * Path to service worker source file (relative to project root)
+     * @default 'app/sw.ts'
+     */
+    swSrc?: string;
+    /**
+     * Destination for compiled service worker
+     * @default 'public/sw.js'
+     */
+    swDest?: string;
+    /**
+     * Disable PWA completely
+     * @default false in production, true in development
+     * @example disable: process.env.NODE_ENV === 'development'
+     */
+    disable?: boolean;
+    /**
+     * Cache on navigation - cache pages when navigating
+     * @default true
+     */
+    cacheOnNavigation?: boolean;
+    /**
+     * Reload app when device goes back online
+     * @default true
+     */
+    reloadOnOnline?: boolean;
+    /**
+     * Additional Serwist options
+     * @see https://serwist.pages.dev/docs/next/configuring
+     */
+    serwistOptions?: Record<string, any>;
+}
+/**
+ * Add PWA configuration to Next.js config using Serwist
+ *
+ * @example Basic usage
+ * ```ts
+ * import { createBaseNextConfig, withPWA } from '@djangocfg/nextjs/config';
+ *
+ * const nextConfig = createBaseNextConfig({...});
+ *
+ * export default withPWA(nextConfig, {
+ *   swSrc: 'app/sw.ts',
+ *   disable: process.env.NODE_ENV === 'development',
+ * });
+ * ```
+ *
+ * @example Integrated with createBaseNextConfig
+ * ```ts
+ * import { createBaseNextConfig } from '@djangocfg/nextjs/config';
+ *
+ * const config = createBaseNextConfig({
+ *   pwa: {
+ *     swSrc: 'app/sw.ts',
+ *     disable: false,
+ *   },
+ * });
+ *
+ * export default config;
+ * ```
+ */
+declare function withPWA(nextConfig: NextConfig, options?: PWAPluginOptions): NextConfig;
+/**
+ * Get service worker template content
+ *
+ * Returns ready-to-use service worker code for app/sw.ts
+ *
+ * @example
+ * ```ts
+ * import { getServiceWorkerTemplate } from '@djangocfg/nextjs/config';
+ *
+ * // Copy this to your app/sw.ts file
+ * console.log(getServiceWorkerTemplate());
+ * ```
+ */
+declare function getServiceWorkerTemplate(): string;
+declare const defaultRuntimeCaching: any[];
+declare function createApiCacheRule(): {};
+declare function createStaticAssetRule(): {};
+declare function createCdnCacheRule(): {};
+
+export { type PWAPluginOptions as P, createStaticAssetRule as a, createCdnCacheRule as b, createApiCacheRule as c, defaultRuntimeCaching as d, getServiceWorkerTemplate as g, withPWA as w };

package/dist/pwa/cli.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/pwa/cli.mjs

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+
+// src/pwa/cli.ts
+import { consola } from "consola";
+import webpush from "web-push";
+var args = process.argv.slice(2);
+var 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("\u2705 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
+`);
+  consola.info("Public key (share with clients):");
+  consola.log(`  ${vapidKeys.publicKey}
+`);
+  consola.info("Private key (keep secret):");
+  consola.log(`  ${vapidKeys.privateKey}
+`);
+}
+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("\u274C 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);
+  }
+  const subscriptionArg = args[1];
+  if (!subscriptionArg) {
+    consola.error("\u274C Subscription required!\n");
+    consola.info("Usage:");
+    consola.log(`  pnpm pwa send '{"endpoint":"...","keys":{...}}'
+`);
+    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("\u2705 Push notification sent successfully!");
+  } catch (err) {
+    consola.error("\u274C 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 ? "\u2705 Set" : "\u274C Not set"}`);
+  consola.log(`  VAPID_PRIVATE_KEY:            ${privateKey ? "\u2705 Set" : "\u274C Not set"}`);
+  consola.log(`  VAPID_MAILTO:                 ${mailto || "\u26A0\uFE0F  Not set (optional)"}
+`);
+  if (!publicKey || !privateKey) {
+    consola.warn("\u26A0\uFE0F  VAPID keys not configured. Run: pnpm pwa vapid\n");
+  } else {
+    consola.success("\u2705 VAPID keys configured\n");
+    consola.log("Public Key:");
+    consola.log(`  ${publicKey.slice(0, 40)}...
+`);
+  }
+  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":"..."}}'
+`);
+  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();
+//# sourceMappingURL=cli.mjs.map

package/dist/pwa/cli.mjs.map

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

package/dist/pwa/index.d.mts

@@ -0,0 +1,274 @@
+import { Viewport, Metadata, MetadataRoute } from 'next';
+export { P as PWAPluginOptions, c as createApiCacheRule, b as createCdnCacheRule, a as createStaticAssetRule, d as defaultRuntimeCaching, g as getServiceWorkerTemplate, w as withPWA } from '../plugin-DuRJ_Jq6.mjs';
+
+/**
+ * PWA Push Notifications Client Utilities
+ *
+ * Functions for requesting permission, subscribing to push notifications,
+ * and sending test notifications
+ */
+/**
+ * Check if push notifications are supported
+ */
+declare function isPushNotificationSupported(): boolean;
+/**
+ * Get current notification permission status
+ */
+declare function getNotificationPermission(): NotificationPermission;
+/**
+ * Request notification permission from user
+ */
+declare function requestNotificationPermission(): Promise<NotificationPermission>;
+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),
+ * });
+ * ```
+ */
+declare function subscribeToPushNotifications(options: PushSubscriptionOptions): Promise<PushSubscription>;
+/**
+ * Unsubscribe from push notifications
+ */
+declare function unsubscribeFromPushNotifications(): Promise<boolean>;
+/**
+ * Get current push subscription
+ */
+declare function getPushSubscription(): Promise<PushSubscription | null>;
+/**
+ * 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' },
+ * });
+ * ```
+ */
+declare function showLocalNotification(options: {
+    title: string;
+    body?: string;
+    icon?: string;
+    badge?: string;
+    tag?: string;
+    data?: any;
+    requireInteraction?: boolean;
+}): Promise<void>;
+
+/**
+ * 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 PushSubscriptionOptions, type ScreenshotConfig, type SmartScreenshotInput, createManifest, createManifestMetadata, createScreenshot, createScreenshots, createViewport, generateManifest, getNotificationPermission, getPushSubscription, isPushNotificationSupported, requestNotificationPermission, showLocalNotification, subscribeToPushNotifications, unsubscribeFromPushNotifications };