@metamask-previews/storage-service 1.0.0-preview-e493d3e8 → 1.0.0-preview-f5c5aecd

package/dist/InMemoryStorageAdapter.cjs

@@ -0,0 +1,129 @@
+"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_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
+ * ```typescript
+ * const adapter = new InMemoryStorageAdapter();
+ * await adapter.setItem('key', 'value');
+ * const value = await adapter.getItem('key'); // Returns 'value'
+ * // After restart: data is lost
+ * ```
+ */
+class InMemoryStorageAdapter {
+    /**
+     * Constructs a new InMemoryStorageAdapter.
+     */
+    constructor() {
+        // Explicitly implement StorageAdapter interface
+        /**
+         * Internal storage map.
+         */
+        _InMemoryStorageAdapter_storage.set(this, void 0);
+        __classPrivateFieldSet(this, _InMemoryStorageAdapter_storage, new Map(), "f");
+    }
+    /**
+     * Retrieve an item from in-memory storage.
+     * Deserializes and unwraps the stored data.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @returns The unwrapped data, or null if not found.
+     */
+    async getItem(namespace, key) {
+        const fullKey = `${types_1.STORAGE_KEY_PREFIX}${namespace}:${key}`;
+        const serialized = __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").get(fullKey);
+        if (!serialized) {
+            return null;
+        }
+        try {
+            const wrapper = JSON.parse(serialized);
+            return wrapper.data;
+        }
+        catch (error) {
+            // istanbul ignore next - defensive error handling for corrupted data
+            console.error(`Failed to parse stored data for ${fullKey}:`, error);
+            // istanbul ignore next
+            return null;
+        }
+    }
+    /**
+     * Store an item in in-memory storage.
+     * Wraps with metadata and serializes to string.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @param value - The value to store (will be wrapped and serialized).
+     */
+    async setItem(namespace, key, value) {
+        const fullKey = `${types_1.STORAGE_KEY_PREFIX}${namespace}:${key}`;
+        const wrapper = {
+            timestamp: Date.now(),
+            data: value,
+        };
+        __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").set(fullKey, JSON.stringify(wrapper));
+    }
+    /**
+     * Remove an item from in-memory storage.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     */
+    async removeItem(namespace, key) {
+        const fullKey = `${types_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_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_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":";;;;;;;;;;;;;;;AACA,uCAA6C;AAa7C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,sBAAsB;IAOjC;;OAEG;IACH;QATA,gDAAgD;QAChD;;WAEG;QACM,kDAA8B;QAMrC,uBAAA,IAAI,mCAAY,IAAI,GAAG,EAAE,MAAA,CAAC;IAC5B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,GAAW;QAC1C,MAAM,OAAO,GAAG,GAAG,0BAAkB,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC;QAC3D,MAAM,UAAU,GAAG,uBAAA,IAAI,uCAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE9C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAsB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC1D,OAAO,OAAO,CAAC,IAAI,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qEAAqE;YACrE,OAAO,CAAC,KAAK,CAAC,mCAAmC,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC;YACpE,uBAAuB;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,GAAW,EAAE,KAAc;QAC1D,MAAM,OAAO,GAAG,GAAG,0BAAkB,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAsB;YACjC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE,KAAK;SACZ,CAAC;QACF,uBAAA,IAAI,uCAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,GAAW;QAC7C,MAAM,OAAO,GAAG,GAAG,0BAAkB,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC;QAC3D,uBAAA,IAAI,uCAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,MAAM,GAAG,GAAG,0BAAkB,GAAG,SAAS,GAAG,CAAC;QACpD,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,uCAAS,CAAC,IAAI,EAAE,CAAC;aACpC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;aACvC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,SAAiB;QAC3B,MAAM,MAAM,GAAG,GAAG,0BAAkB,GAAG,SAAS,GAAG,CAAC;QACpD,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,uCAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACnE,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CACvB,CAAC;QACF,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAA,IAAI,uCAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF;AA/FD,wDA+FC","sourcesContent":["import type { StorageAdapter } from './types';\nimport { STORAGE_KEY_PREFIX } from './types';\n\n/**\n * Wrapper for stored data with metadata.\n * Each adapter can define its own wrapper structure.\n */\ntype StoredDataWrapper<T = unknown> = {\n  /** Timestamp when data was stored (milliseconds since epoch). */\n  timestamp: number;\n  /** The actual data being stored. */\n  data: T;\n};\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\n * ```typescript\n * const adapter = new InMemoryStorageAdapter();\n * await adapter.setItem('key', 'value');\n * const value = await adapter.getItem('key'); // Returns 'value'\n * // After restart: data is lost\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  constructor() {\n    this.#storage = new Map();\n  }\n\n  /**\n   * Retrieve an item from in-memory storage.\n   * Deserializes and unwraps the stored data.\n   *\n   * @param namespace - The controller namespace.\n   * @param key - The data key.\n   * @returns The unwrapped data, or null if not found.\n   */\n  async getItem(namespace: string, key: string): Promise<unknown> {\n    const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n    const serialized = this.#storage.get(fullKey);\n\n    if (!serialized) {\n      return null;\n    }\n\n    try {\n      const wrapper: StoredDataWrapper = JSON.parse(serialized);\n      return wrapper.data;\n    } catch (error) {\n      // istanbul ignore next - defensive error handling for corrupted data\n      console.error(`Failed to parse stored data for ${fullKey}:`, error);\n      // istanbul ignore next\n      return null;\n    }\n  }\n\n  /**\n   * Store an item in in-memory storage.\n   * Wraps with metadata and serializes to string.\n   *\n   * @param namespace - The controller namespace.\n   * @param key - The data key.\n   * @param value - The value to store (will be wrapped and serialized).\n   */\n  async setItem(namespace: string, key: string, value: unknown): Promise<void> {\n    const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n    const wrapper: StoredDataWrapper = {\n      timestamp: Date.now(),\n      data: value,\n    };\n    this.#storage.set(fullKey, JSON.stringify(wrapper));\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.cts

@@ -0,0 +1,71 @@
+import type { StorageAdapter } from "./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
+ * ```typescript
+ * const adapter = new InMemoryStorageAdapter();
+ * await adapter.setItem('key', 'value');
+ * const value = await adapter.getItem('key'); // Returns 'value'
+ * // After restart: data is lost
+ * ```
+ */
+export declare class InMemoryStorageAdapter implements StorageAdapter {
+    #private;
+    /**
+     * Constructs a new InMemoryStorageAdapter.
+     */
+    constructor();
+    /**
+     * Retrieve an item from in-memory storage.
+     * Deserializes and unwraps the stored data.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @returns The unwrapped data, or null if not found.
+     */
+    getItem(namespace: string, key: string): Promise<unknown>;
+    /**
+     * Store an item in in-memory storage.
+     * Wraps with metadata and serializes to string.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @param value - The value to store (will be wrapped and serialized).
+     */
+    setItem(namespace: string, key: string, value: unknown): 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.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,cAAc,EAAE,oBAAgB;AAc9C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,sBAAuB,YAAW,cAAc;;IAO3D;;OAEG;;IAKH;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB/D;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5E;;;;;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,71 @@
+import type { StorageAdapter } 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
+ * ```typescript
+ * const adapter = new InMemoryStorageAdapter();
+ * await adapter.setItem('key', 'value');
+ * const value = await adapter.getItem('key'); // Returns 'value'
+ * // After restart: data is lost
+ * ```
+ */
+export declare class InMemoryStorageAdapter implements StorageAdapter {
+    #private;
+    /**
+     * Constructs a new InMemoryStorageAdapter.
+     */
+    constructor();
+    /**
+     * Retrieve an item from in-memory storage.
+     * Deserializes and unwraps the stored data.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @returns The unwrapped data, or null if not found.
+     */
+    getItem(namespace: string, key: string): Promise<unknown>;
+    /**
+     * Store an item in in-memory storage.
+     * Wraps with metadata and serializes to string.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @param value - The value to store (will be wrapped and serialized).
+     */
+    setItem(namespace: string, key: string, value: unknown): 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,cAAc,EAAE,oBAAgB;AAc9C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,sBAAuB,YAAW,cAAc;;IAO3D;;OAEG;;IAKH;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB/D;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5E;;;;;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.mjs

@@ -0,0 +1,125 @@
+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.
+ *
+ * ⚠️ **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
+ * ```typescript
+ * const adapter = new InMemoryStorageAdapter();
+ * await adapter.setItem('key', 'value');
+ * const value = await adapter.getItem('key'); // Returns 'value'
+ * // After restart: data is lost
+ * ```
+ */
+export class InMemoryStorageAdapter {
+    /**
+     * Constructs a new InMemoryStorageAdapter.
+     */
+    constructor() {
+        // Explicitly implement StorageAdapter interface
+        /**
+         * Internal storage map.
+         */
+        _InMemoryStorageAdapter_storage.set(this, void 0);
+        __classPrivateFieldSet(this, _InMemoryStorageAdapter_storage, new Map(), "f");
+    }
+    /**
+     * Retrieve an item from in-memory storage.
+     * Deserializes and unwraps the stored data.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @returns The unwrapped data, or null if not found.
+     */
+    async getItem(namespace, key) {
+        const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;
+        const serialized = __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").get(fullKey);
+        if (!serialized) {
+            return null;
+        }
+        try {
+            const wrapper = JSON.parse(serialized);
+            return wrapper.data;
+        }
+        catch (error) {
+            // istanbul ignore next - defensive error handling for corrupted data
+            console.error(`Failed to parse stored data for ${fullKey}:`, error);
+            // istanbul ignore next
+            return null;
+        }
+    }
+    /**
+     * Store an item in in-memory storage.
+     * Wraps with metadata and serializes to string.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     * @param value - The value to store (will be wrapped and serialized).
+     */
+    async setItem(namespace, key, value) {
+        const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;
+        const wrapper = {
+            timestamp: Date.now(),
+            data: value,
+        };
+        __classPrivateFieldGet(this, _InMemoryStorageAdapter_storage, "f").set(fullKey, JSON.stringify(wrapper));
+    }
+    /**
+     * Remove an item from in-memory storage.
+     *
+     * @param namespace - The controller namespace.
+     * @param key - The data key.
+     */
+    async removeItem(namespace, key) {
+        const fullKey = `${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 = `${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 = `${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));
+    }
+}
+_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":";;;;;;;;;;;;AACA,OAAO,EAAE,kBAAkB,EAAE,oBAAgB;AAa7C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,sBAAsB;IAOjC;;OAEG;IACH;QATA,gDAAgD;QAChD;;WAEG;QACM,kDAA8B;QAMrC,uBAAA,IAAI,mCAAY,IAAI,GAAG,EAAE,MAAA,CAAC;IAC5B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,GAAW;QAC1C,MAAM,OAAO,GAAG,GAAG,kBAAkB,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC;QAC3D,MAAM,UAAU,GAAG,uBAAA,IAAI,uCAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE9C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAsB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC1D,OAAO,OAAO,CAAC,IAAI,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qEAAqE;YACrE,OAAO,CAAC,KAAK,CAAC,mCAAmC,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC;YACpE,uBAAuB;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,GAAW,EAAE,KAAc;QAC1D,MAAM,OAAO,GAAG,GAAG,kBAAkB,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAsB;YACjC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE,KAAK;SACZ,CAAC;QACF,uBAAA,IAAI,uCAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,GAAW;QAC7C,MAAM,OAAO,GAAG,GAAG,kBAAkB,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC;QAC3D,uBAAA,IAAI,uCAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,MAAM,GAAG,GAAG,kBAAkB,GAAG,SAAS,GAAG,CAAC;QACpD,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,uCAAS,CAAC,IAAI,EAAE,CAAC;aACpC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;aACvC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,SAAiB;QAC3B,MAAM,MAAM,GAAG,GAAG,kBAAkB,GAAG,SAAS,GAAG,CAAC;QACpD,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,uCAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACnE,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CACvB,CAAC;QACF,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAA,IAAI,uCAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF","sourcesContent":["import type { StorageAdapter } from './types';\nimport { STORAGE_KEY_PREFIX } from './types';\n\n/**\n * Wrapper for stored data with metadata.\n * Each adapter can define its own wrapper structure.\n */\ntype StoredDataWrapper<T = unknown> = {\n  /** Timestamp when data was stored (milliseconds since epoch). */\n  timestamp: number;\n  /** The actual data being stored. */\n  data: T;\n};\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\n * ```typescript\n * const adapter = new InMemoryStorageAdapter();\n * await adapter.setItem('key', 'value');\n * const value = await adapter.getItem('key'); // Returns 'value'\n * // After restart: data is lost\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  constructor() {\n    this.#storage = new Map();\n  }\n\n  /**\n   * Retrieve an item from in-memory storage.\n   * Deserializes and unwraps the stored data.\n   *\n   * @param namespace - The controller namespace.\n   * @param key - The data key.\n   * @returns The unwrapped data, or null if not found.\n   */\n  async getItem(namespace: string, key: string): Promise<unknown> {\n    const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n    const serialized = this.#storage.get(fullKey);\n\n    if (!serialized) {\n      return null;\n    }\n\n    try {\n      const wrapper: StoredDataWrapper = JSON.parse(serialized);\n      return wrapper.data;\n    } catch (error) {\n      // istanbul ignore next - defensive error handling for corrupted data\n      console.error(`Failed to parse stored data for ${fullKey}:`, error);\n      // istanbul ignore next\n      return null;\n    }\n  }\n\n  /**\n   * Store an item in in-memory storage.\n   * Wraps with metadata and serializes to string.\n   *\n   * @param namespace - The controller namespace.\n   * @param key - The data key.\n   * @param value - The value to store (will be wrapped and serialized).\n   */\n  async setItem(namespace: string, key: string, value: unknown): Promise<void> {\n    const fullKey = `${STORAGE_KEY_PREFIX}${namespace}:${key}`;\n    const wrapper: StoredDataWrapper = {\n      timestamp: Date.now(),\n      data: value,\n    };\n    this.#storage.set(fullKey, JSON.stringify(wrapper));\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.cjs

@@ -0,0 +1,187 @@
+"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 _StorageService_messenger, _StorageService_storage;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageService = void 0;
+const InMemoryStorageAdapter_1 = require("./InMemoryStorageAdapter.cjs");
+const types_1 = require("./types.cjs");
+/**
+ * StorageService provides a platform-agnostic way for controllers to store
+ * large, infrequently accessed data outside of memory/Redux state.
+ *
+ * **Use cases:**
+ * - Snap source code (6+ MB that's rarely accessed)
+ * - Token metadata caches (4+ MB of cached data)
+ * - Large cached responses from APIs
+ * - Any data > 100 KB that's not frequently accessed
+ *
+ * **Benefits:**
+ * - Reduces memory usage (data stays on disk)
+ * - Faster Redux persist (less data to serialize)
+ * - Faster app startup (less data to parse)
+ * - Lazy loading (data loaded only when needed)
+ *
+ * **Platform Support:**
+ * - Mobile: FilesystemStorage adapter
+ * - Extension: IndexedDB adapter
+ * - Tests/Dev: InMemoryStorageAdapter (default)
+ *
+ * @example Using the service via messenger
+ *
+ * ```typescript
+ * // In a controller
+ * type AllowedActions =
+ *   | StorageServiceSetItemAction
+ *   | StorageServiceGetItemAction;
+ *
+ * class SnapController extends BaseController {
+ *   async storeSnapSourceCode(snapId: string, sourceCode: string) {
+ *     await this.messenger.call(
+ *       'StorageService:setItem',
+ *       'SnapController',
+ *       `${snapId}:sourceCode`,
+ *       sourceCode,
+ *     );
+ *   }
+ *
+ *   async getSnapSourceCode(snapId: string): Promise<string | null> {
+ *     return await this.messenger.call(
+ *       'StorageService:getItem',
+ *       'SnapController',
+ *       `${snapId}:sourceCode`,
+ *     );
+ *   }
+ * }
+ * ```
+ *
+ * @example Initializing in a client
+ *
+ * ```typescript
+ * // Mobile
+ * const service = new StorageService({
+ *   messenger: storageServiceMessenger,
+ *   storage: filesystemStorageAdapter, // Platform-specific
+ * });
+ *
+ * // Extension
+ * const service = new StorageService({
+ *   messenger: storageServiceMessenger,
+ *   storage: indexedDBAdapter, // Platform-specific
+ * });
+ *
+ * // Tests (uses in-memory by default)
+ * const service = new StorageService({
+ *   messenger: storageServiceMessenger,
+ *   // No storage - uses InMemoryStorageAdapter
+ * });
+ * ```
+ */
+class StorageService {
+    /**
+     * Constructs a new StorageService.
+     *
+     * @param options - The options.
+     * @param options.messenger - The messenger suited for this service.
+     * @param options.storage - Storage adapter for persisting data.
+     * If not provided, uses InMemoryStorageAdapter (data lost on restart).
+     */
+    constructor({ messenger, storage }) {
+        /**
+         * The messenger suited for this service.
+         */
+        _StorageService_messenger.set(this, void 0);
+        /**
+         * The storage adapter for persisting data.
+         */
+        _StorageService_storage.set(this, void 0);
+        this.name = types_1.SERVICE_NAME;
+        __classPrivateFieldSet(this, _StorageService_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _StorageService_storage, storage ?? new InMemoryStorageAdapter_1.InMemoryStorageAdapter(), "f");
+        // Warn if using in-memory storage (data won't persist)
+        if (!storage) {
+            console.warn(`${types_1.SERVICE_NAME}: No storage adapter provided. Using in-memory storage. ` +
+                'Data will be lost on restart. Provide a storage adapter for persistence.');
+        }
+        // Register messenger actions
+        __classPrivateFieldGet(this, _StorageService_messenger, "f").registerActionHandler(`${types_1.SERVICE_NAME}:setItem`, this.setItem.bind(this));
+        __classPrivateFieldGet(this, _StorageService_messenger, "f").registerActionHandler(`${types_1.SERVICE_NAME}:getItem`, this.getItem.bind(this));
+        __classPrivateFieldGet(this, _StorageService_messenger, "f").registerActionHandler(`${types_1.SERVICE_NAME}:removeItem`, this.removeItem.bind(this));
+        __classPrivateFieldGet(this, _StorageService_messenger, "f").registerActionHandler(`${types_1.SERVICE_NAME}:getAllKeys`, this.getAllKeys.bind(this));
+        __classPrivateFieldGet(this, _StorageService_messenger, "f").registerActionHandler(`${types_1.SERVICE_NAME}:clear`, this.clear.bind(this));
+    }
+    /**
+     * Store data in storage.
+     *
+     * @param namespace - Controller namespace (e.g., 'SnapController').
+     * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').
+     * @param value - Data to store (will be JSON stringified).
+     * @template T - The type of the value being stored.
+     */
+    async setItem(namespace, key, value) {
+        // Adapter handles serialization and wrapping with metadata
+        await __classPrivateFieldGet(this, _StorageService_storage, "f").setItem(namespace, key, value);
+        // Publish event so other controllers can react to changes
+        // Event type: StorageService:itemSet:namespace
+        // Payload: [value, key]
+        __classPrivateFieldGet(this, _StorageService_messenger, "f").publish(`${types_1.SERVICE_NAME}:itemSet:${namespace}`, value, key);
+    }
+    /**
+     * Retrieve data from storage.
+     *
+     * @param namespace - Controller namespace (e.g., 'SnapController').
+     * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').
+     * @returns Parsed data or null if not found.
+     * @template T - The type of the value being retrieved.
+     */
+    async getItem(namespace, key) {
+        // Adapter handles deserialization and unwrapping
+        const result = await __classPrivateFieldGet(this, _StorageService_storage, "f").getItem(namespace, key);
+        return result;
+    }
+    /**
+     * Remove data from storage.
+     *
+     * @param namespace - Controller namespace (e.g., 'SnapController').
+     * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').
+     */
+    async removeItem(namespace, key) {
+        // Adapter builds full storage key (e.g., mobile: 'storageService:namespace:key')
+        await __classPrivateFieldGet(this, _StorageService_storage, "f").removeItem(namespace, key);
+        // Publish event so other controllers can react to removal
+        // Event type: StorageService:itemRemoved:namespace
+        // Payload: [key]
+        __classPrivateFieldGet(this, _StorageService_messenger, "f").publish(`${types_1.SERVICE_NAME}:itemRemoved:${namespace}`, key);
+    }
+    /**
+     * 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.
+     */
+    async getAllKeys(namespace) {
+        return await __classPrivateFieldGet(this, _StorageService_storage, "f").getAllKeys(namespace);
+    }
+    /**
+     * Clear all data for a namespace.
+     * Delegates to storage adapter which handles clearing.
+     *
+     * @param namespace - Controller namespace (e.g., 'SnapController').
+     */
+    async clear(namespace) {
+        await __classPrivateFieldGet(this, _StorageService_storage, "f").clear(namespace);
+    }
+}
+exports.StorageService = StorageService;
+_StorageService_messenger = new WeakMap(), _StorageService_storage = new WeakMap();
+//# sourceMappingURL=StorageService.cjs.map

package/dist/StorageService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageService.cjs","sourceRoot":"","sources":["../src/StorageService.ts"],"names":[],"mappings":"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","sourcesContent":["import { InMemoryStorageAdapter } from './InMemoryStorageAdapter';\nimport type {\n  StorageAdapter,\n  StorageServiceMessenger,\n  StorageServiceOptions,\n} from './types';\nimport { SERVICE_NAME } from './types';\n\n/**\n * StorageService provides a platform-agnostic way for controllers to store\n * large, infrequently accessed data outside of memory/Redux state.\n *\n * **Use cases:**\n * - Snap source code (6+ MB that's rarely accessed)\n * - Token metadata caches (4+ MB of cached data)\n * - Large cached responses from APIs\n * - Any data > 100 KB that's not frequently accessed\n *\n * **Benefits:**\n * - Reduces memory usage (data stays on disk)\n * - Faster Redux persist (less data to serialize)\n * - Faster app startup (less data to parse)\n * - Lazy loading (data loaded only when needed)\n *\n * **Platform Support:**\n * - Mobile: FilesystemStorage adapter\n * - Extension: IndexedDB adapter\n * - Tests/Dev: InMemoryStorageAdapter (default)\n *\n * @example Using the service via messenger\n *\n * ```typescript\n * // In a controller\n * type AllowedActions =\n *   | StorageServiceSetItemAction\n *   | StorageServiceGetItemAction;\n *\n * class SnapController extends BaseController {\n *   async storeSnapSourceCode(snapId: string, sourceCode: string) {\n *     await this.messenger.call(\n *       'StorageService:setItem',\n *       'SnapController',\n *       `${snapId}:sourceCode`,\n *       sourceCode,\n *     );\n *   }\n *\n *   async getSnapSourceCode(snapId: string): Promise<string | null> {\n *     return await this.messenger.call(\n *       'StorageService:getItem',\n *       'SnapController',\n *       `${snapId}:sourceCode`,\n *     );\n *   }\n * }\n * ```\n *\n * @example Initializing in a client\n *\n * ```typescript\n * // Mobile\n * const service = new StorageService({\n *   messenger: storageServiceMessenger,\n *   storage: filesystemStorageAdapter, // Platform-specific\n * });\n *\n * // Extension\n * const service = new StorageService({\n *   messenger: storageServiceMessenger,\n *   storage: indexedDBAdapter, // Platform-specific\n * });\n *\n * // Tests (uses in-memory by default)\n * const service = new StorageService({\n *   messenger: storageServiceMessenger,\n *   // No storage - uses InMemoryStorageAdapter\n * });\n * ```\n */\nexport class StorageService {\n  /**\n   * The name of the service.\n   */\n  readonly name: typeof SERVICE_NAME;\n\n  /**\n   * The messenger suited for this service.\n   */\n  readonly #messenger: StorageServiceMessenger;\n\n  /**\n   * The storage adapter for persisting data.\n   */\n  readonly #storage: StorageAdapter;\n\n  /**\n   * Constructs a new StorageService.\n   *\n   * @param options - The options.\n   * @param options.messenger - The messenger suited for this service.\n   * @param options.storage - Storage adapter for persisting data.\n   * If not provided, uses InMemoryStorageAdapter (data lost on restart).\n   */\n  constructor({ messenger, storage }: StorageServiceOptions) {\n    this.name = SERVICE_NAME;\n    this.#messenger = messenger;\n    this.#storage = storage ?? new InMemoryStorageAdapter();\n\n    // Warn if using in-memory storage (data won't persist)\n    if (!storage) {\n      console.warn(\n        `${SERVICE_NAME}: No storage adapter provided. Using in-memory storage. ` +\n          'Data will be lost on restart. Provide a storage adapter for persistence.',\n      );\n    }\n\n    // Register messenger actions\n    this.#messenger.registerActionHandler(\n      `${SERVICE_NAME}:setItem`,\n      this.setItem.bind(this),\n    );\n    this.#messenger.registerActionHandler(\n      `${SERVICE_NAME}:getItem`,\n      this.getItem.bind(this),\n    );\n    this.#messenger.registerActionHandler(\n      `${SERVICE_NAME}:removeItem`,\n      this.removeItem.bind(this),\n    );\n    this.#messenger.registerActionHandler(\n      `${SERVICE_NAME}:getAllKeys`,\n      this.getAllKeys.bind(this),\n    );\n    this.#messenger.registerActionHandler(\n      `${SERVICE_NAME}:clear`,\n      this.clear.bind(this),\n    );\n  }\n\n  /**\n   * Store data in storage.\n   *\n   * @param namespace - Controller namespace (e.g., 'SnapController').\n   * @param key - Storage key (e.g., 'npm:@metamask/example-snap:sourceCode').\n   * @param value - Data to store (will be JSON stringified).\n   * @template T - The type of the value being stored.\n   */\n  async setItem<T>(namespace: string, key: string, value: T): Promise<void> {\n    // Adapter handles serialization and wrapping with metadata\n    await this.#storage.setItem(namespace, key, value as never);\n\n    // Publish event so other controllers can react to changes\n    // Event type: StorageService:itemSet:namespace\n    // Payload: [value, key]\n    this.#messenger.publish(\n      `${SERVICE_NAME}:itemSet:${namespace}` as `${typeof SERVICE_NAME}:itemSet:${string}`,\n      value,\n      key,\n    );\n  }\n\n  /**\n   * Retrieve 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 Parsed data or null if not found.\n   * @template T - The type of the value being retrieved.\n   */\n  async getItem<T>(namespace: string, key: string): Promise<T | null> {\n    // Adapter handles deserialization and unwrapping\n    const result = await this.#storage.getItem(namespace, key);\n    return result as T | null;\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   */\n  async removeItem(namespace: string, key: string): Promise<void> {\n    // Adapter builds full storage key (e.g., mobile: 'storageService:namespace:key')\n    await this.#storage.removeItem(namespace, key);\n\n    // Publish event so other controllers can react to removal\n    // Event type: StorageService:itemRemoved:namespace\n    // Payload: [key]\n    this.#messenger.publish(\n      `${SERVICE_NAME}:itemRemoved:${namespace}` as `${typeof SERVICE_NAME}:itemRemoved:${string}`,\n      key,\n    );\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   */\n  async getAllKeys(namespace: string): Promise<string[]> {\n    return await this.#storage.getAllKeys(namespace);\n  }\n\n  /**\n   * Clear all data for a namespace.\n   * Delegates to storage adapter which handles clearing.\n   *\n   * @param namespace - Controller namespace (e.g., 'SnapController').\n   */\n  async clear(namespace: string): Promise<void> {\n    await this.#storage.clear(namespace);\n  }\n}\n"]}