Method addToBatch

lib/TransactionKit.ts:1055–1100

* Adds the current transaction to a specified batch, creating the batch if it does not exist. * * This method associates the current working transaction with a batch, identified by batchName. If the batch does not exist, it is created. Throws an error if there is no selected transaction, no wo

({ batchName }: AddToBatchParams)

   * - The batch is created if it does not already exist.
   */
  addToBatch({ batchName }: AddToBatchParams): IBatchedTransaction {
    if (!this.selectedTransactionName || !this.workingTransaction) {
      this.throwError(
        'addToBatch(): No named transaction to add to batch. Call name() first.'
      );
    }
    if (typeof batchName !== 'string' || batchName.trim() === '') {
      this.throwError(
        'addToBatch(): batchName is required and must be a non-empty string.'
      );
    }
    // If the batch does not exist, create it
    if (!this.batches[batchName]) {
      this.batches[batchName] = [];
      log(
        `addToBatch(): Created new batch: ${batchName}`,
        undefined,
        this.debugMode
      );
    }
    this.workingTransaction.batchName = batchName;
    const existingIndex = this.batches[batchName].findIndex(
      (tx) => tx.transactionName === this.selectedTransactionName
    );

    if (existingIndex >= 0) {
      // Update existing transaction in batch
      this.batches[batchName][existingIndex] = { ...this.workingTransaction };
    } else {
      // Add new transaction to batch
      this.batches[batchName].push({ ...this.workingTransaction });
    }

    // Update namedTransactions
    this.namedTransactions[this.selectedTransactionName] = {
      ...this.workingTransaction,
    };

    log(
      `addToBatch(): Transaction '${this.selectedTransactionName}' added to batch '${batchName}'`,
      undefined,
      this.debugMode
    );

    return this;
  }

  /**
   * Removes the currently selected transaction or batch from the trakit.