@artu-ai/compliance-sdk 0.0.6 → 0.3.0

package/dist/resources/documents.js

@@ -0,0 +1,447 @@
+/**
+ * Documents resource
+ *
+ * CRUD operations for documents. File upload/download operations are handled separately.
+ * All documents are created with pending_upload status.
+ */
+import { createDocumentInputSchema, updateDocumentInputSchema, confirmUploadInputSchema, } from "@artu-ai/shared";
+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
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Documents resource for managing document records.
+ *
+ * @example
+ * ```typescript
+ * // Create a document record
+ * const doc = await sdk.documents.create({
+ *   clientId: "client_123",
+ *   jurisdiction: "MX",
+ *   type: "ine_front",
+ *   category: "identity",
+ * });
+ *
+ * // List documents
+ * const docs = await sdk.documents.list({ filter: { clientId: "client_123" } });
+ *
+ * // Update document metadata
+ * await sdk.documents.update(doc.id, { metadata: { verified: true } });
+ * ```
+ */
+export class DocumentsResource extends BaseResource {
+    // ─────────────────────────────────────────────────────────────────
+    // Create
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Creates a new document record and returns a presigned POST upload URL.
+     *
+     * Documents are created with status "pending_upload".
+     * Use the returned presigned URL to upload the file directly to storage.
+     * After upload, call `confirmUpload()` to transition status to "uploaded".
+     *
+     * **Important:** The upload uses POST with FormData (not PUT). This allows
+     * enforcing a 25 MB file size limit at the storage level.
+     *
+     * @param data - Document data
+     * @returns The created document and presigned upload URL with form fields
+     *
+     * @example
+     * ```typescript
+     * // Create document and get upload URL
+     * const { document, upload } = await compliance.documents.create({
+     *   clientId: "client-123",
+     *   jurisdiction: "MX",
+     *   type: "ine_front",
+     * });
+     *
+     * // Build FormData with fields + file (file must be last!)
+     * const formData = new FormData();
+     * Object.entries(upload.fields).forEach(([key, value]) => {
+     *   formData.append(key, value);
+     * });
+     * formData.append("Content-Type", file.type);  // Add content-type
+     * formData.append("file", file);               // File MUST be last
+     *
+     * // Upload via POST
+     * const uploadResponse = await fetch(upload.url, {
+     *   method: "POST",
+     *   body: formData,
+     * });
+     *
+     * if (!uploadResponse.ok) {
+     *   throw new Error(`Upload failed: ${uploadResponse.status}`);
+     * }
+     *
+     * // Confirm upload with file metadata
+     * await compliance.documents.confirmUpload({
+     *   id: document.id,
+     *   filename: file.name,
+     *   contentType: file.type,
+     *   size: file.size,
+     * });
+     * ```
+     */
+    async create(data) {
+        const validated = this.validate(createDocumentInputSchema, data);
+        const response = await this.execute(() => this.trpc.documents.create.mutate(validated));
+        return {
+            document: this.instantiate(response.document),
+            upload: response.upload,
+        };
+    }
+    /**
+     * Confirms that a file has been uploaded to storage.
+     *
+     * Call this after uploading a file via the presigned URL returned by `create()`.
+     * This transitions the document status from "pending_upload" to "uploaded".
+     *
+     * @param data - Upload confirmation data
+     * @returns The updated document
+     */
+    async confirmUpload(data) {
+        const validated = this.validate(confirmUploadInputSchema, data);
+        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.
+     *
+     * The URL allows direct access to the file in storage without going through the backend.
+     * Use this for displaying documents in the UI or downloading them.
+     *
+     * @param id - Document ID
+     * @returns Presigned download URL with expiration
+     * @throws If document doesn't exist, is in pending_upload status, or has no storage path
+     *
+     * @example
+     * ```typescript
+     * // Get download URL for viewing
+     * const { url, expiresAt } = await compliance.documents.getDownloadUrl(docId);
+     *
+     * // Display in browser
+     * window.open(url, '_blank');
+     *
+     * // Or use in an img tag
+     * <img src={url} alt="Document" />
+     * ```
+     */
+    async getDownloadUrl(id) {
+        const response = await this.execute(() => this.trpc.documents.getDownloadUrl.query({ id }));
+        return response;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Retrieve
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Retrieves a document by ID
+     *
+     * @param id - Document ID
+     * @returns The document
+     */
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.documents.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a document by metadata key/value.
+     */
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.documents.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a document by externalId
+     */
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.documents.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Update
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Updates a document's metadata, expiration, or fields.
+     *
+     * Note: Status cannot be updated directly - it's managed by the system.
+     *
+     * @param id - Document ID
+     * @param data - Fields to update
+     * @returns The updated document
+     */
+    async update(id, data) {
+        const validated = this.validate(updateDocumentInputSchema, data);
+        const response = await this.execute(() => this.trpc.documents.update.mutate({
+            id,
+            data: validated,
+        }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Delete
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Soft-deletes a document
+     *
+     * @param id - Document ID
+     */
+    async delete(id) {
+        await this.execute(() => this.trpc.documents.delete.mutate({ id }));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists documents with optional filtering and pagination.
+     *
+     * @param options - List options with filter, cursor, and limit
+     * @returns Paginated list of documents
+     */
+    async list(options) {
+        const response = await this.execute(() => this.trpc.documents.list.query(options));
+        const typedResponse = response;
+        return {
+            data: typedResponse.data.map((d) => this.instantiate(d)),
+            pagination: typedResponse.pagination,
+        };
+    }
+    /**
+     * Lists all documents for a specific client with pagination.
+     *
+     * @param clientId - Client ID
+     * @param options - Pagination options
+     * @returns Paginated list of documents
+     */
+    async listByClient(clientId, options) {
+        const response = await this.execute(() => this.trpc.documents.listByClient.query({ clientId, ...options }));
+        const typedResponse = response;
+        return {
+            data: typedResponse.data.map((d) => this.instantiate(d)),
+            pagination: typedResponse.pagination,
+        };
+    }
+    /**
+     * Async iterator for documents with optional filtering.
+     *
+     * @param options - Filter options
+     * @yields Documents one at a time
+     */
+    async *iterate(options) {
+        let cursor;
+        let hasMore = true;
+        while (hasMore) {
+            const response = await this.list({
+                ...options,
+                cursor,
+                limit: options?.limit ?? 100,
+            });
+            for (const doc of response.data) {
+                yield doc;
+            }
+            cursor = response.pagination.nextCursor;
+            hasMore = response.pagination.hasMore;
+        }
+    }
+    async createMany(documents, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createDocumentInputSchema), documents);
+        const response = await this.execute(() => this.trpc.documents.createMany.mutate({ items: validated, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((d) => this.instantiate(d)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    async updateMany(updates, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = updates.map((u) => ({
+            id: u.id,
+            data: this.validate(updateDocumentInputSchema, u.data),
+        }));
+        const response = await this.execute(() => this.trpc.documents.updateMany.mutate({ items: validated, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((d) => this.instantiate(d)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Gets document count for a client
+     *
+     * @param clientId - Client ID
+     * @returns Count of documents
+     */
+    async countByClient(clientId) {
+        const response = await this.listByClient(clientId, { limit: 100 });
+        // For accurate count, we'd need a dedicated endpoint
+        // This is an approximation
+        let count = response.data.length;
+        let cursor = response.pagination.nextCursor;
+        while (response.pagination.hasMore && cursor) {
+            const next = await this.listByClient(clientId, { cursor, limit: 100 });
+            count += next.data.length;
+            cursor = next.pagination.nextCursor;
+            if (!next.pagination.hasMore)
+                break;
+        }
+        return count;
+    }
+    /**
+     * Checks if a document with the given type exists for a client
+     *
+     * @param clientId - Client ID
+     * @param type - Document type
+     * @returns True if document exists and is available
+     */
+    async hasDocumentType(clientId, type) {
+        const response = await this.list({
+            filter: { clientId, type },
+            limit: 1,
+        });
+        return response.data.some((d) => d.type === type && d.isAvailable);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Methods
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Instantiates a Document model from raw data.
+     * Override in subclasses to return jurisdiction-specific models.
+     */
+    instantiate(data) {
+        return new Document(data);
+    }
+}

package/dist/resources/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Resource Managers
+ *
+ * This module exports resource classes for interacting with
+ * the compliance API. Each resource handles CRUD operations,
+ * pagination, and error mapping for a specific entity type.
+ *
+ * Resource Hierarchy:
+ * - Base resources: Unscoped, accept full nested input
+ * - Mex resources: Mexico-scoped, accept flattened MX input
+ * - Activity resources: Activity-scoped, accept fully flattened input
+ */
+export { BaseResource, ReadOnlyResource, type ResourceConfig } from "./base";
+export { ClientsResource, type BatchOptions } from "./clients";
+export { TransactionsResource } from "./transactions";
+export type { RelatedClient, LinkedClient } from "@artu-ai/shared";
+export { ReportsResource, type ReportFilter, type ReportItemFilter, type AddItemsResult, } from "./reports";
+export { AddressesResource } from "./addresses";
+export { ContactMethodsResource } from "./contact-methods";
+export { BankAccountsResource } from "./bank-accounts";
+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

@@ -0,0 +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,EACL,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAGrB,cAAc,OAAO,CAAC"}

package/dist/resources/index.js

@@ -0,0 +1,25 @@
+/**
+ * Resource Managers
+ *
+ * This module exports resource classes for interacting with
+ * the compliance API. Each resource handles CRUD operations,
+ * pagination, and error mapping for a specific entity type.
+ *
+ * Resource Hierarchy:
+ * - Base resources: Unscoped, accept full nested input
+ * - Mex resources: Mexico-scoped, accept flattened MX input
+ * - Activity resources: Activity-scoped, accept fully flattened input
+ */
+// Base classes
+export { BaseResource, ReadOnlyResource } from "./base";
+// Base resource implementations (unscoped)
+export { ClientsResource } from "./clients";
+export { TransactionsResource } from "./transactions";
+export { ReportsResource, } from "./reports";
+// Supporting resources
+export { AddressesResource } from "./addresses";
+export { ContactMethodsResource } from "./contact-methods";
+export { BankAccountsResource } from "./bank-accounts";
+export { DocumentsResource, } from "./documents";
+// Mexico-scoped resources
+export * from "./mex";

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

@@ -0,0 +1,165 @@
+/**
+ * AVI (Activos Virtuales) Clients Resource
+ *
+ * Extends MexClientsResource with AVI-specific behavior:
+ * - Accepts flattened CreateAVIClientInput (AVI fields at root level)
+ * - Returns MexAVIClient models
+ */
+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";
+/**
+ * AVI (Activos Virtuales) scoped clients resource.
+ *
+ * Provides the same operations as MexClientsResource but with:
+ * - Flattened input types (AVI fields at root level)
+ * - MexAVIClient model return type
+ *
+ * @example
+ * ```typescript
+ * const aviSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.AVI,
+ * });
+ *
+ * // Create with fully flattened input
+ * const client = await aviSdk.clients.create({
+ *   type: ClientType.Person,
+ *   name: "Juan García",
+ *   rfc: "GAJL850101ABC",   // MX field
+ *   username: "JGARCIA",     // AVI field at root!
+ * });
+ *
+ * // Returns MexAVIClient
+ * console.log(client.username);
+ * ```
+ */
+export declare class AVIClientsResource extends MexClientsResource<AVIClientSort> {
+    /**
+     * Creates a new AVI client with fully flattened input.
+     */
+    create(data: CreateAVIClientInput): Promise<MexAVIClient>;
+    /**
+     * Retrieves a client by ID.
+     */
+    retrieve(id: string, include?: ClientIncludeMap): Promise<MexAVIClient>;
+    /**
+     * Retrieves an AVI client by externalId.
+     */
+    retrieveByExternalId(externalId: string): Promise<MexAVIClient>;
+    /**
+     * Updates an AVI client with flattened input.
+     */
+    update(id: string, data: UpdateAVIClientInput): Promise<MexAVIClient>;
+    /**
+     * Lists AVI clients with optional filtering.
+     *
+     * Accepts fully flattened AVI filter (MX and AVI fields at root level)
+     * and automatically transforms to nested format before calling the API.
+     *
+     * @example
+     * ```typescript
+     * const { data } = await aviSdk.clients.list({
+     *   filter: {
+     *     name: { contains: "García" },
+     *     rfc: { startsWith: "GAJL" },  // MX field at root
+     *     username: { contains: "jgarcia" },  // AVI field at root!
+     *   },
+     * });
+     * ```
+     */
+    list(options?: ListOptions<AVIClientFilter, AVIClientSort>): Promise<PaginatedResponse<MexAVIClient>>;
+    /**
+     * Iterates over AVI clients.
+     *
+     * Accepts fully flattened AVI filter (MX and AVI fields at root level)
+     * and automatically transforms to nested format before calling the API.
+     */
+    iterate(filter?: AVIClientFilter): AsyncGenerator<MexAVIClient, void, undefined>;
+    /**
+     * Creates multiple AVI clients with flattened input.
+     */
+    createMany(clients: CreateAVIClientInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexAVIClient>>;
+    createMany(clients: CreateAVIClientInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexAVIClient>>;
+    /**
+     * Updates multiple AVI clients.
+     */
+    updateMany(updates: {
+        id: string;
+        data: UpdateAVIClientInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexAVIClient>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateAVIClientInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexAVIClient>>;
+    linkClient(parentClientId: string, childClientId: string, relationshipType: ClientRelationshipType, metadata?: Record<string, unknown>): Promise<MexAVIClient>;
+    unlinkClient(parentClientId: string, childClientId: string, relationshipType: ClientRelationshipType): Promise<MexAVIClient>;
+    listLinkedClients(parentClientId: string, relationshipType?: ClientRelationshipType): Promise<LinkedClient[]>;
+    setLinkedClients(parentClientId: string, linkedClients: LinkedClientInput[]): Promise<MexAVIClient>;
+    syncAll(clientId: string, data: {
+        client?: UpdateAVIClientInput;
+        addresses?: SyncItem<CreateMexAddressInput>[];
+        contactMethods?: SyncItem<CreateContactMethodInput>[];
+        bankAccounts?: SyncItem<CreateBankAccountInput>[];
+        linkedClients?: LinkedClientInput[];
+    }, options: {
+        replaceMode: true;
+    }): Promise<{
+        client: MexAVIClient;
+        addresses: SyncResult<MexAddress>;
+        contactMethods: SyncResult<ContactMethod>;
+        bankAccounts: SyncResult<MexBankAccount>;
+    }>;
+    syncAll(clientId: string, data: {
+        client?: UpdateAVIClientInput;
+        addresses?: SyncItem<UpdateMexAddressInput>[];
+        contactMethods?: SyncItem<UpdateContactMethodInput>[];
+        bankAccounts?: SyncItem<UpdateBankAccountInput>[];
+        linkedClients?: LinkedClientInput[];
+    }, options?: {
+        replaceMode?: boolean;
+    }): Promise<{
+        client: MexAVIClient;
+        addresses: SyncResult<MexAddress>;
+        contactMethods: SyncResult<ContactMethod>;
+        bankAccounts: SyncResult<MexBankAccount>;
+    }>;
+    /**
+     * Transforms a flattened AVIClientFilter to nested ClientFilter format
+     * and applies Mexico jurisdiction scoping.
+     *
+     * Extracts AVI-specific fields (username) from root level and nests them
+     * 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.
+     */
+    protected transformToNested(data: CreateAVIClientInput): CreateClientInput;
+    /**
+     * Transforms flattened AVI update input to nested API format.
+     */
+    protected transformUpdateToNested(data: UpdateAVIClientInput): UpdateClientInput;
+    /**
+     * Instantiates a MexAVIClient model.
+     */
+    protected instantiate(data: ClientData): MexAVIClient;
+}
+//# sourceMappingURL=clients.d.ts.map

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

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