@ojolowoblue/lamba 1.0.4 → 1.0.5

package/README.md

@@ -27,7 +27,7 @@ Deployed via CDN or installed via NPM, `lamba` injects a non-intrusive floating
 Include the script tag in your `index.html` file before your application bundle:
 
 ```html
-<script src="https://unpkg.com/@ojolowoblue/lamba"></script>
+<script src="https://unpkg.com/@ojolowoblue/lamba" data-lamba-auto></script>
 ```
 
 That's it! A floating settings button (⚙️) will automatically appear in the bottom-right corner of your web page.
@@ -52,11 +52,11 @@ import lamba from '@ojolowoblue/lamba';
 lamba.init({
   position: 'bottom-right',
   env: {
-    // Supports any env prefix (VITE_, NEXT_PUBLIC_, REACT_APP_, VUE_APP_, PUBLIC_) or custom keys:
+    // Supports any data type (strings, numbers, booleans, objects) & any prefix:
     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',
+    PORT: 3000,
+    VITE_ENABLE_ANALYTICS: true,
+    FEATURE_FLAGS: { newCheckout: true },
   },
 });
 ```
@@ -88,7 +88,7 @@ Wrap your existing `import.meta.env` (Vite) or `process.env` (Webpack/Next.js) o
 // src/config.ts
 import lamba from '@ojolowoblue/lamba';
 
-// Wrap your env object in a dynamic ES Proxy
+// Wrap your env object in a dynamic ES Proxy (preserves primitive boolean & number types!)
 export const env = lamba.wrap(import.meta.env);
 
 // Access keys anywhere in your application:
@@ -121,15 +121,15 @@ import React from 'react';
 import { useLambaEnv } from '@ojolowoblue/lamba/react';
 
 export function UserDashboard() {
-  const apiBase = useLambaEnv('VITE_API_BASE_URL', 'https://api.dev.com');
-  const showBetaFeature = useLambaEnv('VITE_FEATURE_BETA_UI', 'false');
+  const apiBase = useLambaEnv<string>('VITE_API_BASE_URL', 'https://api.dev.com');
+  const isBetaEnabled = useLambaEnv<boolean>('VITE_FEATURE_BETA_UI', false);
 
   return (
     <div style={{ padding: '24px' }}>
       <h1>Dashboard</h1>
       <p>Connected Environment: <code>{apiBase}</code></p>
       
-      {showBetaFeature === 'true' && (
+      {isBetaEnabled && (
         <div className="beta-banner">
           🚀 Beta UI Enabled Live via lamba!
         </div>
@@ -147,14 +147,14 @@ Import `useLambaEnv` from `lamba/vue` as a reactive composition Vue Ref:
 <script setup lang="ts">
 import { useLambaEnv } from '@ojolowoblue/lamba/vue';
 
-const apiBase = useLambaEnv('VITE_API_BASE_URL', 'https://api.dev.com');
-const featureFlag = useLambaEnv('VITE_NEW_HEADER', 'false');
+const apiBase = useLambaEnv<string>('VITE_API_BASE_URL', 'https://api.dev.com');
+const isNewHeader = useLambaEnv<boolean>('VITE_NEW_HEADER', false);
 </script>
 
 <template>
   <div class="container">
     <h2>Current Backend: {{ apiBase }}</h2>
-    <header v-if="featureFlag === 'true'">
+    <header v-if="isNewHeader">
       <h3>✨ New Header Component</h3>
     </header>
   </div>
@@ -171,7 +171,7 @@ Initializes the lamba manager, hydrates saved overrides from `localStorage`, ena
 
 | Option | Type | Default | Description |
 | :--- | :--- | :--- | :--- |
-| `env` | `Record<string, string>` | `{}` | Initial default key-value pairs of environment variables. |
+| `env` | `Record<string, any>` | `{}` | Initial default key-value pairs of environment variables (supports strings, numbers, booleans, objects). |
 | `enabled` | `boolean` | `true` | Set to `false` to disable lamba (e.g. in production builds). |
 | `position` | `'bottom-right' \| 'bottom-left' \| 'top-right' \| 'top-left'` | `'bottom-right'` | Screen position for the floating widget launcher button. |
 | `secretKeysPattern` | `RegExp` | `/(KEY\|SECRET\|TOKEN\|PASSWORD\|AUTH\|PRIVATE)/i` | Regular expression to automatically obscure sensitive keys in the UI. |
@@ -183,11 +183,11 @@ Initializes the lamba manager, hydrates saved overrides from `localStorage`, ena
 
 ### Core Methods
 
-#### `lamba.get(key: string, fallback?: string): string`
-Returns the active value for the specified environment key (returns active override if present, otherwise default value or fallback).
+#### `lamba.get<T = any>(key: string, fallback?: T): T`
+Returns the active value for the specified environment key (returns active override if present, otherwise default value or fallback). Preserves numbers, booleans, and objects.
 
-#### `lamba.set(key: string, value: string): void`
-Programmatically overrides an environment variable live at runtime. The change is persisted in `localStorage` and triggers UI and listener updates.
+#### `lamba.set(key: string, value: any): void`
+Programmatically overrides an environment variable live at runtime with any data type. The change is persisted in `localStorage` and triggers UI and listener updates.
 
 #### `lamba.remove(key: string): void`
 Removes an override for a specific environment variable key, reverting it to its default value.

package/dist/index.d.mts

@@ -1,21 +1,21 @@
 interface EnvVariable {
     key: string;
-    value: string;
-    defaultValue: string;
+    value: any;
+    defaultValue: any;
     isOverridden: boolean;
     isSecret?: boolean;
 }
 interface PresetProfile {
     id: string;
     name: string;
-    overrides: Record<string, string>;
+    overrides: Record<string, any>;
     createdAt: number;
 }
 interface LambaOptions {
     /**
-     * Initial environment variable key-values to supply to lamba.
+     * Initial environment variable key-values to supply to lamba. Accepts strings, numbers, booleans, objects, etc.
      */
-    env?: Record<string, string>;
+    env?: Record<string, any>;
     /**
      * Whether lamba floating UI is enabled. Defaults to true in non-production or when specified.
      */
@@ -47,7 +47,7 @@ interface LambaOptions {
      */
     allowedPrefixes?: string | string[] | RegExp | null;
 }
-type EnvChangeListener = (key: string, value: string, isOverridden: boolean) => void;
+type EnvChangeListener = (key: string, value: any, isOverridden: boolean) => void;
 type StoreChangeListener = (variables: Record<string, EnvVariable>, presets: PresetProfile[], activePresetId: string | null) => void;
 
 /**
@@ -70,7 +70,7 @@ declare class LambaManager {
      * Implicit ES Proxy object where properties like `lamba.env.VITE_API_BASE_URL`
      * return the live active overridden value automatically.
      */
-    env: Record<string, string>;
+    env: Record<string, any>;
     constructor();
     /**
      * Wraps any environment object (such as `import.meta.env` or `process.env`)
@@ -84,11 +84,11 @@ declare class LambaManager {
     /**
      * Gets the active value of an environment variable (returns overridden value if active, otherwise default).
      */
-    get(key: string, fallback?: string): string;
+    get<T = any>(key: string, fallback?: T): T;
     /**
      * Overrides an environment variable live at runtime.
      */
-    set(key: string, value: string): void;
+    set(key: string, value: any): void;
     /**
      * Removes an override for a specific environment variable key.
      */

package/dist/index.d.ts

@@ -1,21 +1,21 @@
 interface EnvVariable {
     key: string;
-    value: string;
-    defaultValue: string;
+    value: any;
+    defaultValue: any;
     isOverridden: boolean;
     isSecret?: boolean;
 }
 interface PresetProfile {
     id: string;
     name: string;
-    overrides: Record<string, string>;
+    overrides: Record<string, any>;
     createdAt: number;
 }
 interface LambaOptions {
     /**
-     * Initial environment variable key-values to supply to lamba.
+     * Initial environment variable key-values to supply to lamba. Accepts strings, numbers, booleans, objects, etc.
      */
-    env?: Record<string, string>;
+    env?: Record<string, any>;
     /**
      * Whether lamba floating UI is enabled. Defaults to true in non-production or when specified.
      */
@@ -47,7 +47,7 @@ interface LambaOptions {
      */
     allowedPrefixes?: string | string[] | RegExp | null;
 }
-type EnvChangeListener = (key: string, value: string, isOverridden: boolean) => void;
+type EnvChangeListener = (key: string, value: any, isOverridden: boolean) => void;
 type StoreChangeListener = (variables: Record<string, EnvVariable>, presets: PresetProfile[], activePresetId: string | null) => void;
 
 /**
@@ -70,7 +70,7 @@ declare class LambaManager {
      * Implicit ES Proxy object where properties like `lamba.env.VITE_API_BASE_URL`
      * return the live active overridden value automatically.
      */
-    env: Record<string, string>;
+    env: Record<string, any>;
     constructor();
     /**
      * Wraps any environment object (such as `import.meta.env` or `process.env`)
@@ -84,11 +84,11 @@ declare class LambaManager {
     /**
      * Gets the active value of an environment variable (returns overridden value if active, otherwise default).
      */
-    get(key: string, fallback?: string): string;
+    get<T = any>(key: string, fallback?: T): T;
     /**
      * Overrides an environment variable live at runtime.
      */
-    set(key: string, value: string): void;
+    set(key: string, value: any): void;
     /**
      * Removes an override for a specific environment variable key.
      */

package/dist/index.js

@@ -307,9 +307,9 @@ var EnvStore = class {
     let changed = false;
     for (const [key, rawDefault] of Object.entries(env)) {
       if (!this.isAllowedKey(key)) continue;
-      const defaultValue = rawDefault !== null && rawDefault !== void 0 ? String(rawDefault) : "";
+      const defaultValue = rawDefault;
       const isOverridden = key in this.overrides;
-      const currentValue = isOverridden ? String(this.overrides[key] ?? "") : defaultValue;
+      const currentValue = isOverridden ? this.overrides[key] : defaultValue;
       const isSecret = this.secretPattern.test(key);
       const existing = this.variables.get(key);
       if (!existing) {
@@ -1363,7 +1363,15 @@ var ModalUI = class {
     `;
     const inputEl = card.querySelector(".var-input");
     inputEl.addEventListener("change", () => {
-      this.store.setOverride(varItem.key, inputEl.value);
+      let val = inputEl.value;
+      if (typeof varItem.defaultValue === "boolean") {
+        if (val === "true") val = true;
+        else if (val === "false") val = false;
+      } else if (typeof varItem.defaultValue === "number") {
+        const num = Number(val);
+        if (!isNaN(num) && val.trim() !== "") val = num;
+      }
+      this.store.setOverride(varItem.key, val);
     });
     card.querySelector(".toggle-secret-btn")?.addEventListener("click", () => {
       this.secretVisibilityMap.set(varItem.key, !isVisible);
@@ -1376,7 +1384,8 @@ var ModalUI = class {
   }
   escapeHtml(str) {
     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;");
+    const text = typeof str === "object" ? JSON.stringify(str) : String(str);
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
   }
 };
 
@@ -1399,7 +1408,7 @@ var LambaManager = class {
       },
       set(_target, prop, value) {
         if (typeof prop === "string") {
-          self.set(prop, String(value));
+          self.set(prop, value);
           return true;
         }
         return false;
@@ -1418,9 +1427,7 @@ var LambaManager = class {
       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);
-          }
+          defaultObj[k] = v;
         }
         if (Object.keys(defaultObj).length > 0) {
           this.store.mergeDefaults(defaultObj);
@@ -1434,10 +1441,24 @@ var LambaManager = class {
         if (typeof prop === "string") {
           const overrideVal = self.get(prop);
           if (overrideVal !== void 0 && overrideVal !== "") {
+            const targetVal = Reflect.get(target, prop);
+            if (typeof targetVal === "boolean") {
+              if (overrideVal === "true" || overrideVal === true) return true;
+              if (overrideVal === "false" || overrideVal === false) return false;
+            } else if (typeof targetVal === "number" && typeof overrideVal === "string") {
+              const num = Number(overrideVal);
+              if (!isNaN(num)) return num;
+            }
             return overrideVal;
           }
         }
         return Reflect.get(target, prop);
+      },
+      set(target, prop, value) {
+        if (typeof prop === "string") {
+          self.set(prop, value);
+        }
+        return Reflect.set(target, prop, value);
       }
     });
   }
@@ -1490,7 +1511,7 @@ var LambaManager = class {
     if (!this.store) {
       this.init();
     }
-    return this.store?.get(key, fallback) ?? fallback ?? "";
+    return this.store?.get(key, fallback) ?? fallback;
   }
   /**
    * Overrides an environment variable live at runtime.