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

package/dist/cjs/behavior/state/managed/values/ValuePatcher.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/behavior/state/managed/values/ValuePatcher.ts"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/behavior/state/transaction/Errors.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "#general";
+/**
+ * Thrown when a {@link Transaction} operation cannot complete because the transaction has the wrong status.
+ */
+export declare class TransactionFlowError extends MatterError {
+}
+/**
+ * Thrown if a {@link Transaction} attempts to lock a {@link Resource} synchronously but the resource is already locked.
+ *
+ * If you see this error you are probably modifying {@link Behavior} state.  You can use
+ * {@link Transaction.addResources} and {@link Transaction.begin} to lock the behavior before performing your write.
+ */
+export declare class SynchronousTransactionConflictError extends MatterError {
+}
+/**
+ * Thrown if a transaction attempts to obtain exclusivity in a manner that would lead to deadlock.
+ */
+export declare class TransactionDeadlockError extends MatterError {
+}
+/**
+ * Thrown if an error occurs during commit or rollback.
+ */
+export declare class FinalizationError extends MatterError {
+}
+/**
+ * Thrown if a {@link Transaction} is accessed after it has been destroyed.
+ *
+ * If you see this error, you have probably kept a reference to a contextual object such as a {@link Behavior} after its
+ * {@link ActionContext} exited.  You may need to create a new context using {@link OfflineContext.act}.
+ *
+ * A possible cause of this error is forgetting to use await on an async function.  The context will remain open so long
+ * as there is an unresolved {@link Promise} it can await.
+ */
+export declare class TransactionDestroyedError extends MatterError {
+}
+//# sourceMappingURL=Errors.d.ts.map

package/dist/cjs/behavior/state/transaction/Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/transaction/Errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAMvC;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;CAAG;AAExD;;;;;GAKG;AACH,qBAAa,mCAAoC,SAAQ,WAAW;CAAG;AAEvE;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,WAAW;CAAG;AAE5D;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;CAAG;AAErD;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,SAAQ,WAAW;CAAG"}

package/dist/cjs/behavior/state/transaction/Errors.js

@@ -0,0 +1,44 @@
+"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 Errors_exports = {};
+__export(Errors_exports, {
+  FinalizationError: () => FinalizationError,
+  SynchronousTransactionConflictError: () => SynchronousTransactionConflictError,
+  TransactionDeadlockError: () => TransactionDeadlockError,
+  TransactionDestroyedError: () => TransactionDestroyedError,
+  TransactionFlowError: () => TransactionFlowError
+});
+module.exports = __toCommonJS(Errors_exports);
+var import_general = require("#general");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class TransactionFlowError extends import_general.MatterError {
+}
+class SynchronousTransactionConflictError extends import_general.MatterError {
+}
+class TransactionDeadlockError extends import_general.MatterError {
+}
+class FinalizationError extends import_general.MatterError {
+}
+class TransactionDestroyedError extends import_general.MatterError {
+}
+//# sourceMappingURL=Errors.js.map

package/dist/cjs/behavior/state/transaction/Errors.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/state/transaction/Errors.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAA4B;AAN5B;AAAA;AAAA;AAAA;AAAA;AAeO,MAAM,6BAA6B,2BAAY;AAAC;AAQhD,MAAM,4CAA4C,2BAAY;AAAC;AAK/D,MAAM,iCAAiC,2BAAY;AAAC;AAKpD,MAAM,0BAA0B,2BAAY;AAAC;AAW7C,MAAM,kCAAkC,2BAAY;AAAC;",
+  "names": []
+}

package/dist/cjs/behavior/state/transaction/Participant.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MaybePromise } from "#general";
+/**
+ * Components with support for transactionality implement this interface.
+ */
+export interface Participant {
+    /**
+     * Description used in error messages.
+     */
+    toString(): string;
+    /**
+     * The "role" of a participant is an optional key you may use to retrieve
+     * a participant from the transaction.
+     */
+    role?: {};
+    /**
+     * Pre-commit logic.
+     *
+     * Pre-commit logic returns a boolean indicating whether it performed an action that affects state.  The transaction
+     * will cycle through participants continuously until all participants return false.
+     *
+     * Thus `preCommit` implementations must be stateful and expect to be invoked more than once for a single
+     * transaction.
+     */
+    preCommit?: () => MaybePromise<boolean>;
+    /**
+     * Commit phase one.
+     */
+    commit1(): MaybePromise;
+    /**
+     * Commit phase two.
+     */
+    commit2(): MaybePromise;
+    /**
+     * Post-commit logic.
+     */
+    postCommit?: () => MaybePromise;
+    /**
+     * Drop isolated writes and revert to original canonical source.
+     */
+    rollback(): MaybePromise;
+}
+//# sourceMappingURL=Participant.d.ts.map

package/dist/cjs/behavior/state/transaction/Participant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Participant.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/transaction/Participant.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,CAAC;IAEV;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAExC;;OAEG;IACH,OAAO,IAAI,YAAY,CAAC;IAExB;;OAEG;IACH,OAAO,IAAI,YAAY,CAAC;IAExB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,YAAY,CAAC;IAEhC;;OAEG;IACH,QAAQ,IAAI,YAAY,CAAC;CAC5B"}

package/dist/cjs/behavior/state/transaction/Participant.js

@@ -0,0 +1,22 @@
+"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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Participant_exports = {};
+module.exports = __toCommonJS(Participant_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=Participant.js.map

package/dist/cjs/behavior/state/transaction/Participant.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/state/transaction/Participant.ts"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/behavior/state/transaction/Resource.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Transaction } from "./Transaction.js";
+/**
+ * A transaction resource is the target a {@link Participant} is mutating. The {@link Coordinator} tracks the state of
+ * resources to ensure only a single transaction ever has exclusive access.
+ */
+export interface Resource {
+    /**
+     * Textual description of the resource used in error messages.
+     */
+    toString(): string;
+    /**
+     * Locking transaction, maintained by {@link Transaction}.
+     */
+    lockedBy?: Transaction;
+    /**
+     * Inform {@link Transaction} this resource is a standin for another resource.
+     */
+    [Resource.reference]?: Resource;
+}
+export declare namespace Resource {
+    const reference: unique symbol;
+}
+//# sourceMappingURL=Resource.d.ts.map

package/dist/cjs/behavior/state/transaction/Resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/transaction/Resource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEvB;;OAEG;IACH,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC;CACnC;AAED,yBAAiB,QAAQ,CAAC;IACf,MAAM,SAAS,eAAsB,CAAC;CAChD"}

package/dist/cjs/behavior/state/transaction/Resource.js

@@ -0,0 +1,33 @@
+"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 Resource_exports = {};
+__export(Resource_exports, {
+  Resource: () => Resource
+});
+module.exports = __toCommonJS(Resource_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Resource;
+((Resource2) => {
+  Resource2.reference = Symbol("reference");
+})(Resource || (Resource = {}));
+//# sourceMappingURL=Resource.js.map

package/dist/cjs/behavior/state/transaction/Resource.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/state/transaction/Resource.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA6BO,IAAU;AAAA,CAAV,CAAUA,cAAV;AACI,EAAMA,UAAA,YAAY,OAAO,WAAW;AAAA,GAD9B;",
+  "names": ["Resource"]
+}

package/dist/cjs/behavior/state/transaction/ResourceSet.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Resource } from "./Resource.js";
+import type { Transaction } from "./Transaction.js";
+/**
+ * An internal set of resources supporting bulk operations for {@link Transaction}.
+ */
+export declare class ResourceSet {
+    #private;
+    constructor(transaction: Transaction, resources?: Iterable<Resource>);
+    /**
+     * Wait until the resources have no exclusive transactions and then lock.
+     */
+    acquireLocks(): Promise<Set<Resource>>;
+    /**
+     * Acquire locks synchronously.
+     *
+     * Throws an error if resources aren't lockable.
+     */
+    acquireLocksSync(): Set<Resource>;
+    /**
+     * Release locks.
+     */
+    releaseLocks(): Set<Resource>;
+    /**
+     * Ensure that a transaction that is committing or rolling back has all resources locked.
+     *
+     * This is just a sanity check.
+     */
+    assertResourcesAreLocked(transaction: Transaction, why: string): void;
+    [Symbol.iterator](): SetIterator<Resource>;
+}
+//# sourceMappingURL=ResourceSet.d.ts.map

package/dist/cjs/behavior/state/transaction/ResourceSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceSet.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/transaction/ResourceSet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD;;GAEG;AACH,qBAAa,WAAW;;gBAIR,WAAW,EAAE,WAAW,EAAE,SAAS,GAAE,QAAQ,CAAC,QAAQ,CAAyB;IAU3F;;OAEG;IACG,YAAY;IA0BlB;;;;OAIG;IACH,gBAAgB;IA2BhB;;OAEG;IACH,YAAY;IAaZ;;;;OAIG;IACH,wBAAwB,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM;IA2C9D,CAAC,MAAM,CAAC,QAAQ,CAAC;CAGpB"}

package/dist/cjs/behavior/state/transaction/ResourceSet.js

@@ -0,0 +1,154 @@
+"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 ResourceSet_exports = {};
+__export(ResourceSet_exports, {
+  ResourceSet: () => ResourceSet
+});
+module.exports = __toCommonJS(ResourceSet_exports);
+var import_general = require("#general");
+var import_Errors = require("./Errors.js");
+var import_Resource = require("./Resource.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("ResourceSet");
+class ResourceSet {
+  #transaction;
+  #resources = /* @__PURE__ */ new Set();
+  constructor(transaction, resources = transaction.resources) {
+    this.#transaction = transaction;
+    for (let resource of resources) {
+      while (resource[import_Resource.Resource.reference]) {
+        resource = resource[import_Resource.Resource.reference];
+      }
+      this.#resources.add(resource);
+    }
+  }
+  /**
+   * Wait until the resources have no exclusive transactions and then lock.
+   */
+  async acquireLocks() {
+    while (true) {
+      let blockedBy;
+      for (const resource of this.#resources) {
+        const lockedBy = resource.lockedBy;
+        if (lockedBy && lockedBy !== this.#transaction) {
+          if (!blockedBy) {
+            blockedBy = /* @__PURE__ */ new Set();
+          }
+          blockedBy.add(lockedBy);
+        }
+      }
+      if (!blockedBy) {
+        break;
+      }
+      this.#detectDeadlock(blockedBy);
+      await this.#transaction.waitFor(blockedBy);
+    }
+    return this.acquireLocksSync();
+  }
+  /**
+   * Acquire locks synchronously.
+   *
+   * Throws an error if resources aren't lockable.
+   */
+  acquireLocksSync() {
+    const toLock = /* @__PURE__ */ new Set();
+    const blocked = /* @__PURE__ */ new Set();
+    for (const resource of this.#resources) {
+      if (resource.lockedBy) {
+        if (resource.lockedBy === this.#transaction) {
+          continue;
+        }
+        logger.warn("Transaction", this.#transaction.via, "blocked by", resource.lockedBy.via);
+        blocked.add(resource);
+      }
+      toLock.add(resource);
+    }
+    if (blocked.size) {
+      logger.warn("You may need to await transaction.begin() to acquire locks asynchronously");
+      const names = [...blocked].map((s) => s.toString());
+      throw new import_Errors.SynchronousTransactionConflictError(`Cannot lock ${(0, import_general.describeList)("and", ...names)} synchronously`);
+    }
+    for (const resource of toLock) {
+      resource.lockedBy = this.#transaction;
+    }
+    return toLock;
+  }
+  /**
+   * Release locks.
+   */
+  releaseLocks() {
+    const unlocked = /* @__PURE__ */ new Set();
+    for (const resource of this.#resources) {
+      if (resource.lockedBy === this.#transaction) {
+        delete resource.lockedBy;
+        unlocked.add(resource);
+      }
+    }
+    return unlocked;
+  }
+  /**
+   * Ensure that a transaction that is committing or rolling back has all resources locked.
+   *
+   * This is just a sanity check.
+   */
+  assertResourcesAreLocked(transaction, why) {
+    for (const resource of transaction.resources) {
+      if (resource.lockedBy !== transaction) {
+        throw new import_Errors.TransactionFlowError(`Transaction attempted ${why} but does not have all resources locked`);
+      }
+    }
+  }
+  /**
+   * If two transactions would block each other then we would have a deadlock.
+   *
+   * This is unlikely but not impossible.  It can happen if an endpoint is added to an exclusive transaction but a
+   * second transaction already has exclusivity on the new endpoint *and* is waiting on the first transaction.
+   *
+   * So... detect if the wait graph would have cycles if we an endpoint.  If so, throw an error.
+   */
+  #detectDeadlock(blockedBy) {
+    const examined = /* @__PURE__ */ new Set();
+    const examineBlocker = (transaction) => {
+      examined.add(transaction);
+      if (transaction === this.#transaction) {
+        throw new import_Errors.TransactionDeadlockError(
+          "Resource deadlock detected, write operation cannot proceed.  To prevent this you can await transaction.begin() before modifying state"
+        );
+      }
+      if (transaction.waitingOn) {
+        for (const blocker of transaction.waitingOn) {
+          if (!examined.has(blocker)) {
+            examineBlocker(blocker);
+          }
+        }
+      }
+    };
+    for (const transaction of blockedBy) {
+      examineBlocker(transaction);
+    }
+  }
+  [Symbol.iterator]() {
+    return this.#resources[Symbol.iterator]();
+  }
+}
+//# sourceMappingURL=ResourceSet.js.map

package/dist/cjs/behavior/state/transaction/ResourceSet.js.map

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

package/dist/cjs/behavior/state/transaction/Status.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Transaction } from "./Transaction.js";
+/**
+ * The lifecycle of a transaction adheres to the following discrete stages.
+ */
+export declare enum Status {
+    /**
+     * Transaction may be used only for read operations.
+     */
+    ReadOnly = "read only",
+    /**
+     * Transaction is registered but there are no ACID guarantees.
+     */
+    Shared = "shared",
+    /**
+     * Transaction is waiting to obtain exclusive access to resources.
+     */
+    Waiting = "waiting",
+    /**
+     * Transaction has exclusive access.  Reads will maintain consistency
+     * and writes are allowed.
+     */
+    Exclusive = "exclusive",
+    /**
+     * Transaction is in the process of committing, phase one.
+     */
+    CommittingPhaseOne = "committing phase one",
+    /**
+     * Transaction is in the process of committing, phase two.
+     */
+    CommittingPhaseTwo = "committing phase two",
+    /**
+     * Transaction is in the process of rolling back.
+     */
+    RollingBack = "rolling back",
+    /**
+     * Transaction is destroyed, no further operations permitted.
+     */
+    Destroyed = "destroyed"
+}
+export declare namespace Status {
+    function assert(transaction: Transaction, acceptable: Status[], target: Status): void;
+    function formatStatus(status: Status): string;
+}
+//# sourceMappingURL=Status.d.ts.map

package/dist/cjs/behavior/state/transaction/Status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Status.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/transaction/Status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,oBAAY,MAAM;IACd;;OAEG;IACH,QAAQ,cAAc;IAEtB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,OAAO,YAAY;IAEnB;;;OAGG;IACH,SAAS,cAAc;IAEvB;;OAEG;IACH,kBAAkB,yBAAyB;IAE3C;;OAEG;IACH,kBAAkB,yBAAyB;IAE3C;;OAEG;IACH,WAAW,iBAAiB;IAE5B;;OAEG;IACH,SAAS,cAAc;CAC1B;AAED,yBAAiB,MAAM,CAAC;IACpB,SAAgB,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,QAMpF;IAED,SAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,UAE1C;CACJ"}

package/dist/cjs/behavior/state/transaction/Status.js

@@ -0,0 +1,55 @@
+"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 Status_exports = {};
+__export(Status_exports, {
+  Status: () => Status
+});
+module.exports = __toCommonJS(Status_exports);
+var import_Errors = require("./Errors.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Status = /* @__PURE__ */ ((Status2) => {
+  Status2["ReadOnly"] = "read only";
+  Status2["Shared"] = "shared";
+  Status2["Waiting"] = "waiting";
+  Status2["Exclusive"] = "exclusive";
+  Status2["CommittingPhaseOne"] = "committing phase one";
+  Status2["CommittingPhaseTwo"] = "committing phase two";
+  Status2["RollingBack"] = "rolling back";
+  Status2["Destroyed"] = "destroyed";
+  return Status2;
+})(Status || {});
+((Status2) => {
+  function assert(transaction, acceptable, target) {
+    if (!acceptable.includes(transaction.status)) {
+      throw new import_Errors.TransactionFlowError(
+        `Cannot transition transaction from ${formatStatus(transaction.status)} to ${formatStatus(target)}`
+      );
+    }
+  }
+  Status2.assert = assert;
+  function formatStatus(status) {
+    return `<${status}>`;
+  }
+  Status2.formatStatus = formatStatus;
+})(Status || (Status = {}));
+//# sourceMappingURL=Status.js.map

package/dist/cjs/behavior/state/transaction/Status.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/state/transaction/Status.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,oBAAqC;AANrC;AAAA;AAAA;AAAA;AAAA;AAYO,IAAK,SAAL,kBAAKA,YAAL;AAIH,EAAAA,QAAA,cAAW;AAKX,EAAAA,QAAA,YAAS;AAKT,EAAAA,QAAA,aAAU;AAMV,EAAAA,QAAA,eAAY;AAKZ,EAAAA,QAAA,wBAAqB;AAKrB,EAAAA,QAAA,wBAAqB;AAKrB,EAAAA,QAAA,iBAAc;AAKd,EAAAA,QAAA,eAAY;AAxCJ,SAAAA;AAAA,GAAA;AAAA,CA2CL,CAAUA,YAAV;AACI,WAAS,OAAO,aAA0B,YAAsB,QAAgB;AACnF,QAAI,CAAC,WAAW,SAAS,YAAY,MAAM,GAAG;AAC1C,YAAM,IAAI;AAAA,QACN,sCAAsC,aAAa,YAAY,MAAM,CAAC,OAAO,aAAa,MAAM,CAAC;AAAA,MACrG;AAAA,IACJ;AAAA,EACJ;AANO,EAAAA,QAAS;AAQT,WAAS,aAAa,QAAgB;AACzC,WAAO,IAAI,MAAM;AAAA,EACrB;AAFO,EAAAA,QAAS;AAAA,GATH;",
+  "names": ["Status"]
+}