@artu-ai/compliance-sdk 0.2.0 → 0.3.0

package/dist/resources/documents.js

@@ -8,6 +8,8 @@ import { createDocumentInputSchema, updateDocumentInputSchema, confirmUploadInpu
 import { z } from "zod";
 import { Document } from "../models/Document";
 import { BaseResource } from "./base";
+import { uploadToS3, normalizeFile, validateFileSize, } from "../utils/upload";
+import { UploadError } from "../errors/upload";
 // ─────────────────────────────────────────────────────────────────
 // Resource
 // ─────────────────────────────────────────────────────────────────
@@ -106,6 +108,111 @@ export class DocumentsResource extends BaseResource {
         const response = await this.execute(() => this.trpc.documents.confirmUpload.mutate(validated));
         return this.instantiate(response);
     }
+    // ─────────────────────────────────────────────────────────────────
+    // Upload (High-Level Helper)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Uploads a file and creates a document in one operation.
+     *
+     * This is a convenience method that combines:
+     * 1. Creating a document record with presigned URL
+     * 2. Uploading the file directly to storage
+     * 3. Confirming the upload
+     *
+     * For more control over the upload process, use `create()`, manual upload,
+     * and `confirmUpload()` separately.
+     *
+     * @param file - The file to upload (File, Blob, or UploadableFile)
+     * @param data - Document metadata (clientId, jurisdiction, type, etc.)
+     * @param options - Upload options (progress callback, abort signal, timeout)
+     * @returns The created and uploaded document
+     *
+     * @example
+     * ```typescript
+     * // Simple upload
+     * const document = await sdk.documents.upload(file, {
+     *   clientId: "client-123",
+     *   jurisdiction: "MX",
+     *   type: "ine_front",
+     * });
+     *
+     * // With progress tracking
+     * const document = await sdk.documents.upload(file, {
+     *   clientId: "client-123",
+     *   jurisdiction: "MX",
+     *   type: "ine_front",
+     * }, {
+     *   onProgress: (progress) => {
+     *     console.log(`Upload: ${Math.round(progress * 100)}%`);
+     *   },
+     * });
+     *
+     * // With abort support
+     * const controller = new AbortController();
+     * const uploadPromise = sdk.documents.upload(file, data, {
+     *   signal: controller.signal,
+     * });
+     *
+     * // Cancel the upload
+     * controller.abort();
+     * ```
+     *
+     * @throws {FileTooLargeError} If file exceeds 25 MB limit
+     * @throws {UploadError} If upload fails at any stage
+     * @throws {UploadAbortedError} If upload is cancelled via AbortSignal
+     * @throws {UploadTimeoutError} If upload times out
+     */
+    async upload(file, data, options = {}) {
+        const { onProgress, signal, timeout } = options;
+        // Normalize file input
+        const normalizedFile = normalizeFile(file);
+        // Validate file size before starting
+        validateFileSize(normalizedFile.size);
+        // Check if already aborted
+        if (signal?.aborted) {
+            throw new UploadError("Upload was aborted before starting", "request");
+        }
+        // Determine content type (use provided or infer from file)
+        const contentType = data.contentType || normalizedFile.type;
+        if (!contentType || contentType === "application/octet-stream") {
+            throw new UploadError("Could not determine file content type. Please provide contentType explicitly.", "request");
+        }
+        // Validate content type is allowed
+        const allowedTypes = [
+            "image/jpeg",
+            "image/png",
+            "image/webp",
+            "application/pdf",
+        ];
+        if (!allowedTypes.includes(contentType)) {
+            throw new UploadError(`Invalid file type: ${contentType}. Allowed types: ${allowedTypes.join(", ")}`, "request");
+        }
+        // Step 1: Create document and get presigned URL
+        const createInput = {
+            ...data,
+            contentType: contentType,
+        };
+        const { document, upload } = await this.create(createInput);
+        // upload should always be present when contentType is provided
+        if (!upload) {
+            throw new UploadError("Server did not return upload URL. This should not happen.", "request");
+        }
+        // Step 2: Upload file to S3
+        // Note: If upload fails, the document remains in pending_upload status
+        // and will be cleaned up by the orphan document cleanup job
+        await uploadToS3(normalizedFile, upload, {
+            onProgress,
+            signal,
+            timeout,
+        });
+        // Step 3: Confirm upload
+        return this.confirmUpload({
+            id: document.id,
+            filename: normalizedFile.name,
+            contentType,
+            size: normalizedFile.size,
+        });
+    }
     /**
      * Gets a presigned URL for downloading/viewing a document.
      *

package/dist/resources/index.d.ts

@@ -18,6 +18,6 @@ export { ReportsResource, type ReportFilter, type ReportItemFilter, type AddItem
 export { AddressesResource } from "./addresses";
 export { ContactMethodsResource } from "./contact-methods";
 export { BankAccountsResource } from "./bank-accounts";
-export { DocumentsResource, type CreateDocumentResult } from "./documents";
+export { DocumentsResource, type CreateDocumentResult, type UploadDocumentInput, type UploadOptions, } from "./documents";
 export * from "./mex";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAG3E,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAGrB,cAAc,OAAO,CAAC"}

package/dist/resources/index.js

@@ -20,6 +20,6 @@ export { ReportsResource, } from "./reports";
 export { AddressesResource } from "./addresses";
 export { ContactMethodsResource } from "./contact-methods";
 export { BankAccountsResource } from "./bank-accounts";
-export { DocumentsResource } from "./documents";
+export { DocumentsResource, } from "./documents";
 // Mexico-scoped resources
 export * from "./mex";

package/dist/resources/mex/actividad-vulnerable/avi/clients.d.ts

@@ -5,7 +5,7 @@
  * - Accepts flattened CreateAVIClientInput (AVI fields at root level)
  * - Returns MexAVIClient models
  */
-import type { CreateClientInput, UpdateClientInput, ClientFilter, ListOptions, PaginatedResponse, CreateAVIClientInput, UpdateAVIClientInput, AtomicBatchResult, PartialBatchResult, ClientRelationshipType, LinkedClient as LinkedClientInput, CreateMexAddressInput, UpdateMexAddressInput, CreateContactMethodInput, UpdateContactMethodInput, CreateBankAccountInput, UpdateBankAccountInput, SyncItem, SyncResult, AVIClientFilter } from "@artu-ai/shared";
+import type { CreateClientInput, UpdateClientInput, ClientFilter, ClientSort, ListOptions, PaginatedResponse, CreateAVIClientInput, UpdateAVIClientInput, AtomicBatchResult, PartialBatchResult, ClientRelationshipType, LinkedClient as LinkedClientInput, CreateMexAddressInput, UpdateMexAddressInput, CreateContactMethodInput, UpdateContactMethodInput, CreateBankAccountInput, UpdateBankAccountInput, SyncItem, SyncResult, AVIClientFilter, AVIClientSort } from "@artu-ai/shared";
 import { MexClientsResource } from "../../clients";
 import { type ClientIncludeMap } from "../../../clients";
 import { MexAVIClient, MexAddress, MexBankAccount, ContactMethod, LinkedClient, type ClientData } from "../../../../models";
@@ -37,7 +37,7 @@ import { MexAVIClient, MexAddress, MexBankAccount, ContactMethod, LinkedClient,
  * console.log(client.username);
  * ```
  */
-export declare class AVIClientsResource extends MexClientsResource {
+export declare class AVIClientsResource extends MexClientsResource<AVIClientSort> {
     /**
      * Creates a new AVI client with fully flattened input.
      */
@@ -71,7 +71,7 @@ export declare class AVIClientsResource extends MexClientsResource {
      * });
      * ```
      */
-    list(options?: ListOptions<AVIClientFilter>): Promise<PaginatedResponse<MexAVIClient>>;
+    list(options?: ListOptions<AVIClientFilter, AVIClientSort>): Promise<PaginatedResponse<MexAVIClient>>;
     /**
      * Iterates over AVI clients.
      *
@@ -143,6 +143,12 @@ export declare class AVIClientsResource extends MexClientsResource {
      * under jurisdictions.MX.actividadVulnerable.AVI.
      */
     protected applyScopeToFilter(filter?: AVIClientFilter): ClientFilter;
+    /**
+     * Transforms a flattened AVIClientSort to nested ClientSort format.
+     *
+     * Maps flattened field names (username, rfc, curp) to their full API paths.
+     */
+    protected applyScopeToSort(sort?: AVIClientSort): ClientSort | undefined;
     /**
      * Transforms flattened AVI input to nested API format.
      */

package/dist/resources/mex/actividad-vulnerable/avi/clients.d.ts.map

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

package/dist/resources/mex/actividad-vulnerable/avi/clients.js

@@ -6,7 +6,7 @@
  * - Returns MexAVIClient models
  */
 import { z } from "zod";
-import { CodigoActividad, createAVIClientInputSchema, updateAVIClientInputSchema, linkedClientSchema, } from "@artu-ai/shared";
+import { CodigoActividad, createAVIClientInputSchema, updateAVIClientInputSchema, linkedClientSchema, transformSort, aviClientFieldMapping, } from "@artu-ai/shared";
 import { MexClientsResource } from "../../clients";
 import { MexAVIClient, } from "../../../../models";
 // ===========================
@@ -98,9 +98,11 @@ export class AVIClientsResource extends MexClientsResource {
      */
     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)),
@@ -251,6 +253,17 @@ export class AVIClientsResource extends MexClientsResource {
         }
         return nestedFilter;
     }
+    /**
+     * Transforms a flattened AVIClientSort to nested ClientSort format.
+     *
+     * Maps flattened field names (username, rfc, curp) to their full API paths.
+     */
+    applyScopeToSort(sort) {
+        if (!sort || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, aviClientFieldMapping);
+    }
     /**
      * Transforms flattened AVI input to nested API format.
      */

package/dist/resources/mex/actividad-vulnerable/avi/reports.d.ts

@@ -5,10 +5,9 @@
  * - Accepts flattened CreateAVIReportInput (AVI fields at root level)
  * - Returns MexAVIReport models
  */
-import type { CreateReportInput, UpdateReportInput, CreateReportItemInput, UpdateReportItemInput, CreateAVIReportInput, UpdateAVIReportInput, CreateAVIReportItemInput, UpdateAVIReportItemInput, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, ValidationResult, GenerateResult, SubmissionResult, MexAVIValidateInput, SubmitAVIReportInput } from "@artu-ai/shared";
-import type { AVIReportFilter } from "@artu-ai/shared";
+import type { CreateReportInput, UpdateReportInput, CreateReportItemInput, UpdateReportItemInput, CreateAVIReportInput, UpdateAVIReportInput, CreateAVIReportItemInput, UpdateAVIReportItemInput, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, ValidationResult, GenerateResult, SubmissionResult, AviReportDefaultsInput, SubmitAVIReportInput } from "@artu-ai/shared";
+import type { AVIReportFilter, AVIReportSort, AVIReportItemFilter, ReportSort, ReportItemFilter, ReportItemSort } from "@artu-ai/shared";
 import { MexReportsResource } from "../../reports";
-import { type ReportItemFilter } from "../../../reports";
 import { MexAVIReport, MexAVIReportItem, type ReportData, type ReportItemData } from "../../../../models";
 /**
  * AVI (Activos Virtuales) scoped reports resource.
@@ -30,7 +29,7 @@ import { MexAVIReport, MexAVIReportItem, type ReportData, type ReportItemData }
  * console.log(report.mesReportado);
  * ```
  */
-export declare class AVIReportsResource extends MexReportsResource {
+export declare class AVIReportsResource extends MexReportsResource<AVIReportSort, AviReportDefaultsInput> {
     create(data: CreateAVIReportInput): Promise<MexAVIReport>;
     retrieve(id: string): Promise<MexAVIReport>;
     retrieveByMetadata(key: string, value: string): Promise<MexAVIReport>;
@@ -41,7 +40,7 @@ export declare class AVIReportsResource extends MexReportsResource {
      *
      * Accepts flattened AVI filter (future AVI-specific report fields at root level).
      */
-    list(options?: ListOptions<AVIReportFilter>): Promise<PaginatedResponse<MexAVIReport>>;
+    list(options?: ListOptions<AVIReportFilter, AVIReportSort>): Promise<PaginatedResponse<MexAVIReport>>;
     /**
      * Iterates over AVI reports.
      *
@@ -69,7 +68,11 @@ export declare class AVIReportsResource extends MexReportsResource {
     addItem(reportId: string, data: CreateAVIReportItemInput): Promise<MexAVIReportItem>;
     getItem(reportId: string, itemId: string): Promise<MexAVIReportItem>;
     updateItem(reportId: string, itemId: string, data: UpdateAVIReportItemInput): Promise<MexAVIReportItem>;
-    listItems(reportId: string, options?: ListOptions<ReportItemFilter>): Promise<PaginatedResponse<MexAVIReportItem>>;
+    listItems(reportId: string, options?: ListOptions<AVIReportItemFilter, ReportItemSort>): Promise<PaginatedResponse<MexAVIReportItem>>;
+    /**
+     * Transforms a flattened AVIReportItemFilter to nested ReportItemFilter format.
+     */
+    protected applyScopeToItemFilter(filter?: AVIReportItemFilter): ReportItemFilter | undefined;
     addItems(reportId: string, items: CreateAVIReportItemInput[]): Promise<{
         added: number;
         items: MexAVIReportItem[];
@@ -77,38 +80,40 @@ export declare 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",
      * });
      * ```
      */
-    validateReport(input: MexAVIValidateInput): Promise<ValidationResult>;
+    validateReport(reportId: string, defaults: AviReportDefaultsInput): Promise<ValidationResult>;
     /**
      * Generates XML for an AVI report.
      *
      * 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);
      * ```
      */
-    generateReport(input: MexAVIValidateInput): Promise<GenerateResult>;
+    generateReport(reportId: string, defaults: AviReportDefaultsInput): Promise<GenerateResult>;
     /**
      * Submits a validated AVI report.
      *
@@ -124,11 +129,24 @@ export declare class AVIReportsResource extends MexReportsResource {
      * ```
      */
     submit(input: SubmitAVIReportInput): Promise<SubmissionResult>;
+    /**
+     * Transforms a flattened AVIReportSort to nested ReportSort format.
+     *
+     * Maps flattened field names to their full API paths.
+     */
+    protected applyScopeToSort(sort?: AVIReportSort): ReportSort | undefined;
     protected transformToNested(data: CreateAVIReportInput): CreateReportInput;
     protected transformUpdateToNested(data: UpdateAVIReportInput): UpdateReportInput;
     protected instantiate(data: ReportData): MexAVIReport;
     protected instantiateItem(data: ReportItemData): MexAVIReportItem;
     protected transformItemToNested(data: CreateAVIReportItemInput): CreateReportItemInput;
     protected transformItemUpdateToNested(data: UpdateAVIReportItemInput): UpdateReportItemInput;
+    /**
+     * Transforms AVI defaults to nested API format for validate/generate.
+     */
+    protected transformAviDefaultsToNested(reportId: string, defaults: AviReportDefaultsInput): {
+        reportId: string;
+        jurisdictions: unknown;
+    };
 }
 //# sourceMappingURL=reports.d.ts.map

package/dist/resources/mex/actividad-vulnerable/avi/reports.d.ts.map

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

package/dist/resources/mex/actividad-vulnerable/avi/reports.js

@@ -6,7 +6,7 @@
  * - Returns MexAVIReport models
  */
 import { z } from "zod";
-import { CodigoActividad, createAVIReportInputSchema, updateAVIReportInputSchema, createAVIReportItemInputSchema, updateAVIReportItemInputSchema, mexAviValidateInputSchema, submitAVIReportInputSchema, } from "@artu-ai/shared";
+import { CodigoActividad, createAVIReportInputSchema, updateAVIReportInputSchema, createAVIReportItemInputSchema, updateAVIReportItemInputSchema, aviDefaultsInputSchema, submitAVIReportInputSchema, transformSort, aviReportFieldMapping, } from "@artu-ai/shared";
 import { MexReportsResource } from "../../reports";
 import { MexAVIReport, MexAVIReportItem, } from "../../../../models";
 // ===========================
@@ -70,9 +70,11 @@ export class AVIReportsResource extends MexReportsResource {
      */
     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)),
@@ -163,15 +165,46 @@ export class AVIReportsResource extends MexReportsResource {
         return this.instantiateItem(response);
     }
     async listItems(reportId, options) {
+        // 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,
         }));
         return {
             data: response.data.map((i) => this.instantiateItem(i)),
             pagination: response.pagination,
         };
     }
+    /**
+     * Transforms a flattened AVIReportItemFilter to nested ReportItemFilter format.
+     */
+    applyScopeToItemFilter(filter) {
+        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;
+        }
+        // Build nested filter structure
+        const aviFilter = {};
+        if (alertType !== undefined)
+            aviFilter.alertType = alertType;
+        if (alertDescription !== undefined)
+            aviFilter.alertDescription = alertDescription;
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        AVI: aviFilter,
+                    },
+                },
+            },
+        };
+    }
     async addItems(reportId, items) {
         const validated = this.validate(z.array(createAVIReportItemInputSchema), items);
         const nestedItems = validated.map((i) => this.transformItemToNested(i));
@@ -187,22 +220,24 @@ 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",
      * });
      * ```
      */
-    async validateReport(input) {
-        const validated = this.validate(mexAviValidateInputSchema, input);
-        return this.execute(() => this.trpc.reports.validate.mutate(validated));
+    async validateReport(reportId, defaults) {
+        const validated = this.validate(aviDefaultsInputSchema, defaults);
+        const nestedInput = this.transformAviDefaultsToNested(reportId, validated);
+        return this.execute(() => this.trpc.reports.validate.mutate(nestedInput));
     }
     // ─────────────────────────────────────────────────────────────────
     // Generation
@@ -212,21 +247,23 @@ 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);
      * ```
      */
-    async generateReport(input) {
-        const validated = this.validate(mexAviValidateInputSchema, input);
-        return this.execute(() => this.trpc.reports.generate.mutate(validated));
+    async generateReport(reportId, defaults) {
+        const validated = this.validate(aviDefaultsInputSchema, defaults);
+        const nestedInput = this.transformAviDefaultsToNested(reportId, validated);
+        return this.execute(() => this.trpc.reports.generate.mutate(nestedInput));
     }
     // ─────────────────────────────────────────────────────────────────
     // Submission
@@ -265,6 +302,17 @@ export class AVIReportsResource extends MexReportsResource {
     // ─────────────────────────────────────────────────────────────────
     // Protected Helpers
     // ─────────────────────────────────────────────────────────────────
+    /**
+     * Transforms a flattened AVIReportSort to nested ReportSort format.
+     *
+     * Maps flattened field names to their full API paths.
+     */
+    applyScopeToSort(sort) {
+        if (!sort || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, aviReportFieldMapping);
+    }
     transformToNested(data) {
         const { mesReportado, ...baseFields } = data;
         return {
@@ -330,4 +378,24 @@ export class AVIReportsResource extends MexReportsResource {
             },
         };
     }
+    /**
+     * Transforms AVI defaults to nested API format for validate/generate.
+     */
+    transformAviDefaultsToNested(reportId, defaults) {
+        const { rfc, collegiateEntityCode, exempt, priority, ...aviFields } = defaults;
+        return {
+            reportId,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        rfc,
+                        collegiateEntityCode,
+                        exempt,
+                        priority,
+                        [CodigoActividad.AVI]: aviFields,
+                    },
+                },
+            },
+        };
+    }
 }

package/dist/resources/mex/actividad-vulnerable/avi/transactions.d.ts

@@ -5,7 +5,7 @@
  * - Accepts flattened CreateAVITransactionInput (AVI fields at root level)
  * - Returns MexAVITransaction models
  */
-import type { CreateTransactionInput, UpdateTransactionInput, ListOptions, PaginatedResponse, CreateAVITransactionInput, UpdateAVITransactionInput, AtomicBatchResult, PartialBatchResult, RelatedClient, AVITransactionFilter } from "@artu-ai/shared";
+import type { CreateTransactionInput, UpdateTransactionInput, TransactionSort, ListOptions, PaginatedResponse, CreateAVITransactionInput, UpdateAVITransactionInput, AtomicBatchResult, PartialBatchResult, RelatedClient, AVITransactionFilter, AVITransactionSort } from "@artu-ai/shared";
 import { ClientRole } from "@artu-ai/shared";
 import { MexTransactionsResource } from "../../transactions";
 import { MexAVITransaction, type TransactionData } from "../../../../models";
@@ -34,7 +34,7 @@ import { MexAVITransaction, type TransactionData } from "../../../../models";
  * console.log(txn.operationType);
  * ```
  */
-export declare class AVITransactionsResource extends MexTransactionsResource {
+export declare class AVITransactionsResource extends MexTransactionsResource<AVITransactionSort> {
     create(data: CreateAVITransactionInput): Promise<MexAVITransaction>;
     retrieve(id: string): Promise<MexAVITransaction>;
     retrieveByMetadata(key: string, value: string): Promise<MexAVITransaction>;
@@ -44,7 +44,7 @@ export declare class AVITransactionsResource extends MexTransactionsResource {
      *
      * Accepts flattened AVI filter (future AVI-specific transaction fields at root level).
      */
-    list(options?: ListOptions<AVITransactionFilter>): Promise<PaginatedResponse<MexAVITransaction>>;
+    list(options?: ListOptions<AVITransactionFilter, AVITransactionSort>): Promise<PaginatedResponse<MexAVITransaction>>;
     /**
      * Iterates over AVI transactions.
      *
@@ -76,6 +76,12 @@ export declare class AVITransactionsResource extends MexTransactionsResource {
     }[], options: {
         atomic: false;
     }): Promise<PartialBatchResult<MexAVITransaction>>;
+    /**
+     * Transforms a flattened AVITransactionSort to nested TransactionSort format.
+     *
+     * Maps flattened field names to their full API paths.
+     */
+    protected applyScopeToSort(sort?: AVITransactionSort): TransactionSort | undefined;
     protected transformToNested(data: CreateAVITransactionInput): CreateTransactionInput;
     protected transformUpdateToNested(data: UpdateAVITransactionInput): UpdateTransactionInput;
     protected instantiate(data: TransactionData): MexAVITransaction;

package/dist/resources/mex/actividad-vulnerable/avi/transactions.d.ts.map

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