@artu-ai/compliance-sdk 0.13.4 → 0.17.0

package/dist/resources/mx/av/ari/transactions.js

@@ -9,6 +9,7 @@
 import { ariTransactionSortingFieldMapping, CodigoActividad, createARITransactionInputSchema, transformSort, updateARITransactionInputSchema, upsertARITransactionInputSchema, } from "@artu-ai/shared";
 import { z } from "zod";
 import { MexARITransaction } from "../../../../models";
+import { splitTransactionCreateFields, splitTransactionUpdateFields, } from "../../update-split";
 import { AVTransactionsResource } from "../transactions";
 // ===========================
 // ARITransactionsResource
@@ -20,7 +21,7 @@ import { AVTransactionsResource } from "../transactions";
  * ```typescript
  * const ariSdk = new ComplianceSDK({
  *   apiKey,
- *   jurisdiction: Jurisdiction.Mexico,
+ *   scope: "MX",
  *   actividadVulnerable: CodigoActividad.ARI,
  * });
  *
@@ -51,7 +52,11 @@ export class ARITransactionsResource extends AVTransactionsResource {
     // ─────────────────────────────────────────────────────────────────
     // CRUD Operations
     // ─────────────────────────────────────────────────────────────────
-    static SCOPE_PATH = ["MX", "actividadVulnerable", "ARI"];
+    static SCOPE_PATH = [
+        "MX",
+        "actividadVulnerable",
+        CodigoActividad.ARI,
+    ];
     async create(data) {
         const merged = await this.mergeProductDataFlat(data, ARITransactionsResource.SCOPE_PATH);
         const validated = this.validate(createARITransactionInputSchema, merged);
@@ -59,12 +64,19 @@ export class ARITransactionsResource extends AVTransactionsResource {
         const response = await this.execute(() => this.trpc.transactions.create.mutate(nestedData));
         return this.instantiate(response);
     }
-    async retrieve(id) {
-        const response = await this.execute(() => this.trpc.transactions.retrieve.query({ id }));
+    async retrieve(id, opts) {
+        const response = await this.execute(() => this.trpc.transactions.retrieve.query({
+            id,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
-    async retrieveByMetadata(key, value) {
-        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({ key, value }));
+    async retrieveByMetadata(key, value, opts) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({
+            key,
+            value,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
     async update(id, data) {
@@ -78,10 +90,11 @@ export class ARITransactionsResource extends AVTransactionsResource {
     // List & Pagination
     // ─────────────────────────────────────────────────────────────────
     async list(options) {
-        const scopedFilter = this.applyScopeToFilter(options?.filter);
-        const scopedSort = this.applyScopeToSort(options?.sort);
+        const { crossScope, ...rest } = options ?? {};
+        const scopedFilter = this.applyAutoScope(this.applyScopeToFilter(rest.filter), crossScope);
+        const scopedSort = this.applyScopeToSort(rest.sort);
         const response = await this.execute(() => this.trpc.transactions.list.query({
-            ...options,
+            ...rest,
             filter: scopedFilter,
             sort: scopedSort,
         }));
@@ -91,15 +104,17 @@ export class ARITransactionsResource extends AVTransactionsResource {
         };
     }
     iterate(options) {
-        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        // Do NOT apply scope here — createIterator calls this.list(), which
+        // applies the flatten transform AND auto-scope exactly once.
         return this.createIterator({
-            filter: scopedFilter,
+            filter: options?.filter,
             sort: options?.sort,
             pageSize: options?.pageSize,
+            crossScope: options?.crossScope,
         });
     }
-    async count(filter) {
-        const scopedFilter = this.applyScopeToFilter(filter);
+    async count(filter, options) {
+        const scopedFilter = this.applyAutoScope(this.applyScopeToFilter(filter), options?.crossScope);
         const response = await this.execute(() => this.trpc.transactions.count.query({ filter: scopedFilter }));
         return response.count;
     }
@@ -244,71 +259,28 @@ export class ARITransactionsResource extends AVTransactionsResource {
     // Protected Helpers
     // ─────────────────────────────────────────────────────────────────
     transformToNested(data) {
-        const { amount, currency, timestamp, relatedClientIds, description, externalId, metadata, operationType, property, payments, } = data;
-        const baseFields = {
-            amount,
-            currency,
-            timestamp,
-            relatedClientIds,
-        };
-        if (description !== undefined)
-            baseFields.description = description;
-        if (externalId !== undefined)
-            baseFields.externalId = externalId;
-        if (metadata !== undefined)
-            baseFields.metadata = metadata;
+        const { base, scopeData } = splitTransactionCreateFields(data, ARITransactionsResource.SCOPE_PATH);
         return {
-            ...baseFields,
+            ...base,
             scopes: ["MX", "MX:AV", "MX:AV:ARI"],
-            jurisdictions: {
-                MX: {
-                    actividadVulnerable: {
-                        [CodigoActividad.ARI]: { operationType, property, payments },
-                    },
-                },
-            },
+            scopeData,
         };
     }
     transformUpdateToNested(data) {
-        const input = data;
-        const { amount, currency, status, description, externalId, metadata, exchangeRates, operationType, property, payments, } = input;
-        const result = {};
-        if (amount !== undefined)
-            result.amount = amount;
-        if (currency !== undefined)
-            result.currency = currency;
-        if (status !== undefined)
-            result.status = status;
-        if (description !== undefined)
-            result.description = description;
-        if (externalId !== undefined)
-            result.externalId = externalId;
-        if (metadata !== undefined)
-            result.metadata = metadata;
-        if (exchangeRates !== undefined)
-            result.exchangeRates =
-                exchangeRates;
-        const ariData = {};
-        if (operationType !== undefined)
-            ariData.operationType = operationType;
-        if (property !== undefined)
-            ariData.property = property;
-        if (payments !== undefined)
-            ariData.payments = payments;
-        const resultRecord = result;
-        resultRecord.scopes = ["MX", "MX:AV", "MX:AV:ARI"];
-        resultRecord.jurisdictions = {
-            MX: {
-                actividadVulnerable: {
-                    [CodigoActividad.ARI]: ariData,
-                },
-            },
+        const { base, scopeData } = splitTransactionUpdateFields(data, ARITransactionsResource.SCOPE_PATH);
+        return {
+            ...base,
+            scopes: ["MX", "MX:AV", "MX:AV:ARI"],
+            scopeData,
         };
-        return result;
     }
     instantiate(data) {
         return new MexARITransaction(data);
     }
+    /** Materializes a raw payload into a {@link MexARITransaction} (return type narrowed via the `instantiate` override). */
+    materialize(data) {
+        return this.instantiate(data);
+    }
     applyScopeToSort(sort) {
         if (!sort || sort.length === 0) {
             return undefined;

package/dist/resources/mx/av/avi/alerts.d.ts

@@ -17,7 +17,7 @@ import { AVAlertsResource } from "../alerts";
  * ```typescript
  * const aviSdk = new ComplianceSDK({
  *   apiKey,
- *   jurisdiction: Jurisdiction.Mexico,
+ *   scope: "MX",
  *   actividadVulnerable: CodigoActividad.AVI,
  * });
  *
@@ -32,16 +32,24 @@ import { AVAlertsResource } from "../alerts";
  */
 export declare class AVIAlertsResource extends AVAlertsResource {
     create(data: CreateAVIAlertInput): Promise<MexAVIAlert>;
-    retrieve(id: string): Promise<MexAVIAlert>;
-    retrieveByMetadata(key: string, value: string): Promise<MexAVIAlert>;
-    retrieveByExternalId(externalId: string): Promise<MexAVIAlert>;
+    retrieve(id: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVIAlert>;
+    retrieveByMetadata(key: string, value: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVIAlert>;
+    retrieveByExternalId(externalId: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVIAlert>;
     update(id: string, data: UpdateAVIAlertInput): Promise<MexAVIAlert>;
     /**
      * Lists AVI alerts with optional filtering.
      *
      * Accepts flattened AVI filter (future AVI-specific alert fields at root level).
      */
-    list(options?: ListOptions<AVIAlertFilter, AVIAlertSort>): Promise<PaginatedResponse<MexAVIAlert>>;
+    list(options?: ListOptions<AVIAlertFilter, AVIAlertSort> & {
+        crossScope?: boolean;
+    }): Promise<PaginatedResponse<MexAVIAlert>>;
     /**
      * Iterates over AVI alerts.
      *
@@ -51,6 +59,7 @@ export declare class AVIAlertsResource extends AVAlertsResource {
         filter?: AVIAlertFilter;
         sort?: AVIAlertSort;
         pageSize?: number;
+        crossScope?: boolean;
     }): AsyncGenerator<MexAVIAlert, void, undefined>;
     /**
      * Counts AVI alerts matching the given filter.
@@ -58,7 +67,9 @@ export declare class AVIAlertsResource extends AVAlertsResource {
      * @param filter - Optional filter criteria (with AVI fields at root level)
      * @returns The count of matching alerts
      */
-    count(filter?: AVIAlertFilter): Promise<number>;
+    count(filter?: AVIAlertFilter, options?: {
+        crossScope?: boolean;
+    }): Promise<number>;
     createMany(alerts: CreateAVIAlertInput[], options?: {
         atomic?: true;
     }): Promise<AtomicBatchResult<MexAVIAlert>>;
@@ -201,6 +212,13 @@ export declare class AVIAlertsResource extends AVAlertsResource {
                     nin?: ("100" | "9999" | "4101" | "4102" | "4103" | "4104" | "4105" | "4106" | "4107" | "4108" | "4109" | "4110" | "4111" | "4112" | "4113" | "4114" | "4115" | "4116" | "4117" | "4118" | "4119" | "4120" | "4121" | "4122")[] | undefined;
                 } | undefined;
             } | undefined;
+            INM?: {
+                alertType?: "100" | "9999" | "3101" | "3102" | "3103" | "3104" | "3105" | "3106" | "3107" | "3108" | "3109" | "3110" | "3111" | "3112" | "3113" | "3114" | "3115" | "3116" | "3117" | "3118" | "3119" | "3120" | {
+                    eq?: "100" | "9999" | "3101" | "3102" | "3103" | "3104" | "3105" | "3106" | "3107" | "3108" | "3109" | "3110" | "3111" | "3112" | "3113" | "3114" | "3115" | "3116" | "3117" | "3118" | "3119" | "3120" | undefined;
+                    in?: ("100" | "9999" | "3101" | "3102" | "3103" | "3104" | "3105" | "3106" | "3107" | "3108" | "3109" | "3110" | "3111" | "3112" | "3113" | "3114" | "3115" | "3116" | "3117" | "3118" | "3119" | "3120")[] | undefined;
+                    nin?: ("100" | "9999" | "3101" | "3102" | "3103" | "3104" | "3105" | "3106" | "3107" | "3108" | "3109" | "3110" | "3111" | "3112" | "3113" | "3114" | "3115" | "3116" | "3117" | "3118" | "3119" | "3120")[] | undefined;
+                } | undefined;
+            } | undefined;
             JYS?: {
                 alertType?: "100" | "9999" | "2101" | "2102" | "2103" | "2104" | "2105" | "2106" | "2107" | "2108" | "2109" | "2110" | "2111" | "2112" | "2113" | "2114" | "2115" | "2116" | "2117" | "2118" | "2119" | "2120" | "2121" | "2122" | "2123" | "2124" | "2125" | "2126" | "2127" | {
                     eq?: "100" | "9999" | "2101" | "2102" | "2103" | "2104" | "2105" | "2106" | "2107" | "2108" | "2109" | "2110" | "2111" | "2112" | "2113" | "2114" | "2115" | "2116" | "2117" | "2118" | "2119" | "2120" | "2121" | "2122" | "2123" | "2124" | "2125" | "2126" | "2127" | undefined;
@@ -215,6 +233,13 @@ export declare class AVIAlertsResource extends AVAlertsResource {
                     nin?: ("100" | "9999" | "2901" | "2902" | "2903" | "2904" | "2905" | "2906" | "2907" | "2908" | "2909" | "2910" | "2911" | "2912" | "2913" | "2914" | "2915" | "2916" | "2917" | "2918" | "2919" | "2920" | "2921" | "2922" | "2923" | "2924" | "2925")[] | undefined;
                 } | undefined;
             } | undefined;
+            MPC?: {
+                alertType?: "100" | "9999" | "2801" | "2802" | "2803" | "2804" | "2805" | "2806" | "2807" | "2808" | "2809" | "2810" | "2811" | "2812" | "2813" | "2814" | {
+                    eq?: "100" | "9999" | "2801" | "2802" | "2803" | "2804" | "2805" | "2806" | "2807" | "2808" | "2809" | "2810" | "2811" | "2812" | "2813" | "2814" | undefined;
+                    in?: ("100" | "9999" | "2801" | "2802" | "2803" | "2804" | "2805" | "2806" | "2807" | "2808" | "2809" | "2810" | "2811" | "2812" | "2813" | "2814")[] | undefined;
+                    nin?: ("100" | "9999" | "2801" | "2802" | "2803" | "2804" | "2805" | "2806" | "2807" | "2808" | "2809" | "2810" | "2811" | "2812" | "2813" | "2814")[] | undefined;
+                } | undefined;
+            } | undefined;
             TSC?: {
                 alertType?: "100" | "9999" | "2201" | "2202" | "2203" | "2204" | "2205" | "2206" | "2207" | "2208" | "2209" | "2210" | "2211" | "2212" | "2213" | "2214" | "2215" | "2216" | {
                     eq?: "100" | "9999" | "2201" | "2202" | "2203" | "2204" | "2205" | "2206" | "2207" | "2208" | "2209" | "2210" | "2211" | "2212" | "2213" | "2214" | "2215" | "2216" | undefined;
@@ -222,6 +247,13 @@ export declare class AVIAlertsResource extends AVAlertsResource {
                     nin?: ("100" | "9999" | "2201" | "2202" | "2203" | "2204" | "2205" | "2206" | "2207" | "2208" | "2209" | "2210" | "2211" | "2212" | "2213" | "2214" | "2215" | "2216")[] | undefined;
                 } | undefined;
             } | undefined;
+            VEH?: {
+                alertType?: "100" | "9999" | "2501" | "2502" | "2503" | "2504" | "2505" | "2506" | "2507" | "2508" | "2509" | "2510" | "2511" | "2512" | "2513" | "2514" | "2515" | "2516" | "2517" | "2518" | "2519" | "2520" | "2521" | {
+                    eq?: "100" | "9999" | "2501" | "2502" | "2503" | "2504" | "2505" | "2506" | "2507" | "2508" | "2509" | "2510" | "2511" | "2512" | "2513" | "2514" | "2515" | "2516" | "2517" | "2518" | "2519" | "2520" | "2521" | undefined;
+                    in?: ("100" | "9999" | "2501" | "2502" | "2503" | "2504" | "2505" | "2506" | "2507" | "2508" | "2509" | "2510" | "2511" | "2512" | "2513" | "2514" | "2515" | "2516" | "2517" | "2518" | "2519" | "2520" | "2521")[] | undefined;
+                    nin?: ("100" | "9999" | "2501" | "2502" | "2503" | "2504" | "2505" | "2506" | "2507" | "2508" | "2509" | "2510" | "2511" | "2512" | "2513" | "2514" | "2515" | "2516" | "2517" | "2518" | "2519" | "2520" | "2521")[] | undefined;
+                } | undefined;
+            } | undefined;
             alertDescription?: string | {
                 eq?: string | undefined;
                 contains?: string | undefined;
@@ -251,7 +283,7 @@ export declare class AVIAlertsResource extends AVAlertsResource {
     /**
      * Validates an AVI alert.
      *
-     * Uses AVI-scoped validation input (jurisdiction and activity are implicit).
+     * Uses AVI-scoped validation input (scope and activity are implicit).
      *
      * @param alertId - The alert ID to validate
      * @param defaults - AVI alert defaults including rfc, platformDomain, alertType, etc.
@@ -328,6 +360,8 @@ export declare class AVIAlertsResource extends AVAlertsResource {
      */
     protected transformUpdateToNested(data: UpdateAVIAlertInput): UpdateAlertInput;
     protected instantiate(data: AlertData): MexAVIAlert;
+    /** Materializes a raw payload into a {@link MexAVIAlert} (return type narrowed via the `instantiate` override). */
+    materialize(data: AlertData): MexAVIAlert;
     protected instantiateItem(data: AlertItemData): MexAVIAlertItem;
     protected instantiateTransactionItem(data: AlertTransactionItemData): MexAVIAlertTransactionItem;
     protected instantiateClientItem(data: AlertClientItemData): MexAVIAlertClientItem;
@@ -342,4 +376,3 @@ export declare class AVIAlertsResource extends AVAlertsResource {
         defaults?: unknown;
     };
 }
-//# sourceMappingURL=alerts.d.ts.map

package/dist/resources/mx/av/avi/alerts.js

@@ -20,7 +20,7 @@ import { AVAlertsResource } from "../alerts";
  * ```typescript
  * const aviSdk = new ComplianceSDK({
  *   apiKey,
- *   jurisdiction: Jurisdiction.Mexico,
+ *   scope: "MX",
  *   actividadVulnerable: CodigoActividad.AVI,
  * });
  *
@@ -43,16 +43,26 @@ export class AVIAlertsResource extends AVAlertsResource {
         const response = await this.execute(() => this.trpc.alerts.create.mutate(nestedData));
         return this.instantiate(response);
     }
-    async retrieve(id) {
-        const response = await this.execute(() => this.trpc.alerts.retrieve.query({ id }));
+    async retrieve(id, opts) {
+        const response = await this.execute(() => this.trpc.alerts.retrieve.query({
+            id,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
-    async retrieveByMetadata(key, value) {
-        const response = await this.execute(() => this.trpc.alerts.retrieveByMetadata.query({ key, value }));
+    async retrieveByMetadata(key, value, opts) {
+        const response = await this.execute(() => this.trpc.alerts.retrieveByMetadata.query({
+            key,
+            value,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
-    async retrieveByExternalId(externalId) {
-        const response = await this.execute(() => this.trpc.alerts.retrieveByExternalId.query({ externalId }));
+    async retrieveByExternalId(externalId, opts) {
+        const response = await this.execute(() => this.trpc.alerts.retrieveByExternalId.query({
+            externalId,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
     async update(id, data) {
@@ -70,10 +80,11 @@ export class AVIAlertsResource extends AVAlertsResource {
      * Accepts flattened AVI filter (future AVI-specific alert fields at root level).
      */
     async list(options) {
-        const scopedFilter = this.applyScopeToFilter(options?.filter);
-        const scopedSort = this.applyScopeToSort(options?.sort);
+        const { crossScope, ...rest } = options ?? {};
+        const scopedFilter = this.applyAutoScope(this.applyScopeToFilter(rest.filter), crossScope);
+        const scopedSort = this.applyScopeToSort(rest.sort);
         const response = await this.execute(() => this.trpc.alerts.list.query({
-            ...options,
+            ...rest,
             filter: scopedFilter,
             sort: scopedSort,
         }));
@@ -88,12 +99,13 @@ export class AVIAlertsResource extends AVAlertsResource {
      * Accepts flattened AVI filter (future AVI-specific alert fields at root level).
      */
     iterate(options) {
-        const scopedFilter = this.applyScopeToFilter(options?.filter);
-        // Note: sort is passed through - createIterator calls list() which handles transformation
+        // Do NOT apply scope here — createIterator calls this.list(), which
+        // applies the flatten transform AND auto-scope exactly once.
         return this.createIterator({
-            filter: scopedFilter,
+            filter: options?.filter,
             sort: options?.sort,
             pageSize: options?.pageSize,
+            crossScope: options?.crossScope,
         });
     }
     /**
@@ -102,8 +114,8 @@ export class AVIAlertsResource extends AVAlertsResource {
      * @param filter - Optional filter criteria (with AVI fields at root level)
      * @returns The count of matching alerts
      */
-    async count(filter) {
-        const scopedFilter = this.applyScopeToFilter(filter);
+    async count(filter, options) {
+        const scopedFilter = this.applyAutoScope(this.applyScopeToFilter(filter), options?.crossScope);
         const response = await this.execute(() => this.trpc.alerts.count.query({ filter: scopedFilter }));
         return response.count;
     }
@@ -264,7 +276,7 @@ export class AVIAlertsResource extends AVAlertsResource {
             avFilter.alertDescription = alertDescription;
         return {
             ...baseFields,
-            jurisdictions: {
+            scopeData: {
                 MX: {
                     actividadVulnerable: {
                         ...avFilter,
@@ -334,7 +346,7 @@ export class AVIAlertsResource extends AVAlertsResource {
     /**
      * Validates an AVI alert.
      *
-     * Uses AVI-scoped validation input (jurisdiction and activity are implicit).
+     * Uses AVI-scoped validation input (scope and activity are implicit).
      *
      * @param alertId - The alert ID to validate
      * @param defaults - AVI alert defaults including rfc, platformDomain, alertType, etc.
@@ -446,11 +458,11 @@ export class AVIAlertsResource extends AVAlertsResource {
         });
         // Only add AVI activity filter if username is provided
         if (username !== undefined) {
-            const mexJurisdiction = (nestedFilter?.jurisdictions?.MX ?? {});
+            const mexJurisdiction = (nestedFilter?.scopeData?.MX ?? {});
             return {
                 ...nestedFilter,
-                jurisdictions: {
-                    ...nestedFilter?.jurisdictions,
+                scopeData: {
+                    ...nestedFilter?.scopeData,
                     MX: {
                         ...mexJurisdiction,
                         actividadVulnerable: {
@@ -495,8 +507,8 @@ export class AVIAlertsResource extends AVAlertsResource {
             ...(hasBaseFields ? { hasErrors } : {}),
             ...(hasSubcategoryFields || hasAvFields
                 ? {
-                    jurisdictions: {
-                        ...existing?.jurisdictions,
+                    scopeData: {
+                        ...existing?.scopeData,
                         MX: {
                             actividadVulnerable: {
                                 ...avFilter,
@@ -515,7 +527,7 @@ export class AVIAlertsResource extends AVAlertsResource {
         return {
             ...baseFields,
             scope: "MX:AV:AVI",
-            jurisdictions: {
+            scopeData: {
                 MX: {
                     actividadVulnerable: {
                         // mesReportado lives at AV level (not subcategory)
@@ -539,7 +551,7 @@ export class AVIAlertsResource extends AVAlertsResource {
         return {
             ...data,
             scope: "MX:AV:AVI",
-            jurisdictions: {
+            scopeData: {
                 MX: {
                     actividadVulnerable: {
                         [CodigoActividad.AVI]: {},
@@ -551,6 +563,10 @@ export class AVIAlertsResource extends AVAlertsResource {
     instantiate(data) {
         return new MexAVIAlert(data);
     }
+    /** Materializes a raw payload into a {@link MexAVIAlert} (return type narrowed via the `instantiate` override). */
+    materialize(data) {
+        return this.instantiate(data);
+    }
     instantiateItem(data) {
         return new MexAVIAlertItem(data);
     }
@@ -574,7 +590,7 @@ export class AVIAlertsResource extends AVAlertsResource {
             avData.amendment = amendment;
         return {
             ...baseFields,
-            jurisdictions: {
+            scopeData: {
                 MX: {
                     actividadVulnerable: {
                         ...avData,
@@ -603,7 +619,7 @@ export class AVIAlertsResource extends AVAlertsResource {
         }
         return {
             ...baseFields,
-            jurisdictions: {
+            scopeData: {
                 MX: {
                     actividadVulnerable: {
                         ...avData,
@@ -630,7 +646,7 @@ export class AVIAlertsResource extends AVAlertsResource {
             alertId,
             reportType: ReportType.MexActividadVulnerableAVI,
             defaults: {
-                jurisdictions: {
+                scopeData: {
                     MX: {
                         actividadVulnerable: {
                             rfc,

package/dist/resources/mx/av/avi/clients.d.ts

@@ -8,6 +8,7 @@
 import type { AtomicBatchResult, AVIClientFilter, AVIClientSort, ClientFilter, ClientRelationshipType, ClientSort, CreateAVIClientInput, CreateBankAccountInput, CreateClientInput, CreateContactMethodInput, CreateMexAddressInput, LinkedClient as LinkedClientInput, ListOptions, PaginatedResponse, PartialBatchResult, SyncCreateDocumentInput, SyncItem, SyncResult, SyncUpdateDocumentInput, UpdateAVIClientInput, UpdateBankAccountInput, UpdateClientInput, UpdateContactMethodInput, UpdateMexAddressInput, UpsertAVIClientInput, UpsertResult } from "@artu-ai/shared";
 import { type ClientData, ContactMethod, Document, LinkedClient, MexAddress, MexAVIClient, MexBankAccount } from "../../../../models";
 import { type ClientIncludeMap } from "../../../clients";
+import type { RelatedPartyParent, RelatedPartySubresource } from "../../../related-parties/base";
 import { AVClientsResource } from "../clients";
 /**
  * AVI (Activos Virtuales) scoped clients resource.
@@ -21,7 +22,7 @@ import { AVClientsResource } from "../clients";
  * const aviSdk = new ComplianceSDK({
  *   apiKey,
  *   environment: "test",
- *   jurisdiction: Jurisdiction.Mexico,
+ *   scope: "MX",
  *   actividadVulnerable: CodigoActividad.AVI,
  * });
  *
@@ -38,6 +39,9 @@ import { AVClientsResource } from "../clients";
  * ```
  */
 export declare class AVIClientsResource extends AVClientsResource {
+    readonly legalRepresentatives: RelatedPartySubresource<MexAVIClient, CreateAVIClientInput>;
+    readonly controllingBeneficiaries: RelatedPartySubresource<MexAVIClient, CreateAVIClientInput>;
+    protected relatedPartyParent(): RelatedPartyParent<MexAVIClient, CreateAVIClientInput>;
     /**
      * Creates a new AVI client with fully flattened input.
      */
@@ -45,11 +49,16 @@ export declare class AVIClientsResource extends AVClientsResource {
     /**
      * Retrieves a client by ID.
      */
-    retrieve(id: string, include?: ClientIncludeMap): Promise<MexAVIClient>;
+    retrieve(id: string, options?: {
+        include?: ClientIncludeMap;
+        crossScope?: boolean;
+    }): Promise<MexAVIClient>;
     /**
      * Retrieves an AVI client by externalId.
      */
-    retrieveByExternalId(externalId: string): Promise<MexAVIClient>;
+    retrieveByExternalId(externalId: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVIClient>;
     /**
      * Updates an AVI client with flattened input.
      */
@@ -71,7 +80,11 @@ export declare class AVIClientsResource extends AVClientsResource {
      * });
      * ```
      */
-    list(options?: ListOptions<AVIClientFilter, AVIClientSort>): Promise<PaginatedResponse<MexAVIClient>>;
+    list(options?: ListOptions<AVIClientFilter, AVIClientSort> & {
+        includePrimaryContacts?: boolean;
+        includeNonPrimary?: boolean;
+        crossScope?: boolean;
+    }): Promise<PaginatedResponse<MexAVIClient>>;
     /**
      * Iterates over AVI clients.
      *
@@ -82,6 +95,7 @@ export declare class AVIClientsResource extends AVClientsResource {
         filter?: AVIClientFilter;
         sort?: AVIClientSort;
         pageSize?: number;
+        crossScope?: boolean;
     }): AsyncGenerator<MexAVIClient, void, undefined>;
     /**
      * Counts AVI clients matching the given filter.
@@ -89,7 +103,10 @@ export declare class AVIClientsResource extends AVClientsResource {
      * @param filter - Optional filter criteria (with AVI fields at root level)
      * @returns The count of matching clients
      */
-    count(filter?: AVIClientFilter): Promise<number>;
+    count(filter?: AVIClientFilter, options?: {
+        includeNonPrimary?: boolean;
+        crossScope?: boolean;
+    }): Promise<number>;
     /**
      * Creates multiple AVI clients with flattened input.
      */
@@ -190,10 +207,10 @@ export declare class AVIClientsResource extends AVClientsResource {
      * Transforms a flattened AVIClientFilter to nested ClientFilter format.
      *
      * Extracts AVI-specific fields (username) from root level and nests them
-     * under jurisdictions.MX.actividadVulnerable.AVI.
+     * under scopeData.MX.actividadVulnerable.AVI.
      *
      * Note: This method only transforms filters, it does not automatically add
-     * jurisdiction or activity scoping. Use explicit filters if needed.
+     * scope or activity scoping. Use explicit filters if needed.
      */
     protected applyScopeToFilter(filter?: AVIClientFilter): ClientFilter | undefined;
     /**
@@ -218,5 +235,6 @@ export declare class AVIClientsResource extends AVClientsResource {
      * Instantiates a MexAVIClient model.
      */
     protected instantiate(data: ClientData): MexAVIClient;
+    /** Materializes a raw payload into a {@link MexAVIClient} (return type narrowed via the `instantiate` override). */
+    materialize(data: ClientData): MexAVIClient;
 }
-//# sourceMappingURL=clients.d.ts.map