Method name

lib/TransactionKit.ts:962–997

* Names the current transaction or selects an existing named transaction. * * If a transaction with the given name already exists, it becomes the selected transaction and its details are loaded into the working context. If not, the current working transaction is assigned the provided name and

({ transactionName }: NameParams)

   * - If a new name is provided, the current working transaction is saved under that name.
   */
  name({ transactionName }: NameParams): INamedTransaction {
    if (typeof transactionName !== 'string' || transactionName.trim() === '') {
      this.throwError(
        'name(): transactionName is required and must be a non-empty string.'
      );
    }

    // Check if transaction exists
    if (this.namedTransactions[transactionName]) {
      // Selecting existing transaction
      this.selectedTransactionName = transactionName;
      this.workingTransaction = { ...this.namedTransactions[transactionName] };
      log(
        `name(): Selected existing transaction: ${transactionName}`,
        undefined,
        this.debugMode
      );
    } else {
      // Creating new transaction
      if (!this.workingTransaction) {
        this.throwError(
          'name(): No transaction data to name. Call transaction() first.'
        );
      }
      this.selectedTransactionName = transactionName;
      this.workingTransaction.transactionName = transactionName;
      this.namedTransactions[transactionName] = { ...this.workingTransaction };
      log(
        `name(): Named new transaction: ${transactionName}`,
        undefined,
        this.debugMode
      );
    }

    return this as INamedTransaction;
  }

  /**
   * Selects a batch by name for subsequent batch operations.