@metamask-previews/storage-service 1.0.2-preview-3866c0ff1 → 1.0.2-preview-e3275932a

package/CHANGELOG.md

@@ -9,7 +9,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- **BREAKING:** Bump minimum Node.js version to 22 ([#9168](https://github.com/MetaMask/core/pull/9168))
 - Bump `@metamask/utils` from `^11.9.0` to `^11.11.0` ([#9074](https://github.com/MetaMask/core/pull/9074))
 - Bump `@metamask/messenger` from `^1.2.0` to `^2.0.0` ([#9392](https://github.com/MetaMask/core/pull/9392))
 

package/dist/InMemoryStorageAdapter.cjs

@@ -0,0 +1,148 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _InMemoryStorageAdapter_storage;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryStorageAdapter = void 0;
+const types_js_1 = require("./types.cjs");
+/**
+ * In-memory storage adapter (default fallback).
+ * Implements the {@link StorageAdapter} interface using a Map.
+ *
+ * ⚠️ **Warning**: Data is NOT persisted - lost on restart.
+ *
+ * **Suitable for:**
+ * - Testing (isolated, no mocking needed)
+ * - Development (quick start, zero config)
+ * - Temporary/ephemeral data
+ *
+ * **Not suitable for:**
+ * - Production (unless data is truly ephemeral)
+ * - Data that needs to persist across restarts
+ *
+ * @example Basic usage
+ * ```typescript
+ * const adapter = new InMemoryStorageAdapter();
+ * await adapter.setItem('SnapController', 'snap-id:sourceCode', 'const x = 1;');
+ * const value = await adapter.getItem('SnapController', 'snap-id:sourceCode'); // 'const x = 1;'
+ * // After restart: data is lost
+ * ```
+ *
+ * @example Initialize with data (useful for testing)
+ * ```typescript
+ * const adapter = new InMemoryStorageAdapter({
+ *   SnapController: {
+ *     'snap-id:sourceCode': 'const x = 1;',
+ *     'snap-id:manifest': { name: 'My Snap' },
+ *   },
+ *   TokenListController: {
+ *     cache: { '0x1': ['token1', 'token2'] },
+ *   },
+ * });
+ * ```
+ */
+class InMemoryStorageAdapter {
+    /**
+     * Constructs a new InMemoryStorageAdapter.
+     *
+     * @param initialData - Optional initial data to populate the storage.
+     * Useful for setting up test fixtures without calling setItem multiple times.
+     */
+    constructor(initialData) {
+        // Explicitly implement StorageAdapter interface
+        /**
+         * Internal storage map.
+         */
+        _InMemoryStorageAdapter_storage.set(this, void 0);
+        __classPrivateFieldSet(this, _InMemoryStorageAdapter_storage, new Map(), "f");
+        if (initialData) {
+            for (const [namespace, items] of Object.entries(initialData)) {
+                for (const [key, value] of Object.entries(items)) {
+                    const fullKey = `${types_js_1.STORAGE_KEY_PREFIX}${namespace}:${key}`;
+                    __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").set(fullKey, JSON.stringify(value));
+                }
+            }
+        }
+    }
+    /**
+     * Retrieve an item from in-memory storage.
+     * Deserializes JSON data from storage.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @returns StorageGetResult: { result } if found, {} if not found, { error } on failure.
+     */
+    async getItem(namespace, key) {
+        const fullKey = `${types_js_1.STORAGE_KEY_PREFIX}${namespace}:${key}`;
+        const serialized = __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").get(fullKey);
+        // Key not found - return empty object
+        if (serialized === undefined) {
+            return {};
+        }
+        try {
+            const result = JSON.parse(serialized);
+            return { result };
+        }
+        catch (error) {
+            console.error(`Failed to parse stored data for ${fullKey}:`, error);
+            return { error: error };
+        }
+    }
+    /**
+     * Store an item in in-memory storage.
+     * Serializes JSON data to string.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @param value - The JSON value to store.
+     */
+    async setItem(namespace, key, value) {
+        const fullKey = `${types_js_1.STORAGE_KEY_PREFIX}${namespace}:${key}`;
+        __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").set(fullKey, JSON.stringify(value));
+    }
+    /**
+     * Remove an item from in-memory storage.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     */
+    async removeItem(namespace, key) {
+        const fullKey = `${types_js_1.STORAGE_KEY_PREFIX}${namespace}:${key}`;
+        __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").delete(fullKey);
+    }
+    /**
+     * Get all keys for a namespace.
+     * Returns keys without the 'storage:namespace:' prefix.
+     *
+     * @param namespace - The namespace to get keys for.
+     * @returns Array of keys (without prefix) for this namespace.
+     */
+    async getAllKeys(namespace) {
+        const prefix = `${types_js_1.STORAGE_KEY_PREFIX}${namespace}:`;
+        return Array.from(__classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").keys())
+            .filter((key) => key.startsWith(prefix))
+            .map((key) => key.slice(prefix.length));
+    }
+    /**
+     * Clear all items for a namespace.
+     *
+     * @param namespace - The namespace to clear.
+     */
+    async clear(namespace) {
+        const prefix = `${types_js_1.STORAGE_KEY_PREFIX}${namespace}:`;
+        const keysToDelete = Array.from(__classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").keys()).filter((key) => key.startsWith(prefix));
+        keysToDelete.forEach((key) => __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").delete(key));
+    }
+}
+exports.InMemoryStorageAdapter = InMemoryStorageAdapter;
+_InMemoryStorageAdapter_storage = new WeakMap();
+//# sourceMappingURL=InMemoryStorageAdapter.cjs.map

package/dist/InMemoryStorageAdapter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStorageAdapter.cjs","sourceRoot":"","sources":["../src/InMemoryStorageAdapter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Json } from '@metamask/utils';\n\nimport type {\n  InitialStorageData,\n  StorageAdapter,\n  StorageGetResult,\n} from './types.js';\nimport { STORAGE_KEY_PREFIX } from './types.js';\n\n/**\n * In-memory storage adapter (default fallback).\n * Implements the {@link StorageAdapter} interface using a Map.\n *\n * ⚠️ **Warning**: Data is NOT persisted - lost on restart.\n *\n * **Suitable for:**\n * - Testing (isolated, no mocking needed)\n * - Development (quick start, zero config)\n * - Temporary/ephemeral data\n *\n * **Not suitable for:**\n * - Production (unless data is truly ephemeral)\n * - Data that needs to persist across restarts\n *\n * @example Basic usage\n * ```typescript\n * const adapter = new InMemoryStorageAdapter();\n * await adapter.setItem('SnapController', 'snap-id:sourceCode', 'const x = 1;');\n * const value = await adapter.getItem('SnapController', 'snap-id:sourceCode'); // 'const x = 1;'\n * // After restart: data is lost\n * ```\n *\n * @example Initialize with data (useful for testing)\n * ```typescript\n * const adapter = new InMemoryStorageAdapter({\n *   SnapController: {\n *     'snap-id:sourceCode': 'const x = 1;',\n *     'snap-id:manifest': { name: 'My Snap' },\n *   },\n *   TokenListController: {\n *     cache: { '0x1': ['token1', 'token2'] },\n *   },\n * });\n * ```\n */\nexport class InMemoryStorageAdapter implements StorageAdapter {\n  // Explicitly implement StorageAdapter interface\n  /**\n   * Internal storage map.\n   */\n  readonly #storage: Map<string, string>;\n\n  /**\n   * Constructs a new InMemoryStorageAdapter.\n   *\n   * @param initialData - Optional initial data to populate the storage.\n   * Useful for setting up test fixtures without calling setItem multiple times.\n   */\n  constructor(initialData?: InitialStorageData) {\n    this.#storage = new Map();\n\n    if (initialData) {\n      for (const [namespace, items] of Object.entries(initialData)) {\n        for (const [key, value] of Object.entries(items)) {\n          const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n          this.#storage.set(fullKey, JSON.stringify(value));\n        }\n      }\n    }\n  }\n\n  /**\n   * Retrieve an item from in-memory storage.\n   * Deserializes JSON data from storage.\n   *\n   * @param namespace - The controller namespace.\n   * @param key - The data key.\n   * @returns StorageGetResult: { result } if found, {} if not found, { error } on failure.\n   */\n  async getItem(namespace: string, key: string): Promise<StorageGetResult> {\n    const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n    const serialized = this.#storage.get(fullKey);\n\n    // Key not found - return empty object\n    if (serialized === undefined) {\n      return {};\n    }\n\n    try {\n      const result = JSON.parse(serialized);\n      return { result };\n    } catch (error) {\n      console.error(`Failed to parse stored data for ${fullKey}:`, error);\n      return { error: error as Error };\n    }\n  }\n\n  /**\n   * Store an item in in-memory storage.\n   * Serializes JSON data to string.\n   *\n   * @param namespace - The controller namespace.\n   * @param key - The data key.\n   * @param value - The JSON value to store.\n   */\n  async setItem(namespace: string, key: string, value: Json): Promise<void> {\n    const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n    this.#storage.set(fullKey, JSON.stringify(value));\n  }\n\n  /**\n   * Remove an item from in-memory storage.\n   *\n   * @param namespace - The controller namespace.\n   * @param key - The data key.\n   */\n  async removeItem(namespace: string, key: string): Promise<void> {\n    const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n    this.#storage.delete(fullKey);\n  }\n\n  /**\n   * Get all keys for a namespace.\n   * Returns keys without the 'storage:namespace:' prefix.\n   *\n   * @param namespace - The namespace to get keys for.\n   * @returns Array of keys (without prefix) for this namespace.\n   */\n  async getAllKeys(namespace: string): Promise<string[]> {\n    const prefix = `${STORAGE_KEY_PREFIX}${namespace}:`;\n    return Array.from(this.#storage.keys())\n      .filter((key) => key.startsWith(prefix))\n      .map((key) => key.slice(prefix.length));\n  }\n\n  /**\n   * Clear all items for a namespace.\n   *\n   * @param namespace - The namespace to clear.\n   */\n  async clear(namespace: string): Promise<void> {\n    const prefix = `${STORAGE_KEY_PREFIX}${namespace}:`;\n    const keysToDelete = Array.from(this.#storage.keys()).filter((key) =>\n      key.startsWith(prefix),\n    );\n    keysToDelete.forEach((key) => this.#storage.delete(key));\n  }\n}\n"]}

package/dist/{InMemoryStorageAdapter.d.ts → InMemoryStorageAdapter.d.cts}

@@ -1,5 +1,5 @@
-import type { Json } from '@metamask/utils';
-import type { InitialStorageData, StorageAdapter, StorageGetResult } from './types.js';
+import type { Json } from "@metamask/utils";
+import type { InitialStorageData, StorageAdapter, StorageGetResult } from "./types.cjs";
 /**
  * In-memory storage adapter (default fallback).
  * Implements the {@link StorageAdapter} interface using a Map.
@@ -85,4 +85,4 @@ export declare class InMemoryStorageAdapter implements StorageAdapter {
      */
     clear(namespace: string): Promise<void>;
 }
-//# sourceMappingURL=InMemoryStorageAdapter.d.ts.map
+//# sourceMappingURL=InMemoryStorageAdapter.d.cts.map

package/dist/InMemoryStorageAdapter.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStorageAdapter.d.cts","sourceRoot":"","sources":["../src/InMemoryStorageAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EACjB,oBAAmB;AAGpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,sBAAuB,YAAW,cAAc;;IAO3D;;;;;OAKG;gBACS,WAAW,CAAC,EAAE,kBAAkB;IAa5C;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkBxE;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/D;;;;;;OAMG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOtD;;;;OAIG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO9C"}

package/dist/InMemoryStorageAdapter.d.mts

@@ -0,0 +1,88 @@
+import type { Json } from "@metamask/utils";
+import type { InitialStorageData, StorageAdapter, StorageGetResult } from "./types.mjs";
+/**
+ * In-memory storage adapter (default fallback).
+ * Implements the {@link StorageAdapter} interface using a Map.
+ *
+ * ⚠️ **Warning**: Data is NOT persisted - lost on restart.
+ *
+ * **Suitable for:**
+ * - Testing (isolated, no mocking needed)
+ * - Development (quick start, zero config)
+ * - Temporary/ephemeral data
+ *
+ * **Not suitable for:**
+ * - Production (unless data is truly ephemeral)
+ * - Data that needs to persist across restarts
+ *
+ * @example Basic usage
+ * ```typescript
+ * const adapter = new InMemoryStorageAdapter();
+ * await adapter.setItem('SnapController', 'snap-id:sourceCode', 'const x = 1;');
+ * const value = await adapter.getItem('SnapController', 'snap-id:sourceCode'); // 'const x = 1;'
+ * // After restart: data is lost
+ * ```
+ *
+ * @example Initialize with data (useful for testing)
+ * ```typescript
+ * const adapter = new InMemoryStorageAdapter({
+ *   SnapController: {
+ *     'snap-id:sourceCode': 'const x = 1;',
+ *     'snap-id:manifest': { name: 'My Snap' },
+ *   },
+ *   TokenListController: {
+ *     cache: { '0x1': ['token1', 'token2'] },
+ *   },
+ * });
+ * ```
+ */
+export declare class InMemoryStorageAdapter implements StorageAdapter {
+    #private;
+    /**
+     * Constructs a new InMemoryStorageAdapter.
+     *
+     * @param initialData - Optional initial data to populate the storage.
+     * Useful for setting up test fixtures without calling setItem multiple times.
+     */
+    constructor(initialData?: InitialStorageData);
+    /**
+     * Retrieve an item from in-memory storage.
+     * Deserializes JSON data from storage.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @returns StorageGetResult: { result } if found, {} if not found, { error } on failure.
+     */
+    getItem(namespace: string, key: string): Promise<StorageGetResult>;
+    /**
+     * Store an item in in-memory storage.
+     * Serializes JSON data to string.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @param value - The JSON value to store.
+     */
+    setItem(namespace: string, key: string, value: Json): Promise<void>;
+    /**
+     * Remove an item from in-memory storage.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     */
+    removeItem(namespace: string, key: string): Promise<void>;
+    /**
+     * Get all keys for a namespace.
+     * Returns keys without the 'storage:namespace:' prefix.
+     *
+     * @param namespace - The namespace to get keys for.
+     * @returns Array of keys (without prefix) for this namespace.
+     */
+    getAllKeys(namespace: string): Promise<string[]>;
+    /**
+     * Clear all items for a namespace.
+     *
+     * @param namespace - The namespace to clear.
+     */
+    clear(namespace: string): Promise<void>;
+}
+//# sourceMappingURL=InMemoryStorageAdapter.d.mts.map

package/dist/InMemoryStorageAdapter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStorageAdapter.d.mts","sourceRoot":"","sources":["../src/InMemoryStorageAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EACjB,oBAAmB;AAGpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,sBAAuB,YAAW,cAAc;;IAO3D;;;;;OAKG;gBACS,WAAW,CAAC,EAAE,kBAAkB;IAa5C;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkBxE;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/D;;;;;;OAMG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOtD;;;;OAIG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO9C"}

package/dist/{InMemoryStorageAdapter.js → InMemoryStorageAdapter.mjs}

@@ -1,4 +1,16 @@
-import { STORAGE_KEY_PREFIX } from './types.js';
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _InMemoryStorageAdapter_storage;
+import { STORAGE_KEY_PREFIX } from "./types.mjs";
 /**
  * In-memory storage adapter (default fallback).
  * Implements the {@link StorageAdapter} interface using a Map.
@@ -36,11 +48,6 @@ import { STORAGE_KEY_PREFIX } from './types.js';
  * ```
  */
 export class InMemoryStorageAdapter {
-    // Explicitly implement StorageAdapter interface
-    /**
-     * Internal storage map.
-     */
-    #storage;
     /**
      * Constructs a new InMemoryStorageAdapter.
      *
@@ -48,12 +55,17 @@ export class InMemoryStorageAdapter {
      * Useful for setting up test fixtures without calling setItem multiple times.
      */
     constructor(initialData) {
-        this.#storage = new Map();
+        // Explicitly implement StorageAdapter interface
+        /**
+         * Internal storage map.
+         */
+        _InMemoryStorageAdapter_storage.set(this, void 0);
+        __classPrivateFieldSet(this, _InMemoryStorageAdapter_storage, new Map(), "f");
         if (initialData) {
             for (const [namespace, items] of Object.entries(initialData)) {
                 for (const [key, value] of Object.entries(items)) {
                     const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;
-                    this.#storage.set(fullKey, JSON.stringify(value));
+                    __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").set(fullKey, JSON.stringify(value));
                 }
             }
         }
@@ -68,7 +80,7 @@ export class InMemoryStorageAdapter {
      */
     async getItem(namespace, key) {
         const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;
-        const serialized = this.#storage.get(fullKey);
+        const serialized = __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").get(fullKey);
         // Key not found - return empty object
         if (serialized === undefined) {
             return {};
@@ -92,7 +104,7 @@ export class InMemoryStorageAdapter {
      */
     async setItem(namespace, key, value) {
         const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;
-        this.#storage.set(fullKey, JSON.stringify(value));
+        __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").set(fullKey, JSON.stringify(value));
     }
     /**
      * Remove an item from in-memory storage.
@@ -102,7 +114,7 @@ export class InMemoryStorageAdapter {
      */
     async removeItem(namespace, key) {
         const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;
-        this.#storage.delete(fullKey);
+        __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").delete(fullKey);
     }
     /**
      * Get all keys for a namespace.
@@ -113,7 +125,7 @@ export class InMemoryStorageAdapter {
      */
     async getAllKeys(namespace) {
         const prefix = `${STORAGE_KEY_PREFIX}${namespace}:`;
-        return Array.from(this.#storage.keys())
+        return Array.from(__classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").keys())
             .filter((key) => key.startsWith(prefix))
             .map((key) => key.slice(prefix.length));
     }
@@ -124,8 +136,9 @@ export class InMemoryStorageAdapter {
      */
     async clear(namespace) {
         const prefix = `${STORAGE_KEY_PREFIX}${namespace}:`;
-        const keysToDelete = Array.from(this.#storage.keys()).filter((key) => key.startsWith(prefix));
-        keysToDelete.forEach((key) => this.#storage.delete(key));
+        const keysToDelete = Array.from(__classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").keys()).filter((key) => key.startsWith(prefix));
+        keysToDelete.forEach((key) => __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").delete(key));
     }
 }
-//# sourceMappingURL=InMemoryStorageAdapter.js.map
+_InMemoryStorageAdapter_storage = new WeakMap();
+//# sourceMappingURL=InMemoryStorageAdapter.mjs.map

package/dist/InMemoryStorageAdapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStorageAdapter.mjs","sourceRoot":"","sources":["../src/InMemoryStorageAdapter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Json } from '@metamask/utils';\n\nimport type {\n  InitialStorageData,\n  StorageAdapter,\n  StorageGetResult,\n} from './types.js';\nimport { STORAGE_KEY_PREFIX } from './types.js';\n\n/**\n * In-memory storage adapter (default fallback).\n * Implements the {@link StorageAdapter} interface using a Map.\n *\n * ⚠️ **Warning**: Data is NOT persisted - lost on restart.\n *\n * **Suitable for:**\n * - Testing (isolated, no mocking needed)\n * - Development (quick start, zero config)\n * - Temporary/ephemeral data\n *\n * **Not suitable for:**\n * - Production (unless data is truly ephemeral)\n * - Data that needs to persist across restarts\n *\n * @example Basic usage\n * ```typescript\n * const adapter = new InMemoryStorageAdapter();\n * await adapter.setItem('SnapController', 'snap-id:sourceCode', 'const x = 1;');\n * const value = await adapter.getItem('SnapController', 'snap-id:sourceCode'); // 'const x = 1;'\n * // After restart: data is lost\n * ```\n *\n * @example Initialize with data (useful for testing)\n * ```typescript\n * const adapter = new InMemoryStorageAdapter({\n *   SnapController: {\n *     'snap-id:sourceCode': 'const x = 1;',\n *     'snap-id:manifest': { name: 'My Snap' },\n *   },\n *   TokenListController: {\n *     cache: { '0x1': ['token1', 'token2'] },\n *   },\n * });\n * ```\n */\nexport class InMemoryStorageAdapter implements StorageAdapter {\n  // Explicitly implement StorageAdapter interface\n  /**\n   * Internal storage map.\n   */\n  readonly #storage: Map<string, string>;\n\n  /**\n   * Constructs a new InMemoryStorageAdapter.\n   *\n   * @param initialData - Optional initial data to populate the storage.\n   * Useful for setting up test fixtures without calling setItem multiple times.\n   */\n  constructor(initialData?: InitialStorageData) {\n    this.#storage = new Map();\n\n    if (initialData) {\n      for (const [namespace, items] of Object.entries(initialData)) {\n        for (const [key, value] of Object.entries(items)) {\n          const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n          this.#storage.set(fullKey, JSON.stringify(value));\n        }\n      }\n    }\n  }\n\n  /**\n   * Retrieve an item from in-memory storage.\n   * Deserializes JSON data from storage.\n   *\n   * @param namespace - The controller namespace.\n   * @param key - The data key.\n   * @returns StorageGetResult: { result } if found, {} if not found, { error } on failure.\n   */\n  async getItem(namespace: string, key: string): Promise<StorageGetResult> {\n    const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n    const serialized = this.#storage.get(fullKey);\n\n    // Key not found - return empty object\n    if (serialized === undefined) {\n      return {};\n    }\n\n    try {\n      const result = JSON.parse(serialized);\n      return { result };\n    } catch (error) {\n      console.error(`Failed to parse stored data for ${fullKey}:`, error);\n      return { error: error as Error };\n    }\n  }\n\n  /**\n   * Store an item in in-memory storage.\n   * Serializes JSON data to string.\n   *\n   * @param namespace - The controller namespace.\n   * @param key - The data key.\n   * @param value - The JSON value to store.\n   */\n  async setItem(namespace: string, key: string, value: Json): Promise<void> {\n    const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n    this.#storage.set(fullKey, JSON.stringify(value));\n  }\n\n  /**\n   * Remove an item from in-memory storage.\n   *\n   * @param namespace - The controller namespace.\n   * @param key - The data key.\n   */\n  async removeItem(namespace: string, key: string): Promise<void> {\n    const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n    this.#storage.delete(fullKey);\n  }\n\n  /**\n   * Get all keys for a namespace.\n   * Returns keys without the 'storage:namespace:' prefix.\n   *\n   * @param namespace - The namespace to get keys for.\n   * @returns Array of keys (without prefix) for this namespace.\n   */\n  async getAllKeys(namespace: string): Promise<string[]> {\n    const prefix = `${STORAGE_KEY_PREFIX}${namespace}:`;\n    return Array.from(this.#storage.keys())\n      .filter((key) => key.startsWith(prefix))\n      .map((key) => key.slice(prefix.length));\n  }\n\n  /**\n   * Clear all items for a namespace.\n   *\n   * @param namespace - The namespace to clear.\n   */\n  async clear(namespace: string): Promise<void> {\n    const prefix = `${STORAGE_KEY_PREFIX}${namespace}:`;\n    const keysToDelete = Array.from(this.#storage.keys()).filter((key) =>\n      key.startsWith(prefix),\n    );\n    keysToDelete.forEach((key) => this.#storage.delete(key));\n  }\n}\n"]}

package/dist/StorageService-method-action-types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=StorageService-method-action-types.cjs.map

package/dist/StorageService-method-action-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageService-method-action-types.cjs","sourceRoot":"","sources":["../src/StorageService-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { StorageService } from './StorageService.js';\n\n/**\n * Store large JSON data in storage.\n *\n * ⚠️ **Designed for large values (100KB+), not many small ones.**\n * Each storage operation has I/O overhead. For best performance,\n * store one large object rather than many small key-value pairs.\n *\n * @example Good: Store entire cache as one value\n * ```typescript\n * await service.setItem('TokenList', 'cache', { '0x1': [...], '0x38': [...] });\n * ```\n *\n * @example Avoid: Many small values\n * ```typescript\n * // ❌ Don't do this - too many small writes\n * await service.setItem('TokenList', 'cache:0x1', [...]);\n * await service.setItem('TokenList', 'cache:0x38', [...]);\n * ```\n *\n * @param namespace - Controller namespace (e.g., 'SnapController').\n * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').\n * @param value - JSON data to store (should be 100KB+ for optimal use).\n */\nexport type StorageServiceSetItemAction = {\n  type: `StorageService:setItem`;\n  handler: StorageService['setItem'];\n};\n\n/**\n * Retrieve JSON data from storage.\n *\n * @param namespace - Controller namespace (e.g., 'SnapController').\n * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').\n * @returns StorageGetResult: { result } if found, {} if not found, { error } on failure.\n */\nexport type StorageServiceGetItemAction = {\n  type: `StorageService:getItem`;\n  handler: StorageService['getItem'];\n};\n\n/**\n * Remove data from storage.\n *\n * @param namespace - Controller namespace (e.g., 'SnapController').\n * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').\n */\nexport type StorageServiceRemoveItemAction = {\n  type: `StorageService:removeItem`;\n  handler: StorageService['removeItem'];\n};\n\n/**\n * Get all keys for a namespace.\n * Delegates to storage adapter which handles filtering.\n *\n * @param namespace - Controller namespace (e.g., 'SnapController').\n * @returns Array of keys (without prefix) for this namespace.\n */\nexport type StorageServiceGetAllKeysAction = {\n  type: `StorageService:getAllKeys`;\n  handler: StorageService['getAllKeys'];\n};\n\n/**\n * Clear all data for a namespace.\n *\n * @param namespace - Controller namespace (e.g., 'SnapController').\n */\nexport type StorageServiceClearAction = {\n  type: `StorageService:clear`;\n  handler: StorageService['clear'];\n};\n\n/**\n * Union of all StorageService action types.\n */\nexport type StorageServiceMethodActions =\n  | StorageServiceSetItemAction\n  | StorageServiceGetItemAction\n  | StorageServiceRemoveItemAction\n  | StorageServiceGetAllKeysAction\n  | StorageServiceClearAction;\n"]}

package/dist/{StorageService-method-action-types.d.ts → StorageService-method-action-types.d.cts}

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { StorageService } from './StorageService.js';
+import type { StorageService } from "./StorageService.cjs";
 /**
  * Store large JSON data in storage.
  *
@@ -75,4 +75,4 @@ export type StorageServiceClearAction = {
  * Union of all StorageService action types.
  */
 export type StorageServiceMethodActions = StorageServiceSetItemAction | StorageServiceGetItemAction | StorageServiceRemoveItemAction | StorageServiceGetAllKeysAction | StorageServiceClearAction;
-//# sourceMappingURL=StorageService-method-action-types.d.ts.map
+//# sourceMappingURL=StorageService-method-action-types.d.cts.map

package/dist/StorageService-method-action-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageService-method-action-types.d.cts","sourceRoot":"","sources":["../src/StorageService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,6BAA4B;AAE1D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GACnC,2BAA2B,GAC3B,2BAA2B,GAC3B,8BAA8B,GAC9B,8BAA8B,GAC9B,yBAAyB,CAAC"}

package/dist/StorageService-method-action-types.d.mts

@@ -0,0 +1,78 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { StorageService } from "./StorageService.mjs";
+/**
+ * Store large JSON data in storage.
+ *
+ * ⚠️ **Designed for large values (100KB+), not many small ones.**
+ * Each storage operation has I/O overhead. For best performance,
+ * store one large object rather than many small key-value pairs.
+ *
+ * @example Good: Store entire cache as one value
+ * ```typescript
+ * await service.setItem('TokenList', 'cache', { '0x1': [...], '0x38': [...] });
+ * ```
+ *
+ * @example Avoid: Many small values
+ * ```typescript
+ * // ❌ Don't do this - too many small writes
+ * await service.setItem('TokenList', 'cache:0x1', [...]);
+ * await service.setItem('TokenList', 'cache:0x38', [...]);
+ * ```
+ *
+ * @param namespace - Controller namespace (e.g., 'SnapController').
+ * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').
+ * @param value - JSON data to store (should be 100KB+ for optimal use).
+ */
+export type StorageServiceSetItemAction = {
+    type: `StorageService:setItem`;
+    handler: StorageService['setItem'];
+};
+/**
+ * Retrieve JSON data from storage.
+ *
+ * @param namespace - Controller namespace (e.g., 'SnapController').
+ * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').
+ * @returns StorageGetResult: { result } if found, {} if not found, { error } on failure.
+ */
+export type StorageServiceGetItemAction = {
+    type: `StorageService:getItem`;
+    handler: StorageService['getItem'];
+};
+/**
+ * Remove data from storage.
+ *
+ * @param namespace - Controller namespace (e.g., 'SnapController').
+ * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').
+ */
+export type StorageServiceRemoveItemAction = {
+    type: `StorageService:removeItem`;
+    handler: StorageService['removeItem'];
+};
+/**
+ * Get all keys for a namespace.
+ * Delegates to storage adapter which handles filtering.
+ *
+ * @param namespace - Controller namespace (e.g., 'SnapController').
+ * @returns Array of keys (without prefix) for this namespace.
+ */
+export type StorageServiceGetAllKeysAction = {
+    type: `StorageService:getAllKeys`;
+    handler: StorageService['getAllKeys'];
+};
+/**
+ * Clear all data for a namespace.
+ *
+ * @param namespace - Controller namespace (e.g., 'SnapController').
+ */
+export type StorageServiceClearAction = {
+    type: `StorageService:clear`;
+    handler: StorageService['clear'];
+};
+/**
+ * Union of all StorageService action types.
+ */
+export type StorageServiceMethodActions = StorageServiceSetItemAction | StorageServiceGetItemAction | StorageServiceRemoveItemAction | StorageServiceGetAllKeysAction | StorageServiceClearAction;
+//# sourceMappingURL=StorageService-method-action-types.d.mts.map

package/dist/StorageService-method-action-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageService-method-action-types.d.mts","sourceRoot":"","sources":["../src/StorageService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,6BAA4B;AAE1D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GACnC,2BAA2B,GAC3B,2BAA2B,GAC3B,8BAA8B,GAC9B,8BAA8B,GAC9B,yBAAyB,CAAC"}

package/dist/{StorageService-method-action-types.js → StorageService-method-action-types.mjs}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=StorageService-method-action-types.js.map
+//# sourceMappingURL=StorageService-method-action-types.mjs.map

package/dist/StorageService-method-action-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageService-method-action-types.mjs","sourceRoot":"","sources":["../src/StorageService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { StorageService } from './StorageService.js';\n\n/**\n * Store large JSON data in storage.\n *\n * ⚠️ **Designed for large values (100KB+), not many small ones.**\n * Each storage operation has I/O overhead. For best performance,\n * store one large object rather than many small key-value pairs.\n *\n * @example Good: Store entire cache as one value\n * ```typescript\n * await service.setItem('TokenList', 'cache', { '0x1': [...], '0x38': [...] });\n * ```\n *\n * @example Avoid: Many small values\n * ```typescript\n * // ❌ Don't do this - too many small writes\n * await service.setItem('TokenList', 'cache:0x1', [...]);\n * await service.setItem('TokenList', 'cache:0x38', [...]);\n * ```\n *\n * @param namespace - Controller namespace (e.g., 'SnapController').\n * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').\n * @param value - JSON data to store (should be 100KB+ for optimal use).\n */\nexport type StorageServiceSetItemAction = {\n  type: `StorageService:setItem`;\n  handler: StorageService['setItem'];\n};\n\n/**\n * Retrieve JSON data from storage.\n *\n * @param namespace - Controller namespace (e.g., 'SnapController').\n * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').\n * @returns StorageGetResult: { result } if found, {} if not found, { error } on failure.\n */\nexport type StorageServiceGetItemAction = {\n  type: `StorageService:getItem`;\n  handler: StorageService['getItem'];\n};\n\n/**\n * Remove data from storage.\n *\n * @param namespace - Controller namespace (e.g., 'SnapController').\n * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').\n */\nexport type StorageServiceRemoveItemAction = {\n  type: `StorageService:removeItem`;\n  handler: StorageService['removeItem'];\n};\n\n/**\n * Get all keys for a namespace.\n * Delegates to storage adapter which handles filtering.\n *\n * @param namespace - Controller namespace (e.g., 'SnapController').\n * @returns Array of keys (without prefix) for this namespace.\n */\nexport type StorageServiceGetAllKeysAction = {\n  type: `StorageService:getAllKeys`;\n  handler: StorageService['getAllKeys'];\n};\n\n/**\n * Clear all data for a namespace.\n *\n * @param namespace - Controller namespace (e.g., 'SnapController').\n */\nexport type StorageServiceClearAction = {\n  type: `StorageService:clear`;\n  handler: StorageService['clear'];\n};\n\n/**\n * Union of all StorageService action types.\n */\nexport type StorageServiceMethodActions =\n  | StorageServiceSetItemAction\n  | StorageServiceGetItemAction\n  | StorageServiceRemoveItemAction\n  | StorageServiceGetAllKeysAction\n  | StorageServiceClearAction;\n"]}