@dropout-ai/runtime 0.3.11 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dropout-ai/runtime",
-  "version": "0.3.11",
+  "version": "0.4.0",
   "description": "Invisible Node.js runtime for understanding behavoiral impact of AI interactions.",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/index.js

@@ -17,7 +17,27 @@ const KNOWN_AI_DOMAINS = [
 ];
 
 class Dropout {
+  // Singleton Instance Storage
+  static instance = null;
+
+  /**
+   * Universal Initialization Method (Idempotent)
+   * Users call this explicitly in their code.
+   */
+  static init(config) {
+    if (!Dropout.instance) {
+      new Dropout(config);
+    }
+    return Dropout.instance;
+  }
+
   constructor(config = {}) {
+    // 🛡️ SINGLETON GUARD (Prevent multiple initializations)
+    if (Dropout.instance) {
+      if (config.debug) console.log("[Dropout] ℹ️ Already initialized. Returning existing instance.");
+      return Dropout.instance;
+    }
+
     // 🛡️ 1. BROWSER GUARD (Client-Side Protection)
     if (typeof window !== 'undefined' && typeof window.document !== 'undefined') {
       if (config.debug) console.warn("[Dropout] ⚠️ Skipped: Browser detected. SDK is Server-Only.");
@@ -26,7 +46,9 @@ class Dropout {
 
     // 🛡️ 2. CREDENTIAL GUARD
     if (!config.apiKey || !config.projectId) {
-      if (config.debug) console.warn("[Dropout] ⚠️ Skipped: Missing API Key or Project ID.");
+      if (config.debug) {
+        console.warn("\x1b[31m%s\x1b[0m", "[Dropout] 🔴 Initialization Failed: Missing API Key or Project ID.");
+      }
       return;
     }
 
@@ -56,9 +78,10 @@ class Dropout {
       this.lastPromptHash = null;
       this.lastResponseHash = null;
 
-      // Singleton Guard
+      // Global Guard (Extra safety for HMR environments like Next.js)
       if (global.__dropout_initialized__) {
-        if (this.debug) console.log("[Dropout] ℹ️ Already initialized.");
+        if (this.debug) console.log("[Dropout] ℹ️ Global flag found. Skipping re-initialization.");
+        Dropout.instance = this; // Re-bind if lost
         return;
       }
       global.__dropout_initialized__ = true;
@@ -68,7 +91,10 @@ class Dropout {
         global.__dropout_session_id__ = this.generateSessionId();
       }
 
-      if (this.debug) console.log(`[Dropout] 🟢 Online: ${this.projectId}`);
+      // ✅ VISUAL SUCCESS INDICATOR
+      if (this.debug) {
+        console.log('\x1b[32m%s\x1b[0m', `[Dropout] 🟢 Online | Project: ${this.projectId}`);
+      }
 
       // Bindings
       this.log = this.log.bind(this);
@@ -77,10 +103,12 @@ class Dropout {
       // 4. Start Network Interceptor
       this.patchNetwork();
 
-      // 5. SEND STARTUP PING (Always run this, silent by default)
-      // This turns the dashboard status GREEN immediately on app boot.
+      // 5. SEND STARTUP PING
       this.sendStartupSignal();
 
+      // Lock the instance
+      Dropout.instance = this;
+
     } catch (err) {
       // THE ULTIMATE CATCH-ALL: Ensure app NEVER crashes
       if (config.debug) console.error("[Dropout] ❌ Initialization Error:", err);
@@ -108,7 +136,6 @@ class Dropout {
       turn_role: 'system',
       turn_index: 0,
       content: 'Dropout SDK Initialized',
-      // content_blob: 'Dropout SDK Initialized',
       metadata_flags: {
         type: 'system_boot',
         environment: process.env.NODE_ENV || 'development',
@@ -185,7 +212,6 @@ class Dropout {
         model: payload.model,
         latency_ms: payload.latency_ms || null,
         content: payload.content,
-        // content_blob: payload.content,
         content_hash: payload.content_hash,
         metadata_flags: payload.metadata_flags,
         received_at: new Date().toISOString()
@@ -409,9 +435,9 @@ class Dropout {
   }
 }
 
-// Auto-Start (Server-Side Only)
+// Auto-Start (Backwards Compatibility & Environment Variable Support)
 if (typeof process !== 'undefined' && process.env.DROPOUT_PROJECT_ID && process.env.DROPOUT_API_KEY) {
-  new Dropout({
+  Dropout.init({
     projectId: process.env.DROPOUT_PROJECT_ID,
     apiKey: process.env.DROPOUT_API_KEY,
     debug: process.env.DROPOUT_DEBUG === 'true'