@matter/general 0.16.6-alpha.0-20260121-06f1d9611 → 0.16.6-alpha.0-20260122-b5154bcb4

package/dist/cjs/storage/Storage.d.ts

@@ -24,6 +24,7 @@ export declare abstract class Storage {
     abstract values(contexts: string[]): MaybePromise<Record<string, SupportedStorageTypes>>;
     abstract contexts(contexts: string[]): MaybePromise<string[]>;
     abstract clearAll(contexts: string[]): MaybePromise<void>;
+    abstract clear(completely?: boolean): MaybePromise<void>;
     /**
      * Checks if a key exists in the storage for the given contexts.
      * Important Note: This default implementation just reads the value for the key and checks if it is undefined.

package/dist/cjs/storage/Storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../src/storage/Storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAuB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAEhD;;GAEG;AACH,8BAAsB,OAAO;IACzB,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,UAAU,IAAI,YAAY,CAAC,IAAI,CAAC;IACzC,QAAQ,CAAC,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAC9F,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;IACnG,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAAC,IAAI,CAAC;IAC/F,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;IACpE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACxF,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IAC7D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC;IAEzD;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;IAQ3D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;CACnH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;CAClC;AAED,yBAAiB,gBAAgB,CAAC;IAC9B,SAAgB,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,gBAAgB,CAE5E;IAED,SAAgB,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,gBAAgB,CAIxF;CACJ"}
+{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../src/storage/Storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAuB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAEhD;;GAEG;AACH,8BAAsB,OAAO;IACzB,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,UAAU,IAAI,YAAY,CAAC,IAAI,CAAC;IACzC,QAAQ,CAAC,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAC9F,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;IACnG,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAAC,IAAI,CAAC;IAC/F,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;IACpE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACxF,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IAC7D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC;IAEzD,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC;IAExD;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;IAQ3D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;CACnH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;CAClC;AAED,yBAAiB,gBAAgB,CAAC;IAC9B,SAAgB,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,gBAAgB,CAE5E;IAED,SAAgB,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,gBAAgB,CAIxF;CACJ"}

package/dist/cjs/storage/Storage.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/Storage.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,yBAAiD;AACjD,sBAA6B;AAP7B;AAAA;AAAA;AAAA;AAAA;AAUO,MAAM,qBAAqB,+BAAY;AAAC;AAKxC,MAAe,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkB1B,IAAI,UAAoB,KAAoC;AACxD,UAAM,QAAQ,KAAK,IAAI,UAAU,GAAG;AACpC,QAAI,6BAAa,GAAG,KAAK,GAAG;AACxB,aAAO,6BAAa,KAAK,OAAO,OAAK,MAAM,MAAS;AAAA,IACxD;AACA,WAAO,UAAU;AAAA,EACrB;AAIJ;AASO,IAAU;AAAA,CAAV,CAAUA,sBAAV;AACI,WAAS,GAAiB,SAA6C;AAC1E,WAAO,WAAW,WAAW,OAAO,QAAQ,UAAU;AAAA,EAC1D;AAFO,EAAAA,kBAAS;AAIT,WAAS,OAAqB,SAAqD;AACtF,QAAI,CAAC,GAAG,OAAO,GAAG;AACd,YAAM,IAAI,uCAAoB,yDAAyD;AAAA,IAC3F;AAAA,EACJ;AAJO,EAAAA,kBAAS;AAAA,GALH;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,yBAAiD;AACjD,sBAA6B;AAP7B;AAAA;AAAA;AAAA;AAAA;AAUO,MAAM,qBAAqB,+BAAY;AAAC;AAKxC,MAAe,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoB1B,IAAI,UAAoB,KAAoC;AACxD,UAAM,QAAQ,KAAK,IAAI,UAAU,GAAG;AACpC,QAAI,6BAAa,GAAG,KAAK,GAAG;AACxB,aAAO,6BAAa,KAAK,OAAO,OAAK,MAAM,MAAS;AAAA,IACxD;AACA,WAAO,UAAU;AAAA,EACrB;AAIJ;AASO,IAAU;AAAA,CAAV,CAAUA,sBAAV;AACI,WAAS,GAAiB,SAA6C;AAC1E,WAAO,WAAW,WAAW,OAAO,QAAQ,UAAU;AAAA,EAC1D;AAFO,EAAAA,kBAAS;AAIT,WAAS,OAAqB,SAAqD;AACtF,QAAI,CAAC,GAAG,OAAO,GAAG;AACd,YAAM,IAAI,uCAAoB,yDAAyD;AAAA,IAC3F;AAAA,EACJ;AAJO,EAAAA,kBAAS;AAAA,GALH;",
   "names": ["CloneableStorage"]
 }

package/dist/cjs/storage/StorageMigration.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Storage } from "./Storage.js";
+/**
+ * A simple storage migrator of storage.
+ *
+ * It does not modify or remove source data.
+ */
+export declare namespace StorageMigration {
+    interface MigrationSkipped {
+        contexts: string[];
+        key: string;
+        error: string;
+    }
+    interface MigrationResult {
+        success: boolean;
+        migratedCount: number;
+        skippedCount: number;
+        skippedItems: MigrationSkipped[];
+    }
+    /**
+     * Migrate storage from `source` to `target`.
+     */
+    function migrate(source: Storage, target: Storage): Promise<MigrationResult>;
+    /**
+     * Export migration result to log
+     */
+    function resultToLog(result: MigrationResult): string;
+}
+//# sourceMappingURL=StorageMigration.d.ts.map

package/dist/cjs/storage/StorageMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageMigration.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageMigration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C;;;;GAIG;AACH,yBAAiB,gBAAgB,CAAC;IAC9B,UAAiB,gBAAgB;QAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACjB;IAED,UAAiB,eAAe;QAC5B,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,gBAAgB,EAAE,CAAC;KACpC;IAED;;OAEG;IACH,SAAsB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAmBxF;IAED;;OAEG;IACH,SAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,UAkBlD;CACJ"}

package/dist/cjs/storage/StorageMigration.js

@@ -0,0 +1,116 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var StorageMigration_exports = {};
+__export(StorageMigration_exports, {
+  StorageMigration: () => StorageMigration
+});
+module.exports = __toCommonJS(StorageMigration_exports);
+var import_Logger = require("#log/Logger.js");
+var import_MatterError = require("#MatterError.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = new import_Logger.Logger("StorageMigrator");
+var StorageMigration;
+((StorageMigration2) => {
+  async function migrate(source, target) {
+    const result = {
+      success: true,
+      migratedCount: 0,
+      skippedCount: 0,
+      skippedItems: []
+    };
+    await migrateContext({
+      source,
+      target,
+      contexts: [],
+      result
+    });
+    result.success = result.skippedCount === 0;
+    return result;
+  }
+  StorageMigration2.migrate = migrate;
+  function resultToLog(result) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    let logContent = `
+    # Migration Log
+    - Timestamp: ${timestamp}
+    - Success: ${result.success}
+    - Migrated: ${result.migratedCount}
+    - Skipped: ${result.skippedCount}
+    `.replace(/^\s+/gm, "");
+    if (result.skippedCount > 0 && result.skippedItems.length > 0) {
+      logContent += `
+## Skipped Items
+`;
+      for (const item of result.skippedItems) {
+        logContent += `- ${buildContextKeyLog(item.contexts, item.key)}: ${item.error}
+`;
+      }
+    }
+    return logContent;
+  }
+  StorageMigration2.resultToLog = resultToLog;
+})(StorageMigration || (StorageMigration = {}));
+async function migrateContext(args) {
+  const { source, target, contexts, result } = args;
+  const keys = await source.keys(contexts);
+  for (const key of keys) {
+    try {
+      const value = await source.get(contexts, key);
+      if (value === void 0) {
+        const blob = await source.openBlob(contexts, key);
+        if (blob.size === 0) {
+          continue;
+        }
+        const stream = blob.stream();
+        await target.writeBlobFromStream(contexts, key, stream);
+        result.migratedCount += 1;
+        continue;
+      }
+      await target.set(contexts, key, value);
+      result.migratedCount += 1;
+    } catch (err) {
+      result.skippedCount += 1;
+      result.skippedItems.push({
+        contexts,
+        key,
+        error: err instanceof Error ? err.message : String(err)
+      });
+      logger.warn(`[migrate] Skipped '${buildContextKeyLog(contexts, key)}' entity: ${err}`);
+    }
+  }
+  const subContexts = await source.contexts(contexts);
+  const promises = [];
+  subContexts.forEach((subCon) => {
+    promises.push(
+      migrateContext({
+        ...args,
+        contexts: [...contexts, subCon]
+      })
+    );
+  });
+  await import_MatterError.MatterAggregateError.allSettled(promises, "[migrate] Error migrating sub-contexts!");
+}
+function buildContextKeyLog(contexts, key) {
+  return `${contexts.join(".")}$${key}`;
+}
+//# sourceMappingURL=StorageMigration.js.map

package/dist/cjs/storage/StorageMigration.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/StorageMigration.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,oBAAuB;AACvB,yBAAqC;AAPrC;AAAA;AAAA;AAAA;AAAA;AAUA,MAAM,SAAS,IAAI,qBAAO,iBAAiB;AAOpC,IAAU;AAAA,CAAV,CAAUA,sBAAV;AAiBH,iBAAsB,QAAQ,QAAiB,QAA2C;AACtF,UAAM,SAAS;AAAA,MACX,SAAS;AAAA,MACT,eAAe;AAAA,MACf,cAAc;AAAA,MACd,cAAc,CAAC;AAAA,IACnB;AAGA,UAAM,eAAe;AAAA,MACjB;AAAA,MACA;AAAA,MACA,UAAU,CAAC;AAAA,MACX;AAAA,IACJ,CAAC;AAGD,WAAO,UAAU,OAAO,iBAAiB;AACzC,WAAO;AAAA,EACX;AAnBA,EAAAA,kBAAsB;AAwBf,WAAS,YAAY,QAAyB;AACjD,UAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AAEzC,QAAI,aAAa;AAAA;AAAA,mBAEN,SAAS;AAAA,iBACX,OAAO,OAAO;AAAA,kBACb,OAAO,aAAa;AAAA,iBACrB,OAAO,YAAY;AAAA,MAC9B,QAAQ,UAAU,EAAE;AAClB,QAAI,OAAO,eAAe,KAAK,OAAO,aAAa,SAAS,GAAG;AAC3D,oBAAc;AAAA;AAAA;AACd,iBAAW,QAAQ,OAAO,cAAc;AACpC,sBAAc,KAAK,mBAAmB,KAAK,UAAU,KAAK,GAAG,CAAC,KAAK,KAAK,KAAK;AAAA;AAAA,MACjF;AAAA,IACJ;AAEA,WAAO;AAAA,EACX;AAlBO,EAAAA,kBAAS;AAAA,GAzCH;AAiEjB,eAAe,eAAe,MAK3B;AACC,QAAM,EAAE,QAAQ,QAAQ,UAAU,OAAO,IAAI;AAC7C,QAAM,OAAO,MAAM,OAAO,KAAK,QAAQ;AAEvC,aAAW,OAAO,MAAM;AACpB,QAAI;AACA,YAAM,QAAQ,MAAM,OAAO,IAAI,UAAU,GAAG;AAC5C,UAAI,UAAU,QAAW;AAErB,cAAM,OAAO,MAAM,OAAO,SAAS,UAAU,GAAG;AAChD,YAAI,KAAK,SAAS,GAAG;AACjB;AAAA,QACJ;AAEA,cAAM,SAAS,KAAK,OAAO;AAC3B,cAAM,OAAO,oBAAoB,UAAU,KAAK,MAAM;AAEtD,eAAO,iBAAiB;AACxB;AAAA,MACJ;AAEA,YAAM,OAAO,IAAI,UAAU,KAAK,KAAK;AACrC,aAAO,iBAAiB;AAAA,IAC5B,SAAS,KAAK;AACV,aAAO,gBAAgB;AACvB,aAAO,aAAa,KAAK;AAAA,QACrB;AAAA,QACA;AAAA,QACA,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,MAC1D,CAAC;AACD,aAAO,KAAK,sBAAsB,mBAAmB,UAAU,GAAG,CAAC,aAAa,GAAG,EAAE;AAAA,IACzF;AAAA,EACJ;AAGA,QAAM,cAAc,MAAM,OAAO,SAAS,QAAQ;AAClD,QAAM,WAA4B,CAAC;AAEnC,cAAY,QAAQ,YAAU;AAC1B,aAAS;AAAA,MACL,eAAe;AAAA,QACX,GAAG;AAAA,QACH,UAAU,CAAC,GAAG,UAAU,MAAM;AAAA,MAClC,CAAC;AAAA,IACL;AAAA,EACJ,CAAC;AAGD,QAAM,wCAAqB,WAAW,UAAU,yCAAyC;AAC7F;AAEA,SAAS,mBAAmB,UAAoB,KAAa;AACzD,SAAO,GAAG,SAAS,KAAK,GAAG,CAAC,IAAI,GAAG;AACvC;",
+  "names": ["StorageMigration"]
+}

package/dist/cjs/storage/StorageService.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2022-2026 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { MaybePromise } from "#util/Promises.js";
 import { Environment } from "../environment/Environment.js";
 import { Environmental } from "../environment/Environmental.js";
 import { Diagnostic } from "../log/Diagnostic.js";
@@ -14,7 +15,7 @@ import { StorageManager } from "./StorageManager.js";
 export declare class StorageService {
     #private;
     [Diagnostic.value]: () => (string | (Record<string, unknown> & Diagnostic))[];
-    constructor(environment: Environment, factory?: (namespace: string) => Storage, resolver?: (...paths: string[]) => string);
+    constructor(environment: Environment, factory?: (namespace: string) => MaybePromise<Storage>, resolver?: (...paths: string[]) => string);
     static [Environmental.create](environment: Environment): StorageService;
     /**
      * Open storage.  The storage is initialized but the caller must take ownership.
@@ -25,7 +26,7 @@ export declare class StorageService {
     /**
      * Install a factory for opening storage.  Without such a factory storage is unavailable.
      */
-    set factory(factory: (namespace: string) => Storage);
+    set factory(factory: (namespace: string) => MaybePromise<Storage>);
     /**
      * The storage location.  Only used for diagnostic purposes.
      */

package/dist/cjs/storage/StorageService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageService.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,cAAc;;IA4DvB,CAAC,UAAU,CAAC,KAAK,CAAC;gBAvDd,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EACxC,QAAQ,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM;IAU7C,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,WAAW;IAItD;;;;OAIG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM;IAW5B;;OAEG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EAElD;IAED;;OAEG;IACH,IAAI,QAAQ,IAIW,MAAM,GAAG,SAAS,CAFxC;IAED,IAAI,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAExC;IAED;;OAEG;IACH,OAAO,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;CAW3C"}
+{"version":3,"file":"StorageService.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,cAAc;;IA6DvB,CAAC,UAAU,CAAC,KAAK,CAAC;gBAxDd,WAAW,EAAE,WAAW,EAExB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,YAAY,CAAC,OAAO,CAAC,EACtD,QAAQ,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM;IAU7C,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,WAAW;IAItD;;;;OAIG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM;IAW5B;;OAEG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,YAAY,CAAC,OAAO,CAAC,EAEhE;IAED;;OAEG;IACH,IAAI,QAAQ,IAIW,MAAM,GAAG,SAAS,CAFxC;IAED,IAAI,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAExC;IAED;;OAEG;IACH,OAAO,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;CAW3C"}

package/dist/cjs/storage/StorageService.js

@@ -50,7 +50,7 @@ class StorageService {
     if (this.#factory === void 0) {
       throw new import_MatterError.NoProviderError("Storage is unavailable because no platform implementation is installed");
     }
-    const storage = this.#factory(namespace);
+    const storage = await this.#factory(namespace);
     const manager = new import_StorageManager.StorageManager(storage);
     await manager.initialize();
     return manager;

package/dist/cjs/storage/StorageService.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/StorageService.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,yBAAgC;AAEhC,2BAA8B;AAC9B,wBAA2B;AAE3B,4BAA+B;AAX/B;AAAA;AAAA;AAAA;AAAA;AAgBO,MAAM,eAAe;AAAA,EACxB;AAAA,EACA;AAAA,EAEA,YACI,aACA,SACA,UACF;AACE,gBAAY,IAAI,gBAAgB,IAAI;AACpC,SAAK,WAAW;AAIhB,SAAK,UAAU,aAAa,IAAI,UAAc,MAAM,KAAK,GAAG;AAAA,EAChE;AAAA,EAEA,QAAQ,mCAAc,MAAM,EAAE,aAA0B;AACpD,WAAO,IAAI,KAAK,WAAW;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,KAAK,WAAmB;AAC1B,QAAI,KAAK,aAAa,QAAW;AAC7B,YAAM,IAAI,mCAAgB,wEAAwE;AAAA,IACtG;AAEA,UAAM,UAAU,KAAK,SAAS,SAAS;AACvC,UAAM,UAAU,IAAI,qCAAe,OAAO;AAC1C,UAAM,QAAQ,WAAW;AACzB,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,QAAQ,SAAyC;AACjD,SAAK,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,WAAW;AACX,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,SAASA,WAA8B;AACvC,SAAK,YAAYA;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA,EAKA;AAAA,EAEA,CAAC,6BAAW,KAAK,IAAI;AACjB,WAAO;AAAA,MACH;AAAA,MACA,6BAAW,KAAK;AAAA,QACZ,UAAU,YAAY;AAAA,QACtB,WAAW,CAAC,CAAC,KAAK;AAAA,MACtB,CAAC;AAAA,IACL;AAAA,EACJ;AACJ;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,yBAAgC;AAEhC,2BAA8B;AAC9B,wBAA2B;AAE3B,4BAA+B;AAZ/B;AAAA;AAAA;AAAA;AAAA;AAiBO,MAAM,eAAe;AAAA,EACxB;AAAA,EACA;AAAA,EAEA,YACI,aAEA,SACA,UACF;AACE,gBAAY,IAAI,gBAAgB,IAAI;AACpC,SAAK,WAAW;AAIhB,SAAK,UAAU,aAAa,IAAI,UAAc,MAAM,KAAK,GAAG;AAAA,EAChE;AAAA,EAEA,QAAQ,mCAAc,MAAM,EAAE,aAA0B;AACpD,WAAO,IAAI,KAAK,WAAW;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,KAAK,WAAmB;AAC1B,QAAI,KAAK,aAAa,QAAW;AAC7B,YAAM,IAAI,mCAAgB,wEAAwE;AAAA,IACtG;AAEA,UAAM,UAAU,MAAM,KAAK,SAAS,SAAS;AAC7C,UAAM,UAAU,IAAI,qCAAe,OAAO;AAC1C,UAAM,QAAQ,WAAW;AACzB,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,QAAQ,SAAuD;AAC/D,SAAK,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,WAAW;AACX,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,SAASA,WAA8B;AACvC,SAAK,YAAYA;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA,EAKA;AAAA,EAEA,CAAC,6BAAW,KAAK,IAAI;AACjB,WAAO;AAAA,MACH;AAAA,MACA,6BAAW,KAAK;AAAA,QACZ,UAAU,YAAY;AAAA,QACtB,WAAW,CAAC,CAAC,KAAK;AAAA,MACtB,CAAC;AAAA,IACL;AAAA,EACJ;AACJ;",
   "names": ["location"]
 }

package/dist/cjs/storage/index.d.ts

@@ -8,6 +8,7 @@ export * from "./Storage.js";
 export * from "./StorageBackendMemory.js";
 export * from "./StorageContext.js";
 export * from "./StorageManager.js";
+export * from "./StorageMigration.js";
 export * from "./StorageService.js";
 export * from "./StringifyTools.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/cjs/storage/index.js

@@ -20,6 +20,7 @@ __reExport(storage_exports, require("./Storage.js"), module.exports);
 __reExport(storage_exports, require("./StorageBackendMemory.js"), module.exports);
 __reExport(storage_exports, require("./StorageContext.js"), module.exports);
 __reExport(storage_exports, require("./StorageManager.js"), module.exports);
+__reExport(storage_exports, require("./StorageMigration.js"), module.exports);
 __reExport(storage_exports, require("./StorageService.js"), module.exports);
 __reExport(storage_exports, require("./StringifyTools.js"), module.exports);
 /**

package/dist/cjs/storage/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/index.ts"],
-  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,4BAAc,mCANd;AAOA,4BAAc,yBAPd;AAQA,4BAAc,sCARd;AASA,4BAAc,gCATd;AAUA,4BAAc,gCAVd;AAWA,4BAAc,gCAXd;AAYA,4BAAc,gCAZd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,4BAAc,mCANd;AAOA,4BAAc,yBAPd;AAQA,4BAAc,sCARd;AASA,4BAAc,gCATd;AAUA,4BAAc,gCAVd;AAWA,4BAAc,kCAXd;AAYA,4BAAc,gCAZd;AAaA,4BAAc,gCAbd;AAAA;AAAA;AAAA;AAAA;AAAA;",
   "names": []
 }

package/dist/esm/storage/Storage.d.ts

@@ -24,6 +24,7 @@ export declare abstract class Storage {
     abstract values(contexts: string[]): MaybePromise<Record<string, SupportedStorageTypes>>;
     abstract contexts(contexts: string[]): MaybePromise<string[]>;
     abstract clearAll(contexts: string[]): MaybePromise<void>;
+    abstract clear(completely?: boolean): MaybePromise<void>;
     /**
      * Checks if a key exists in the storage for the given contexts.
      * Important Note: This default implementation just reads the value for the key and checks if it is undefined.

package/dist/esm/storage/Storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../src/storage/Storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAuB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAEhD;;GAEG;AACH,8BAAsB,OAAO;IACzB,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,UAAU,IAAI,YAAY,CAAC,IAAI,CAAC;IACzC,QAAQ,CAAC,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAC9F,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;IACnG,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAAC,IAAI,CAAC;IAC/F,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;IACpE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACxF,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IAC7D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC;IAEzD;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;IAQ3D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;CACnH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;CAClC;AAED,yBAAiB,gBAAgB,CAAC;IAC9B,SAAgB,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,gBAAgB,CAE5E;IAED,SAAgB,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,gBAAgB,CAIxF;CACJ"}
+{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../src/storage/Storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAuB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAEhD;;GAEG;AACH,8BAAsB,OAAO;IACzB,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,UAAU,IAAI,YAAY,CAAC,IAAI,CAAC;IACzC,QAAQ,CAAC,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAC9F,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;IACnG,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAAC,IAAI,CAAC;IAC/F,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;IACpE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACxF,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IAC7D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC;IAEzD,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC;IAExD;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;IAQ3D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;CACnH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;CAClC;AAED,yBAAiB,gBAAgB,CAAC;IAC9B,SAAgB,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,gBAAgB,CAE5E;IAED,SAAgB,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,gBAAgB,CAIxF;CACJ"}

package/dist/esm/storage/Storage.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/Storage.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,qBAAqB,mBAAmB;AACjD,SAAS,oBAAoB;AAGtB,MAAM,qBAAqB,YAAY;AAAC;AAKxC,MAAe,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkB1B,IAAI,UAAoB,KAAoC;AACxD,UAAM,QAAQ,KAAK,IAAI,UAAU,GAAG;AACpC,QAAI,aAAa,GAAG,KAAK,GAAG;AACxB,aAAO,aAAa,KAAK,OAAO,OAAK,MAAM,MAAS;AAAA,IACxD;AACA,WAAO,UAAU;AAAA,EACrB;AAIJ;AASO,IAAU;AAAA,CAAV,CAAUA,sBAAV;AACI,WAAS,GAAiB,SAA6C;AAC1E,WAAO,WAAW,WAAW,OAAO,QAAQ,UAAU;AAAA,EAC1D;AAFO,EAAAA,kBAAS;AAIT,WAAS,OAAqB,SAAqD;AACtF,QAAI,CAAC,GAAG,OAAO,GAAG;AACd,YAAM,IAAI,oBAAoB,yDAAyD;AAAA,IAC3F;AAAA,EACJ;AAJO,EAAAA,kBAAS;AAAA,GALH;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,qBAAqB,mBAAmB;AACjD,SAAS,oBAAoB;AAGtB,MAAM,qBAAqB,YAAY;AAAC;AAKxC,MAAe,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoB1B,IAAI,UAAoB,KAAoC;AACxD,UAAM,QAAQ,KAAK,IAAI,UAAU,GAAG;AACpC,QAAI,aAAa,GAAG,KAAK,GAAG;AACxB,aAAO,aAAa,KAAK,OAAO,OAAK,MAAM,MAAS;AAAA,IACxD;AACA,WAAO,UAAU;AAAA,EACrB;AAIJ;AASO,IAAU;AAAA,CAAV,CAAUA,sBAAV;AACI,WAAS,GAAiB,SAA6C;AAC1E,WAAO,WAAW,WAAW,OAAO,QAAQ,UAAU;AAAA,EAC1D;AAFO,EAAAA,kBAAS;AAIT,WAAS,OAAqB,SAAqD;AACtF,QAAI,CAAC,GAAG,OAAO,GAAG;AACd,YAAM,IAAI,oBAAoB,yDAAyD;AAAA,IAC3F;AAAA,EACJ;AAJO,EAAAA,kBAAS;AAAA,GALH;",
   "names": ["CloneableStorage"]
 }

package/dist/esm/storage/StorageMigration.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Storage } from "./Storage.js";
+/**
+ * A simple storage migrator of storage.
+ *
+ * It does not modify or remove source data.
+ */
+export declare namespace StorageMigration {
+    interface MigrationSkipped {
+        contexts: string[];
+        key: string;
+        error: string;
+    }
+    interface MigrationResult {
+        success: boolean;
+        migratedCount: number;
+        skippedCount: number;
+        skippedItems: MigrationSkipped[];
+    }
+    /**
+     * Migrate storage from `source` to `target`.
+     */
+    function migrate(source: Storage, target: Storage): Promise<MigrationResult>;
+    /**
+     * Export migration result to log
+     */
+    function resultToLog(result: MigrationResult): string;
+}
+//# sourceMappingURL=StorageMigration.d.ts.map

package/dist/esm/storage/StorageMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageMigration.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageMigration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C;;;;GAIG;AACH,yBAAiB,gBAAgB,CAAC;IAC9B,UAAiB,gBAAgB;QAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACjB;IAED,UAAiB,eAAe;QAC5B,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,gBAAgB,EAAE,CAAC;KACpC;IAED;;OAEG;IACH,SAAsB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAmBxF;IAED;;OAEG;IACH,SAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,UAkBlD;CACJ"}

package/dist/esm/storage/StorageMigration.js

@@ -0,0 +1,96 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Logger } from "#log/Logger.js";
+import { MatterAggregateError } from "#MatterError.js";
+const logger = new Logger("StorageMigrator");
+var StorageMigration;
+((StorageMigration2) => {
+  async function migrate(source, target) {
+    const result = {
+      success: true,
+      migratedCount: 0,
+      skippedCount: 0,
+      skippedItems: []
+    };
+    await migrateContext({
+      source,
+      target,
+      contexts: [],
+      result
+    });
+    result.success = result.skippedCount === 0;
+    return result;
+  }
+  StorageMigration2.migrate = migrate;
+  function resultToLog(result) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    let logContent = `
+    # Migration Log
+    - Timestamp: ${timestamp}
+    - Success: ${result.success}
+    - Migrated: ${result.migratedCount}
+    - Skipped: ${result.skippedCount}
+    `.replace(/^\s+/gm, "");
+    if (result.skippedCount > 0 && result.skippedItems.length > 0) {
+      logContent += `
+## Skipped Items
+`;
+      for (const item of result.skippedItems) {
+        logContent += `- ${buildContextKeyLog(item.contexts, item.key)}: ${item.error}
+`;
+      }
+    }
+    return logContent;
+  }
+  StorageMigration2.resultToLog = resultToLog;
+})(StorageMigration || (StorageMigration = {}));
+async function migrateContext(args) {
+  const { source, target, contexts, result } = args;
+  const keys = await source.keys(contexts);
+  for (const key of keys) {
+    try {
+      const value = await source.get(contexts, key);
+      if (value === void 0) {
+        const blob = await source.openBlob(contexts, key);
+        if (blob.size === 0) {
+          continue;
+        }
+        const stream = blob.stream();
+        await target.writeBlobFromStream(contexts, key, stream);
+        result.migratedCount += 1;
+        continue;
+      }
+      await target.set(contexts, key, value);
+      result.migratedCount += 1;
+    } catch (err) {
+      result.skippedCount += 1;
+      result.skippedItems.push({
+        contexts,
+        key,
+        error: err instanceof Error ? err.message : String(err)
+      });
+      logger.warn(`[migrate] Skipped '${buildContextKeyLog(contexts, key)}' entity: ${err}`);
+    }
+  }
+  const subContexts = await source.contexts(contexts);
+  const promises = [];
+  subContexts.forEach((subCon) => {
+    promises.push(
+      migrateContext({
+        ...args,
+        contexts: [...contexts, subCon]
+      })
+    );
+  });
+  await MatterAggregateError.allSettled(promises, "[migrate] Error migrating sub-contexts!");
+}
+function buildContextKeyLog(contexts, key) {
+  return `${contexts.join(".")}$${key}`;
+}
+export {
+  StorageMigration
+};
+//# sourceMappingURL=StorageMigration.js.map

package/dist/esm/storage/StorageMigration.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/StorageMigration.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,cAAc;AACvB,SAAS,4BAA4B;AAGrC,MAAM,SAAS,IAAI,OAAO,iBAAiB;AAOpC,IAAU;AAAA,CAAV,CAAUA,sBAAV;AAiBH,iBAAsB,QAAQ,QAAiB,QAA2C;AACtF,UAAM,SAAS;AAAA,MACX,SAAS;AAAA,MACT,eAAe;AAAA,MACf,cAAc;AAAA,MACd,cAAc,CAAC;AAAA,IACnB;AAGA,UAAM,eAAe;AAAA,MACjB;AAAA,MACA;AAAA,MACA,UAAU,CAAC;AAAA,MACX;AAAA,IACJ,CAAC;AAGD,WAAO,UAAU,OAAO,iBAAiB;AACzC,WAAO;AAAA,EACX;AAnBA,EAAAA,kBAAsB;AAwBf,WAAS,YAAY,QAAyB;AACjD,UAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AAEzC,QAAI,aAAa;AAAA;AAAA,mBAEN,SAAS;AAAA,iBACX,OAAO,OAAO;AAAA,kBACb,OAAO,aAAa;AAAA,iBACrB,OAAO,YAAY;AAAA,MAC9B,QAAQ,UAAU,EAAE;AAClB,QAAI,OAAO,eAAe,KAAK,OAAO,aAAa,SAAS,GAAG;AAC3D,oBAAc;AAAA;AAAA;AACd,iBAAW,QAAQ,OAAO,cAAc;AACpC,sBAAc,KAAK,mBAAmB,KAAK,UAAU,KAAK,GAAG,CAAC,KAAK,KAAK,KAAK;AAAA;AAAA,MACjF;AAAA,IACJ;AAEA,WAAO;AAAA,EACX;AAlBO,EAAAA,kBAAS;AAAA,GAzCH;AAiEjB,eAAe,eAAe,MAK3B;AACC,QAAM,EAAE,QAAQ,QAAQ,UAAU,OAAO,IAAI;AAC7C,QAAM,OAAO,MAAM,OAAO,KAAK,QAAQ;AAEvC,aAAW,OAAO,MAAM;AACpB,QAAI;AACA,YAAM,QAAQ,MAAM,OAAO,IAAI,UAAU,GAAG;AAC5C,UAAI,UAAU,QAAW;AAErB,cAAM,OAAO,MAAM,OAAO,SAAS,UAAU,GAAG;AAChD,YAAI,KAAK,SAAS,GAAG;AACjB;AAAA,QACJ;AAEA,cAAM,SAAS,KAAK,OAAO;AAC3B,cAAM,OAAO,oBAAoB,UAAU,KAAK,MAAM;AAEtD,eAAO,iBAAiB;AACxB;AAAA,MACJ;AAEA,YAAM,OAAO,IAAI,UAAU,KAAK,KAAK;AACrC,aAAO,iBAAiB;AAAA,IAC5B,SAAS,KAAK;AACV,aAAO,gBAAgB;AACvB,aAAO,aAAa,KAAK;AAAA,QACrB;AAAA,QACA;AAAA,QACA,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,MAC1D,CAAC;AACD,aAAO,KAAK,sBAAsB,mBAAmB,UAAU,GAAG,CAAC,aAAa,GAAG,EAAE;AAAA,IACzF;AAAA,EACJ;AAGA,QAAM,cAAc,MAAM,OAAO,SAAS,QAAQ;AAClD,QAAM,WAA4B,CAAC;AAEnC,cAAY,QAAQ,YAAU;AAC1B,aAAS;AAAA,MACL,eAAe;AAAA,QACX,GAAG;AAAA,QACH,UAAU,CAAC,GAAG,UAAU,MAAM;AAAA,MAClC,CAAC;AAAA,IACL;AAAA,EACJ,CAAC;AAGD,QAAM,qBAAqB,WAAW,UAAU,yCAAyC;AAC7F;AAEA,SAAS,mBAAmB,UAAoB,KAAa;AACzD,SAAO,GAAG,SAAS,KAAK,GAAG,CAAC,IAAI,GAAG;AACvC;",
+  "names": ["StorageMigration"]
+}

package/dist/esm/storage/StorageService.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2022-2026 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { MaybePromise } from "#util/Promises.js";
 import { Environment } from "../environment/Environment.js";
 import { Environmental } from "../environment/Environmental.js";
 import { Diagnostic } from "../log/Diagnostic.js";
@@ -14,7 +15,7 @@ import { StorageManager } from "./StorageManager.js";
 export declare class StorageService {
     #private;
     [Diagnostic.value]: () => (string | (Record<string, unknown> & Diagnostic))[];
-    constructor(environment: Environment, factory?: (namespace: string) => Storage, resolver?: (...paths: string[]) => string);
+    constructor(environment: Environment, factory?: (namespace: string) => MaybePromise<Storage>, resolver?: (...paths: string[]) => string);
     static [Environmental.create](environment: Environment): StorageService;
     /**
      * Open storage.  The storage is initialized but the caller must take ownership.
@@ -25,7 +26,7 @@ export declare class StorageService {
     /**
      * Install a factory for opening storage.  Without such a factory storage is unavailable.
      */
-    set factory(factory: (namespace: string) => Storage);
+    set factory(factory: (namespace: string) => MaybePromise<Storage>);
     /**
      * The storage location.  Only used for diagnostic purposes.
      */

package/dist/esm/storage/StorageService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageService.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,cAAc;;IA4DvB,CAAC,UAAU,CAAC,KAAK,CAAC;gBAvDd,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EACxC,QAAQ,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM;IAU7C,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,WAAW;IAItD;;;;OAIG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM;IAW5B;;OAEG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EAElD;IAED;;OAEG;IACH,IAAI,QAAQ,IAIW,MAAM,GAAG,SAAS,CAFxC;IAED,IAAI,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAExC;IAED;;OAEG;IACH,OAAO,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;CAW3C"}
+{"version":3,"file":"StorageService.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,cAAc;;IA6DvB,CAAC,UAAU,CAAC,KAAK,CAAC;gBAxDd,WAAW,EAAE,WAAW,EAExB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,YAAY,CAAC,OAAO,CAAC,EACtD,QAAQ,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM;IAU7C,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,WAAW;IAItD;;;;OAIG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM;IAW5B;;OAEG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,YAAY,CAAC,OAAO,CAAC,EAEhE;IAED;;OAEG;IACH,IAAI,QAAQ,IAIW,MAAM,GAAG,SAAS,CAFxC;IAED,IAAI,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAExC;IAED;;OAEG;IACH,OAAO,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;CAW3C"}

package/dist/esm/storage/StorageService.js

@@ -27,7 +27,7 @@ class StorageService {
     if (this.#factory === void 0) {
       throw new NoProviderError("Storage is unavailable because no platform implementation is installed");
     }
-    const storage = this.#factory(namespace);
+    const storage = await this.#factory(namespace);
     const manager = new StorageManager(storage);
     await manager.initialize();
     return manager;

package/dist/esm/storage/StorageService.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/StorageService.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,uBAAuB;AAEhC,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB;AAE3B,SAAS,sBAAsB;AAKxB,MAAM,eAAe;AAAA,EACxB;AAAA,EACA;AAAA,EAEA,YACI,aACA,SACA,UACF;AACE,gBAAY,IAAI,gBAAgB,IAAI;AACpC,SAAK,WAAW;AAIhB,SAAK,UAAU,aAAa,IAAI,UAAc,MAAM,KAAK,GAAG;AAAA,EAChE;AAAA,EAEA,QAAQ,cAAc,MAAM,EAAE,aAA0B;AACpD,WAAO,IAAI,KAAK,WAAW;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,KAAK,WAAmB;AAC1B,QAAI,KAAK,aAAa,QAAW;AAC7B,YAAM,IAAI,gBAAgB,wEAAwE;AAAA,IACtG;AAEA,UAAM,UAAU,KAAK,SAAS,SAAS;AACvC,UAAM,UAAU,IAAI,eAAe,OAAO;AAC1C,UAAM,QAAQ,WAAW;AACzB,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,QAAQ,SAAyC;AACjD,SAAK,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,WAAW;AACX,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,SAASA,WAA8B;AACvC,SAAK,YAAYA;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA,EAKA;AAAA,EAEA,CAAC,WAAW,KAAK,IAAI;AACjB,WAAO;AAAA,MACH;AAAA,MACA,WAAW,KAAK;AAAA,QACZ,UAAU,YAAY;AAAA,QACtB,WAAW,CAAC,CAAC,KAAK;AAAA,MACtB,CAAC;AAAA,IACL;AAAA,EACJ;AACJ;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,uBAAuB;AAEhC,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB;AAE3B,SAAS,sBAAsB;AAKxB,MAAM,eAAe;AAAA,EACxB;AAAA,EACA;AAAA,EAEA,YACI,aAEA,SACA,UACF;AACE,gBAAY,IAAI,gBAAgB,IAAI;AACpC,SAAK,WAAW;AAIhB,SAAK,UAAU,aAAa,IAAI,UAAc,MAAM,KAAK,GAAG;AAAA,EAChE;AAAA,EAEA,QAAQ,cAAc,MAAM,EAAE,aAA0B;AACpD,WAAO,IAAI,KAAK,WAAW;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,KAAK,WAAmB;AAC1B,QAAI,KAAK,aAAa,QAAW;AAC7B,YAAM,IAAI,gBAAgB,wEAAwE;AAAA,IACtG;AAEA,UAAM,UAAU,MAAM,KAAK,SAAS,SAAS;AAC7C,UAAM,UAAU,IAAI,eAAe,OAAO;AAC1C,UAAM,QAAQ,WAAW;AACzB,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,QAAQ,SAAuD;AAC/D,SAAK,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,WAAW;AACX,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,SAASA,WAA8B;AACvC,SAAK,YAAYA;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA,EAKA;AAAA,EAEA,CAAC,WAAW,KAAK,IAAI;AACjB,WAAO;AAAA,MACH;AAAA,MACA,WAAW,KAAK;AAAA,QACZ,UAAU,YAAY;AAAA,QACtB,WAAW,CAAC,CAAC,KAAK;AAAA,MACtB,CAAC;AAAA,IACL;AAAA,EACJ;AACJ;",
   "names": ["location"]
 }

package/dist/esm/storage/index.d.ts

@@ -8,6 +8,7 @@ export * from "./Storage.js";
 export * from "./StorageBackendMemory.js";
 export * from "./StorageContext.js";
 export * from "./StorageManager.js";
+export * from "./StorageMigration.js";
 export * from "./StorageService.js";
 export * from "./StringifyTools.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/esm/storage/index.js

@@ -8,6 +8,7 @@ export * from "./Storage.js";
 export * from "./StorageBackendMemory.js";
 export * from "./StorageContext.js";
 export * from "./StorageManager.js";
+export * from "./StorageMigration.js";
 export * from "./StorageService.js";
 export * from "./StringifyTools.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/storage/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/index.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/general",
-    "version": "0.16.6-alpha.0-20260121-06f1d9611",
+    "version": "0.16.6-alpha.0-20260122-b5154bcb4",
     "description": "Non-Matter support for Matter.js",
     "keywords": [
         "iot",
@@ -36,7 +36,7 @@
         "@noble/curves": "^2.0.1"
     },
     "devDependencies": {
-        "@matter/testing": "0.16.6-alpha.0-20260121-06f1d9611"
+        "@matter/testing": "0.16.6-alpha.0-20260122-b5154bcb4"
     },
     "files": [
         "dist/**/*",

package/src/storage/Storage.ts

@@ -25,6 +25,8 @@ export abstract class Storage {
     abstract values(contexts: string[]): MaybePromise<Record<string, SupportedStorageTypes>>;
     abstract contexts(contexts: string[]): MaybePromise<string[]>;
     abstract clearAll(contexts: string[]): MaybePromise<void>;
+    // TODO: use `completely` variable for removing storage completely
+    abstract clear(completely?: boolean): MaybePromise<void>;
 
     /**
      * Checks if a key exists in the storage for the given contexts.

package/src/storage/StorageMigration.ts

@@ -0,0 +1,141 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { Logger } from "#log/Logger.js";
+import { MatterAggregateError } from "#MatterError.js";
+import type { Storage } from "./Storage.js";
+
+const logger = new Logger("StorageMigrator");
+
+/**
+ * A simple storage migrator of storage.
+ *
+ * It does not modify or remove source data.
+ */
+export namespace StorageMigration {
+    export interface MigrationSkipped {
+        contexts: string[];
+        key: string;
+        error: string;
+    }
+
+    export interface MigrationResult {
+        success: boolean;
+        migratedCount: number;
+        skippedCount: number;
+        skippedItems: MigrationSkipped[];
+    }
+
+    /**
+     * Migrate storage from `source` to `target`.
+     */
+    export async function migrate(source: Storage, target: Storage): Promise<MigrationResult> {
+        const result = {
+            success: true,
+            migratedCount: 0,
+            skippedCount: 0,
+            skippedItems: [],
+        };
+
+        // Migrate all contexts recursively
+        await migrateContext({
+            source,
+            target,
+            contexts: [],
+            result,
+        });
+
+        // Result
+        result.success = result.skippedCount === 0;
+        return result;
+    }
+
+    /**
+     * Export migration result to log
+     */
+    export function resultToLog(result: MigrationResult) {
+        const timestamp = new Date().toISOString();
+
+        let logContent = `
+    # Migration Log
+    - Timestamp: ${timestamp}
+    - Success: ${result.success}
+    - Migrated: ${result.migratedCount}
+    - Skipped: ${result.skippedCount}
+    `.replace(/^\s+/gm, "");
+        if (result.skippedCount > 0 && result.skippedItems.length > 0) {
+            logContent += `\n## Skipped Items\n`;
+            for (const item of result.skippedItems) {
+                logContent += `- ${buildContextKeyLog(item.contexts, item.key)}: ${item.error}\n`;
+            }
+        }
+
+        return logContent;
+    }
+}
+
+/**
+ * Migrate a specific context and its sub-contexts recursively
+ */
+async function migrateContext(args: {
+    source: Storage;
+    target: Storage;
+    contexts: string[];
+    result: StorageMigration.MigrationResult;
+}) {
+    const { source, target, contexts, result } = args;
+    const keys = await source.keys(contexts);
+
+    for (const key of keys) {
+        try {
+            const value = await source.get(contexts, key);
+            if (value === undefined) {
+                // Blob
+                const blob = await source.openBlob(contexts, key);
+                if (blob.size === 0) {
+                    continue;
+                }
+
+                const stream = blob.stream();
+                await target.writeBlobFromStream(contexts, key, stream);
+
+                result.migratedCount += 1;
+                continue;
+            }
+            // Json
+            await target.set(contexts, key, value);
+            result.migratedCount += 1;
+        } catch (err) {
+            result.skippedCount += 1;
+            result.skippedItems.push({
+                contexts,
+                key,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            logger.warn(`[migrate] Skipped '${buildContextKeyLog(contexts, key)}' entity: ${err}`);
+        }
+    }
+
+    // Migrate subcontext recursively
+    const subContexts = await source.contexts(contexts);
+    const promises: Promise<void>[] = [];
+
+    subContexts.forEach(subCon => {
+        promises.push(
+            migrateContext({
+                ...args,
+                contexts: [...contexts, subCon],
+            }),
+        );
+    });
+
+    // Promise.all with try catch
+    await MatterAggregateError.allSettled(promises, "[migrate] Error migrating sub-contexts!");
+}
+
+function buildContextKeyLog(contexts: string[], key: string) {
+    return `${contexts.join(".")}$${key}`;
+}

package/src/storage/StorageService.ts

@@ -3,6 +3,7 @@
  * Copyright 2022-2026 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { MaybePromise } from "#util/Promises.js";
 
 import { NoProviderError } from "../MatterError.js";
 import { Environment } from "../environment/Environment.js";
@@ -15,12 +16,13 @@ import { StorageManager } from "./StorageManager.js";
  * Service adapter for the Matter.js storage API.
  */
 export class StorageService {
-    #factory?: (namespace: string) => Storage;
+    #factory?: (namespace: string) => MaybePromise<Storage>;
     #location?: string;
 
     constructor(
         environment: Environment,
-        factory?: (namespace: string) => Storage,
+
+        factory?: (namespace: string) => MaybePromise<Storage>,
         resolver?: (...paths: string[]) => string,
     ) {
         environment.set(StorageService, this);
@@ -45,7 +47,7 @@ export class StorageService {
             throw new NoProviderError("Storage is unavailable because no platform implementation is installed");
         }
 
-        const storage = this.#factory(namespace);
+        const storage = await this.#factory(namespace);
         const manager = new StorageManager(storage);
         await manager.initialize();
         return manager;
@@ -54,7 +56,7 @@ export class StorageService {
     /**
      * Install a factory for opening storage.  Without such a factory storage is unavailable.
      */
-    set factory(factory: (namespace: string) => Storage) {
+    set factory(factory: (namespace: string) => MaybePromise<Storage>) {
         this.#factory = factory;
     }
 

package/src/storage/index.ts

@@ -9,5 +9,6 @@ export * from "./Storage.js";
 export * from "./StorageBackendMemory.js";
 export * from "./StorageContext.js";
 export * from "./StorageManager.js";
+export * from "./StorageMigration.js";
 export * from "./StorageService.js";
 export * from "./StringifyTools.js";