@vacantthinker/firefox-addon-framework-easy 2026.615.1133 → 2026.615.1148

package/dist/opStorage.d.ts

@@ -9,15 +9,19 @@ export declare function stoOpCheck(key: string): Promise<boolean>;
  * @param key The key to retrieve.
  * @returns Promise resolving to the stored value or null if not found.
  */
-export declare function stoOpGet<T = any>(key: string): Promise<T | null>;
+export declare function stoOpGet<T>(key: string): Promise<T | null>;
 /**
  * Retrieves all items from local storage.
  * @returns Promise resolving to an object containing all storage items.
  */
-export declare function stoOpGetAll<T = Record<string, any>>(): Promise<T>;
+export declare function stoOpGetAll<T extends Record<string, unknown>>(): Promise<T>;
+/**
+ * Clears all data from local storage.
+ */
 export declare function stoOpClear(): Promise<void>;
 /**
  * Queries keys that start with a specific prefix.
+ * WARNING: This loads all storage into memory. Use sparingly on large datasets.
  * @param prefix The prefix to filter keys.
  * @returns Promise resolving to an array of matching keys.
  */
@@ -25,9 +29,9 @@ export declare function stoOpQueryStartWith(prefix: string): Promise<string[]>;
 /**
  * Sets a value in local storage.
  * @param key The key to set.
- * @param value The value to store.
+ * @param value The value to store. Must be JSON-serializable.
  */
-export declare function stoOpSet(key: string, value: any): Promise<void>;
+export declare function stoOpSet<T = unknown>(key: string, value: T): Promise<void>;
 /**
  * Removes a key from local storage.
  * @param key The key to remove.

package/dist/opStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opStorage.d.ts","sourceRoot":"","sources":["../src/opStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG9D;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKtE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAGvE;AAED,wBAAsB,UAAU,kBAE/B;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAI3E;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,GACT,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7D"}
+{"version":3,"file":"opStorage.d.ts","sourceRoot":"","sources":["../src/opStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI9D;AAED;;;;GAIG;AAEH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKhE;AAED;;;GAGG;AAEH,wBAAsB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAKjF;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhD;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ3E;AAED;;;;GAIG;AAGH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D"}

package/dist/opStorage.js

@@ -5,16 +5,18 @@
  */
 export async function stoOpCheck(key) {
     const result = await browser.storage.local.get(key);
-    return key in result;
+    // FIX: Protects against prototype pollution (e.g., key = "constructor")
+    return Object.prototype.hasOwnProperty.call(result, key);
 }
 /**
  * Retrieves a value from local storage by key.
  * @param key The key to retrieve.
  * @returns Promise resolving to the stored value or null if not found.
  */
+// FIX: Removed default `any`. Forces the caller to specify the expected type.
 export async function stoOpGet(key) {
     const result = await browser.storage.local.get(key);
-    return result[key] !== undefined ?
+    return Object.prototype.hasOwnProperty.call(result, key) ?
         result[key] :
         null;
 }
@@ -22,30 +24,50 @@ export async function stoOpGet(key) {
  * Retrieves all items from local storage.
  * @returns Promise resolving to an object containing all storage items.
  */
+// FIX: Narrowed generic constraint to ensure it returns an object structure.
 export async function stoOpGetAll() {
-    const result = await browser.storage.local.get();
+    const result = await browser.storage.local.get(null); // Explicitly passing
+    // null is safer in
+    // some MV3 contexts
     return result;
 }
+/**
+ * Clears all data from local storage.
+ */
 export async function stoOpClear() {
     await browser.storage.local.clear();
 }
 /**
  * Queries keys that start with a specific prefix.
+ * WARNING: This loads all storage into memory. Use sparingly on large datasets.
  * @param prefix The prefix to filter keys.
  * @returns Promise resolving to an array of matching keys.
  */
 export async function stoOpQueryStartWith(prefix) {
-    const allItems = await browser.storage.local.get();
-    return Object.keys(allItems)
-        .filter((key) => key.startsWith(prefix));
+    try {
+        const allItems = await browser.storage.local.get(null);
+        return Object.keys(allItems).filter((key) => key.startsWith(prefix));
+    }
+    catch (error) {
+        console.error(`stoOpQueryStartWith failed. Storage might be too large:`, error);
+        return [];
+    }
 }
 /**
  * Sets a value in local storage.
  * @param key The key to set.
- * @param value The value to store.
+ * @param value The value to store. Must be JSON-serializable.
  */
+// FIX: Replaced `any` with `unknown` to prevent reckless assignments without
+// type checking.
 export async function stoOpSet(key, value) {
-    await browser.storage.local.set({ [key]: value });
+    try {
+        await browser.storage.local.set({ [key]: value });
+    }
+    catch (error) {
+        console.error(`stoOpSet failed to write key "${key}". Quota exceeded?`, error);
+        throw error;
+    }
 }
 /**
  * Removes a key from local storage.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vacantthinker/firefox-addon-framework-easy",
-  "version": "2026.0615.1133",
+  "version": "2026.0615.1148",
   "description": "",
   "type": "module",
   "main": "dist/index.js",