@matter/general 0.11.0-alpha.0-20241005-e3e4e4a7a

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

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "../MatterError.js";
+import { MaybePromise } from "../util/Promises.js";
+import { SupportedStorageTypes } from "./StringifyTools.js";
+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>;
+}
+export declare 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>;
+}
+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;
+}
+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

@@ -0,0 +1 @@
+{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../src/storage/Storage.ts"],"names":[],"mappings":"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"}

package/dist/esm/storage/Storage.js

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "../MatterError.js";
+class StorageError extends MatterError {
+}
+class MaybeAsyncStorage {
+}
+class SyncStorage {
+}
+export {
+  MaybeAsyncStorage,
+  StorageError,
+  SyncStorage
+};
+//# sourceMappingURL=Storage.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/Storage.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,SAAS,mBAAmB;AAIrB,MAAM,qBAAqB,YAAY;AAAC;AAsBxC,MAAe,kBAAqC;AAY3D;AAGO,MAAe,YAA+B;AAYrD;",
+  "names": []
+}

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SyncStorage } from "./Storage.js";
+import { SupportedStorageTypes } from "./StringifyTools.js";
+export declare class StorageBackendMemory extends SyncStorage {
+    #private;
+    protected store: any;
+    protected isInitialized: boolean;
+    constructor(store?: any);
+    get initialized(): boolean;
+    static create(store?: any): Promise<StorageBackendMemory>;
+    private createContextKey;
+    initialize(): void;
+    close(): void;
+    clear(): void;
+    get<T extends SupportedStorageTypes>(contexts: string[], key: string): T | undefined;
+    set(contexts: string[], keyOrValues: string | Record<string, SupportedStorageTypes>, value?: SupportedStorageTypes): void;
+    delete(contexts: string[], key: string): void;
+    keys(contexts: string[]): string[];
+    values(contexts: string[]): Record<string, SupportedStorageTypes>;
+    contexts(contexts: string[]): string[];
+    clearAll(contexts: string[]): void;
+}
+//# sourceMappingURL=StorageBackendMemory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StorageBackendMemory.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageBackendMemory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAgB,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qBAAa,oBAAqB,SAAQ,WAAW;;IAGrC,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;IAKL,KAAK;IAIL,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;CAa9B"}

package/dist/esm/storage/StorageBackendMemory.js

@@ -0,0 +1,111 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { StorageError, SyncStorage } from "./Storage.js";
+class StorageBackendMemory extends SyncStorage {
+  constructor(store = {}) {
+    super();
+    this.store = store;
+  }
+  isInitialized = false;
+  get initialized() {
+    return this.isInitialized;
+  }
+  static async create(store = {}) {
+    const storage = new StorageBackendMemory(store);
+    storage.initialize();
+    return storage;
+  }
+  createContextKey(contexts) {
+    const key = contexts.join(".");
+    if (!key.length || key.includes("..") || key.startsWith(".") || key.endsWith("."))
+      throw new StorageError("Context must not be an empty string.");
+    return key;
+  }
+  initialize() {
+    if (this.initialized) throw new StorageError("Storage already initialized!");
+    this.isInitialized = true;
+  }
+  close() {
+    this.isInitialized = false;
+  }
+  clear() {
+    this.store = {};
+  }
+  get(contexts, key) {
+    if (!this.initialized) throw new StorageError("Storage is not initialized");
+    if (!contexts.length || !key.length) throw new StorageError("Context and key must not be empty.");
+    return this.store[this.createContextKey(contexts)]?.[key];
+  }
+  #setKey(contexts, key, value) {
+    if (!contexts.length || !key.length) throw new StorageError("Context and key must not be empty.");
+    const contextKey = this.createContextKey(contexts);
+    if (this.store[contextKey] === void 0) {
+      this.store[contextKey] = {};
+    }
+    this.store[contextKey][key] = value;
+  }
+  set(contexts, keyOrValues, value) {
+    if (!this.initialized) throw new StorageError("Storage is not initialized");
+    if (typeof keyOrValues === "string") {
+      this.#setKey(contexts, keyOrValues, value);
+    } else {
+      Object.entries(keyOrValues).forEach(([key, value2]) => {
+        this.#setKey(contexts, key, value2);
+      });
+    }
+  }
+  delete(contexts, key) {
+    if (!this.initialized) throw new StorageError("Storage is not initialized");
+    if (!contexts.length || !key.length) throw new StorageError("Context and key must not be empty.");
+    delete this.store[this.createContextKey(contexts)]?.[key];
+  }
+  keys(contexts) {
+    if (!this.initialized) throw new StorageError("Storage is not initialized");
+    if (!contexts.length) throw new StorageError("Context must not be empty!");
+    return Object.keys(this.store[this.createContextKey(contexts)] ?? {});
+  }
+  values(contexts) {
+    const values = {};
+    for (const key of this.keys(contexts)) {
+      values[key] = this.get(contexts, key);
+    }
+    return values;
+  }
+  contexts(contexts) {
+    if (!this.initialized) throw new StorageError("Storage is not initialized");
+    const contextKey = contexts.length ? this.createContextKey(contexts) : "";
+    const startContextKey = contextKey.length ? `${contextKey}.` : "";
+    const foundContexts = new Array();
+    Object.keys(this.store).forEach((key) => {
+      if (key.startsWith(startContextKey)) {
+        const subKeys = key.substring(startContextKey.length).split(".");
+        if (subKeys.length < 1) return;
+        const context = subKeys[0];
+        if (!foundContexts.includes(context)) {
+          foundContexts.push(context);
+        }
+      }
+    });
+    return foundContexts;
+  }
+  clearAll(contexts) {
+    if (!this.initialized) throw new StorageError("Storage is not initialized");
+    const contextKey = this.createContextKey(contexts);
+    if (contextKey.length) {
+      delete this.store[contextKey];
+    }
+    const startContextKey = contextKey.length ? `${contextKey}.` : "";
+    Object.keys(this.store).forEach((key) => {
+      if (key.startsWith(startContextKey)) {
+        delete this.store[key];
+      }
+    });
+  }
+}
+export {
+  StorageBackendMemory
+};
+//# sourceMappingURL=StorageBackendMemory.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Storage, StorageOperationResult } from "./Storage.js";
+import { SupportedStorageTypes } from "./StringifyTools.js";
+export declare class StorageContext<S extends Storage = any> {
+    private readonly 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[]>;
+    /** Clears all keys in this context */
+    clear(): StorageOperationResult<S>;
+    /** Clears all keys in this context and all created sub-contexts. */
+    clearAll(): StorageOperationResult<S>;
+}
+//# sourceMappingURL=StorageContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StorageContext.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAgB,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qBAAa,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,GAAG;IAE3C,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;IAoBL,oEAAoE;IACpE,QAAQ,IAC+C,sBAAsB,CAAC,CAAC,CAAC;CAEnF"}

package/dist/esm/storage/StorageContext.js

@@ -0,0 +1,97 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MaybePromise } from "../util/Promises.js";
+import { StorageError } from "./Storage.js";
+class StorageContext {
+  constructor(storage, thisContexts) {
+    this.storage = storage;
+    this.thisContexts = thisContexts;
+  }
+  get(key, defaultValue) {
+    const value = this.storage.get(this.thisContexts, key);
+    if (value !== void 0) {
+      if (MaybePromise.is(value)) {
+        return value.then((v) => {
+          if (v !== void 0) return v;
+          if (defaultValue === void 0) {
+            throw new StorageError(
+              `No value found for key ${key} in context ${this.thisContexts} and no default value specified!`
+            );
+          }
+          return defaultValue;
+        });
+      }
+      return value;
+    }
+    if (defaultValue === void 0) {
+      throw new StorageError(
+        `No value found for key ${key} in context ${this.thisContexts} and no default value specified!`
+      );
+    }
+    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;
+  }
+  set(keyOrValues, value) {
+    if (typeof keyOrValues === "string") {
+      return this.storage.set(this.thisContexts, keyOrValues, value);
+    }
+    return this.storage.set(this.thisContexts, keyOrValues);
+  }
+  delete(key) {
+    return this.storage.delete(this.thisContexts, key);
+  }
+  createContext(context) {
+    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);
+  }
+  values() {
+    return this.storage.values(this.thisContexts);
+  }
+  contexts() {
+    return this.storage.contexts(this.thisContexts);
+  }
+  /** Clears all keys in this context */
+  clear() {
+    const keys = this.keys();
+    if (MaybePromise.is(keys)) {
+      return keys.then((keys2) => {
+        return Promise.all(keys2.map((key) => this.delete(key))).then(() => Promise.resolve());
+      });
+    }
+    const promises = new Array();
+    keys.forEach((key) => {
+      const promise = this.delete(key);
+      if (promise !== void 0 && MaybePromise.is(promise)) {
+        promises.push(promise);
+      }
+    });
+    if (promises.length > 0) {
+      return Promise.all(promises).then(() => Promise.resolve());
+    }
+    return void 0;
+  }
+  /** Clears all keys in this context and all created sub-contexts. */
+  clearAll() {
+    return this.storage.clearAll(this.thisContexts);
+  }
+}
+export {
+  StorageContext
+};
+//# sourceMappingURL=StorageContext.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/StorageContext.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,oBAAoB;AAC7B,SAAkB,oBAA4C;AAGvD,MAAM,eAAwC;AAAA,EACjD,YACqB,SACR,cACX;AAFmB;AACR;AAAA,EACV;AAAA,EAEH,IAAqC,KAAa,cAAgD;AAC9F,UAAM,QAAQ,KAAK,QAAQ,IAAI,KAAK,cAAc,GAAG;AACrD,QAAI,UAAU,QAAW;AACrB,UAAI,aAAa,GAAG,KAAK,GAAG;AACxB,eAAO,MAAM,KAAK,OAAK;AACnB,cAAI,MAAM,OAAW,QAAO;AAC5B,cAAI,iBAAiB,QAAW;AAC5B,kBAAM,IAAI;AAAA,cACN,0BAA0B,GAAG,eAAe,KAAK,YAAY;AAAA,YACjE;AAAA,UACJ;AACA,iBAAO;AAAA,QACX,CAAC;AAAA,MACL;AACA,aAAO;AAAA,IACX;AACA,QAAI,iBAAiB,QAAW;AAC5B,YAAM,IAAI;AAAA,QACN,0BAA0B,GAAG,eAAe,KAAK,YAAY;AAAA,MACjE;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAAA,EAEA,IAAI,KAAa;AACb,UAAM,QAAQ,KAAK,QAAQ,IAAI,KAAK,cAAc,GAAG;AACrD,QAAI,UAAU,QAAW;AACrB,UAAI,aAAa,GAAG,KAAK,GAAG;AACxB,eAAO,MAAM,KAAK,OAAK,MAAM,MAAS;AAAA,MAC1C;AACA,aAAO;AAAA,IACX;AACA,WAAO;AAAA,EACX;AAAA,EAIA,IAAI,aAA6D,OAA+B;AAC5F,QAAI,OAAO,gBAAgB,UAAU;AACjC,aAAO,KAAK,QAAQ,IAAI,KAAK,cAAc,aAAa,KAAK;AAAA,IACjE;AACA,WAAO,KAAK,QAAQ,IAAI,KAAK,cAAc,WAAW;AAAA,EAC1D;AAAA,EAEA,OAAO,KAAa;AAChB,WAAO,KAAK,QAAQ,OAAO,KAAK,cAAc,GAAG;AAAA,EACrD;AAAA,EAEA,cAAc,SAAoC;AAC9C,QAAI,QAAQ,WAAW,EAAG,OAAM,IAAI,aAAa,qCAAqC;AACtF,QAAI,QAAQ,SAAS,GAAG,EAAG,OAAM,IAAI,aAAa,gCAAgC;AAClF,WAAO,IAAI,eAAe,KAAK,SAAS,CAAC,GAAG,KAAK,cAAc,OAAO,CAAC;AAAA,EAC3E;AAAA,EAEA,OAAO;AACH,WAAO,KAAK,QAAQ,KAAK,KAAK,YAAY;AAAA,EAC9C;AAAA,EAEA,SAAS;AACL,WAAO,KAAK,QAAQ,OAAO,KAAK,YAAY;AAAA,EAIhD;AAAA,EAEA,WAAW;AACP,WAAO,KAAK,QAAQ,SAAS,KAAK,YAAY;AAAA,EAClD;AAAA;AAAA,EAGA,QAAQ;AACJ,UAAM,OAAO,KAAK,KAAK;AACvB,QAAI,aAAa,GAAG,IAAI,GAAG;AACvB,aAAO,KAAK,KAAK,CAAAA,UAAQ;AACrB,eAAO,QAAQ,IAAIA,MAAK,IAAI,SAAO,KAAK,OAAO,GAAG,CAAC,CAAC,EAAE,KAAK,MAAM,QAAQ,QAAQ,CAAC;AAAA,MACtF,CAAC;AAAA,IACL;AACA,UAAM,WAAW,IAAI,MAAyB;AAC9C,SAAK,QAAQ,SAAO;AAChB,YAAM,UAAU,KAAK,OAAO,GAAG;AAC/B,UAAI,YAAY,UAAa,aAAa,GAAG,OAAO,GAAG;AACnD,iBAAS,KAAK,OAAO;AAAA,MACzB;AAAA,IACJ,CAAC;AACD,QAAI,SAAS,SAAS,GAAG;AACrB,aAAO,QAAQ,IAAI,QAAQ,EAAE,KAAK,MAAM,QAAQ,QAAQ,CAAC;AAAA,IAC7D;AACA,WAAO;AAAA,EACX;AAAA;AAAA,EAGA,WAAW;AACP,WAAO,KAAK,QAAQ,SAAS,KAAK,YAAY;AAAA,EAClD;AACJ;",
+  "names": ["keys"]
+}

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

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MaybePromise } from "../util/Promises.js";
+import { Storage } from "./Storage.js";
+import { StorageContext } from "./StorageContext.js";
+export declare class StorageManager<S extends Storage = any> {
+    private storage;
+    private initialized;
+    constructor(storage: S);
+    initialize(): MaybePromise<void>;
+    close(): MaybePromise<void>;
+    createContext(context: string): StorageContext<S>;
+}
+//# sourceMappingURL=StorageManager.d.ts.map

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

@@ -0,0 +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,MAAM,qBAAqB,CAAC;AAErD,qBAAa,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,GAAG;IAGnC,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"}

package/dist/esm/storage/StorageManager.js

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MaybePromise } from "../util/Promises.js";
+import { StorageError } from "./Storage.js";
+import { StorageContext } from "./StorageContext.js";
+class StorageManager {
+  constructor(storage) {
+    this.storage = storage;
+  }
+  initialized = false;
+  initialize() {
+    if (!this.storage.initialized) {
+      const init = this.storage.initialize();
+      if (MaybePromise.is(init)) {
+        return init.then(() => {
+          this.initialized = true;
+        });
+      }
+    }
+    this.initialized = true;
+  }
+  close() {
+    this.initialized = false;
+    return this.storage.close();
+  }
+  createContext(context) {
+    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!");
+    return new StorageContext(this.storage, [context]);
+  }
+}
+export {
+  StorageManager
+};
+//# sourceMappingURL=StorageManager.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/StorageManager.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,oBAAoB;AAC7B,SAAkB,oBAAoB;AACtC,SAAS,sBAAsB;AAExB,MAAM,eAAwC;AAAA,EAGjD,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;",
+  "names": []
+}

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

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Environment } from "../environment/Environment.js";
+import { Environmental } from "../environment/Environmental.js";
+import { Diagnostic } from "../log/Diagnostic.js";
+import { Storage } from "./Storage.js";
+import { StorageManager } from "./StorageManager.js";
+/**
+ * Service adapter for the Matter.js storage API.
+ */
+export declare class StorageService {
+    #private;
+    constructor(environment: Environment, factory?: (namespace: string) => Storage);
+    static [Environmental.create](environment: Environment): StorageService;
+    /**
+     * Open storage.  The storage is initialized but the caller must take ownership.
+     *
+     * @param namespace a unique namespace identifier such as a root node ID
+     */
+    open(namespace: string): Promise<StorageManager<Storage>>;
+    /**
+     * Install a factory for opening storage.  Without such a factory storage is unavailable.
+     */
+    set factory(factory: (namespace: string) => Storage);
+    /**
+     * The storage location.  Only used for diagnostic purposes.
+     */
+    get location(): string | undefined;
+    set location(location: string | undefined);
+    [Diagnostic.value](): (string | (Record<string, unknown> & Diagnostic))[];
+}
+//# sourceMappingURL=StorageService.d.ts.map

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

@@ -0,0 +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;;gBAIX,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO;IAK9E,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,CAAC,UAAU,CAAC,KAAK,CAAC;CASrB"}

package/dist/esm/storage/StorageService.js

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { NoProviderError } from "../MatterError.js";
+import { Environmental } from "../environment/Environmental.js";
+import { Diagnostic } from "../log/Diagnostic.js";
+import { StorageManager } from "./StorageManager.js";
+class StorageService {
+  #factory;
+  #location;
+  constructor(environment, factory) {
+    environment.set(StorageService, this);
+    this.#factory = factory;
+  }
+  static [Environmental.create](environment) {
+    return new this(environment);
+  }
+  /**
+   * Open storage.  The storage is initialized but the caller must take ownership.
+   *
+   * @param namespace a unique namespace identifier such as a root node ID
+   */
+  async open(namespace) {
+    if (this.#factory === void 0) {
+      throw new NoProviderError("Storage is unavailable because no platform implementation is installed");
+    }
+    const storage = this.#factory(namespace);
+    const manager = new StorageManager(storage);
+    await manager.initialize();
+    return manager;
+  }
+  /**
+   * Install a factory for opening storage.  Without such a factory storage is unavailable.
+   */
+  set factory(factory) {
+    this.#factory = factory;
+  }
+  /**
+   * The storage location.  Only used for diagnostic purposes.
+   */
+  get location() {
+    return this.#location;
+  }
+  set location(location2) {
+    this.#location = location2;
+  }
+  [Diagnostic.value]() {
+    return [
+      "Persistence",
+      Diagnostic.dict({
+        location: location ?? "(unknown)",
+        available: !!this.#factory
+      })
+    ];
+  }
+}
+export {
+  StorageService
+};
+//# sourceMappingURL=StorageService.js.map

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

@@ -0,0 +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,YAAY,aAA0B,SAA0C;AAC5E,gBAAY,IAAI,gBAAgB,IAAI;AACpC,SAAK,WAAW;AAAA,EACpB;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,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/StringifyTools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/** Supported base types to stringify the data for the storage that can be used as keys and also values. */
+type SupportedStorageBaseTypes = string | number | boolean | bigint | Uint8Array;
+/** Supported combined types to stringify the data for the storage that can be used as values. */
+type SupportedComplexStorageTypes = Array<SupportedStorageBaseTypes | SupportedComplexStorageTypes> | {
+    [key: string]: SupportedStorageBaseTypes | SupportedComplexStorageTypes | null | undefined;
+} | Array<[SupportedStorageBaseTypes, SupportedStorageBaseTypes | SupportedComplexStorageTypes | null | undefined]> | Map<SupportedStorageBaseTypes, SupportedStorageBaseTypes | SupportedComplexStorageTypes> | null | undefined;
+export type SupportedStorageTypes = SupportedStorageBaseTypes | SupportedComplexStorageTypes;
+export declare function toJson(object: SupportedStorageTypes, spaces?: number): string;
+export declare function fromJson(json: string): SupportedStorageTypes;
+export {};
+//# sourceMappingURL=StringifyTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StringifyTools.d.ts","sourceRoot":"","sources":["../../../src/storage/StringifyTools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,2GAA2G;AAC3G,KAAK,yBAAyB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAEjF,iGAAiG;AACjG,KAAK,4BAA4B,GAC3B,KAAK,CAAC,yBAAyB,GAAG,4BAA4B,CAAC,GAC/D;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,GAAG,4BAA4B,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GAC9F,KAAK,CAAC,CAAC,yBAAyB,EAAE,yBAAyB,GAAG,4BAA4B,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAC/G,GAAG,CAAC,yBAAyB,EAAE,yBAAyB,GAAG,4BAA4B,CAAC,GACxF,IAAI,GACJ,SAAS,CAAC;AAEhB,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,GAAG,4BAA4B,CAAC;AAQ7F,wBAAgB,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA4B7E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CA8C5D"}