@artu-ai/compliance-sdk 0.2.0 → 0.4.0

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

@@ -23,7 +23,7 @@ import type {
   ValidationResult,
   GenerateResult,
   SubmissionResult,
-  MexAVIValidateInput,
+  AviReportDefaultsInput,
   SubmitAVIReportInput,
 } from "@artu-ai/shared";
 import {
@@ -32,12 +32,20 @@ import {
   updateAVIReportInputSchema,
   createAVIReportItemInputSchema,
   updateAVIReportItemInputSchema,
-  mexAviValidateInputSchema,
+  aviDefaultsInputSchema,
   submitAVIReportInputSchema,
+  transformSort,
+  aviReportFieldMapping,
+} from "@artu-ai/shared";
+import type {
+  AVIReportFilter,
+  AVIReportSort,
+  AVIReportItemFilter,
+  ReportSort,
+  ReportItemFilter,
+  ReportItemSort,
 } from "@artu-ai/shared";
-import type { AVIReportFilter } from "@artu-ai/shared";
 import { MexReportsResource } from "../../reports";
-import { type ReportItemFilter } from "../../../reports";
 import { type BatchOptions } from "../../../clients";
 import {
   MexAVIReport,
@@ -70,7 +78,7 @@ import {
  * console.log(report.mesReportado);
  * ```
  */
-export class AVIReportsResource extends MexReportsResource {
+export class AVIReportsResource extends MexReportsResource<AVIReportSort, AviReportDefaultsInput> {
   // ─────────────────────────────────────────────────────────────────
   // Report CRUD
   // ─────────────────────────────────────────────────────────────────
@@ -127,14 +135,16 @@ export class AVIReportsResource extends MexReportsResource {
    * Accepts flattened AVI filter (future AVI-specific report fields at root level).
    */
   async list(
-    options?: ListOptions<AVIReportFilter>
+    options?: ListOptions<AVIReportFilter, AVIReportSort>
   ): Promise<PaginatedResponse<MexAVIReport>> {
     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 AVIReportsResource extends MexReportsResource {
 
   async listItems(
     reportId: string,
-    options?: ListOptions<ReportItemFilter>
+    options?: ListOptions<AVIReportItemFilter, ReportItemSort>
   ): Promise<PaginatedResponse<MexAVIReportItem>> {
+    // Transform flattened AVI 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 AVIReportsResource extends MexReportsResource {
     };
   }
 
+  /**
+   * Transforms a flattened AVIReportItemFilter to nested ReportItemFilter format.
+   */
+  protected applyScopeToItemFilter(
+    filter?: AVIReportItemFilter
+  ): ReportItemFilter | undefined {
+    if (!filter) return undefined;
+
+    const { alertType, alertDescription, ...baseFields } = filter;
+
+    // If no AVI-specific fields, return base filter as-is
+    if (alertType === undefined && alertDescription === undefined) {
+      return baseFields as ReportItemFilter;
+    }
+
+    // Build nested filter structure
+    const aviFilter: Record<string, unknown> = {};
+    if (alertType !== undefined) aviFilter.alertType = alertType;
+    if (alertDescription !== undefined) aviFilter.alertDescription = alertDescription;
+
+    return {
+      ...baseFields,
+      jurisdictions: {
+        MX: {
+          actividadVulnerable: {
+            AVI: aviFilter,
+          },
+        },
+      },
+    } as ReportItemFilter;
+  }
+
   async addItems(
     reportId: string,
     items: CreateAVIReportItemInput[]
@@ -336,24 +382,29 @@ export class AVIReportsResource extends MexReportsResource {
   /**
    * Validates an AVI report.
    *
-   * Uses AVI-scoped validation input (jurisdiction and activity default automatically).
+   * Uses AVI-scoped validation input (jurisdiction and activity are implicit).
+   *
+   * @param reportId - The report ID to validate
+   * @param defaults - AVI report defaults including rfc, platformDomain, alertType, etc.
    *
    * @example
    * ```typescript
-   * const result = await aviSdk.reports.validateReport({
-   *   reportId: report.id,
-   *   defaults: {
-   *     rfc: "ABC200101XXX",
-   *     platformDomain: "https://example.com",
-   *   },
+   * const result = await aviSdk.reports.validateReport(report.id, {
+   *   rfc: "ABC200101XXX",
+   *   platformDomain: "https://example.com",
+   *   alertType: "100",
    * });
    * ```
    */
   override async validateReport(
-    input: MexAVIValidateInput
+    reportId: string,
+    defaults: AviReportDefaultsInput
   ): Promise<ValidationResult> {
-    const validated = this.validate(mexAviValidateInputSchema, input);
-    return this.execute(() => this.trpc.reports.validate.mutate(validated));
+    const validated = this.validate(aviDefaultsInputSchema, defaults);
+    const nestedInput = this.transformAviDefaultsToNested(reportId, validated);
+    return this.execute(() =>
+      this.trpc.reports.validate.mutate(nestedInput as Parameters<typeof this.trpc.reports.validate.mutate>[0])
+    );
   }
 
   // ─────────────────────────────────────────────────────────────────
@@ -365,23 +416,30 @@ export class AVIReportsResource extends MexReportsResource {
    *
    * Uses the same input as validateReport.
    *
+   * @param reportId - The report ID to generate XML for
+   * @param defaults - AVI report defaults including rfc, platformDomain, alertType, etc.
+   *
    * @example
    * ```typescript
-   * const result = await aviSdk.reports.generateReport({
-   *   reportId: report.id,
-   *   defaults: {
-   *     rfc: "ABC200101XXX",
-   *     platformDomain: "https://example.com",
-   *   },
+   * const result = await aviSdk.reports.generateReport(report.id, {
+   *   rfc: "ABC200101XXX",
+   *   platformDomain: "https://example.com",
+   *   alertType: "100",
    * });
    * console.log(result.xml);
    * ```
    */
   override async generateReport(
-    input: MexAVIValidateInput
+    reportId: string,
+    defaults: AviReportDefaultsInput
   ): Promise<GenerateResult> {
-    const validated = this.validate(mexAviValidateInputSchema, input);
-    return this.execute(() => this.trpc.reports.generate.mutate(validated));
+    const validated = this.validate(aviDefaultsInputSchema, defaults);
+    const nestedInput = this.transformAviDefaultsToNested(reportId, validated);
+    return this.execute(() =>
+      this.trpc.reports.generate.mutate(
+        nestedInput as Parameters<typeof this.trpc.reports.generate.mutate>[0]
+      )
+    );
   }
 
   // ─────────────────────────────────────────────────────────────────
@@ -430,6 +488,18 @@ export class AVIReportsResource extends MexReportsResource {
   // Protected Helpers
   // ─────────────────────────────────────────────────────────────────
 
+  /**
+   * Transforms a flattened AVIReportSort to nested ReportSort format.
+   *
+   * Maps flattened field names to their full API paths.
+   */
+  protected override applyScopeToSort(sort?: AVIReportSort): ReportSort | undefined {
+    if (!sort || sort.length === 0) {
+      return undefined;
+    }
+    return transformSort(sort, aviReportFieldMapping);
+  }
+
   protected override transformToNested(
     data: CreateAVIReportInput
   ): CreateReportInput {
@@ -510,4 +580,30 @@ export class AVIReportsResource extends MexReportsResource {
       },
     } as UpdateReportItemInput;
   }
+
+  /**
+   * Transforms AVI defaults to nested API format for validate/generate.
+   */
+  protected transformAviDefaultsToNested(
+    reportId: string,
+    defaults: AviReportDefaultsInput
+  ): { reportId: string; jurisdictions: unknown } {
+    const { rfc, collegiateEntityCode, exempt, priority, ...aviFields } =
+      defaults;
+
+    return {
+      reportId,
+      jurisdictions: {
+        MX: {
+          actividadVulnerable: {
+            rfc,
+            collegiateEntityCode,
+            exempt,
+            priority,
+            [CodigoActividad.AVI]: aviFields,
+          },
+        },
+      },
+    };
+  }
 }

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

@@ -10,6 +10,7 @@ import { z } from "zod";
 import type {
   CreateTransactionInput,
   UpdateTransactionInput,
+  TransactionSort,
   ListOptions,
   PaginatedResponse,
   CreateAVITransactionInput,
@@ -18,6 +19,7 @@ import type {
   PartialBatchResult,
   RelatedClient,
   AVITransactionFilter,
+  AVITransactionSort,
 } from "@artu-ai/shared";
 import {
   Jurisdiction,
@@ -25,6 +27,8 @@ import {
   createAVITransactionInputSchema,
   updateAVITransactionInputSchema,
   ClientRole,
+  transformSort,
+  aviTransactionFieldMapping,
 } from "@artu-ai/shared";
 import { MexTransactionsResource } from "../../transactions";
 import { type BatchOptions } from "../../../clients";
@@ -59,7 +63,7 @@ import { MexAVITransaction, type TransactionData } from "../../../../models";
  * console.log(txn.operationType);
  * ```
  */
-export class AVITransactionsResource extends MexTransactionsResource {
+export class AVITransactionsResource extends MexTransactionsResource<AVITransactionSort> {
   // ─────────────────────────────────────────────────────────────────
   // CRUD Operations
   // ─────────────────────────────────────────────────────────────────
@@ -115,14 +119,16 @@ export class AVITransactionsResource extends MexTransactionsResource {
    * Accepts flattened AVI filter (future AVI-specific transaction fields at root level).
    */
   async list(
-    options?: ListOptions<AVITransactionFilter>
+    options?: ListOptions<AVITransactionFilter, AVITransactionSort>
   ): Promise<PaginatedResponse<MexAVITransaction>> {
     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,
       })
     );
 
@@ -300,6 +306,18 @@ export class AVITransactionsResource extends MexTransactionsResource {
   // Protected Helpers
   // ─────────────────────────────────────────────────────────────────
 
+  /**
+   * Transforms a flattened AVITransactionSort to nested TransactionSort format.
+   *
+   * Maps flattened field names to their full API paths.
+   */
+  protected override applyScopeToSort(sort?: AVITransactionSort): TransactionSort | undefined {
+    if (!sort || sort.length === 0) {
+      return undefined;
+    }
+    return transformSort(sort, aviTransactionFieldMapping);
+  }
+
   protected override transformToNested(
     data: CreateAVITransactionInput
   ): CreateTransactionInput {

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

@@ -29,13 +29,17 @@ import type {
   SyncItem,
   SyncResult,
   JYSClientFilter,
+  JYSClientSort,
 } from "@artu-ai/shared";
 import {
   CodigoActividad,
   createJYSClientInputSchema,
   updateJYSClientInputSchema,
   linkedClientSchema,
+  transformSort,
+  jysClientFieldMapping,
 } 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 MexJYSClient
  * ```
  */
-export class JYSClientsResource extends MexClientsResource {
+export class JYSClientsResource extends MexClientsResource<JYSClientSort> {
   // ─────────────────────────────────────────────────────────────────
   // CRUD Operations
   // ─────────────────────────────────────────────────────────────────
@@ -126,14 +130,16 @@ export class JYSClientsResource extends MexClientsResource {
    * transforms to nested format before calling the API.
    */
   async list(
-    options?: ListOptions<JYSClientFilter> & { includePrimaryContacts?: boolean }
+    options?: ListOptions<JYSClientFilter, JYSClientSort> & { includePrimaryContacts?: boolean }
   ): Promise<PaginatedResponse<MexJYSClient>> {
     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,
       })
     );
 
@@ -385,6 +391,18 @@ export class JYSClientsResource extends MexClientsResource {
   // Protected Helpers
   // ─────────────────────────────────────────────────────────────────
 
+  /**
+   * Transforms a flattened JYSClientSort to nested ClientSort format.
+   *
+   * Maps flattened field names to their full API paths.
+   */
+  protected override applyScopeToSort(sort?: JYSClientSort): ClientSort | undefined {
+    if (!sort || sort.length === 0) {
+      return undefined;
+    }
+    return transformSort(sort, jysClientFieldMapping);
+  }
+
   /**
    * Transforms JYS input to nested API format.
    * JYS has no additional fields, but we add the JYS activity marker.

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

@@ -20,7 +20,7 @@ import type {
   PaginatedResponse,
   AtomicBatchResult,
   PartialBatchResult,
-  MexJYSValidateInput,
+  JysReportDefaultsInput,
   ValidationResult,
   GenerateResult,
   SubmissionResult,
@@ -32,12 +32,20 @@ import {
   updateJYSReportInputSchema,
   createJYSReportItemInputSchema,
   updateJYSReportItemInputSchema,
-  mexJysValidateInputSchema,
+  jysDefaultsInputSchema,
   submitJYSSubmissionInputSchema,
+  transformSort,
+  jysReportFieldMapping,
+} from "@artu-ai/shared";
+import type {
+  JYSReportFilter,
+  JYSReportSort,
+  JYSReportItemFilter,
+  ReportSort,
+  ReportItemFilter,
+  ReportItemSort,
 } from "@artu-ai/shared";
-import type { JYSReportFilter } from "@artu-ai/shared";
 import { MexReportsResource } from "../../reports";
-import { type ReportItemFilter } from "../../../reports";
 import { type BatchOptions } from "../../../clients";
 import {
   MexJYSReport,
@@ -70,7 +78,7 @@ import {
  * console.log(report.mesReportado);
  * ```
  */
-export class JYSReportsResource extends MexReportsResource {
+export class JYSReportsResource extends MexReportsResource<JYSReportSort, JysReportDefaultsInput> {
   // ─────────────────────────────────────────────────────────────────
   // Report CRUD
   // ─────────────────────────────────────────────────────────────────
@@ -127,14 +135,16 @@ export class JYSReportsResource extends MexReportsResource {
    * Accepts flattened JYS filter (future JYS-specific report fields at root level).
    */
   async list(
-    options?: ListOptions<JYSReportFilter>
+    options?: ListOptions<JYSReportFilter, JYSReportSort>
   ): Promise<PaginatedResponse<MexJYSReport>> {
     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 JYSReportsResource extends MexReportsResource {
 
   async listItems(
     reportId: string,
-    options?: ListOptions<ReportItemFilter>
+    options?: ListOptions<JYSReportItemFilter, ReportItemSort>
   ): Promise<PaginatedResponse<MexJYSReportItem>> {
+    // Transform flattened JYS 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 JYSReportsResource extends MexReportsResource {
     };
   }
 
+  /**
+   * Transforms a flattened JYSReportItemFilter to nested ReportItemFilter format.
+   */
+  protected applyScopeToItemFilter(
+    filter?: JYSReportItemFilter
+  ): ReportItemFilter | undefined {
+    if (!filter) return undefined;
+
+    const { alertType, alertDescription, ...baseFields } = filter;
+
+    // If no JYS-specific fields, return base filter as-is
+    if (alertType === undefined && alertDescription === undefined) {
+      return baseFields as ReportItemFilter;
+    }
+
+    // Build nested filter structure
+    const jysFilter: Record<string, unknown> = {};
+    if (alertType !== undefined) jysFilter.alertType = alertType;
+    if (alertDescription !== undefined) jysFilter.alertDescription = alertDescription;
+
+    return {
+      ...baseFields,
+      jurisdictions: {
+        MX: {
+          actividadVulnerable: {
+            JYS: jysFilter,
+          },
+        },
+      },
+    } as ReportItemFilter;
+  }
+
   async addItems(
     reportId: string,
     items: CreateJYSReportItemInput[]
@@ -338,19 +384,28 @@ export class JYSReportsResource extends MexReportsResource {
    *
    * Uses JYS-scoped validation input (jurisdiction and activity are implicit).
    *
+   * @param reportId - The report ID to validate
+   * @param defaults - JYS report defaults including rfc, alertType, etc.
+   *
    * @example
    * ```typescript
-   * const result = await jysSdk.reports.validateReport({
-   *   reportId: report.id,
-   *   defaults: { rfc: "ABC200101XXX" },
+   * const result = await jysSdk.reports.validateReport(report.id, {
+   *   rfc: "ABC200101XXX",
+   *   alertType: "100",
    * });
    * ```
    */
   override async validateReport(
-    input: MexJYSValidateInput
+    reportId: string,
+    defaults: JysReportDefaultsInput
   ): Promise<ValidationResult> {
-    const validated = this.validate(mexJysValidateInputSchema, input);
-    return this.execute(() => this.trpc.reports.validate.mutate(validated));
+    const validated = this.validate(jysDefaultsInputSchema, defaults);
+    const nestedInput = this.transformJysDefaultsToNested(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 JYSReportsResource extends MexReportsResource {
    * Generates XML for a JYS report.
    *
    * Uses the same input as validateReport.
+   *
+   * @param reportId - The report ID to generate XML for
+   * @param defaults - JYS report defaults including rfc, alertType, etc.
    */
   override async generateReport(
-    input: MexJYSValidateInput
+    reportId: string,
+    defaults: JysReportDefaultsInput
   ): Promise<GenerateResult> {
-    const validated = this.validate(mexJysValidateInputSchema, input);
-    return this.execute(() => this.trpc.reports.generate.mutate(validated));
+    const validated = this.validate(jysDefaultsInputSchema, defaults);
+    const nestedInput = this.transformJysDefaultsToNested(reportId, validated);
+    return this.execute(() =>
+      this.trpc.reports.generate.mutate(
+        nestedInput as Parameters<typeof this.trpc.reports.generate.mutate>[0]
+      )
+    );
   }
 
   // ─────────────────────────────────────────────────────────────────
@@ -406,6 +470,18 @@ export class JYSReportsResource extends MexReportsResource {
   // Protected Helpers
   // ─────────────────────────────────────────────────────────────────
 
+  /**
+   * Transforms a flattened JYSReportSort to nested ReportSort format.
+   *
+   * Maps flattened field names to their full API paths.
+   */
+  protected override applyScopeToSort(sort?: JYSReportSort): ReportSort | undefined {
+    if (!sort || sort.length === 0) {
+      return undefined;
+    }
+    return transformSort(sort, jysReportFieldMapping);
+  }
+
   protected override transformToNested(
     data: CreateJYSReportInput
   ): CreateReportInput {
@@ -486,4 +562,30 @@ export class JYSReportsResource extends MexReportsResource {
       },
     } as UpdateReportItemInput;
   }
+
+  /**
+   * Transforms JYS defaults to nested API format for validate/generate.
+   */
+  protected transformJysDefaultsToNested(
+    reportId: string,
+    defaults: JysReportDefaultsInput
+  ): { reportId: string; jurisdictions: unknown } {
+    const { rfc, collegiateEntityCode, exempt, priority, ...jysFields } =
+      defaults;
+
+    return {
+      reportId,
+      jurisdictions: {
+        MX: {
+          actividadVulnerable: {
+            rfc,
+            collegiateEntityCode,
+            exempt,
+            priority,
+            [CodigoActividad.JYS]: jysFields,
+          },
+        },
+      },
+    };
+  }
 }

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

@@ -18,6 +18,7 @@ import type {
   PartialBatchResult,
   RelatedClient,
   JYSTransactionFilter,
+  JYSTransactionSort,
 } from "@artu-ai/shared";
 import {
   Jurisdiction,
@@ -25,7 +26,10 @@ import {
   createJYSTransactionInputSchema,
   updateJYSTransactionInputSchema,
   ClientRole,
+  transformSort,
+  jysTransactionFieldMapping,
 } from "@artu-ai/shared";
+import type { TransactionSort } from "@artu-ai/shared";
 import { MexTransactionsResource } from "../../transactions";
 import { type BatchOptions } from "../../../clients";
 import { MexJYSTransaction, type TransactionData } from "../../../../models";
@@ -62,7 +66,7 @@ import { MexJYSTransaction, type TransactionData } from "../../../../models";
  * console.log(txn.settlementType);
  * ```
  */
-export class JYSTransactionsResource extends MexTransactionsResource {
+export class JYSTransactionsResource extends MexTransactionsResource<JYSTransactionSort> {
   // ─────────────────────────────────────────────────────────────────
   // CRUD Operations
   // ─────────────────────────────────────────────────────────────────
@@ -118,14 +122,16 @@ export class JYSTransactionsResource extends MexTransactionsResource {
    * Accepts flattened JYS filter (future JYS-specific transaction fields at root level).
    */
   async list(
-    options?: ListOptions<JYSTransactionFilter>
+    options?: ListOptions<JYSTransactionFilter, JYSTransactionSort>
   ): Promise<PaginatedResponse<MexJYSTransaction>> {
     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,
       })
     );
 
@@ -303,6 +309,18 @@ export class JYSTransactionsResource extends MexTransactionsResource {
   // Protected Helpers
   // ─────────────────────────────────────────────────────────────────
 
+  /**
+   * Transforms a flattened JYSTransactionSort to nested TransactionSort format.
+   *
+   * Maps flattened field names to their full API paths.
+   */
+  protected override applyScopeToSort(sort?: JYSTransactionSort): TransactionSort | undefined {
+    if (!sort || sort.length === 0) {
+      return undefined;
+    }
+    return transformSort(sort, jysTransactionFieldMapping);
+  }
+
   protected override transformToNested(
     data: CreateJYSTransactionInput
   ): CreateTransactionInput {