@ojolowoblue/lamba 1.0.5 → 1.0.7

package/dist/index.mjs

@@ -2,34 +2,33 @@
 var STORAGE_PRESETS_KEY = "__lamba_presets__";
 var STORAGE_ACTIVE_PRESET_KEY = "__lamba_active_preset__";
 var PresetManager = class {
-  constructor() {
+  constructor(storage) {
     this.presets = [];
     this.activePresetId = null;
+    this.storage = storage;
     this.loadFromStorage();
   }
   loadFromStorage() {
-    if (typeof localStorage === "undefined") return;
     try {
-      const rawPresets = localStorage.getItem(STORAGE_PRESETS_KEY);
+      const rawPresets = this.storage.getItem(STORAGE_PRESETS_KEY);
       if (rawPresets) {
         this.presets = JSON.parse(rawPresets);
       }
-      this.activePresetId = localStorage.getItem(STORAGE_ACTIVE_PRESET_KEY);
+      this.activePresetId = this.storage.getItem(STORAGE_ACTIVE_PRESET_KEY);
     } catch (e) {
-      console.warn("[lamba] Failed to parse presets from localStorage", e);
+      console.warn("[lamba] Failed to parse presets from storage", e);
     }
   }
   saveToStorage() {
-    if (typeof localStorage === "undefined") return;
     try {
-      localStorage.setItem(STORAGE_PRESETS_KEY, JSON.stringify(this.presets));
+      this.storage.setItem(STORAGE_PRESETS_KEY, JSON.stringify(this.presets));
       if (this.activePresetId) {
-        localStorage.setItem(STORAGE_ACTIVE_PRESET_KEY, this.activePresetId);
+        this.storage.setItem(STORAGE_ACTIVE_PRESET_KEY, this.activePresetId);
       } else {
-        localStorage.removeItem(STORAGE_ACTIVE_PRESET_KEY);
+        this.storage.removeItem(STORAGE_ACTIVE_PRESET_KEY);
       }
     } catch (e) {
-      console.warn("[lamba] Failed to save presets to localStorage", e);
+      console.warn("[lamba] Failed to save presets to storage", e);
     }
   }
   getPresets() {
@@ -181,6 +180,99 @@ async function tryFetchRootEnvFile() {
   return {};
 }
 
+// src/core/storage.ts
+var LocalStorageAdapter = class {
+  getItem(key) {
+    try {
+      return typeof localStorage !== "undefined" ? localStorage.getItem(key) : null;
+    } catch {
+      return null;
+    }
+  }
+  setItem(key, value) {
+    try {
+      if (typeof localStorage !== "undefined") localStorage.setItem(key, value);
+    } catch {
+    }
+  }
+  removeItem(key) {
+    try {
+      if (typeof localStorage !== "undefined") localStorage.removeItem(key);
+    } catch {
+    }
+  }
+  clear() {
+    try {
+      if (typeof localStorage !== "undefined") {
+        localStorage.removeItem("__lamba_overrides__");
+        localStorage.removeItem("__lamba_presets__");
+        localStorage.removeItem("__lamba_active_preset__");
+      }
+    } catch {
+    }
+  }
+};
+var SessionStorageAdapter = class {
+  getItem(key) {
+    try {
+      return typeof sessionStorage !== "undefined" ? sessionStorage.getItem(key) : null;
+    } catch {
+      return null;
+    }
+  }
+  setItem(key, value) {
+    try {
+      if (typeof sessionStorage !== "undefined") sessionStorage.setItem(key, value);
+    } catch {
+    }
+  }
+  removeItem(key) {
+    try {
+      if (typeof sessionStorage !== "undefined") sessionStorage.removeItem(key);
+    } catch {
+    }
+  }
+  clear() {
+    try {
+      if (typeof sessionStorage !== "undefined") {
+        sessionStorage.removeItem("__lamba_overrides__");
+        sessionStorage.removeItem("__lamba_presets__");
+        sessionStorage.removeItem("__lamba_active_preset__");
+      }
+    } catch {
+    }
+  }
+};
+var MemoryStorageAdapter = class {
+  constructor() {
+    this.store = /* @__PURE__ */ new Map();
+  }
+  getItem(key) {
+    return this.store.get(key) ?? null;
+  }
+  setItem(key, value) {
+    this.store.set(key, value);
+  }
+  removeItem(key) {
+    this.store.delete(key);
+  }
+  clear() {
+    this.store.clear();
+  }
+};
+function createStorageAdapter(strategy = "local", custom) {
+  if (custom) return custom;
+  switch (strategy) {
+    case "session":
+      return new SessionStorageAdapter();
+    case "memory":
+      return new MemoryStorageAdapter();
+    case "local":
+    default:
+      return new LocalStorageAdapter();
+  }
+}
+
 // src/core/store.ts
 var STORAGE_OVERRIDES_KEY = "__lamba_overrides__";
 var DEFAULT_SECRET_PATTERN = /(KEY|SECRET|TOKEN|PASSWORD|AUTH|PRIVATE|CREDENTIAL|SIGNATURE)/i;
@@ -192,7 +284,8 @@ var EnvStore = class {
     this.storeChangeListeners = /* @__PURE__ */ new Set();
     this.secretPattern = options.secretKeysPattern || DEFAULT_SECRET_PATTERN;
     this.allowedPrefixes = options.allowedPrefixes;
-    this.presetManager = new PresetManager();
+    this.storage = createStorageAdapter(options.storageStrategy ?? "local", options.storage);
+    this.presetManager = new PresetManager(this.storage);
     this.loadOverridesFromStorage();
     if (options.env) {
       this.mergeDefaults(options.env);
@@ -209,22 +302,20 @@ var EnvStore = class {
     this.patchProcessEnv();
   }
   loadOverridesFromStorage() {
-    if (typeof localStorage === "undefined") return;
     try {
-      const stored = localStorage.getItem(STORAGE_OVERRIDES_KEY);
+      const stored = this.storage.getItem(STORAGE_OVERRIDES_KEY);
       if (stored) {
         this.overrides = JSON.parse(stored);
       }
     } catch (e) {
-      console.warn("[lamba] Failed to parse overrides from localStorage", e);
+      console.warn("[lamba] Failed to parse overrides from storage", e);
     }
   }
   saveOverridesToStorage() {
-    if (typeof localStorage === "undefined") return;
     try {
-      localStorage.setItem(STORAGE_OVERRIDES_KEY, JSON.stringify(this.overrides));
+      this.storage.setItem(STORAGE_OVERRIDES_KEY, JSON.stringify(this.overrides));
     } catch (e) {
-      console.warn("[lamba] Failed to save overrides to localStorage", e);
+      console.warn("[lamba] Failed to save overrides to storage", e);
     }
   }
   /**
@@ -1445,7 +1536,10 @@ var LambaManager = class {
       interceptNetworkRequests: true,
       ...options
     };
-    if (this.options.enabled === false) return this;
+    if (this.options.enabled === false) {
+      this.purge(options);
+      return this;
+    }
     this.store = new EnvStore(this.options);
     if (this.options.interceptNetworkRequests !== false) {
       this.networkInterceptor = new NetworkInterceptor(this.store);
@@ -1502,6 +1596,18 @@ var LambaManager = class {
   reset() {
     this.store?.resetAllOverrides();
   }
+  /**
+   * Removes ALL lamba data from storage (overrides, presets, active preset).
+   * Safe to call even when lamba has not been initialized.
+   * Useful when disabling lamba to ensure no stale data remains in the browser.
+   *
+   * @param options - Optionally pass storage options to target the correct adapter.
+   *                  Defaults to 'local' (localStorage) to cover the common case.
+   */
+  purge(options) {
+    const adapter = this.store?.storage ?? createStorageAdapter(options?.storageStrategy ?? "local", options?.storage);
+    adapter.clear();
+  }
   /**
    * Subscribes to environment variable changes.
    */
@@ -1540,6 +1646,9 @@ if (typeof window !== "undefined") {
 var index_default = lamba;
 export {
   LambaManager,
+  LocalStorageAdapter,
+  MemoryStorageAdapter,
+  SessionStorageAdapter,
   index_default as default,
   lamba,
   parseEnvString,