@artu-ai/compliance-sdk 0.0.5 → 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC,OAAO,EACL,MAAM,EACN,KAAK,UAAU,EACf,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,OAAO,GACR,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG7E,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,EACrB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,SAAS,EACT,KAAK,aAAa,EAClB,WAAW,EACX,cAAc,EACd,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,cAAc,EACd,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,UAAU,EACV,KAAK,cAAc,EACnB,YAAY,EAEZ,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAElB,SAAS,EACT,KAAK,aAAa,EAClB,WAAW,EACX,aAAa,EACb,KAAK,iBAAiB,EACtB,eAAe,GAChB,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,4BAA4B,EAC5B,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EAEd,iCAAiC,EACjC,gCAAgC,EAChC,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EAEnB,4BAA4B,EAC5B,KAAK,gCAAgC,EACrC,2BAA2B,EAC3B,gCAAgC,EAChC,KAAK,oCAAoC,EACzC,+BAA+B,EAC/B,YAAY,EACZ,KAAK,gBAAgB,EACrB,cAAc,EACd,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,YAAY,EACZ,KAAK,gBAAgB,EACrB,cAAc,EACd,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,YAAY,EACZ,KAAK,gBAAgB,EACrB,cAAc,EACd,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AAGpC,YAAY,EAEV,WAAW,EACX,cAAc,EACd,8BAA8B,EAE9B,gBAAgB,EAChB,mBAAmB,EACnB,mCAAmC,EAEnC,YAAY,EAEZ,gBAAgB,EAEhB,WAAW,EACX,cAAc,EACd,8BAA8B,EAC9B,eAAe,EACf,kBAAkB,EAClB,kCAAkC,GACnC,MAAM,SAAS,CAAC"}

package/dist/models/index.js

@@ -0,0 +1,34 @@
+/**
+ * Data Models
+ *
+ * Pure data models with typed accessors.
+ * Models never make API calls - they're just data containers.
+ */
+// Base model class
+export { BaseModel } from "./base";
+// Base client (root level)
+export { Client, isClient, isIndividual, isCompany, isTrust, } from "./Client";
+// Base transaction (root level)
+export { Transaction, isTransaction } from "./Transaction";
+// Base report (root level)
+export { Report, isReport } from "./Report";
+export { ReportItem, isReportItem } from "./ReportItem";
+// Supporting models
+export { Address, isAddress } from "./Address";
+export { ContactMethod } from "./ContactMethod";
+export { BankAccount, isBankAccount } from "./BankAccount";
+export { Document } from "./Document";
+export { LinkedClient, isLinkedClient, } from "./LinkedClient";
+// Mexico hierarchy
+export { MexClient, isMexClient, MexTransaction, isMexTransaction, MexBankAccount, isMexBankAccount, MexAddress, isMexAddress, 
+// Mexico documents
+MexDocument, MexIneFrontDocument, MexIneBackDocument, MexPassportDocument, MexCurpDocument, MexRfcConstanciaDocument, MexAddressProofDocument, MexActaConstitutivaDocument, MexPoderNotarialDocument, isMexDocument, isMexIneFront, isMexIneBack, isMexPassport, isMexCurp, isMexRfcConstancia, isMexAddressProof, isMexActaConstitutiva, isMexPoderNotarial, 
+// Mexico reports
+MexReport, isMexReport, MexReportItem, isMexReportItem, } from "./mex";
+export { 
+// Clients
+MexActividadVulnerableClient, isActividadVulnerable, MexAVIClient, isMexAVIClient, MexJYSClient, isMexJYSClient, MexTSCClient, isMexTSCClient, 
+// Transactions
+MexActividadVulnerableTransaction, isActividadVulnerableTransaction, MexAVITransaction, isMexAVITransaction, MexJYSTransaction, isMexJYSTransaction, MexTSCTransaction, isMexTSCTransaction, 
+// Reports
+MexActividadVulnerableReport, isActividadVulnerableReport, MexActividadVulnerableReportItem, isActividadVulnerableReportItem, MexAVIReport, isMexAVIReport, MexAVIReportItem, isMexAVIReportItem, MexJYSReport, isMexJYSReport, MexJYSReportItem, isMexJYSReportItem, MexTSCReport, isMexTSCReport, MexTSCReportItem, isMexTSCReportItem, } from "./mex/actividad-vulnerable";

package/dist/models/mex/MexAddress.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Mexico Address Model
+ *
+ * Extends Address with Mexico-specific accessors for the standard
+ * Mexican address format: street, exteriorNumber, interiorNumber, neighborhood.
+ */
+import type { MexAddressData } from "@artu-ai/shared";
+import { Address } from "../Address";
+/**
+ * Mexico-specific address data
+ */
+export type { MexAddressData };
+/**
+ * Mexico Address Model.
+ *
+ * Extends `Address` with Mexico-specific accessors for the standard
+ * Mexican address format.
+ *
+ * @example
+ * ```typescript
+ * if (address instanceof MexAddress) {
+ *   console.log(`Street: ${address.street}`);
+ *   console.log(`Number: ${address.exteriorNumber}`);
+ *   console.log(`Neighborhood: ${address.neighborhood}`);
+ *   console.log(`Formatted: ${address.formattedMexican}`);
+ * }
+ * ```
+ */
+export declare class MexAddress extends Address {
+    /**
+     * Mexico-specific address data
+     */
+    protected get mexicoData(): MexAddressData | undefined;
+    /**
+     * Exterior number (número exterior)
+     * @example "222", "S/N"
+     */
+    get exteriorNumber(): string | undefined;
+    /**
+     * Interior number (número interior)
+     * @example "Piso 5", "Depto. 301", "Local A"
+     */
+    get interiorNumber(): string | undefined;
+    /**
+     * Neighborhood/Colony (colonia)
+     * @example "Juárez", "Roma Norte", "Polanco"
+     */
+    get neighborhood(): string | undefined;
+    /**
+     * Municipality or delegation (municipio/alcaldía)
+     * @example "Cuauhtémoc", "Miguel Hidalgo"
+     */
+    get municipality(): string | undefined;
+    /**
+     * Between streets reference (entre calles)
+     * @example "Between Varsovia and Praga"
+     */
+    get betweenStreets(): string | undefined;
+    /**
+     * Additional reference (referencia)
+     * @example "Blue building in front of the park"
+     */
+    get reference(): string | undefined;
+    /**
+     * Street address line with number (Mexican format)
+     * @example "Paseo de la Reforma 222 Int. Piso 5"
+     */
+    get streetLine(): string;
+    /**
+     * Returns a formatted single-line address in Mexican format
+     * @example "Paseo de la Reforma 222, Col. Juárez, 06600 Ciudad de México, CDMX"
+     */
+    get formattedMexican(): string;
+    /**
+     * Returns a formatted multi-line address in Mexican format
+     */
+    get formattedMexicanMultiLine(): string;
+    /**
+     * Override the base formatted to use Mexican format
+     */
+    get formatted(): string;
+    /**
+     * Override the base formattedMultiLine to use Mexican format
+     */
+    get formattedMultiLine(): string;
+    toString(): string;
+}
+import type { AddressModel } from "../types";
+/**
+ * Check if address is a Mexico address
+ */
+export declare function isMexAddress(address: AddressModel): address is MexAddress;
+//# sourceMappingURL=MexAddress.d.ts.map

package/dist/models/mex/MexAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MexAddress.d.ts","sourceRoot":"","sources":["../../../src/models/mex/MexAddress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAMrC;;GAEG;AACH,YAAY,EAAE,cAAc,EAAE,CAAC;AAM/B;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAW,SAAQ,OAAO;IAKrC;;OAEG;IACH,SAAS,KAAK,UAAU,IAAI,cAAc,GAAG,SAAS,CAErD;IAMD;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAEvC;IAED;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAEvC;IAED;;;OAGG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED;;;OAGG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAEvC;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAMD;;;OAGG;IACH,IAAI,UAAU,IAAI,MAAM,CAMvB;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAQ7B;IAED;;OAEG;IACH,IAAI,yBAAyB,IAAI,MAAM,CAUtC;IAED;;OAEG;IACH,IAAa,SAAS,IAAI,MAAM,CAE/B;IAED;;OAEG;IACH,IAAa,kBAAkB,IAAI,MAAM,CAExC;IAMQ,QAAQ,IAAI,MAAM;CAI5B;AAMD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,IAAI,UAAU,CAEzE"}

package/dist/models/mex/MexAddress.js

@@ -0,0 +1,148 @@
+/**
+ * Mexico Address Model
+ *
+ * Extends Address with Mexico-specific accessors for the standard
+ * Mexican address format: street, exteriorNumber, interiorNumber, neighborhood.
+ */
+import { Address } from "../Address";
+// ===========================
+// MexAddress Model
+// ===========================
+/**
+ * Mexico Address Model.
+ *
+ * Extends `Address` with Mexico-specific accessors for the standard
+ * Mexican address format.
+ *
+ * @example
+ * ```typescript
+ * if (address instanceof MexAddress) {
+ *   console.log(`Street: ${address.street}`);
+ *   console.log(`Number: ${address.exteriorNumber}`);
+ *   console.log(`Neighborhood: ${address.neighborhood}`);
+ *   console.log(`Formatted: ${address.formattedMexican}`);
+ * }
+ * ```
+ */
+export class MexAddress extends Address {
+    // ─────────────────────────────────────────────────────────────────
+    // Mexico-Specific Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Mexico-specific address data
+     */
+    get mexicoData() {
+        return this._data.jurisdictions?.MX;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Mexico Address Fields
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Exterior number (número exterior)
+     * @example "222", "S/N"
+     */
+    get exteriorNumber() {
+        return this.mexicoData?.exteriorNumber;
+    }
+    /**
+     * Interior number (número interior)
+     * @example "Piso 5", "Depto. 301", "Local A"
+     */
+    get interiorNumber() {
+        return this.mexicoData?.interiorNumber;
+    }
+    /**
+     * Neighborhood/Colony (colonia)
+     * @example "Juárez", "Roma Norte", "Polanco"
+     */
+    get neighborhood() {
+        return this.mexicoData?.neighborhood;
+    }
+    /**
+     * Municipality or delegation (municipio/alcaldía)
+     * @example "Cuauhtémoc", "Miguel Hidalgo"
+     */
+    get municipality() {
+        return this.mexicoData?.municipality;
+    }
+    /**
+     * Between streets reference (entre calles)
+     * @example "Between Varsovia and Praga"
+     */
+    get betweenStreets() {
+        return this.mexicoData?.betweenStreets;
+    }
+    /**
+     * Additional reference (referencia)
+     * @example "Blue building in front of the park"
+     */
+    get reference() {
+        return this.mexicoData?.reference;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Formatting
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Street address line with number (Mexican format)
+     * @example "Paseo de la Reforma 222 Int. Piso 5"
+     */
+    get streetLine() {
+        const parts = [this.street, this.exteriorNumber];
+        if (this.interiorNumber) {
+            parts.push(`Int. ${this.interiorNumber}`);
+        }
+        return parts.filter(Boolean).join(" ");
+    }
+    /**
+     * Returns a formatted single-line address in Mexican format
+     * @example "Paseo de la Reforma 222, Col. Juárez, 06600 Ciudad de México, CDMX"
+     */
+    get formattedMexican() {
+        const parts = [
+            this.streetLine,
+            this.neighborhood ? `Col. ${this.neighborhood}` : undefined,
+            `${this.postalCode} ${this.city}`,
+            this.state,
+        ].filter(Boolean);
+        return parts.join(", ");
+    }
+    /**
+     * Returns a formatted multi-line address in Mexican format
+     */
+    get formattedMexicanMultiLine() {
+        const lines = [
+            this.streetLine,
+            this.neighborhood ? `Col. ${this.neighborhood}` : undefined,
+            this.municipality ? `${this.municipality}` : undefined,
+            `${this.postalCode} ${this.city}, ${this.state}`,
+            this.betweenStreets,
+            this.reference,
+        ].filter(Boolean);
+        return lines.join("\n");
+    }
+    /**
+     * Override the base formatted to use Mexican format
+     */
+    get formatted() {
+        return this.formattedMexican;
+    }
+    /**
+     * Override the base formattedMultiLine to use Mexican format
+     */
+    get formattedMultiLine() {
+        return this.formattedMexicanMultiLine;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        const location = this.neighborhood || this.city;
+        return `MexAddress(${this.id}, ${this.type}, ${location})`;
+    }
+}
+/**
+ * Check if address is a Mexico address
+ */
+export function isMexAddress(address) {
+    return address instanceof MexAddress;
+}

package/dist/models/mex/MexBankAccount.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Mexico Bank Account Model
+ *
+ * Extends BankAccount with Mexico-specific accessors.
+ * Data is flattened at root level (clabe, codigoBanco, codigoPlaza).
+ */
+import type { MexBankAccount as MexBankAccountSchema } from "@artu-ai/shared";
+import { BankAccount } from "../BankAccount";
+/**
+ * Mexico bank account data (with MX-specific fields at root)
+ */
+export type MexBankAccountData = MexBankAccountSchema;
+/**
+ * Mexico Bank Account Model.
+ *
+ * Provides typed accessors for Mexico-specific fields like CLABE.
+ *
+ * @example
+ * ```typescript
+ * const account = await sdk.bankAccounts.retrieve(id);
+ *
+ * if (account.country === "MX") {
+ *   // account is MexBankAccount
+ *   console.log(`CLABE: ${account.clabe}`);
+ *   console.log(`Bank Code: ${account.codigoBanco}`);
+ * }
+ * ```
+ */
+export declare class MexBankAccount extends BankAccount {
+    protected _data: MexBankAccountData;
+    /**
+     * CLABE (18-digit Mexican interbank code)
+     *
+     * The CLABE is structured as:
+     * - Digits 1-3: Bank code
+     * - Digits 4-6: Plaza (branch location) code
+     * - Digits 7-17: Account number
+     * - Digit 18: Check digit
+     */
+    get clabe(): string | undefined;
+    /**
+     * Bank code from CLABE (first 3 digits)
+     */
+    get codigoBanco(): string | undefined;
+    /**
+     * Plaza (branch location) code from CLABE (digits 4-6)
+     */
+    get codigoPlaza(): string | undefined;
+    /**
+     * Returns a masked CLABE (shows last 4 digits)
+     */
+    get maskedClabe(): string | undefined;
+    /**
+     * Returns a formatted CLABE with spaces for readability
+     * Format: XXX XXX XXXXXXXXXXX X
+     */
+    get formattedClabe(): string | undefined;
+    toString(): string;
+}
+import type { BankAccountModel } from "../types";
+/**
+ * Check if bank account is a Mexico bank account
+ */
+export declare function isMexBankAccount(account: BankAccountModel): account is MexBankAccount;
+//# sourceMappingURL=MexBankAccount.d.ts.map

package/dist/models/mex/MexBankAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MexBankAccount.d.ts","sourceRoot":"","sources":["../../../src/models/mex/MexBankAccount.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAM7C;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAMtD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAE7C,UAAkB,KAAK,EAAE,kBAAkB,CAAC;IAM5C;;;;;;;;OAQG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAMD;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAKpC;IAED;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAIvC;IAMQ,QAAQ,IAAI,MAAM;CAG5B;AAMD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,gBAAgB,GACxB,OAAO,IAAI,cAAc,CAE3B"}

package/dist/models/mex/MexBankAccount.js

@@ -0,0 +1,90 @@
+/**
+ * Mexico Bank Account Model
+ *
+ * Extends BankAccount with Mexico-specific accessors.
+ * Data is flattened at root level (clabe, codigoBanco, codigoPlaza).
+ */
+import { BankAccount } from "../BankAccount";
+// ===========================
+// MexBankAccount Model
+// ===========================
+/**
+ * Mexico Bank Account Model.
+ *
+ * Provides typed accessors for Mexico-specific fields like CLABE.
+ *
+ * @example
+ * ```typescript
+ * const account = await sdk.bankAccounts.retrieve(id);
+ *
+ * if (account.country === "MX") {
+ *   // account is MexBankAccount
+ *   console.log(`CLABE: ${account.clabe}`);
+ *   console.log(`Bank Code: ${account.codigoBanco}`);
+ * }
+ * ```
+ */
+export class MexBankAccount extends BankAccount {
+    // ─────────────────────────────────────────────────────────────────
+    // CLABE (Clave Bancaria Estandarizada)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * CLABE (18-digit Mexican interbank code)
+     *
+     * The CLABE is structured as:
+     * - Digits 1-3: Bank code
+     * - Digits 4-6: Plaza (branch location) code
+     * - Digits 7-17: Account number
+     * - Digit 18: Check digit
+     */
+    get clabe() {
+        return this._data.clabe;
+    }
+    /**
+     * Bank code from CLABE (first 3 digits)
+     */
+    get codigoBanco() {
+        return this._data.codigoBanco;
+    }
+    /**
+     * Plaza (branch location) code from CLABE (digits 4-6)
+     */
+    get codigoPlaza() {
+        return this._data.codigoPlaza;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Formatting
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Returns a masked CLABE (shows last 4 digits)
+     */
+    get maskedClabe() {
+        const clabe = this.clabe;
+        if (!clabe)
+            return undefined;
+        const lastFour = clabe.slice(-4);
+        return `**************${lastFour}`;
+    }
+    /**
+     * Returns a formatted CLABE with spaces for readability
+     * Format: XXX XXX XXXXXXXXXXX X
+     */
+    get formattedClabe() {
+        const clabe = this.clabe;
+        if (!clabe || clabe.length !== 18)
+            return clabe;
+        return `${clabe.slice(0, 3)} ${clabe.slice(3, 6)} ${clabe.slice(6, 17)} ${clabe.slice(17)}`;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexBankAccount(${this.id}, ${this.bankName}, ${this.maskedClabe ?? this.maskedAccountNumber})`;
+    }
+}
+/**
+ * Check if bank account is a Mexico bank account
+ */
+export function isMexBankAccount(account) {
+    return account instanceof MexBankAccount;
+}

package/dist/models/mex/MexClient.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Mexico Client Model
+ *
+ * Extends base Client with Mexico-specific accessors.
+ * Provides type-safe access to RFC, CURP, and jurisdiction data.
+ */
+import { Client, type ClientData } from "../Client";
+import type { ClientRelationshipType, MexJurisdictionData } from "@artu-ai/shared";
+import { MexBankAccount } from "./MexBankAccount";
+/**
+ * Client data with Mexico jurisdiction
+ */
+export type MexClientData = ClientData & {
+    jurisdictions?: {
+        MX?: MexJurisdictionData;
+        [key: string]: unknown;
+    };
+};
+/**
+ * Mexico Client Model.
+ *
+ * Provides typed accessors for Mexico-specific data:
+ * - RFC (Registro Federal de Contribuyentes)
+ * - CURP (Clave Única de Registro de Población)
+ * - Actividad Económica
+ * - Giro Mercantil
+ *
+ * @example
+ * ```typescript
+ * if (client instanceof MexClient) {
+ *   console.log(`RFC: ${client.rfc}`);
+ *   console.log(`CURP: ${client.curp}`);
+ * }
+ * ```
+ */
+export declare class MexClient extends Client {
+    /**
+     * Mexico-specific jurisdiction data
+     */
+    protected get mexicoData(): MexJurisdictionData | undefined;
+    /**
+     * RFC (Registro Federal de Contribuyentes)
+     * Tax identification number
+     */
+    get rfc(): string | undefined;
+    /**
+     * CURP (Clave Única de Registro de Población)
+     * Only applicable for personas físicas
+     */
+    get curp(): string | undefined;
+    /**
+     * Economic activity classification code
+     */
+    get actividadEconomica(): string | undefined;
+    /**
+     * Business sector (giro mercantil)
+     */
+    get giroMercantil(): string | undefined;
+    /**
+     * Whether client is registered for any Actividad Vulnerable
+     */
+    get isActividadVulnerable(): boolean;
+    /**
+     * Activity codes the client is registered for
+     */
+    get activityCodes(): string[];
+    /**
+     * Checks if registered for a specific activity
+     */
+    hasActivity(code: "AVI" | "JYS" | "TSC"): boolean;
+    toString(): string;
+    /**
+     * Linked clients (if included) instantiated as MexClient
+     */
+    get linkedClients(): {
+        relationshipType: ClientRelationshipType;
+        client: MexClient;
+    }[] | undefined;
+    get addresses(): MexAddress[] | undefined;
+    get bankAccounts(): MexBankAccount[] | undefined;
+}
+import type { ClientModel } from "../types";
+import { MexAddress } from "./MexAddress";
+/**
+ * Check if client is a Mexico client
+ */
+export declare function isMexClient(client: ClientModel): client is MexClient;
+//# sourceMappingURL=MexClient.d.ts.map

package/dist/models/mex/MexClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MexClient.d.ts","sourceRoot":"","sources":["../../../src/models/mex/MexClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG;IACvC,aAAa,CAAC,EAAE;QACd,EAAE,CAAC,EAAE,mBAAmB,CAAC;QACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAMF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAU,SAAQ,MAAM;IAKnC;;OAEG;IACH,SAAS,KAAK,UAAU,IAAI,mBAAmB,GAAG,SAAS,CAE1D;IAMD;;;OAGG;IACH,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAED;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAMD;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAE3C;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAMD;;OAEG;IACH,IAAI,qBAAqB,IAAI,OAAO,CAInC;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,EAAE,CAQ5B;IAED;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO;IAQxC,QAAQ,IAAI,MAAM;IAI3B;;OAEG;IACH,IAAa,aAAa,IACtB;QACE,gBAAgB,EAAE,sBAAsB,CAAC;QACzC,MAAM,EAAE,SAAS,CAAC;KACnB,EAAE,GACH,SAAS,CAKZ;IAED,IAAa,SAAS,IAAI,UAAU,EAAE,GAAG,SAAS,CAEjD;IAED,IAAa,YAAY,IAAI,cAAc,EAAE,GAAG,SAAS,CAExD;CACF;AAMD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,IAAI,SAAS,CAEpE"}

package/dist/models/mex/MexClient.js

@@ -0,0 +1,133 @@
+/**
+ * Mexico Client Model
+ *
+ * Extends base Client with Mexico-specific accessors.
+ * Provides type-safe access to RFC, CURP, and jurisdiction data.
+ */
+import { Client } from "../Client";
+import { MexBankAccount } from "./MexBankAccount";
+// ===========================
+// MexClient Model
+// ===========================
+/**
+ * Mexico Client Model.
+ *
+ * Provides typed accessors for Mexico-specific data:
+ * - RFC (Registro Federal de Contribuyentes)
+ * - CURP (Clave Única de Registro de Población)
+ * - Actividad Económica
+ * - Giro Mercantil
+ *
+ * @example
+ * ```typescript
+ * if (client instanceof MexClient) {
+ *   console.log(`RFC: ${client.rfc}`);
+ *   console.log(`CURP: ${client.curp}`);
+ * }
+ * ```
+ */
+export class MexClient extends Client {
+    // ─────────────────────────────────────────────────────────────────
+    // Mexico Jurisdiction Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Mexico-specific jurisdiction data
+     */
+    get mexicoData() {
+        return this._data.jurisdictions?.MX;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Tax Identifiers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * RFC (Registro Federal de Contribuyentes)
+     * Tax identification number
+     */
+    get rfc() {
+        return this.mexicoData?.rfc;
+    }
+    /**
+     * CURP (Clave Única de Registro de Población)
+     * Only applicable for personas físicas
+     */
+    get curp() {
+        return this.mexicoData?.curp;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Economic Activity
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Economic activity classification code
+     */
+    get actividadEconomica() {
+        return this.mexicoData?.actividadEconomica;
+    }
+    /**
+     * Business sector (giro mercantil)
+     */
+    get giroMercantil() {
+        return this.mexicoData?.giroMercantil;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Actividades Vulnerables
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Whether client is registered for any Actividad Vulnerable
+     */
+    get isActividadVulnerable() {
+        const av = this.mexicoData?.actividadVulnerable;
+        if (!av)
+            return false;
+        return !!(av.AVI || av.JYS || av.TSC);
+    }
+    /**
+     * Activity codes the client is registered for
+     */
+    get activityCodes() {
+        const av = this.mexicoData?.actividadVulnerable;
+        if (!av)
+            return [];
+        const codes = [];
+        if (av.AVI)
+            codes.push("AVI");
+        if (av.JYS)
+            codes.push("JYS");
+        if (av.TSC)
+            codes.push("TSC");
+        return codes;
+    }
+    /**
+     * Checks if registered for a specific activity
+     */
+    hasActivity(code) {
+        return this.activityCodes.includes(code);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexClient(${this.id}, ${this.name}, RFC: ${this.rfc ?? "N/A"})`;
+    }
+    /**
+     * Linked clients (if included) instantiated as MexClient
+     */
+    get linkedClients() {
+        return (this._data.linkedClients ?? []).map((l) => ({
+            relationshipType: l.relationshipType,
+            client: new MexClient(l.client),
+        }));
+    }
+    get addresses() {
+        return this._data.addresses?.map((a) => new MexAddress(a));
+    }
+    get bankAccounts() {
+        return this._data.bankAccounts?.map((b) => new MexBankAccount(b));
+    }
+}
+import { MexAddress } from "./MexAddress";
+/**
+ * Check if client is a Mexico client
+ */
+export function isMexClient(client) {
+    return client instanceof MexClient;
+}