@artu-ai/compliance-sdk 0.13.4 → 0.17.0

package/dist/models/mx/av/mjr/MexMJRClient.d.ts

@@ -37,4 +37,3 @@ import type { ClientModel } from "../../../types";
  * Check if client is a MJR (Metales y Joyas) client
  */
 export declare function isMexMJRClient(client: ClientModel): client is MexMJRClient;
-//# sourceMappingURL=MexMJRClient.d.ts.map

package/dist/models/mx/av/mjr/MexMJRProduct.d.ts

@@ -67,4 +67,3 @@ import type { Product } from "../../../Product";
  * Check if product is a MJR (Metales y Joyas) product
  */
 export declare function isMexMJRProduct(product: Product): product is MexMJRProduct;
-//# sourceMappingURL=MexMJRProduct.d.ts.map

package/dist/models/mx/av/mjr/MexMJRTransaction.d.ts

@@ -76,4 +76,3 @@ import type { TransactionModel } from "../../../types";
  * Check if transaction is a MJR (Metales y Joyas) transaction
  */
 export declare function isMexMJRTransaction(txn: TransactionModel): txn is MexMJRTransaction;
-//# sourceMappingURL=MexMJRTransaction.d.ts.map

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

@@ -0,0 +1,53 @@
+/**
+ * Mexico MPC Alert Model
+ *
+ * Alert model for Mutuo, Préstamos y Créditos activity.
+ */
+import type { mpc } from "@artu-ai/shared";
+import { MexAVAlert, type MexAVAlertData } from "../MexAVAlert";
+/**
+ * MPC alert data
+ */
+export interface MexMPCAlertData extends MexAVAlertData {
+    scopeData?: {
+        MX?: {
+            actividadVulnerable?: {
+                MPC?: mpc.MPCAlertData;
+            };
+        };
+        [key: string]: unknown;
+    };
+}
+/**
+ * Mexico MPC Alert Model.
+ *
+ * Provides typed accessors for MPC-specific alert data.
+ *
+ * @example
+ * ```typescript
+ * if (alert instanceof MexMPCAlert) {
+ *   console.log(`Period: ${alert.mesReportado}`);
+ * }
+ * ```
+ */
+export declare class MexMPCAlert extends MexAVAlert {
+    /**
+     * MPC-specific alert data
+     */
+    protected get mpcData(): mpc.MPCAlertData | 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 an MPC (Mutuo, Préstamos y Créditos) alert
+ */
+export declare function isMexMPCAlert(alert: AlertModel): alert is MexMPCAlert;

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

@@ -0,0 +1,77 @@
+/**
+ * Mexico MPC Alert Model
+ *
+ * Alert model for Mutuo, Préstamos y Créditos activity.
+ */
+import { MexAVAlert } from "../MexAVAlert";
+// ===========================
+// MexMPCAlert Model
+// ===========================
+/**
+ * Mexico MPC Alert Model.
+ *
+ * Provides typed accessors for MPC-specific alert data.
+ *
+ * @example
+ * ```typescript
+ * if (alert instanceof MexMPCAlert) {
+ *   console.log(`Period: ${alert.mesReportado}`);
+ * }
+ * ```
+ */
+export class MexMPCAlert extends MexAVAlert {
+    // ─────────────────────────────────────────────────────────────────
+    // MPC Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * MPC-specific alert data
+     */
+    get mpcData() {
+        return this.actividadVulnerableData?.MPC;
+    }
+    /**
+     * Reporting period (YYYYMM format)
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.mesReportado
+     */
+    get mesReportado() {
+        const avData = this.actividadVulnerableData;
+        return avData?.mesReportado ?? undefined;
+    }
+    /**
+     * Reporting period as a formatted string (e.g., "January 2024")
+     */
+    get formattedPeriod() {
+        const mes = this.mesReportado;
+        if (!mes)
+            return undefined;
+        const year = mes.slice(0, 4);
+        const month = parseInt(mes.slice(4, 6), 10);
+        const monthNames = [
+            "January",
+            "February",
+            "March",
+            "April",
+            "May",
+            "June",
+            "July",
+            "August",
+            "September",
+            "October",
+            "November",
+            "December",
+        ];
+        return `${monthNames[month - 1]} ${year}`;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexMPCAlert(${this.id}, ${this.mesReportado ?? "N/A"})`;
+    }
+}
+/**
+ * Check if alert is an MPC (Mutuo, Préstamos y Créditos) alert
+ */
+export function isMexMPCAlert(alert) {
+    return alert instanceof MexMPCAlert;
+}

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

@@ -0,0 +1,60 @@
+/**
+ * Mexico MPC Alert Client Item Model
+ *
+ * Alert client item model for Mutuo, Préstamos y Créditos activity.
+ * Provides BOTH client-side and alert-item-side MPC-specific accessors.
+ */
+import type { mpc } from "@artu-ai/shared";
+import { MexAVAlertClientItem, type MexAVAlertClientItemData } from "../MexAVAlertClientItem";
+/**
+ * MPC alert client item data
+ */
+export type MexMPCAlertClientItemData = MexAVAlertClientItemData & {
+    alertItemScopeData?: {
+        MX?: {
+            actividadVulnerable?: {
+                MPC?: mpc.MPCAlertItemData;
+            };
+        };
+        [key: string]: unknown;
+    };
+};
+/**
+ * Mexico MPC Alert Client Item Model.
+ *
+ * Provides typed accessors for both:
+ * - Client-side MPC data
+ * - Alert-item-side MPC data (alertType, amendment, etc.)
+ */
+export declare class MexMPCAlertClientItem extends MexAVAlertClientItem {
+    /**
+     * MPC-specific alert item data
+     */
+    protected get mpcData(): mpc.MPCAlertItemData | undefined;
+    /**
+     * Alert type code
+     * - "100" for monthly alerts
+     * - Other codes for unusual activity
+     */
+    get alertType(): mpc.MPCTipoAlerta | undefined;
+    /**
+     * Alert description (for unusual activity)
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.alertDescription
+     */
+    get alertDescription(): string | undefined;
+    /**
+     * Amendment data for corrections
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.amendment
+     */
+    get amendment(): mpc.Amendment | undefined;
+    /**
+     * Whether this item is an amendment
+     */
+    get isAmendment(): boolean;
+    toString(): string;
+}
+import type { AlertClientItemModel } from "../../../types";
+/**
+ * Check if alert client item is an MPC (Mutuo, Préstamos y Créditos) alert client item
+ */
+export declare function isMexMPCAlertClientItem(item: AlertClientItemModel): item is MexMPCAlertClientItem;

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

@@ -0,0 +1,68 @@
+/**
+ * Mexico MPC Alert Client Item Model
+ *
+ * Alert client item model for Mutuo, Préstamos y Créditos activity.
+ * Provides BOTH client-side and alert-item-side MPC-specific accessors.
+ */
+import { MexAVAlertClientItem, } from "../MexAVAlertClientItem";
+// ===========================
+// MexMPCAlertClientItem Model
+// ===========================
+/**
+ * Mexico MPC Alert Client Item Model.
+ *
+ * Provides typed accessors for both:
+ * - Client-side MPC data
+ * - Alert-item-side MPC data (alertType, amendment, etc.)
+ */
+export class MexMPCAlertClientItem extends MexAVAlertClientItem {
+    // ─────────────────────────────────────────────────────────────────
+    // Alert Item-Side MPC Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * MPC-specific alert item data
+     */
+    get mpcData() {
+        return this.alertItemActividadVulnerableData?.MPC;
+    }
+    /**
+     * Alert type code
+     * - "100" for monthly alerts
+     * - Other codes for unusual activity
+     */
+    get alertType() {
+        return this.mpcData?.alertType;
+    }
+    /**
+     * Alert description (for unusual activity)
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.alertDescription
+     */
+    get alertDescription() {
+        return this.alertItemActividadVulnerableData?.alertDescription;
+    }
+    /**
+     * Amendment data for corrections
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.amendment
+     */
+    get amendment() {
+        return this.alertItemActividadVulnerableData?.amendment;
+    }
+    /**
+     * Whether this item is an amendment
+     */
+    get isAmendment() {
+        return !!this.alertItemActividadVulnerableData?.amendment;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexMPCAlertClientItem(${this.id}, ${this.name}, alertItem=${this.alertItemId ?? "indirect"}, alertType=${this.alertType ?? "N/A"})`;
+    }
+}
+/**
+ * Check if alert client item is an MPC (Mutuo, Préstamos y Créditos) alert client item
+ */
+export function isMexMPCAlertClientItem(item) {
+    return item instanceof MexMPCAlertClientItem;
+}

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

@@ -0,0 +1,57 @@
+/**
+ * Mexico MPC Alert Item Model
+ *
+ * Alert item model for Mutuo, Préstamos y Créditos activity.
+ */
+import type { mpc } from "@artu-ai/shared";
+import { MexAVAlertItem, type MexAVAlertItemData } from "../MexAVAlertItem";
+/**
+ * MPC alert item data
+ */
+export interface MexMPCAlertItemData extends MexAVAlertItemData {
+    scopeData?: {
+        MX?: {
+            actividadVulnerable?: {
+                MPC?: mpc.MPCAlertItemData;
+            };
+        };
+        [key: string]: unknown;
+    };
+}
+/**
+ * Mexico MPC Alert Item Model.
+ *
+ * Provides typed accessors for MPC-specific alert item data.
+ */
+export declare class MexMPCAlertItem extends MexAVAlertItem {
+    /**
+     * MPC-specific alert item data
+     */
+    protected get mpcData(): mpc.MPCAlertItemData | undefined;
+    /**
+     * Alert type code
+     * - "100" for monthly alerts
+     * - Other codes for unusual activity
+     */
+    get alertType(): mpc.MPCTipoAlerta | undefined;
+    /**
+     * Alert description (for unusual activity)
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.alertDescription
+     */
+    get alertDescription(): string | undefined;
+    /**
+     * Amendment data for corrections
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.amendment
+     */
+    get amendment(): mpc.Amendment | undefined;
+    /**
+     * Whether this item is an amendment
+     */
+    get isAmendment(): boolean;
+    toString(): string;
+}
+import type { AlertItemModel } from "../../../types";
+/**
+ * Check if alert item is an MPC (Mutuo, Préstamos y Créditos) alert item
+ */
+export declare function isMexMPCAlertItem(item: AlertItemModel): item is MexMPCAlertItem;

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

@@ -0,0 +1,67 @@
+/**
+ * Mexico MPC Alert Item Model
+ *
+ * Alert item model for Mutuo, Préstamos y Créditos activity.
+ */
+import { MexAVAlertItem } from "../MexAVAlertItem";
+// ===========================
+// MexMPCAlertItem Model
+// ===========================
+/**
+ * Mexico MPC Alert Item Model.
+ *
+ * Provides typed accessors for MPC-specific alert item data.
+ */
+export class MexMPCAlertItem extends MexAVAlertItem {
+    // ─────────────────────────────────────────────────────────────────
+    // MPC Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * MPC-specific alert item data
+     */
+    get mpcData() {
+        return this.actividadVulnerableData?.MPC;
+    }
+    /**
+     * Alert type code
+     * - "100" for monthly alerts
+     * - Other codes for unusual activity
+     */
+    get alertType() {
+        return this.mpcData?.alertType;
+    }
+    /**
+     * Alert description (for unusual activity)
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.alertDescription
+     */
+    get alertDescription() {
+        const avData = this.actividadVulnerableData;
+        return avData?.alertDescription ?? undefined;
+    }
+    /**
+     * Amendment data for corrections
+     * Lives at the AV level: scopeData.MX.actividadVulnerable.amendment
+     */
+    get amendment() {
+        const avData = this.actividadVulnerableData;
+        return avData?.amendment ?? undefined;
+    }
+    /**
+     * Whether this item is an amendment
+     */
+    get isAmendment() {
+        return !!this.amendment;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexMPCAlertItem(${this.id}, ${this.clientNames?.join(", ") ?? "Unknown"}, Alert: ${this.alertType ?? "N/A"})`;
+    }
+}
+/**
+ * Check if alert item is an MPC (Mutuo, Préstamos y Créditos) alert item
+ */
+export function isMexMPCAlertItem(item) {
+    return item instanceof MexMPCAlertItem;
+}

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

@@ -0,0 +1,92 @@
+/**
+ * Mexico MPC Alert Transaction Item Model
+ *
+ * Alert transaction item model for Mutuo, Préstamos y Créditos activity.
+ * Provides BOTH transaction-side MPC getters and alert-item-side MPC getters.
+ */
+import type { mpc } from "@artu-ai/shared";
+import { MexAVAlertTransactionItem, type MexAVAlertTransactionItemData } from "../MexAVAlertTransactionItem";
+/**
+ * MPC alert transaction item data
+ */
+export interface MexMPCAlertTransactionItemData extends MexAVAlertTransactionItemData {
+    alertItemScopeData?: {
+        MX?: {
+            actividadVulnerable?: {
+                MPC?: mpc.MPCAlertItemData;
+            };
+        };
+        [key: string]: unknown;
+    };
+}
+/**
+ * Mexico MPC Alert Transaction Item Model.
+ *
+ * Provides typed accessors for both:
+ * - Transaction-side MPC data (operation, postal code, collateral, disbursements)
+ * - Alert-item-side MPC data (alert type, description, amendment)
+ */
+export declare class MexMPCAlertTransactionItem extends MexAVAlertTransactionItem {
+    /**
+     * MPC-specific transaction data
+     */
+    protected get mpcTxData(): mpc.MPCTransactionData | undefined;
+    /**
+     * Operation type
+     */
+    get operationType(): string | undefined;
+    /**
+     * Postal code where the operation took place
+     */
+    get postalCode(): string | undefined;
+    /**
+     * Array of collateral entries for this transaction.
+     */
+    get collateral(): mpc.MPCCollateral[];
+    /**
+     * Array of disbursements 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;
+    /**
+     * MPC-specific alert item data
+     */
+    protected get alertItemMpcData(): mpc.MPCAlertItemData | undefined;
+    /**
+     * Alert type code
+     * - "100" for monthly alerts
+     * - Other codes for unusual activity
+     */
+    get alertType(): mpc.MPCTipoAlerta | undefined;
+    /**
+     * Alert description (for unusual activity)
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.alertDescription
+     */
+    get alertDescription(): string | undefined;
+    /**
+     * Amendment data for corrections
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.amendment
+     */
+    get amendment(): mpc.Amendment | undefined;
+    /**
+     * Whether this item is an amendment
+     */
+    get isAmendment(): boolean;
+    toString(): string;
+}
+import type { AlertTransactionItemModel } from "../../../types";
+/**
+ * Check if alert transaction item is an MPC (Mutuo, Préstamos y Créditos) alert transaction item
+ */
+export declare function isMexMPCAlertTransactionItem(item: AlertTransactionItemModel): item is MexMPCAlertTransactionItem;

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

@@ -0,0 +1,119 @@
+/**
+ * Mexico MPC Alert Transaction Item Model
+ *
+ * Alert transaction item model for Mutuo, Préstamos y Créditos activity.
+ * Provides BOTH transaction-side MPC getters and alert-item-side MPC getters.
+ */
+import { MexAVAlertTransactionItem, } from "../MexAVAlertTransactionItem";
+// ===========================
+// MexMPCAlertTransactionItem Model
+// ===========================
+/**
+ * Mexico MPC Alert Transaction Item Model.
+ *
+ * Provides typed accessors for both:
+ * - Transaction-side MPC data (operation, postal code, collateral, disbursements)
+ * - Alert-item-side MPC data (alert type, description, amendment)
+ */
+export class MexMPCAlertTransactionItem extends MexAVAlertTransactionItem {
+    // ─────────────────────────────────────────────────────────────────
+    // Transaction-Side MPC Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * MPC-specific transaction data
+     */
+    get mpcTxData() {
+        return this.actividadVulnerableData?.MPC;
+    }
+    /**
+     * Operation type
+     */
+    get operationType() {
+        return this.mpcTxData?.operationType;
+    }
+    /**
+     * Postal code where the operation took place
+     */
+    get postalCode() {
+        return this.mpcTxData?.postalCode;
+    }
+    /**
+     * Array of collateral entries for this transaction.
+     */
+    get collateral() {
+        return this.mpcTxData?.collateral ?? [];
+    }
+    /**
+     * Array of disbursements for this transaction.
+     */
+    get disbursements() {
+        return this.mpcTxData?.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);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Alert Item-Side MPC Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * MPC-specific alert item data
+     */
+    get alertItemMpcData() {
+        return this.alertItemActividadVulnerableData?.MPC;
+    }
+    /**
+     * Alert type code
+     * - "100" for monthly alerts
+     * - Other codes for unusual activity
+     */
+    get alertType() {
+        return this.alertItemMpcData?.alertType;
+    }
+    /**
+     * Alert description (for unusual activity)
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.alertDescription
+     */
+    get alertDescription() {
+        return this.alertItemActividadVulnerableData?.alertDescription;
+    }
+    /**
+     * Amendment data for corrections
+     * Lives at the AV level: alertItemScopeData.MX.actividadVulnerable.amendment
+     */
+    get amendment() {
+        return this.alertItemActividadVulnerableData?.amendment;
+    }
+    /**
+     * Whether this item is an amendment
+     */
+    get isAmendment() {
+        return !!this.alertItemActividadVulnerableData?.amendment;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexMPCAlertTransactionItem(${this.id}, ${this.formattedAmount}, alertItem=${this.alertItemId}, alertType=${this.alertType ?? "N/A"})`;
+    }
+}
+/**
+ * Check if alert transaction item is an MPC (Mutuo, Préstamos y Créditos) alert transaction item
+ */
+export function isMexMPCAlertTransactionItem(item) {
+    return item instanceof MexMPCAlertTransactionItem;
+}

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

@@ -0,0 +1,39 @@
+/**
+ * Mexico MPC (Mutuo, Préstamos y Créditos) Client
+ *
+ * Specialized for loan/credit activity.
+ */
+import type { ClientRelationshipType, mpc } from "@artu-ai/shared";
+import { MexAVClient } from "../MexAVClient";
+/**
+ * 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 declare class MexMPCClient extends MexAVClient {
+    /**
+     * MPC-specific activity data
+     */
+    protected get mpcData(): mpc.MPCClientData | undefined;
+    toString(): string;
+    /**
+     * Linked clients (if included) instantiated as MexMPCClient
+     */
+    get linkedClients(): {
+        relationshipType: ClientRelationshipType;
+        client: MexMPCClient;
+    }[] | undefined;
+}
+import type { ClientModel } from "../../../types";
+/**
+ * Check if client is an MPC (Mutuo, Préstamos y Créditos) client
+ */
+export declare function isMexMPCClient(client: ClientModel): client is MexMPCClient;