Class TransactionApprovalRuleService

constructor

• new TransactionApprovalRuleService(
      args: { db: B2bDatabase },
  ): TransactionApprovalRuleService

  Parameters

  • args: { db: B2bDatabase }

  Returns TransactionApprovalRuleService

Staticinstance

disable

• disable(
      __namedParameters: { customerId: string; ruleId: string },
  ): Promise<
      | { ok: true; value: TransactionApprovalRule }
      | { error: ServiceError; ok: false },
  >

  ACTIVE → DISABLED. Disabling a disabled rule is a no-op success.

  Parameters

  • __namedParameters: { customerId: string; ruleId: string }

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

get

• get(
      __namedParameters: { customerId: string; ruleId: string },
  ): Promise<{ ok: true; value: TransactionApprovalRule | null }>

  Parameters

  • __namedParameters: { customerId: string; ruleId: string }

  Returns Promise<{ ok: true; value: TransactionApprovalRule | null }>

requirementsFor

• requirementsFor(
      __namedParameters: {
          amount: { source: BigNumber } | { target: BigNumber } | null;
          approverKeys: string[];
          customerId: string;
          productId: string;
          quote: { sourceAmount: BigNumber } | null;
          requesterId: string;
          source: TransactionApprovalSource;
      },
  ): Promise<
      | { ok: true; value: TransactionApprovalRequirements }
      | { error: ServiceError; ok: false },
  >

  The approval a payment needs: the steps of every ACTIVE rule that matches, grouped by rule name. A rule matches when every key it sets matches (productIds and categories on the payment's product, minAmountUsd against the BE-6 figure, inclusive). A payment with no USD figure (target amount only) matches an amount rule, so dual control is never bypassed.

  approverKeys are what the rail's confirm action checks, plus transactions/metadata:w: an approver executes the payment. The requester never counts as an approver (D4).

  Parameters

  • __namedParameters: {
        amount: { source: BigNumber } | { target: BigNumber } | null;
        approverKeys: string[];
        customerId: string;
        productId: string;
        quote: { sourceAmount: BigNumber } | null;
        requesterId: string;
        source: TransactionApprovalSource;
    }

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

search

• search(
      __namedParameters: {
          customerId: string;
          ids?: string[];
          page?: number;
          pageSize?: number;
          statuses?: ("ACTIVE" | "DISABLED")[];
      },
  ): Promise<
      {
          ok: true;
          value: {
              hasNext: boolean;
              items: TransactionApprovalRule[];
              total: number;
          };
      },
  >

  Parameters

  • __namedParameters: {
        customerId: string;
        ids?: string[];
        page?: number;
        pageSize?: number;
        statuses?: ("ACTIVE" | "DISABLED")[];
    }

  Returns Promise<
      {
          ok: true;
          value: {
              hasNext: boolean;
              items: TransactionApprovalRule[];
              total: number;
          };
      },
  >

upsert

• upsert(
      __namedParameters: {
          actorId: string;
          customerId: string;
          rule: TransactionApprovalRuleInput;
      },
  ): Promise<
      | {
          ok: true;
          value: TransactionApprovalRule & { requesterOnlySteps: number[] };
      }
      | {
          error: | RuleValidationError
          | ServiceError<"RULE_NOT_FOUND">
          | ServiceError<"RULE_DISABLED">;
          ok: false;
      },
  >

  Creates a rule, or edits an ACTIVE one when rule.id is set. Edits never touch in-flight requests: a request snapshots its requirements.

  Parameters

  • __namedParameters: { actorId: string; customerId: string; rule: TransactionApprovalRuleInput }

    • actorId: string

      The dashboard user (cdu_…) writing the rule.

    • customerId: string

    • rule: TransactionApprovalRuleInput

  Returns Promise<
      | {
          ok: true;
          value: TransactionApprovalRule & { requesterOnlySteps: number[] };
      }
      | {
          error: | RuleValidationError
          | ServiceError<"RULE_NOT_FOUND">
          | ServiceError<"RULE_DISABLED">;
          ok: false;
      },
  >