@cloudsignal/pwa-sdk 1.0.0 → 1.1.0

package/dist/index.d.mts

@@ -209,6 +209,14 @@ interface PWAConfig {
     heartbeat?: HeartbeatConfig;
     /** Custom logger function */
     logger?: LoggerFunction;
+    /** Wake lock configuration (v1.1.0) */
+    wakeLock?: WakeLockConfig$1;
+    /** Offline queue configuration (v1.1.0) */
+    offlineQueue?: OfflineQueueConfig$1;
+    /** iOS install banner configuration (v1.1.0) */
+    iosInstallBanner?: IOSInstallBannerConfig$1;
+    /** Notification analytics configuration (v1.1.0) */
+    notificationAnalytics?: NotificationAnalyticsConfig;
 }
 /**
  * Service worker configuration
@@ -236,6 +244,60 @@ interface HeartbeatConfig {
     /** Stop heartbeat when page is hidden */
     stopOnHidden?: boolean;
 }
+/**
+ * Wake lock configuration to prevent screen sleep
+ */
+interface WakeLockConfig$1 {
+    /** Enable wake lock feature */
+    enabled?: boolean;
+    /** Automatically request wake lock on init */
+    autoRequest?: boolean;
+    /** Automatically re-acquire on visibility change */
+    reacquireOnVisibility?: boolean;
+}
+/**
+ * Offline queue configuration for resilient request handling
+ */
+interface OfflineQueueConfig$1 {
+    /** Enable offline request queuing */
+    enabled?: boolean;
+    /** Maximum requests in queue */
+    maxQueueSize?: number;
+    /** Time to live in hours for queued requests */
+    maxAgeTTLHours?: number;
+    /** Auto-process queue when coming online */
+    autoProcessOnOnline?: boolean;
+}
+/**
+ * iOS install banner configuration
+ */
+interface IOSInstallBannerConfig$1 {
+    /** Enable iOS install banner */
+    enabled?: boolean;
+    /** Custom banner title */
+    title?: string;
+    /** Custom banner subtitle */
+    subtitle?: string;
+    /** App name to display */
+    appName?: string;
+    /** App icon URL */
+    iconUrl?: string;
+    /** Show on first visit */
+    showOnFirstVisit?: boolean;
+    /** Delay before showing (ms) */
+    showDelay?: number;
+    /** How many days before showing again after dismissal */
+    dismissRememberDays?: number;
+}
+/**
+ * Notification analytics configuration
+ */
+interface NotificationAnalyticsConfig {
+    /** Enable analytics tracking */
+    enabled?: boolean;
+    /** Backend endpoint for analytics events */
+    endpoint?: string;
+}
 /**
  * Logger function signature
  */
@@ -441,7 +503,7 @@ interface NotificationAction {
 /**
  * Event types emitted by the SDK
  */
-type PWAEvent = 'install:available' | 'install:accepted' | 'install:dismissed' | 'install:completed' | 'install:error' | 'push:registered' | 'push:unregistered' | 'push:updated' | 'push:error' | 'push:received' | 'push:clicked' | 'permission:granted' | 'permission:denied' | 'permission:prompt' | 'sw:registered' | 'sw:updated' | 'sw:error' | 'sw:activated' | 'config:loaded' | 'config:error' | 'heartbeat:started' | 'heartbeat:stopped' | 'heartbeat:sent' | 'heartbeat:error' | 'network:online' | 'network:offline' | 'state:changed';
+type PWAEvent = 'install:available' | 'install:accepted' | 'install:dismissed' | 'install:completed' | 'install:error' | 'push:registered' | 'push:unregistered' | 'push:updated' | 'push:error' | 'push:received' | 'push:clicked' | 'permission:granted' | 'permission:denied' | 'permission:prompt' | 'sw:registered' | 'sw:updated' | 'sw:error' | 'sw:activated' | 'config:loaded' | 'config:error' | 'heartbeat:started' | 'heartbeat:stopped' | 'heartbeat:sent' | 'heartbeat:error' | 'heartbeat:intervalChanged' | 'heartbeat:pausedForBattery' | 'heartbeat:resumedFromBattery' | 'network:online' | 'network:offline' | 'state:changed' | 'wakeLock:acquired' | 'wakeLock:released' | 'wakeLock:error' | 'offlineQueue:queued' | 'offlineQueue:processed' | 'offlineQueue:flushed' | 'iosBanner:shown' | 'iosBanner:dismissed' | 'iosBanner:installClicked';
 /**
  * Event handler function
  */
@@ -517,6 +579,265 @@ interface NetworkEvent {
     connectionType?: string;
 }
 
+/**
+ * CloudSignal PWA SDK Wake Lock Types
+ */
+/**
+ * Wake lock configuration
+ */
+interface WakeLockConfig {
+    /** Enable wake lock feature */
+    enabled?: boolean;
+    /** Automatically reacquire lock when page becomes visible */
+    autoReacquire?: boolean;
+}
+/**
+ * Wake lock state
+ */
+interface WakeLockState {
+    /** Whether wake lock is currently active */
+    isActive: boolean;
+    /** Whether Wake Lock API is supported */
+    isSupported: boolean;
+    /** Type of wake lock (currently only 'screen' is supported) */
+    type?: 'screen';
+    /** Timestamp when lock was acquired */
+    acquiredAt?: number;
+}
+/**
+ * Wake lock acquired event data
+ */
+interface WakeLockAcquiredEvent {
+    timestamp: number;
+}
+/**
+ * Wake lock released event data
+ */
+interface WakeLockReleasedEvent {
+    timestamp: number;
+    reason: 'manual' | 'visibility' | 'system';
+}
+/**
+ * Wake lock error event data
+ */
+interface WakeLockErrorEvent {
+    timestamp: number;
+    error: string;
+    errorName?: string;
+}
+/**
+ * iOS Install Banner configuration
+ */
+interface IOSInstallBannerConfig {
+    /** Enable iOS install banner */
+    enabled?: boolean;
+    /** Title text */
+    title?: string;
+    /** Description text */
+    description?: string;
+    /** Button text */
+    buttonText?: string;
+    /** Close button text */
+    closeText?: string;
+    /** Icon URL (app icon) */
+    iconUrl?: string;
+    /** Custom CSS styles */
+    customStyles?: Partial<IOSInstallBannerStyles>;
+    /** Delay before showing banner (ms) */
+    showDelay?: number;
+    /** Remember dismissal for this many days */
+    dismissalDays?: number;
+    /** Position: 'top' | 'bottom' */
+    position?: 'top' | 'bottom';
+}
+/**
+ * iOS Install Banner styles
+ */
+interface IOSInstallBannerStyles {
+    backgroundColor: string;
+    textColor: string;
+    buttonBackgroundColor: string;
+    buttonTextColor: string;
+    borderRadius: string;
+    boxShadow: string;
+}
+/**
+ * iOS Install Banner state
+ */
+interface IOSInstallBannerState {
+    /** Whether banner is currently visible */
+    isVisible: boolean;
+    /** Whether banner was dismissed */
+    wasDismissed: boolean;
+    /** Whether device is iOS Safari (eligible for banner) */
+    isEligible: boolean;
+    /** Whether PWA is already installed */
+    isInstalled: boolean;
+}
+/**
+ * Notification analytics event
+ */
+interface NotificationAnalyticsEvent {
+    /** Unique notification ID */
+    notificationId: string;
+    /** Event type */
+    eventType: 'displayed' | 'clicked' | 'dismissed';
+    /** Registration ID */
+    registrationId?: string;
+    /** Timestamp of event */
+    timestamp: number;
+    /** Action clicked (if notification had action buttons) */
+    action?: string;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Network connection info (from Network Information API)
+ */
+interface NetworkConnectionInfo {
+    /** Effective connection type: '4g' | '3g' | '2g' | 'slow-2g' */
+    effectiveType?: '4g' | '3g' | '2g' | 'slow-2g';
+    /** Whether user has requested reduced data usage */
+    saveData?: boolean;
+    /** Estimated downlink speed in Mbps */
+    downlink?: number;
+    /** Estimated round-trip time in ms */
+    rtt?: number;
+}
+/**
+ * Battery info (from Battery Status API)
+ */
+interface BatteryInfo {
+    /** Battery level (0-1) */
+    level: number;
+    /** Whether device is charging */
+    charging: boolean;
+}
+/**
+ * Adaptive heartbeat configuration
+ */
+interface AdaptiveHeartbeatConfig {
+    /** Enable network-aware interval adjustment */
+    adaptToNetwork?: boolean;
+    /** Enable battery-aware pausing */
+    adaptToBattery?: boolean;
+    /** Battery threshold to pause heartbeat (0-1, default: 0.15) */
+    batteryPauseThreshold?: number;
+    /** Intervals by connection type */
+    intervals?: {
+        '4g'?: number;
+        '3g'?: number;
+        '2g'?: number;
+        'slow-2g'?: number;
+        'unknown'?: number;
+    };
+}
+/**
+ * iOS Install Banner options (for constructor)
+ */
+interface IOSInstallBannerOptions$1 {
+    /** Title text */
+    title?: string;
+    /** Subtitle text */
+    subtitle?: string;
+    /** App name to display */
+    appName?: string;
+    /** App icon URL */
+    iconUrl?: string;
+    /** Delay before showing (ms) */
+    showDelay?: number;
+    /** Days to remember dismissal */
+    dismissRememberDays?: number;
+    /** Callback when banner is shown */
+    onShow?: () => void;
+    /** Callback when banner is dismissed */
+    onDismiss?: () => void;
+    /** Callback when install instructions are clicked */
+    onInstallClick?: () => void;
+}
+
+/**
+ * CloudSignal PWA SDK Offline Queue Types
+ */
+/**
+ * Queued request for offline retry
+ */
+interface QueuedRequest {
+    /** Unique request ID */
+    id?: number;
+    /** Request URL */
+    url: string;
+    /** HTTP method */
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request body (JSON stringified) */
+    body?: string;
+    /** When the request was queued */
+    queuedAt: number;
+    /** Number of retry attempts */
+    retryCount: number;
+    /** Maximum retry attempts */
+    maxRetries: number;
+    /** Request type for categorization */
+    requestType: QueuedRequestType;
+    /** Priority (higher = more important) */
+    priority: number;
+    /** Optional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Types of requests that can be queued
+ */
+type QueuedRequestType = 'registration' | 'heartbeat' | 'analytics' | 'preferences' | 'unregister' | 'custom';
+/**
+ * Offline queue configuration
+ */
+interface OfflineQueueConfig {
+    /** Enable offline queue */
+    enabled?: boolean;
+    /** Maximum number of queued requests */
+    maxQueueSize?: number;
+    /** Maximum age of queued requests in ms (default: 24 hours) */
+    maxAge?: number;
+    /** Base retry delay in ms (default: 1000) */
+    baseRetryDelay?: number;
+    /** Maximum retry delay in ms (default: 60000) */
+    maxRetryDelay?: number;
+    /** Default max retries per request */
+    defaultMaxRetries?: number;
+    /** Process queue when online event fires */
+    processOnOnline?: boolean;
+}
+/**
+ * Result of processing a queued request
+ */
+interface QueueProcessResult {
+    /** Request ID */
+    id: number;
+    /** Whether request succeeded */
+    success: boolean;
+    /** HTTP status code if request was made */
+    statusCode?: number;
+    /** Error message if failed */
+    error?: string;
+    /** Whether request should be retried */
+    shouldRetry: boolean;
+}
+/**
+ * Offline queue statistics
+ */
+interface OfflineQueueStats {
+    /** Total requests in queue */
+    totalQueued: number;
+    /** Requests by type */
+    byType: Record<QueuedRequestType, number>;
+    /** Oldest request timestamp */
+    oldestRequest?: number;
+    /** Newest request timestamp */
+    newestRequest?: number;
+}
+
 /**
  * CloudSignal PWA Client
  * Main class for PWA functionality including installation, push notifications, and device tracking
@@ -532,6 +853,9 @@ declare class CloudSignalPWA {
     private installationManager;
     private pushNotificationManager;
     private heartbeatManager;
+    private wakeLockManager;
+    private offlineQueueManager;
+    private iosInstallBanner;
     private eventHandlers;
     constructor(config: PWAConfig);
     /**
@@ -607,6 +931,65 @@ declare class CloudSignalPWA {
      * Stop heartbeat
      */
     stopHeartbeat(): void;
+    /**
+     * Get current heartbeat interval (may vary with network conditions)
+     */
+    getHeartbeatInterval(): number;
+    /**
+     * Get current network connection info
+     */
+    getNetworkInfo(): NetworkConnectionInfo;
+    /**
+     * Get battery info if available
+     */
+    getBatteryInfo(): Promise<BatteryInfo | null>;
+    /**
+     * Request screen wake lock to prevent sleep
+     */
+    requestWakeLock(): Promise<boolean>;
+    /**
+     * Release screen wake lock
+     */
+    releaseWakeLock(): void;
+    /**
+     * Get wake lock state
+     */
+    getWakeLockState(): WakeLockState;
+    /**
+     * Queue a request for later execution when offline
+     */
+    queueOfflineRequest(url: string, method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', options?: {
+        body?: string;
+        headers?: Record<string, string>;
+    }): Promise<number | null>;
+    /**
+     * Process all queued requests
+     */
+    processOfflineQueue(): Promise<QueueProcessResult[]>;
+    /**
+     * Get offline queue statistics
+     */
+    getOfflineQueueStats(): Promise<OfflineQueueStats>;
+    /**
+     * Clear all queued requests
+     */
+    clearOfflineQueue(): Promise<void>;
+    /**
+     * Show iOS install banner manually
+     */
+    showIOSInstallBanner(): void;
+    /**
+     * Hide iOS install banner
+     */
+    hideIOSInstallBanner(): void;
+    /**
+     * Check if iOS install banner was previously dismissed
+     */
+    wasIOSBannerDismissed(): boolean;
+    /**
+     * Reset iOS banner dismissal state
+     */
+    resetIOSBannerDismissal(): void;
     /**
      * Clear app badge
      */
@@ -651,6 +1034,10 @@ declare class CloudSignalPWA {
      * Set up network status listeners
      */
     private setupNetworkListeners;
+    /**
+     * Configure notification analytics in service worker
+     */
+    private configureNotificationAnalytics;
     /**
      * Log message if debug is enabled
      */
@@ -966,6 +1353,7 @@ declare class PushNotificationManager {
 
 /**
  * HeartbeatManager - Online Status Tracking via Periodic Heartbeat
+ * Now with network and battery awareness for optimal performance
  */
 
 interface HeartbeatManagerOptions {
@@ -973,25 +1361,38 @@ interface HeartbeatManagerOptions {
     organizationId: string;
     organizationSecret: string;
     config?: HeartbeatConfig;
+    adaptiveConfig?: AdaptiveHeartbeatConfig;
     debug?: boolean;
     onHeartbeatSent?: () => void;
     onHeartbeatError?: (error: Error) => void;
+    onIntervalChanged?: (newInterval: number, reason: string) => void;
+    onPausedForBattery?: () => void;
+    onResumedFromBattery?: () => void;
 }
 /**
  * HeartbeatManager sends periodic heartbeats to track online status
+ * Now with adaptive intervals based on network quality and battery level
  */
 declare class HeartbeatManager {
     private serviceUrl;
     private organizationId;
     private organizationSecret;
     private config;
+    private adaptiveConfig;
     private debug;
     private registrationId;
     private intervalId;
     private isRunning;
+    private isPausedForBattery;
+    private currentInterval;
     private visibilityHandler;
+    private connectionChangeHandler;
+    private batteryManager;
     private onHeartbeatSent?;
     private onHeartbeatError?;
+    private onIntervalChanged?;
+    private onPausedForBattery?;
+    private onResumedFromBattery?;
     constructor(options: HeartbeatManagerOptions);
     /**
      * Set the registration ID for heartbeat requests
@@ -1017,6 +1418,38 @@ declare class HeartbeatManager {
      * Update heartbeat configuration
      */
     updateConfig(config: Partial<HeartbeatConfig>): void;
+    /**
+     * Get current network connection info
+     */
+    getNetworkInfo(): NetworkConnectionInfo;
+    /**
+     * Get current battery info (if available)
+     */
+    getBatteryInfo(): Promise<BatteryInfo | null>;
+    /**
+     * Get current heartbeat interval
+     */
+    getCurrentInterval(): number;
+    /**
+     * Check if heartbeat is paused due to low battery
+     */
+    isPausedDueToBattery(): boolean;
+    /**
+     * Start the heartbeat interval
+     */
+    private startInterval;
+    /**
+     * Update interval based on network conditions
+     */
+    private updateIntervalForNetwork;
+    /**
+     * Set up network change handler
+     */
+    private setupNetworkChangeHandler;
+    /**
+     * Set up battery monitoring
+     */
+    private setupBatteryMonitoring;
     /**
      * Set up visibility change handler
      */
@@ -1027,6 +1460,423 @@ declare class HeartbeatManager {
     private log;
 }
 
+/**
+ * WakeLockManager - Screen Wake Lock API wrapper
+ * Prevents device screen from dimming/locking when needed
+ */
+
+interface WakeLockManagerOptions {
+    config?: WakeLockConfig;
+    debug?: boolean;
+    onAcquired?: (event: WakeLockAcquiredEvent) => void;
+    onReleased?: (event: WakeLockReleasedEvent) => void;
+    onError?: (event: WakeLockErrorEvent) => void;
+}
+/**
+ * WakeLockManager provides a simple API for the Screen Wake Lock API
+ * with automatic reacquisition when the page becomes visible again
+ */
+declare class WakeLockManager {
+    private wakeLock;
+    private config;
+    private debug;
+    private visibilityHandler;
+    private releaseHandler;
+    private shouldReacquire;
+    private onAcquired?;
+    private onReleased?;
+    private onError?;
+    constructor(options?: WakeLockManagerOptions);
+    /**
+     * Check if Screen Wake Lock API is supported
+     */
+    isSupported(): boolean;
+    /**
+     * Get current wake lock state
+     */
+    getState(): WakeLockState;
+    /**
+     * Acquire a screen wake lock
+     * Prevents the screen from dimming or locking
+     */
+    acquire(): Promise<boolean>;
+    /**
+     * Release the screen wake lock
+     */
+    release(): Promise<void>;
+    /**
+     * Toggle wake lock on/off
+     */
+    toggle(): Promise<boolean>;
+    /**
+     * Check if wake lock is currently active
+     */
+    isActive(): boolean;
+    /**
+     * Destroy the manager and release any held locks
+     */
+    destroy(): Promise<void>;
+    /**
+     * Handle wake lock release (from system)
+     */
+    private handleRelease;
+    /**
+     * Set up visibility change handler for auto-reacquire
+     */
+    private setupVisibilityHandler;
+    /**
+     * Remove visibility change handler
+     */
+    private removeVisibilityHandler;
+    /**
+     * Log message if debug is enabled
+     */
+    private log;
+}
+
+/**
+ * OfflineQueueManager - Queue and retry failed requests when offline
+ * Uses IndexedDB for persistence across sessions
+ */
+
+interface OfflineQueueManagerOptions {
+    config?: OfflineQueueConfig;
+    debug?: boolean;
+    onRequestQueued?: (request: QueuedRequest) => void;
+    onRequestProcessed?: (result: QueueProcessResult) => void;
+    onQueueEmpty?: () => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * OfflineQueueManager handles queuing failed requests and retrying them
+ * when the network connection is restored
+ */
+declare class OfflineQueueManager {
+    private db;
+    private config;
+    private debug;
+    private isProcessing;
+    private onlineHandler;
+    private onRequestQueued?;
+    private onRequestProcessed?;
+    private onQueueEmpty?;
+    private onError?;
+    constructor(options?: OfflineQueueManagerOptions);
+    /**
+     * Initialize the offline queue manager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Destroy the manager and clean up listeners
+     */
+    destroy(): void;
+    /**
+     * Add a request to the queue
+     */
+    queueRequest(url: string, method: QueuedRequest['method'], options?: {
+        headers?: Record<string, string>;
+        body?: string;
+        requestType?: QueuedRequestType;
+        priority?: number;
+        maxRetries?: number;
+        metadata?: Record<string, any>;
+    }): Promise<number | null>;
+    /**
+     * Process all queued requests
+     */
+    processQueue(): Promise<QueueProcessResult[]>;
+    /**
+     * Process a single queued request
+     */
+    private processRequest;
+    /**
+     * Determine if a request should be retried based on status code
+     */
+    private shouldRetryStatus;
+    /**
+     * Update retry count and schedule next retry
+     */
+    private updateRetryCount;
+    /**
+     * Get queue statistics
+     */
+    getStats(): Promise<OfflineQueueStats>;
+    /**
+     * Clear all queued requests
+     */
+    clearQueue(): Promise<void>;
+    /**
+     * Check if queue has pending requests
+     */
+    hasPendingRequests(): Promise<boolean>;
+    /**
+     * Get number of queued requests
+     */
+    getQueueCount(): Promise<number>;
+    private openDatabase;
+    private addToStore;
+    private removeFromStore;
+    private getAllRequests;
+    private removeOldestRequest;
+    private cleanupOldRequests;
+    private promisifyRequest;
+    private delay;
+    private log;
+}
+
+/**
+ * IOSInstallBanner Internationalization (i18n)
+ * Language translations for iOS install instructions
+ */
+/**
+ * Supported language codes
+ */
+type IOSBannerLanguage = 'en' | 'es' | 'fr' | 'de' | 'it' | 'pt' | 'nl' | 'ru' | 'zh' | 'ja' | 'ko' | 'ar' | 'he' | 'hi' | 'tr' | 'pl' | 'sv' | 'da' | 'no' | 'fi';
+/**
+ * Language strings interface
+ */
+interface IOSBannerStrings {
+    title: string;
+    description: string;
+    buttonText: string;
+    closeText: string;
+    step1: string;
+    step2: string;
+    step3: string;
+    shareIconHint: string;
+    shareIconDescription: string;
+}
+/**
+ * Built-in language translations (20 languages)
+ */
+declare const IOS_BANNER_TRANSLATIONS: Record<IOSBannerLanguage, IOSBannerStrings>;
+/**
+ * Detect browser language and map to supported language
+ */
+declare function detectBrowserLanguage(): IOSBannerLanguage;
+
+/**
+ * IOSInstallBanner - Styled iOS Safari install instructions banner
+ * Shows users how to add the PWA to their home screen on iOS
+ * Supports 20 languages with auto-detection
+ */
+
+interface IOSInstallBannerOptions {
+    config?: IOSInstallBannerConfig;
+    /** Language code (e.g., 'en', 'es', 'fr') - auto-detected if not provided */
+    language?: IOSBannerLanguage;
+    /** Custom strings to override built-in translations */
+    customStrings?: Partial<IOSBannerStrings>;
+    debug?: boolean;
+    onShow?: () => void;
+    onDismiss?: () => void;
+    onInstallClick?: () => void;
+}
+declare class IOSInstallBanner {
+    private config;
+    private styles;
+    private strings;
+    private language;
+    private debug;
+    private bannerElement;
+    private overlayElement;
+    private onShow?;
+    private onDismiss?;
+    private onInstallClick?;
+    constructor(options?: IOSInstallBannerOptions);
+    /**
+     * Get current language
+     */
+    getLanguage(): IOSBannerLanguage;
+    /**
+     * Get current strings
+     */
+    getStrings(): IOSBannerStrings;
+    /**
+     * Set language and update strings
+     */
+    setLanguage(language: IOSBannerLanguage): void;
+    /**
+     * Get current banner state
+     */
+    getState(): IOSInstallBannerState;
+    /**
+     * Check if device is iOS Safari (eligible for banner)
+     */
+    isEligible(): boolean;
+    /**
+     * Check if PWA is already installed (running in standalone mode)
+     */
+    isInstalled(): boolean;
+    /**
+     * Check if banner was previously dismissed
+     */
+    wasDismissed(): boolean;
+    /**
+     * Show the install banner if eligible
+     */
+    show(): Promise<boolean>;
+    /**
+     * Hide the install banner
+     */
+    hide(): void;
+    /**
+     * Dismiss the banner and remember the dismissal
+     */
+    dismiss(): void;
+    /**
+     * Reset dismissal state (for testing or after significant time)
+     */
+    resetDismissal(): void;
+    /**
+     * Get iOS install steps (localized)
+     */
+    getInstallSteps(): string[];
+    /**
+     * Create and inject the banner element
+     */
+    private createBanner;
+    /**
+     * Log message if debug is enabled
+     */
+    private log;
+}
+
+/**
+ * NotificationPermissionPrompt - Soft prompt before native notification permission
+ * Improves opt-in rates by explaining value before triggering browser prompt
+ * Supports 20 languages with auto-detection
+ */
+
+/**
+ * Notification prompt strings interface
+ */
+interface NotificationPromptStrings {
+    title: string;
+    description: string;
+    allowButton: string;
+    laterButton: string;
+    iosNote?: string;
+}
+/**
+ * Built-in translations (20 languages)
+ */
+declare const NOTIFICATION_PROMPT_TRANSLATIONS: Record<IOSBannerLanguage, NotificationPromptStrings>;
+/**
+ * Prompt styles
+ */
+interface NotificationPromptStyles {
+    backgroundColor: string;
+    textColor: string;
+    primaryButtonBackground: string;
+    primaryButtonText: string;
+    secondaryButtonBackground: string;
+    secondaryButtonText: string;
+    borderRadius: string;
+    boxShadow: string;
+}
+/**
+ * Prompt configuration
+ */
+interface NotificationPromptConfig {
+    /** Enable the soft prompt */
+    enabled?: boolean;
+    /** Custom icon URL */
+    iconUrl?: string;
+    /** Show delay in ms */
+    showDelay?: number;
+    /** Days to remember dismissal */
+    dismissalDays?: number;
+    /** Position: 'top' | 'center' | 'bottom' */
+    position?: 'top' | 'center' | 'bottom';
+    /** Custom styles */
+    customStyles?: Partial<NotificationPromptStyles>;
+    /** Show iOS-specific note */
+    showIOSNote?: boolean;
+}
+interface NotificationPromptOptions {
+    config?: NotificationPromptConfig;
+    /** Language code - auto-detected if not provided */
+    language?: IOSBannerLanguage;
+    /** Custom strings to override translations */
+    customStrings?: Partial<NotificationPromptStrings>;
+    debug?: boolean;
+    /** Called when user clicks allow */
+    onAllow?: () => void;
+    /** Called when user clicks later */
+    onLater?: () => void;
+    /** Called when prompt is shown */
+    onShow?: () => void;
+}
+/**
+ * NotificationPermissionPrompt - Soft prompt before native browser permission
+ */
+declare class NotificationPermissionPrompt {
+    private config;
+    private styles;
+    private strings;
+    private language;
+    private debug;
+    private promptElement;
+    private overlayElement;
+    private onAllow?;
+    private onLater?;
+    private onShow?;
+    constructor(options?: NotificationPromptOptions);
+    /**
+     * Get current language
+     */
+    getLanguage(): IOSBannerLanguage;
+    /**
+     * Set language
+     */
+    setLanguage(language: IOSBannerLanguage): void;
+    /**
+     * Check if should show prompt
+     */
+    shouldShow(): boolean;
+    /**
+     * Check if previously dismissed
+     */
+    wasDismissed(): boolean;
+    /**
+     * Check if device is iOS
+     */
+    private isIOS;
+    /**
+     * Check if PWA is installed (standalone mode)
+     */
+    private isInstalled;
+    /**
+     * Show the soft prompt
+     */
+    show(): Promise<boolean>;
+    /**
+     * Hide the prompt
+     */
+    hide(): void;
+    /**
+     * Dismiss and remember
+     */
+    dismiss(): void;
+    /**
+     * Reset dismissal state
+     */
+    resetDismissal(): void;
+    /**
+     * Handle allow click - triggers native permission
+     */
+    handleAllow(): Promise<NotificationPermission>;
+    /**
+     * Create and inject the prompt element
+     */
+    private createPrompt;
+    /**
+     * Log message if debug is enabled
+     */
+    private log;
+}
+
 /**
  * HMAC Authentication Utilities
  * Implements CloudSignal's HMAC signature scheme for API authentication
@@ -1189,9 +2039,11 @@ declare class IndexedDBStorage {
  * CloudSignal PWA SDK
  * Progressive Web App features with push notifications, installation management, and device tracking
  *
+ * v1.1.0: Added WakeLock, OfflineQueue, iOS Install Banner, Network-aware Heartbeat, Notification Analytics
+ *
  * @packageDocumentation
  */
 
-declare const VERSION = "1.0.0";
+declare const VERSION = "1.1.0";
 
-export { type BeforeInstallPromptEvent, CloudSignalPWA, type ConfigLoadedEvent, DeviceDetector, type DeviceInfo, type DisplayMode, type EventHandler, type HeartbeatConfig, type HeartbeatEvent, HeartbeatManager, IndexedDBStorage, type InitializeResult, type InstallAvailableEvent, type InstallResult, type InstallResultEvent, InstallationManager, type InstallationState, type LoggerFunction, type NetworkEvent, type NetworkInfo, type NotificationAction, type NotificationPayload, type NotificationPermissionState, type NotificationPreferences, type PWACapabilities, type PWAConfig, type PWAEvent, type PWAServiceConfig, type PWASupportLevel, type PermissionEvent, type PlatformInfo, type PushClickedEvent, PushNotificationManager, type PushReceivedEvent, type PushRegisteredEvent, type PushSubscriptionData, type RegisterOptions, type Registration, type RegistrationStatus, type RegistrationStatusResponse, type ScreenInfo, type ServiceWorkerConfig, type ServiceWorkerEvent, ServiceWorkerManager, VERSION, CloudSignalPWA as default, deviceDetector, generateAuthHeaders, generateBrowserFingerprint, generateHMACSignature, generateTrackingId, getRegistrationId, getStorageItem, isValidUUID, makeAuthenticatedRequest, removeRegistrationId, removeStorageItem, setRegistrationId, setStorageItem };
+export { type AdaptiveHeartbeatConfig, type BatteryInfo, type BeforeInstallPromptEvent, CloudSignalPWA, type ConfigLoadedEvent, DeviceDetector, type DeviceInfo, type DisplayMode, type EventHandler, type HeartbeatConfig, type HeartbeatEvent, HeartbeatManager, type IOSBannerLanguage, type IOSBannerStrings, IOSInstallBanner, type IOSInstallBannerConfig$1 as IOSInstallBannerConfig, type IOSInstallBannerOptions$1 as IOSInstallBannerOptions, IOS_BANNER_TRANSLATIONS, IndexedDBStorage, type InitializeResult, type InstallAvailableEvent, type InstallResult, type InstallResultEvent, InstallationManager, type InstallationState, type LoggerFunction, NOTIFICATION_PROMPT_TRANSLATIONS, type NetworkConnectionInfo, type NetworkEvent, type NetworkInfo, type NotificationAction, type NotificationAnalyticsConfig, type NotificationAnalyticsEvent, type NotificationPayload, NotificationPermissionPrompt, type NotificationPermissionState, type NotificationPreferences, type IOSBannerLanguage as NotificationPromptLanguage, type NotificationPromptStrings, type OfflineQueueConfig$1 as OfflineQueueConfig, OfflineQueueManager, type OfflineQueueStats, type PWACapabilities, type PWAConfig, type PWAEvent, type PWAServiceConfig, type PWASupportLevel, type PermissionEvent, type PlatformInfo, type PushClickedEvent, PushNotificationManager, type PushReceivedEvent, type PushRegisteredEvent, type PushSubscriptionData, type QueueProcessResult, type QueuedRequest, type RegisterOptions, type Registration, type RegistrationStatus, type RegistrationStatusResponse, type ScreenInfo, type ServiceWorkerConfig, type ServiceWorkerEvent, ServiceWorkerManager, VERSION, type WakeLockConfig$1 as WakeLockConfig, WakeLockManager, type WakeLockState, CloudSignalPWA as default, detectBrowserLanguage, deviceDetector, generateAuthHeaders, generateBrowserFingerprint, generateHMACSignature, generateTrackingId, getRegistrationId, getStorageItem, isValidUUID, makeAuthenticatedRequest, removeRegistrationId, removeStorageItem, setRegistrationId, setStorageItem };