@tammsyr/admin-api-client 1.2.6 → 1.2.8

package/dist/data-contracts.d.ts

@@ -1,13 +1,13 @@
 export interface AdminLoginRequestDto {
     /**
      * Admin email address
-     * @example "admin@tamm.com"
+     * @example "superadmin@tamm.com"
      */
     email: string;
     /**
      * Admin password
      * @minLength 6
-     * @example "SecureP@ss123"
+     * @example "Test@1234"
      */
     password: string;
     /**
@@ -582,16 +582,31 @@ export interface AgentStatisticsDto {
     activeAgents: number;
     /** Number of suspended agents */
     suspendedAgents: number;
-    /** Total number of branches across all agents */
-    totalBranches: number;
+}
+export interface LocalizedNameDto {
+    /**
+     * English name
+     * @example "Head Office"
+     */
+    en: string;
+    /**
+     * Arabic name
+     * @example "المركز الرئيسي"
+     */
+    ar: string;
 }
 export interface AgentListItemDto {
     /** @format uuid */
     id: string;
     type: "MONEY_TRANSFER" | "EXCHANGE_BUREAU" | "BANK";
     status: "PENDING" | "ACTIVE" | "SUSPENDED" | "TERMINATED";
-    name: string;
+    name: LocalizedNameDto;
     licenseNumber: string;
+    /**
+     * 8-digit Customer Information File identifier
+     * @example "00074521"
+     */
+    cif: string;
     contactPerson: string;
     contactEmail: string;
     contactPhone: string;
@@ -604,8 +619,6 @@ export interface AgentListItemDto {
     createdAt: string;
     /** @format date-time */
     updatedAt: string;
-    /** @example 3 */
-    branchCount: number;
 }
 export interface AgentListResponseDto {
     /** List of agents */
@@ -685,48 +698,6 @@ export interface AgentCommissionResponseDto {
      */
     updatedAt: string;
 }
-export interface BranchResponseDto {
-    /**
-     * Branch ID
-     * @format uuid
-     */
-    id: string;
-    /**
-     * Agent ID
-     * @format uuid
-     */
-    agentId: string;
-    /** Branch name */
-    name: string;
-    /** Branch code */
-    code: string;
-    /** Branch status */
-    status: "ACTIVE" | "INACTIVE" | "SUSPENDED";
-    /** Address */
-    address: string;
-    /** City */
-    city: string;
-    /** Latitude */
-    latitude: number;
-    /** Longitude */
-    longitude: number;
-    /** Contact phone */
-    contactPhone: string;
-    /** Contact email */
-    contactEmail?: string;
-    /** Whether the branch is active */
-    isActive: boolean;
-    /**
-     * Created at
-     * @format date-time
-     */
-    createdAt: string;
-    /**
-     * Updated at
-     * @format date-time
-     */
-    updatedAt: string;
-}
 export interface AdminAccountResponseDto {
     /**
      * Account ID (UUID)
@@ -734,8 +705,8 @@ export interface AdminAccountResponseDto {
      */
     id: string;
     /**
-     * Human-readable 16-digit account number. Only set for main accounts.
-     * @example "1076012345678903"
+     * Human-readable 22-digit account number. Only set for main accounts.
+     * @example "0017601010000001000011"
      */
     accountNumber?: string;
     /**
@@ -796,8 +767,13 @@ export interface AgentResponseDto {
     id: string;
     type: "MONEY_TRANSFER" | "EXCHANGE_BUREAU" | "BANK";
     status: "PENDING" | "ACTIVE" | "SUSPENDED" | "TERMINATED";
-    name: string;
+    name: LocalizedNameDto;
     licenseNumber: string;
+    /**
+     * 8-digit Customer Information File identifier
+     * @example "00074521"
+     */
+    cif: string;
     contactPerson: string;
     contactEmail: string;
     contactPhone: string;
@@ -810,11 +786,8 @@ export interface AgentResponseDto {
     createdAt: string;
     /** @format date-time */
     updatedAt: string;
-    /** @example 3 */
-    branchCount: number;
     limits?: AgentLimitResponseDto[];
     commissions?: AgentCommissionResponseDto[];
-    branches?: BranchResponseDto[];
     /** Agent main wallets (admin GET only; unified ownerId + type per account) */
     accounts?: AdminAccountResponseDto[];
 }
@@ -832,11 +805,8 @@ export interface CreateAgentWalletDto {
     name?: string;
 }
 export interface CreateAgentDto {
-    /**
-     * Agent name
-     * @example "Acme Agent"
-     */
-    name: string;
+    /** Translatable display name */
+    name: LocalizedNameDto;
     /** @example "MONEY_TRANSFER" */
     type: "MONEY_TRANSFER" | "EXCHANGE_BUREAU" | "BANK";
     /**
@@ -887,15 +857,12 @@ export interface CreateAgentResponseDto {
      * @format uuid
      */
     id: string;
-    /** Agent name */
-    name: string;
+    /** Translatable agent name */
+    name: LocalizedNameDto;
 }
 export interface UpdateAgentDto {
-    /**
-     * Agent name
-     * @example "Acme Agent"
-     */
-    name?: string;
+    /** Translatable display name */
+    name?: LocalizedNameDto;
     /** @example "MONEY_TRANSFER" */
     type?: "MONEY_TRANSFER" | "EXCHANGE_BUREAU" | "BANK";
     /**
@@ -946,68 +913,8 @@ export interface UpdateAgentResponseDto {
      * @format uuid
      */
     id: string;
-    /** Agent name */
-    name: string;
-}
-export interface UpsertBranchItemDto {
-    /**
-     * Branch name
-     * @example "Downtown Branch"
-     */
-    name: string;
-    /**
-     * Unique branch code
-     * @example "BR-001"
-     */
-    code: string;
-    /**
-     * Address
-     * @example "123 Main St"
-     */
-    address: string;
-    /**
-     * City
-     * @example "Dubai"
-     */
-    city: string;
-    /**
-     * Latitude
-     * @example 25.276987
-     */
-    latitude?: number;
-    /**
-     * Longitude
-     * @example 55.296249
-     */
-    longitude?: number;
-    /**
-     * Contact phone
-     * @example "+971501234567"
-     */
-    contactPhone: string;
-    /**
-     * Contact email
-     * @example "branch@acme.com"
-     */
-    contactEmail?: string;
-    /**
-     * Whether the branch is active
-     * @default true
-     */
-    isActive?: boolean;
-    /** Branch status */
-    status?: "ACTIVE" | "SUSPENDED" | "INACTIVE";
-    /**
-     * Branch ID — if provided, updates; if omitted, creates
-     * @format uuid
-     */
-    branchId?: string;
-}
-export interface UpsertBranchesDto {
-    branches: UpsertBranchItemDto[];
-}
-export interface BranchesUpsertResponseDto {
-    branches: BranchResponseDto[];
+    /** Translatable agent name */
+    name: LocalizedNameDto;
 }
 export interface SetLimitDto {
     /**
@@ -1088,136 +995,243 @@ export interface AgentCommissionsResponseDto {
     /** List of agent commissions */
     commissions: AgentCommissionResponseDto[];
 }
-export interface KycStatisticsResponseDto {
+export interface SubmissionStatisticsResponseDto {
     /**
-     * Total number of KYC requests
-     * @example 150
+     * Submissions still waiting on storage to confirm uploads
+     * @example 3
      */
-    total: number;
+    pending_upload: number;
     /**
-     * Number of pending KYC requests
-     * @example 45
+     * Submissions whose files are confirmed; awaiting reviewer
+     * @example 17
      */
-    pending: number;
+    uploaded: number;
     /**
-     * Number of KYC requests under review
-     * @example 12
+     * Submissions currently being reviewed
+     * @example 5
      */
-    underReview: number;
+    under_review: number;
     /**
-     * Number of verified KYC requests
-     * @example 80
+     * Approved submissions (post-saga for INDIVIDUAL)
+     * @example 102
      */
-    verified: number;
+    approved: number;
     /**
-     * Number of rejected KYC requests
-     * @example 13
+     * Rejected submissions (customer may re-submit)
+     * @example 11
      */
     rejected: number;
-}
-export interface ListKycResponseRow {
-    id: string;
-    fullName: string;
     /**
-     * KYC request status
-     * @example "pending"
-     */
-    status: "pending" | "under_review" | "verified" | "rejected";
-    createdAt: string;
-}
-export interface KycListResponseDto {
-    /** List of KYC requests */
-    data: ListKycResponseRow[];
-    /** Pagination metadata */
+     * Submissions whose expiry_date has passed (background cron)
+     * @example 4
+     */
+    expired: number;
+}
+export interface SubjectInputDto {
+    role: "INDIVIDUAL" | "BUSINESS" | "UBO" | "DIRECTOR";
+    subject_id: string;
+    display_name: string;
+}
+export interface SubmissionFileResponseDto {
+    file_id: string;
+    slot_key: string;
+    storage_reference?: string;
+    original_name: string;
+    mime_type: string;
+    size_bytes: number;
+    sha256?: object;
+    uploaded_at: string;
+    uploaded_by?: string;
+}
+export interface SubmissionReviewResponseDto {
+    reviewer_id?: object;
+    reviewed_at?: object;
+    decision?: object;
+    rejection_reason_code?: object;
+    rejection_notes?: object;
+    previous_attempts: number;
+}
+export interface SubmissionResponseDto {
+    submission_id: string;
+    customer_id: string;
+    subject: SubjectInputDto;
+    document_type_code: string;
+    document_type_version: number;
+    document_type_category: string;
+    files: SubmissionFileResponseDto[];
+    extracted_fields: object;
+    status: "PENDING_UPLOAD" | "UPLOADED" | "UNDER_REVIEW" | "APPROVED" | "REJECTED" | "EXPIRED";
+    review: SubmissionReviewResponseDto;
+    previous_submission_id?: object;
+    created_at: string;
+    updated_at: string;
+    expires_at?: object;
+}
+export interface SubmissionListResponseDto {
+    data: SubmissionResponseDto[];
     meta: PaginationMetaDto;
 }
-export interface KycDocumentResponseDto {
-    /**
-     * Document type
-     * @example "id_front"
-     */
-    documentType: "id_front" | "id_back" | "selfie";
-    /**
-     * Reference to the encrypted storage location
-     * @example "uploads/kyc/123/id_front.enc"
-     */
-    storageReference: string;
-}
-export interface KycRequestResponseDto {
-    /**
-     * KYC request unique identifier
-     * @example "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
-     */
+export interface ApproveSubmissionRequestDto {
+    notes?: string;
+}
+export interface RejectSubmissionRequestDto {
+    reason_code: "EXPIRED" | "ILLEGIBLE" | "WRONG_DOCUMENT" | "OTHER";
+    notes: string;
+}
+export interface SubmitFieldsRequestDto {
+    /** Map of field key → value, validated against pinned schema */
+    extracted_fields: object;
+}
+export interface FileSlotDto {
+    key: string;
+    /** i18n map (e.g. { en: "Front", ar: "الأمامي" }) */
+    label_i18n: object;
+    /** Optional i18n helper text shown under the label (e.g. capture hints) */
+    description_i18n?: object;
+    required: boolean;
+    accepted_mime: string[];
+    max_size_mb: number;
+    capture_hint: "document" | "selfie" | "any";
+}
+export interface FieldValidationDto {
+    pattern?: string;
+    min_length?: number;
+    max_length?: number;
+    min?: number;
+    max?: number;
+    min_offset_days?: number;
+    max_offset_days?: number;
+    options?: string[];
+    options_source?: string;
+}
+export interface FieldDto {
+    key: string;
+    label_i18n: object;
+    /** Optional i18n helper text shown under the label (e.g. "As printed on the document") */
+    description_i18n?: object;
+    type: "string" | "number" | "date" | "boolean" | "enum";
+    required: boolean;
+    pii?: boolean;
+    validation: FieldValidationDto;
+}
+export interface DocumentTypeResponseDto {
     id: string;
+    code: string;
+    version: number;
+    name_i18n: object;
+    description_i18n?: object;
+    category: "IDENTITY" | "ADDRESS" | "INCORPORATION" | "OWNERSHIP" | "FINANCIAL" | "OTHER";
+    applies_to: "INDIVIDUAL" | "BUSINESS" | "UBO" | "DIRECTOR";
+    file_slots: FileSlotDto[];
+    fields: FieldDto[];
+    is_active: boolean;
+    created_by: string;
+    created_at: string;
+}
+export interface CreateDocumentTypeRequestDto {
+    code: string;
+    name_i18n: object;
+    description_i18n?: object;
+    category: "IDENTITY" | "ADDRESS" | "INCORPORATION" | "OWNERSHIP" | "FINANCIAL" | "OTHER";
+    applies_to: "INDIVIDUAL" | "BUSINESS" | "UBO" | "DIRECTOR";
+    file_slots: FileSlotDto[];
+    fields: FieldDto[];
+}
+export interface PatchDocumentTypeRequestDto {
+    is_active?: boolean;
+    name_i18n?: object;
+}
+export interface RuleResponseDto {
+    id: string;
+    country_code?: object;
+    customer_type?: "INDIVIDUAL" | "SME" | "CORPORATE";
+    risk_level?: "LOW" | "MEDIUM" | "HIGH";
+    business_type?: object;
+    subject_role: "INDIVIDUAL" | "BUSINESS" | "UBO" | "DIRECTOR";
+    document_type_code: string;
+    is_mandatory: boolean;
+    alternative_group?: object;
+    min_count?: object | null;
+    priority: number;
+    is_active: boolean;
+}
+export interface CreateRuleRequestDto {
+    /** ISO 3166-1 alpha-2; null = wildcard */
+    country_code?: string;
+    customer_type?: "INDIVIDUAL" | "SME" | "CORPORATE";
+    risk_level?: "LOW" | "MEDIUM" | "HIGH";
+    subject_role: "INDIVIDUAL" | "BUSINESS" | "UBO" | "DIRECTOR";
+    document_type_code: string;
+    is_mandatory: boolean;
+    alternative_group?: string;
     /**
-     * Person unique identifier
-     * @example "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
-     */
-    personId: string;
-    firstName: string;
-    lastName: string;
-    fatherName: string;
-    motherName: string;
-    /**
-     * Full national ID number (decrypted)
-     * @example "12345678901234"
-     */
-    nationalIdNumber: string;
-    nationality: string;
-    dateOfBirth: string;
-    address: string;
-    documentType: "passport" | "national_id";
-    /**
-     * KYC provider (MANUAL, AUTOMATED, etc.)
-     * @example "MANUAL"
-     */
-    provider: string;
-    /**
-     * KYC request status
-     * @example "pending"
-     */
-    status: "pending" | "under_review" | "verified" | "rejected";
-    /** Uploaded documents for this request */
-    documents: KycDocumentResponseDto[];
-    /**
-     * Timestamp when the request entered review
-     * @example "2025-01-01T12:00:00.000Z"
-     */
-    reviewAt: string | null;
-    /**
-     * Rejection reason if status is rejected
-     * @example "DOCUMENT_BLURRY"
+     * KYB scope — business type code; null/omit = any business type
+     * @example "LLC"
      */
-    rejectionReason: string | null;
+    business_type?: string;
     /**
-     * Admin identifier who reviewed the request
-     * @example "admin-123"
+     * Minimum subjects required for this rule's subject_role (e.g. 2 UBOs). Omit to use the resolver default.
+     * @min 1
      */
-    reviewedByAdminId: string | null;
+    min_count?: number;
+    /** @default 100 */
+    priority: number;
+}
+export interface PatchRuleRequestDto {
+    is_mandatory?: boolean;
+    alternative_group?: string;
+    priority?: number;
+    is_active?: boolean;
+    /** @min 1 */
+    min_count?: number;
+}
+export interface PreviewRequirementsRequestDto {
     /**
-     * Email of the admin who reviewed the request
-     * @example "admin@tamm.com"
+     * ISO 3166-1 alpha-2 country code
+     * @example "EG"
      */
-    reviewedByAdminEmail: string | null;
+    country: string;
+    customer_type: "INDIVIDUAL" | "SME" | "CORPORATE";
+    risk_level: "LOW" | "MEDIUM" | "HIGH";
     /**
-     * Creation timestamp of the request
-     * @example "2025-01-01T11:00:00.000Z"
+     * KYB only — business type code to preview
+     * @example "LLC"
      */
-    createdAt: string;
-    /** @example "2025-01-01T11:00:00.000Z" */
-    updatedAt: string;
+    business_type?: string;
+    /** Language override for labels */
+    lang?: string;
 }
-export interface UpdateKycStatusDto {
+export interface BusinessTypeResponseDto {
+    id: string;
+    code: string;
+    name_i18n: object;
+    description_i18n?: object;
+    customer_type?: object | null;
+    is_active: boolean;
+    created_by: string;
+    created_at: string;
+}
+export interface CreateBusinessTypeRequestDto {
     /**
-     * Target status: under_review (start review), rejected or verified (approve)
-     * @example "under_review"
+     * Unique code, e.g. "LLC"
+     * @example "LLC"
      */
-    status: "pending" | "under_review" | "verified" | "rejected";
+    code: string;
     /**
-     * Rejection reason
-     * @example "Document is blurry"
+     * i18n name map
+     * @example {"en":"LLC","ar":"ش.ذ.م.م"}
      */
-    rejectionReason: string;
+    name_i18n: object;
+    /** i18n description map */
+    description_i18n?: object;
+    /** Which customer_type this business type belongs to (null = any) */
+    customer_type?: "INDIVIDUAL" | "SME" | "CORPORATE";
+}
+export interface PatchBusinessTypeRequestDto {
+    is_active?: boolean;
+    name_i18n?: object;
+    description_i18n?: object;
+    customer_type?: "INDIVIDUAL" | "SME" | "CORPORATE";
 }
 export interface AmlRuleDto {
     /**
@@ -1729,7 +1743,7 @@ export interface TransactionResponseDto {
      * Transaction status
      * @example "COMPLETED"
      */
-    status: "VOUCHER_PENDING" | "INITIATED" | "VALIDATING" | "AUTHORIZED" | "RESERVED" | "POSTING" | "COMPLETED" | "REJECTED" | "DECLINED" | "CANCELLED" | "FAILED" | "REVERSING" | "REVERSED";
+    status: "COMPLETED" | "FAILED" | "VOUCHER_PENDING" | "REVERSED";
     /**
      * Transaction description
      * @example "Payment for services"
@@ -1741,10 +1755,10 @@ export interface TransactionResponseDto {
      */
     correlationId: string;
     /**
-     * Human-readable reason for the current status (e.g. AML decline reason)
-     * @example "Transaction declined due to high risk (risk score: 85, matched rules: 2)"
+     * Deprecated — kept for wire compatibility. Failure reasons now ride the transaction.failed event payload; AML reasons live in transaction_summaries.
+     * @example ""
      */
-    statusReason: string;
+    statusReason?: string;
     /**
      * Transaction creation timestamp (ISO format)
      * @example "2024-01-15T12:00:00Z"
@@ -1849,8 +1863,8 @@ export interface AdminAccountDetailResponseDto {
      */
     id: string;
     /**
-     * Human-readable 16-digit account number. Only set for main accounts.
-     * @example "1076012345678903"
+     * Human-readable 22-digit account number. Only set for main accounts.
+     * @example "0017601010000001000011"
      */
     accountNumber?: string;
     /**
@@ -1985,10 +1999,13 @@ export interface AdminTransactionItemDto {
     /** @example "P2P_TRANSFER" */
     type: "P2P_TRANSFER" | "WITHDRAWAL" | "TOP_UP" | "MERCHANT_PAYMENT" | "REVERSAL" | "REFUND" | "MOVING";
     /** @example "COMPLETED" */
-    status: "INITIATED" | "VALIDATING" | "AUTHORIZED" | "RESERVED" | "POSTING" | "COMPLETED" | "REJECTED" | "DECLINED" | "CANCELLED" | "FAILED" | "REVERSING" | "REVERSED";
+    status: "COMPLETED" | "FAILED" | "VOUCHER_PENDING" | "REVERSED";
     /** @example "Payment for services" */
     description?: string;
-    /** @example 0 */
+    /**
+     * AML risk score (0-100). Computed asynchronously after the transaction is posted; admin views fetch this from aml-service.transaction_summaries via gRPC and merge it in.
+     * @example 0
+     */
     amlRiskScore: number;
     /** @example "LOW" */
     amlRiskLevel: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
@@ -2724,6 +2741,172 @@ export interface ResolveDlqMessageDto {
      */
     note?: string;
 }
+export interface BankBranchResponseDto {
+    /** @example "001" */
+    code: string;
+    name: LocalizedNameDto;
+    /** @example true */
+    isActive: boolean;
+    /** @format date-time */
+    createdAt: string;
+    /** @format date-time */
+    updatedAt: string;
+}
+export interface BankBranchesListResponseDto {
+    branches: BankBranchResponseDto[];
+}
+export interface CreateBankBranchDto {
+    /**
+     * 3-digit branch code (immutable once issued)
+     * @example "002"
+     */
+    code: string;
+    /** Translatable display name */
+    name: LocalizedNameDto;
+}
+export interface UpdateBankBranchDto {
+    name?: LocalizedNameDto;
+    /** Toggle whether this branch can issue new account numbers */
+    isActive?: boolean;
+}
+export interface AccountTypeResponseDto {
+    /** @example "10" */
+    code: string;
+    /**
+     * Matches accountTypeEnum value
+     * @example "personal"
+     */
+    key: string;
+    name: LocalizedNameDto;
+    /** @example true */
+    isActive: boolean;
+    /** @format date-time */
+    createdAt: string;
+    /** @format date-time */
+    updatedAt: string;
+}
+export interface AccountTypesListResponseDto {
+    accountTypes: AccountTypeResponseDto[];
+}
+export interface UpdateAccountTypeDto {
+    name?: LocalizedNameDto;
+    /** Toggle whether the generator may issue new account numbers of this type */
+    isActive?: boolean;
+}
+export interface CurrencyConfigResponseDto {
+    /** @example "USD" */
+    code: string;
+    /** @example "840" */
+    numericCode: string;
+    name: LocalizedNameDto;
+    /** @example true */
+    isActive: boolean;
+    /** @format date-time */
+    createdAt: string;
+}
+export interface CurrencyConfigListResponseDto {
+    currencies: CurrencyConfigResponseDto[];
+}
+export interface CreateCurrencyConfigDto {
+    /**
+     * ISO 4217 alpha-3 code
+     * @example "EUR"
+     */
+    code: string;
+    /**
+     * ISO 4217 numeric code (3 digits)
+     * @example "978"
+     */
+    numericCode: string;
+    name: LocalizedNameDto;
+}
+export interface UpdateCurrencyConfigDto {
+    /**
+     * ISO 4217 numeric code (3 digits)
+     * @example "978"
+     */
+    numericCode?: string;
+    name?: LocalizedNameDto;
+    /** Toggle whether the generator may issue new account numbers in this currency */
+    isActive?: boolean;
+}
+export interface ApprovalDecisionResponseDto {
+    id: string;
+    adminId: string;
+    adminEmail: string;
+    decision: "APPROVED" | "REJECTED";
+    comment?: object;
+    /** @format date-time */
+    createdAt: string;
+}
+export interface ApprovalRequestResponseDto {
+    id: string;
+    actionType: "admin.create" | "admin.update" | "admin.delete" | "admin.status_update" | "system_config.upsert" | "system_config.delete" | "account.fund" | "role.assign_permissions" | "reconciliation.run";
+    resource: string;
+    resourceId?: object;
+    title: string;
+    status: "PENDING" | "APPROVED" | "EXECUTED" | "FAILED" | "REJECTED" | "EXPIRED" | "CANCELLED";
+    /** Distinct approvers required (maker excluded) */
+    requiredApprovals: number;
+    /** Distinct approvals recorded so far */
+    approvalsCount: number;
+    requestedBy: string;
+    requestedByEmail: string;
+    reason?: object;
+    /** Present once executed */
+    executionError?: object;
+    /** @format date-time */
+    createdAt: string;
+    /** @format date-time */
+    expiresAt: string;
+    executedAt?: object;
+    decisions?: ApprovalDecisionResponseDto[];
+}
+export interface ApprovalRequestListResponseDto {
+    data: ApprovalRequestResponseDto[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
+export interface CreateApprovalDecisionDto {
+    /** The checker verdict on the approval request */
+    decision: "APPROVED" | "REJECTED";
+    /**
+     * Optional note explaining the decision (stored for audit)
+     * @maxLength 1000
+     */
+    comment?: string;
+}
+export interface ApprovalPolicyResponseDto {
+    actionType: "admin.create" | "admin.update" | "admin.delete" | "admin.status_update" | "system_config.upsert" | "system_config.delete" | "account.fund" | "role.assign_permissions" | "reconciliation.run";
+    enabled: boolean;
+    requiredApprovals: number;
+    allowSelfApprove: boolean;
+    bypassSuperAdmin: boolean;
+    expiresInHours: number;
+    /** @format date-time */
+    updatedAt: string;
+}
+export interface UpdateApprovalPolicyDto {
+    /** Whether four-eyes is enforced for this action */
+    enabled?: boolean;
+    /**
+     * Distinct approvers required (maker excluded). Minimum 1.
+     * @min 1
+     * @max 10
+     */
+    requiredApprovals?: number;
+    /** Allow the maker to approve their own request (break-glass) */
+    allowSelfApprove?: boolean;
+    /** Exempt super admins from four-eyes for this action */
+    bypassSuperAdmin?: boolean;
+    /**
+     * Hours before a pending request expires
+     * @min 1
+     */
+    expiresInHours?: number;
+}
 export type LoginData = AdminLoginResponseDto;
 export type LoginError = ErrorResponseDto;
 export type RefreshData = AdminLoginResponseDto;
@@ -2977,11 +3160,6 @@ export interface CreateAgentWalletParams {
     id: string;
 }
 export type CreateAgentWalletData = AdminAccountResponseDto;
-export interface UpsertAgentBranchesParams {
-    /** Agent ID */
-    id: string;
-}
-export type UpsertAgentBranchesData = BranchesUpsertResponseDto;
 export interface UpsertAgentLimitsParams {
     /** Agent ID (UUID) */
     id: string;
@@ -2992,11 +3170,6 @@ export interface UpsertAgentCommissionsParams {
     id: string;
 }
 export type UpsertAgentCommissionsData = AgentCommissionsResponseDto;
-export interface DeleteBranchParams {
-    /** Branch ID (UUID) */
-    branchId: string;
-}
-export type DeleteBranchData = MessageResponseDto;
 export interface DeleteLimitParams {
     /** Limit ID (UUID) */
     limitId: string;
@@ -3007,45 +3180,99 @@ export interface DeleteCommissionParams {
     commissionId: string;
 }
 export type DeleteCommissionData = MessageResponseDto;
-export type GetStatisticsResult = KycStatisticsResponseDto;
-export interface FindAllParams10 {
+export type StatisticsData = SubmissionStatisticsResponseDto;
+export interface ListParams {
+    status?: "PENDING_UPLOAD" | "UPLOADED" | "UNDER_REVIEW" | "APPROVED" | "REJECTED" | "EXPIRED";
+    subject_id?: string;
+    subject_role?: "INDIVIDUAL" | "BUSINESS" | "UBO" | "DIRECTOR";
     /**
-     * Page number (1-based)
      * @min 1
      * @default 1
-     * @example 1
      */
     page?: number;
     /**
-     * Number of items per page
      * @min 1
      * @max 200
      * @default 20
-     * @example 20
      */
     limit?: number;
-    /**
-     * Filter by KYC status
-     * @example "pending"
-     */
-    status?: "pending" | "under_review" | "verified" | "rejected";
-    /**
-     * Search by KYC request ID or person ID
-     * @example "kyc-001"
-     */
-    search?: string;
 }
-export type FindAllResult2 = KycListResponseDto;
-export interface FindByIdParams6 {
-    /** KYC request ID */
+export type ListData = SubmissionListResponseDto;
+export interface GetParams {
+    id: string;
+}
+export type GetData = SubmissionResponseDto;
+export interface StartReviewParams {
+    id: string;
+}
+export type StartReviewData = any;
+export interface ApproveParams {
+    id: string;
+}
+export type ApproveData = any;
+export interface RejectParams {
+    id: string;
+}
+export type RejectData = any;
+export interface PatchFieldsParams {
+    id: string;
+}
+export type PatchFieldsData = any;
+export interface List2Params {
+    only_active: string;
+}
+export type List2Data = DocumentTypeResponseDto[];
+export type CreateResult1 = any;
+export interface ListVersionsParams {
+    code: string;
+}
+export type ListVersionsData = any;
+export interface CreateVersionParams {
+    code: string;
+}
+export type CreateVersionData = any;
+export interface PatchParams {
+    id: string;
+}
+export type PatchData = any;
+export interface RemoveParams {
+    id: string;
+}
+export type RemoveData = any;
+export interface List3Params {
+    country_code?: string;
+    customer_type?: "INDIVIDUAL" | "SME" | "CORPORATE";
+    risk_level?: "LOW" | "MEDIUM" | "HIGH";
+    subject_role?: "INDIVIDUAL" | "BUSINESS" | "UBO" | "DIRECTOR";
+    document_type_code?: string;
+    /** KYB business type code filter */
+    business_type?: string;
+    only_active?: boolean;
+}
+export type List3Data = RuleResponseDto[];
+export type Create2Data = any;
+export interface Patch2Params {
     id: string;
 }
-export type FindByIdResult1 = KycRequestResponseDto;
-export interface UpdateStatusParams2 {
-    /** KYC request ID */
+export type Patch2Data = any;
+export interface Remove2Params {
+    id: string;
+}
+export type Remove2Data = any;
+export type PreviewData = any;
+export interface List4Params {
+    only_active: string;
+}
+export type List4Data = BusinessTypeResponseDto[];
+export type Create3Data = any;
+export interface Patch3Params {
     id: string;
 }
-export type UpdateStatusResult = KycRequestResponseDto;
+export type Patch3Data = any;
+export interface Remove3Params {
+    id: string;
+}
+export type Remove3Data = any;
 export interface GetAmlRulesParams {
     currency?: "SYP" | "USD" | "EUR";
     isActive?: boolean;
@@ -3101,7 +3328,7 @@ export interface AssignAlertParams {
 }
 export type AssignAlertData = AmlAlertDto;
 export type AssignAlertError = ErrorResponseDto;
-export type GetStatisticsOutput = AccountStatisticsResponseDto;
+export type GetStatisticsResult = AccountStatisticsResponseDto;
 export interface ListAccountsParams {
     /**
      * Page number (1-based)
@@ -3175,7 +3402,7 @@ export interface UpdateAccountStatusParams {
     id: string;
 }
 export type UpdateAccountStatusData = AdminAccountResponseDto;
-export interface GetStatisticsParams3 {
+export interface GetStatisticsParams2 {
     /** Start date filter (ISO date, e.g. 2025-01-01) */
     startDate?: string;
     /** End date filter (ISO date, e.g. 2025-12-31) */
@@ -3183,7 +3410,7 @@ export interface GetStatisticsParams3 {
     /** Filter by currency */
     currency?: "SYP" | "USD" | "EUR";
 }
-export type GetStatisticsResult1 = TransactionStatisticsResponseDto;
+export type GetStatisticsOutput = TransactionStatisticsResponseDto;
 export interface ListTransactionsParams {
     /** Search by transaction ID or public transaction ID */
     search?: string;
@@ -3218,9 +3445,9 @@ export type GetTransactionDetailData = AdminTransactionDetailResponseDto;
 export type GetTransactionDetailError = ErrorResponseDto;
 export type SendGlobalNotificationData = SendGlobalNotificationResponseDto;
 export type SendGlobalNotificationError = ErrorResponseDto;
-export type CreateData1 = ScheduledNotificationResponseDto;
+export type CreateResult2 = ScheduledNotificationResponseDto;
 export type CreateErrorData = ErrorResponseDto;
-export interface FindAllParams12 {
+export interface FindAllParams10 {
     /** Filter by status */
     status?: "pending" | "sent" | "failed" | "cancelled";
     /**
@@ -3248,11 +3475,11 @@ export interface UpdateParams6 {
 }
 export type UpdateResult1 = ScheduledNotificationResponseDto;
 export type UpdateErrorData = ErrorResponseDto;
-export interface RemoveParams {
+export interface RemoveParams2 {
     /** MongoDB ObjectId */
     id: string;
 }
-export type RemoveData = any;
+export type RemoveResult = any;
 export type RemoveError = ErrorResponseDto;
 export interface GetSystemConfigsParams {
     /** Filter by config key */
@@ -3309,14 +3536,14 @@ export interface DeleteDocumentParams {
 }
 export type DeleteDocumentData = any;
 export type DeleteDocumentError = ErrorResponseDto;
-export type ListData = AppVersionPolicyListResponseDto;
+export type ListResult = AppVersionPolicyListResponseDto;
 export type UpsertData = AppVersionPolicyDto;
-export interface GetParams {
+export interface GetParams2 {
     platform: "ios" | "android";
 }
-export type GetData = AppVersionPolicyDto;
-export type GetStatisticsResult2 = UserStatisticsResponseDto;
-export interface FindAllParams14 {
+export type GetResult = AppVersionPolicyDto;
+export type GetStatisticsResult1 = UserStatisticsResponseDto;
+export interface FindAllParams12 {
     /**
      * Page number (1-based)
      * @min 1
@@ -3363,7 +3590,7 @@ export interface FindAllParams14 {
      */
     query?: string;
 }
-export type FindAllResult3 = PersonListResponseDto;
+export type FindAllData2 = PersonListResponseDto;
 export interface ExportUsersParams {
     /**
      * Field to sort by
@@ -3404,11 +3631,11 @@ export interface ExportUsersParams {
 export type ExportUsersData = any;
 export type GetSecurityQuestionsByPhoneData = GetSecurityQuestionsByPhoneResponseDto;
 export type RegenerateRecoveryCodeData = RegenerateRecoveryCodeByPhoneResponseDto;
-export interface FindByIdParams8 {
+export interface FindByIdParams6 {
     /** Person ID (UUID) */
     id: string;
 }
-export type FindByIdResult2 = PersonDetailDto;
+export type FindByIdData1 = PersonDetailDto;
 export interface UpdatePersonStatusParams {
     /** Person ID (UUID) */
     id: string;
@@ -3419,7 +3646,7 @@ export interface UpdateUserStatusParams {
     id: string;
 }
 export type UpdateUserStatusData = any;
-export interface FindAllParams16 {
+export interface FindAllParams14 {
     /**
      * Page number (1-based)
      * @default 1
@@ -3448,14 +3675,99 @@ export interface FindAllParams16 {
      */
     endDate?: string;
 }
-export type FindAllData2 = DlqMessageListResponseDto;
+export type FindAllResult2 = DlqMessageListResponseDto;
 export type PendingByTopicData = DlqPendingByTopicResponseDto[];
-export interface FindByIdParams10 {
+export interface FindByIdParams8 {
     id: string;
 }
-export type FindByIdData1 = DlqMessageResponseDto;
+export type FindByIdResult1 = DlqMessageResponseDto;
 export interface ResolveParams {
     id: string;
 }
 export type ResolveData = DlqMessageResponseDto;
+export interface ListParams3 {
+    /** Return only active branches */
+    onlyActive?: boolean;
+}
+export type ListOutput = BankBranchesListResponseDto;
+export type CreateData1 = BankBranchResponseDto;
+export interface GetByCodeParams {
+    /** 3-digit branch code */
+    code: string;
+}
+export type GetByCodeData = BankBranchResponseDto;
+export interface UpdateParams8 {
+    /** 3-digit branch code */
+    code: string;
+}
+export type UpdateResult2 = BankBranchResponseDto;
+export interface ListParams5 {
+    onlyActive?: boolean;
+}
+export type ListResult1 = AccountTypesListResponseDto;
+export interface UpdateParams10 {
+    /** 2-digit account-type code */
+    code: string;
+}
+export type UpdateResult3 = AccountTypeResponseDto;
+export interface ListParams7 {
+    onlyActive?: boolean;
+}
+export type ListOutput1 = CurrencyConfigListResponseDto;
+export type CreateResult3 = CurrencyConfigResponseDto;
+export interface GetByCodeParams2 {
+    /** ISO 4217 alpha-3 code (e.g. USD) */
+    code: string;
+}
+export type GetByCodeResult = CurrencyConfigResponseDto;
+export interface DeleteParams6 {
+    /** ISO 4217 alpha-3 code */
+    code: string;
+}
+export type DeleteOutput1 = any;
+export interface UpdateParams12 {
+    /** ISO 4217 alpha-3 code */
+    code: string;
+}
+export type UpdateResult4 = CurrencyConfigResponseDto;
+export interface ListRequestsParams {
+    /** Filter by status */
+    status?: "PENDING" | "APPROVED" | "EXECUTED" | "FAILED" | "REJECTED" | "EXPIRED" | "CANCELLED";
+    /** Filter by action type */
+    actionType?: "admin.create" | "admin.update" | "admin.delete" | "admin.status_update" | "system_config.upsert" | "system_config.delete" | "account.fund" | "role.assign_permissions" | "reconciliation.run";
+    /** Filter by maker (admin UUID) */
+    requestedBy?: string;
+    /**
+     * Page number (1-based)
+     * @default 1
+     */
+    page?: number;
+    /**
+     * Items per page (max 200)
+     * @default 20
+     */
+    limit?: number;
+}
+export type ListRequestsData = ApprovalRequestListResponseDto;
+export interface GetRequestParams {
+    /** Approval request UUID */
+    id: string;
+}
+export type GetRequestData = ApprovalRequestResponseDto;
+export interface DecideParams {
+    /** Approval request UUID */
+    id: string;
+}
+export type DecideData = ApprovalRequestResponseDto;
+export interface CancelParams {
+    /** Approval request UUID */
+    id: string;
+}
+export type CancelData = ApprovalRequestResponseDto;
+export type ListData1 = ApprovalPolicyResponseDto[];
+export interface UpdateParams14 {
+    actionType: "admin.create" | "admin.update" | "admin.delete" | "admin.status_update" | "system_config.upsert" | "system_config.delete" | "account.fund" | "role.assign_permissions" | "reconciliation.run";
+}
+export type UpdateOutput1 = ApprovalPolicyResponseDto;
+export type IndexData = any;
 //# sourceMappingURL=data-contracts.d.ts.map