@djangocfg/layouts 2.1.226 → 2.1.228

package/src/snippets/PWAInstall/utils/logger.ts

@@ -1,149 +0,0 @@
-/**
- * PWA Logger with Conditional Logging
- *
- * Provides logging utilities that respect environment and debug settings:
- * - In production: Only errors are logged
- * - In development: All levels are logged
- * - Debug mode: Can be enabled in production via localStorage
- *
- * @example
- * ```typescript
- * import { pwaLogger } from '../utils/logger';
- *
- * pwaLogger.info('Info message'); // Only in dev
- * pwaLogger.warn('Warning message'); // Only in dev
- * pwaLogger.error('Error message'); // Always logged
- * pwaLogger.debug('Debug message'); // Only when debug enabled
- * ```
- *
- * Enable debug mode in production:
- * ```typescript
- * import { enablePWADebug } from '../utils/logger';
- * enablePWADebug();
- * // or in console:
- * localStorage.setItem('pwa_debug', 'true');
- * ```
- */
-
-import { consola } from 'consola';
-
-const isDevelopment = process.env.NODE_ENV === 'development';
-
-/**
- * Check if debug mode is enabled via localStorage
- */
-function isDebugEnabled(): boolean {
-  if (typeof window === 'undefined') return false;
-  try {
-    return localStorage.getItem('pwa_debug') === 'true';
-  } catch {
-    return false;
-  }
-}
-
-/**
- * PWA Logger instance with conditional logging
- */
-export const pwaLogger = {
-  /**
-   * Info level logging
-   * Only logs in development or when debug is enabled
-   */
-  info: (...args: Parameters<typeof consola.info>): void => {
-    if (isDevelopment || isDebugEnabled()) {
-      consola.info(...args);
-    }
-  },
-
-  /**
-   * Warning level logging
-   * Only logs in development or when debug is enabled
-   */
-  warn: (...args: Parameters<typeof consola.warn>): void => {
-    if (isDevelopment || isDebugEnabled()) {
-      consola.warn(...args);
-    }
-  },
-
-  /**
-   * Error level logging
-   * Always logs (production + development)
-   */
-  error: (...args: Parameters<typeof consola.error>): void => {
-    consola.error(...args);
-  },
-
-  /**
-   * Debug level logging
-   * Only logs when debug is explicitly enabled
-   */
-  debug: (...args: Parameters<typeof consola.debug>): void => {
-    if (isDebugEnabled()) {
-      consola.debug(...args);
-    }
-  },
-
-  /**
-   * Success level logging
-   * Only logs in development or when debug is enabled
-   */
-  success: (...args: Parameters<typeof consola.success>): void => {
-    if (isDevelopment || isDebugEnabled()) {
-      consola.success(...args);
-    }
-  },
-};
-
-/**
- * Enable debug mode
- *
- * This allows seeing debug logs in production.
- * Call this function or set localStorage manually:
- * `localStorage.setItem('pwa_debug', 'true')`
- *
- * @example
- * ```typescript
- * import { enablePWADebug } from '@djangocfg/layouts/snippets';
- * enablePWADebug();
- * // Reload page to see debug logs
- * ```
- */
-export function enablePWADebug(): void {
-  if (typeof window !== 'undefined') {
-    try {
-      localStorage.setItem('pwa_debug', 'true');
-      consola.info('[PWA] Debug mode enabled. Reload page to see debug logs.');
-    } catch (e) {
-      consola.error('[PWA] Failed to enable debug mode:', e);
-    }
-  }
-}
-
-/**
- * Disable debug mode
- *
- * @example
- * ```typescript
- * import { disablePWADebug } from '@djangocfg/layouts/snippets';
- * disablePWADebug();
- * ```
- */
-export function disablePWADebug(): void {
-  if (typeof window !== 'undefined') {
-    try {
-      localStorage.removeItem('pwa_debug');
-      consola.info('[PWA] Debug mode disabled.');
-    } catch (e) {
-      consola.error('[PWA] Failed to disable debug mode:', e);
-    }
-  }
-}
-
-/**
- * Check if debug mode is currently active
- *
- * @returns true if debug mode is enabled
- */
-export function isPWADebugEnabled(): boolean {
-  return isDebugEnabled();
-}

package/src/snippets/PWAInstall/utils/platform.ts

@@ -1,151 +0,0 @@
-/**
- * Platform Detection Utilities
- *
- * Centralized utilities for detecting PWA state, platform, and capabilities.
- * Used by hooks to avoid code duplication.
- */
-
-/**
- * Check if running as PWA (standalone mode)
- *
- * Checks if the app is running in standalone mode (added to home screen).
- * This is the primary indicator that a PWA has been installed.
- *
- * @returns true if app is running in standalone mode
- *
- * @example
- * ```typescript
- * if (isStandalone()) {
- *   console.log('Running as PWA');
- * }
- * ```
- */
-export function isStandalone(): boolean {
-  if (typeof window === 'undefined') return false;
-
-  // Fallback for older browsers without matchMedia
-  if (!window.matchMedia) {
-    // Use legacy iOS check only
-    const nav = navigator as Navigator & { standalone?: boolean };
-    return nav.standalone === true;
-  }
-
-  // Check display-mode media query (modern approach)
-  const isStandaloneDisplay = window.matchMedia('(display-mode: standalone)').matches;
-
-  // Legacy iOS check (navigator.standalone)
-  const nav = navigator as Navigator & { standalone?: boolean };
-  const isStandaloneNavigator = nav.standalone === true;
-
-  return isStandaloneDisplay || isStandaloneNavigator;
-}
-
-/**
- * Check if device is mobile
- *
- * @returns true if device is mobile (iOS, Android, etc.)
- */
-export function isMobileDevice(): boolean {
-  if (typeof window === 'undefined') return false;
-  return /iPhone|iPad|iPod|Android/i.test(navigator.userAgent);
-}
-
-/**
- * Check if web app manifest exists and is valid
- *
- * @returns true if manifest link exists in document head
- */
-export function hasValidManifest(): boolean {
-  if (typeof document === 'undefined') return false;
-  const manifestLink = document.querySelector('link[rel="manifest"]');
-  return !!manifestLink;
-}
-
-/**
- * Reliable check for PWA mode with edge case handling
- *
- * This function provides additional validation for desktop browsers
- * to avoid false positives (e.g., Safari macOS "Add to Dock").
- *
- * For mobile devices, standard standalone check is sufficient.
- * For desktop, additionally validates that a manifest exists.
- *
- * @returns true if app is running as a genuine PWA
- *
- * @example
- * ```typescript
- * // Use this for more reliable detection
- * if (isStandaloneReliable()) {
- *   console.log('Definitely running as PWA');
- * }
- * ```
- */
-export function isStandaloneReliable(): boolean {
-  const standalone = isStandalone();
-  if (!standalone) return false;
-
-  // For mobile devices, standalone check is sufficient
-  if (isMobileDevice()) return true;
-
-  // For desktop browsers, additionally check for valid manifest
-  // This prevents false positives like Safari macOS "Add to Dock"
-  return hasValidManifest();
-}
-
-/**
- * Get display mode from media query
- *
- * @returns Current display mode: 'standalone', 'fullscreen', 'minimal-ui', or 'browser'
- */
-export function getDisplayMode(): 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser' {
-  if (typeof window === 'undefined') return 'browser';
-
-  if (!window.matchMedia) return 'browser';
-
-  const modes: Array<'standalone' | 'fullscreen' | 'minimal-ui'> = [
-    'fullscreen',
-    'standalone',
-    'minimal-ui',
-  ];
-
-  for (const mode of modes) {
-    if (window.matchMedia(`(display-mode: ${mode})`).matches) {
-      return mode;
-    }
-  }
-
-  return 'browser';
-}
-
-/**
- * Create a media query listener for display-mode changes
- *
- * @param callback - Function to call when display mode changes
- * @returns Cleanup function to remove listener
- *
- * @example
- * ```typescript
- * const cleanup = onDisplayModeChange((isStandalone) => {
- *   console.log('Display mode changed:', isStandalone);
- * });
- *
- * // Later: cleanup();
- * ```
- */
-export function onDisplayModeChange(callback: (isStandalone: boolean) => void): () => void {
-  if (typeof window === 'undefined' || !window.matchMedia) {
-    return () => {}; // No-op cleanup
-  }
-
-  const mediaQuery = window.matchMedia('(display-mode: standalone)');
-
-  const handleChange = (e: MediaQueryListEvent) => {
-    callback(e.matches);
-  };
-
-  mediaQuery.addEventListener('change', handleChange);
-
-  return () => {
-    mediaQuery.removeEventListener('change', handleChange);
-  };
-}