@matter/node 0.15.1 → 0.15.2-alpha.0-20250704-2715344f0

package/dist/esm/storage/EndpointStore.js

@@ -0,0 +1,105 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class EndpointStore {
+  initialValues = {};
+  #storage;
+  #knownBehaviors = /* @__PURE__ */ new Set();
+  constructor(storage) {
+    this.#storage = storage;
+  }
+  /**
+   * Retrieve the primary key used to identify this store.
+   */
+  get id() {
+    return this.storage.thisContexts[this.storage.thisContexts.length - 1];
+  }
+  /**
+   * Create a {@link Datasource.Store} for a behavior.
+   */
+  createStoreForBehavior(behaviorId, factory) {
+    const initialValues = this.initialValues[behaviorId];
+    if (initialValues !== void 0) {
+      delete this.initialValues[behaviorId];
+    }
+    return factory(this, behaviorId, initialValues);
+  }
+  /**
+   * Patch values.  Keyed by {@link Behavior.id} then property name.
+   *
+   * See {@link Datasource.Store.set} for the patch semantics the individual structs use.
+   */
+  async set(values) {
+    for (const behaviorId in values) {
+      const behaviorValues = values[behaviorId];
+      const behaviorStorage = this.storage.createContext(behaviorId);
+      if (behaviorValues === void 0) {
+        if (this.knownBehaviors.has(behaviorId)) {
+          await behaviorStorage.clearAll();
+          this.knownBehaviors.delete(behaviorId);
+        }
+        continue;
+      }
+      if (!this.knownBehaviors.has(behaviorId)) {
+        this.knownBehaviors.add(behaviorId);
+      }
+      const toSave = {};
+      let keysToSave = 0;
+      for (const key in behaviorValues) {
+        const value = behaviorValues[key];
+        if (value === void 0) {
+          await behaviorStorage.delete(key);
+        } else {
+          toSave[key] = value;
+          keysToSave++;
+        }
+      }
+      if (keysToSave > 0) {
+        await behaviorStorage.set(toSave);
+      }
+    }
+  }
+  /**
+   * Description used in diagnostic messages.
+   */
+  toString() {
+    return `storage:${this.#storage.thisContexts.join(".")}`;
+  }
+  /**
+   * IDs for behaviors persisted in this store.
+   */
+  get knownBehaviors() {
+    return this.#knownBehaviors;
+  }
+  /**
+   * Load the store with persisted values.
+   */
+  async load() {
+    this.#knownBehaviors = new Set(await this.storage.contexts());
+    for (const behaviorId of this.#knownBehaviors) {
+      const behaviorValues = this.initialValues[behaviorId] = {};
+      const behaviorStorage = this.storage.createContext(behaviorId);
+      const storedValues = await behaviorStorage.values();
+      for (const [key, value] of Object.entries(storedValues)) {
+        if (value !== void 0) {
+          behaviorValues[key] = value;
+        }
+      }
+    }
+  }
+  /**
+   * Remove all persisted information for the {@link Endpoint}
+   */
+  erase() {
+    return this.storage.clearAll();
+  }
+  get storage() {
+    return this.#storage;
+  }
+}
+export {
+  EndpointStore
+};
+//# sourceMappingURL=EndpointStore.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/EndpointStore.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAcO,MAAM,cAAc;AAAA,EACb,gBAAgB,CAAC;AAAA,EAE3B;AAAA,EAEA,kBAAkB,oBAAI,IAAY;AAAA,EAElC,YAAY,SAAyB;AACjC,SAAK,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,KAAK;AACL,WAAO,KAAK,QAAQ,aAAa,KAAK,QAAQ,aAAa,SAAS,CAAC;AAAA,EACzE;AAAA;AAAA;AAAA;AAAA,EAKA,uBAAuD,YAAoB,SAA2B;AAClG,UAAM,gBAAgB,KAAK,cAAc,UAAU;AACnD,QAAI,kBAAkB,QAAW;AAC7B,aAAO,KAAK,cAAc,UAAU;AAAA,IACxC;AAEA,WAAO,QAAQ,MAAM,YAAY,aAAa;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,IAAI,QAAgD;AACtD,eAAW,cAAc,QAAQ;AAC7B,YAAM,iBAAiB,OAAO,UAAU;AACxC,YAAM,kBAAkB,KAAK,QAAQ,cAAc,UAAU;AAE7D,UAAI,mBAAmB,QAAW;AAC9B,YAAI,KAAK,eAAe,IAAI,UAAU,GAAG;AACrC,gBAAM,gBAAgB,SAAS;AAC/B,eAAK,eAAe,OAAO,UAAU;AAAA,QACzC;AACA;AAAA,MACJ;AAEA,UAAI,CAAC,KAAK,eAAe,IAAI,UAAU,GAAG;AACtC,aAAK,eAAe,IAAI,UAAU;AAAA,MACtC;AAEA,YAAM,SAAS,CAAC;AAChB,UAAI,aAAa;AACjB,iBAAW,OAAO,gBAAgB;AAC9B,cAAM,QAAQ,eAAe,GAAG;AAChC,YAAI,UAAU,QAAW;AACrB,gBAAM,gBAAgB,OAAO,GAAG;AAAA,QACpC,OAAO;AACH,iBAAO,GAAG,IAAI;AACd;AAAA,QACJ;AAAA,MACJ;AACA,UAAI,aAAa,GAAG;AAChB,cAAM,gBAAgB,IAAI,MAAM;AAAA,MACpC;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW;AACP,WAAO,WAAW,KAAK,SAAS,aAAa,KAAK,GAAG,CAAC;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,iBAAiB;AACjB,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO;AACT,SAAK,kBAAkB,IAAI,IAAI,MAAM,KAAK,QAAQ,SAAS,CAAC;AAE5D,eAAW,cAAc,KAAK,iBAAiB;AAC3C,YAAM,iBAAkB,KAAK,cAAc,UAAU,IAAI,CAAC;AAC1D,YAAM,kBAAkB,KAAK,QAAQ,cAAc,UAAU;AAE7D,YAAM,eAAe,MAAM,gBAAgB,OAAO;AAClD,iBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,YAAY,GAAG;AACrD,YAAI,UAAU,QAAW;AACrB,yBAAe,GAAG,IAAI;AAAA,QAC1B;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ;AACJ,WAAO,KAAK,QAAQ,SAAS;AAAA,EACjC;AAAA,EAEA,IAAc,UAAU;AACpB,WAAO,KAAK;AAAA,EAChB;AACJ;",
+  "names": []
+}

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Endpoint } from "#endpoint/Endpoint.js";
+import { Construction, MaybePromise, StorageContextFactory } from "#general";
+import { EndpointStore } from "./EndpointStore.js";
+/**
+ * Non-volatile state management for a {@link Node}.
+ *
+ * We eagerly load all available data from disk on startup.  This prevents storage from forcing asynchronous
+ * {@link Endpoint} initialization.  We then can initialize most behaviors synchronously.
+ */
+export declare abstract class NodeStore {
+    #private;
+    get construction(): Construction<NodeStore>;
+    constructor(storageFactory: StorageContextFactory);
+    toString(): string;
+    [Construction.construct](): MaybePromise<void>;
+    abstract storeForEndpoint(endpoint: Endpoint): EndpointStore;
+    abstract erase(): MaybePromise<void>;
+    protected abstract load(): MaybePromise<void>;
+    protected createStorageContext(name: string): import("#general").StorageContext<any>;
+    protected get storageFactory(): StorageContextFactory<any>;
+}
+//# sourceMappingURL=NodeStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeStore.d.ts","sourceRoot":"","sources":["../../../src/storage/NodeStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;GAKG;AACH,8BAAsB,SAAS;;IAI3B,IAAI,YAAY,4BAEf;gBAEW,cAAc,EAAE,qBAAqB;IAKjD,QAAQ;IAIR,CAAC,YAAY,CAAC,SAAS,CAAC;IAIxB,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa;IAE5D,QAAQ,CAAC,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC;IAEpC,SAAS,CAAC,QAAQ,CAAC,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC;IAE7C,SAAS,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM;IAI3C,SAAS,KAAK,cAAc,+BAE3B;CACJ"}

package/dist/esm/storage/NodeStore.js

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Construction } from "#general";
+class NodeStore {
+  #storageFactory;
+  #construction;
+  get construction() {
+    return this.#construction;
+  }
+  constructor(storageFactory) {
+    this.#storageFactory = storageFactory;
+    this.#construction = Construction(this);
+  }
+  toString() {
+    return "node store";
+  }
+  [Construction.construct]() {
+    return this.load();
+  }
+  createStorageContext(name) {
+    return this.#storageFactory.createContext(name);
+  }
+  get storageFactory() {
+    return this.#storageFactory;
+  }
+}
+export {
+  NodeStore
+};
+//# sourceMappingURL=NodeStore.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/storage/NodeStore.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,oBAAyD;AAU3D,MAAe,UAAU;AAAA,EAC5B;AAAA,EACA;AAAA,EAEA,IAAI,eAAe;AACf,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,YAAY,gBAAuC;AAC/C,SAAK,kBAAkB;AACvB,SAAK,gBAAgB,aAAa,IAAI;AAAA,EAC1C;AAAA,EAEA,WAAW;AACP,WAAO;AAAA,EACX;AAAA,EAEA,CAAC,aAAa,SAAS,IAAI;AACvB,WAAO,KAAK,KAAK;AAAA,EACrB;AAAA,EAQU,qBAAqB,MAAc;AACzC,WAAO,KAAK,gBAAgB,cAAc,IAAI;AAAA,EAClD;AAAA,EAEA,IAAc,iBAAiB;AAC3B,WAAO,KAAK;AAAA,EAChB;AACJ;",
+  "names": []
+}

package/dist/esm/storage/client/ClientNodeStore.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Endpoint } from "#endpoint/Endpoint.js";
+import { EndpointStore } from "#storage/EndpointStore.js";
+import { NodeStore } from "../NodeStore.js";
+export declare class ClientNodeStore extends NodeStore {
+    #private;
+    get endpointStores(): MapIterator<EndpointStore>;
+    erase(): void | Promise<void> | undefined;
+    storeForEndpoint(endpoint: Endpoint): EndpointStore;
+    protected load(): Promise<void>;
+}
+//# sourceMappingURL=ClientNodeStore.d.ts.map

package/dist/esm/storage/client/ClientNodeStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientNodeStore.d.ts","sourceRoot":"","sources":["../../../../src/storage/client/ClientNodeStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,qBAAa,eAAgB,SAAQ,SAAS;;IAI1C,IAAI,cAAc,+BAEjB;IAEQ,KAAK;IAKL,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa;cAgBnC,IAAI;CAahC"}

package/dist/esm/storage/client/ClientNodeStore.js

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InternalError } from "#general";
+import { EndpointStore } from "#storage/EndpointStore.js";
+import { NodeStore } from "../NodeStore.js";
+class ClientNodeStore extends NodeStore {
+  #storage;
+  #stores = /* @__PURE__ */ new Map();
+  get endpointStores() {
+    return this.#stores.values();
+  }
+  erase() {
+    this.#stores = /* @__PURE__ */ new Map();
+    return this.#storage?.clearAll();
+  }
+  storeForEndpoint(endpoint) {
+    const { number } = endpoint;
+    if (this.#storage === void 0) {
+      throw new InternalError(`Endpoint storage ${this.toString()}.endpoints.${number} accessed before load`);
+    }
+    let store = this.#stores.get(number);
+    if (store === void 0) {
+      store = new EndpointStore(this.#storage.createContext(number.toString()));
+      this.#stores.set(number, store);
+    }
+    return store;
+  }
+  async load() {
+    this.#storage = this.storageFactory.createContext("endpoints");
+    for (const id of await this.#storage.contexts()) {
+      const number = Number.parseInt(id);
+      if (Number.isNaN(number)) {
+        continue;
+      }
+      const store = new EndpointStore(this.#storage.createContext(id));
+      await store.load();
+      this.#stores.set(number, store);
+    }
+  }
+}
+export {
+  ClientNodeStore
+};
+//# sourceMappingURL=ClientNodeStore.js.map

package/dist/esm/storage/client/ClientNodeStore.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/storage/client/ClientNodeStore.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,qBAAqC;AAC9C,SAAS,qBAAqB;AAE9B,SAAS,iBAAiB;AAEnB,MAAM,wBAAwB,UAAU;AAAA,EAC3C;AAAA,EACA,UAAU,oBAAI,IAAmC;AAAA,EAEjD,IAAI,iBAAiB;AACjB,WAAO,KAAK,QAAQ,OAAO;AAAA,EAC/B;AAAA,EAES,QAAQ;AACb,SAAK,UAAU,oBAAI,IAAI;AACvB,WAAO,KAAK,UAAU,SAAS;AAAA,EACnC;AAAA,EAES,iBAAiB,UAAmC;AACzD,UAAM,EAAE,OAAO,IAAI;AAEnB,QAAI,KAAK,aAAa,QAAW;AAC7B,YAAM,IAAI,cAAc,oBAAoB,KAAK,SAAS,CAAC,cAAc,MAAM,uBAAuB;AAAA,IAC1G;AAEA,QAAI,QAAQ,KAAK,QAAQ,IAAI,MAAM;AACnC,QAAI,UAAU,QAAW;AACrB,cAAQ,IAAI,cAAc,KAAK,SAAS,cAAc,OAAO,SAAS,CAAC,CAAC;AACxE,WAAK,QAAQ,IAAI,QAAQ,KAAK;AAAA,IAClC;AAEA,WAAO;AAAA,EACX;AAAA,EAEA,MAAyB,OAAO;AAC5B,SAAK,WAAW,KAAK,eAAe,cAAc,WAAW;AAC7D,eAAW,MAAM,MAAM,KAAK,SAAS,SAAS,GAAG;AAC7C,YAAM,SAAS,OAAO,SAAS,EAAE;AACjC,UAAI,OAAO,MAAM,MAAM,GAAG;AACtB;AAAA,MACJ;AAEA,YAAM,QAAQ,IAAI,cAAc,KAAK,SAAS,cAAc,EAAE,CAAC;AAC/D,YAAM,MAAM,KAAK;AACjB,WAAK,QAAQ,IAAI,QAAQ,KAAK;AAAA,IAClC;AAAA,EACJ;AACJ;",
+  "names": []
+}

package/dist/{cjs/node/storage/ClientStoreService.d.ts → esm/storage/client/ClientNodeStores.d.ts}

@@ -5,42 +5,32 @@
  */
 import { Construction, StorageContext } from "#general";
 import type { ClientNode } from "#node/ClientNode.js";
-import { NodeStore } from "./NodeStore.js";
+import { NodeStore } from "../NodeStore.js";
 /**
- * Manages all {@link ClientNodeStore}s for a {@link Node}.
- *
- * We eagerly load all available endpoint data from disk because this allows us to keep {@link Endpoint} initialization
- * more synchronous.  We can initialize most behaviors synchronously if their state is already in memory.
- *
- * TODO - cleanup of storage for permanently removed endpoints
+ * Manages {@link ClientNodeStore}s for a {@link Node}.
  */
-export declare abstract class ClientStoreService {
+export declare class ClientNodeStores {
+    #private;
+    get construction(): Construction<ClientNodeStores>;
+    constructor(storage: StorageContext);
+    [Construction.construct](): Promise<void>;
     /**
-     * Allocate a stable local ID. for a peer
+     * Allocate a stable local ID for a peer.
      *
      * The ID may be preassigned or we will assign using an incrementing sequential number.  The number is reserved for
      * the life of this process or, if data is persisted, until erased.
      */
-    abstract allocateId(): string;
+    allocateId(): string;
     /**
      * Obtain the store for a single {@link ClientNode}.
      *
      * These stores are cached internally by ID.
      */
-    abstract storeForNode(node: ClientNode): NodeStore;
+    storeForNode(node: ClientNode): NodeStore;
     /**
      * List all nodes present.
      */
-    abstract knownIds: string[];
-}
-export declare class ClientStoreFactory extends ClientStoreService {
-    #private;
-    get construction(): Construction<ClientStoreFactory>;
-    constructor(storage: StorageContext);
-    [Construction.construct](): Promise<void>;
-    allocateId(): string;
-    storeForNode(node: ClientNode): NodeStore;
     get knownIds(): string[];
     close(): Promise<void>;
 }
-//# sourceMappingURL=ClientStoreService.d.ts.map
+//# sourceMappingURL=ClientNodeStores.d.ts.map

package/dist/esm/storage/client/ClientNodeStores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientNodeStores.d.ts","sourceRoot":"","sources":["../../../../src/storage/client/ClientNodeStores.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAwB,cAAc,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK5C;;GAEG;AACH,qBAAa,gBAAgB;;IAMzB,IAAI,YAAY,mCAEf;gBAEW,OAAO,EAAE,cAAc;IAM7B,CAAC,YAAY,CAAC,SAAS,CAAC;IAwB9B;;;;;OAKG;IACH,UAAU;IAMV;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS;IAWzC;;OAEG;IACH,IAAI,QAAQ,aAIX;IAEK,KAAK;CAUd"}

package/dist/esm/{node/storage/ClientStoreService.js → storage/client/ClientNodeStores.js}

@@ -4,11 +4,9 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Construction, MatterAggregateError } from "#general";
-import { NodeStore } from "./NodeStore.js";
+import { ClientNodeStore } from "./ClientNodeStore.js";
 const CLIENT_ID_PREFIX = "peer";
-class ClientStoreService {
-}
-class ClientStoreFactory extends ClientStoreService {
+class ClientNodeStores {
   #storage;
   #stores = {};
   #construction;
@@ -17,7 +15,6 @@ class ClientStoreFactory extends ClientStoreService {
     return this.#construction;
   }
   constructor(storage) {
-    super();
     this.#storage = storage;
     this.#construction = Construction(this);
     this.#construction.start();
@@ -34,30 +31,39 @@ class ClientStoreFactory extends ClientStoreService {
           this.#nextAutomaticId = num + 1;
         }
       }
-      const store = new NodeStore(this.#storage.createContext(id));
-      this.#stores[id] = store;
-      store.construction.start();
+      this.#createNodeStore(id);
     }
     await MatterAggregateError.allSettled(
       Object.values(this.#stores).map((store) => store.construction.ready),
       "Error while initializing client stores"
     );
   }
+  /**
+   * Allocate a stable local ID for a peer.
+   *
+   * The ID may be preassigned or we will assign using an incrementing sequential number.  The number is reserved for
+   * the life of this process or, if data is persisted, until erased.
+   */
   allocateId() {
     this.#construction.assert();
     return `${CLIENT_ID_PREFIX}${this.#nextAutomaticId++}`;
   }
+  /**
+   * Obtain the store for a single {@link ClientNode}.
+   *
+   * These stores are cached internally by ID.
+   */
   storeForNode(node) {
     this.#construction.assert();
-    let store = this.#stores[node.id];
+    const store = this.#stores[node.id];
     if (store) {
       return store;
     }
-    store = new NodeStore(this.#storage.createContext(node.id));
-    store.construction.start();
-    this.#stores[node.id] = store;
-    return store;
+    return this.#createNodeStore(node.id);
   }
+  /**
+   * List all nodes present.
+   */
   get knownIds() {
     this.#construction.assert();
     return Object.keys(this.#stores);
@@ -65,9 +71,14 @@ class ClientStoreFactory extends ClientStoreService {
   async close() {
     await this.construction;
   }
+  #createNodeStore(id) {
+    const store = new ClientNodeStore(this.#storage.createContext(id));
+    store.construction.start();
+    this.#stores[id] = store;
+    return store;
+  }
 }
 export {
-  ClientStoreFactory,
-  ClientStoreService
+  ClientNodeStores
 };
-//# sourceMappingURL=ClientStoreService.js.map
+//# sourceMappingURL=ClientNodeStores.js.map

package/dist/esm/storage/client/ClientNodeStores.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/storage/client/ClientNodeStores.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,cAAc,4BAA4C;AAInE,SAAS,uBAAuB;AAEhC,MAAM,mBAAmB;AAKlB,MAAM,iBAAiB;AAAA,EAC1B;AAAA,EACA,UAAU,CAAC;AAAA,EACX;AAAA,EACA,mBAAmB;AAAA,EAEnB,IAAI,eAAe;AACf,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,YAAY,SAAyB;AACjC,SAAK,WAAW;AAChB,SAAK,gBAAgB,aAAa,IAAI;AACtC,SAAK,cAAc,MAAM;AAAA,EAC7B;AAAA,EAEA,OAAO,aAAa,SAAS,IAAI;AAC7B,UAAM,WAAW,MAAM,KAAK,SAAS,SAAS;AAE9C,eAAW,MAAM,UAAU;AACvB,UAAI,CAAC,GAAG,WAAW,gBAAgB,GAAG;AAClC;AAAA,MACJ;AAEA,YAAM,MAAM,OAAO,SAAS,GAAG,MAAM,iBAAiB,MAAM,CAAC;AAC7D,UAAI,CAAC,OAAO,MAAM,GAAG,GAAG;AACpB,YAAI,KAAK,oBAAoB,KAAK;AAC9B,eAAK,mBAAmB,MAAM;AAAA,QAClC;AAAA,MACJ;AAEA,WAAK,iBAAiB,EAAE;AAAA,IAC5B;AAEA,UAAM,qBAAqB;AAAA,MACvB,OAAO,OAAO,KAAK,OAAO,EAAE,IAAI,WAAS,MAAM,aAAa,KAAK;AAAA,MACjE;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,aAAa;AACT,SAAK,cAAc,OAAO;AAE1B,WAAO,GAAG,gBAAgB,GAAG,KAAK,kBAAkB;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,MAA6B;AACtC,SAAK,cAAc,OAAO;AAE1B,UAAM,QAAQ,KAAK,QAAQ,KAAK,EAAE;AAClC,QAAI,OAAO;AACP,aAAO;AAAA,IACX;AAEA,WAAO,KAAK,iBAAiB,KAAK,EAAE;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,WAAW;AACX,SAAK,cAAc,OAAO;AAE1B,WAAO,OAAO,KAAK,KAAK,OAAO;AAAA,EACnC;AAAA,EAEA,MAAM,QAAQ;AACV,UAAM,KAAK;AAAA,EACf;AAAA,EAEA,iBAAiB,IAAY;AACzB,UAAM,QAAQ,IAAI,gBAAgB,KAAK,SAAS,cAAc,EAAE,CAAC;AACjE,UAAM,aAAa,MAAM;AACzB,SAAK,QAAQ,EAAE,IAAI;AACnB,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/esm/storage/client/DatasourceCache.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Datasource } from "#behavior/state/managed/Datasource.js";
+import { Val } from "#protocol";
+import { EndpointStore } from "#storage/EndpointStore.js";
+/**
+ * Factory function for the default implementation of {@link Datasource.ExternallyMutableStore}.
+ *
+ * This implements storage for attribute values for a single cluster loaded from remote nodes.
+ */
+export declare function DatasourceCache(store: EndpointStore, behaviorId: string, initialValues: Val.Struct | undefined): Datasource.ExternallyMutableStore;
+export declare namespace DatasourceCache {
+    /**
+     * Standard key for storing the version.
+     *
+     * This conveys the version to the {@link Datasource}.
+     */
+    const VERSION_KEY = "__version__";
+}
+//# sourceMappingURL=DatasourceCache.d.ts.map

package/dist/esm/storage/client/DatasourceCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatasourceCache.d.ts","sourceRoot":"","sources":["../../../../src/storage/client/DatasourceCache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAEnE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG1D;;;;GAIG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,GAAG,CAAC,MAAM,GAAG,SAAS,GACtC,UAAU,CAAC,sBAAsB,CAoCnC;AAID,yBAAiB,eAAe,CAAC;IAC7B;;;;OAIG;IACI,MAAM,WAAW,gBAAgB,CAAC;CAC5C"}

package/dist/esm/storage/client/DatasourceCache.js

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Datasource } from "#behavior/state/managed/Datasource.js";
+import { InternalError } from "#general";
+import { DatasourceStore } from "../server/DatasourceStore.js";
+function DatasourceCache(store, behaviorId, initialValues) {
+  let version = initialValues?.[DatasourceCache.VERSION_KEY];
+  if (typeof version !== "number") {
+    version = Datasource.UNKNOWN_VERSION;
+  }
+  return {
+    ...DatasourceStore(store, behaviorId, initialValues),
+    async externalSet(values) {
+      if (typeof values[DatasourceCache.VERSION_KEY] === "number") {
+        version = values[DatasourceCache.VERSION_KEY];
+      }
+      await store.set({ [behaviorId]: values });
+      if (this.externalChangeListener) {
+        await this.externalChangeListener(values);
+      } else {
+        if (!this.initialValues) {
+          this.initialValues = {};
+        }
+        Object.assign(this.initialValues, values);
+      }
+    },
+    externalChangeListener: void 0,
+    get version() {
+      return version;
+    },
+    set version(_version) {
+      throw new InternalError("Datasource version must be set via externalSet");
+    }
+  };
+}
+DatasourceCache;
+((DatasourceCache2) => {
+  DatasourceCache2.VERSION_KEY = "__version__";
+})(DatasourceCache || (DatasourceCache = {}));
+export {
+  DatasourceCache
+};
+//# sourceMappingURL=DatasourceCache.js.map

package/dist/esm/storage/client/DatasourceCache.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/storage/client/DatasourceCache.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAG9B,SAAS,uBAAuB;AAOzB,SAAS,gBACZ,OACA,YACA,eACiC;AACjC,MAAI,UAAU,gBAAgB,gBAAgB,WAAW;AACzD,MAAI,OAAO,YAAY,UAAU;AAC7B,cAAU,WAAW;AAAA,EACzB;AAEA,SAAO;AAAA,IACH,GAAG,gBAAgB,OAAO,YAAY,aAAa;AAAA,IAEnD,MAAM,YAAY,QAAoB;AAClC,UAAI,OAAO,OAAO,gBAAgB,WAAW,MAAM,UAAU;AACzD,kBAAU,OAAO,gBAAgB,WAAW;AAAA,MAChD;AAEA,YAAM,MAAM,IAAI,EAAE,CAAC,UAAU,GAAG,OAAO,CAAC;AAExC,UAAI,KAAK,wBAAwB;AAC7B,cAAM,KAAK,uBAAuB,MAAM;AAAA,MAC5C,OAAO;AACH,YAAI,CAAC,KAAK,eAAe;AACrB,eAAK,gBAAgB,CAAC;AAAA,QAC1B;AACA,eAAO,OAAO,KAAK,eAAe,MAAM;AAAA,MAC5C;AAAA,IACJ;AAAA,IAEA,wBAAwB;AAAA,IAExB,IAAI,UAAU;AACV,aAAO;AAAA,IACX;AAAA,IAEA,IAAI,QAAQ,UAAkB;AAC1B,YAAM,IAAI,cAAc,gDAAgD;AAAA,IAC5E;AAAA,EACJ;AACJ;AAEA;AAAA,CAEO,CAAUA,qBAAV;AAMI,EAAMA,iBAAA,cAAc;AAAA,GANd;",
+  "names": ["DatasourceCache"]
+}

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

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./client/ClientNodeStore.js";
+export * from "./client/ClientNodeStores.js";
+export * from "./client/DatasourceCache.js";
+export * from "./NodeStore.js";
+export * from "./server/DatasourceStore.js";
+export * from "./server/ServerEndpointStore.js";
+export * from "./server/ServerEndpointStores.js";
+export * from "./server/ServerNodeStore.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,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC"}

package/dist/esm/storage/index.js

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./client/ClientNodeStore.js";
+export * from "./client/ClientNodeStores.js";
+export * from "./client/DatasourceCache.js";
+export * from "./NodeStore.js";
+export * from "./server/DatasourceStore.js";
+export * from "./server/ServerEndpointStore.js";
+export * from "./server/ServerEndpointStores.js";
+export * from "./server/ServerNodeStore.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;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/{cjs/endpoint/storage → esm/storage/server}/DatasourceStore.d.ts

@@ -5,11 +5,14 @@
  */
 import { Datasource } from "#behavior/state/managed/Datasource.js";
 import { Val } from "#protocol";
-import type { EndpointStore } from "./EndpointStore.js";
+import type { EndpointStore } from "#storage/EndpointStore.js";
 /**
  * Factory function for the default implementation of {@link Datasource.Store}.
  *
- * Performs read & write for non-volatile values for a single behavior via the {@link EndpointStore} interface.
+ * Performs read & write for non-volatile values for a single behavior via the {@link ServerEndpointStore} interface.
  */
 export declare function DatasourceStore(endpointStore: EndpointStore, behaviorId: string, initialValues: Val.Struct | undefined): Datasource.Store;
+export declare namespace DatasourceStore {
+    type Type = typeof DatasourceStore;
+}
 //# sourceMappingURL=DatasourceStore.d.ts.map

package/dist/esm/storage/server/DatasourceStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatasourceStore.d.ts","sourceRoot":"","sources":["../../../../src/storage/server/DatasourceStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAEnE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAO/D;;;;GAIG;AACH,wBAAgB,eAAe,CAC3B,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,GAAG,CAAC,MAAM,GAAG,SAAS,GACtC,UAAU,CAAC,KAAK,CAsBlB;AA0CD,yBAAiB,eAAe,CAAC;IAC7B,KAAY,IAAI,GAAG,OAAO,eAAe,CAAC;CAC7C"}

package/dist/esm/{endpoint/storage → storage/server}/DatasourceStore.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../../../src/endpoint/storage/DatasourceStore.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAoBO,SAAS,gBACZ,eACA,YACA,eACgB;AAChB,SAAO;AAAA,IACH;AAAA,IAEA,MAAM,IAAI,aAA0B,QAAoB;AACpD,UAAI,eAAe,aAAa;AAC5B;AAAA,MACJ;AACA,YAAM,cAAc,eAAe,aAAa,aAAa;AAC7D,UAAI,CAAC,YAAY,WAAW;AACxB,oBAAY,YAAY,CAAC;AAAA,MAC7B;AACA,YAAM,oBAAoB,YAAY,UAAU,UAAU;AAC1D,UAAI,mBAAmB;AACnB,mBAAW,OAAO,QAAQ;AACtB,4BAAkB,GAAG,IAAI,OAAO,GAAG;AAAA,QACvC;AAAA,MACJ,OAAO;AACH,oBAAY,UAAU,UAAU,IAAI,EAAE,GAAG,OAAO;AAAA,MACpD;AAAA,IACJ;AAAA,EACJ;AACJ;AAMA,SAAS,eAAe,aAA0B,eAA8B;AAC5E,MAAI,cAAc,YAAY,eAAe,aAAa;AAC1D,MAAI,aAAa;AACb,WAAO;AAAA,EACX;AAEA,gBAAc;AAAA,IACV,MAAM;AAAA,IAEN,WAAW;AAAA,IAEX,WAAW;AACP,aAAO,cAAc,SAAS;AAAA,IAClC;AAAA,IAEA,UAAwB;AAAA,IAGxB;AAAA,IAEA,MAAM,UAAU;AACZ,UAAI,KAAK,WAAW;AAChB,cAAM,cAAc,IAAI,KAAK,SAAS;AAAA,MAC1C;AAAA,IACJ;AAAA,IAEA,WAAyB;AACrB,aAAO,KAAK;AAAA,IAChB;AAAA,EACJ;AAEA,cAAY,gBAAgB,WAAW;AAEvC,SAAO;AACX;",
+  "sources": ["../../../../src/storage/server/DatasourceStore.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAqBO,SAAS,gBACZ,eACA,YACA,eACgB;AAChB,SAAO;AAAA,IACH;AAAA,IAEA,MAAM,IAAI,aAA0B,QAAoB;AACpD,UAAI,eAAe,aAAa;AAC5B;AAAA,MACJ;AACA,YAAM,cAAc,eAAe,aAAa,aAAa;AAC7D,UAAI,CAAC,YAAY,WAAW;AACxB,oBAAY,YAAY,CAAC;AAAA,MAC7B;AACA,YAAM,oBAAoB,YAAY,UAAU,UAAU;AAC1D,UAAI,mBAAmB;AACnB,mBAAW,OAAO,QAAQ;AACtB,4BAAkB,GAAG,IAAI,OAAO,GAAG;AAAA,QACvC;AAAA,MACJ,OAAO;AACH,oBAAY,UAAU,UAAU,IAAI,EAAE,GAAG,OAAO;AAAA,MACpD;AAAA,IACJ;AAAA,EACJ;AACJ;AAMA,SAAS,eAAe,aAA0B,eAA8B;AAC5E,MAAI,cAAc,YAAY,eAAe,aAAa;AAC1D,MAAI,aAAa;AACb,WAAO;AAAA,EACX;AAEA,gBAAc;AAAA,IACV,MAAM;AAAA,IAEN,WAAW;AAAA,IAEX,WAAW;AACP,aAAO,cAAc,SAAS;AAAA,IAClC;AAAA,IAEA,UAAwB;AAAA,IAGxB;AAAA,IAEA,MAAM,UAAU;AACZ,UAAI,KAAK,WAAW;AAChB,cAAM,cAAc,IAAI,KAAK,SAAS;AAAA,MAC1C;AAAA,IACJ;AAAA,IAEA,WAAyB;AACrB,aAAO,KAAK;AAAA,IAChB;AAAA,EACJ;AAEA,cAAY,gBAAgB,WAAW;AAEvC,SAAO;AACX;",
   "names": []
 }

package/dist/esm/storage/server/ServerEndpointStore.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Endpoint } from "#endpoint/Endpoint.js";
+import { StorageContext } from "#general";
+import { EndpointStore } from "#storage/EndpointStore.js";
+/**
+ * Persistence backing for an {@link Endpoint}.
+ *
+ * This is the API {@link Endpoint} uses for reading and writing non-volatile values.
+ */
+export declare class ServerEndpointStore extends EndpointStore {
+    #private;
+    get number(): number | undefined;
+    set number(number: number | undefined);
+    constructor(storage: StorageContext);
+    /**
+     * Invoke a function on this store and the stores of descendant parts.
+     */
+    visit(fn: (store: ServerEndpointStore) => void): void;
+    childStoreFor(endpoint: Endpoint): ServerEndpointStore;
+    protected storeForPartId(partId: string): ServerEndpointStore;
+    saveNumber(): Promise<void>;
+    load(): Promise<void>;
+    /**
+     * Erase the child storage for one part
+     */
+    eraseChildStoreFor(endpoint: Endpoint): Promise<void>;
+}
+//# sourceMappingURL=ServerEndpointStore.d.ts.map

package/dist/esm/storage/server/ServerEndpointStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerEndpointStore.d.ts","sourceRoot":"","sources":["../../../../src/storage/server/ServerEndpointStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAuB,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI1D;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;;IAMlD,IAAI,MAAM,IAIS,MAAM,GAAG,SAAS,CAFpC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAIpC;gBAEW,OAAO,EAAE,cAAc;IAMnC;;OAEG;IACH,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI;IAO9C,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,mBAAmB;IAOtD,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM;IASjC,UAAU;IAID,IAAI;IAWnB;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,QAAQ;CAmB9C"}