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

package/dist/esm/net/NodeJsUdpChannel.js

@@ -0,0 +1,159 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  ChannelType,
+  Diagnostic,
+  isIPv4,
+  isIPv6,
+  Logger,
+  MAX_UDP_MESSAGE_SIZE,
+  NetworkError
+} from "#general";
+import { RetransmissionLimitReachedError } from "#protocol";
+import * as dgram from "dgram";
+import { NodeJsNetwork } from "./NodeJsNetwork.js";
+const logger = Logger.get("UdpChannelNode");
+function createDgramSocket(host, port, options) {
+  const socket = dgram.createSocket(options);
+  return new Promise((resolve, reject) => {
+    const handleBindError = (error) => {
+      try {
+        socket.close();
+      } catch (error2) {
+        logger.debug("Error on closing socket", error2);
+      }
+      reject(error);
+    };
+    socket.on("error", handleBindError);
+    socket.bind(port, host, () => {
+      const { address: localHost, port: localPort } = socket.address();
+      logger.debug(
+        "Socket created and bound ",
+        Diagnostic.dict({
+          remoteAddress: `${host}:${port}`,
+          localAddress: `${localHost}:${localPort}`
+        })
+      );
+      socket.removeListener("error", handleBindError);
+      socket.on("error", (error) => logger.error(error));
+      resolve(socket);
+    });
+  });
+}
+class NodeJsUdpChannel {
+  constructor(type, socket, netInterface) {
+    this.type = type;
+    this.socket = socket;
+    this.netInterface = netInterface;
+  }
+  static async create({
+    listeningPort,
+    type,
+    listeningAddress,
+    netInterface,
+    membershipAddresses
+  }) {
+    const socketOptions = { type, reuseAddr: true };
+    if (type === "udp6") {
+      socketOptions.ipv6Only = true;
+    }
+    const socket = await createDgramSocket(listeningAddress, listeningPort, socketOptions);
+    socket.setBroadcast(true);
+    let netInterfaceZone;
+    if (netInterface !== void 0) {
+      netInterfaceZone = NodeJsNetwork.getNetInterfaceZoneIpv6(netInterface);
+      let multicastInterface;
+      if (type === "udp4") {
+        multicastInterface = NodeJsNetwork.getMulticastInterfaceIpv4(netInterface);
+        if (multicastInterface === void 0) {
+          throw new NetworkError(`No IPv4 addresses on interface: ${netInterface}`);
+        }
+      } else {
+        if (netInterfaceZone === void 0) {
+          throw new NetworkError(`No IPv6 addresses on interface: ${netInterface}`);
+        }
+        multicastInterface = `::%${netInterfaceZone}`;
+      }
+      logger.debug(
+        "Initialize multicast",
+        Diagnostic.dict({
+          address: `${multicastInterface}:${listeningPort}`,
+          interface: netInterface,
+          type
+        })
+      );
+      socket.setMulticastInterface(multicastInterface);
+    }
+    if (membershipAddresses !== void 0) {
+      const multicastInterfaces = NodeJsNetwork.getMembershipMulticastInterfaces(netInterface, type === "udp4");
+      for (const address of membershipAddresses) {
+        for (const multicastInterface of multicastInterfaces) {
+          try {
+            socket.addMembership(address, multicastInterface);
+          } catch (error) {
+            logger.warn(
+              `Error adding membership for address ${address}${multicastInterface ? ` with interface ${multicastInterface}` : ""}: ${error}`
+            );
+          }
+        }
+      }
+    }
+    return new NodeJsUdpChannel(type, socket, netInterfaceZone);
+  }
+  maxPayloadSize = MAX_UDP_MESSAGE_SIZE;
+  onData(listener) {
+    const messageListener = (data, { address, port }) => {
+      const netInterface = this.netInterface ?? NodeJsNetwork.getNetInterfaceForIp(address);
+      if (netInterface === void 0) return;
+      listener(netInterface, address, port, data);
+    };
+    this.socket.on("message", messageListener);
+    return {
+      close: async () => {
+        this.socket.removeListener("message", messageListener);
+      }
+    };
+  }
+  async send(host, port, data) {
+    return new Promise((resolve, reject) => {
+      this.socket.send(data, port, host, (error) => {
+        if (error !== null) {
+          const netError = error instanceof Error && "code" in error && error.code === "EHOSTUNREACH" ? new RetransmissionLimitReachedError(error.message) : new NetworkError(error.message);
+          netError.stack = error.stack;
+          reject(netError);
+          return;
+        }
+        resolve();
+      });
+    });
+  }
+  async close() {
+    try {
+      this.socket.close();
+    } catch (error) {
+      logger.debug("Error on closing socket", error);
+    }
+  }
+  get port() {
+    return this.socket.address().port;
+  }
+  supports(type, address) {
+    if (type !== ChannelType.UDP) {
+      return false;
+    }
+    if (address === void 0) {
+      return true;
+    }
+    if (this.type === "udp4") {
+      return isIPv4(address);
+    }
+    return isIPv6(address);
+  }
+}
+export {
+  NodeJsUdpChannel
+};
+//# sourceMappingURL=NodeJsUdpChannel.js.map

package/dist/esm/net/NodeJsUdpChannel.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import "./register.js";
+export * from "./NodeJsNetwork.js";
+export * from "./NodeJsUdpChannel.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/net/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,eAAe,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/dist/esm/net/index.js

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import "./register.js";
+export * from "./NodeJsNetwork.js";
+export * from "./NodeJsUdpChannel.js";
+//# sourceMappingURL=index.js.map

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

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

package/dist/esm/net/register.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/esm/net/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/net/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/esm/net/register.js

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Network, NoProviderError, singleton } from "#general";
+import { NodeJsNetwork } from "./NodeJsNetwork.js";
+try {
+  Network.get();
+} catch (error) {
+  NoProviderError.accept(error);
+  Network.get = singleton(() => new NodeJsNetwork());
+  process.on("beforeExit", () => void Network.get().close());
+}
+//# sourceMappingURL=register.js.map

package/dist/esm/net/register.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/net/register.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,SAAS,iBAAiB,iBAAiB;AACpD,SAAS,qBAAqB;AAG9B,IAAI;AACA,UAAQ,IAAI;AAChB,SAAS,OAAO;AACZ,kBAAgB,OAAO,KAAK;AAE5B,UAAQ,MAAM,UAAU,MAAM,IAAI,cAAc,CAAC;AAGjD,UAAQ,GAAG,cAAc,MAAM,KAAK,QAAQ,IAAI,EAAE,MAAM,CAAC;AAC7D;",
+  "names": []
+}

package/dist/esm/package.json

@@ -0,0 +1,11 @@
+{
+    "type": "module",
+    "imports": {
+        "#general": "@matter/general",
+        "#types": "@matter/types",
+        "#clusters/*": "@matter/types/clusters/*",
+        "#node": "@matter/node",
+        "#protocol": "@matter/protocol",
+        "#*": "./*"
+    }
+}

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SupportedStorageTypes, SyncStorage } from "#general";
+export declare class StorageBackendDisk extends SyncStorage {
+    private readonly localStorage;
+    protected isInitialized: boolean;
+    constructor(path: string, clear?: boolean);
+    get initialized(): boolean;
+    initialize(): void;
+    close(): void;
+    clear(): void;
+    getContextBaseKey(contexts: string[], allowEmptyContext?: boolean): string;
+    buildStorageKey(contexts: string[], key: string): string;
+    get<T extends SupportedStorageTypes>(contexts: string[], key: string): T | undefined;
+    set(contexts: string[], key: string, value: SupportedStorageTypes): void;
+    set(contexts: string[], values: Record<string, SupportedStorageTypes>): void;
+    delete(contexts: string[], key: string): void;
+    /** Returns all keys of a storage context without keys of sub-contexts */
+    keys(contexts: string[]): string[];
+    values(contexts: string[]): Record<string, SupportedStorageTypes>;
+    contexts(contexts: string[]): string[];
+    clearAll(contexts: string[]): void;
+}
+//# sourceMappingURL=StorageBackendDisk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StorageBackendDisk.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageBackendDisk.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA0B,qBAAqB,EAAE,WAAW,EAAU,MAAM,UAAU,CAAC;AAG9F,qBAAa,kBAAmB,SAAQ,WAAW;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,SAAS,CAAC,aAAa,UAAS;gBAEpB,IAAI,EAAE,MAAM,EAAE,KAAK,UAAQ;IAMvC,IAAI,WAAW,YAEd;IAED,UAAU;IAIV,KAAK;IAIL,KAAK;IAIL,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,iBAAiB,UAAQ;IAY/D,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM;IAQ/C,GAAG,CAAC,CAAC,SAAS,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAMpF,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,IAAI;IACxE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,IAAI;IAe5E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM;IAItC,yEAAyE;IACzE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE;IAavB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE;IASzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAkB3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;CAS9B"}

package/dist/esm/storage/StorageBackendDisk.js

@@ -0,0 +1,108 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { fromJson, StorageError, SyncStorage, toJson } from "#general";
+import { LocalStorage } from "node-localstorage";
+class StorageBackendDisk extends SyncStorage {
+  localStorage;
+  isInitialized = false;
+  constructor(path, clear = false) {
+    super();
+    this.localStorage = new LocalStorage(path);
+    if (clear) this.clear();
+  }
+  get initialized() {
+    return this.isInitialized;
+  }
+  initialize() {
+    this.isInitialized = true;
+  }
+  close() {
+    this.isInitialized = false;
+  }
+  clear() {
+    this.localStorage.clear();
+  }
+  getContextBaseKey(contexts, allowEmptyContext = false) {
+    const contextKey = contexts.join(".");
+    if (!contextKey.length && !allowEmptyContext || contextKey.includes("..") || contextKey.startsWith(".") || contextKey.endsWith("."))
+      throw new StorageError("Context must not be an empty and not contain dots.");
+    return contextKey;
+  }
+  buildStorageKey(contexts, key) {
+    if (!key.length) {
+      throw new StorageError("Key must not be an empty string.");
+    }
+    const contextKey = this.getContextBaseKey(contexts);
+    return `${contextKey}.${key}`;
+  }
+  get(contexts, key) {
+    const value = this.localStorage.getItem(this.buildStorageKey(contexts, key));
+    if (value === null) return void 0;
+    return fromJson(value);
+  }
+  set(contexts, keyOrValues, value) {
+    if (typeof keyOrValues === "string") {
+      this.localStorage.setItem(this.buildStorageKey(contexts, keyOrValues), toJson(value));
+    } else {
+      for (const [key, value2] of Object.entries(keyOrValues)) {
+        this.localStorage.setItem(this.buildStorageKey(contexts, key), toJson(value2));
+      }
+    }
+  }
+  delete(contexts, key) {
+    this.localStorage.removeItem(this.buildStorageKey(contexts, key));
+  }
+  /** Returns all keys of a storage context without keys of sub-contexts */
+  keys(contexts) {
+    const contextKey = this.getContextBaseKey(contexts);
+    const keys = [];
+    const contextKeyStart = `${contextKey}.`;
+    const len = contextKeyStart.length;
+    for (const key of Object.keys(this.localStorage)) {
+      if (key.startsWith(contextKeyStart) && !key.includes(".", len)) {
+        keys.push(key.substring(len));
+      }
+    }
+    return keys;
+  }
+  values(contexts) {
+    const values = {};
+    for (const key of this.keys(contexts)) {
+      values[key] = this.get(contexts, key);
+    }
+    return values;
+  }
+  contexts(contexts) {
+    const contextKey = this.getContextBaseKey(contexts, true);
+    const startContextKey = contextKey.length ? `${contextKey}.` : "";
+    const len = startContextKey.length;
+    const foundContexts = new Array();
+    for (const key of Object.keys(this.localStorage)) {
+      if (key.startsWith(startContextKey)) {
+        const subKeys = key.substring(len).split(".");
+        if (subKeys.length === 1) continue;
+        const context = subKeys[0];
+        if (!foundContexts.includes(context)) {
+          foundContexts.push(context);
+        }
+      }
+    }
+    return foundContexts;
+  }
+  clearAll(contexts) {
+    const contextKey = this.getContextBaseKey(contexts, true);
+    const startContextKey = contextKey.length ? `${contextKey}.` : "";
+    for (const key of Object.keys(this.localStorage)) {
+      if (key.startsWith(startContextKey)) {
+        this.localStorage.removeItem(key);
+      }
+    }
+  }
+}
+export {
+  StorageBackendDisk
+};
+//# sourceMappingURL=StorageBackendDisk.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { StorageBackendMemory, SupportedStorageTypes } from "#general";
+export declare class StorageBackendJsonFile extends StorageBackendMemory {
+    private readonly path;
+    /** We store changes after a value was set to the storage, but not more often than this setting (in ms). */
+    static commitDelay: number;
+    committed: Promise<void>;
+    private readonly commitTimer;
+    private closed;
+    private resolveCommitted?;
+    constructor(path: string);
+    static create(path: string): Promise<StorageBackendJsonFile>;
+    initialize(): Promise<void>;
+    private triggerCommit;
+    set(contexts: string[], keyOrValues: string | Record<string, SupportedStorageTypes>, value?: SupportedStorageTypes): void;
+    delete(contexts: string[], key: string): void;
+    clear(): void;
+    private commit;
+    close(): Promise<void>;
+    private toJson;
+    private fromJson;
+}
+//# sourceMappingURL=StorageBackendJsonFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StorageBackendJsonFile.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageBackendJsonFile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAY,oBAAoB,EAAgB,qBAAqB,EAAgB,MAAM,UAAU,CAAC;AAG7G,qBAAa,sBAAuB,SAAQ,oBAAoB;IAWhD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVjC,2GAA2G;IAC3G,MAAM,CAAC,WAAW,SAAQ;IAC1B,SAAS,gBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAE1B;IACF,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAC,CAAa;gBAET,IAAI,EAAE,MAAM;WAInB,MAAM,CAAC,IAAI,EAAE,MAAM;IAM1B,UAAU;IAczB,OAAO,CAAC,aAAa;IASZ,GAAG,CACR,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAC3D,KAAK,CAAC,EAAE,qBAAqB,GAC9B,IAAI;IAKE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7C,KAAK,IAAI,IAAI;YAKR,MAAM;IAcL,KAAK;IAQpB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,QAAQ;CAGnB"}

package/dist/esm/storage/StorageBackendJsonFile.js

@@ -0,0 +1,90 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { fromJson, StorageBackendMemory, StorageError, Time, toJson } from "#general";
+import { readFile, writeFile } from "fs/promises";
+class StorageBackendJsonFile extends StorageBackendMemory {
+  constructor(path) {
+    super();
+    this.path = path;
+  }
+  /** We store changes after a value was set to the storage, but not more often than this setting (in ms). */
+  static commitDelay = 1e3;
+  committed = Promise.resolve();
+  commitTimer = Time.getTimer(
+    "Storage commit",
+    StorageBackendJsonFile.commitDelay,
+    () => this.commit()
+  );
+  closed = false;
+  resolveCommitted;
+  static async create(path) {
+    const storage = new this(path);
+    await storage.initialize();
+    return storage;
+  }
+  async initialize() {
+    if (this.initialized) throw new StorageError("Storage already initialized!");
+    super.initialize();
+    try {
+      this.store = this.fromJson(await readFile(this.path, "utf-8"));
+    } catch (error) {
+      if (error.code !== "ENOENT") {
+        throw error;
+      }
+    }
+    this.isInitialized = true;
+  }
+  triggerCommit() {
+    if (!this.commitTimer.isRunning) {
+      this.committed = new Promise((resolve) => {
+        this.resolveCommitted = resolve;
+      });
+      this.commitTimer.start();
+    }
+  }
+  set(contexts, keyOrValues, value) {
+    super.set(contexts, keyOrValues, value);
+    this.triggerCommit();
+  }
+  delete(contexts, key) {
+    super.delete(contexts, key);
+    this.triggerCommit();
+  }
+  clear() {
+    super.clear();
+    this.triggerCommit();
+  }
+  async commit() {
+    if (!this.initialized || this.closed) return;
+    if (this.commitTimer.isRunning) {
+      this.commitTimer.stop();
+    }
+    try {
+      await writeFile(this.path, this.toJson(this.store), "utf-8");
+    } finally {
+      if (this.resolveCommitted !== void 0) {
+        this.resolveCommitted?.();
+      }
+    }
+  }
+  async close() {
+    this.commitTimer.stop();
+    await this.commit();
+    super.close();
+    this.closed = true;
+    this.isInitialized = false;
+  }
+  toJson(object) {
+    return toJson(object, 1);
+  }
+  fromJson(json) {
+    return fromJson(json);
+  }
+}
+export {
+  StorageBackendJsonFile
+};
+//# sourceMappingURL=StorageBackendJsonFile.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/StorageBackendJsonFile.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,UAAU,sBAAsB,cAAqC,MAAM,cAAc;AAClG,SAAS,UAAU,iBAAiB;AAE7B,MAAM,+BAA+B,qBAAqB;AAAA,EAW7D,YAA6B,MAAc;AACvC,UAAM;AADmB;AAAA,EAE7B;AAAA;AAAA,EAXA,OAAO,cAAc;AAAA,EACrB,YAAY,QAAQ,QAAQ;AAAA,EAEX,cAAc,KAAK;AAAA,IAAS;AAAA,IAAkB,uBAAuB;AAAA,IAAa,MAC/F,KAAK,OAAO;AAAA,EAChB;AAAA,EACQ,SAAS;AAAA,EACT;AAAA,EAMR,aAAsB,OAAO,MAAc;AACvC,UAAM,UAAU,IAAI,KAAK,IAAI;AAC7B,UAAM,QAAQ,WAAW;AACzB,WAAO;AAAA,EACX;AAAA,EAEA,MAAe,aAAa;AACxB,QAAI,KAAK,YAAa,OAAM,IAAI,aAAa,8BAA8B;AAC3E,UAAM,WAAW;AACjB,QAAI;AACA,WAAK,QAAQ,KAAK,SAAS,MAAM,SAAS,KAAK,MAAM,OAAO,CAAC;AAAA,IACjE,SAAS,OAAY;AAEjB,UAAI,MAAM,SAAS,UAAU;AACzB,cAAM;AAAA,MACV;AAAA,IACJ;AACA,SAAK,gBAAgB;AAAA,EACzB;AAAA,EAEQ,gBAAgB;AACpB,QAAI,CAAC,KAAK,YAAY,WAAW;AAC7B,WAAK,YAAY,IAAI,QAAQ,aAAW;AACpC,aAAK,mBAAmB;AAAA,MAC5B,CAAC;AACD,WAAK,YAAY,MAAM;AAAA,IAC3B;AAAA,EACJ;AAAA,EAES,IACL,UACA,aACA,OACI;AACJ,UAAM,IAAI,UAAU,aAAa,KAAK;AACtC,SAAK,cAAc;AAAA,EACvB;AAAA,EAES,OAAO,UAAoB,KAAmB;AACnD,UAAM,OAAO,UAAU,GAAG;AAC1B,SAAK,cAAc;AAAA,EACvB;AAAA,EAES,QAAc;AACnB,UAAM,MAAM;AACZ,SAAK,cAAc;AAAA,EACvB;AAAA,EAEA,MAAc,SAAS;AACnB,QAAI,CAAC,KAAK,eAAe,KAAK,OAAQ;AACtC,QAAI,KAAK,YAAY,WAAW;AAC5B,WAAK,YAAY,KAAK;AAAA,IAC1B;AACA,QAAI;AACA,YAAM,UAAU,KAAK,MAAM,KAAK,OAAO,KAAK,KAAK,GAAG,OAAO;AAAA,IAC/D,UAAE;AACE,UAAI,KAAK,qBAAqB,QAAW;AACrC,aAAK,mBAAmB;AAAA,MAC5B;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,MAAe,QAAQ;AACnB,SAAK,YAAY,KAAK;AACtB,UAAM,KAAK,OAAO;AAClB,UAAM,MAAM;AACZ,SAAK,SAAS;AACd,SAAK,gBAAgB;AAAA,EACzB;AAAA,EAEQ,OAAO,QAAqB;AAChC,WAAO,OAAO,QAAQ,CAAC;AAAA,EAC3B;AAAA,EAEQ,SAAS,MAAmB;AAChC,WAAO,SAAS,IAAI;AAAA,EACxB;AACJ;",
+  "names": []
+}

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

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./StorageBackendDisk.js";
+export * from "./StorageBackendJsonFile.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/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,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC"}

package/dist/esm/storage/index.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./StorageBackendDisk.js";
+export * from "./StorageBackendJsonFile.js";
+//# sourceMappingURL=index.js.map

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

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