@artu-ai/compliance-sdk 0.4.0 → 0.4.2

package/src/resources/mex/bank-accounts.ts

@@ -1,283 +0,0 @@
-/**
- * Mexico Bank Accounts Resource
- *
- * Extends BankAccountsResource to return MexBankAccount models
- * with Mexico-specific helpers (CLABE formatting, etc.).
- */
-
-import type {
-  CreateBankAccountInput,
-  UpdateBankAccountInput,
-  BankAccountFilter,
-  BankAccountSort,
-  ListOptions,
-  PaginatedResponse,
-  AtomicBatchResult,
-  PartialBatchResult,
-  SyncItem,
-  SyncResult,
-  MexBankAccountFilter,
-  MexBankAccountSort,
-} from "@artu-ai/shared";
-import {
-  transformSort,
-  mexBankAccountFieldMapping,
-} from "@artu-ai/shared";
-import { BankAccountsResource } from "../bank-accounts";
-import { type BatchOptions } from "../clients";
-import { MexBankAccount, type BankAccountData } from "../../models";
-
-/**
- * Mexico-scoped bank accounts resource.
- *
- * Identical to BankAccountsResource but returns MexBankAccount models
- * with Mexico-specific helpers like CLABE formatting.
- *
- * @example
- * ```typescript
- * const mexSdk = new ComplianceSDK({
- *   apiKey,
- *   environment: "test",
- *   jurisdiction: Jurisdiction.Mexico,
- * });
- *
- * const account = await mexSdk.bankAccounts.create({
- *   clientId: "client_123",
- *   accountNumber: "1234567890",
- *   bankName: "BBVA México",
- *   type: "checking",
- *   currency: "MXN",
- *   country: "MX",
- *   clabe: "012180001234567890",
- * });
- *
- * // Returns MexBankAccount with helpers
- * console.log(account.clabe);
- * console.log(account.formattedClabe);  // "012 180 00123456789 0"
- * console.log(account.maskedClabe);     // "**************7890"
- * ```
- */
-export class MexBankAccountsResource<
-  TSort = MexBankAccountSort,
-> extends BankAccountsResource<TSort> {
-  // ─────────────────────────────────────────────────────────────────
-  // CRUD Operations (override return types)
-  // ─────────────────────────────────────────────────────────────────
-
-  override async create(data: CreateBankAccountInput): Promise<MexBankAccount> {
-    return super.create(data) as Promise<MexBankAccount>;
-  }
-
-  override async retrieve(id: string): Promise<MexBankAccount> {
-    return super.retrieve(id) as Promise<MexBankAccount>;
-  }
-
-  override async retrieveByMetadata(
-    key: string,
-    value: string
-  ): Promise<MexBankAccount> {
-    return super.retrieveByMetadata(key, value) as Promise<MexBankAccount>;
-  }
-
-  override async retrieveByExternalId(
-    externalId: string
-  ): Promise<MexBankAccount> {
-    return super.retrieveByExternalId(externalId) as Promise<MexBankAccount>;
-  }
-
-  override async update(
-    id: string,
-    data: UpdateBankAccountInput
-  ): Promise<MexBankAccount> {
-    return super.update(id, data) as Promise<MexBankAccount>;
-  }
-
-  // ─────────────────────────────────────────────────────────────────
-  // List & Pagination
-  // ─────────────────────────────────────────────────────────────────
-
-  /**
-   * Lists bank accounts with optional filtering.
-   *
-   * Accepts flattened MX filter (MX-specific fields at root level).
-   */
-  async list(
-    options?: ListOptions<MexBankAccountFilter, TSort>
-  ): Promise<PaginatedResponse<MexBankAccount>> {
-    const scopedFilter = this.applyScopeToFilter(options?.filter);
-    const scopedSort = this.applyScopeToSort(options?.sort);
-
-    const response = await this.execute(() =>
-      this.trpc.bankAccounts.list.query({
-        ...options,
-        filter: scopedFilter,
-        sort: scopedSort,
-      })
-    );
-
-    return {
-      data: response.data.map((a) => this.instantiate(a)),
-      pagination: response.pagination,
-    };
-  }
-
-  override async listByClient(
-    clientId: string,
-    options?: { cursor?: string; limit?: number }
-  ): Promise<PaginatedResponse<MexBankAccount>> {
-    return super.listByClient(clientId, options) as Promise<
-      PaginatedResponse<MexBankAccount>
-    >;
-  }
-
-  /**
-   * Iterates over bank accounts.
-   *
-   * Accepts flattened MX filter (MX-specific fields at root level).
-   */
-  iterate(
-    filter?: MexBankAccountFilter
-  ): AsyncGenerator<MexBankAccount, void, undefined> {
-    const scopedFilter = this.applyScopeToFilter(filter);
-    return this.createIterator<MexBankAccount>({ filter: scopedFilter });
-  }
-
-  // ─────────────────────────────────────────────────────────────────
-  // Batch Operations (override return types)
-  // ─────────────────────────────────────────────────────────────────
-
-  override async createMany(
-    accounts: CreateBankAccountInput[],
-    options?: { atomic?: true }
-  ): Promise<AtomicBatchResult<MexBankAccount>>;
-  override async createMany(
-    accounts: CreateBankAccountInput[],
-    options: { atomic: false }
-  ): Promise<PartialBatchResult<MexBankAccount>>;
-  override async createMany(
-    accounts: CreateBankAccountInput[],
-    options: BatchOptions = {}
-  ): Promise<
-    AtomicBatchResult<MexBankAccount> | PartialBatchResult<MexBankAccount>
-  > {
-    return super.createMany(accounts, options as { atomic?: true }) as Promise<
-      AtomicBatchResult<MexBankAccount> | PartialBatchResult<MexBankAccount>
-    >;
-  }
-
-  override async updateMany(
-    updates: { id: string; data: UpdateBankAccountInput }[],
-    options?: { atomic?: true }
-  ): Promise<AtomicBatchResult<MexBankAccount>>;
-  override async updateMany(
-    updates: { id: string; data: UpdateBankAccountInput }[],
-    options: { atomic: false }
-  ): Promise<PartialBatchResult<MexBankAccount>>;
-  override async updateMany(
-    updates: { id: string; data: UpdateBankAccountInput }[],
-    options: BatchOptions = {}
-  ): Promise<
-    AtomicBatchResult<MexBankAccount> | PartialBatchResult<MexBankAccount>
-  > {
-    return super.updateMany(updates, options as { atomic?: true }) as Promise<
-      AtomicBatchResult<MexBankAccount> | PartialBatchResult<MexBankAccount>
-    >;
-  }
-
-  // ─────────────────────────────────────────────────────────────────
-  // Sync Operations (override return types)
-  // ─────────────────────────────────────────────────────────────────
-
-  override async sync(
-    clientId: string,
-    items: SyncItem<CreateBankAccountInput>[],
-    options: { replaceMode: true }
-  ): Promise<SyncResult<MexBankAccount>>;
-  override async sync(
-    clientId: string,
-    items: SyncItem<UpdateBankAccountInput>[],
-    options?: { replaceMode?: boolean }
-  ): Promise<SyncResult<MexBankAccount>>;
-  override async sync(
-    clientId: string,
-    items: SyncItem<UpdateBankAccountInput | CreateBankAccountInput>[],
-    options?: { replaceMode?: boolean }
-  ): Promise<SyncResult<MexBankAccount>> {
-    return super.sync(clientId, items, options) as Promise<
-      SyncResult<MexBankAccount>
-    >;
-  }
-
-  // ─────────────────────────────────────────────────────────────────
-  // Convenience Methods (override return types)
-  // ─────────────────────────────────────────────────────────────────
-
-  override async setPrimary(id: string): Promise<MexBankAccount> {
-    return super.setPrimary(id) as Promise<MexBankAccount>;
-  }
-
-  override async activate(id: string): Promise<MexBankAccount> {
-    return super.activate(id) as Promise<MexBankAccount>;
-  }
-
-  override async deactivate(id: string): Promise<MexBankAccount> {
-    return super.deactivate(id) as Promise<MexBankAccount>;
-  }
-
-  override async getPrimary(clientId: string): Promise<MexBankAccount | null> {
-    return super.getPrimary(clientId) as Promise<MexBankAccount | null>;
-  }
-
-  // ─────────────────────────────────────────────────────────────────
-  // Protected Helpers
-  // ─────────────────────────────────────────────────────────────────
-
-  /**
-   * Transforms flattened MX filter to nested API format.
-   *
-   * Mexico-specific filter fields (clabe, codigoBanco, codigoPlaza) are stored
-   * in `jurisdictions.MX`. Base fields pass through unchanged.
-   */
-  protected applyScopeToFilter(filter?: MexBankAccountFilter): BankAccountFilter {
-    if (!filter) return {};
-
-    const { clabe, codigoBanco, codigoPlaza, ...baseFields } = filter;
-
-    const hasMexFields =
-      clabe !== undefined ||
-      codigoBanco !== undefined ||
-      codigoPlaza !== undefined;
-
-    if (!hasMexFields) {
-      return baseFields as BankAccountFilter;
-    }
-
-    const mexData: Record<string, unknown> = {};
-    if (clabe !== undefined) mexData.clabe = clabe;
-    if (codigoBanco !== undefined) mexData.codigoBanco = codigoBanco;
-    if (codigoPlaza !== undefined) mexData.codigoPlaza = codigoPlaza;
-
-    return {
-      ...baseFields,
-      jurisdictions: { MX: mexData },
-    } as BankAccountFilter;
-  }
-
-  /**
-   * Transforms a flattened MexBankAccountSort to nested BankAccountSort format.
-   *
-   * Maps flattened field names to their full API paths.
-   *
-   * Note: Uses unknown parameter to allow derived classes to override with their own sort types.
-   */
-  protected applyScopeToSort(sort?: TSort): BankAccountSort | undefined {
-    if (!sort || !Array.isArray(sort) || sort.length === 0) {
-      return undefined;
-    }
-    return transformSort(sort as MexBankAccountSort, mexBankAccountFieldMapping);
-  }
-
-  protected override instantiate(data: BankAccountData): MexBankAccount {
-    return new MexBankAccount(data);
-  }
-}