@artu-ai/compliance-sdk 0.2.0 → 0.3.0

package/dist/resources/mex/clients.js

@@ -8,7 +8,7 @@
  * - Returns MexClient models
  */
 import { z } from "zod";
-import { Jurisdiction, createMexClientInputSchema, updateMexClientInputSchema, linkedClientSchema, createMexAddressInputSchema, updateMexAddressInputSchema, createContactMethodInputSchema, updateContactMethodInputSchema, createBankAccountInputSchema, updateBankAccountInputSchema, replaceSyncItemSchema, } from "@artu-ai/shared";
+import { Jurisdiction, createMexClientInputSchema, updateMexClientInputSchema, linkedClientSchema, createMexAddressInputSchema, updateMexAddressInputSchema, createContactMethodInputSchema, updateContactMethodInputSchema, createBankAccountInputSchema, updateBankAccountInputSchema, replaceSyncItemSchema, transformSort, mexClientFieldMapping, } from "@artu-ai/shared";
 import { ClientsResource, } from "../clients";
 import { MexClient, MexAddress, MexBankAccount, ContactMethod, } from "../../models";
 // ===========================
@@ -107,9 +107,11 @@ export class MexClientsResource extends ClientsResource {
      */
     async list(options) {
         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,
         }));
         return {
             data: response.data.map((c) => this.instantiate(c)),
@@ -299,6 +301,20 @@ export class MexClientsResource extends ClientsResource {
             ...(hasMexFields && { jurisdictions: { MX: mexFilter } }),
         };
     }
+    /**
+     * 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.
+     */
+    applyScopeToSort(sort) {
+        if (!sort || !Array.isArray(sort) || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, mexClientFieldMapping);
+    }
     /**
      * Transforms flattened MX input to nested API format.
      */

package/dist/resources/mex/reports.d.ts

@@ -6,9 +6,9 @@
  * - Filters list/iterate to Mexico reports only
  * - Returns MexReport models
  */
-import type { CreateReportInput, UpdateReportInput, CreateReportItemInput, UpdateReportItemInput, CreateMexReportInput, UpdateMexReportInput, CreateMexReportItemInput, UpdateMexReportItemInput, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, MexValidateReportInput, MexSubmitReportInput, ValidationResult, GenerateResult, SubmissionResult } from "@artu-ai/shared";
-import type { ReportFilter, MexReportFilter } from "@artu-ai/shared";
-import { ReportsResource, type ReportItemFilter } from "../reports";
+import type { CreateReportInput, UpdateReportInput, CreateReportItemInput, UpdateReportItemInput, CreateMexReportInput, UpdateMexReportInput, CreateMexReportItemInput, UpdateMexReportItemInput, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, MexSubmitReportInput, ValidationResult, GenerateResult, SubmissionResult, MexReportDefaultsInput, ReportDefaultsInput } from "@artu-ai/shared";
+import type { ReportFilter, ReportSort, MexReportFilter, MexReportSort } from "@artu-ai/shared";
+import { ReportsResource, type ReportItemFilter, type ReportItemSort } from "../reports";
 import { MexReport, type ReportData, type ReportItemData } from "../../models";
 import { MexReportItem } from "../../models/mex";
 /**
@@ -39,7 +39,7 @@ import { MexReportItem } from "../../models/mex";
  * // data is MexReport[]
  * ```
  */
-export declare class MexReportsResource extends ReportsResource {
+export declare class MexReportsResource<TSort = MexReportSort, TDefaults = MexReportDefaultsInput> extends ReportsResource<TSort, TDefaults> {
     /**
      * Creates a new Mexico report with flattened input.
      */
@@ -60,7 +60,7 @@ export declare class MexReportsResource extends ReportsResource {
      * Accepts flattened MX filter (future MX-specific report fields at root level).
      * Automatically filters to reports with Mexico jurisdiction data.
      */
-    list(options?: ListOptions<MexReportFilter>): Promise<PaginatedResponse<MexReport>>;
+    list(options?: ListOptions<MexReportFilter, TSort>): Promise<PaginatedResponse<MexReport>>;
     /**
      * Iterates over Mexico reports.
      *
@@ -99,9 +99,9 @@ export declare class MexReportsResource extends ReportsResource {
      */
     updateItem(reportId: string, itemId: string, data: UpdateMexReportItemInput): Promise<MexReportItem>;
     /**
-     * Lists items in a report.
+     * Lists items in a report with filtering, sorting, and pagination.
      */
-    listItems(reportId: string, options?: ListOptions<ReportItemFilter>): Promise<PaginatedResponse<MexReportItem>>;
+    listItems(reportId: string, options?: ListOptions<ReportItemFilter, ReportItemSort>): Promise<PaginatedResponse<MexReportItem>>;
     /**
      * Adds multiple items to a report with flattened Mexico input.
      */
@@ -114,39 +114,47 @@ export declare class MexReportsResource extends ReportsResource {
      *
      * Uses Mexico-scoped validation input (jurisdiction is implicit).
      *
+     * @param reportId - The report ID to validate
+     * @param defaults - Mexico report defaults including activity-specific settings
+     *
      * @example
      * ```typescript
-     * const result = await mexSdk.reports.validateReport({
-     *   reportId: report.id,
-     *   actividadVulnerable: "AVI",
-     *   defaults: {
+     * const result = await mexSdk.reports.validateReport(report.id, {
+     *   actividadVulnerable: {
      *     rfc: "ABC200101XXX",
-     *     platformDomain: "https://example.com",
+     *     AVI: {
+     *       platformDomain: "https://example.com",
+     *       alertType: "100",
+     *     },
      *   },
      * });
      * ```
      */
-    validateReport(input: MexValidateReportInput): Promise<ValidationResult>;
+    validateReport(reportId: string, defaults: TDefaults): Promise<ValidationResult>;
     /**
      * Generates XML for a Mexico report.
      *
      * Uses the same input as validateReport since generation requires
      * the same transformation and defaults.
      *
+     * @param reportId - The report ID to generate XML for
+     * @param defaults - Mexico report defaults including activity-specific settings
+     *
      * @example
      * ```typescript
-     * const result = await mexSdk.reports.generateReport({
-     *   reportId: report.id,
-     *   actividadVulnerable: "AVI",
-     *   defaults: {
+     * const result = await mexSdk.reports.generateReport(report.id, {
+     *   actividadVulnerable: {
      *     rfc: "ABC200101XXX",
-     *     platformDomain: "https://example.com",
+     *     AVI: {
+     *       platformDomain: "https://example.com",
+     *       alertType: "100",
+     *     },
      *   },
      * });
      * console.log(result.xml);
      * ```
      */
-    generateReport(input: MexValidateReportInput): Promise<GenerateResult>;
+    generateReport(reportId: string, defaults: TDefaults): Promise<GenerateResult>;
     /**
      * Submits a validated Mexico report.
      *
@@ -176,6 +184,14 @@ export declare class MexReportsResource extends ReportsResource {
      * Uses `availableJurisdictions` to find any report that includes Mexico.
      */
     protected applyScopeToFilter(filter?: MexReportFilter): ReportFilter;
+    /**
+     * Transforms a flattened MexReportSort to nested ReportSort 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): ReportSort | undefined;
     /**
      * Transforms flattened MX input to nested API format.
      */
@@ -200,5 +216,11 @@ export declare class MexReportsResource extends ReportsResource {
      * Transforms flattened MX report item update input to nested API format.
      */
     protected transformItemUpdateToNested(data: UpdateMexReportItemInput): UpdateReportItemInput;
+    /**
+     * Transforms flattened MX validate/generate input to nested API format.
+     */
+    protected transformValidateToNested(reportId: string, defaults: MexReportDefaultsInput): {
+        reportId: string;
+    } & ReportDefaultsInput;
 }
 //# sourceMappingURL=reports.d.ts.map

package/dist/resources/mex/reports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../../src/resources/mex/reports.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../../src/resources/mex/reports.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAYzB,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,eAAe,EACf,aAAa,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMjD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,kBAAkB,CAC7B,KAAK,GAAG,aAAa,EACrB,SAAS,GAAG,sBAAsB,CAClC,SAAQ,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC;IAKzC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAW5D;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAOxC,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAOlE,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAOlE;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAcxE;;;;;OAKG;IACG,IAAI,CACR,OAAO,CAAC,EAAE,WAAW,CAAC,eAAe,EAAE,KAAK,CAAC,GAC5C,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAkBxC;;;;;OAKG;IACH,OAAO,CACL,MAAM,CAAC,EAAE,eAAe,GACvB,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC;IASvC,UAAU,CACd,OAAO,EAAE,oBAAoB,EAAE,EAC/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAA;KAAE,GAC1B,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAClC,UAAU,CACd,OAAO,EAAE,oBAAoB,EAAE,EAC/B,OAAO,EAAE;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GACzB,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAiCnC,UAAU,CACd,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,oBAAoB,CAAA;KAAE,EAAE,EACrD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAA;KAAE,GAC1B,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAClC,UAAU,CACd,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,oBAAoB,CAAA;KAAE,EAAE,EACrD,OAAO,EAAE;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GACzB,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IA0CzC;;OAEG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,aAAa,CAAC;IAWzB;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAOvE;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,aAAa,CAAC;IAczB;;OAEG;IACG,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,CAAC,gBAAgB,EAAE,cAAc,CAAC,GACtD,OAAO,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAc5C;;OAEG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,wBAAwB,EAAE,GAChC,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAqBrD;;;;;;;;;;;;;;;;;;;;OAoBG;IACY,cAAc,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,GAClB,OAAO,CAAC,gBAAgB,CAAC;IAa5B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACY,cAAc,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,GAClB,OAAO,CAAC,cAAc,CAAC;IAa1B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqBpE;;;;;;OAMG;IACH,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,YAAY;IAepE;;;;;;OAMG;IACH,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS;IAOhE;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,iBAAiB;IAoB1E;;OAEG;IACH,SAAS,CAAC,uBAAuB,CAC/B,IAAI,EAAE,oBAAoB,GACzB,iBAAiB;IAepB;;OAEG;cACgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS;IAI3D;;OAEG;cACgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa;IAIvE;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAC7B,IAAI,EAAE,wBAAwB,GAC7B,qBAAqB;IAexB;;OAEG;IACH,SAAS,CAAC,2BAA2B,CACnC,IAAI,EAAE,wBAAwB,GAC7B,qBAAqB;IAexB;;OAEG;IACH,SAAS,CAAC,yBAAyB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,sBAAsB,GAC/B;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,mBAAmB;CAQ9C"}

package/dist/resources/mex/reports.js

@@ -7,8 +7,8 @@
  * - Returns MexReport models
  */
 import { z } from "zod";
-import { Jurisdiction, createMexReportInputSchema, updateMexReportInputSchema, createMexReportItemInputSchema, updateMexReportItemInputSchema, mexValidateReportInputSchema, mexSubmitReportInputSchema, } from "@artu-ai/shared";
-import { ReportsResource } from "../reports";
+import { Jurisdiction, createMexReportInputSchema, updateMexReportInputSchema, createMexReportItemInputSchema, updateMexReportItemInputSchema, mexSubmitReportInputSchema, transformSort, mexReportFieldMapping, mexReportDefaultsInputSchema, } from "@artu-ai/shared";
+import { ReportsResource, } from "../reports";
 import { MexReport } from "../../models";
 import { MexReportItem } from "../../models/mex";
 // ===========================
@@ -90,9 +90,11 @@ export class MexReportsResource extends ReportsResource {
      */
     async list(options) {
         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,
         }));
         return {
             data: response.data.map((r) => this.instantiate(r)),
@@ -193,7 +195,7 @@ export class MexReportsResource extends ReportsResource {
         return this.instantiateItem(response);
     }
     /**
-     * Lists items in a report.
+     * Lists items in a report with filtering, sorting, and pagination.
      */
     async listItems(reportId, options) {
         const response = await this.execute(() => this.trpc.reports.listItems.query({
@@ -225,21 +227,26 @@ export class MexReportsResource extends ReportsResource {
      *
      * Uses Mexico-scoped validation input (jurisdiction is implicit).
      *
+     * @param reportId - The report ID to validate
+     * @param defaults - Mexico report defaults including activity-specific settings
+     *
      * @example
      * ```typescript
-     * const result = await mexSdk.reports.validateReport({
-     *   reportId: report.id,
-     *   actividadVulnerable: "AVI",
-     *   defaults: {
+     * const result = await mexSdk.reports.validateReport(report.id, {
+     *   actividadVulnerable: {
      *     rfc: "ABC200101XXX",
-     *     platformDomain: "https://example.com",
+     *     AVI: {
+     *       platformDomain: "https://example.com",
+     *       alertType: "100",
+     *     },
      *   },
      * });
      * ```
      */
-    async validateReport(input) {
-        const validated = this.validate(mexValidateReportInputSchema, input);
-        return this.execute(() => this.trpc.reports.validate.mutate(validated));
+    async validateReport(reportId, defaults) {
+        const validated = this.validate(mexReportDefaultsInputSchema, defaults);
+        const nestedInput = this.transformValidateToNested(reportId, validated);
+        return this.execute(() => this.trpc.reports.validate.mutate(nestedInput));
     }
     // ─────────────────────────────────────────────────────────────────
     // Generation
@@ -250,22 +257,27 @@ export class MexReportsResource extends ReportsResource {
      * Uses the same input as validateReport since generation requires
      * the same transformation and defaults.
      *
+     * @param reportId - The report ID to generate XML for
+     * @param defaults - Mexico report defaults including activity-specific settings
+     *
      * @example
      * ```typescript
-     * const result = await mexSdk.reports.generateReport({
-     *   reportId: report.id,
-     *   actividadVulnerable: "AVI",
-     *   defaults: {
+     * const result = await mexSdk.reports.generateReport(report.id, {
+     *   actividadVulnerable: {
      *     rfc: "ABC200101XXX",
-     *     platformDomain: "https://example.com",
+     *     AVI: {
+     *       platformDomain: "https://example.com",
+     *       alertType: "100",
+     *     },
      *   },
      * });
      * console.log(result.xml);
      * ```
      */
-    async generateReport(input) {
-        const validated = this.validate(mexValidateReportInputSchema, input);
-        return this.execute(() => this.trpc.reports.generate.mutate(validated));
+    async generateReport(reportId, defaults) {
+        const validated = this.validate(mexReportDefaultsInputSchema, defaults);
+        const nestedInput = this.transformValidateToNested(reportId, validated);
+        return this.execute(() => this.trpc.reports.generate.mutate(nestedInput));
     }
     // ─────────────────────────────────────────────────────────────────
     // Submission
@@ -325,6 +337,19 @@ export class MexReportsResource extends ReportsResource {
             availableJurisdictions: Jurisdiction.Mexico,
         };
     }
+    /**
+     * Transforms a flattened MexReportSort to nested ReportSort 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.
+     */
+    applyScopeToSort(sort) {
+        if (!sort || !Array.isArray(sort) || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, mexReportFieldMapping);
+    }
     /**
      * Transforms flattened MX input to nested API format.
      */
@@ -401,4 +426,15 @@ export class MexReportsResource extends ReportsResource {
             },
         };
     }
+    /**
+     * Transforms flattened MX validate/generate input to nested API format.
+     */
+    transformValidateToNested(reportId, defaults) {
+        return {
+            reportId,
+            jurisdictions: {
+                MX: defaults,
+            },
+        };
+    }
 }

package/dist/resources/mex/transactions.d.ts

@@ -7,7 +7,7 @@
  * - Filters list/iterate to Mexico transactions only
  * - Returns MexTransaction models
  */
-import type { CreateTransactionInput, UpdateTransactionInput, TransactionFilter, ListOptions, PaginatedResponse, CreateMexTransactionInput, UpdateMexTransactionInput, AtomicBatchResult, PartialBatchResult, RelatedClient, MexTransactionFilter } from "@artu-ai/shared";
+import type { CreateTransactionInput, UpdateTransactionInput, TransactionFilter, TransactionSort, ListOptions, PaginatedResponse, CreateMexTransactionInput, UpdateMexTransactionInput, AtomicBatchResult, PartialBatchResult, RelatedClient, MexTransactionFilter, MexTransactionSort } from "@artu-ai/shared";
 import { ClientRole } from "@artu-ai/shared";
 import { TransactionsResource } from "../transactions";
 import { MexTransaction, type TransactionData } from "../../models";
@@ -42,7 +42,7 @@ import { MexTransaction, type TransactionData } from "../../models";
  * // data is MexTransaction[]
  * ```
  */
-export declare class MexTransactionsResource extends TransactionsResource {
+export declare class MexTransactionsResource<TSort = MexTransactionSort> extends TransactionsResource<TSort> {
     /**
      * Creates a new Mexico transaction with flattened input.
      */
@@ -62,7 +62,7 @@ export declare class MexTransactionsResource extends TransactionsResource {
      *
      * Accepts flattened MX filter (future MX-specific transaction fields at root level).
      */
-    list(options?: ListOptions<MexTransactionFilter>): Promise<PaginatedResponse<MexTransaction>>;
+    list(options?: ListOptions<MexTransactionFilter, TSort>): Promise<PaginatedResponse<MexTransaction>>;
     /**
      * Iterates over Mexico transactions.
      *
@@ -101,6 +101,14 @@ export declare class MexTransactionsResource extends TransactionsResource {
      * but this method ensures the jurisdiction scope is applied.
      */
     protected applyScopeToFilter(filter?: MexTransactionFilter): TransactionFilter;
+    /**
+     * Transforms a flattened MexTransactionSort to nested TransactionSort 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): TransactionSort | undefined;
     /**
      * Transforms flattened MX input to nested API format.
      */

package/dist/resources/mex/transactions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../../src/resources/mex/transactions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../../src/resources/mex/transactions.ts"],"names":[],"mappings":"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"}

package/dist/resources/mex/transactions.js

@@ -8,7 +8,7 @@
  * - Returns MexTransaction models
  */
 import { z } from "zod";
-import { Jurisdiction, createMexTransactionInputSchema, updateMexTransactionInputSchema, } from "@artu-ai/shared";
+import { Jurisdiction, createMexTransactionInputSchema, updateMexTransactionInputSchema, transformSort, mexTransactionFieldMapping, } from "@artu-ai/shared";
 import { TransactionsResource } from "../transactions";
 import { MexTransaction } from "../../models";
 // ===========================
@@ -92,9 +92,11 @@ export class MexTransactionsResource extends TransactionsResource {
      */
     async list(options) {
         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,
         }));
         return {
             data: response.data.map((t) => this.instantiate(t)),
@@ -215,6 +217,19 @@ export class MexTransactionsResource extends TransactionsResource {
             availableJurisdictions: Jurisdiction.Mexico,
         };
     }
+    /**
+     * Transforms a flattened MexTransactionSort to nested TransactionSort 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.
+     */
+    applyScopeToSort(sort) {
+        if (!sort || !Array.isArray(sort) || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, mexTransactionFieldMapping);
+    }
     /**
      * Transforms flattened MX input to nested API format.
      */

package/dist/resources/reports.d.ts

@@ -9,10 +9,10 @@
  * - JYSReportsResource - Mexico JYS-scoped with flattened JYS fields
  * - TSCReportsResource - Mexico TSC-scoped with flattened TSC fields
  */
-import type { CreateReportInput, UpdateReportInput, CreateReportItemInput, UpdateReportItemInput, ReportFilter, ReportItemFilter, ValidationResult, GenerateResult, SubmitReportInput, SubmissionResult, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, ValidateReportInput } from "@artu-ai/shared";
+import type { CreateReportInput, UpdateReportInput, UpdateReportStatusInput, CreateReportItemInput, UpdateReportItemInput, ReportFilter, ReportSort, ReportItemFilter, ReportItemSort, ValidationResult, GenerateResult, SubmitReportInput, SubmissionResult, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, ReportDefaultsInput } from "@artu-ai/shared";
 import { BaseResource } from "./base";
 import { Report, ReportItem, type ReportData, type ReportItemData } from "../models";
-export type { ReportFilter, ReportItemFilter };
+export type { ReportFilter, ReportItemFilter, ReportItemSort };
 /**
  * Add items result
  */
@@ -54,7 +54,7 @@ export interface AddItemsResult {
  * }
  * ```
  */
-export declare class ReportsResource extends BaseResource<Report, CreateReportInput, UpdateReportInput, ReportFilter> {
+export declare class ReportsResource<TSort = ReportSort, TDefaults = ReportDefaultsInput> extends BaseResource<Report, CreateReportInput, UpdateReportInput, ReportFilter, TSort> {
     /**
      * Creates a new report.
      *
@@ -78,6 +78,16 @@ export declare class ReportsResource extends BaseResource<Report, CreateReportIn
      * Updates a report.
      */
     update(id: string, data: UpdateReportInput): Promise<Report>;
+    /**
+     * Updates a report's status.
+     *
+     * Restrictions:
+     * - Can only manually set to: Draft
+     * - Cannot change from: Accepted (terminal), Submitted (awaiting response)
+     *
+     * Use this to reset a report back to Draft status for re-editing.
+     */
+    updateStatus(id: string, data: UpdateReportStatusInput): Promise<Report>;
     /**
      * Deletes a report.
      */
@@ -85,7 +95,7 @@ export declare class ReportsResource extends BaseResource<Report, CreateReportIn
     /**
      * Lists reports with optional filtering and pagination.
      */
-    list(options?: ListOptions<ReportFilter>): Promise<PaginatedResponse<Report>>;
+    list(options?: ListOptions<ReportFilter, TSort>): Promise<PaginatedResponse<Report>>;
     /**
      * Returns an async iterator over all reports matching the filter.
      */
@@ -107,9 +117,9 @@ export declare class ReportsResource extends BaseResource<Report, CreateReportIn
      */
     removeItem(reportId: string, itemId: string): Promise<void>;
     /**
-     * Lists items in a report.
+     * Lists items in a report with filtering, sorting, and pagination.
      */
-    listItems(reportId: string, options?: ListOptions<ReportItemFilter>): Promise<PaginatedResponse<ReportItem>>;
+    listItems(reportId: string, options?: ListOptions<ReportItemFilter, ReportItemSort>): Promise<PaginatedResponse<ReportItem>>;
     /**
      * Adds multiple items to a report.
      * Validates all items upfront - fails fast if any item is invalid.
@@ -124,43 +134,27 @@ export declare class ReportsResource extends BaseResource<Report, CreateReportIn
     /**
      * Validates a report and its items.
      *
-     * Requires jurisdiction and activity-specific defaults.
+     * Requires jurisdiction-specific defaults.
      * For scoped SDKs, use the scoped resource which provides a simpler API.
      *
-     * @example
-     * ```typescript
-     * const result = await sdk.reports.validateReport({
-     *   reportId: report.id,
-     *   jurisdiction: "MX",
-     *   actividadVulnerable: "AVI",
-     *   defaults: {
-     *     rfc: "ABC200101XXX",
-     *     platformDomain: "https://example.com",
-     *   },
-     * });
-     * ```
-     */
-    validateReport(input: ValidateReportInput): Promise<ValidationResult>;
-    /**
-     * Generates the report output (e.g., XML for Mexico reports).
+     * @param reportId - The report ID to validate
+     * @param defaults - Jurisdiction-specific defaults for validation
+     */
+    validateReport(reportId: string, defaults: TDefaults): Promise<ValidationResult>;
+    /**
+     * Validates and generates the report output (e.g., XML for Mexico reports).
      *
-     * Requires the same input as validateReport since generation uses
-     * the same transformation and defaults.
+     * Performs validation first:
+     * - If validation fails, returns `{ status: "validation_failed", validation: {...} }`
+     * - If validation passes, returns `{ status: "success", xml: "...", ... }`
      *
-     * @example
-     * ```typescript
-     * const result = await sdk.reports.generate({
-     *   reportId: report.id,
-     *   jurisdiction: "MX",
-     *   actividadVulnerable: "AVI",
-     *   defaults: {
-     *     rfc: "ABC200101XXX",
-     *     platformDomain: "https://example.com",
-     *   },
-     * });
-     * ```
-     */
-    generate(input: ValidateReportInput): Promise<GenerateResult>;
+     * Use `validateReport` for dry-run/preview validation without generating XML.
+     *
+     * @param reportId - The report ID to generate
+     * @param defaults - Jurisdiction-specific defaults for generation
+     * @returns GenerateResult with status "success" or "validation_failed"
+     */
+    generateReport(reportId: string, defaults: TDefaults): Promise<GenerateResult>;
     /**
      * Submits a validated report.
      *

package/dist/resources/reports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/resources/reports.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/resources/reports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAWzB,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EACL,MAAM,EACN,UAAU,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAOnB,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,eAAe,CAC1B,KAAK,GAAG,UAAU,EAClB,SAAS,GAAG,mBAAmB,CAC/B,SAAQ,YAAY,CACpB,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,KAAK,CACN;IAKC;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUtD;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO3C;;OAEG;IACG,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOrE;;OAEG;IACG,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO/D;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IASlE;;;;;;;;OAQG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAS9E;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;IACG,IAAI,CACR,OAAO,CAAC,EAAE,WAAW,CAAC,YAAY,EAAE,KAAK,CAAC,GACzC,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAarC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC;IAQvE;;OAEG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,UAAU,CAAC;IAUtB;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAOpE;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,UAAU,CAAC;IAStB;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE;;OAEG;IACG,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,CAAC,gBAAgB,EAAE,cAAc,CAAC,GACtD,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAczC;;;OAGG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,qBAAqB,EAAE,GAC7B,OAAO,CAAC,cAAc,CAAC;IAgB1B;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAU/B;;;;;;;;OAQG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,GAClB,OAAO,CAAC,gBAAgB,CAAC;IAO5B;;;;;;;;;;;;OAYG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,GAClB,OAAO,CAAC,cAAc,CAAC;IAW1B;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IASjE;;;;;;OAMG;IACG,UAAU,CACd,OAAO,EAAE,iBAAiB,EAAE,EAC5B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAA;KAAE,GAC1B,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC/B,UAAU,CACd,OAAO,EAAE,iBAAiB,EAAE,EAC5B,OAAO,EAAE;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GACzB,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IA6BtC;;;;;;OAMG;IACG,UAAU,CACd,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,iBAAiB,CAAA;KAAE,EAAE,EAClD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAA;KAAE,GAC1B,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC/B,UAAU,CACd,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,iBAAiB,CAAA;KAAE,EAAE,EAClD,OAAO,EAAE;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GACzB,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAsCtC;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAI/C;;;OAGG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU;CAG5D"}