@ojolowoblue/lamba 1.0.2 → 1.0.4

package/README.md

@@ -1,6 +1,6 @@
 # lamba ⚡
 
-**`lamba`** is a universal, lightweight developer tool and browser widget for viewing, overriding, and swapping environment variables live in web applications (React, Vue, Next.js, Vite, Astro, Svelte, or Vanilla HTML/JS)—**without touching source code, restarting dev servers, or editing `.env` files.**
+**`lamba`** is a universal, lightweight developer tool and browser widget for viewing, overriding, and swapping environment variables live in web applications—supporting **all framework prefixes** (`VITE_`, `NEXT_PUBLIC_`, `REACT_APP_`, `VUE_APP_`, `PUBLIC_`, `EXPO_PUBLIC_`, `NUXT_`, `GATSBY_`, or unprefixed keys) across React, Vue, Next.js, Vite, Create React App, Astro, Nuxt, Svelte, or Vanilla HTML/JS—**without touching source code, restarting dev servers, or editing `.env` files.**
 
 Deployed via CDN or installed via NPM, `lamba` injects a non-intrusive floating UI powered by **Shadow DOM encapsulation**. Devs, QA engineers, and project managers can test multiple API environments, toggle feature flags, switch authentication tokens, and swap backend clusters on the fly directly in the browser.
 
@@ -9,6 +9,7 @@ Deployed via CDN or installed via NPM, `lamba` injects a non-intrusive floating
 ## 🌟 Key Features
 
 - ⚡ **Zero-Setup CDN & NPM Support**: Add a single `<script>` tag or install via NPM/Yarn/PNPM.
+- 🌐 **Universal Framework & Prefix Support**: Works out of the box with any env variable prefix (`VITE_`, `NEXT_PUBLIC_`, `REACT_APP_`, `VUE_APP_`, `PUBLIC_`, `EXPO_PUBLIC_`, `NUXT_`, `GATSBY_`) or unprefixed variables.
 - 🛡️ **Shadow DOM Encapsulation**: Modern glassmorphism UI rendered inside a Custom Element (`<lamba-widget>`), ensuring zero CSS style leakage into or out of your app.
 - 🌐 **Automatic Network Interception**: Automatically intercepts outbound `fetch()` and `XMLHttpRequest` calls hitting default base URLs and redirects them to your live active environment overrides on the fly.
 - 🎛️ **Preset Profile Manager**: Save named environment snapshots (e.g., *Staging API*, *Local Mock Server*, *QA Test Suite*, *Production Read-Only*) and switch between them with one click.
@@ -51,9 +52,11 @@ import lamba from '@ojolowoblue/lamba';
 lamba.init({
   position: 'bottom-right',
   env: {
-    VITE_API_BASE_URL: 'https://api.dev.example.com',
-    VITE_FEATURE_NEW_CHECKOUT: 'false',
+    // Supports any env prefix (VITE_, NEXT_PUBLIC_, REACT_APP_, VUE_APP_, PUBLIC_) or custom keys:
+    NEXT_PUBLIC_API_URL: 'https://api.dev.example.com',
+    REACT_APP_FEATURE_FLAG: 'false',
     VITE_ENABLE_ANALYTICS: 'true',
+    API_BASE_URL: 'https://api.dev.example.com',
   },
 });
 ```
@@ -174,6 +177,7 @@ Initializes the lamba manager, hydrates saved overrides from `localStorage`, ena
 | `secretKeysPattern` | `RegExp` | `/(KEY\|SECRET\|TOKEN\|PASSWORD\|AUTH\|PRIVATE)/i` | Regular expression to automatically obscure sensitive keys in the UI. |
 | `autoFetchEnvFile` | `boolean` | `false` | Whether to attempt fetching root `/.env` file during local development. |
 | `interceptNetworkRequests` | `boolean` | `true` | Whether to implicitly intercept `fetch` & `XHR` calls matching original base URLs. |
+| `allowedPrefixes` | `string \| string[] \| RegExp \| null` | `null` | Optional prefix filter (e.g. `['VITE_', 'NEXT_PUBLIC_']`). Omitting allows ALL keys regardless of prefix. |
 
 ---
 

package/dist/index.d.mts

@@ -41,6 +41,11 @@ interface LambaOptions {
      * Defaults to true.
      */
     interceptNetworkRequests?: boolean;
+    /**
+     * Optional prefix filter or array of prefixes to include (e.g. ['VITE_', 'NEXT_PUBLIC_', 'REACT_APP_']).
+     * If omitted, null, or empty, ALL environment variable keys are allowed and supported regardless of prefix.
+     */
+    allowedPrefixes?: string | string[] | RegExp | null;
 }
 type EnvChangeListener = (key: string, value: string, isOverridden: boolean) => void;
 type StoreChangeListener = (variables: Record<string, EnvVariable>, presets: PresetProfile[], activePresetId: string | null) => void;

package/dist/index.d.ts

@@ -41,6 +41,11 @@ interface LambaOptions {
      * Defaults to true.
      */
     interceptNetworkRequests?: boolean;
+    /**
+     * Optional prefix filter or array of prefixes to include (e.g. ['VITE_', 'NEXT_PUBLIC_', 'REACT_APP_']).
+     * If omitted, null, or empty, ALL environment variable keys are allowed and supported regardless of prefix.
+     */
+    allowedPrefixes?: string | string[] | RegExp | null;
 }
 type EnvChangeListener = (key: string, value: string, isOverridden: boolean) => void;
 type StoreChangeListener = (variables: Record<string, EnvVariable>, presets: PresetProfile[], activePresetId: string | null) => void;

package/dist/index.js

@@ -136,25 +136,41 @@ function stringifyEnv(env) {
 function autoDiscoverBrowserEnv() {
   const discovered = {};
   if (typeof window === "undefined") return discovered;
+  const extractPrimitiveProps = (obj) => {
+    if (!obj || typeof obj !== "object") return;
+    for (const [k, v] of Object.entries(obj)) {
+      if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
+        discovered[k] = String(v);
+      }
+    }
+  };
   try {
     const winProcess = window.process;
     if (winProcess && winProcess.env && typeof winProcess.env === "object") {
-      for (const [k, v] of Object.entries(winProcess.env)) {
-        if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
-          discovered[k] = String(v);
-        }
-      }
+      extractPrimitiveProps(winProcess.env);
     }
   } catch (e) {
   }
   try {
-    const customEnv = window.__ENV__ || window.ENV;
-    if (customEnv && typeof customEnv === "object") {
-      for (const [k, v] of Object.entries(customEnv)) {
-        if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
-          discovered[k] = String(v);
-        }
-      }
+    const nextData = window.__NEXT_DATA__;
+    if (nextData) {
+      if (nextData.env) extractPrimitiveProps(nextData.env);
+      if (nextData.runtimeConfig?.public) extractPrimitiveProps(nextData.runtimeConfig.public);
+    }
+  } catch (e) {
+  }
+  try {
+    const nuxtData = window.__NUXT__;
+    if (nuxtData?.config?.public) {
+      extractPrimitiveProps(nuxtData.config.public);
+    }
+  } catch (e) {
+  }
+  try {
+    const win = window;
+    const customEnv = win.__ENV__ || win.ENV || win.PUBLIC_ENV || win.__LAMBA_ENV__;
+    if (customEnv) {
+      extractPrimitiveProps(customEnv);
     }
   } catch (e) {
   }
@@ -205,6 +221,7 @@ var EnvStore = class {
     this.envChangeListeners = /* @__PURE__ */ new Set();
     this.storeChangeListeners = /* @__PURE__ */ new Set();
     this.secretPattern = options.secretKeysPattern || DEFAULT_SECRET_PATTERN;
+    this.allowedPrefixes = options.allowedPrefixes;
     this.presetManager = new PresetManager();
     this.loadOverridesFromStorage();
     if (options.env) {
@@ -241,7 +258,6 @@ var EnvStore = class {
     }
   }
   /**
-   * Monkey-patches window.process.env to reactively return overridden values.
    */
   patchProcessEnv() {
     if (typeof window === "undefined") return;
@@ -270,11 +286,30 @@ var EnvStore = class {
     } catch (e) {
     }
   }
+  /**
+   * Checks if an environment variable key satisfies the allowedPrefixes option.
+   */
+  isAllowedKey(key) {
+    if (!this.allowedPrefixes) return true;
+    if (typeof this.allowedPrefixes === "string") {
+      return key.startsWith(this.allowedPrefixes);
+    }
+    if (Array.isArray(this.allowedPrefixes)) {
+      if (this.allowedPrefixes.length === 0) return true;
+      return this.allowedPrefixes.some((p) => key.startsWith(p));
+    }
+    if (this.allowedPrefixes instanceof RegExp) {
+      return this.allowedPrefixes.test(key);
+    }
+    return true;
+  }
   mergeDefaults(env) {
     let changed = false;
-    for (const [key, defaultValue] of Object.entries(env)) {
+    for (const [key, rawDefault] of Object.entries(env)) {
+      if (!this.isAllowedKey(key)) continue;
+      const defaultValue = rawDefault !== null && rawDefault !== void 0 ? String(rawDefault) : "";
       const isOverridden = key in this.overrides;
-      const currentValue = isOverridden ? this.overrides[key] : defaultValue;
+      const currentValue = isOverridden ? String(this.overrides[key] ?? "") : defaultValue;
       const isSecret = this.secretPattern.test(key);
       const existing = this.variables.get(key);
       if (!existing) {
@@ -459,9 +494,12 @@ var NetworkInterceptor = class {
     const allVars = this.store.getAll();
     let resultUrl = url;
     for (const varObj of Object.values(allVars)) {
-      if (varObj.isOverridden && varObj.defaultValue && varObj.value) {
-        const defaultBase = varObj.defaultValue.replace(/\/+$/, "");
-        const overrideBase = varObj.value.replace(/\/+$/, "");
+      if (varObj.isOverridden && varObj.defaultValue !== void 0 && varObj.value !== void 0) {
+        const rawDefault = String(varObj.defaultValue ?? "");
+        const rawOverride = String(varObj.value ?? "");
+        if (!rawDefault || !rawOverride) continue;
+        const defaultBase = rawDefault.replace(/\/+$/, "");
+        const overrideBase = rawOverride.replace(/\/+$/, "");
         if (defaultBase && resultUrl.includes(defaultBase)) {
           resultUrl = resultUrl.replace(defaultBase, overrideBase);
         }
@@ -1154,7 +1192,7 @@ var ModalUI = class {
       </div>
     `;
     footer.querySelector(".lamba-add-var-btn")?.addEventListener("click", () => {
-      const key = prompt("Enter new environment variable key name (e.g. VITE_API_URL):");
+      const key = prompt("Enter new environment variable key name (e.g. API_URL, NEXT_PUBLIC_API_URL, REACT_APP_API_URL, VITE_API_URL):");
       if (key) {
         const value = prompt(`Enter value for ${key}:`) || "";
         this.store.setOverride(key, value);
@@ -1337,7 +1375,8 @@ var ModalUI = class {
     return card;
   }
   escapeHtml(str) {
-    return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
+    if (str === null || str === void 0) return "";
+    return String(str).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
   }
 };
 
@@ -1372,6 +1411,23 @@ var LambaManager = class {
    * in a dynamic proxy that implicitly resolves live overrides from lamba.
    */
   wrap(targetEnv) {
+    if (!this.store) {
+      this.init();
+    }
+    if (targetEnv && typeof targetEnv === "object" && this.store) {
+      try {
+        const defaultObj = {};
+        for (const [k, v] of Object.entries(targetEnv)) {
+          if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
+            defaultObj[k] = String(v);
+          }
+        }
+        if (Object.keys(defaultObj).length > 0) {
+          this.store.mergeDefaults(defaultObj);
+        }
+      } catch (e) {
+      }
+    }
     const self = this;
     return new Proxy(targetEnv, {
       get(target, prop) {
@@ -1485,8 +1541,8 @@ var LambaManager = class {
 var lamba = new LambaManager();
 if (typeof window !== "undefined") {
   window.lamba = lamba;
-  const isCdnScript = document.currentScript !== null || !!document.querySelector('script[src*="lamba"]');
-  if (isCdnScript) {
+  const currentScript = document.currentScript;
+  if (currentScript && (currentScript.hasAttribute("data-lamba-auto") || currentScript.hasAttribute("data-auto-init"))) {
     lamba.init();
   }
 }