@togglely/sdk-core 1.1.11 → 1.2.2

package/dist/cli.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+/**
+ * Togglely CLI - Build-time JSON generator
+ *
+ * Usage:
+ *   togglely-pull --apiKey=xxx --project=xxx --environment=xxx --output=./toggles.json
+ *   togglely-pull --config=./togglely.config.js
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const config = {};
+    for (const arg of args) {
+        if (arg.startsWith('--apiKey=')) {
+            config.apiKey = arg.split('=')[1];
+        }
+        else if (arg.startsWith('--project=')) {
+            config.project = arg.split('=')[1];
+        }
+        else if (arg.startsWith('--environment=')) {
+            config.environment = arg.split('=')[1];
+        }
+        else if (arg.startsWith('--baseUrl=')) {
+            config.baseUrl = arg.split('=')[1];
+        }
+        else if (arg.startsWith('--tenantId=')) {
+            config.tenantId = arg.split('=')[1];
+        }
+        else if (arg.startsWith('--output=')) {
+            config.output = arg.split('=')[1];
+        }
+        else if (arg.startsWith('--format=')) {
+            config.format = arg.split('=')[1];
+        }
+        else if (arg.startsWith('--config=')) {
+            const configPath = arg.split('=')[1];
+            if (fs.existsSync(configPath)) {
+                const fileConfig = require(path.resolve(configPath));
+                Object.assign(config, fileConfig);
+            }
+            else {
+                console.error(`Config file not found: ${configPath}`);
+                process.exit(1);
+            }
+        }
+    }
+    return config;
+}
+function loadEnvFile() {
+    const envConfig = {};
+    // Try to load from .env file
+    const envPaths = ['.env', '.env.local', '.env.production', '.env.development'];
+    for (const envPath of envPaths) {
+        if (fs.existsSync(envPath)) {
+            const content = fs.readFileSync(envPath, 'utf-8');
+            const lines = content.split('\n');
+            for (const line of lines) {
+                const match = line.match(/^TOGGLELY_(\w+)=(.+)$/);
+                if (match) {
+                    const key = match[1].toLowerCase();
+                    const value = match[2].replace(/^["']|["']$/g, '');
+                    if (key === 'apikey')
+                        envConfig.apiKey = value;
+                    if (key === 'project')
+                        envConfig.project = value;
+                    if (key === 'environment')
+                        envConfig.environment = value;
+                    if (key === 'baseurl')
+                        envConfig.baseUrl = value;
+                    if (key === 'tenantid')
+                        envConfig.tenantId = value;
+                }
+            }
+        }
+    }
+    return envConfig;
+}
+async function fetchToggles(config) {
+    const params = new URLSearchParams();
+    params.set('apiKey', config.apiKey);
+    if (config.tenantId)
+        params.set('tenantId', config.tenantId);
+    const url = `${config.baseUrl}/sdk/flags/${config.project}/${config.environment}?${params.toString()}`;
+    console.log(`Fetching toggles from: ${url.replace(config.apiKey, '***')}`);
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    return response.json();
+}
+function generateOutput(data, format) {
+    switch (format) {
+        case 'env':
+            return Object.entries(data)
+                .map(([key, value]) => {
+                const envKey = `TOGGLELY_${key.toUpperCase().replace(/-/g, '_')}`;
+                const envValue = typeof value === 'object' ? JSON.stringify(value) : String(value);
+                return `${envKey}=${envValue}`;
+            })
+                .join('\n');
+        case 'js':
+            return `// Auto-generated by Togglely CLI
+module.exports = ${JSON.stringify(data, null, 2)};
+`;
+        case 'json':
+        default:
+            return JSON.stringify(data, null, 2);
+    }
+}
+async function main() {
+    console.log('🚀 Togglely CLI - Build-time JSON Generator\n');
+    const argsConfig = parseArgs();
+    const envConfig = loadEnvFile();
+    // Merge configs (args > env > defaults)
+    const config = {
+        baseUrl: 'https://togglely.de',
+        output: './togglely-toggles.json',
+        format: 'json',
+        ...envConfig,
+        ...argsConfig,
+    };
+    // Validate required fields
+    if (!config.apiKey || !config.project || !config.environment) {
+        console.error('❌ Missing required parameters:');
+        console.error('   --apiKey=<key>');
+        console.error('   --project=<project-key>');
+        console.error('   --environment=<environment-key>');
+        console.error('\nOr use environment variables:');
+        console.error('   TOGGLELY_APIKEY, TOGGLELY_PROJECT, TOGGLELY_ENVIRONMENT');
+        console.error('\nOr use a config file:');
+        console.error('   --config=./togglely.config.js');
+        process.exit(1);
+    }
+    try {
+        const data = await fetchToggles(config);
+        const output = generateOutput(data, config.format);
+        // Ensure directory exists
+        const dir = path.dirname(config.output);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(config.output, output);
+        console.log(`✅ Successfully saved ${Object.keys(data).length} toggles to: ${config.output}`);
+        console.log(`\nToggles found:`);
+        Object.entries(data).forEach(([key, value]) => {
+            const status = value.enabled ? '✅' : '❌';
+            console.log(`   ${status} ${key}: ${JSON.stringify(value.value)}`);
+        });
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error.message}`);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,7 +1,12 @@
 /**
- * Togglely Core SDK - Framework agnostic
+ * Togglely Core SDK - Framework agnostic feature flag management
  *
- * Supports offline fallback via environment variables
+ * Features:
+ * - Real-time feature flag evaluation
+ * - Offline fallback via JSON file, environment variables, or window object
+ * - Multi-brand/tenant support
+ * - Type-safe flag access
+ * - Build-time JSON generation for offline-first deployment
  */
 export interface TogglelyConfig {
     /** API Key from your Togglely dashboard */
@@ -14,8 +19,12 @@ export interface TogglelyConfig {
     baseUrl: string;
     /** Request timeout in milliseconds (default: 5000) */
     timeout?: number;
-    /** Enable offline mode fallback via environment variables (default: true) */
+    /** Enable offline fallback (default: true) */
     offlineFallback?: boolean;
+    /** Path to offline JSON file for fallback (optional) */
+    offlineJsonPath?: string;
+    /** Inline offline toggles data (optional) */
+    offlineToggles?: Record<string, ToggleValue>;
     /** Prefix for environment variables (default: 'TOGGLELY_') */
     envPrefix?: string;
     /** Auto-fetch toggles on init (default: true) */
@@ -37,6 +46,7 @@ export interface ToggleContext {
 export interface ToggleValue {
     value: any;
     enabled: boolean;
+    flagType?: 'BOOLEAN' | 'STRING' | 'NUMBER' | 'JSON';
 }
 export interface AllTogglesResponse {
     [key: string]: ToggleValue;
@@ -49,9 +59,6 @@ export interface TogglelyState {
 }
 export type TogglelyEventType = 'ready' | 'update' | 'error' | 'offline' | 'online';
 export type TogglelyEventHandler = (state: TogglelyState) => void;
-/**
- * Core Togglely Client
- */
 export declare class TogglelyClient {
     private config;
     private toggles;
@@ -69,19 +76,62 @@ export declare class TogglelyClient {
     getState(): TogglelyState;
     isReady(): boolean;
     isOffline(): boolean;
+    /**
+     * Check if a boolean feature flag is enabled
+     * @param key - The flag key
+     * @param defaultValue - Default value if flag not found
+     * @returns Promise<boolean>
+     */
     isEnabled(key: string, defaultValue?: boolean): Promise<boolean>;
+    /**
+     * Get a string feature flag value
+     * @param key - The flag key
+     * @param defaultValue - Default value if flag not found or disabled
+     * @returns Promise<string>
+     */
     getString(key: string, defaultValue?: string): Promise<string>;
+    /**
+     * Get a number feature flag value
+     * @param key - The flag key
+     * @param defaultValue - Default value if flag not found or disabled
+     * @returns Promise<number>
+     */
     getNumber(key: string, defaultValue?: number): Promise<number>;
+    /**
+     * Get a JSON feature flag value
+     * @param key - The flag key
+     * @param defaultValue - Default value if flag not found or disabled
+     * @returns Promise<T>
+     */
     getJSON<T = any>(key: string, defaultValue?: T): Promise<T>;
+    /**
+     * Get raw toggle value
+     * @param key - The flag key
+     * @returns Promise<ToggleValue | null>
+     */
     getValue(key: string): Promise<ToggleValue | null>;
+    /**
+     * Get all toggles
+     * @returns Record<string, ToggleValue>
+     */
     getAllToggles(): Record<string, ToggleValue>;
     /**
-     * Load toggles from environment variables
-     * Format: TOGGLELY_<TOGGLE_KEY>=<value> or TOGGLELY_<TOGGLE_KEY>_ENABLED=true
+     * Load offline toggles from multiple sources (in priority order):
+     * 1. Inline offlineToggles from config
+     * 2. JSON file (if offlineJsonPath is set)
+     * 3. window.__TOGGLELY_TOGGLES (browser)
+     * 4. Environment variables (Node.js)
      */
     private loadOfflineToggles;
+    /**
+     * Load offline toggles from JSON file (async)
+     */
+    private loadOfflineJsonFile;
     private getOfflineToggle;
     private parseOfflineValue;
+    /**
+     * Refresh all toggles from the server
+     */
     refresh(): Promise<void>;
     forceOfflineMode(): void;
     forceOnlineMode(): void;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.esm.js

@@ -1,11 +1,14 @@
 /**
- * Togglely Core SDK - Framework agnostic
+ * Togglely Core SDK - Framework agnostic feature flag management
  *
- * Supports offline fallback via environment variables
- */
-/**
- * Core Togglely Client
+ * Features:
+ * - Real-time feature flag evaluation
+ * - Offline fallback via JSON file, environment variables, or window object
+ * - Multi-brand/tenant support
+ * - Type-safe flag access
+ * - Build-time JSON generation for offline-first deployment
  */
+// ==================== Togglely Client ====================
 class TogglelyClient {
     constructor(config) {
         this.toggles = new Map();
@@ -23,6 +26,7 @@ class TogglelyClient {
             offlineFallback: true,
             envPrefix: 'TOGGLELY_',
             autoFetch: true,
+            offlineJsonPath: undefined,
             ...config
         };
         // Initialize event handlers
@@ -88,30 +92,56 @@ class TogglelyClient {
         return this.state.isOffline;
     }
     // ==================== Toggle Accessors ====================
+    /**
+     * Check if a boolean feature flag is enabled
+     * @param key - The flag key
+     * @param defaultValue - Default value if flag not found
+     * @returns Promise<boolean>
+     */
     async isEnabled(key, defaultValue = false) {
-        console.log(`[Togglely SDK] isEnabled("${key}", default=${defaultValue})`);
         const value = await this.getValue(key);
-        console.log(`[Togglely SDK] isEnabled result for "${key}":`, value);
         if (value === null) {
-            console.log(`[Togglely SDK] "${key}" not found, returning default: ${defaultValue}`);
             return defaultValue;
         }
-        const result = value.enabled && value.value === true;
-        console.log(`[Togglely SDK] "${key}" enabled=${value.enabled}, value=${value.value} → returning ${result}`);
-        return result;
+        // enabled is the primary on/off switch for a flag.
+        // value.value holds the flag's configured value (used for non-boolean use-cases).
+        // For boolean flags: if enabled, return the boolean value itself.
+        // If the value is not a boolean (misconfigured), fall back to just enabled.
+        if (typeof value.value === 'boolean') {
+            return value.enabled && value.value;
+        }
+        return value.enabled;
     }
+    /**
+     * Get a string feature flag value
+     * @param key - The flag key
+     * @param defaultValue - Default value if flag not found or disabled
+     * @returns Promise<string>
+     */
     async getString(key, defaultValue = '') {
         const value = await this.getValue(key);
         if (value === null || !value.enabled)
             return defaultValue;
         return String(value.value);
     }
+    /**
+     * Get a number feature flag value
+     * @param key - The flag key
+     * @param defaultValue - Default value if flag not found or disabled
+     * @returns Promise<number>
+     */
     async getNumber(key, defaultValue = 0) {
         const value = await this.getValue(key);
         if (value === null || !value.enabled)
             return defaultValue;
         return Number(value.value);
     }
+    /**
+     * Get a JSON feature flag value
+     * @param key - The flag key
+     * @param defaultValue - Default value if flag not found or disabled
+     * @returns Promise<T>
+     */
     async getJSON(key, defaultValue = {}) {
         const value = await this.getValue(key);
         if (value === null || !value.enabled)
@@ -126,57 +156,43 @@ class TogglelyClient {
         }
         return value.value;
     }
+    /**
+     * Get raw toggle value
+     * @param key - The flag key
+     * @returns Promise<ToggleValue | null>
+     */
     async getValue(key) {
-        // Try cache first - but only if no context is set
-        if (Object.keys(this.context).length === 0) {
-            const cached = this.toggles.get(key);
-            if (cached) {
-                console.log(`[Togglely SDK] Cache hit for "${key}":`, cached);
-                return cached;
-            }
-        }
+        // Note: We intentionally do NOT use cache here to always get fresh values
+        // The cache is only used for offline fallback and getAllToggles()
+        // If you need cached values, use getAllToggles() instead
         // Fetch from server
         try {
             const params = new URLSearchParams();
-            // Send API key as query parameter (required by backend)
-            if (this.config.apiKey)
-                params.set('apiKey', this.config.apiKey);
-            const brandKey = this.context.tenantId || this.context.brandKey;
-            if (brandKey)
-                params.set('tenantId', String(brandKey));
-            // Always send context if available (needed for targeting rules)
+            // Support both brandKey and tenantId for maximum compatibility
+            if (this.context.brandKey)
+                params.set('brandKey', String(this.context.brandKey));
+            if (this.context.tenantId)
+                params.set('tenantId', String(this.context.tenantId));
             if (Object.keys(this.context).length > 0) {
                 params.set('context', JSON.stringify(this.context));
             }
             const query = params.toString() ? `?${params.toString()}` : '';
             const url = `${this.config.baseUrl}/sdk/flags/${encodeURIComponent(this.config.project)}/${encodeURIComponent(this.config.environment)}/${encodeURIComponent(key)}${query}`;
-            console.log(`[Togglely SDK] Fetching: ${url}`);
-            const response = await this.fetchWithTimeout(url, { headers: { 'Content-Type': 'application/json' } });
-            console.log(`[Togglely SDK] Response status: ${response.status}`);
+            const headers = {
+                'Content-Type': 'application/json'
+            };
+            if (this.config.apiKey) {
+                headers['Authorization'] = `Bearer ${this.config.apiKey}`;
+            }
+            const response = await this.fetchWithTimeout(url, { headers });
             if (!response.ok) {
-                // Try to get error details from response
-                let errorBody = '';
-                try {
-                    errorBody = await response.text();
-                    console.error(`[Togglely SDK] Error response body:`, errorBody);
-                }
-                catch { }
                 if (response.status === 404) {
-                    console.log(`[Togglely SDK] Flag "${key}" not found (404)`);
                     return null;
                 }
-                if (response.status === 401) {
-                    console.error(`[Togglely SDK] Authentication failed (401) - Check your API key`);
-                }
-                if (response.status === 403) {
-                    console.error(`[Togglely SDK] Forbidden (403) - Origin not allowed`);
-                }
-                throw new Error(`HTTP ${response.status}: ${errorBody || response.statusText}`);
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
             }
             const data = await response.json();
-            console.log(`[Togglely SDK] Received data for "${key}":`, data);
             this.toggles.set(key, data);
-            // Update state if we were offline
             if (this.state.isOffline) {
                 this.state.isOffline = false;
                 this.emit('online');
@@ -184,20 +200,21 @@ class TogglelyClient {
             return data;
         }
         catch (error) {
-            console.error(`[Togglely SDK] Network/Error for "${key}":`, error.message);
-            // Try offline fallback only if enabled
+            // Try offline fallback
             if (this.config.offlineFallback) {
                 const offlineValue = this.getOfflineToggle(key);
                 if (offlineValue !== null) {
-                    console.log(`[Togglely SDK] Using offline fallback for "${key}":`, offlineValue);
                     return offlineValue;
                 }
             }
-            // Return safe default instead of null
-            console.warn(`[Togglely SDK] Returning default (disabled) for "${key}" due to error`);
+            // Return safe default
             return { value: false, enabled: false };
         }
     }
+    /**
+     * Get all toggles
+     * @returns Record<string, ToggleValue>
+     */
     getAllToggles() {
         const result = {};
         this.toggles.forEach((value, key) => {
@@ -207,12 +224,28 @@ class TogglelyClient {
     }
     // ==================== Offline Fallback ====================
     /**
-     * Load toggles from environment variables
-     * Format: TOGGLELY_<TOGGLE_KEY>=<value> or TOGGLELY_<TOGGLE_KEY>_ENABLED=true
+     * Load offline toggles from multiple sources (in priority order):
+     * 1. Inline offlineToggles from config
+     * 2. JSON file (if offlineJsonPath is set)
+     * 3. window.__TOGGLELY_TOGGLES (browser)
+     * 4. Environment variables (Node.js)
      */
     loadOfflineToggles() {
         try {
-            // Browser environment - check window.__TOGGLELY_TOGGLES
+            // Priority 1: Inline offline toggles from config
+            if (this.config.offlineToggles && Object.keys(this.config.offlineToggles).length > 0) {
+                for (const [key, value] of Object.entries(this.config.offlineToggles)) {
+                    this.toggles.set(key, value);
+                }
+                this.offlineTogglesLoaded = true;
+                console.log('[Togglely] Loaded offline toggles from config');
+                return;
+            }
+            // Priority 2: JSON file (browser only - fetch synchronously not possible, will try async)
+            if (this.config.offlineJsonPath && typeof window !== 'undefined') {
+                this.loadOfflineJsonFile(this.config.offlineJsonPath);
+            }
+            // Priority 3: Browser environment - check window.__TOGGLELY_TOGGLES
             if (typeof window !== 'undefined' && window.__TOGGLELY_TOGGLES) {
                 const offlineToggles = window.__TOGGLELY_TOGGLES;
                 for (const [key, value] of Object.entries(offlineToggles)) {
@@ -222,12 +255,11 @@ class TogglelyClient {
                 console.log('[Togglely] Loaded offline toggles from window.__TOGGLELY_TOGGLES');
                 return;
             }
-            // Node.js / Bun / Deno environment - check process.env
+            // Priority 4: Node.js / Bun / Deno environment - check process.env
             if (typeof process !== 'undefined' && process.env) {
                 const prefix = this.config.envPrefix;
                 for (const [envKey, envValue] of Object.entries(process.env)) {
                     if (envKey?.startsWith(prefix) && envValue !== undefined) {
-                        // Parse toggle key: TOGGLELY_MY_FEATURE -> my-feature
                         const toggleKey = envKey
                             .slice(prefix.length)
                             .toLowerCase()
@@ -243,13 +275,47 @@ class TogglelyClient {
             console.warn('[Togglely] Failed to load offline toggles:', error);
         }
     }
+    /**
+     * Load offline toggles from JSON file (async)
+     */
+    async loadOfflineJsonFile(path) {
+        try {
+            if (typeof window !== 'undefined') {
+                // Browser - fetch the JSON file
+                const response = await fetch(path);
+                if (response.ok) {
+                    const data = await response.json();
+                    for (const [key, value] of Object.entries(data)) {
+                        this.toggles.set(key, this.parseOfflineValue(value));
+                    }
+                    this.offlineTogglesLoaded = true;
+                    console.log('[Togglely] Loaded offline toggles from JSON file:', path);
+                }
+            }
+            else if (typeof require !== 'undefined') {
+                // Node.js - require the JSON file
+                const fs = require('fs');
+                const pathModule = require('path');
+                const fullPath = pathModule.resolve(path);
+                if (fs.existsSync(fullPath)) {
+                    const data = JSON.parse(fs.readFileSync(fullPath, 'utf-8'));
+                    for (const [key, value] of Object.entries(data)) {
+                        this.toggles.set(key, this.parseOfflineValue(value));
+                    }
+                    this.offlineTogglesLoaded = true;
+                    console.log('[Togglely] Loaded offline toggles from JSON file:', fullPath);
+                }
+            }
+        }
+        catch (error) {
+            console.warn('[Togglely] Failed to load offline JSON file:', error);
+        }
+    }
     getOfflineToggle(key) {
         if (!this.config.offlineFallback)
             return null;
-        // Try to get from already loaded offline toggles
         const cached = this.toggles.get(key);
         if (cached) {
-            // If we haven't emitted offline event yet, do it now
             if (!this.state.isOffline) {
                 this.state.isOffline = true;
                 this.emit('offline');
@@ -259,44 +325,47 @@ class TogglelyClient {
         return null;
     }
     parseOfflineValue(value) {
-        // Handle boolean strings
         if (typeof value === 'string') {
             const lower = value.toLowerCase();
             if (lower === 'true')
                 return { value: true, enabled: true };
             if (lower === 'false')
                 return { value: false, enabled: true };
-            // Try to parse as number
             if (!isNaN(Number(value))) {
                 return { value: Number(value), enabled: true };
             }
-            // Try to parse as JSON
             try {
                 const parsed = JSON.parse(value);
                 return { value: parsed, enabled: true };
             }
             catch {
-                // Return as string
                 return { value, enabled: true };
             }
         }
         return { value, enabled: true };
     }
     // ==================== Refresh / Polling ====================
+    /**
+     * Refresh all toggles from the server
+     */
     async refresh() {
         try {
             const params = new URLSearchParams();
-            // Send API key as query parameter (required by backend)
-            if (this.config.apiKey)
-                params.set('apiKey', this.config.apiKey);
-            const brandKey = this.context.tenantId || this.context.brandKey;
-            if (brandKey)
-                params.set('tenantId', String(brandKey));
-            // Always send context if available (needed for targeting rules)
+            // Support both brandKey and tenantId for maximum compatibility
+            if (this.context.brandKey)
+                params.set('brandKey', String(this.context.brandKey));
+            if (this.context.tenantId)
+                params.set('tenantId', String(this.context.tenantId));
             if (Object.keys(this.context).length > 0) {
                 params.set('context', JSON.stringify(this.context));
             }
-            const response = await this.fetchWithTimeout(`${this.config.baseUrl}/sdk/flags/${encodeURIComponent(this.config.project)}/${encodeURIComponent(this.config.environment)}?${params.toString()}`, { headers: { 'Content-Type': 'application/json' } });
+            const headers = {
+                'Content-Type': 'application/json'
+            };
+            if (this.config.apiKey) {
+                headers['Authorization'] = `Bearer ${this.config.apiKey}`;
+            }
+            const response = await this.fetchWithTimeout(`${this.config.baseUrl}/sdk/flags/${encodeURIComponent(this.config.project)}/${encodeURIComponent(this.config.environment)}?${params.toString()}`, { headers });
             if (!response.ok) {
                 throw new Error(`HTTP ${response.status}`);
             }
@@ -311,7 +380,6 @@ class TogglelyClient {
                 this.state.isReady = true;
                 this.emit('ready');
             }
-            // If we were offline, go online
             if (this.state.isOffline) {
                 this.state.isOffline = false;
                 this.emit('online');
@@ -320,7 +388,6 @@ class TogglelyClient {
         }
         catch (error) {
             this.state.lastError = error;
-            // If we have offline toggles, switch to offline mode
             if (this.config.offlineFallback && this.offlineTogglesLoaded) {
                 if (!this.state.isOffline) {
                     this.state.isOffline = true;