Class TransactionRequestMetadataService

constructor

• new TransactionRequestMetadataService(
      __namedParameters: {
          fileService: TransactionMetadataFileService;
          metadataService: TransactionMetadataService;
      },
  ): TransactionRequestMetadataService

  Parameters

  • __namedParameters: {
        fileService: TransactionMetadataFileService;
        metadataService: TransactionMetadataService;
    }

  Returns TransactionRequestMetadataService

Staticinstance

attachToTransaction

• attachToTransaction(
      __namedParameters: {
          customerId: string;
          metadata: TransactionRequestMetadata;
          requesterDashboardUserId: string;
          requestId: string;
          transactionId: string;
      },
  ): Promise<
      {
          ok: true;
          value: {
              files: { created: boolean; file: TransactionMetadataFile }[];
              metadata: TransactionMetadata;
          };
      },
  >

  Record the request on the transaction's metadata (approvalRequestId, the requester as creator, never the approver whose click ran execution), write the request's note and attach its files. Safe to retry after a crash: the metadata upserts and a file already attached is returned, not duplicated. The files keep their request-owned keys (no second copy), which TransactionMetadataFileService.get serves as it does any transaction file. A failure throws so execution retries. created lists the files this call added, for the caller's activity rows.

  Parameters

  • __namedParameters: {
        customerId: string;
        metadata: TransactionRequestMetadata;
        requesterDashboardUserId: string;
        requestId: string;
        transactionId: string;
    }

  Returns Promise<
      {
          ok: true;
          value: {
              files: { created: boolean; file: TransactionMetadataFile }[];
              metadata: TransactionMetadata;
          };
      },
  >

promote

• promote(
      __namedParameters: {
          cached: CachedTransactionMetadata | null;
          customerId: string;
          requestId: string;
      },
  ): Promise<
      | { error: ServiceError; ok: false }
      | { ok: true; value: TransactionRequestMetadata },
  >

  Copy the cached files out of staging to request-owned keys and return the value for the request's metadata. Call before the insert, outside any database transaction, with the apreq_ id the row will get.

  Parameters

  • __namedParameters: {
        cached: CachedTransactionMetadata | null;
        customerId: string;
        requestId: string;
    }

  Returns Promise<
      | { error: ServiceError; ok: false }
      | { ok: true; value: TransactionRequestMetadata },
  >