@matter/general 0.15.3 → 0.16.0-alpha.0-20250802-1af103e3d

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

@@ -11,34 +11,11 @@ export declare class StorageError extends MatterError {
 /**
  * Matter.js uses this key/value API to manage persistent state.
  */
-export interface Storage {
-    readonly initialized: boolean;
-    initialize(): MaybePromise<void>;
-    close(): MaybePromise<void>;
-    get(contexts: string[], key: string): MaybePromise<SupportedStorageTypes | undefined>;
-    set(contexts: string[], values: Record<string, SupportedStorageTypes>): MaybePromise<void>;
-    set(contexts: string[], key: string, value: SupportedStorageTypes): MaybePromise<void>;
-    delete(contexts: string[], key: string): MaybePromise<void>;
-    keys(contexts: string[]): MaybePromise<string[]>;
-    values(contexts: string[]): MaybePromise<Record<string, SupportedStorageTypes>>;
-    contexts(contexts: string[]): MaybePromise<string[]>;
-    clearAll(contexts: string[]): MaybePromise<void>;
-}
-/**
- * Extended interface for storage that supports snapshotting.
- */
-export interface CloneableStorage {
-    clone(): MaybePromise<Storage>;
-}
-export declare namespace CloneableStorage {
-    function is<T extends {}>(storage: T): storage is T & CloneableStorage;
-    function assert<T extends {}>(storage: T): asserts storage is T & CloneableStorage;
-}
-export declare abstract class MaybeAsyncStorage implements Storage {
-    abstract initialized: boolean;
+export declare abstract class Storage {
+    abstract readonly initialized: boolean;
     abstract initialize(): MaybePromise<void>;
     abstract close(): MaybePromise<void>;
-    abstract get<T extends SupportedStorageTypes>(contexts: string[], key: string): MaybePromise<T | undefined>;
+    abstract get(contexts: string[], key: string): MaybePromise<SupportedStorageTypes | undefined>;
     abstract set(contexts: string[], values: Record<string, SupportedStorageTypes>): MaybePromise<void>;
     abstract set(contexts: string[], key: string, value: SupportedStorageTypes): MaybePromise<void>;
     abstract delete(contexts: string[], key: string): MaybePromise<void>;
@@ -46,19 +23,23 @@ export declare abstract class MaybeAsyncStorage implements Storage {
     abstract values(contexts: string[]): MaybePromise<Record<string, SupportedStorageTypes>>;
     abstract contexts(contexts: string[]): MaybePromise<string[]>;
     abstract clearAll(contexts: string[]): 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.
+     * Please implement this method in your storage implementation if you want to optimize it.
+     */
+    has(contexts: string[], key: string): MaybePromise<boolean>;
+    abstract openBlob(contexts: string[], key: string): MaybePromise<Blob>;
+    abstract writeBlobFromStream(contexts: string[], key: string, stream: ReadableStream<Uint8Array>): MaybePromise<void>;
 }
-export declare abstract class SyncStorage implements Storage {
-    abstract initialized: boolean;
-    abstract initialize(): MaybePromise<void>;
-    abstract close(): MaybePromise<void>;
-    abstract get<T extends SupportedStorageTypes>(contexts: string[], key: string): T | undefined;
-    abstract set(contexts: string[], values: Record<string, SupportedStorageTypes>): void;
-    abstract set(contexts: string[], key: string, value: SupportedStorageTypes): void;
-    abstract delete(contexts: string[], key: string): void;
-    abstract keys(contexts: string[]): string[];
-    abstract values(contexts: string[]): Record<string, SupportedStorageTypes>;
-    abstract contexts(contexts: string[]): string[];
-    abstract clearAll(contexts: string[]): void;
+/**
+ * Extended interface for storage that supports snapshotting.
+ */
+export interface CloneableStorage {
+    clone(): MaybePromise<Storage>;
+}
+export declare namespace CloneableStorage {
+    function is<T extends {}>(storage: T): storage is T & CloneableStorage;
+    function assert<T extends {}>(storage: T): asserts storage is T & CloneableStorage;
 }
-export type StorageOperationResult<S extends Storage, T = void> = S extends SyncStorage ? T : Promise<T>;
 //# sourceMappingURL=Storage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../src/storage/Storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../src/storage/Storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,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,CACxB,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,YAAY,CAAC,IAAI,CAAC;CACxB;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

@@ -19,12 +19,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var Storage_exports = {};
 __export(Storage_exports, {
   CloneableStorage: () => CloneableStorage,
-  MaybeAsyncStorage: () => MaybeAsyncStorage,
-  StorageError: () => StorageError,
-  SyncStorage: () => SyncStorage
+  Storage: () => Storage,
+  StorageError: () => StorageError
 });
 module.exports = __toCommonJS(Storage_exports);
 var import_MatterError = require("../MatterError.js");
+var import_Promises = require("../util/Promises.js");
 /**
  * @license
  * Copyright 2022-2025 Matter.js Authors
@@ -32,6 +32,20 @@ var import_MatterError = require("../MatterError.js");
  */
 class StorageError extends import_MatterError.MatterError {
 }
+class Storage {
+  /**
+   * 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.
+   * Please implement this method in your storage implementation if you want to optimize it.
+   */
+  has(contexts, key) {
+    const value = this.get(contexts, key);
+    if (import_Promises.MaybePromise.is(value)) {
+      return import_Promises.MaybePromise.then(value, (v) => v !== void 0);
+    }
+    return value !== void 0;
+  }
+}
 var CloneableStorage;
 ((CloneableStorage2) => {
   function is(storage) {
@@ -45,8 +59,4 @@ var CloneableStorage;
   }
   CloneableStorage2.assert = assert;
 })(CloneableStorage || (CloneableStorage = {}));
-class MaybeAsyncStorage {
-}
-class SyncStorage {
-}
 //# sourceMappingURL=Storage.js.map

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;AAAA;AAKA,yBAAiD;AALjD;AAAA;AAAA;AAAA;AAAA;AASO,MAAM,qBAAqB,+BAAY;AAAC;AA0BxC,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;AAeV,MAAe,kBAAqC;AAY3D;AAGO,MAAe,YAA+B;AAYrD;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,yBAAiD;AACjD,sBAA6B;AAN7B;AAAA;AAAA;AAAA;AAAA;AASO,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;AAQJ;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/StorageBackendMemory.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { CloneableStorage, SyncStorage } from "./Storage.js";
+import { CloneableStorage, Storage } from "./Storage.js";
 import { SupportedStorageTypes } from "./StringifyTools.js";
-export declare class StorageBackendMemory extends SyncStorage implements CloneableStorage {
+export declare class StorageBackendMemory extends Storage implements CloneableStorage {
     #private;
     protected store: any;
     protected isInitialized: boolean;
@@ -18,7 +18,9 @@ export declare class StorageBackendMemory extends SyncStorage implements Cloneab
     close(): Promise<void>;
     clear(): void;
     get data(): any;
-    get<T extends SupportedStorageTypes>(contexts: string[], key: string): T | undefined;
+    get(contexts: string[], key: string): SupportedStorageTypes | undefined;
+    openBlob(contexts: string[], key: string): Blob;
+    writeBlobFromStream(contexts: string[], key: string, stream: ReadableStream<Uint8Array>): Promise<void>;
     set(contexts: string[], keyOrValues: string | Record<string, SupportedStorageTypes>, value?: SupportedStorageTypes): void;
     delete(contexts: string[], key: string): void;
     keys(contexts: string[]): string[];

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

@@ -1 +1 @@
-{"version":3,"file":"StorageBackendMemory.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageBackendMemory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAgB,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qBAAa,oBAAqB,SAAQ,WAAY,YAAW,gBAAgB;;IAGjE,SAAS,CAAC,KAAK,EAAE,GAAG;IAFhC,SAAS,CAAC,aAAa,UAAS;gBAEV,KAAK,GAAE,GAAQ;IAIrC,IAAI,WAAW,YAEd;WAEY,MAAM,CAAC,KAAK,GAAE,GAAQ;IAMnC,OAAO,CAAC,gBAAgB;IAOxB,UAAU;IAMV,KAAK;IAMC,KAAK;IAKX,KAAK;IAIL,IAAI,IAAI,QAEP;IAED,GAAG,CAAC,CAAC,SAAS,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAepF,GAAG,CACC,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAC3D,KAAK,CAAC,EAAE,qBAAqB;IAYjC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM;IAMtC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE;IAMvB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE;IASzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAkB3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;CAqB9B"}
+{"version":3,"file":"StorageBackendMemory.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageBackendMemory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qBAAa,oBAAqB,SAAQ,OAAQ,YAAW,gBAAgB;;IAG7D,SAAS,CAAC,KAAK,EAAE,GAAG;IAFhC,SAAS,CAAC,aAAa,UAAS;gBAEV,KAAK,GAAE,GAAQ;IAIrC,IAAI,WAAW,YAEd;WAEY,MAAM,CAAC,KAAK,GAAE,GAAQ;IAMnC,OAAO,CAAC,gBAAgB;IAOxB,UAAU;IAMV,KAAK;IAMC,KAAK;IAKX,KAAK;IAIL,IAAI,IAAI,QAEP;IAED,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAMvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAWzC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC7G,GAAG,CACC,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAC3D,KAAK,CAAC,EAAE,qBAAqB;IAYjC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM;IAMtC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE;IAMvB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE;IASzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAkB3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;CAqB9B"}

package/dist/cjs/storage/StorageBackendMemory.js

@@ -28,7 +28,7 @@ var import_Storage = require("./Storage.js");
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-class StorageBackendMemory extends import_Storage.SyncStorage {
+class StorageBackendMemory extends import_Storage.Storage {
   constructor(store = {}) {
     super();
     this.store = store;
@@ -71,6 +71,39 @@ class StorageBackendMemory extends import_Storage.SyncStorage {
     if (!contexts.length || !key.length) throw new import_Storage.StorageError("Context and key must not be empty.");
     return this.store[this.createContextKey(contexts)]?.[key];
   }
+  openBlob(contexts, key) {
+    const value = this.get(contexts, key);
+    if (value === void 0) {
+      return new Blob([]);
+    }
+    if (!(value instanceof Uint8Array)) {
+      throw new import_Storage.StorageError("Value must be an Uint8Array to read as blob stream.");
+    }
+    return new Blob([value]);
+  }
+  async writeBlobFromStream(contexts, key, stream) {
+    this.#assertInitialized();
+    const reader = stream.getReader();
+    const chunks = [];
+    try {
+      let length = 0;
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        chunks.push(value);
+        length += value.length;
+      }
+      const combined = new Uint8Array(length);
+      let offset = 0;
+      for (const chunk of chunks) {
+        combined.set(chunk, offset);
+        offset += chunk.length;
+      }
+      this.#setKey(contexts, key, combined);
+    } catch (error) {
+      throw new import_Storage.StorageError(`Error reading stream: ${error.message}`);
+    }
+  }
   #setKey(contexts, key, value) {
     if (!contexts.length || !key.length) throw new import_Storage.StorageError("Context and key must not be empty.");
     const contextKey = this.createContextKey(contexts);

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/StorageBackendMemory.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["value"]
 }

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

@@ -3,27 +3,30 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Storage, StorageOperationResult } from "./Storage.js";
+import { MaybePromise } from "../util/Promises.js";
+import { Storage } from "./Storage.js";
 import { SupportedStorageTypes } from "./StringifyTools.js";
-export interface StorageContextFactory<S extends Storage = any> {
-    createContext(context: string): StorageContext<S>;
+export interface StorageContextFactory {
+    createContext(context: string): StorageContext;
 }
-export declare class StorageContext<S extends Storage = any> implements StorageContextFactory<S> {
-    private readonly storage;
+export declare class StorageContext implements StorageContextFactory {
+    protected readonly storage: Storage;
     readonly thisContexts: string[];
-    constructor(storage: S, thisContexts: string[]);
-    get<T extends SupportedStorageTypes>(key: string, defaultValue?: T): StorageOperationResult<S, T>;
-    has(key: string): StorageOperationResult<S, boolean>;
-    set(key: string, value: SupportedStorageTypes): StorageOperationResult<S>;
-    set(values: Record<string, SupportedStorageTypes>): StorageOperationResult<S>;
-    delete(key: string): StorageOperationResult<S>;
-    createContext(context: string): StorageContext<S>;
-    keys(): StorageOperationResult<S, string[]>;
-    values(): StorageOperationResult<S, Record<string, SupportedStorageTypes>>;
-    contexts(): StorageOperationResult<S, string[]>;
+    constructor(storage: Storage, thisContexts: string[]);
+    get<T extends SupportedStorageTypes>(key: string, defaultValue?: T): MaybePromise<T>;
+    has(key: string): MaybePromise<boolean>;
+    set(key: string, value: SupportedStorageTypes): MaybePromise<void>;
+    set(values: Record<string, SupportedStorageTypes>): MaybePromise<void>;
+    delete(key: string): MaybePromise<void>;
+    createContext(context: string): StorageContext;
+    keys(): MaybePromise<string[]>;
+    values(): MaybePromise<Record<string, SupportedStorageTypes>>;
+    contexts(): MaybePromise<string[]>;
     /** Clears all keys in this context */
-    clear(): StorageOperationResult<S>;
+    clear(): PromiseLike<void> | undefined;
     /** Clears all keys in this context and all created sub-contexts. */
-    clearAll(): StorageOperationResult<S>;
+    clearAll(): MaybePromise<void>;
+    openBlob(key: string): MaybePromise<Blob>;
+    writeBlobFromStream(key: string, stream: ReadableStream<Uint8Array>): MaybePromise<void>;
 }
 //# sourceMappingURL=StorageContext.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StorageContext.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,OAAO,EAAgB,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,OAAO,GAAG,GAAG;IAC1D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;CACrD;AAED,qBAAa,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,GAAG,CAAE,YAAW,qBAAqB,CAAC,CAAC,CAAC;IAEhF,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE;gBADd,OAAO,EAAE,CAAC,EAClB,YAAY,EAAE,MAAM,EAAE;IAGnC,GAAG,CAAC,CAAC,SAAS,qBAAqB,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC;IAwBjG,GAAG,CAAC,GAAG,EAAE,MAAM;IAWf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CAAC,CAAC,CAAC;IACzE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC;IAQ7E,MAAM,CAAC,GAAG,EAAE,MAAM,GACwC,sBAAsB,CAAC,CAAC,CAAC;IAGnF,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;IAMjD,IAAI,IAC+C,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IAGtF,MAAM,IAC+C,sBAAsB,CACnE,CAAC,EACD,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CACxC;IAGL,QAAQ,IAC+C,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IAG1F,sCAAsC;IACtC,KAAK;IAyBL,oEAAoE;IACpE,QAAQ,IAC+C,sBAAsB,CAAC,CAAC,CAAC;CAEnF"}
+{"version":3,"file":"StorageContext.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IAClC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC;CAClD;AAED,qBAAa,cAAe,YAAW,qBAAqB;IAEpD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE;gBADZ,OAAO,EAAE,OAAO,EAC1B,YAAY,EAAE,MAAM,EAAE;IAGnC,GAAG,CAAC,CAAC,SAAS,qBAAqB,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAwBpF,GAAG,CAAC,GAAG,EAAE,MAAM;IAIf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAAC,IAAI,CAAC;IAClE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;IAQtE,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAM9C,IAAI;IAIJ,MAAM;IAIN,QAAQ;IAIR,sCAAsC;IACtC,KAAK;IAuBL,oEAAoE;IACpE,QAAQ;IAIR,QAAQ,CAAC,GAAG,EAAE,MAAM;IAIpB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC;CAGtE"}

package/dist/cjs/storage/StorageContext.js

@@ -58,14 +58,7 @@ class StorageContext {
     return defaultValue;
   }
   has(key) {
-    const value = this.storage.get(this.thisContexts, key);
-    if (value !== void 0) {
-      if (import_Promises.MaybePromise.is(value)) {
-        return value.then((v) => v !== void 0);
-      }
-      return true;
-    }
-    return false;
+    return this.storage.has(this.thisContexts, key);
   }
   set(keyOrValues, value) {
     if (typeof keyOrValues === "string") {
@@ -110,10 +103,8 @@ class StorageContext {
       }
     });
     if (promises.length > 0) {
-      return import_MatterError.MatterAggregateError.allSettled(promises, "Error while clearing storage").then(
-        () => {
-        }
-      );
+      return import_MatterError.MatterAggregateError.allSettled(promises, "Error while clearing storage").then(() => {
+      });
     }
     return void 0;
   }
@@ -121,5 +112,11 @@ class StorageContext {
   clearAll() {
     return this.storage.clearAll(this.thisContexts);
   }
+  openBlob(key) {
+    return this.storage.openBlob(this.thisContexts, key);
+  }
+  writeBlobFromStream(key, stream) {
+    return this.storage.writeBlobFromStream(this.thisContexts, key, stream);
+  }
 }
 //# sourceMappingURL=StorageContext.js.map

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/StorageContext.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["keys"]
 }

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

@@ -6,12 +6,12 @@
 import { MaybePromise } from "../util/Promises.js";
 import { Storage } from "./Storage.js";
 import { StorageContext, StorageContextFactory } from "./StorageContext.js";
-export declare class StorageManager<S extends Storage = any> implements StorageContextFactory<S> {
+export declare class StorageManager implements StorageContextFactory {
     private storage;
     private initialized;
-    constructor(storage: S);
+    constructor(storage: Storage);
     initialize(): MaybePromise<void>;
     close(): MaybePromise<void>;
-    createContext(context: string): StorageContext<S>;
+    createContext(context: string): StorageContext;
 }
 //# sourceMappingURL=StorageManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StorageManager.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,qBAAa,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,GAAG,CAAE,YAAW,qBAAqB,CAAC,CAAC,CAAC;IAGxE,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,WAAW,CAAS;gBAER,OAAO,EAAE,CAAC;IAE9B,UAAU,IAAI,YAAY,CAAC,IAAI,CAAC;IAYhC,KAAK;IAKL,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;CAMpD"}
+{"version":3,"file":"StorageManager.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,qBAAa,cAAe,YAAW,qBAAqB;IAG5C,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,WAAW,CAAS;gBAER,OAAO,EAAE,OAAO;IAEpC,UAAU,IAAI,YAAY,CAAC,IAAI,CAAC;IAYhC,KAAK;IAKL,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;CAMjD"}

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/StorageManager.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,sBAA6B;AAC7B,qBAAsC;AACtC,4BAAsD;AARtD;AAAA;AAAA;AAAA;AAAA;AAUO,MAAM,eAA4E;AAAA,EAGrF,YAAoB,SAAY;AAAZ;AAAA,EAAa;AAAA,EAFzB,cAAc;AAAA,EAItB,aAAiC;AAC7B,QAAI,CAAC,KAAK,QAAQ,aAAa;AAC3B,YAAM,OAAO,KAAK,QAAQ,WAAW;AACrC,UAAI,6BAAa,GAAG,IAAI,GAAG;AACvB,eAAO,KAAK,KAAK,MAAM;AACnB,eAAK,cAAc;AAAA,QACvB,CAAC;AAAA,MACL;AAAA,IACJ;AACA,SAAK,cAAc;AAAA,EACvB;AAAA,EAEA,QAAQ;AACJ,SAAK,cAAc;AACnB,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC9B;AAAA,EAEA,cAAc,SAAoC;AAC9C,QAAI,CAAC,KAAK,YAAa,OAAM,IAAI,4BAAa,4CAA4C;AAC1F,QAAI,CAAC,QAAQ,OAAQ,OAAM,IAAI,4BAAa,sCAAsC;AAClF,QAAI,QAAQ,SAAS,GAAG,EAAG,OAAM,IAAI,4BAAa,gCAAgC;AAClF,WAAO,IAAI,qCAAe,KAAK,SAAS,CAAC,OAAO,CAAC;AAAA,EACrD;AACJ;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,sBAA6B;AAC7B,qBAAsC;AACtC,4BAAsD;AARtD;AAAA;AAAA;AAAA;AAAA;AAUO,MAAM,eAAgD;AAAA,EAGzD,YAAoB,SAAkB;AAAlB;AAAA,EAAmB;AAAA,EAF/B,cAAc;AAAA,EAItB,aAAiC;AAC7B,QAAI,CAAC,KAAK,QAAQ,aAAa;AAC3B,YAAM,OAAO,KAAK,QAAQ,WAAW;AACrC,UAAI,6BAAa,GAAG,IAAI,GAAG;AACvB,eAAO,KAAK,KAAK,MAAM;AACnB,eAAK,cAAc;AAAA,QACvB,CAAC;AAAA,MACL;AAAA,IACJ;AACA,SAAK,cAAc;AAAA,EACvB;AAAA,EAEA,QAAQ;AACJ,SAAK,cAAc;AACnB,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC9B;AAAA,EAEA,cAAc,SAAiC;AAC3C,QAAI,CAAC,KAAK,YAAa,OAAM,IAAI,4BAAa,4CAA4C;AAC1F,QAAI,CAAC,QAAQ,OAAQ,OAAM,IAAI,4BAAa,sCAAsC;AAClF,QAAI,QAAQ,SAAS,GAAG,EAAG,OAAM,IAAI,4BAAa,gCAAgC;AAClF,WAAO,IAAI,qCAAe,KAAK,SAAS,CAAC,OAAO,CAAC;AAAA,EACrD;AACJ;",
   "names": []
 }

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

@@ -20,7 +20,7 @@ export declare class StorageService {
      *
      * @param namespace a unique namespace identifier such as a root node ID
      */
-    open(namespace: string): Promise<StorageManager<Storage>>;
+    open(namespace: string): Promise<StorageManager>;
     /**
      * Install a factory for opening storage.  Without such a factory storage is unavailable.
      */

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

@@ -11,34 +11,11 @@ export declare class StorageError extends MatterError {
 /**
  * Matter.js uses this key/value API to manage persistent state.
  */
-export interface Storage {
-    readonly initialized: boolean;
-    initialize(): MaybePromise<void>;
-    close(): MaybePromise<void>;
-    get(contexts: string[], key: string): MaybePromise<SupportedStorageTypes | undefined>;
-    set(contexts: string[], values: Record<string, SupportedStorageTypes>): MaybePromise<void>;
-    set(contexts: string[], key: string, value: SupportedStorageTypes): MaybePromise<void>;
-    delete(contexts: string[], key: string): MaybePromise<void>;
-    keys(contexts: string[]): MaybePromise<string[]>;
-    values(contexts: string[]): MaybePromise<Record<string, SupportedStorageTypes>>;
-    contexts(contexts: string[]): MaybePromise<string[]>;
-    clearAll(contexts: string[]): MaybePromise<void>;
-}
-/**
- * Extended interface for storage that supports snapshotting.
- */
-export interface CloneableStorage {
-    clone(): MaybePromise<Storage>;
-}
-export declare namespace CloneableStorage {
-    function is<T extends {}>(storage: T): storage is T & CloneableStorage;
-    function assert<T extends {}>(storage: T): asserts storage is T & CloneableStorage;
-}
-export declare abstract class MaybeAsyncStorage implements Storage {
-    abstract initialized: boolean;
+export declare abstract class Storage {
+    abstract readonly initialized: boolean;
     abstract initialize(): MaybePromise<void>;
     abstract close(): MaybePromise<void>;
-    abstract get<T extends SupportedStorageTypes>(contexts: string[], key: string): MaybePromise<T | undefined>;
+    abstract get(contexts: string[], key: string): MaybePromise<SupportedStorageTypes | undefined>;
     abstract set(contexts: string[], values: Record<string, SupportedStorageTypes>): MaybePromise<void>;
     abstract set(contexts: string[], key: string, value: SupportedStorageTypes): MaybePromise<void>;
     abstract delete(contexts: string[], key: string): MaybePromise<void>;
@@ -46,19 +23,23 @@ export declare abstract class MaybeAsyncStorage implements Storage {
     abstract values(contexts: string[]): MaybePromise<Record<string, SupportedStorageTypes>>;
     abstract contexts(contexts: string[]): MaybePromise<string[]>;
     abstract clearAll(contexts: string[]): 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.
+     * Please implement this method in your storage implementation if you want to optimize it.
+     */
+    has(contexts: string[], key: string): MaybePromise<boolean>;
+    abstract openBlob(contexts: string[], key: string): MaybePromise<Blob>;
+    abstract writeBlobFromStream(contexts: string[], key: string, stream: ReadableStream<Uint8Array>): MaybePromise<void>;
 }
-export declare abstract class SyncStorage implements Storage {
-    abstract initialized: boolean;
-    abstract initialize(): MaybePromise<void>;
-    abstract close(): MaybePromise<void>;
-    abstract get<T extends SupportedStorageTypes>(contexts: string[], key: string): T | undefined;
-    abstract set(contexts: string[], values: Record<string, SupportedStorageTypes>): void;
-    abstract set(contexts: string[], key: string, value: SupportedStorageTypes): void;
-    abstract delete(contexts: string[], key: string): void;
-    abstract keys(contexts: string[]): string[];
-    abstract values(contexts: string[]): Record<string, SupportedStorageTypes>;
-    abstract contexts(contexts: string[]): string[];
-    abstract clearAll(contexts: string[]): void;
+/**
+ * Extended interface for storage that supports snapshotting.
+ */
+export interface CloneableStorage {
+    clone(): MaybePromise<Storage>;
+}
+export declare namespace CloneableStorage {
+    function is<T extends {}>(storage: T): storage is T & CloneableStorage;
+    function assert<T extends {}>(storage: T): asserts storage is T & CloneableStorage;
 }
-export type StorageOperationResult<S extends Storage, T = void> = S extends SyncStorage ? T : Promise<T>;
 //# sourceMappingURL=Storage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../src/storage/Storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../src/storage/Storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,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,CACxB,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,YAAY,CAAC,IAAI,CAAC;CACxB;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

@@ -4,8 +4,23 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { ImplementationError, MatterError } from "../MatterError.js";
+import { MaybePromise } from "../util/Promises.js";
 class StorageError extends MatterError {
 }
+class Storage {
+  /**
+   * 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.
+   * Please implement this method in your storage implementation if you want to optimize it.
+   */
+  has(contexts, key) {
+    const value = this.get(contexts, key);
+    if (MaybePromise.is(value)) {
+      return MaybePromise.then(value, (v) => v !== void 0);
+    }
+    return value !== void 0;
+  }
+}
 var CloneableStorage;
 ((CloneableStorage2) => {
   function is(storage) {
@@ -19,14 +34,9 @@ var CloneableStorage;
   }
   CloneableStorage2.assert = assert;
 })(CloneableStorage || (CloneableStorage = {}));
-class MaybeAsyncStorage {
-}
-class SyncStorage {
-}
 export {
   CloneableStorage,
-  MaybeAsyncStorage,
-  StorageError,
-  SyncStorage
+  Storage,
+  StorageError
 };
 //# sourceMappingURL=Storage.js.map

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/Storage.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,SAAS,qBAAqB,mBAAmB;AAI1C,MAAM,qBAAqB,YAAY;AAAC;AA0BxC,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;AAeV,MAAe,kBAAqC;AAY3D;AAGO,MAAe,YAA+B;AAYrD;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,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;AAQJ;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/StorageBackendMemory.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { CloneableStorage, SyncStorage } from "./Storage.js";
+import { CloneableStorage, Storage } from "./Storage.js";
 import { SupportedStorageTypes } from "./StringifyTools.js";
-export declare class StorageBackendMemory extends SyncStorage implements CloneableStorage {
+export declare class StorageBackendMemory extends Storage implements CloneableStorage {
     #private;
     protected store: any;
     protected isInitialized: boolean;
@@ -18,7 +18,9 @@ export declare class StorageBackendMemory extends SyncStorage implements Cloneab
     close(): Promise<void>;
     clear(): void;
     get data(): any;
-    get<T extends SupportedStorageTypes>(contexts: string[], key: string): T | undefined;
+    get(contexts: string[], key: string): SupportedStorageTypes | undefined;
+    openBlob(contexts: string[], key: string): Blob;
+    writeBlobFromStream(contexts: string[], key: string, stream: ReadableStream<Uint8Array>): Promise<void>;
     set(contexts: string[], keyOrValues: string | Record<string, SupportedStorageTypes>, value?: SupportedStorageTypes): void;
     delete(contexts: string[], key: string): void;
     keys(contexts: string[]): string[];

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

@@ -1 +1 @@
-{"version":3,"file":"StorageBackendMemory.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageBackendMemory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAgB,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qBAAa,oBAAqB,SAAQ,WAAY,YAAW,gBAAgB;;IAGjE,SAAS,CAAC,KAAK,EAAE,GAAG;IAFhC,SAAS,CAAC,aAAa,UAAS;gBAEV,KAAK,GAAE,GAAQ;IAIrC,IAAI,WAAW,YAEd;WAEY,MAAM,CAAC,KAAK,GAAE,GAAQ;IAMnC,OAAO,CAAC,gBAAgB;IAOxB,UAAU;IAMV,KAAK;IAMC,KAAK;IAKX,KAAK;IAIL,IAAI,IAAI,QAEP;IAED,GAAG,CAAC,CAAC,SAAS,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAepF,GAAG,CACC,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAC3D,KAAK,CAAC,EAAE,qBAAqB;IAYjC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM;IAMtC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE;IAMvB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE;IASzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAkB3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;CAqB9B"}
+{"version":3,"file":"StorageBackendMemory.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageBackendMemory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qBAAa,oBAAqB,SAAQ,OAAQ,YAAW,gBAAgB;;IAG7D,SAAS,CAAC,KAAK,EAAE,GAAG;IAFhC,SAAS,CAAC,aAAa,UAAS;gBAEV,KAAK,GAAE,GAAQ;IAIrC,IAAI,WAAW,YAEd;WAEY,MAAM,CAAC,KAAK,GAAE,GAAQ;IAMnC,OAAO,CAAC,gBAAgB;IAOxB,UAAU;IAMV,KAAK;IAMC,KAAK;IAKX,KAAK;IAIL,IAAI,IAAI,QAEP;IAED,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAMvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAWzC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC7G,GAAG,CACC,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAC3D,KAAK,CAAC,EAAE,qBAAqB;IAYjC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM;IAMtC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE;IAMvB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE;IASzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAkB3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;CAqB9B"}

package/dist/esm/storage/StorageBackendMemory.js

@@ -4,8 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { deepCopy } from "#util/DeepCopy.js";
-import { StorageError, SyncStorage } from "./Storage.js";
-class StorageBackendMemory extends SyncStorage {
+import { Storage, StorageError } from "./Storage.js";
+class StorageBackendMemory extends Storage {
   constructor(store = {}) {
     super();
     this.store = store;
@@ -48,6 +48,39 @@ class StorageBackendMemory extends SyncStorage {
     if (!contexts.length || !key.length) throw new StorageError("Context and key must not be empty.");
     return this.store[this.createContextKey(contexts)]?.[key];
   }
+  openBlob(contexts, key) {
+    const value = this.get(contexts, key);
+    if (value === void 0) {
+      return new Blob([]);
+    }
+    if (!(value instanceof Uint8Array)) {
+      throw new StorageError("Value must be an Uint8Array to read as blob stream.");
+    }
+    return new Blob([value]);
+  }
+  async writeBlobFromStream(contexts, key, stream) {
+    this.#assertInitialized();
+    const reader = stream.getReader();
+    const chunks = [];
+    try {
+      let length = 0;
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        chunks.push(value);
+        length += value.length;
+      }
+      const combined = new Uint8Array(length);
+      let offset = 0;
+      for (const chunk of chunks) {
+        combined.set(chunk, offset);
+        offset += chunk.length;
+      }
+      this.#setKey(contexts, key, combined);
+    } catch (error) {
+      throw new StorageError(`Error reading stream: ${error.message}`);
+    }
+  }
   #setKey(contexts, key, value) {
     if (!contexts.length || !key.length) throw new StorageError("Context and key must not be empty.");
     const contextKey = this.createContextKey(contexts);

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/StorageBackendMemory.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["value"]
 }

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

@@ -3,27 +3,30 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Storage, StorageOperationResult } from "./Storage.js";
+import { MaybePromise } from "../util/Promises.js";
+import { Storage } from "./Storage.js";
 import { SupportedStorageTypes } from "./StringifyTools.js";
-export interface StorageContextFactory<S extends Storage = any> {
-    createContext(context: string): StorageContext<S>;
+export interface StorageContextFactory {
+    createContext(context: string): StorageContext;
 }
-export declare class StorageContext<S extends Storage = any> implements StorageContextFactory<S> {
-    private readonly storage;
+export declare class StorageContext implements StorageContextFactory {
+    protected readonly storage: Storage;
     readonly thisContexts: string[];
-    constructor(storage: S, thisContexts: string[]);
-    get<T extends SupportedStorageTypes>(key: string, defaultValue?: T): StorageOperationResult<S, T>;
-    has(key: string): StorageOperationResult<S, boolean>;
-    set(key: string, value: SupportedStorageTypes): StorageOperationResult<S>;
-    set(values: Record<string, SupportedStorageTypes>): StorageOperationResult<S>;
-    delete(key: string): StorageOperationResult<S>;
-    createContext(context: string): StorageContext<S>;
-    keys(): StorageOperationResult<S, string[]>;
-    values(): StorageOperationResult<S, Record<string, SupportedStorageTypes>>;
-    contexts(): StorageOperationResult<S, string[]>;
+    constructor(storage: Storage, thisContexts: string[]);
+    get<T extends SupportedStorageTypes>(key: string, defaultValue?: T): MaybePromise<T>;
+    has(key: string): MaybePromise<boolean>;
+    set(key: string, value: SupportedStorageTypes): MaybePromise<void>;
+    set(values: Record<string, SupportedStorageTypes>): MaybePromise<void>;
+    delete(key: string): MaybePromise<void>;
+    createContext(context: string): StorageContext;
+    keys(): MaybePromise<string[]>;
+    values(): MaybePromise<Record<string, SupportedStorageTypes>>;
+    contexts(): MaybePromise<string[]>;
     /** Clears all keys in this context */
-    clear(): StorageOperationResult<S>;
+    clear(): PromiseLike<void> | undefined;
     /** Clears all keys in this context and all created sub-contexts. */
-    clearAll(): StorageOperationResult<S>;
+    clearAll(): MaybePromise<void>;
+    openBlob(key: string): MaybePromise<Blob>;
+    writeBlobFromStream(key: string, stream: ReadableStream<Uint8Array>): MaybePromise<void>;
 }
 //# sourceMappingURL=StorageContext.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StorageContext.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,OAAO,EAAgB,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,OAAO,GAAG,GAAG;IAC1D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;CACrD;AAED,qBAAa,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,GAAG,CAAE,YAAW,qBAAqB,CAAC,CAAC,CAAC;IAEhF,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE;gBADd,OAAO,EAAE,CAAC,EAClB,YAAY,EAAE,MAAM,EAAE;IAGnC,GAAG,CAAC,CAAC,SAAS,qBAAqB,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC;IAwBjG,GAAG,CAAC,GAAG,EAAE,MAAM;IAWf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CAAC,CAAC,CAAC;IACzE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC;IAQ7E,MAAM,CAAC,GAAG,EAAE,MAAM,GACwC,sBAAsB,CAAC,CAAC,CAAC;IAGnF,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;IAMjD,IAAI,IAC+C,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IAGtF,MAAM,IAC+C,sBAAsB,CACnE,CAAC,EACD,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CACxC;IAGL,QAAQ,IAC+C,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IAG1F,sCAAsC;IACtC,KAAK;IAyBL,oEAAoE;IACpE,QAAQ,IAC+C,sBAAsB,CAAC,CAAC,CAAC;CAEnF"}
+{"version":3,"file":"StorageContext.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IAClC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC;CAClD;AAED,qBAAa,cAAe,YAAW,qBAAqB;IAEpD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE;gBADZ,OAAO,EAAE,OAAO,EAC1B,YAAY,EAAE,MAAM,EAAE;IAGnC,GAAG,CAAC,CAAC,SAAS,qBAAqB,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAwBpF,GAAG,CAAC,GAAG,EAAE,MAAM;IAIf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAAC,IAAI,CAAC;IAClE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;IAQtE,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAM9C,IAAI;IAIJ,MAAM;IAIN,QAAQ;IAIR,sCAAsC;IACtC,KAAK;IAuBL,oEAAoE;IACpE,QAAQ;IAIR,QAAQ,CAAC,GAAG,EAAE,MAAM;IAIpB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC;CAGtE"}

package/dist/esm/storage/StorageContext.js

@@ -35,14 +35,7 @@ class StorageContext {
     return defaultValue;
   }
   has(key) {
-    const value = this.storage.get(this.thisContexts, key);
-    if (value !== void 0) {
-      if (MaybePromise.is(value)) {
-        return value.then((v) => v !== void 0);
-      }
-      return true;
-    }
-    return false;
+    return this.storage.has(this.thisContexts, key);
   }
   set(keyOrValues, value) {
     if (typeof keyOrValues === "string") {
@@ -87,10 +80,8 @@ class StorageContext {
       }
     });
     if (promises.length > 0) {
-      return MatterAggregateError.allSettled(promises, "Error while clearing storage").then(
-        () => {
-        }
-      );
+      return MatterAggregateError.allSettled(promises, "Error while clearing storage").then(() => {
+      });
     }
     return void 0;
   }
@@ -98,6 +89,12 @@ class StorageContext {
   clearAll() {
     return this.storage.clearAll(this.thisContexts);
   }
+  openBlob(key) {
+    return this.storage.openBlob(this.thisContexts, key);
+  }
+  writeBlobFromStream(key, stream) {
+    return this.storage.writeBlobFromStream(this.thisContexts, key, stream);
+  }
 }
 export {
   StorageContext

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/StorageContext.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["keys"]
 }

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

@@ -6,12 +6,12 @@
 import { MaybePromise } from "../util/Promises.js";
 import { Storage } from "./Storage.js";
 import { StorageContext, StorageContextFactory } from "./StorageContext.js";
-export declare class StorageManager<S extends Storage = any> implements StorageContextFactory<S> {
+export declare class StorageManager implements StorageContextFactory {
     private storage;
     private initialized;
-    constructor(storage: S);
+    constructor(storage: Storage);
     initialize(): MaybePromise<void>;
     close(): MaybePromise<void>;
-    createContext(context: string): StorageContext<S>;
+    createContext(context: string): StorageContext;
 }
 //# sourceMappingURL=StorageManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StorageManager.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,qBAAa,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,GAAG,CAAE,YAAW,qBAAqB,CAAC,CAAC,CAAC;IAGxE,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,WAAW,CAAS;gBAER,OAAO,EAAE,CAAC;IAE9B,UAAU,IAAI,YAAY,CAAC,IAAI,CAAC;IAYhC,KAAK;IAKL,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;CAMpD"}
+{"version":3,"file":"StorageManager.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,qBAAa,cAAe,YAAW,qBAAqB;IAG5C,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,WAAW,CAAS;gBAER,OAAO,EAAE,OAAO;IAEpC,UAAU,IAAI,YAAY,CAAC,IAAI,CAAC;IAYhC,KAAK;IAKL,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;CAMjD"}

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/storage/StorageManager.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,oBAAoB;AAC7B,SAAkB,oBAAoB;AACtC,SAAS,sBAA6C;AAE/C,MAAM,eAA4E;AAAA,EAGrF,YAAoB,SAAY;AAAZ;AAAA,EAAa;AAAA,EAFzB,cAAc;AAAA,EAItB,aAAiC;AAC7B,QAAI,CAAC,KAAK,QAAQ,aAAa;AAC3B,YAAM,OAAO,KAAK,QAAQ,WAAW;AACrC,UAAI,aAAa,GAAG,IAAI,GAAG;AACvB,eAAO,KAAK,KAAK,MAAM;AACnB,eAAK,cAAc;AAAA,QACvB,CAAC;AAAA,MACL;AAAA,IACJ;AACA,SAAK,cAAc;AAAA,EACvB;AAAA,EAEA,QAAQ;AACJ,SAAK,cAAc;AACnB,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC9B;AAAA,EAEA,cAAc,SAAoC;AAC9C,QAAI,CAAC,KAAK,YAAa,OAAM,IAAI,aAAa,4CAA4C;AAC1F,QAAI,CAAC,QAAQ,OAAQ,OAAM,IAAI,aAAa,sCAAsC;AAClF,QAAI,QAAQ,SAAS,GAAG,EAAG,OAAM,IAAI,aAAa,gCAAgC;AAClF,WAAO,IAAI,eAAe,KAAK,SAAS,CAAC,OAAO,CAAC;AAAA,EACrD;AACJ;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,oBAAoB;AAC7B,SAAkB,oBAAoB;AACtC,SAAS,sBAA6C;AAE/C,MAAM,eAAgD;AAAA,EAGzD,YAAoB,SAAkB;AAAlB;AAAA,EAAmB;AAAA,EAF/B,cAAc;AAAA,EAItB,aAAiC;AAC7B,QAAI,CAAC,KAAK,QAAQ,aAAa;AAC3B,YAAM,OAAO,KAAK,QAAQ,WAAW;AACrC,UAAI,aAAa,GAAG,IAAI,GAAG;AACvB,eAAO,KAAK,KAAK,MAAM;AACnB,eAAK,cAAc;AAAA,QACvB,CAAC;AAAA,MACL;AAAA,IACJ;AACA,SAAK,cAAc;AAAA,EACvB;AAAA,EAEA,QAAQ;AACJ,SAAK,cAAc;AACnB,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC9B;AAAA,EAEA,cAAc,SAAiC;AAC3C,QAAI,CAAC,KAAK,YAAa,OAAM,IAAI,aAAa,4CAA4C;AAC1F,QAAI,CAAC,QAAQ,OAAQ,OAAM,IAAI,aAAa,sCAAsC;AAClF,QAAI,QAAQ,SAAS,GAAG,EAAG,OAAM,IAAI,aAAa,gCAAgC;AAClF,WAAO,IAAI,eAAe,KAAK,SAAS,CAAC,OAAO,CAAC;AAAA,EACrD;AACJ;",
   "names": []
 }

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

@@ -20,7 +20,7 @@ export declare class StorageService {
      *
      * @param namespace a unique namespace identifier such as a root node ID
      */
-    open(namespace: string): Promise<StorageManager<Storage>>;
+    open(namespace: string): Promise<StorageManager>;
     /**
      * Install a factory for opening storage.  Without such a factory storage is unavailable.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/general",
-    "version": "0.15.3",
+    "version": "0.16.0-alpha.0-20250802-1af103e3d",
     "description": "Non-Matter support for Matter.js",
     "keywords": [
         "iot",
@@ -36,7 +36,7 @@
         "@noble/curves": "^1.9.5"
     },
     "devDependencies": {
-        "@matter/testing": "0.15.3"
+        "@matter/testing": "0.16.0-alpha.0-20250802-1af103e3d"
     },
     "files": [
         "dist/**/*",

package/src/storage/Storage.ts

@@ -12,18 +12,38 @@ export class StorageError extends MatterError {}
 /**
  * Matter.js uses this key/value API to manage persistent state.
  */
-export interface Storage {
-    readonly initialized: boolean;
-    initialize(): MaybePromise<void>;
-    close(): MaybePromise<void>;
-    get(contexts: string[], key: string): MaybePromise<SupportedStorageTypes | undefined>;
-    set(contexts: string[], values: Record<string, SupportedStorageTypes>): MaybePromise<void>;
-    set(contexts: string[], key: string, value: SupportedStorageTypes): MaybePromise<void>;
-    delete(contexts: string[], key: string): MaybePromise<void>;
-    keys(contexts: string[]): MaybePromise<string[]>;
-    values(contexts: string[]): MaybePromise<Record<string, SupportedStorageTypes>>;
-    contexts(contexts: string[]): MaybePromise<string[]>;
-    clearAll(contexts: string[]): MaybePromise<void>;
+export abstract class Storage {
+    abstract readonly initialized: boolean;
+    abstract initialize(): MaybePromise<void>;
+    abstract close(): MaybePromise<void>;
+    abstract get(contexts: string[], key: string): MaybePromise<SupportedStorageTypes | undefined>;
+    abstract set(contexts: string[], values: Record<string, SupportedStorageTypes>): MaybePromise<void>;
+    abstract set(contexts: string[], key: string, value: SupportedStorageTypes): MaybePromise<void>;
+    abstract delete(contexts: string[], key: string): MaybePromise<void>;
+    abstract keys(contexts: string[]): MaybePromise<string[]>;
+    abstract values(contexts: string[]): MaybePromise<Record<string, SupportedStorageTypes>>;
+    abstract contexts(contexts: string[]): MaybePromise<string[]>;
+    abstract clearAll(contexts: string[]): 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.
+     * Please implement this method in your storage implementation if you want to optimize it.
+     */
+    has(contexts: string[], key: string): MaybePromise<boolean> {
+        const value = this.get(contexts, key);
+        if (MaybePromise.is(value)) {
+            return MaybePromise.then(value, v => v !== undefined);
+        }
+        return value !== undefined;
+    }
+
+    abstract openBlob(contexts: string[], key: string): MaybePromise<Blob>;
+    abstract writeBlobFromStream(
+        contexts: string[],
+        key: string,
+        stream: ReadableStream<Uint8Array>,
+    ): MaybePromise<void>;
 }
 
 /**
@@ -44,37 +64,3 @@ export namespace CloneableStorage {
         }
     }
 }
-
-// This extra class is needed because of https://github.com/microsoft/TypeScript/issues/57905 in order
-// to have the generics typing support on the "get" method and can be removed when the TS issue is fixed
-// or we remove the legacy API.
-export abstract class MaybeAsyncStorage implements Storage {
-    abstract initialized: boolean;
-    abstract initialize(): MaybePromise<void>;
-    abstract close(): MaybePromise<void>;
-    abstract get<T extends SupportedStorageTypes>(contexts: string[], key: string): MaybePromise<T | undefined>;
-    abstract set(contexts: string[], values: Record<string, SupportedStorageTypes>): MaybePromise<void>;
-    abstract set(contexts: string[], key: string, value: SupportedStorageTypes): MaybePromise<void>;
-    abstract delete(contexts: string[], key: string): MaybePromise<void>;
-    abstract keys(contexts: string[]): MaybePromise<string[]>;
-    abstract values(contexts: string[]): MaybePromise<Record<string, SupportedStorageTypes>>;
-    abstract contexts(contexts: string[]): MaybePromise<string[]>;
-    abstract clearAll(contexts: string[]): MaybePromise<void>;
-}
-
-// This can be removed once we remove the legacy API
-export abstract class SyncStorage implements Storage {
-    abstract initialized: boolean;
-    abstract initialize(): MaybePromise<void>;
-    abstract close(): MaybePromise<void>;
-    abstract get<T extends SupportedStorageTypes>(contexts: string[], key: string): T | undefined;
-    abstract set(contexts: string[], values: Record<string, SupportedStorageTypes>): void;
-    abstract set(contexts: string[], key: string, value: SupportedStorageTypes): void;
-    abstract delete(contexts: string[], key: string): void;
-    abstract keys(contexts: string[]): string[];
-    abstract values(contexts: string[]): Record<string, SupportedStorageTypes>;
-    abstract contexts(contexts: string[]): string[];
-    abstract clearAll(contexts: string[]): void;
-}
-
-export type StorageOperationResult<S extends Storage, T = void> = S extends SyncStorage ? T : Promise<T>;

package/src/storage/StorageBackendMemory.ts

@@ -5,10 +5,10 @@
  */
 
 import { deepCopy } from "#util/DeepCopy.js";
-import { CloneableStorage, StorageError, SyncStorage } from "./Storage.js";
+import { CloneableStorage, Storage, StorageError } from "./Storage.js";
 import { SupportedStorageTypes } from "./StringifyTools.js";
 
-export class StorageBackendMemory extends SyncStorage implements CloneableStorage {
+export class StorageBackendMemory extends Storage implements CloneableStorage {
     protected isInitialized = false;
 
     constructor(protected store: any = {}) {
@@ -57,12 +57,48 @@ export class StorageBackendMemory extends SyncStorage implements CloneableStorag
         return this.store;
     }
 
-    get<T extends SupportedStorageTypes>(contexts: string[], key: string): T | undefined {
+    get(contexts: string[], key: string): SupportedStorageTypes | undefined {
         this.#assertInitialized();
         if (!contexts.length || !key.length) throw new StorageError("Context and key must not be empty.");
         return this.store[this.createContextKey(contexts)]?.[key];
     }
 
+    openBlob(contexts: string[], key: string): Blob {
+        const value = this.get(contexts, key);
+        if (value === undefined) {
+            return new Blob([]);
+        }
+        if (!(value instanceof Uint8Array)) {
+            throw new StorageError("Value must be an Uint8Array to read as blob stream.");
+        }
+        return new Blob([value]);
+    }
+
+    async writeBlobFromStream(contexts: string[], key: string, stream: ReadableStream<Uint8Array>): Promise<void> {
+        this.#assertInitialized();
+        const reader = stream.getReader();
+        const chunks: Uint8Array[] = [];
+
+        try {
+            let length = 0;
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) break;
+                chunks.push(value);
+                length += value.length;
+            }
+            const combined = new Uint8Array(length);
+            let offset = 0;
+            for (const chunk of chunks) {
+                combined.set(chunk, offset);
+                offset += chunk.length;
+            }
+            this.#setKey(contexts, key, combined);
+        } catch (error: any) {
+            throw new StorageError(`Error reading stream: ${error.message}`);
+        }
+    }
+
     #setKey(contexts: string[], key: string, value: SupportedStorageTypes) {
         if (!contexts.length || !key.length) throw new StorageError("Context and key must not be empty.");
         const contextKey = this.createContextKey(contexts);

package/src/storage/StorageContext.ts

@@ -6,20 +6,20 @@
 
 import { MatterAggregateError } from "#MatterError.js";
 import { MaybePromise } from "../util/Promises.js";
-import { Storage, StorageError, StorageOperationResult } from "./Storage.js";
+import { Storage, StorageError } from "./Storage.js";
 import { SupportedStorageTypes } from "./StringifyTools.js";
 
-export interface StorageContextFactory<S extends Storage = any> {
-    createContext(context: string): StorageContext<S>;
+export interface StorageContextFactory {
+    createContext(context: string): StorageContext;
 }
 
-export class StorageContext<S extends Storage = any> implements StorageContextFactory<S> {
+export class StorageContext implements StorageContextFactory {
     constructor(
-        private readonly storage: S,
+        protected readonly storage: Storage,
         readonly thisContexts: string[],
     ) {}
 
-    get<T extends SupportedStorageTypes>(key: string, defaultValue?: T): StorageOperationResult<S, T> {
+    get<T extends SupportedStorageTypes>(key: string, defaultValue?: T): MaybePromise<T> {
         const value = this.storage.get(this.thisContexts, key);
         if (value !== undefined) {
             if (MaybePromise.is(value)) {
@@ -30,62 +30,52 @@ export class StorageContext<S extends Storage = any> implements StorageContextFa
                             `No value found for key ${key} in context ${this.thisContexts} and no default value specified!`,
                         );
                     }
-                    return defaultValue;
-                }) as StorageOperationResult<S, T>;
+                    return defaultValue as T;
+                }) as MaybePromise<T>;
             }
-            return value as StorageOperationResult<S, T>;
+            return value as T;
         }
         if (defaultValue === undefined) {
             throw new StorageError(
                 `No value found for key ${key} in context ${this.thisContexts} and no default value specified!`,
             );
         }
-        return defaultValue as StorageOperationResult<S, T>;
+        return defaultValue;
     }
 
     has(key: string) {
-        const value = this.storage.get(this.thisContexts, key);
-        if (value !== undefined) {
-            if (MaybePromise.is(value)) {
-                return value.then(v => v !== undefined) as StorageOperationResult<S, boolean>;
-            }
-            return true as StorageOperationResult<S, boolean>;
-        }
-        return false as StorageOperationResult<S, boolean>;
+        return this.storage.has(this.thisContexts, key);
     }
 
-    set(key: string, value: SupportedStorageTypes): StorageOperationResult<S>;
-    set(values: Record<string, SupportedStorageTypes>): StorageOperationResult<S>;
+    set(key: string, value: SupportedStorageTypes): MaybePromise<void>;
+    set(values: Record<string, SupportedStorageTypes>): MaybePromise<void>;
     set(keyOrValues: string | Record<string, SupportedStorageTypes>, value?: SupportedStorageTypes) {
         if (typeof keyOrValues === "string") {
-            return this.storage.set(this.thisContexts, keyOrValues, value) as StorageOperationResult<S>;
+            return this.storage.set(this.thisContexts, keyOrValues, value);
         }
-        return this.storage.set(this.thisContexts, keyOrValues) as StorageOperationResult<S>;
+        return this.storage.set(this.thisContexts, keyOrValues);
     }
 
     delete(key: string) {
-        return this.storage.delete(this.thisContexts, key) as StorageOperationResult<S>;
+        return this.storage.delete(this.thisContexts, key);
     }
 
-    createContext(context: string): StorageContext<S> {
+    createContext(context: string): StorageContext {
         if (context.length === 0) throw new StorageError("Context must not be an empty string");
         if (context.includes(".")) throw new StorageError("Context must not contain dots!");
         return new StorageContext(this.storage, [...this.thisContexts, context]);
     }
 
     keys() {
-        return this.storage.keys(this.thisContexts) as StorageOperationResult<S, string[]>;
+        return this.storage.keys(this.thisContexts);
     }
 
     values() {
-        return this.storage.values(this.thisContexts) as StorageOperationResult<
-            S,
-            Record<string, SupportedStorageTypes>
-        >;
+        return this.storage.values(this.thisContexts);
     }
 
     contexts() {
-        return this.storage.contexts(this.thisContexts) as StorageOperationResult<S, string[]>;
+        return this.storage.contexts(this.thisContexts);
     }
 
     /** Clears all keys in this context */
@@ -97,7 +87,7 @@ export class StorageContext<S extends Storage = any> implements StorageContextFa
                     keys.map(key => this.delete(key)),
                     "Error while clearing storage",
                 ).then(() => {});
-            }) as StorageOperationResult<S>;
+            });
         }
         const promises = new Array<PromiseLike<void>>();
         keys.forEach(key => {
@@ -107,15 +97,21 @@ export class StorageContext<S extends Storage = any> implements StorageContextFa
             }
         });
         if (promises.length > 0) {
-            return MatterAggregateError.allSettled(promises, "Error while clearing storage").then(
-                () => {},
-            ) as StorageOperationResult<S>;
+            return MatterAggregateError.allSettled(promises, "Error while clearing storage").then(() => {});
         }
-        return undefined as StorageOperationResult<S>;
+        return undefined;
     }
 
     /** Clears all keys in this context and all created sub-contexts. */
     clearAll() {
-        return this.storage.clearAll(this.thisContexts) as StorageOperationResult<S>;
+        return this.storage.clearAll(this.thisContexts);
+    }
+
+    openBlob(key: string) {
+        return this.storage.openBlob(this.thisContexts, key);
+    }
+
+    writeBlobFromStream(key: string, stream: ReadableStream<Uint8Array>) {
+        return this.storage.writeBlobFromStream(this.thisContexts, key, stream);
     }
 }

package/src/storage/StorageManager.ts

@@ -8,10 +8,10 @@ import { MaybePromise } from "../util/Promises.js";
 import { Storage, StorageError } from "./Storage.js";
 import { StorageContext, StorageContextFactory } from "./StorageContext.js";
 
-export class StorageManager<S extends Storage = any> implements StorageContextFactory<S> {
+export class StorageManager implements StorageContextFactory {
     private initialized = false;
 
-    constructor(private storage: S) {}
+    constructor(private storage: Storage) {}
 
     initialize(): MaybePromise<void> {
         if (!this.storage.initialized) {
@@ -30,7 +30,7 @@ export class StorageManager<S extends Storage = any> implements StorageContextFa
         return this.storage.close();
     }
 
-    createContext(context: string): StorageContext<S> {
+    createContext(context: string): StorageContext {
         if (!this.initialized) throw new StorageError("The storage needs to be initialized first!");
         if (!context.length) throw new StorageError("Context must not be an empty string!");
         if (context.includes(".")) throw new StorageError("Context must not contain dots!");