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

package/dist/cjs/storage/StorageContext.js

@@ -0,0 +1,117 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var StorageContext_exports = {};
+__export(StorageContext_exports, {
+  StorageContext: () => StorageContext
+});
+module.exports = __toCommonJS(StorageContext_exports);
+var import_Promises = require("../util/Promises.js");
+var import_Storage = require("./Storage.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+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 (import_Promises.MaybePromise.is(value)) {
+        return value.then((v) => {
+          if (v !== void 0) return v;
+          if (defaultValue === void 0) {
+            throw new import_Storage.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 import_Storage.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 (import_Promises.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 import_Storage.StorageError("Context must not be an empty string");
+    if (context.includes(".")) throw new import_Storage.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 (import_Promises.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 && import_Promises.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);
+  }
+}
+//# sourceMappingURL=StorageContext.js.map

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

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

package/dist/cjs/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/cjs/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/cjs/storage/StorageManager.js

@@ -0,0 +1,59 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var StorageManager_exports = {};
+__export(StorageManager_exports, {
+  StorageManager: () => StorageManager
+});
+module.exports = __toCommonJS(StorageManager_exports);
+var import_Promises = require("../util/Promises.js");
+var import_Storage = require("./Storage.js");
+var import_StorageContext = require("./StorageContext.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class StorageManager {
+  constructor(storage) {
+    this.storage = storage;
+  }
+  initialized = false;
+  initialize() {
+    if (!this.storage.initialized) {
+      const init = this.storage.initialize();
+      if (import_Promises.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 import_Storage.StorageError("The storage needs to be initialized first!");
+    if (!context.length) throw new import_Storage.StorageError("Context must not be an empty string!");
+    if (context.includes(".")) throw new import_Storage.StorageError("Context must not contain dots!");
+    return new import_StorageContext.StorageContext(this.storage, [context]);
+  }
+}
+//# sourceMappingURL=StorageManager.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/StorageManager.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,sBAA6B;AAC7B,qBAAsC;AACtC,4BAA+B;AAR/B;AAAA;AAAA;AAAA;AAAA;AAUO,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,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;",
+  "names": []
+}

package/dist/cjs/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/cjs/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/cjs/storage/StorageService.js

@@ -0,0 +1,82 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var StorageService_exports = {};
+__export(StorageService_exports, {
+  StorageService: () => StorageService
+});
+module.exports = __toCommonJS(StorageService_exports);
+var import_MatterError = require("../MatterError.js");
+var import_Environmental = require("../environment/Environmental.js");
+var import_Diagnostic = require("../log/Diagnostic.js");
+var import_StorageManager = require("./StorageManager.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class StorageService {
+  #factory;
+  #location;
+  constructor(environment, factory) {
+    environment.set(StorageService, this);
+    this.#factory = factory;
+  }
+  static [import_Environmental.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 import_MatterError.NoProviderError("Storage is unavailable because no platform implementation is installed");
+    }
+    const storage = this.#factory(namespace);
+    const manager = new import_StorageManager.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;
+  }
+  [import_Diagnostic.Diagnostic.value]() {
+    return [
+      "Persistence",
+      import_Diagnostic.Diagnostic.dict({
+        location: location ?? "(unknown)",
+        available: !!this.#factory
+      })
+    ];
+  }
+}
+//# sourceMappingURL=StorageService.js.map

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

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

package/dist/cjs/storage/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/cjs/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"}

package/dist/cjs/storage/StringifyTools.js

@@ -0,0 +1,105 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var StringifyTools_exports = {};
+__export(StringifyTools_exports, {
+  fromJson: () => fromJson,
+  toJson: () => toJson
+});
+module.exports = __toCommonJS(StringifyTools_exports);
+var import_MatterError = require("../MatterError.js");
+var import_Bytes = require("../util/Bytes.js");
+var import_Type = require("../util/Type.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const JSON_SPECIAL_KEY_TYPE = "__object__";
+const JSON_SPECIAL_KEY_VALUE = "__value__";
+function toJson(object, spaces) {
+  return JSON.stringify(
+    object,
+    (_key, value) => {
+      if (value === void 0) {
+        return `{"${JSON_SPECIAL_KEY_TYPE}":"Undefined"}`;
+      }
+      if (typeof value === "bigint") {
+        return `{"${JSON_SPECIAL_KEY_TYPE}":"BigInt","${JSON_SPECIAL_KEY_VALUE}":"${value.toString()}"}`;
+      }
+      if (value instanceof Uint8Array) {
+        return `{"${JSON_SPECIAL_KEY_TYPE}":"Uint8Array","${JSON_SPECIAL_KEY_VALUE}":"${import_Bytes.Bytes.toHex(value)}"}`;
+      }
+      if ((0, import_Type.isObject)(value) && value.type === "Buffer" && Array.isArray(value.data)) {
+        return `{"${JSON_SPECIAL_KEY_TYPE}":"Uint8Array","${JSON_SPECIAL_KEY_VALUE}":"${import_Bytes.Bytes.toHex(
+          Uint8Array.from(value.data)
+        )}"}`;
+      }
+      if (value instanceof Map) {
+        return `{"${JSON_SPECIAL_KEY_TYPE}":"Map","${JSON_SPECIAL_KEY_VALUE}":${JSON.stringify(
+          toJson(Array.from(value.entries()))
+        )}}`;
+      }
+      return value;
+    },
+    spaces
+  );
+}
+function fromJson(json) {
+  return JSON.parse(json, (_key, value) => {
+    if (typeof value === "string" && value.startsWith(`{"${JSON_SPECIAL_KEY_TYPE}":"`) && value.endsWith("}")) {
+      const data = JSON.parse(value);
+      const object = data[JSON_SPECIAL_KEY_TYPE];
+      switch (object) {
+        case "Undefined":
+          return void 0;
+        case "BigInt":
+          return BigInt(data[JSON_SPECIAL_KEY_VALUE]);
+        case "Uint8Array":
+          return import_Bytes.Bytes.fromHex(data[JSON_SPECIAL_KEY_VALUE]);
+        case "Map":
+          return new Map(
+            fromJson(data[JSON_SPECIAL_KEY_VALUE])
+          );
+        // TODO Remove in the future, leave here for now for backward compatibility?
+        case "AttributeId":
+        case "CaseAuthenticatedTag":
+        case "ClusterId":
+        case "CommandId":
+        case "DataVersion":
+        case "DeviceTypeId":
+        case "EndpointNumber":
+        case "EntryIndex":
+        case "EventId":
+        case "FabricIndex":
+        case "FieldId":
+        case "GroupId":
+        case "VendorId":
+          return data[JSON_SPECIAL_KEY_VALUE];
+        case "EventNumber":
+        case "FabricId":
+        case "NodeId":
+          return BigInt(data[JSON_SPECIAL_KEY_VALUE]);
+        default:
+          throw new import_MatterError.UnexpectedDataError(`Unknown object type: ${object}`);
+      }
+    }
+    return value;
+  });
+}
+//# sourceMappingURL=StringifyTools.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/StringifyTools.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,yBAAoC;AACpC,mBAAsB;AACtB,kBAAyB;AARzB;AAAA;AAAA;AAAA;AAAA;AAyBA,MAAM,wBAAwB;AAG9B,MAAM,yBAAyB;AAExB,SAAS,OAAO,QAA+B,QAAyB;AAC3E,SAAO,KAAK;AAAA,IACR;AAAA,IACA,CAAC,MAAM,UAAU;AACb,UAAI,UAAU,QAAW;AACrB,eAAO,KAAK,qBAAqB;AAAA,MACrC;AACA,UAAI,OAAO,UAAU,UAAU;AAC3B,eAAO,KAAK,qBAAqB,eAAe,sBAAsB,MAAM,MAAM,SAAS,CAAC;AAAA,MAChG;AACA,UAAI,iBAAiB,YAAY;AAC7B,eAAO,KAAK,qBAAqB,mBAAmB,sBAAsB,MAAM,mBAAM,MAAM,KAAK,CAAC;AAAA,MACtG;AAEA,cAAI,sBAAS,KAAK,KAAK,MAAM,SAAS,YAAY,MAAM,QAAQ,MAAM,IAAI,GAAG;AACzE,eAAO,KAAK,qBAAqB,mBAAmB,sBAAsB,MAAM,mBAAM;AAAA,UAClF,WAAW,KAAK,MAAM,IAAI;AAAA,QAC9B,CAAC;AAAA,MACL;AACA,UAAI,iBAAiB,KAAK;AACtB,eAAO,KAAK,qBAAqB,YAAY,sBAAsB,KAAK,KAAK;AAAA,UACzE,OAAO,MAAM,KAAK,MAAM,QAAQ,CAAC,CAAC;AAAA,QACtC,CAAC;AAAA,MACL;AACA,aAAO;AAAA,IACX;AAAA,IACA;AAAA,EACJ;AACJ;AAEO,SAAS,SAAS,MAAqC;AAC1D,SAAO,KAAK,MAAM,MAAM,CAAC,MAAM,UAAU;AACrC,QAAI,OAAO,UAAU,YAAY,MAAM,WAAW,KAAK,qBAAqB,KAAK,KAAK,MAAM,SAAS,GAAG,GAAG;AACvG,YAAM,OAAO,KAAK,MAAM,KAAK;AAC7B,YAAM,SAAS,KAAK,qBAAqB;AACzC,cAAQ,QAAQ;AAAA,QACZ,KAAK;AACD,iBAAO;AAAA,QACX,KAAK;AACD,iBAAO,OAAO,KAAK,sBAAsB,CAAC;AAAA,QAC9C,KAAK;AACD,iBAAO,mBAAM,QAAQ,KAAK,sBAAsB,CAAC;AAAA,QACrD,KAAK;AACD,iBAAO,IAAI;AAAA,YACP,SAAS,KAAK,sBAAsB,CAAC;AAAA,UAIzC;AAAA;AAAA,QAGJ,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AACD,iBAAO,KAAK,sBAAsB;AAAA,QACtC,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AACD,iBAAO,OAAO,KAAK,sBAAsB,CAAC;AAAA,QAE9C;AACI,gBAAM,IAAI,uCAAoB,wBAAwB,MAAM,EAAE;AAAA,MACtE;AAAA,IACJ;AACA,WAAO;AAAA,EACX,CAAC;AACL;",
+  "names": []
+}

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

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Storage.js";
+export * from "./StorageBackendMemory.js";
+export * from "./StorageContext.js";
+export * from "./StorageManager.js";
+export * from "./StorageService.js";
+export * from "./StringifyTools.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cjs/storage/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var storage_exports = {};
+module.exports = __toCommonJS(storage_exports);
+__reExport(storage_exports, require("./Storage.js"), module.exports);
+__reExport(storage_exports, require("./StorageBackendMemory.js"), module.exports);
+__reExport(storage_exports, require("./StorageContext.js"), module.exports);
+__reExport(storage_exports, require("./StorageManager.js"), module.exports);
+__reExport(storage_exports, require("./StorageService.js"), module.exports);
+__reExport(storage_exports, require("./StringifyTools.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,4BAAc,yBANd;AAOA,4BAAc,sCAPd;AAQA,4BAAc,gCARd;AASA,4BAAc,gCATd;AAUA,4BAAc,gCAVd;AAWA,4BAAc,gCAXd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/time/Time.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Diagnostic } from "../log/Diagnostic.js";
+/**
+ * Timer and date/time management interface.
+ *
+ * You may replace this platform abstraction but we provide an implementation compatible with any standard JS
+ * environment.
+ */
+export declare class Time {
+    static get: () => Time;
+    now(): Date;
+    static readonly now: () => Date;
+    nowMs(): number;
+    static readonly nowMs: () => number;
+    /** Returns a timer that will call callback after durationMs has passed. */
+    getTimer(name: string, durationMs: number, callback: Timer.Callback): Timer;
+    static readonly getTimer: (name: string, durationMs: number, callback: Timer.Callback) => Timer;
+    /** Returns a timer that will periodically call callback at intervalMs intervals. */
+    getPeriodicTimer(name: string, intervalMs: number, callback: Timer.Callback): Timer;
+    static readonly getPeriodicTimer: (name: string, intervalMs: number, callback: Timer.Callback) => Timer;
+    static readonly sleep: (name: string, durationMs: number) => Promise<void>;
+    static register(timer: Timer): void;
+    static unregister(timer: Timer): void;
+}
+export interface Timer {
+    /** Name (diagnostics) */
+    name: string;
+    /** Set to true to indicate the timer should not prevent program exit */
+    utility: boolean;
+    /** System ID (diagnostics) */
+    systemId: unknown;
+    /** Interval (diagnostics) */
+    intervalMs: number;
+    /** Is the timer periodic? (diagnostics) */
+    isPeriodic: boolean;
+    /** Amount of time interval has been active (diagnostics) */
+    elapsed?: Diagnostic.Elapsed;
+    /** Is true if this timer is running. */
+    isRunning: boolean;
+    /** Starts this timer, chainable. */
+    start(): Timer;
+    /** Stops this timer, chainable. */
+    stop(): Timer;
+}
+export declare namespace Timer {
+    type Callback = () => any;
+}
+export declare class StandardTimer implements Timer {
+    #private;
+    readonly name: string;
+    readonly intervalMs: number;
+    private readonly callback;
+    readonly isPeriodic: boolean;
+    isRunning: boolean;
+    get systemId(): number;
+    constructor(name: string, intervalMs: number, callback: Timer.Callback, isPeriodic: boolean);
+    get utility(): boolean;
+    set utility(utility: boolean);
+    start(): this;
+    stop(): this;
+}
+//# sourceMappingURL=Time.d.ts.map

package/dist/cjs/time/Time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../../../src/time/Time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKlD;;;;;GAKG;AACH,qBAAa,IAAI;IACb,MAAM,CAAC,GAAG,aAAc;IAExB,GAAG;IAGH,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAO,IAAI,CAAqB;IAEnD,KAAK;IAGL,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAO,MAAM,CAAuB;IAEzD,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,KAAK;IAG3E,MAAM,CAAC,QAAQ,CAAC,QAAQ,SAAU,MAAM,cAAc,MAAM,YAAY,KAAK,CAAC,QAAQ,KAAG,KAAK,CAC1C;IAEpD,oFAAoF;IACpF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,KAAK;IAGnF,MAAM,CAAC,QAAQ,CAAC,gBAAgB,SAAU,MAAM,cAAc,MAAM,YAAY,KAAK,CAAC,QAAQ,KAAG,KAAK,CAC1C;IAE5D,MAAM,CAAC,QAAQ,CAAC,KAAK,SAAgB,MAAM,cAAc,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CACI;IAEnF,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK;IAK5B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK;CAGjC;AAID,MAAM,WAAW,KAAK;IAClB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;IAEjB,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAElB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC;IAEpB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC;IAE7B,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IAEnB,oCAAoC;IACpC,KAAK,IAAI,KAAK,CAAC;IAEf,mCAAmC;IACnC,IAAI,IAAI,KAAK,CAAC;CACjB;AAED,yBAAiB,KAAK,CAAC;IACnB,KAAY,QAAQ,GAAG,MAAM,GAAG,CAAC;CACpC;AAED,qBAAa,aAAc,YAAW,KAAK;;IAUnC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO;IAVhC,SAAS,UAAS;IAElB,IAAI,QAAQ,WAEX;gBAGY,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EACV,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAChC,UAAU,EAAE,OAAO;IAShC,IAAI,OAAO,IAIU,OAAO,CAF3B;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,EAgB3B;IAED,KAAK;IAcL,IAAI;CAMP"}