@artu-ai/compliance-sdk 0.0.6 → 0.3.0

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

@@ -0,0 +1,195 @@
+/**
+ * Mexico Clients Resource
+ *
+ * Extends ClientsResource with Mexico-specific behavior:
+ * - Accepts flattened CreateMexClientInput (MX fields at root level)
+ * - Automatically sets primaryJurisdiction to Mexico
+ * - Filters list/iterate to Mexico clients only
+ * - Returns MexClient models
+ */
+import type { CreateClientInput, UpdateClientInput, ClientFilter, ClientSort, ListOptions, PaginatedResponse, CreateMexClientInput, UpdateMexClientInput, AtomicBatchResult, PartialBatchResult, ClientRelationshipType, LinkedClient as LinkedClientInput, CreateAddressInput, UpdateAddressInput, CreateMexAddressInput, UpdateMexAddressInput, CreateContactMethodInput, UpdateContactMethodInput, CreateBankAccountInput, UpdateBankAccountInput, SyncItem, SyncResult, MexClientFilter, MexClientSort } from "@artu-ai/shared";
+import { ClientsResource, type ClientIncludeMap } from "../clients";
+import { MexClient, MexAddress, MexBankAccount, ContactMethod, LinkedClient, type ClientData } from "../../models";
+/**
+ * Mexico-scoped clients resource.
+ *
+ * Provides the same operations as ClientsResource but with:
+ * - Flattened input types (MX fields at root level)
+ * - Automatic jurisdiction scoping
+ * - MexClient model return type
+ *
+ * @example
+ * ```typescript
+ * const mexSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: Jurisdiction.Mexico,
+ * });
+ *
+ * // Create with flattened input
+ * const client = await mexSdk.clients.create({
+ *   type: ClientType.Person,
+ *   name: "Juan García",
+ *   rfc: "GAJL850101ABC",      // MX field at root
+ *   curp: "GAJL850101HDFRRL09", // MX field at root
+ *   actividadVulnerable: {      // Activity data keyed by code
+ *     AVI: { username: "JGARCIA" },
+ *   },
+ * });
+ *
+ * // List returns only Mexico clients
+ * const { data } = await mexSdk.clients.list();
+ * // data is MexClient[]
+ * ```
+ */
+export declare class MexClientsResource<TSort = MexClientSort> extends ClientsResource<TSort> {
+    /**
+     * Creates a new Mexico client with flattened input.
+     *
+     * @param data - Client creation data with MX fields at root level
+     * @returns The created MexClient model
+     */
+    create(data: CreateMexClientInput): Promise<MexClient>;
+    /**
+     * Retrieves a client by ID.
+     */
+    retrieve(id: string, include?: ClientIncludeMap): Promise<MexClient>;
+    /**
+     * Retrieves a Mexico client by externalId.
+     */
+    retrieveByExternalId(externalId: string): Promise<MexClient>;
+    /**
+     * Updates a Mexico client with flattened input.
+     */
+    update(id: string, data: UpdateMexClientInput): Promise<MexClient>;
+    /**
+     * Lists Mexico clients with optional filtering.
+     *
+     * Accepts flattened Mexico filter (MX fields at root level) and automatically
+     * transforms to nested format before calling the API.
+     *
+     * @example
+     * ```typescript
+     * // Filter with flattened MX fields
+     * const { data } = await mexSdk.clients.list({
+     *   filter: {
+     *     name: { contains: "García" },
+     *     rfc: { startsWith: "GAJL" },  // MX field at root!
+     *   },
+     * });
+     * ```
+     */
+    list(options?: ListOptions<MexClientFilter, TSort> & {
+        includePrimaryContacts?: boolean;
+    }): Promise<PaginatedResponse<MexClient>>;
+    /**
+     * Iterates over Mexico clients.
+     *
+     * Accepts flattened Mexico filter (MX fields at root level) and automatically
+     * transforms to nested format before calling the API.
+     */
+    iterate(filter?: MexClientFilter): AsyncGenerator<MexClient, void, undefined>;
+    /**
+     * Creates multiple Mexico clients with flattened input.
+     */
+    createMany(clients: CreateMexClientInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexClient>>;
+    createMany(clients: CreateMexClientInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexClient>>;
+    /**
+     * Updates multiple Mexico clients.
+     */
+    updateMany(updates: {
+        id: string;
+        data: UpdateMexClientInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexClient>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMexClientInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexClient>>;
+    linkClient(parentClientId: string, childClientId: string, relationshipType: ClientRelationshipType, metadata?: Record<string, unknown>): Promise<MexClient>;
+    unlinkClient(parentClientId: string, childClientId: string, relationshipType: ClientRelationshipType): Promise<MexClient>;
+    listLinkedClients(parentClientId: string, relationshipType?: ClientRelationshipType): Promise<LinkedClient[]>;
+    setLinkedClients(parentClientId: string, linkedClients: LinkedClientInput[]): Promise<MexClient>;
+    /**
+     * Atomically updates a Mexico client and all related resources in a single transaction.
+     *
+     * Accepts flattened Mexico address input types for convenience.
+     */
+    syncAll(clientId: string, data: {
+        client?: UpdateMexClientInput;
+        addresses?: SyncItem<CreateMexAddressInput>[];
+        contactMethods?: SyncItem<CreateContactMethodInput>[];
+        bankAccounts?: SyncItem<CreateBankAccountInput>[];
+        linkedClients?: LinkedClientInput[];
+    }, options: {
+        replaceMode: true;
+    }): Promise<{
+        client: MexClient;
+        addresses: SyncResult<MexAddress>;
+        contactMethods: SyncResult<ContactMethod>;
+        bankAccounts: SyncResult<MexBankAccount>;
+    }>;
+    syncAll(clientId: string, data: {
+        client?: UpdateMexClientInput;
+        addresses?: SyncItem<UpdateMexAddressInput>[];
+        contactMethods?: SyncItem<UpdateContactMethodInput>[];
+        bankAccounts?: SyncItem<UpdateBankAccountInput>[];
+        linkedClients?: LinkedClientInput[];
+    }, options?: {
+        replaceMode?: boolean;
+    }): Promise<{
+        client: MexClient;
+        addresses: SyncResult<MexAddress>;
+        contactMethods: SyncResult<ContactMethod>;
+        bankAccounts: SyncResult<MexBankAccount>;
+    }>;
+    /**
+     * Transforms a flattened MexClientFilter to nested ClientFilter format
+     * and applies Mexico jurisdiction scoping.
+     *
+     * Extracts MX-specific fields (rfc, curp, actividadEconomica, giroMercantil,
+     * actividadVulnerable) from root level and nests them under jurisdictions.MX.
+     */
+    protected applyScopeToFilter(filter?: MexClientFilter): ClientFilter;
+    /**
+     * Transforms a flattened MexClientSort to nested ClientSort format.
+     *
+     * Maps flattened field names (rfc, curp, actividadVulnerable.AVI.username)
+     * to their full API paths (jurisdictions.MX.rfc, etc.).
+     *
+     * Note: Uses unknown parameter to allow derived classes to override with their own sort types.
+     */
+    protected applyScopeToSort(sort?: TSort): ClientSort | undefined;
+    /**
+     * Transforms flattened MX input to nested API format.
+     */
+    protected transformToNested(data: CreateMexClientInput): CreateClientInput;
+    /**
+     * Transforms flattened MX update input to nested API format.
+     */
+    protected transformUpdateToNested(data: UpdateMexClientInput): UpdateClientInput;
+    /**
+     * Transforms a flattened MX address sync item to nested API format.
+     */
+    protected transformAddressSyncItem(item: SyncItem<UpdateMexAddressInput | CreateMexAddressInput>): SyncItem<UpdateAddressInput | CreateAddressInput>;
+    /**
+     * Transforms flattened MX address input to nested API format.
+     */
+    protected transformAddressToNested(data: CreateMexAddressInput): CreateAddressInput;
+    /**
+     * Transforms flattened MX address update input to nested API format.
+     */
+    protected transformAddressUpdateToNested(data: UpdateMexAddressInput): UpdateAddressInput;
+    /**
+     * Instantiates a MexClient model.
+     */
+    protected instantiate(data: ClientData): MexClient;
+}
+//# sourceMappingURL=clients.d.ts.map

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

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

package/dist/resources/mex/clients.js

@@ -0,0 +1,454 @@
+/**
+ * Mexico Clients Resource
+ *
+ * Extends ClientsResource with Mexico-specific behavior:
+ * - Accepts flattened CreateMexClientInput (MX fields at root level)
+ * - Automatically sets primaryJurisdiction to Mexico
+ * - Filters list/iterate to Mexico clients only
+ * - Returns MexClient models
+ */
+import { z } from "zod";
+import { Jurisdiction, createMexClientInputSchema, updateMexClientInputSchema, linkedClientSchema, createMexAddressInputSchema, updateMexAddressInputSchema, createContactMethodInputSchema, updateContactMethodInputSchema, createBankAccountInputSchema, updateBankAccountInputSchema, replaceSyncItemSchema, transformSort, mexClientFieldMapping, } from "@artu-ai/shared";
+import { ClientsResource, } from "../clients";
+import { MexClient, MexAddress, MexBankAccount, ContactMethod, } from "../../models";
+// ===========================
+// MexClientsResource
+// ===========================
+/**
+ * Mexico-scoped clients resource.
+ *
+ * Provides the same operations as ClientsResource but with:
+ * - Flattened input types (MX fields at root level)
+ * - Automatic jurisdiction scoping
+ * - MexClient model return type
+ *
+ * @example
+ * ```typescript
+ * const mexSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: Jurisdiction.Mexico,
+ * });
+ *
+ * // Create with flattened input
+ * const client = await mexSdk.clients.create({
+ *   type: ClientType.Person,
+ *   name: "Juan García",
+ *   rfc: "GAJL850101ABC",      // MX field at root
+ *   curp: "GAJL850101HDFRRL09", // MX field at root
+ *   actividadVulnerable: {      // Activity data keyed by code
+ *     AVI: { username: "JGARCIA" },
+ *   },
+ * });
+ *
+ * // List returns only Mexico clients
+ * const { data } = await mexSdk.clients.list();
+ * // data is MexClient[]
+ * ```
+ */
+export class MexClientsResource extends ClientsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations (override with flattened input types)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Creates a new Mexico client with flattened input.
+     *
+     * @param data - Client creation data with MX fields at root level
+     * @returns The created MexClient model
+     */
+    async create(data) {
+        const validated = this.validate(createMexClientInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.clients.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a client by ID.
+     */
+    async retrieve(id, include) {
+        const response = await this.execute(() => this.trpc.clients.retrieve.query({ id, include }));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a Mexico client by externalId.
+     */
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.clients.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    /**
+     * Updates a Mexico client with flattened input.
+     */
+    async update(id, data) {
+        const validated = this.validate(updateMexClientInputSchema, data);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.clients.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination (scoped to Mexico)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists Mexico clients with optional filtering.
+     *
+     * Accepts flattened Mexico filter (MX fields at root level) and automatically
+     * transforms to nested format before calling the API.
+     *
+     * @example
+     * ```typescript
+     * // Filter with flattened MX fields
+     * const { data } = await mexSdk.clients.list({
+     *   filter: {
+     *     name: { contains: "García" },
+     *     rfc: { startsWith: "GAJL" },  // MX field at root!
+     *   },
+     * });
+     * ```
+     */
+    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)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Iterates over Mexico clients.
+     *
+     * Accepts flattened Mexico filter (MX fields at root level) and automatically
+     * transforms to nested format before calling the API.
+     */
+    iterate(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        return this.createIterator({ filter: scopedFilter });
+    }
+    async createMany(clients, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createMexClientInputSchema), clients);
+        const nestedClients = validated.map((c) => this.transformToNested(c));
+        const response = await this.execute(() => this.trpc.clients.createMany.mutate({ items: nestedClients, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((c) => this.instantiate(c)),
+            };
+        }
+        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 updateItemSchema = z.object({
+            id: z.uuid(),
+            data: updateMexClientInputSchema,
+        });
+        const validated = this.validate(z.array(updateItemSchema), updates);
+        const nestedUpdates = validated.map((u) => ({
+            id: u.id,
+            data: this.transformUpdateToNested(u.data),
+        }));
+        const response = await this.execute(() => this.trpc.clients.updateMany.mutate({ items: nestedUpdates, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((c) => this.instantiate(c)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Client-to-Client Relationship Management (scoped returns)
+    // ─────────────────────────────────────────────────────────────────
+    async linkClient(parentClientId, childClientId, relationshipType, metadata) {
+        const response = await this.execute(() => this.trpc.clients.linkClient.mutate({
+            parentClientId,
+            childClientId,
+            relationshipType,
+            metadata,
+        }));
+        return this.instantiate(response);
+    }
+    async unlinkClient(parentClientId, childClientId, relationshipType) {
+        const response = await this.execute(() => this.trpc.clients.unlinkClient.mutate({
+            parentClientId,
+            childClientId,
+            relationshipType,
+        }));
+        return this.instantiate(response);
+    }
+    async listLinkedClients(parentClientId, relationshipType) {
+        return super.listLinkedClients(parentClientId, relationshipType);
+    }
+    async setLinkedClients(parentClientId, linkedClients) {
+        const validated = this.validate(z.array(linkedClientSchema), linkedClients);
+        const response = await this.execute(() => this.trpc.clients.setLinkedClients.mutate({
+            parentClientId,
+            linkedClients: validated,
+        }));
+        return this.instantiate(response);
+    }
+    async syncAll(clientId, data, options) {
+        // Validate and transform client input
+        const validatedClient = data.client
+            ? this.transformUpdateToNested(this.validate(updateMexClientInputSchema, data.client))
+            : undefined;
+        // Validate and transform addresses (flattened MX → nested)
+        let validatedAddresses;
+        if (data.addresses) {
+            const validated = this.validate(z.array(replaceSyncItemSchema(createMexAddressInputSchema, updateMexAddressInputSchema)), data.addresses);
+            validatedAddresses = validated.map((item) => this.transformAddressSyncItem(item));
+        }
+        // Validate contact methods (base types, no transform)
+        const validatedContactMethods = data.contactMethods
+            ? this.validate(z.array(replaceSyncItemSchema(createContactMethodInputSchema, updateContactMethodInputSchema)), data.contactMethods)
+            : undefined;
+        // Validate bank accounts (base types, no transform)
+        const validatedBankAccounts = data.bankAccounts
+            ? this.validate(z.array(replaceSyncItemSchema(createBankAccountInputSchema, updateBankAccountInputSchema)), data.bankAccounts)
+            : undefined;
+        const validatedLinkedClients = data.linkedClients
+            ? this.validate(z.array(linkedClientSchema), data.linkedClients)
+            : undefined;
+        const response = await this.execute(() => this.trpc.clients.syncAll.mutate({
+            clientId,
+            client: validatedClient,
+            addresses: validatedAddresses,
+            contactMethods: validatedContactMethods,
+            bankAccounts: validatedBankAccounts,
+            linkedClients: validatedLinkedClients,
+            replaceMode: options?.replaceMode,
+        }));
+        return {
+            client: this.instantiate(response.client),
+            addresses: {
+                created: response.addresses.created.map((a) => new MexAddress(a)),
+                updated: response.addresses.updated.map((a) => new MexAddress(a)),
+                deleted: response.addresses.deleted,
+            },
+            contactMethods: {
+                created: response.contactMethods.created.map((c) => new ContactMethod(c)),
+                updated: response.contactMethods.updated.map((c) => new ContactMethod(c)),
+                deleted: response.contactMethods.deleted,
+            },
+            bankAccounts: {
+                created: response.bankAccounts.created.map((b) => new MexBankAccount(b)),
+                updated: response.bankAccounts.updated.map((b) => new MexBankAccount(b)),
+                deleted: response.bankAccounts.deleted,
+            },
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Transforms a flattened MexClientFilter to nested ClientFilter format
+     * and applies Mexico jurisdiction scoping.
+     *
+     * Extracts MX-specific fields (rfc, curp, actividadEconomica, giroMercantil,
+     * actividadVulnerable) from root level and nests them under jurisdictions.MX.
+     */
+    applyScopeToFilter(filter) {
+        if (!filter) {
+            return {
+                availableJurisdictions: Jurisdiction.Mexico,
+            };
+        }
+        // Extract MX-specific filter fields
+        const { rfc, curp, actividadEconomica, giroMercantil, actividadVulnerable, ...baseFields } = filter;
+        // Build MX jurisdiction filter if any MX fields are present
+        const hasMexFields = rfc !== undefined ||
+            curp !== undefined ||
+            actividadEconomica !== undefined ||
+            giroMercantil !== undefined ||
+            actividadVulnerable !== undefined;
+        const mexFilter = {};
+        if (rfc !== undefined)
+            mexFilter.rfc = rfc;
+        if (curp !== undefined)
+            mexFilter.curp = curp;
+        if (actividadEconomica !== undefined)
+            mexFilter.actividadEconomica = actividadEconomica;
+        if (giroMercantil !== undefined)
+            mexFilter.giroMercantil = giroMercantil;
+        if (actividadVulnerable !== undefined)
+            mexFilter.actividadVulnerable = actividadVulnerable;
+        return {
+            ...baseFields,
+            availableJurisdictions: Jurisdiction.Mexico,
+            ...(hasMexFields && { jurisdictions: { MX: mexFilter } }),
+        };
+    }
+    /**
+     * Transforms a flattened MexClientSort to nested ClientSort format.
+     *
+     * Maps flattened field names (rfc, curp, actividadVulnerable.AVI.username)
+     * to their full API paths (jurisdictions.MX.rfc, etc.).
+     *
+     * Note: Uses unknown parameter to allow derived classes to override with their own sort types.
+     */
+    applyScopeToSort(sort) {
+        if (!sort || !Array.isArray(sort) || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, mexClientFieldMapping);
+    }
+    /**
+     * Transforms flattened MX input to nested API format.
+     */
+    transformToNested(data) {
+        const { rfc, curp, actividadEconomica, giroMercantil, actividadVulnerable, ...baseFields } = data;
+        // Build MX jurisdiction data
+        const mexData = {};
+        if (rfc !== undefined)
+            mexData.rfc = rfc;
+        if (curp !== undefined)
+            mexData.curp = curp;
+        if (actividadEconomica !== undefined)
+            mexData.actividadEconomica = actividadEconomica;
+        if (giroMercantil !== undefined)
+            mexData.giroMercantil = giroMercantil;
+        if (actividadVulnerable !== undefined)
+            mexData.actividadVulnerable = actividadVulnerable;
+        return {
+            ...baseFields,
+            primaryJurisdiction: Jurisdiction.Mexico,
+            jurisdictions: {
+                MX: mexData,
+            },
+        };
+    }
+    /**
+     * Transforms flattened MX update input to nested API format.
+     */
+    transformUpdateToNested(data) {
+        const { rfc, curp, actividadEconomica, giroMercantil, actividadVulnerable, ...baseFields } = data;
+        // Only include MX data if any MX fields are present
+        const hasMexFields = rfc !== undefined ||
+            curp !== undefined ||
+            actividadEconomica !== undefined ||
+            giroMercantil !== undefined ||
+            actividadVulnerable !== undefined;
+        if (!hasMexFields) {
+            return baseFields;
+        }
+        const mexData = {};
+        if (rfc !== undefined)
+            mexData.rfc = rfc;
+        if (curp !== undefined)
+            mexData.curp = curp;
+        if (actividadEconomica !== undefined)
+            mexData.actividadEconomica = actividadEconomica;
+        if (giroMercantil !== undefined)
+            mexData.giroMercantil = giroMercantil;
+        if (actividadVulnerable !== undefined)
+            mexData.actividadVulnerable = actividadVulnerable;
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: mexData,
+            },
+        };
+    }
+    /**
+     * Transforms a flattened MX address sync item to nested API format.
+     */
+    transformAddressSyncItem(item) {
+        if ("_delete" in item && item._delete) {
+            // Delete items pass through unchanged
+            return item;
+        }
+        if ("id" in item && item.id) {
+            // Update items - transform the data fields
+            const { id, ...data } = item;
+            return {
+                id,
+                ...this.transformAddressUpdateToNested(data),
+            };
+        }
+        // Create items - transform full item
+        return this.transformAddressToNested(item);
+    }
+    /**
+     * Transforms flattened MX address input to nested API format.
+     */
+    transformAddressToNested(data) {
+        const { exteriorNumber, interiorNumber, neighborhood, municipality, betweenStreets, reference, ...baseFields } = data;
+        const mexData = {
+            exteriorNumber,
+            neighborhood,
+        };
+        if (interiorNumber !== undefined)
+            mexData.interiorNumber = interiorNumber;
+        if (municipality !== undefined)
+            mexData.municipality = municipality;
+        if (betweenStreets !== undefined)
+            mexData.betweenStreets = betweenStreets;
+        if (reference !== undefined)
+            mexData.reference = reference;
+        return {
+            ...baseFields,
+            jurisdictions: { MX: mexData },
+        };
+    }
+    /**
+     * Transforms flattened MX address update input to nested API format.
+     */
+    transformAddressUpdateToNested(data) {
+        const { exteriorNumber, interiorNumber, neighborhood, municipality, betweenStreets, reference, ...baseFields } = data;
+        const hasMexFields = exteriorNumber !== undefined ||
+            interiorNumber !== undefined ||
+            neighborhood !== undefined ||
+            municipality !== undefined ||
+            betweenStreets !== undefined ||
+            reference !== undefined;
+        if (!hasMexFields) {
+            return baseFields;
+        }
+        const mexData = {};
+        if (exteriorNumber !== undefined)
+            mexData.exteriorNumber = exteriorNumber;
+        if (interiorNumber !== undefined)
+            mexData.interiorNumber = interiorNumber;
+        if (neighborhood !== undefined)
+            mexData.neighborhood = neighborhood;
+        if (municipality !== undefined)
+            mexData.municipality = municipality;
+        if (betweenStreets !== undefined)
+            mexData.betweenStreets = betweenStreets;
+        if (reference !== undefined)
+            mexData.reference = reference;
+        return {
+            ...baseFields,
+            jurisdictions: { MX: mexData },
+        };
+    }
+    /**
+     * Instantiates a MexClient model.
+     */
+    instantiate(data) {
+        return new MexClient(data);
+    }
+}