@artu-ai/compliance-sdk 0.13.4 → 0.17.0

package/dist/models/mx/av/mpc/MexMPCClient.js

@@ -0,0 +1,54 @@
+/**
+ * Mexico MPC (Mutuo, Préstamos y Créditos) Client
+ *
+ * Specialized for loan/credit activity.
+ */
+import { MexAVClient } from "../MexAVClient";
+// ===========================
+// MexMPCClient Model
+// ===========================
+/**
+ * Mexico MPC Client Model.
+ *
+ * Provides typed accessors for loan/credit specific data.
+ * MPC clients have no activity-specific fields beyond the base.
+ *
+ * @example
+ * ```typescript
+ * if (client instanceof MexMPCClient) {
+ *   console.log(`MPC Client: ${client.name}`);
+ * }
+ * ```
+ */
+export class MexMPCClient extends MexAVClient {
+    // ─────────────────────────────────────────────────────────────────
+    // MPC-Specific Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * MPC-specific activity data
+     */
+    get mpcData() {
+        return this.mexicoData?.actividadVulnerable?.MPC;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexMPCClient(${this.id}, ${this.name})`;
+    }
+    /**
+     * Linked clients (if included) instantiated as MexMPCClient
+     */
+    get linkedClients() {
+        return (this._data.linkedClients ?? []).map((l) => ({
+            relationshipType: l.relationshipType,
+            client: new MexMPCClient(l.client),
+        }));
+    }
+}
+/**
+ * Check if client is an MPC (Mutuo, Préstamos y Créditos) client
+ */
+export function isMexMPCClient(client) {
+    return client instanceof MexMPCClient;
+}

package/dist/models/mx/av/mpc/MexMPCProduct.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Mexico MPC (Mutuo, Préstamos y Créditos) Product
+ *
+ * Specialized for loan/credit product templates.
+ */
+import type { MPCProductData } from "@artu-ai/shared";
+import { MexAVProduct } from "../MexAVProduct";
+/**
+ * Mexico MPC Product Model.
+ *
+ * Provides typed accessors for loan/credit product data.
+ *
+ * MPC products carry their default collateral settings under
+ * `defaultCollateral` (single object — there is no per-transaction
+ * collateral default in the array sense, since disbursement details are
+ * always captured at transaction creation time).
+ *
+ * @example
+ * ```typescript
+ * if (product instanceof MexMPCProduct) {
+ *   console.log(`Operation: ${product.operationType}`);
+ *   console.log(`Default tipoGarantia: ${product.defaultCollateral?.tipoGarantia}`);
+ * }
+ * ```
+ */
+export declare class MexMPCProduct extends MexAVProduct {
+    /**
+     * MPC-specific product data
+     */
+    protected get mpcData(): MPCProductData | undefined;
+    /**
+     * Operation type
+     */
+    get operationType(): string | undefined;
+    /**
+     * Default collateral settings used as a template for linked transactions.
+     */
+    get defaultCollateral(): MPCProductData["defaultCollateral"] | undefined;
+    toString(): string;
+}
+import type { Product } from "../../../Product";
+/**
+ * Check if product is an MPC (Mutuo, Préstamos y Créditos) product
+ */
+export declare function isMexMPCProduct(product: Product): product is MexMPCProduct;

package/dist/models/mx/av/mpc/MexMPCProduct.js

@@ -0,0 +1,68 @@
+/**
+ * Mexico MPC (Mutuo, Préstamos y Créditos) Product
+ *
+ * Specialized for loan/credit product templates.
+ */
+import { MexAVProduct } from "../MexAVProduct";
+// ===========================
+// MexMPCProduct Model
+// ===========================
+/**
+ * Mexico MPC Product Model.
+ *
+ * Provides typed accessors for loan/credit product data.
+ *
+ * MPC products carry their default collateral settings under
+ * `defaultCollateral` (single object — there is no per-transaction
+ * collateral default in the array sense, since disbursement details are
+ * always captured at transaction creation time).
+ *
+ * @example
+ * ```typescript
+ * if (product instanceof MexMPCProduct) {
+ *   console.log(`Operation: ${product.operationType}`);
+ *   console.log(`Default tipoGarantia: ${product.defaultCollateral?.tipoGarantia}`);
+ * }
+ * ```
+ */
+export class MexMPCProduct extends MexAVProduct {
+    // ─────────────────────────────────────────────────────────────────
+    // MPC-Specific Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * MPC-specific product data
+     */
+    get mpcData() {
+        return this.actividadVulnerableData?.MPC;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Operation Fields
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Operation type
+     */
+    get operationType() {
+        return this.mpcData?.operationType;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Default Collateral
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Default collateral settings used as a template for linked transactions.
+     */
+    get defaultCollateral() {
+        return this.mpcData?.defaultCollateral;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexMPCProduct(${this.id}, ${this.name}, operationType: ${this.operationType ?? "N/A"})`;
+    }
+}
+/**
+ * Check if product is an MPC (Mutuo, Préstamos y Créditos) product
+ */
+export function isMexMPCProduct(product) {
+    return product instanceof MexMPCProduct;
+}

package/dist/models/mx/av/mpc/MexMPCTransaction.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Mexico MPC (Mutuo, Préstamos y Créditos) Transaction
+ *
+ * Specialized for loan/credit transactions.
+ */
+import type { mpc } from "@artu-ai/shared";
+import { MexAVTransaction } from "../MexAVTransaction";
+/**
+ * Mexico MPC Transaction Model.
+ *
+ * Provides typed accessors for loan/credit transaction data.
+ * MPC transactions have a `collateral[]` array (only for ConGarantia operations)
+ * and a `disbursements[]` array (fund-release records).
+ *
+ * @example
+ * ```typescript
+ * if (txn instanceof MexMPCTransaction) {
+ *   console.log(`Operation: ${txn.operationType}`);
+ *   console.log(`Postal Code: ${txn.postalCode}`);
+ *   console.log(`Collateral: ${txn.collateral.length}`);
+ *   console.log(`Disbursements: ${txn.disbursements.length}`);
+ * }
+ * ```
+ */
+export declare class MexMPCTransaction extends MexAVTransaction {
+    /**
+     * MPC-specific transaction data
+     */
+    protected get mpcData(): mpc.MPCTransactionData | undefined;
+    /**
+     * Operation type: "401" (SinGarantia) or "402" (ConGarantia)
+     */
+    get operationType(): string | undefined;
+    /**
+     * Postal code where the operation took place
+     */
+    get postalCode(): string | undefined;
+    /**
+     * Array of collateral entries for this transaction.
+     * Empty for SinGarantia (401) operations.
+     */
+    get collateral(): mpc.MPCCollateral[];
+    /**
+     * Whether this transaction carries any collateral.
+     */
+    get hasCollateral(): boolean;
+    /**
+     * Total number of collateral entries.
+     */
+    get collateralCount(): number;
+    /**
+     * Array of disbursements (fund-release records) for this transaction.
+     */
+    get disbursements(): mpc.MPCDisbursementData[];
+    /**
+     * Whether this transaction has any disbursements.
+     */
+    get hasDisbursements(): boolean;
+    /**
+     * Total number of disbursements in this transaction.
+     */
+    get disbursementsCount(): number;
+    /**
+     * Total disbursement amount across all disbursements.
+     */
+    get totalDisbursementAmount(): number;
+    toString(): string;
+}
+import type { TransactionModel } from "../../../types";
+/**
+ * Check if transaction is an MPC (Mutuo, Préstamos y Créditos) transaction
+ */
+export declare function isMexMPCTransaction(txn: TransactionModel): txn is MexMPCTransaction;

package/dist/models/mx/av/mpc/MexMPCTransaction.js

@@ -0,0 +1,113 @@
+/**
+ * Mexico MPC (Mutuo, Préstamos y Créditos) Transaction
+ *
+ * Specialized for loan/credit transactions.
+ */
+import { MexAVTransaction } from "../MexAVTransaction";
+// ===========================
+// MexMPCTransaction Model
+// ===========================
+/**
+ * Mexico MPC Transaction Model.
+ *
+ * Provides typed accessors for loan/credit transaction data.
+ * MPC transactions have a `collateral[]` array (only for ConGarantia operations)
+ * and a `disbursements[]` array (fund-release records).
+ *
+ * @example
+ * ```typescript
+ * if (txn instanceof MexMPCTransaction) {
+ *   console.log(`Operation: ${txn.operationType}`);
+ *   console.log(`Postal Code: ${txn.postalCode}`);
+ *   console.log(`Collateral: ${txn.collateral.length}`);
+ *   console.log(`Disbursements: ${txn.disbursements.length}`);
+ * }
+ * ```
+ */
+export class MexMPCTransaction extends MexAVTransaction {
+    // ─────────────────────────────────────────────────────────────────
+    // MPC-Specific Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * MPC-specific transaction data
+     */
+    get mpcData() {
+        return this.mexicoData?.actividadVulnerable?.MPC;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Operation Fields
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Operation type: "401" (SinGarantia) or "402" (ConGarantia)
+     */
+    get operationType() {
+        return this.mpcData?.operationType;
+    }
+    /**
+     * Postal code where the operation took place
+     */
+    get postalCode() {
+        return this.mpcData?.postalCode;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Collateral (datos_garantia)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Array of collateral entries for this transaction.
+     * Empty for SinGarantia (401) operations.
+     */
+    get collateral() {
+        return this.mpcData?.collateral ?? [];
+    }
+    /**
+     * Whether this transaction carries any collateral.
+     */
+    get hasCollateral() {
+        return this.collateral.length > 0;
+    }
+    /**
+     * Total number of collateral entries.
+     */
+    get collateralCount() {
+        return this.collateral.length;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Disbursements (datos_liquidacion)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Array of disbursements (fund-release records) for this transaction.
+     */
+    get disbursements() {
+        return this.mpcData?.disbursements ?? [];
+    }
+    /**
+     * Whether this transaction has any disbursements.
+     */
+    get hasDisbursements() {
+        return this.disbursements.length > 0;
+    }
+    /**
+     * Total number of disbursements in this transaction.
+     */
+    get disbursementsCount() {
+        return this.disbursements.length;
+    }
+    /**
+     * Total disbursement amount across all disbursements.
+     */
+    get totalDisbursementAmount() {
+        return this.disbursements.reduce((sum, d) => sum + Number(d.amount), 0);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexMPCTransaction(${this.id}, ${this.formattedAmount}, collateral: ${this.collateral.length}, disbursements: ${this.disbursementsCount})`;
+    }
+}
+/**
+ * Check if transaction is an MPC (Mutuo, Préstamos y Créditos) transaction
+ */
+export function isMexMPCTransaction(txn) {
+    return txn instanceof MexMPCTransaction;
+}

package/dist/models/mx/av/tsc/MexTSCAlert.d.ts

@@ -9,7 +9,7 @@ import { MexAVAlert, type MexAVAlertData } from "../MexAVAlert";
  * TSC alert data
  */
 export interface MexTSCAlertData extends MexAVAlertData {
-    jurisdictions?: {
+    scopeData?: {
         MX?: {
             actividadVulnerable?: {
                 TSC?: tsc.TSCAlertData;
@@ -37,7 +37,7 @@ export declare class MexTSCAlert extends MexAVAlert {
     protected get tscData(): tsc.TSCAlertData | undefined;
     /**
      * Reporting period (YYYYMM format)
-     * Lives at the AV level: jurisdictions.MX.actividadVulnerable.mesReportado
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.mesReportado
      */
     get mesReportado(): string | undefined;
     /**
@@ -51,4 +51,3 @@ import type { AlertModel } from "../../../types";
  * Check if alert is a TSC (Tarjetas de Servicio y Crédito) alert
  */
 export declare function isMexTSCAlert(alert: AlertModel): alert is MexTSCAlert;
-//# sourceMappingURL=MexTSCAlert.d.ts.map

package/dist/models/mx/av/tsc/MexTSCAlert.js

@@ -31,7 +31,7 @@ export class MexTSCAlert extends MexAVAlert {
     }
     /**
      * Reporting period (YYYYMM format)
-     * Lives at the AV level: jurisdictions.MX.actividadVulnerable.mesReportado
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.mesReportado
      */
     get mesReportado() {
         const avData = this.actividadVulnerableData;

package/dist/models/mx/av/tsc/MexTSCAlertClientItem.d.ts

@@ -11,7 +11,7 @@ type TipoAlerta = actividadVulnerable.tsc.TipoAlerta;
  * TSC alert client item data
  */
 export type MexTSCAlertClientItemData = MexAVAlertClientItemData & {
-    alertItemJurisdictions?: {
+    alertItemScopeData?: {
         MX?: {
             actividadVulnerable?: {
                 TSC?: tsc.TSCAlertItemData;
@@ -44,12 +44,12 @@ export declare class MexTSCAlertClientItem extends MexAVAlertClientItem {
     get alertType(): TipoAlerta | undefined;
     /**
      * Alert description (for unusual activity)
-     * Lives at the AV level: alertItemJurisdictions.MX.actividadVulnerable.alertDescription
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.alertDescription
      */
     get alertDescription(): string | undefined;
     /**
      * Amendment data for corrections
-     * Lives at the AV level: alertItemJurisdictions.MX.actividadVulnerable.amendment
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.amendment
      */
     get amendment(): tsc.Amendment | undefined;
     /**
@@ -64,4 +64,3 @@ import type { AlertClientItemModel } from "../../../types";
  */
 export declare function isMexTSCAlertClientItem(item: AlertClientItemModel): item is MexTSCAlertClientItem;
 export {};
-//# sourceMappingURL=MexTSCAlertClientItem.d.ts.map

package/dist/models/mx/av/tsc/MexTSCAlertClientItem.js

@@ -44,14 +44,14 @@ export class MexTSCAlertClientItem extends MexAVAlertClientItem {
     }
     /**
      * Alert description (for unusual activity)
-     * Lives at the AV level: alertItemJurisdictions.MX.actividadVulnerable.alertDescription
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.alertDescription
      */
     get alertDescription() {
         return this.alertItemActividadVulnerableData?.alertDescription;
     }
     /**
      * Amendment data for corrections
-     * Lives at the AV level: alertItemJurisdictions.MX.actividadVulnerable.amendment
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.amendment
      */
     get amendment() {
         return this.alertItemActividadVulnerableData?.amendment;

package/dist/models/mx/av/tsc/MexTSCAlertItem.d.ts

@@ -10,7 +10,7 @@ type TipoAlerta = actividadVulnerable.tsc.TipoAlerta;
  * TSC alert item data
  */
 export interface MexTSCAlertItemData extends MexAVAlertItemData {
-    jurisdictions?: {
+    scopeData?: {
         MX?: {
             actividadVulnerable?: {
                 TSC?: tsc.TSCAlertItemData;
@@ -37,12 +37,12 @@ export declare class MexTSCAlertItem extends MexAVAlertItem {
     get alertType(): TipoAlerta | undefined;
     /**
      * Alert description (for unusual activity)
-     * Lives at the AV level: jurisdictions.MX.actividadVulnerable.alertDescription
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.alertDescription
      */
     get alertDescription(): string | undefined;
     /**
      * Amendment data for corrections
-     * Lives at the AV level: jurisdictions.MX.actividadVulnerable.amendment
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.amendment
      */
     get amendment(): tsc.Amendment | undefined;
     /**
@@ -57,4 +57,3 @@ import type { AlertItemModel } from "../../../types";
  */
 export declare function isMexTSCAlertItem(item: AlertItemModel): item is MexTSCAlertItem;
 export {};
-//# sourceMappingURL=MexTSCAlertItem.d.ts.map

package/dist/models/mx/av/tsc/MexTSCAlertItem.js

@@ -32,7 +32,7 @@ export class MexTSCAlertItem extends MexAVAlertItem {
     }
     /**
      * Alert description (for unusual activity)
-     * Lives at the AV level: jurisdictions.MX.actividadVulnerable.alertDescription
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.alertDescription
      */
     get alertDescription() {
         const avData = this.actividadVulnerableData;
@@ -40,7 +40,7 @@ export class MexTSCAlertItem extends MexAVAlertItem {
     }
     /**
      * Amendment data for corrections
-     * Lives at the AV level: jurisdictions.MX.actividadVulnerable.amendment
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.amendment
      */
     get amendment() {
         const avData = this.actividadVulnerableData;

package/dist/models/mx/av/tsc/MexTSCAlertTransactionItem.d.ts

@@ -12,7 +12,7 @@ type TipoAlerta = actividadVulnerable.tsc.TipoAlerta;
  * TSC alert transaction item data
  */
 export interface MexTSCAlertTransactionItemData extends MexAVAlertTransactionItemData {
-    alertItemJurisdictions?: {
+    alertItemScopeData?: {
         MX?: {
             actividadVulnerable?: {
                 TSC?: tsc.TSCAlertItemData;
@@ -65,12 +65,12 @@ export declare class MexTSCAlertTransactionItem extends MexAVAlertTransactionIte
     get alertType(): TipoAlerta | undefined;
     /**
      * Alert description (for unusual activity)
-     * Lives at the AV level: alertItemJurisdictions.MX.actividadVulnerable.alertDescription
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.alertDescription
      */
     get alertDescription(): string | undefined;
     /**
      * Amendment data for corrections
-     * Lives at the AV level: alertItemJurisdictions.MX.actividadVulnerable.amendment
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.amendment
      */
     get amendment(): tsc.Amendment | undefined;
     /**
@@ -85,4 +85,3 @@ import type { AlertTransactionItemModel } from "../../../types";
  */
 export declare function isMexTSCAlertTransactionItem(item: AlertTransactionItemModel): item is MexTSCAlertTransactionItem;
 export {};
-//# sourceMappingURL=MexTSCAlertTransactionItem.d.ts.map

package/dist/models/mx/av/tsc/MexTSCAlertTransactionItem.js

@@ -77,14 +77,14 @@ export class MexTSCAlertTransactionItem extends MexAVAlertTransactionItem {
     }
     /**
      * Alert description (for unusual activity)
-     * Lives at the AV level: alertItemJurisdictions.MX.actividadVulnerable.alertDescription
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.alertDescription
      */
     get alertDescription() {
         return this.alertItemActividadVulnerableData?.alertDescription;
     }
     /**
      * Amendment data for corrections
-     * Lives at the AV level: alertItemJurisdictions.MX.actividadVulnerable.amendment
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.amendment
      */
     get amendment() {
         return this.alertItemActividadVulnerableData?.amendment;

package/dist/models/mx/av/tsc/MexTSCClient.d.ts

@@ -36,4 +36,3 @@ import type { ClientModel } from "../../../types";
  * Check if client is a TSC (Tarjetas de Servicio y Crédito) client
  */
 export declare function isMexTSCClient(client: ClientModel): client is MexTSCClient;
-//# sourceMappingURL=MexTSCClient.d.ts.map

package/dist/models/mx/av/tsc/MexTSCProduct.d.ts

@@ -46,4 +46,3 @@ import type { Product } from "../../../Product";
  * Check if product is a TSC (Tarjetas de Servicio y Credito) product
  */
 export declare function isMexTSCProduct(product: Product): product is MexTSCProduct;
-//# sourceMappingURL=MexTSCProduct.d.ts.map

package/dist/models/mx/av/tsc/MexTSCTransaction.d.ts

@@ -50,4 +50,3 @@ import type { TransactionModel } from "../../../types";
  * Check if transaction is a TSC (Tarjetas de Servicio y Crédito) transaction
  */
 export declare function isMexTSCTransaction(txn: TransactionModel): txn is MexTSCTransaction;
-//# sourceMappingURL=MexTSCTransaction.d.ts.map

package/dist/models/mx/av/veh/MexVEHAlert.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Mexico VEH Alert Model
+ *
+ * Alert model for Vehículos activity.
+ */
+import type { veh } from "@artu-ai/shared";
+import { MexAVAlert, type MexAVAlertData } from "../MexAVAlert";
+/**
+ * VEH alert data
+ */
+export interface MexVEHAlertData extends MexAVAlertData {
+    scopeData?: {
+        MX?: {
+            actividadVulnerable?: {
+                VEH?: veh.VEHAlertData;
+            };
+        };
+        [key: string]: unknown;
+    };
+}
+/**
+ * Mexico VEH Alert Model.
+ *
+ * Provides typed accessors for VEH-specific alert data.
+ *
+ * @example
+ * ```typescript
+ * if (alert instanceof MexVEHAlert) {
+ *   console.log(`Period: ${alert.mesReportado}`);
+ * }
+ * ```
+ */
+export declare class MexVEHAlert extends MexAVAlert {
+    /**
+     * VEH-specific alert data
+     */
+    protected get vehData(): veh.VEHAlertData | undefined;
+    /**
+     * Reporting period (YYYYMM format)
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.mesReportado
+     */
+    get mesReportado(): string | undefined;
+    /**
+     * Reporting period as a formatted string (e.g., "January 2024")
+     */
+    get formattedPeriod(): string | undefined;
+    toString(): string;
+}
+import type { AlertModel } from "../../../types";
+/**
+ * Check if alert is a VEH (Vehículos) alert
+ */
+export declare function isMexVEHAlert(alert: AlertModel): alert is MexVEHAlert;