@matter/general 0.12.4-alpha.0-20250211-56b2c53a0 → 0.12.4-alpha.0-20250213-1187f81eb

package/dist/esm/transaction/Tx.js

@@ -0,0 +1,566 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Diagnostic } from "#log/Diagnostic.js";
+import { Logger } from "#log/Logger.js";
+import { ImplementationError, ReadOnlyError } from "#MatterError.js";
+import { Observable } from "#util/Observable.js";
+import { MaybePromise } from "#util/Promises.js";
+import { describeList } from "#util/String.js";
+import { FinalizationError, TransactionDestroyedError, TransactionFlowError, UnsettledStateError } from "./errors.js";
+import { ResourceSet } from "./ResourceSet.js";
+import { Status } from "./Status.js";
+import { Transaction } from "./Transaction.js";
+const logger = Logger.get("Transaction");
+const MAX_PRECOMMIT_CYCLES = 5;
+const MAX_CHAINED_COMMITS = 5;
+function act(via, actor) {
+  const tx = new Tx(via);
+  let commits = 0;
+  function commitTransaction(finalResult) {
+    commits++;
+    if (commits > MAX_CHAINED_COMMITS) {
+      throw new TransactionFlowError(
+        `Transaction commits have cascaded ${MAX_CHAINED_COMMITS} times which likely indicates an infinite loop`
+      );
+    }
+    const result = tx.commit();
+    if (MaybePromise.is(result)) {
+      return result.then(() => {
+        if (tx.status === Transaction.Status.Exclusive) {
+          return commitTransaction(finalResult);
+        }
+        return finalResult;
+      });
+    } else if (tx.status === Transaction.Status.Exclusive) {
+      return commitTransaction(finalResult);
+    }
+    return finalResult;
+  }
+  const handleTransactionError = (error) => {
+    if (commits) {
+      throw error;
+    }
+    logger.error("Rolling back", tx.via, "due to error:", Diagnostic.weak(error?.message || `${error}`));
+    try {
+      const result = tx.rollback();
+      if (MaybePromise.is(result)) {
+        return Promise.resolve(result).catch((error2) => {
+          if (error2 !== error) {
+            logger.error("Secondary error in", tx.via, "rollback:", error2);
+          }
+          throw error;
+        });
+      }
+    } catch (error2) {
+      if (error2 !== error) {
+        logger.error("Secondary error in", tx.via, "rollback:", error2);
+      }
+    }
+    throw error;
+  };
+  const closeTransaction = tx.close.bind(tx);
+  let isAsync = false;
+  try {
+    const actorResult = actor(tx);
+    if (MaybePromise.is(actorResult)) {
+      isAsync = tx.isAsync = true;
+      return Promise.resolve(actorResult).then(commitTransaction, handleTransactionError).finally(closeTransaction);
+    }
+    const commitResult = commitTransaction(actorResult);
+    if (MaybePromise.is(commitResult)) {
+      isAsync = true;
+      return Promise.resolve(commitResult).catch(handleTransactionError).finally(closeTransaction);
+    }
+    return commitResult;
+  } catch (e) {
+    const result = handleTransactionError(e);
+    isAsync = true;
+    return Promise.resolve(result).finally(closeTransaction);
+  } finally {
+    if (!isAsync) {
+      tx.close();
+    }
+  }
+}
+class Tx {
+  #participants = /* @__PURE__ */ new Set();
+  #roles = /* @__PURE__ */ new Map();
+  #resources = /* @__PURE__ */ new Set();
+  #status;
+  #waitingOn;
+  #via;
+  #shared;
+  #closed;
+  #isAsync = false;
+  constructor(via, readonly = false) {
+    this.#via = Diagnostic.via(via);
+    if (readonly) {
+      this.#status = Status.ReadOnly;
+    } else {
+      this.#status = Status.Shared;
+    }
+  }
+  close() {
+    this.#status = Status.Destroyed;
+    this.#resources.clear();
+    this.#roles.clear();
+    this.#participants.clear();
+    this.#closed?.emit();
+  }
+  get via() {
+    return this.#via;
+  }
+  get status() {
+    return this.#status;
+  }
+  get participants() {
+    return this.#participants;
+  }
+  get resources() {
+    return this.#resources;
+  }
+  get waitingOn() {
+    return this.#waitingOn;
+  }
+  get isAsync() {
+    return this.#isAsync;
+  }
+  set isAsync(isAsync) {
+    if (!this.#isAsync) {
+      this.#locksChanged(this.#resources);
+    }
+    this.#isAsync = isAsync;
+  }
+  onShared(listener, once) {
+    if (this.status === Status.ReadOnly) {
+      return;
+    }
+    if (this.#shared === void 0) {
+      this.#shared = Observable();
+    }
+    this.#shared[once ? "once" : "on"](listener);
+  }
+  onClose(listener) {
+    if (this.status === Status.ReadOnly) {
+      return;
+    }
+    if (this.status === Status.Destroyed) {
+      listener();
+    }
+    if (this.#closed === void 0) {
+      this.#closed = Observable();
+    }
+    this.#closed.once(listener);
+  }
+  async addResources(...resources) {
+    this.#assertAvailable();
+    if (this.#status === Status.Exclusive) {
+      const set = new ResourceSet(this, resources);
+      const locked = await set.acquireLocks();
+      this.#locksChanged(locked);
+    }
+    this.addResourcesSync(...resources);
+  }
+  addResourcesSync(...resources) {
+    this.#assertAvailable();
+    if (this.#status === Status.Exclusive) {
+      const set = new ResourceSet(this, resources);
+      const locked = set.acquireLocksSync();
+      this.#locksChanged(locked);
+    } else if (this.#status !== Status.Shared) {
+      throw new TransactionFlowError(`Cannot add resources to transaction that is ${this.status}`);
+    }
+    for (const resource of resources) {
+      this.#resources.add(resource);
+    }
+  }
+  async begin() {
+    this.#assertAvailable();
+    if (this.status === Status.Exclusive) {
+      return;
+    }
+    if (this.status !== Status.Shared) {
+      throw new TransactionFlowError(`Cannot begin write transaction because transaction is ${this.#status}`);
+    }
+    this.#status = Status.Waiting;
+    try {
+      const resources = new ResourceSet(this, this.#resources);
+      const locked = await resources.acquireLocks();
+      this.#locksChanged(locked);
+      this.#status = Status.Exclusive;
+    } catch (e) {
+      this.#status = Status.Shared;
+      throw e;
+    }
+  }
+  beginSync() {
+    this.#assertAvailable();
+    if (this.status === Status.Exclusive) {
+      return;
+    }
+    if (this.status !== Status.Shared) {
+      throw new TransactionFlowError(`Cannot begin write transaction because transaction is ${this.#status}`);
+    }
+    this.#status = Status.Exclusive;
+    try {
+      const resources = new ResourceSet(this, this.#resources);
+      const locked = resources.acquireLocksSync();
+      this.#locksChanged(locked);
+    } catch (e) {
+      this.#status = Status.Shared;
+      throw e;
+    }
+  }
+  addParticipants(...participants) {
+    this.#assertAvailable();
+    for (const participant of participants) {
+      if (this.#participants.has(participant)) {
+        continue;
+      }
+      if ([...this.#participants].findIndex((p) => p.toString() === participant.toString()) !== -1) {
+        throw new ImplementationError(`Participant ${participant} identity is not unique`);
+      }
+      this.#participants.add(participant);
+      if (participant.role !== void 0) {
+        if (this.#roles.has(participant.role)) {
+          throw new TransactionFlowError(`A participant is already registered for role ${participant.role}`);
+        }
+        this.#roles.set(participant.role, participant);
+      }
+    }
+  }
+  getParticipant(role) {
+    this.#assertAvailable();
+    return this.#roles.get(role);
+  }
+  commit() {
+    this.#assertAvailable();
+    if (this.#status === Status.Shared) {
+      return this.rollback();
+    }
+    const performCommit = () => {
+      const participants = [...this.#participants];
+      const result2 = this.#finalize(Status.CommittingPhaseOne, "committed", this.#executeCommit.bind(this));
+      if (MaybePromise.is(result2)) {
+        return result2.then(() => this.#executePostCommit(participants));
+      }
+      return this.#executePostCommit(participants);
+    };
+    const result = this.#executePreCommit();
+    if (MaybePromise.is(result)) {
+      return result.then(performCommit);
+    }
+    return performCommit();
+  }
+  rollback() {
+    this.#assertAvailable();
+    return this.#finalize(Status.RollingBack, "rolled back", () => this.#executeRollback());
+  }
+  waitFor(others) {
+    this.#assertAvailable();
+    if (this.waitingOn) {
+      throw new TransactionFlowError("Attempted wait on a transaction that is already waiting");
+    }
+    logger.debug("Tx", this.via, "waiting on", describeList("and", ...[...others].map((other) => other.via)));
+    this.#waitingOn = others;
+    return new Promise((resolve) => {
+      for (const other of others) {
+        other.onShared(() => {
+          others.delete(other);
+          if (!others.size) {
+            this.#waitingOn = void 0;
+            resolve();
+          }
+        }, true);
+      }
+    }).finally(() => this.#waitingOn = void 0);
+  }
+  toString() {
+    return `transaction<${this.via}>`;
+  }
+  /**
+   * Shared implementation for commit and rollback.
+   */
+  #finalize(status, why, finalizer) {
+    if (this.status !== Status.Shared && this.status !== Status.Exclusive) {
+      throw new TransactionFlowError(
+        `Illegal attempt to enter status ${status} when transaction is ${this.#status}`
+      );
+    }
+    const cleanup = () => {
+      const set = new ResourceSet(this, this.#resources);
+      const unlocked = set.releaseLocks();
+      this.#locksChanged(unlocked, `${why} and unlocked`);
+      this.#participants.clear();
+      this.#status = Status.Shared;
+      this.#shared?.emit();
+    };
+    let isAsync = false;
+    try {
+      this.#status = status;
+      const result = finalizer();
+      if (MaybePromise.is(result)) {
+        isAsync = true;
+        return Promise.resolve(result).finally(cleanup);
+      }
+    } finally {
+      if (!isAsync) {
+        cleanup();
+      }
+    }
+  }
+  /**
+   * Iteratively execute pre-commit until all participants "settle" and report no possible mutation.
+   */
+  #executePreCommit() {
+    let mayHaveMutated = false;
+    let abortedDueToError = false;
+    let iterator = this.participants[Symbol.iterator]();
+    let cycles = 1;
+    const errorRollback = (error) => {
+      logger.error(
+        "Rolling back",
+        this.via,
+        "due to pre-commit error:",
+        Diagnostic.weak(error?.message || `${error}`)
+      );
+      const result = this.#finalize(Status.RollingBack, "rolled back", () => this.#executeRollback());
+      if (MaybePromise.is(result)) {
+        return result.then(() => {
+          throw error;
+        });
+      }
+      throw error;
+    };
+    const nextCycle = () => {
+      cycles++;
+      if (cycles > MAX_PRECOMMIT_CYCLES) {
+        return errorRollback(
+          new UnsettledStateError(
+            `State has not settled after ${MAX_PRECOMMIT_CYCLES} pre-commit cycles which likely indicates an infinite loop`
+          )
+        );
+      }
+      mayHaveMutated = false;
+      iterator = this.participants[Symbol.iterator]();
+    };
+    const nextPreCommit = (previousResult) => {
+      if (abortedDueToError) {
+        return;
+      }
+      if (previousResult) {
+        mayHaveMutated = true;
+      }
+      while (true) {
+        const n = iterator.next();
+        if (n.done) {
+          if (mayHaveMutated) {
+            const result = nextCycle();
+            if (MaybePromise.is(result)) {
+              return result;
+            }
+            continue;
+          }
+          break;
+        }
+        const participant = n.value;
+        const handleError = (error) => {
+          abortedDueToError = true;
+          return errorRollback(error);
+        };
+        try {
+          const result = participant.preCommit?.();
+          if (MaybePromise.is(result)) {
+            return Promise.resolve(result).catch(handleError).then(nextPreCommit);
+          }
+          if (result) {
+            mayHaveMutated = true;
+          }
+        } catch (e) {
+          return handleError(e);
+        }
+      }
+    };
+    return nextPreCommit();
+  }
+  /**
+   * Commit logic passed to #finalize.
+   */
+  #executeCommit() {
+    const result = this.#executeCommit1();
+    if (MaybePromise.is(result)) {
+      return Promise.resolve(result).then(this.#executeCommit2.bind(this));
+    }
+    return this.#executeCommit2();
+  }
+  #executeCommit1() {
+    let needRollback = false;
+    let asyncCommits;
+    for (const participant of this.participants) {
+      const handleParticipantError = (error) => {
+        logger.error(`Error committing ${participant} (phase one):`, error);
+        needRollback = true;
+      };
+      try {
+        const result = participant.commit1();
+        if (MaybePromise.is(result)) {
+          if (!asyncCommits) {
+            asyncCommits = [];
+          }
+          asyncCommits.push(Promise.resolve(result).catch(handleParticipantError));
+        }
+      } catch (e) {
+        handleParticipantError(e);
+        break;
+      }
+    }
+    const abortIfFailed = () => {
+      if (needRollback) {
+        const result = this.#executeRollback();
+        if (MaybePromise.is(result)) {
+          return result.then(() => {
+            throw new FinalizationError("Rolled back due to commit phase one error");
+          });
+        }
+        throw new FinalizationError("Rolled back due to commit phase one error");
+      }
+    };
+    if (asyncCommits) {
+      return Promise.allSettled(asyncCommits).then(abortIfFailed);
+    }
+    return abortIfFailed();
+  }
+  #executeCommit2() {
+    this.#status = Status.CommittingPhaseTwo;
+    let errored;
+    let ongoing;
+    for (const participant of this.participants) {
+      const promise = MaybePromise.then(
+        () => participant.commit2(),
+        void 0,
+        (error) => {
+          logger.error(`Error committing (phase two) ${participant}, state inconsistency possible:`, error);
+          if (errored) {
+            errored.push(participant);
+          } else {
+            errored = [participant];
+          }
+        }
+      );
+      if (MaybePromise.is(promise)) {
+        if (ongoing) {
+          ongoing.push(promise);
+        } else {
+          ongoing = [promise];
+        }
+      }
+    }
+    if (ongoing) {
+      return Promise.allSettled(ongoing).then(() => throwIfErrored(errored, "in commit phase 2"));
+    } else {
+      throwIfErrored(errored, "in commit phase 2");
+    }
+  }
+  #executePostCommit(participants) {
+    const participantIterator = participants[Symbol.iterator]();
+    const postCommitNextParticipant = () => {
+      const next = participantIterator.next();
+      if (next.done) {
+        return;
+      }
+      const participant = next.value;
+      return MaybePromise.then(
+        () => participant.postCommit?.(),
+        () => postCommitNextParticipant(),
+        (error) => {
+          logger.error(`Error post-commit of ${participant}:`, error);
+        }
+      );
+    };
+    return postCommitNextParticipant();
+  }
+  /**
+   * Rollback logic passed to #finish.
+   */
+  #executeRollback() {
+    this.#status = Status.RollingBack;
+    let errored;
+    let ongoing;
+    for (const participant of this.participants) {
+      const promise = MaybePromise.then(
+        () => participant.rollback(),
+        void 0,
+        (error) => {
+          logger.error(`Error rolling back ${participant}, state inconsistency possible:`, error);
+          if (errored) {
+            errored.push(participant);
+          } else {
+            errored = [participant];
+          }
+        }
+      );
+      if (MaybePromise.is(promise)) {
+        if (ongoing) {
+          ongoing.push(promise);
+        } else {
+          ongoing = [promise];
+        }
+      }
+    }
+    const finished = () => {
+      this.#status = Status.Shared;
+      throwIfErrored(errored, "in commit phase 2");
+    };
+    if (ongoing) {
+      return Promise.allSettled(ongoing).then(finished);
+    } else {
+      finished();
+    }
+  }
+  #locksChanged(resources, how = "locked") {
+    if (!resources.size || !this.isAsync) {
+      return;
+    }
+    let resourceDescription;
+    if (how === "locked") {
+      resourceDescription = Diagnostic.strong(describeList("and", ...[...resources].map((r) => r.toString())));
+    } else {
+      resourceDescription = `${resources.size} resource${resources.size === 1 ? "" : "s"}`;
+    }
+    logger.debug(this.via, how, resourceDescription);
+  }
+  #assertAvailable() {
+    if (this.#status === Status.Destroyed) {
+      logger.warn(
+        "You have accessed transaction",
+        this.via,
+        "outside of the context in which it was active.  Open a new context or ensure your operation completes before the context exits"
+      );
+      throw new TransactionDestroyedError(`Transaction ${this.#via} is destroyed`);
+    }
+    if (this.#status === Status.ReadOnly) {
+      throw new ReadOnlyError();
+    }
+  }
+}
+const ReadOnlyTransaction = new Tx("readonly", true);
+function throwIfErrored(errored, when) {
+  if (!errored?.length) {
+    return;
+  }
+  const suffix = errored.length > 1 ? "s" : "";
+  throw new FinalizationError(
+    `Unhandled error${suffix} ${when} participant${suffix} ${describeList(
+      "and",
+      ...errored.map((p) => p.toString())
+    )}`
+  );
+}
+export {
+  ReadOnlyTransaction,
+  act
+};
+//# sourceMappingURL=Tx.js.map

package/dist/esm/transaction/Tx.js.map

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

package/dist/esm/transaction/errors.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "#MatterError.js";
+/**
+ * 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 its exited.  You may need to create
+ * a new, independent transaction context.
+ *
+ * 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 {
+}
+/**
+ * Thrown if a {@link Transaction} cannot commit because state has mutated continuously for too many pre-commit cycles.
+ *
+ * "Pre-commit" is a commit event triggered by {@link Transaction} before stage 1 commit.  During pre-commit listeners
+ * may mutate state.  If state does change, the transaction re-runs pre-commit so all listeners see the same state.
+ *
+ * If state continues to mutate for too many of these cycles then the transaction will abort.  This likely indicates a
+ * logic error that will result in an infinite loop.
+ */
+export declare class UnsettledStateError extends FinalizationError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/transaction/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/transaction/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C;;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;AAE7D;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;CAAG"}

package/dist/esm/transaction/errors.js

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "#MatterError.js";
+class TransactionFlowError extends MatterError {
+}
+class SynchronousTransactionConflictError extends MatterError {
+}
+class TransactionDeadlockError extends MatterError {
+}
+class FinalizationError extends MatterError {
+}
+class TransactionDestroyedError extends MatterError {
+}
+class UnsettledStateError extends FinalizationError {
+}
+export {
+  FinalizationError,
+  SynchronousTransactionConflictError,
+  TransactionDeadlockError,
+  TransactionDestroyedError,
+  TransactionFlowError,
+  UnsettledStateError
+};
+//# sourceMappingURL=errors.js.map

package/dist/esm/transaction/errors.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/transaction/errors.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,mBAAmB;AAMrB,MAAM,6BAA6B,YAAY;AAAC;AAQhD,MAAM,4CAA4C,YAAY;AAAC;AAK/D,MAAM,iCAAiC,YAAY;AAAC;AAKpD,MAAM,0BAA0B,YAAY;AAAC;AAW7C,MAAM,kCAAkC,YAAY;AAAC;AAWrD,MAAM,4BAA4B,kBAAkB;AAAC;",
+  "names": []
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transaction/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}