@astermind/cybernetic-chatbot-client 1.0.6 → 1.0.9

package/dist/cybernetic-chatbot-client.umd.js

@@ -2016,6 +2016,8 @@ LJ5AZXvOhHaXdHzMuYKX5BpK4w7TqbPvJ6QPvKmLKvHh1VKcUJ6mJQgJJw==
 
     // src/config.ts
     // Configuration loading and validation
+    /** Default API URL when not specified */
+    const DEFAULT_API_URL = 'https://api.astermind.ai';
     /**
      * Validate configuration
      */
@@ -2036,30 +2038,169 @@ LJ5AZXvOhHaXdHzMuYKX5BpK4w7TqbPvJ6QPvKmLKvHh1VKcUJ6mJQgJJw==
         return true;
     }
     /**
-     * Load config from window.astermindConfig or script tag data attributes
+     * Load config from Node.js process.env (for bundlers that replace process.env)
      */
-    function loadConfig() {
+    function loadFromProcessEnv() {
+        // Check if process.env exists (Node.js or bundler-injected)
+        if (typeof process === 'undefined' || !process.env) {
+            return null;
+        }
+        // Check for ASTERMIND_RAG_* env vars (non-prefixed, for Node.js/server environments)
+        const apiKey = process.env.ASTERMIND_RAG_API_KEY;
+        const apiUrl = process.env.ASTERMIND_RAG_API_SERVER_URL;
+        if (apiKey) {
+            return {
+                apiKey,
+                apiUrl: apiUrl || DEFAULT_API_URL,
+                _source: 'env'
+            };
+        }
+        // Check for CRA-style REACT_APP_* env vars
+        const craApiKey = process.env.REACT_APP_ASTERMIND_RAG_API_KEY;
+        const craApiUrl = process.env.REACT_APP_ASTERMIND_RAG_API_SERVER_URL;
+        if (craApiKey) {
+            return {
+                apiKey: craApiKey,
+                apiUrl: craApiUrl || DEFAULT_API_URL,
+                _source: 'env'
+            };
+        }
+        return null;
+    }
+    /**
+     * Load config from Vite's import.meta.env (browser environment)
+     * Note: This only works at build time when Vite replaces the variables
+     */
+    function loadFromViteEnv() {
+        // Check for window.__ASTERMIND_CONFIG__ (SSR-injected config)
+        if (typeof window !== 'undefined') {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const injected = window.__ASTERMIND_CONFIG__;
+            if (injected && typeof injected === 'object' && injected.apiKey) {
+                return {
+                    ...injected,
+                    apiUrl: injected.apiUrl || DEFAULT_API_URL,
+                    _source: 'vite'
+                };
+            }
+        }
+        // Check for Vite's import.meta.env (replaced at build time)
+        // Note: TypeScript doesn't know about import.meta.env, so we use a try-catch
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const importMeta = globalThis.import?.meta?.env;
+            if (importMeta) {
+                const apiKey = importMeta.VITE_ASTERMIND_RAG_API_KEY;
+                const apiUrl = importMeta.VITE_ASTERMIND_RAG_API_SERVER_URL;
+                if (apiKey) {
+                    return {
+                        apiKey,
+                        apiUrl: apiUrl || DEFAULT_API_URL,
+                        _source: 'vite'
+                    };
+                }
+            }
+        }
+        catch {
+            // import.meta not available in this environment
+        }
+        return null;
+    }
+    /**
+     * Load config from window.astermindConfig global object
+     */
+    function loadFromGlobalObject() {
         if (typeof window === 'undefined') {
             return null;
         }
-        // Check for global config object
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        if (window.astermindConfig) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const config = window.astermindConfig;
-            validateConfig(config);
-            return config;
+        const globalConfig = window.astermindConfig;
+        if (globalConfig && typeof globalConfig === 'object' && globalConfig.apiKey) {
+            return {
+                ...globalConfig,
+                apiUrl: globalConfig.apiUrl || DEFAULT_API_URL,
+                _source: 'window'
+            };
+        }
+        return null;
+    }
+    /**
+     * Load config from script tag data attributes
+     */
+    function loadFromScriptAttributes() {
+        if (typeof window === 'undefined' || typeof document === 'undefined') {
+            return null;
         }
-        // Check for script tag with data attributes
         const script = document.querySelector('script[data-astermind-key]');
         if (script) {
-            return {
-                apiUrl: script.getAttribute('data-astermind-url') || 'https://api.astermind.ai',
-                apiKey: script.getAttribute('data-astermind-key') || ''
-            };
+            const apiKey = script.getAttribute('data-astermind-key');
+            if (apiKey) {
+                return {
+                    apiKey,
+                    apiUrl: script.getAttribute('data-astermind-url') || DEFAULT_API_URL,
+                    _source: 'data-attr'
+                };
+            }
         }
         return null;
     }
+    /**
+     * Load config using priority-based fallback chain:
+     * 1. Environment variables (process.env - for bundlers/Node.js)
+     * 2. Vite environment variables (import.meta.env or window.__ASTERMIND_CONFIG__)
+     * 3. Global object (window.astermindConfig)
+     * 4. Script data attributes (data-astermind-key, data-astermind-url)
+     *
+     * @param options - Configuration options
+     * @param options.throwOnMissingKey - If true (default), throws when no API key found. If false, returns null and logs a warning.
+     * @returns Configuration object or null if not found and throwOnMissingKey is false
+     */
+    function loadConfig(options = {}) {
+        const { throwOnMissingKey = true } = options;
+        // Priority 1: Environment variables (Node.js/bundler)
+        const envConfig = loadFromProcessEnv();
+        if (envConfig) {
+            return envConfig;
+        }
+        // Priority 2: Vite environment variables / SSR-injected config
+        const viteConfig = loadFromViteEnv();
+        if (viteConfig) {
+            return viteConfig;
+        }
+        // Priority 3: Global object (window.astermindConfig)
+        const globalConfig = loadFromGlobalObject();
+        if (globalConfig) {
+            validateConfig(globalConfig);
+            return globalConfig;
+        }
+        // Priority 4: Script data attributes
+        const scriptConfig = loadFromScriptAttributes();
+        if (scriptConfig) {
+            return scriptConfig;
+        }
+        // No config found
+        if (throwOnMissingKey) {
+            throw new Error('AsterMind API key is required. Configure using one of these methods:\n' +
+                '  1. Set VITE_ASTERMIND_RAG_API_KEY environment variable (Vite)\n' +
+                '  2. Set REACT_APP_ASTERMIND_RAG_API_KEY environment variable (CRA)\n' +
+                '  3. Set window.astermindConfig = { apiKey: "am_...", apiUrl: "..." }\n' +
+                '  4. Add data-astermind-key attribute to your script tag\n' +
+                '  5. Pass apiKey directly to createClient() or CyberneticClient constructor');
+        }
+        else {
+            console.warn('[AsterMind] No API key found. Chatbot will not function until configured.');
+            return null;
+        }
+    }
+    /**
+     * Export individual loaders for testing and advanced use cases
+     */
+    const configLoaders = {
+        loadFromProcessEnv,
+        loadFromViteEnv,
+        loadFromGlobalObject,
+        loadFromScriptAttributes
+    };
 
     // src/agentic/CyberneticIntentClassifier.ts
     // Hybrid intent classification for agentic capabilities
@@ -3275,6 +3416,7 @@ LJ5AZXvOhHaXdHzMuYKX5BpK4w7TqbPvJ6QPvKmLKvHh1VKcUJ6mJQgJJw==
     exports.CyberneticLocalRAG = CyberneticLocalRAG;
     exports.LicenseManager = LicenseManager;
     exports.REQUIRED_FEATURES = REQUIRED_FEATURES;
+    exports.configLoaders = configLoaders;
     exports.createClient = createClient;
     exports.createLicenseManager = createLicenseManager;
     exports.detectEnvironment = detectEnvironment;