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

package/dist/cjs/storage/StorageBackendDisk.js

@@ -0,0 +1,128 @@
+"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 StorageBackendDisk_exports = {};
+__export(StorageBackendDisk_exports, {
+  StorageBackendDisk: () => StorageBackendDisk
+});
+module.exports = __toCommonJS(StorageBackendDisk_exports);
+var import_general = require("#general");
+var import_node_localstorage = require("node-localstorage");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class StorageBackendDisk extends import_general.SyncStorage {
+  localStorage;
+  isInitialized = false;
+  constructor(path, clear = false) {
+    super();
+    this.localStorage = new import_node_localstorage.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 import_general.StorageError("Context must not be an empty and not contain dots.");
+    return contextKey;
+  }
+  buildStorageKey(contexts, key) {
+    if (!key.length) {
+      throw new import_general.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 (0, import_general.fromJson)(value);
+  }
+  set(contexts, keyOrValues, value) {
+    if (typeof keyOrValues === "string") {
+      this.localStorage.setItem(this.buildStorageKey(contexts, keyOrValues), (0, import_general.toJson)(value));
+    } else {
+      for (const [key, value2] of Object.entries(keyOrValues)) {
+        this.localStorage.setItem(this.buildStorageKey(contexts, key), (0, import_general.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);
+      }
+    }
+  }
+}
+//# sourceMappingURL=StorageBackendDisk.js.map

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

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

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

@@ -0,0 +1,110 @@
+"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 StorageBackendJsonFile_exports = {};
+__export(StorageBackendJsonFile_exports, {
+  StorageBackendJsonFile: () => StorageBackendJsonFile
+});
+module.exports = __toCommonJS(StorageBackendJsonFile_exports);
+var import_general = require("#general");
+var import_promises = require("fs/promises");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class StorageBackendJsonFile extends import_general.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 = import_general.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 import_general.StorageError("Storage already initialized!");
+    super.initialize();
+    try {
+      this.store = this.fromJson(await (0, import_promises.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 (0, import_promises.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 (0, import_general.toJson)(object, 1);
+  }
+  fromJson(json) {
+    return (0, import_general.fromJson)(json);
+  }
+}
+//# sourceMappingURL=StorageBackendJsonFile.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/StorageBackendJsonFile.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAkG;AAClG,sBAAoC;AAPpC;AAAA;AAAA;AAAA;AAAA;AASO,MAAM,+BAA+B,oCAAqB;AAAA,EAW7D,YAA6B,MAAc;AACvC,UAAM;AADmB;AAAA,EAE7B;AAAA;AAAA,EAXA,OAAO,cAAc;AAAA,EACrB,YAAY,QAAQ,QAAQ;AAAA,EAEX,cAAc,oBAAK;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,4BAAa,8BAA8B;AAC3E,UAAM,WAAW;AACjB,QAAI;AACA,WAAK,QAAQ,KAAK,SAAS,UAAM,0BAAS,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,gBAAM,2BAAU,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,eAAO,uBAAO,QAAQ,CAAC;AAAA,EAC3B;AAAA,EAEQ,SAAS,MAAmB;AAChC,eAAO,yBAAS,IAAI;AAAA,EACxB;AACJ;",
+  "names": []
+}

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

package/dist/cjs/storage/index.js

@@ -0,0 +1,25 @@
+"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("./StorageBackendDisk.js"), module.exports);
+__reExport(storage_exports, require("./StorageBackendJsonFile.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,oCANd;AAOA,4BAAc,wCAPd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}