@artu-ai/compliance-sdk 0.2.0 → 0.3.0

package/src/resources/mex/actividad-vulnerable/tsc/clients.ts

@@ -29,13 +29,17 @@ import type {
   SyncItem,
   SyncResult,
   TSCClientFilter,
+  TSCClientSort,
 } from "@artu-ai/shared";
 import {
   CodigoActividad,
   createTSCClientInputSchema,
   updateTSCClientInputSchema,
   linkedClientSchema,
+  transformSort,
+  tscClientFieldMapping,
 } from "@artu-ai/shared";
+import type { ClientSort } from "@artu-ai/shared";
 import { MexClientsResource } from "../../clients";
 import { type BatchOptions, type ClientIncludeMap } from "../../../clients";
 import {
@@ -72,7 +76,7 @@ import {
  * // Returns MexTSCClient
  * ```
  */
-export class TSCClientsResource extends MexClientsResource {
+export class TSCClientsResource extends MexClientsResource<TSCClientSort> {
   // ─────────────────────────────────────────────────────────────────
   // CRUD Operations
   // ─────────────────────────────────────────────────────────────────
@@ -126,14 +130,16 @@ export class TSCClientsResource extends MexClientsResource {
    * transforms to nested format before calling the API.
    */
   async list(
-    options?: ListOptions<TSCClientFilter> & { includePrimaryContacts?: boolean }
+    options?: ListOptions<TSCClientFilter, TSCClientSort> & { includePrimaryContacts?: boolean }
   ): Promise<PaginatedResponse<MexTSCClient>> {
     const scopedFilter = this.applyScopeToFilter(options?.filter);
+    const scopedSort = this.applyScopeToSort(options?.sort);
 
     const response = await this.execute(() =>
       this.trpc.clients.list.query({
         ...options,
         filter: scopedFilter,
+        sort: scopedSort,
       })
     );
 
@@ -424,4 +430,16 @@ export class TSCClientsResource extends MexClientsResource {
   protected override instantiate(data: ClientData): MexTSCClient {
     return new MexTSCClient(data);
   }
+
+  /**
+   * Transforms a flattened TSCClientSort to nested ClientSort format.
+   *
+   * Maps flattened field names to their full API paths using TSC-specific field mapping.
+   */
+  protected override applyScopeToSort(sort?: TSCClientSort): ClientSort | undefined {
+    if (!sort || sort.length === 0) {
+      return undefined;
+    }
+    return transformSort(sort, tscClientFieldMapping);
+  }
 }

package/src/resources/mex/actividad-vulnerable/tsc/reports.ts

@@ -20,7 +20,7 @@ import type {
   PaginatedResponse,
   AtomicBatchResult,
   PartialBatchResult,
-  MexTSCValidateInput,
+  TscReportDefaultsInput,
   ValidationResult,
   GenerateResult,
   SubmissionResult,
@@ -32,12 +32,20 @@ import {
   updateTSCReportInputSchema,
   createTSCReportItemInputSchema,
   updateTSCReportItemInputSchema,
-  mexTscValidateInputSchema,
+  tscDefaultsInputSchema,
   submitTSCSubmissionInputSchema,
+  transformSort,
+  tscReportFieldMapping,
+} from "@artu-ai/shared";
+import type {
+  TSCReportFilter,
+  TSCReportSort,
+  TSCReportItemFilter,
+  ReportSort,
+  ReportItemFilter,
+  ReportItemSort,
 } from "@artu-ai/shared";
-import type { TSCReportFilter } from "@artu-ai/shared";
 import { MexReportsResource } from "../../reports";
-import { type ReportItemFilter } from "../../../reports";
 import { type BatchOptions } from "../../../clients";
 import {
   MexTSCReport,
@@ -70,7 +78,7 @@ import {
  * console.log(report.mesReportado);
  * ```
  */
-export class TSCReportsResource extends MexReportsResource {
+export class TSCReportsResource extends MexReportsResource<TSCReportSort, TscReportDefaultsInput> {
   // ─────────────────────────────────────────────────────────────────
   // Report CRUD
   // ─────────────────────────────────────────────────────────────────
@@ -127,14 +135,16 @@ export class TSCReportsResource extends MexReportsResource {
    * Accepts flattened TSC filter (future TSC-specific report fields at root level).
    */
   async list(
-    options?: ListOptions<TSCReportFilter>
+    options?: ListOptions<TSCReportFilter, TSCReportSort>
   ): Promise<PaginatedResponse<MexTSCReport>> {
     const scopedFilter = this.applyScopeToFilter(options?.filter);
+    const scopedSort = this.applyScopeToSort(options?.sort);
 
     const response = await this.execute(() =>
       this.trpc.reports.list.query({
         ...options,
         filter: scopedFilter,
+        sort: scopedSort,
       })
     );
 
@@ -294,12 +304,16 @@ export class TSCReportsResource extends MexReportsResource {
 
   async listItems(
     reportId: string,
-    options?: ListOptions<ReportItemFilter>
+    options?: ListOptions<TSCReportItemFilter, ReportItemSort>
   ): Promise<PaginatedResponse<MexTSCReportItem>> {
+    // Transform flattened TSC filter to nested format
+    const scopedFilter = this.applyScopeToItemFilter(options?.filter);
+
     const response = await this.execute(() =>
       this.trpc.reports.listItems.query({
         reportId,
         ...options,
+        filter: scopedFilter,
       })
     );
 
@@ -309,6 +323,38 @@ export class TSCReportsResource extends MexReportsResource {
     };
   }
 
+  /**
+   * Transforms a flattened TSCReportItemFilter to nested ReportItemFilter format.
+   */
+  protected applyScopeToItemFilter(
+    filter?: TSCReportItemFilter
+  ): ReportItemFilter | undefined {
+    if (!filter) return undefined;
+
+    const { alertType, alertDescription, ...baseFields } = filter;
+
+    // If no TSC-specific fields, return base filter as-is
+    if (alertType === undefined && alertDescription === undefined) {
+      return baseFields as ReportItemFilter;
+    }
+
+    // Build nested filter structure
+    const tscFilter: Record<string, unknown> = {};
+    if (alertType !== undefined) tscFilter.alertType = alertType;
+    if (alertDescription !== undefined) tscFilter.alertDescription = alertDescription;
+
+    return {
+      ...baseFields,
+      jurisdictions: {
+        MX: {
+          actividadVulnerable: {
+            TSC: tscFilter,
+          },
+        },
+      },
+    } as ReportItemFilter;
+  }
+
   async addItems(
     reportId: string,
     items: CreateTSCReportItemInput[]
@@ -338,19 +384,28 @@ export class TSCReportsResource extends MexReportsResource {
    *
    * Uses TSC-scoped validation input (jurisdiction and activity are implicit).
    *
+   * @param reportId - The report ID to validate
+   * @param defaults - TSC report defaults including rfc, alertType, etc.
+   *
    * @example
    * ```typescript
-   * const result = await tscSdk.reports.validateReport({
-   *   reportId: report.id,
-   *   defaults: { rfc: "ABC200101XXX" },
+   * const result = await tscSdk.reports.validateReport(report.id, {
+   *   rfc: "ABC200101XXX",
+   *   alertType: "100",
    * });
    * ```
    */
   override async validateReport(
-    input: MexTSCValidateInput
+    reportId: string,
+    defaults: TscReportDefaultsInput
   ): Promise<ValidationResult> {
-    const validated = this.validate(mexTscValidateInputSchema, input);
-    return this.execute(() => this.trpc.reports.validate.mutate(validated));
+    const validated = this.validate(tscDefaultsInputSchema, defaults);
+    const nestedInput = this.transformTscDefaultsToNested(reportId, validated);
+    return this.execute(() =>
+      this.trpc.reports.validate.mutate(
+        nestedInput as Parameters<typeof this.trpc.reports.validate.mutate>[0]
+      )
+    );
   }
 
   // ─────────────────────────────────────────────────────────────────
@@ -361,12 +416,21 @@ export class TSCReportsResource extends MexReportsResource {
    * Generates XML for a TSC report.
    *
    * Uses the same input as validateReport.
+   *
+   * @param reportId - The report ID to generate XML for
+   * @param defaults - TSC report defaults including rfc, alertType, etc.
    */
   override async generateReport(
-    input: MexTSCValidateInput
+    reportId: string,
+    defaults: TscReportDefaultsInput
   ): Promise<GenerateResult> {
-    const validated = this.validate(mexTscValidateInputSchema, input);
-    return this.execute(() => this.trpc.reports.generate.mutate(validated));
+    const validated = this.validate(tscDefaultsInputSchema, defaults);
+    const nestedInput = this.transformTscDefaultsToNested(reportId, validated);
+    return this.execute(() =>
+      this.trpc.reports.generate.mutate(
+        nestedInput as Parameters<typeof this.trpc.reports.generate.mutate>[0]
+      )
+    );
   }
 
   // ─────────────────────────────────────────────────────────────────
@@ -486,4 +550,42 @@ export class TSCReportsResource extends MexReportsResource {
       },
     } as UpdateReportItemInput;
   }
+
+  /**
+   * Transforms a flattened TSCReportSort to nested ReportSort format.
+   *
+   * Maps flattened field names to their full API paths using TSC-specific field mapping.
+   */
+  protected override applyScopeToSort(sort?: TSCReportSort): ReportSort | undefined {
+    if (!sort || sort.length === 0) {
+      return undefined;
+    }
+    return transformSort(sort, tscReportFieldMapping);
+  }
+
+  /**
+   * Transforms TSC defaults to nested API format for validate/generate.
+   */
+  protected transformTscDefaultsToNested(
+    reportId: string,
+    defaults: TscReportDefaultsInput
+  ): { reportId: string; jurisdictions: unknown } {
+    const { rfc, collegiateEntityCode, exempt, priority, ...tscFields } =
+      defaults;
+
+    return {
+      reportId,
+      jurisdictions: {
+        MX: {
+          actividadVulnerable: {
+            rfc,
+            collegiateEntityCode,
+            exempt,
+            priority,
+            [CodigoActividad.TSC]: tscFields,
+          },
+        },
+      },
+    };
+  }
 }

package/src/resources/mex/actividad-vulnerable/tsc/transactions.ts

@@ -18,6 +18,7 @@ import type {
   PartialBatchResult,
   RelatedClient,
   TSCTransactionFilter,
+  TSCTransactionSort,
 } from "@artu-ai/shared";
 import {
   Jurisdiction,
@@ -25,7 +26,10 @@ import {
   createTSCTransactionInputSchema,
   updateTSCTransactionInputSchema,
   ClientRole,
+  transformSort,
+  tscTransactionFieldMapping,
 } from "@artu-ai/shared";
+import type { TransactionSort } from "@artu-ai/shared";
 import { MexTransactionsResource } from "../../transactions";
 import { type BatchOptions } from "../../../clients";
 import { MexTSCTransaction, type TransactionData } from "../../../../models";
@@ -59,7 +63,7 @@ import { MexTSCTransaction, type TransactionData } from "../../../../models";
  * console.log(txn.cardType);
  * ```
  */
-export class TSCTransactionsResource extends MexTransactionsResource {
+export class TSCTransactionsResource extends MexTransactionsResource<TSCTransactionSort> {
   // ─────────────────────────────────────────────────────────────────
   // CRUD Operations
   // ─────────────────────────────────────────────────────────────────
@@ -115,14 +119,16 @@ export class TSCTransactionsResource extends MexTransactionsResource {
    * Accepts flattened TSC filter (future TSC-specific transaction fields at root level).
    */
   async list(
-    options?: ListOptions<TSCTransactionFilter>
+    options?: ListOptions<TSCTransactionFilter, TSCTransactionSort>
   ): Promise<PaginatedResponse<MexTSCTransaction>> {
     const scopedFilter = this.applyScopeToFilter(options?.filter);
+    const scopedSort = this.applyScopeToSort(options?.sort);
 
     const response = await this.execute(() =>
       this.trpc.transactions.list.query({
         ...options,
         filter: scopedFilter,
+        sort: scopedSort,
       })
     );
 
@@ -383,4 +389,16 @@ export class TSCTransactionsResource extends MexTransactionsResource {
   protected override instantiate(data: TransactionData): MexTSCTransaction {
     return new MexTSCTransaction(data);
   }
+
+  /**
+   * Transforms a flattened TSCTransactionSort to nested TransactionSort format.
+   *
+   * Maps flattened field names to their full API paths using TSC-specific field mapping.
+   */
+  protected override applyScopeToSort(sort?: TSCTransactionSort): TransactionSort | undefined {
+    if (!sort || sort.length === 0) {
+      return undefined;
+    }
+    return transformSort(sort, tscTransactionFieldMapping);
+  }
 }

package/src/resources/mex/addresses.ts

@@ -13,6 +13,7 @@ import type {
   CreateAddressInput,
   UpdateAddressInput,
   AddressFilter,
+  AddressSort,
   AddressType,
   ListOptions,
   PaginatedResponse,
@@ -23,11 +24,14 @@ import type {
   SyncItem,
   SyncResult,
   MexAddressFilter,
+  MexAddressSort,
 } from "@artu-ai/shared";
 import {
   createMexAddressInputSchema,
   updateMexAddressInputSchema,
   replaceSyncItemSchema,
+  transformSort,
+  mexAddressFieldMapping,
 } from "@artu-ai/shared";
 import { AddressesResource } from "../addresses";
 import { type BatchOptions } from "../clients";
@@ -71,7 +75,9 @@ import { MexAddress, type AddressData } from "../../models";
  * console.log(address.formattedMexican);
  * ```
  */
-export class MexAddressesResource extends AddressesResource {
+export class MexAddressesResource<
+  TSort = MexAddressSort,
+> extends AddressesResource<TSort> {
   // ─────────────────────────────────────────────────────────────────
   // CRUD Operations (override with flattened input types)
   // ─────────────────────────────────────────────────────────────────
@@ -137,14 +143,16 @@ export class MexAddressesResource extends AddressesResource {
    * Accepts flattened MX filter (MX-specific fields at root level).
    */
   async list(
-    options?: ListOptions<MexAddressFilter>
+    options?: ListOptions<MexAddressFilter, TSort>
   ): Promise<PaginatedResponse<MexAddress>> {
     const scopedFilter = this.applyScopeToFilter(options?.filter);
+    const scopedSort = this.applyScopeToSort(options?.sort);
 
     const response = await this.execute(() =>
       this.trpc.addresses.list.query({
         ...options,
         filter: scopedFilter,
+        sort: scopedSort,
       })
     );
 
@@ -382,6 +390,20 @@ export class MexAddressesResource extends AddressesResource {
     } as AddressFilter;
   }
 
+  /**
+   * Transforms a flattened MexAddressSort to nested AddressSort 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): AddressSort | undefined {
+    if (!sort || !Array.isArray(sort) || sort.length === 0) {
+      return undefined;
+    }
+    return transformSort(sort as MexAddressSort, mexAddressFieldMapping);
+  }
+
   /**
    * Transforms flattened MX input to nested API format.
    *

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

@@ -9,6 +9,7 @@ import type {
   CreateBankAccountInput,
   UpdateBankAccountInput,
   BankAccountFilter,
+  BankAccountSort,
   ListOptions,
   PaginatedResponse,
   AtomicBatchResult,
@@ -16,6 +17,11 @@ import type {
   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";
@@ -51,7 +57,9 @@ import { MexBankAccount, type BankAccountData } from "../../models";
  * console.log(account.maskedClabe);     // "**************7890"
  * ```
  */
-export class MexBankAccountsResource extends BankAccountsResource {
+export class MexBankAccountsResource<
+  TSort = MexBankAccountSort,
+> extends BankAccountsResource<TSort> {
   // ─────────────────────────────────────────────────────────────────
   // CRUD Operations (override return types)
   // ─────────────────────────────────────────────────────────────────
@@ -94,14 +102,16 @@ export class MexBankAccountsResource extends BankAccountsResource {
    * Accepts flattened MX filter (MX-specific fields at root level).
    */
   async list(
-    options?: ListOptions<MexBankAccountFilter>
+    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,
       })
     );
 
@@ -253,6 +263,20 @@ export class MexBankAccountsResource extends BankAccountsResource {
     } 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);
   }

package/src/resources/mex/clients.ts

@@ -13,6 +13,7 @@ import type {
   CreateClientInput,
   UpdateClientInput,
   ClientFilter,
+  ClientSort,
   ListOptions,
   PaginatedResponse,
   CreateMexClientInput,
@@ -32,6 +33,7 @@ import type {
   SyncItem,
   SyncResult,
   MexClientFilter,
+  MexClientSort,
 } from "@artu-ai/shared";
 import {
   Jurisdiction,
@@ -45,6 +47,8 @@ import {
   createBankAccountInputSchema,
   updateBankAccountInputSchema,
   replaceSyncItemSchema,
+  transformSort,
+  mexClientFieldMapping,
 } from "@artu-ai/shared";
 import {
   ClientsResource,
@@ -96,7 +100,9 @@ import {
  * // data is MexClient[]
  * ```
  */
-export class MexClientsResource extends ClientsResource {
+export class MexClientsResource<
+  TSort = MexClientSort,
+> extends ClientsResource<TSort> {
   // ─────────────────────────────────────────────────────────────────
   // CRUD Operations (override with flattened input types)
   // ─────────────────────────────────────────────────────────────────
@@ -173,14 +179,16 @@ export class MexClientsResource extends ClientsResource {
    * ```
    */
   async list(
-    options?: ListOptions<MexClientFilter> & { includePrimaryContacts?: boolean }
+    options?: ListOptions<MexClientFilter, TSort> & { includePrimaryContacts?: boolean }
   ): Promise<PaginatedResponse<MexClient>> {
     const scopedFilter = this.applyScopeToFilter(options?.filter);
+    const scopedSort = this.applyScopeToSort(options?.sort);
 
     const response = await this.execute(() =>
       this.trpc.clients.list.query({
         ...options,
         filter: scopedFilter,
+        sort: scopedSort,
       })
     );
 
@@ -553,6 +561,21 @@ export class MexClientsResource extends ClientsResource {
     } as ClientFilter;
   }
 
+  /**
+   * Transforms a flattened MexClientSort to nested ClientSort format.
+   *
+   * Maps flattened field names (rfc, curp, actividadVulnerable.AVI.username)
+   * to their full API paths (jurisdictions.MX.rfc, etc.).
+   *
+   * Note: Uses unknown parameter to allow derived classes to override with their own sort types.
+   */
+  protected applyScopeToSort(sort?: TSort): ClientSort | undefined {
+    if (!sort || !Array.isArray(sort) || sort.length === 0) {
+      return undefined;
+    }
+    return transformSort(sort as MexClientSort, mexClientFieldMapping);
+  }
+
   /**
    * Transforms flattened MX input to nested API format.
    */