@artu-ai/compliance-sdk 0.13.4 → 0.17.0

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

@@ -24,7 +24,7 @@ import { AVClientsResource } from "../clients";
  * const aviSdk = new ComplianceSDK({
  *   apiKey,
  *   environment: "test",
- *   jurisdiction: Jurisdiction.Mexico,
+ *   scope: "MX",
  *   actividadVulnerable: CodigoActividad.AVI,
  * });
  *
@@ -41,6 +41,9 @@ import { AVClientsResource } from "../clients";
  * ```
  */
 export class AVIClientsResource extends AVClientsResource {
+    relatedPartyParent() {
+        return this.makeRelatedPartyParent((input) => this.transformToNested(this.validate(createAVIClientInputSchema, input)));
+    }
     // ─────────────────────────────────────────────────────────────────
     // CRUD Operations
     // ─────────────────────────────────────────────────────────────────
@@ -56,15 +59,22 @@ export class AVIClientsResource extends AVClientsResource {
     /**
      * Retrieves a client by ID.
      */
-    async retrieve(id, include) {
-        const response = await this.execute(() => this.trpc.clients.retrieve.query({ id, include }));
+    async retrieve(id, options) {
+        const response = await this.execute(() => this.trpc.clients.retrieve.query({
+            id,
+            include: options?.include,
+            requireScope: this.buildRequireScope(options?.crossScope),
+        }));
         return this.instantiate(response);
     }
     /**
      * Retrieves an AVI client by externalId.
      */
-    async retrieveByExternalId(externalId) {
-        const response = await this.execute(() => this.trpc.clients.retrieveByExternalId.query({ externalId }));
+    async retrieveByExternalId(externalId, opts) {
+        const response = await this.execute(() => this.trpc.clients.retrieveByExternalId.query({
+            externalId,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
     /**
@@ -97,10 +107,11 @@ export class AVIClientsResource extends AVClientsResource {
      * ```
      */
     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.clients.list.query({
-            ...options,
+            ...rest,
             filter: scopedFilter,
             sort: scopedSort,
         }));
@@ -116,12 +127,14 @@ export class AVIClientsResource extends AVClientsResource {
      * and automatically transforms to nested format before calling the API.
      */
     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. Pre-applying
+        // either here would double-inject.
         return this.createIterator({
-            filter: scopedFilter,
+            filter: options?.filter,
             sort: options?.sort,
             pageSize: options?.pageSize,
+            crossScope: options?.crossScope,
         });
     }
     /**
@@ -130,9 +143,12 @@ export class AVIClientsResource extends AVClientsResource {
      * @param filter - Optional filter criteria (with AVI fields at root level)
      * @returns The count of matching clients
      */
-    async count(filter) {
-        const scopedFilter = this.applyScopeToFilter(filter);
-        const response = await this.execute(() => this.trpc.clients.count.query({ filter: scopedFilter }));
+    async count(filter, options) {
+        const scopedFilter = this.applyAutoScope(this.applyScopeToFilter(filter), options?.crossScope);
+        const response = await this.execute(() => this.trpc.clients.count.query({
+            filter: scopedFilter,
+            includeNonPrimary: options?.includeNonPrimary,
+        }));
         return response.count;
     }
     async createMany(clients, options = {}) {
@@ -294,10 +310,10 @@ export 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.
      */
     applyScopeToFilter(filter) {
         if (!filter) {
@@ -309,11 +325,11 @@ export class AVIClientsResource extends AVClientsResource {
         const nestedFilter = super.applyScopeToFilter(mexFilter);
         // 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: {
@@ -344,12 +360,12 @@ export class AVIClientsResource extends AVClientsResource {
         const { username, ...restData } = data;
         // Use parent for base + MX fields
         const nested = super.transformToNested(restData);
-        // Add AVI activity data (parent always provides jurisdictions.MX)
-        const mexData = nested.jurisdictions?.MX;
+        // Add AVI activity data (parent always provides scopeData.MX)
+        const mexData = nested.scopeData?.MX;
         return {
             ...nested,
             scopes: ["MX", "MX:AV", "MX:AV:AVI"],
-            jurisdictions: {
+            scopeData: {
                 MX: {
                     ...mexData,
                     actividadVulnerable: {
@@ -372,7 +388,7 @@ export class AVIClientsResource extends AVClientsResource {
         // Use parent for base + MX fields
         const nested = super.transformUpdateToNested(restData);
         // Always add AVI activity data to ensure filterability
-        const mexData = (nested.jurisdictions?.MX ??
+        const mexData = (nested.scopeData?.MX ??
             {});
         // Build AVI data object (empty if no fields provided)
         const aviData = {};
@@ -385,7 +401,7 @@ export class AVIClientsResource extends AVClientsResource {
         return {
             ...nested,
             scopes: ["MX", "MX:AV", "MX:AV:AVI"],
-            jurisdictions: { MX: mexData },
+            scopeData: { MX: mexData },
         };
     }
     /**
@@ -394,4 +410,8 @@ export class AVIClientsResource extends AVClientsResource {
     instantiate(data) {
         return new MexAVIClient(data);
     }
+    /** Materializes a raw payload into a {@link MexAVIClient} (return type narrowed via the `instantiate` override). */
+    materialize(data) {
+        return this.instantiate(data);
+    }
 }

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

@@ -5,4 +5,3 @@ export { AVIAlertsResource } from "./alerts";
 export { AVIClientsResource } from "./clients";
 export { AVIProductsResource } from "./products";
 export { AVITransactionsResource } from "./transactions";
-//# sourceMappingURL=index.d.ts.map

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

@@ -10,19 +10,29 @@ import { MexAVIProduct, type ProductData } from "../../../../models";
 import { AVProductsResource } from "../products";
 export declare class AVIProductsResource extends AVProductsResource {
     create(data: CreateAVIProductInput): Promise<MexAVIProduct>;
-    retrieve(id: string): Promise<MexAVIProduct>;
-    retrieveByExternalId(externalId: string): Promise<MexAVIProduct>;
+    retrieve(id: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVIProduct>;
+    retrieveByExternalId(externalId: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVIProduct>;
     update(id: string, data: UpdateAVIProductInput): Promise<MexAVIProduct>;
-    list(options?: ListOptions<ProductFilter, ProductSort>): Promise<PaginatedResponse<MexAVIProduct>>;
-    count(filter?: ProductFilter): Promise<number>;
+    list(options?: ListOptions<ProductFilter, ProductSort> & {
+        crossScope?: boolean;
+    }): Promise<PaginatedResponse<MexAVIProduct>>;
+    count(filter?: ProductFilter, options?: {
+        crossScope?: boolean;
+    }): Promise<number>;
     iterate(options?: {
         filter?: ProductFilter;
         sort?: ProductSort;
         pageSize?: number;
+        crossScope?: boolean;
     }): AsyncGenerator<MexAVIProduct, void, undefined>;
     upsertByExternalId(data: UpsertAVIProductInput): Promise<UpsertResult<MexAVIProduct>>;
     protected transformToNested(data: CreateAVIProductInput): CreateProductInput;
     protected transformUpdateToNested(data: UpdateAVIProductInput): UpdateProductInput;
     protected instantiate(data: ProductData): MexAVIProduct;
+    /** Materializes a raw payload into a {@link MexAVIProduct} (return type narrowed via the `instantiate` override). */
+    materialize(data: ProductData): MexAVIProduct;
 }
-//# sourceMappingURL=products.d.ts.map

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

@@ -21,12 +21,18 @@ export class AVIProductsResource extends AVProductsResource {
         const response = await this.execute(() => this.trpc.products.create.mutate(nestedData));
         return this.instantiate(response);
     }
-    async retrieve(id) {
-        const response = await this.execute(() => this.trpc.products.retrieve.query({ id }));
+    async retrieve(id, opts) {
+        const response = await this.execute(() => this.trpc.products.retrieve.query({
+            id,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
-    async retrieveByExternalId(externalId) {
-        const response = await this.execute(() => this.trpc.products.retrieveByExternalId.query({ externalId }));
+    async retrieveByExternalId(externalId, opts) {
+        const response = await this.execute(() => this.trpc.products.retrieveByExternalId.query({
+            externalId,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
     async update(id, data) {
@@ -39,14 +45,17 @@ export class AVIProductsResource extends AVProductsResource {
     // List & Pagination
     // ─────────────────────────────────────────────────────────────────
     async list(options) {
-        const response = await this.execute(() => this.trpc.products.list.query(options));
+        const { crossScope, ...rest } = options ?? {};
+        const filter = this.applyAutoScope(rest.filter, crossScope);
+        const response = await this.execute(() => this.trpc.products.list.query({ ...rest, filter }));
         return {
             data: response.data.map((p) => this.instantiate(p)),
             pagination: response.pagination,
         };
     }
-    async count(filter) {
-        const response = await this.execute(() => this.trpc.products.count.query({ filter }));
+    async count(filter, options) {
+        const scopedFilter = this.applyAutoScope(filter, options?.crossScope);
+        const response = await this.execute(() => this.trpc.products.count.query({ filter: scopedFilter }));
         return response.count;
     }
     iterate(options) {
@@ -54,6 +63,7 @@ export class AVIProductsResource extends AVProductsResource {
             filter: options?.filter,
             sort: options?.sort,
             pageSize: options?.pageSize,
+            crossScope: options?.crossScope,
         });
     }
     // ─────────────────────────────────────────────────────────────────
@@ -83,7 +93,7 @@ export class AVIProductsResource extends AVProductsResource {
         return {
             ...baseFields,
             scopes: ["MX", "MX:AV", "MX:AV:AVI"],
-            jurisdictions: {
+            scopeData: {
                 MX: {
                     actividadVulnerable: {
                         [CodigoActividad.AVI]: aviFields,
@@ -104,7 +114,7 @@ export class AVIProductsResource extends AVProductsResource {
         if (metadata !== undefined)
             result.metadata = metadata;
         result.scopes = ["MX", "MX:AV", "MX:AV:AVI"];
-        result.jurisdictions = {
+        result.scopeData = {
             MX: {
                 actividadVulnerable: {
                     [CodigoActividad.AVI]: aviFields,
@@ -116,4 +126,8 @@ export class AVIProductsResource extends AVProductsResource {
     instantiate(data) {
         return new MexAVIProduct(data);
     }
+    /** Materializes a raw payload into a {@link MexAVIProduct} (return type narrowed via the `instantiate` override). */
+    materialize(data) {
+        return this.instantiate(data);
+    }
 }

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

@@ -30,4 +30,3 @@ export interface AVIUpdateTenantInput extends Omit<MexUpdateTenantInput, "activi
 export declare class AVITenantResource extends AVTenantResource {
     update(data: AVIUpdateTenantInput): Promise<TenantResponse>;
 }
-//# sourceMappingURL=tenant.d.ts.map

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

@@ -16,7 +16,7 @@ import { AVTransactionsResource } from "../transactions";
  * ```typescript
  * const aviSdk = new ComplianceSDK({
  *   apiKey,
- *   jurisdiction: Jurisdiction.Mexico,
+ *   scope: "MX",
  *   actividadVulnerable: CodigoActividad.AVI,
  * });
  *
@@ -37,15 +37,21 @@ import { AVTransactionsResource } from "../transactions";
 export declare class AVITransactionsResource extends AVTransactionsResource {
     protected static readonly SCOPE_PATH: string[];
     create(data: CreateAVITransactionInput): Promise<MexAVITransaction>;
-    retrieve(id: string): Promise<MexAVITransaction>;
-    retrieveByMetadata(key: string, value: string): Promise<MexAVITransaction>;
+    retrieve(id: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVITransaction>;
+    retrieveByMetadata(key: string, value: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVITransaction>;
     update(id: string, data: UpdateAVITransactionInput): Promise<MexAVITransaction>;
     /**
      * Lists AVI transactions with optional filtering.
      *
      * Accepts flattened AVI filter (future AVI-specific transaction fields at root level).
      */
-    list(options?: ListOptions<AVITransactionFilter, AVITransactionSort>): Promise<PaginatedResponse<MexAVITransaction>>;
+    list(options?: ListOptions<AVITransactionFilter, AVITransactionSort> & {
+        crossScope?: boolean;
+    }): Promise<PaginatedResponse<MexAVITransaction>>;
     /**
      * Iterates over AVI transactions.
      *
@@ -55,6 +61,7 @@ export declare class AVITransactionsResource extends AVTransactionsResource {
         filter?: AVITransactionFilter;
         sort?: AVITransactionSort;
         pageSize?: number;
+        crossScope?: boolean;
     }): AsyncGenerator<MexAVITransaction, void, undefined>;
     /**
      * Counts AVI transactions matching the given filter.
@@ -62,7 +69,9 @@ export declare class AVITransactionsResource extends AVTransactionsResource {
      * @param filter - Optional filter criteria (with AVI fields at root level)
      * @returns The count of matching transactions
      */
-    count(filter?: AVITransactionFilter): Promise<number>;
+    count(filter?: AVITransactionFilter, options?: {
+        crossScope?: boolean;
+    }): Promise<number>;
     listByClient(clientId: string, options?: {
         cursor?: string;
         limit?: number;
@@ -117,5 +126,6 @@ export declare class AVITransactionsResource extends AVTransactionsResource {
     protected transformToNested(data: CreateAVITransactionInput): CreateTransactionInput;
     protected transformUpdateToNested(data: UpdateAVITransactionInput): UpdateTransactionInput;
     protected instantiate(data: TransactionData): MexAVITransaction;
+    /** Materializes a raw payload into a {@link MexAVITransaction} (return type narrowed via the `instantiate` override). */
+    materialize(data: TransactionData): MexAVITransaction;
 }
-//# sourceMappingURL=transactions.d.ts.map

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

@@ -8,6 +8,7 @@
 import { aviTransactionSortingFieldMapping, CodigoActividad, createAVITransactionInputSchema, transformSort, updateAVITransactionInputSchema, upsertAVITransactionInputSchema, } from "@artu-ai/shared";
 import { z } from "zod";
 import { MexAVITransaction } from "../../../../models";
+import { splitTransactionCreateFields, splitTransactionUpdateFields, } from "../../update-split";
 import { AVTransactionsResource } from "../transactions";
 // ===========================
 // AVITransactionsResource
@@ -19,7 +20,7 @@ import { AVTransactionsResource } from "../transactions";
  * ```typescript
  * const aviSdk = new ComplianceSDK({
  *   apiKey,
- *   jurisdiction: Jurisdiction.Mexico,
+ *   scope: "MX",
  *   actividadVulnerable: CodigoActividad.AVI,
  * });
  *
@@ -41,7 +42,11 @@ export class AVITransactionsResource extends AVTransactionsResource {
     // ─────────────────────────────────────────────────────────────────
     // CRUD Operations
     // ─────────────────────────────────────────────────────────────────
-    static SCOPE_PATH = ["MX", "actividadVulnerable", "AVI"];
+    static SCOPE_PATH = [
+        "MX",
+        "actividadVulnerable",
+        CodigoActividad.AVI,
+    ];
     async create(data) {
         const merged = await this.mergeProductDataFlat(data, AVITransactionsResource.SCOPE_PATH);
         const validated = this.validate(createAVITransactionInputSchema, merged);
@@ -49,12 +54,19 @@ export class AVITransactionsResource 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) {
@@ -73,10 +85,11 @@ export class AVITransactionsResource extends AVTransactionsResource {
      * Accepts flattened AVI filter (future AVI-specific transaction 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.transactions.list.query({
-            ...options,
+            ...rest,
             filter: scopedFilter,
             sort: scopedSort,
         }));
@@ -91,12 +104,13 @@ export class AVITransactionsResource extends AVTransactionsResource {
      * Accepts flattened AVI filter (future AVI-specific transaction 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,
         });
     }
     /**
@@ -105,8 +119,8 @@ export class AVITransactionsResource extends AVTransactionsResource {
      * @param filter - Optional filter criteria (with AVI fields at root level)
      * @returns The count of matching transactions
      */
-    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;
     }
@@ -268,73 +282,26 @@ export class AVITransactionsResource extends AVTransactionsResource {
         return transformSort(sort, aviTransactionSortingFieldMapping);
     }
     transformToNested(data) {
-        // Extract AVI-specific fields based on operation type
-        const { amount, currency, timestamp, relatedClientIds, description, externalId, metadata, ...aviFields } = data;
-        // Build base fields (relatedClientIds is required)
-        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, AVITransactionsResource.SCOPE_PATH);
         return {
-            ...baseFields,
+            ...base,
             scopes: ["MX", "MX:AV", "MX:AV:AVI"],
-            jurisdictions: {
-                MX: {
-                    actividadVulnerable: {
-                        [CodigoActividad.AVI]: aviFields,
-                    },
-                },
-            },
+            scopeData,
         };
     }
     transformUpdateToNested(data) {
-        // Cast to access fields - Zod validation ensures correctness
-        const input = data;
-        const { amount, currency, status, description, externalId, metadata, exchangeRates, ...aviFields } = input;
-        // Build base update fields
-        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;
-        // Build AVI fields object (even if empty, to ensure filterability)
-        const aviData = {};
-        for (const [key, value] of Object.entries(aviFields)) {
-            if (value !== undefined)
-                aviData[key] = value;
-        }
-        // Always include AVI activity marker and scopes to ensure filterability
-        const resultRecord = result;
-        resultRecord.scopes = ["MX", "MX:AV", "MX:AV:AVI"];
-        resultRecord.jurisdictions = {
-            MX: {
-                actividadVulnerable: {
-                    [CodigoActividad.AVI]: aviData,
-                },
-            },
+        const { base, scopeData } = splitTransactionUpdateFields(data, AVITransactionsResource.SCOPE_PATH);
+        return {
+            ...base,
+            scopes: ["MX", "MX:AV", "MX:AV:AVI"],
+            scopeData,
         };
-        return result;
     }
     instantiate(data) {
         return new MexAVITransaction(data);
     }
+    /** Materializes a raw payload into a {@link MexAVITransaction} (return type narrowed via the `instantiate` override). */
+    materialize(data) {
+        return this.instantiate(data);
+    }
 }

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

@@ -8,6 +8,7 @@
 import type { AtomicBatchResult, ClientRelationshipType, ClientSort, CreateBankAccountInput, CreateClientInput, CreateContactMethodInput, CreateMexAddressInput, CreateMexClientInput, LinkedClient as LinkedClientInput, ListOptions, MexClientFilter, MexClientSort, PaginatedResponse, PartialBatchResult, SyncCreateDocumentInput, SyncItem, SyncResult, SyncUpdateDocumentInput, UpdateBankAccountInput, UpdateClientInput, UpdateContactMethodInput, UpdateMexAddressInput, UpdateMexClientInput, UpsertMexClientInput, UpsertResult } from "@artu-ai/shared";
 import { type ClientData, ContactMethod, Document, LinkedClient, MexAddress, MexAVClient, MexBankAccount } from "../../../models";
 import { type ClientIncludeMap } from "../../clients";
+import type { RelatedPartySubresource } from "../../related-parties/base";
 import { MexClientsResource } from "../clients";
 /**
  * AV (Actividad Vulnerable) scoped clients resource.
@@ -15,19 +16,32 @@ import { MexClientsResource } from "../clients";
  * Passthrough to MX level with AV scope marker.
  */
 export declare class AVClientsResource extends MexClientsResource<MexClientSort> {
+    readonly legalRepresentatives: RelatedPartySubresource<MexAVClient, CreateMexClientInput>;
+    readonly controllingBeneficiaries: RelatedPartySubresource<MexAVClient, CreateMexClientInput>;
     create(data: CreateMexClientInput): Promise<MexAVClient>;
-    retrieve(id: string, include?: ClientIncludeMap): Promise<MexAVClient>;
-    retrieveByExternalId(externalId: string): Promise<MexAVClient>;
+    retrieve(id: string, options?: {
+        include?: ClientIncludeMap;
+        crossScope?: boolean;
+    }): Promise<MexAVClient>;
+    retrieveByExternalId(externalId: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVClient>;
     update(id: string, data: UpdateMexClientInput): Promise<MexAVClient>;
     list(options?: ListOptions<MexClientFilter, MexClientSort> & {
         includePrimaryContacts?: boolean;
+        includeNonPrimary?: boolean;
+        crossScope?: boolean;
     }): Promise<PaginatedResponse<MexAVClient>>;
     iterate(options?: {
         filter?: MexClientFilter;
         sort?: MexClientSort;
         pageSize?: number;
+        crossScope?: boolean;
     }): AsyncGenerator<MexAVClient, void, undefined>;
-    count(filter?: MexClientFilter): Promise<number>;
+    count(filter?: MexClientFilter, options?: {
+        includeNonPrimary?: boolean;
+        crossScope?: boolean;
+    }): Promise<number>;
     createMany(clients: CreateMexClientInput[], options?: {
         atomic?: true;
     }): Promise<AtomicBatchResult<MexAVClient>>;
@@ -112,5 +126,6 @@ export declare class AVClientsResource extends MexClientsResource<MexClientSort>
     protected transformToNested(data: CreateMexClientInput): CreateClientInput;
     protected transformUpdateToNested(data: UpdateMexClientInput): UpdateClientInput;
     protected instantiate(data: ClientData): MexAVClient;
+    /** Materializes a raw payload into a {@link MexAVClient} (return type narrowed via the `instantiate` override). */
+    materialize(data: ClientData): MexAVClient;
 }
-//# sourceMappingURL=clients.d.ts.map