@artu-ai/compliance-sdk 0.0.5 → 0.2.0

package/dist/models/mex/actividad-vulnerable/jys/MexJYSClient.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Mexico JYS (Juegos y Sorteos) Client
+ *
+ * Specialized for gaming and lottery operations.
+ */
+import type { ClientRelationshipType, jys } from "@artu-ai/shared";
+import { MexActividadVulnerableClient } from "../MexActividadVulnerableClient";
+/**
+ * Mexico JYS Client Model.
+ *
+ * Provides typed accessors for gaming/lottery specific data.
+ *
+ * @example
+ * ```typescript
+ * if (client instanceof MexJYSClient) {
+ *   console.log(`JYS Client: ${client.name}`);
+ * }
+ * ```
+ */
+export declare class MexJYSClient extends MexActividadVulnerableClient {
+    /**
+     * JYS-specific activity data
+     */
+    protected get jysData(): jys.JYSClientData | undefined;
+    toString(): string;
+    /**
+     * Linked clients (if included) instantiated as MexJYSClient
+     */
+    get linkedClients(): {
+        relationshipType: ClientRelationshipType;
+        client: MexJYSClient;
+    }[] | undefined;
+}
+import type { ClientModel } from "../../../types";
+/**
+ * Check if client is a JYS (Juegos y Sorteos) client
+ */
+export declare function isMexJYSClient(client: ClientModel): client is MexJYSClient;
+//# sourceMappingURL=MexJYSClient.d.ts.map

package/dist/models/mex/actividad-vulnerable/jys/MexJYSClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MexJYSClient.d.ts","sourceRoot":"","sources":["../../../../../src/models/mex/actividad-vulnerable/jys/MexJYSClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAM/E;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,4BAA4B;IAK5D;;OAEG;IACH,SAAS,KAAK,OAAO,IAAI,GAAG,CAAC,aAAa,GAAG,SAAS,CAErD;IAMQ,QAAQ,IAAI,MAAM;IAI3B;;OAEG;IACH,IAAa,aAAa,IACtB;QACE,gBAAgB,EAAE,sBAAsB,CAAC;QACzC,MAAM,EAAE,YAAY,CAAC;KACtB,EAAE,GACH,SAAS,CAKZ;CACF;AAMD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,IAAI,YAAY,CAE1E"}

package/dist/models/mex/actividad-vulnerable/jys/MexJYSClient.js

@@ -0,0 +1,53 @@
+/**
+ * Mexico JYS (Juegos y Sorteos) Client
+ *
+ * Specialized for gaming and lottery operations.
+ */
+import { MexActividadVulnerableClient } from "../MexActividadVulnerableClient";
+// ===========================
+// MexJYSClient Model
+// ===========================
+/**
+ * Mexico JYS Client Model.
+ *
+ * Provides typed accessors for gaming/lottery specific data.
+ *
+ * @example
+ * ```typescript
+ * if (client instanceof MexJYSClient) {
+ *   console.log(`JYS Client: ${client.name}`);
+ * }
+ * ```
+ */
+export class MexJYSClient extends MexActividadVulnerableClient {
+    // ─────────────────────────────────────────────────────────────────
+    // JYS-Specific Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * JYS-specific activity data
+     */
+    get jysData() {
+        return this.mexicoData?.actividadVulnerable?.JYS;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexJYSClient(${this.id}, ${this.name})`;
+    }
+    /**
+     * Linked clients (if included) instantiated as MexJYSClient
+     */
+    get linkedClients() {
+        return (this._data.linkedClients ?? []).map((l) => ({
+            relationshipType: l.relationshipType,
+            client: new MexJYSClient(l.client),
+        }));
+    }
+}
+/**
+ * Check if client is a JYS (Juegos y Sorteos) client
+ */
+export function isMexJYSClient(client) {
+    return client instanceof MexJYSClient;
+}

package/dist/models/mex/actividad-vulnerable/jys/MexJYSReport.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Mexico JYS Report Model
+ *
+ * Report model for Juegos y Sorteos (Games and Raffles) activity.
+ */
+import { MexActividadVulnerableReport, type MexActividadVulnerableReportData } from "../MexActividadVulnerableReport";
+import type { jys } from "@artu-ai/shared";
+/**
+ * JYS report data
+ */
+export interface MexJYSReportData extends MexActividadVulnerableReportData {
+    jurisdictions?: {
+        MX?: {
+            actividadVulnerable?: {
+                JYS?: jys.JYSReportData;
+            };
+        };
+        [key: string]: unknown;
+    };
+}
+/**
+ * Mexico JYS Report Model.
+ *
+ * Provides typed accessors for JYS-specific report data.
+ *
+ * @example
+ * ```typescript
+ * if (report instanceof MexJYSReport) {
+ *   console.log(`Period: ${report.mesReportado}`);
+ * }
+ * ```
+ */
+export declare class MexJYSReport extends MexActividadVulnerableReport {
+    /**
+     * JYS-specific report data
+     */
+    protected get jysData(): jys.JYSReportData | undefined;
+    /**
+     * Reporting period (YYYYMM format)
+     */
+    get mesReportado(): string | undefined;
+    /**
+     * Reporting period as a formatted string (e.g., "January 2024")
+     */
+    get formattedPeriod(): string | undefined;
+    toString(): string;
+}
+import type { ReportModel } from "../../../types";
+/**
+ * Check if report is a JYS (Juegos y Sorteos) report
+ */
+export declare function isMexJYSReport(report: ReportModel): report is MexJYSReport;
+//# sourceMappingURL=MexJYSReport.d.ts.map

package/dist/models/mex/actividad-vulnerable/jys/MexJYSReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MexJYSReport.d.ts","sourceRoot":"","sources":["../../../../../src/models/mex/actividad-vulnerable/jys/MexJYSReport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,4BAA4B,EAC5B,KAAK,gCAAgC,EACtC,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAM3C;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,gCAAgC;IACxE,aAAa,CAAC,EAAE;QACd,EAAE,CAAC,EAAE;YACH,mBAAmB,CAAC,EAAE;gBACpB,GAAG,CAAC,EAAE,GAAG,CAAC,aAAa,CAAC;aACzB,CAAC;SACH,CAAC;QACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAMD;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,4BAA4B;IAK5D;;OAEG;IACH,SAAS,KAAK,OAAO,IAAI,GAAG,CAAC,aAAa,GAAG,SAAS,CAErD;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAuBxC;IAMQ,QAAQ,IAAI,MAAM;CAG5B;AAMD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,IAAI,YAAY,CAE1E"}

package/dist/models/mex/actividad-vulnerable/jys/MexJYSReport.js

@@ -0,0 +1,75 @@
+/**
+ * Mexico JYS Report Model
+ *
+ * Report model for Juegos y Sorteos (Games and Raffles) activity.
+ */
+import { MexActividadVulnerableReport, } from "../MexActividadVulnerableReport";
+// ===========================
+// MexJYSReport Model
+// ===========================
+/**
+ * Mexico JYS Report Model.
+ *
+ * Provides typed accessors for JYS-specific report data.
+ *
+ * @example
+ * ```typescript
+ * if (report instanceof MexJYSReport) {
+ *   console.log(`Period: ${report.mesReportado}`);
+ * }
+ * ```
+ */
+export class MexJYSReport extends MexActividadVulnerableReport {
+    // ─────────────────────────────────────────────────────────────────
+    // JYS Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * JYS-specific report data
+     */
+    get jysData() {
+        return this.actividadVulnerableData?.JYS;
+    }
+    /**
+     * Reporting period (YYYYMM format)
+     */
+    get mesReportado() {
+        return this.jysData?.mesReportado;
+    }
+    /**
+     * 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 `MexJYSReport(${this.id}, ${this.mesReportado ?? "N/A"})`;
+    }
+}
+/**
+ * Check if report is a JYS (Juegos y Sorteos) report
+ */
+export function isMexJYSReport(report) {
+    return report instanceof MexJYSReport;
+}

package/dist/models/mex/actividad-vulnerable/jys/MexJYSReportItem.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Mexico JYS Report Item Model
+ *
+ * Report item model for Juegos y Sorteos (Games and Raffles) activity.
+ */
+import { MexActividadVulnerableReportItem, type MexActividadVulnerableReportItemData } from "../MexActividadVulnerableReportItem";
+import type { jys } from "@artu-ai/shared";
+/**
+ * JYS report item data
+ */
+export interface MexJYSReportItemData extends MexActividadVulnerableReportItemData {
+    jurisdictions?: {
+        MX?: {
+            actividadVulnerable?: {
+                JYS?: jys.JYSReportItemData;
+            };
+        };
+        [key: string]: unknown;
+    };
+}
+/**
+ * Mexico JYS Report Item Model.
+ *
+ * Provides typed accessors for JYS-specific report item data.
+ */
+export declare class MexJYSReportItem extends MexActividadVulnerableReportItem {
+    /**
+     * JYS-specific report item data
+     */
+    protected get jysData(): jys.JYSReportItemData | undefined;
+    /**
+     * Alert type code
+     * - "100" for monthly reports
+     * - Other codes for unusual activity
+     */
+    get alertType(): jys.TipoAlerta | undefined;
+    /**
+     * Alert description (for unusual activity)
+     */
+    get alertDescription(): string | undefined;
+    /**
+     * Amendment data for corrections
+     */
+    get amendment(): jys.Amendment | undefined;
+    /**
+     * Whether this item is an amendment
+     */
+    get isAmendment(): boolean;
+    toString(): string;
+}
+import type { ReportItemModel } from "../../../types";
+/**
+ * Check if report item is a JYS (Juegos y Sorteos) report item
+ */
+export declare function isMexJYSReportItem(item: ReportItemModel): item is MexJYSReportItem;
+//# sourceMappingURL=MexJYSReportItem.d.ts.map

package/dist/models/mex/actividad-vulnerable/jys/MexJYSReportItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MexJYSReportItem.d.ts","sourceRoot":"","sources":["../../../../../src/models/mex/actividad-vulnerable/jys/MexJYSReportItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,gCAAgC,EAChC,KAAK,oCAAoC,EAC1C,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAM3C;;GAEG;AACH,MAAM,WAAW,oBACf,SAAQ,oCAAoC;IAC5C,aAAa,CAAC,EAAE;QACd,EAAE,CAAC,EAAE;YACH,mBAAmB,CAAC,EAAE;gBACpB,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC;aAC7B,CAAC;SACH,CAAC;QACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAMD;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,gCAAgC;IAKpE;;OAEG;IACH,SAAS,KAAK,OAAO,IAAI,GAAG,CAAC,iBAAiB,GAAG,SAAS,CAEzD;IAED;;;;OAIG;IACH,IAAI,SAAS,IAAI,GAAG,CAAC,UAAU,GAAG,SAAS,CAE1C;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,GAAG,CAAC,SAAS,GAAG,SAAS,CAEzC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAMQ,QAAQ,IAAI,MAAM;CAG5B;AAMD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,eAAe,GACpB,IAAI,IAAI,gBAAgB,CAE1B"}

package/dist/models/mex/actividad-vulnerable/jys/MexJYSReportItem.js

@@ -0,0 +1,63 @@
+/**
+ * Mexico JYS Report Item Model
+ *
+ * Report item model for Juegos y Sorteos (Games and Raffles) activity.
+ */
+import { MexActividadVulnerableReportItem, } from "../MexActividadVulnerableReportItem";
+// ===========================
+// MexJYSReportItem Model
+// ===========================
+/**
+ * Mexico JYS Report Item Model.
+ *
+ * Provides typed accessors for JYS-specific report item data.
+ */
+export class MexJYSReportItem extends MexActividadVulnerableReportItem {
+    // ─────────────────────────────────────────────────────────────────
+    // JYS Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * JYS-specific report item data
+     */
+    get jysData() {
+        return this.actividadVulnerableData?.JYS;
+    }
+    /**
+     * Alert type code
+     * - "100" for monthly reports
+     * - Other codes for unusual activity
+     */
+    get alertType() {
+        return this.jysData?.alertType;
+    }
+    /**
+     * Alert description (for unusual activity)
+     */
+    get alertDescription() {
+        return this.jysData?.alertDescription;
+    }
+    /**
+     * Amendment data for corrections
+     */
+    get amendment() {
+        return this.jysData?.amendment;
+    }
+    /**
+     * Whether this item is an amendment
+     */
+    get isAmendment() {
+        return !!this.jysData?.amendment;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexJYSReportItem(${this.id}, ${this.clientName ?? "Unknown"}, Alert: ${this.alertType ?? "N/A"})`;
+    }
+}
+/**
+ * Check if report item is a JYS (Juegos y Sorteos) report item
+ */
+export function isMexJYSReportItem(item) {
+    return item instanceof MexJYSReportItem;
+}

package/dist/models/mex/actividad-vulnerable/jys/MexJYSTransaction.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Mexico JYS (Juegos y Sorteos) Transaction
+ *
+ * Specialized for gaming and lottery transactions.
+ */
+import { jys } from "@artu-ai/shared";
+import { MexActividadVulnerableTransaction } from "../MexActividadVulnerableTransaction";
+/**
+ * Mexico JYS Transaction Model.
+ *
+ * Provides typed accessors for gaming/lottery transaction data.
+ *
+ * @example
+ * ```typescript
+ * if (txn instanceof MexJYSTransaction) {
+ *   console.log(`Operation: ${txn.operationType}`);
+ *   console.log(`Settlement: ${txn.settlementType}`);
+ * }
+ * ```
+ */
+export declare class MexJYSTransaction extends MexActividadVulnerableTransaction {
+    /**
+     * JYS-specific transaction data
+     */
+    protected get jysData(): jys.JYSTransactionData | undefined;
+    /**
+     * Operation type (e.g., bet, prize, purchase)
+     */
+    get operationType(): string | undefined;
+    /**
+     * Business line (e.g., casino, lottery, sports betting)
+     */
+    get businessLine(): string | undefined;
+    /**
+     * Operation method (e.g., in-individual, online)
+     */
+    get operationMethod(): string | undefined;
+    /**
+     * Branch information where the transaction occurred
+     */
+    get branchInfo(): jys.BranchInformation | undefined;
+    /**
+     * Branch postal code
+     */
+    get branchPostalCode(): string | undefined;
+    /**
+     * Whether this is an operator branch (vs own branch)
+     */
+    get isOperatorBranch(): boolean;
+    /**
+     * Operator name (if operator branch)
+     */
+    get operatorName(): string | undefined;
+    /**
+     * Settlement type (cash or in-kind)
+     */
+    get settlementType(): jys.TipoLiquidacion | undefined;
+    /**
+     * Whether this is a cash settlement
+     */
+    get isCashSettlement(): boolean;
+    /**
+     * Whether this is an in-kind settlement (assets)
+     */
+    get isInKindSettlement(): boolean;
+    /**
+     * Monetary instrument (for cash settlements)
+     */
+    get monetaryInstrument(): string | undefined;
+    /**
+     * Asset type (for in-kind settlements)
+     */
+    get assetType(): string | undefined;
+    /**
+     * Real estate type (for real estate in-kind settlements)
+     */
+    get realEstateType(): string | undefined;
+    toString(): string;
+}
+import type { TransactionModel } from "../../../types";
+/**
+ * Check if transaction is a JYS (Juegos y Sorteos) transaction
+ */
+export declare function isMexJYSTransaction(txn: TransactionModel): txn is MexJYSTransaction;
+//# sourceMappingURL=MexJYSTransaction.d.ts.map

package/dist/models/mex/actividad-vulnerable/jys/MexJYSTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MexJYSTransaction.d.ts","sourceRoot":"","sources":["../../../../../src/models/mex/actividad-vulnerable/jys/MexJYSTransaction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,iCAAiC,EAAE,MAAM,sCAAsC,CAAC;AAMzF;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,SAAQ,iCAAiC;IAKtE;;OAEG;IACH,SAAS,KAAK,OAAO,IAAI,GAAG,CAAC,kBAAkB,GAAG,SAAS,CAE1D;IAMD;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAExC;IAMD;;OAEG;IACH,IAAI,UAAU,IAAI,GAAG,CAAC,iBAAiB,GAAG,SAAS,CAIlD;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAMrC;IAMD;;OAEG;IACH,IAAI,cAAc,IAAI,GAAG,CAAC,eAAe,GAAG,SAAS,CAIpD;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAI3C;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAIlC;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAIvC;IAMQ,QAAQ,IAAI,MAAM;CAG5B;AAMD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,GACpB,GAAG,IAAI,iBAAiB,CAE1B"}

package/dist/models/mex/actividad-vulnerable/jys/MexJYSTransaction.js

@@ -0,0 +1,152 @@
+/**
+ * Mexico JYS (Juegos y Sorteos) Transaction
+ *
+ * Specialized for gaming and lottery transactions.
+ */
+import { jys } from "@artu-ai/shared";
+import { MexActividadVulnerableTransaction } from "../MexActividadVulnerableTransaction";
+// ===========================
+// MexJYSTransaction Model
+// ===========================
+/**
+ * Mexico JYS Transaction Model.
+ *
+ * Provides typed accessors for gaming/lottery transaction data.
+ *
+ * @example
+ * ```typescript
+ * if (txn instanceof MexJYSTransaction) {
+ *   console.log(`Operation: ${txn.operationType}`);
+ *   console.log(`Settlement: ${txn.settlementType}`);
+ * }
+ * ```
+ */
+export class MexJYSTransaction extends MexActividadVulnerableTransaction {
+    // ─────────────────────────────────────────────────────────────────
+    // JYS-Specific Data
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * JYS-specific transaction data
+     */
+    get jysData() {
+        return this.mexicoData?.actividadVulnerable?.JYS;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Operation Fields
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Operation type (e.g., bet, prize, purchase)
+     */
+    get operationType() {
+        return this.jysData?.operationType;
+    }
+    /**
+     * Business line (e.g., casino, lottery, sports betting)
+     */
+    get businessLine() {
+        return this.jysData?.businessLine;
+    }
+    /**
+     * Operation method (e.g., in-individual, online)
+     */
+    get operationMethod() {
+        return this.jysData?.operationMethod;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Branch Information
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Branch information where the transaction occurred
+     */
+    get branchInfo() {
+        const data = this.jysData;
+        if (!data)
+            return undefined;
+        return data.branchInformation;
+    }
+    /**
+     * Branch postal code
+     */
+    get branchPostalCode() {
+        return this.branchInfo?.postalCode;
+    }
+    /**
+     * Whether this is an operator branch (vs own branch)
+     */
+    get isOperatorBranch() {
+        return this.branchInfo?.type === jys.TipoSucursal.Operator;
+    }
+    /**
+     * Operator name (if operator branch)
+     */
+    get operatorName() {
+        const info = this.branchInfo;
+        if (info?.type === jys.TipoSucursal.Operator) {
+            return info.operatorName;
+        }
+        return undefined;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Settlement Information
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Settlement type (cash or in-kind)
+     */
+    get settlementType() {
+        const data = this.jysData;
+        if (!data || !("settlementType" in data))
+            return undefined;
+        return data.settlementType;
+    }
+    /**
+     * Whether this is a cash settlement
+     */
+    get isCashSettlement() {
+        return this.settlementType === jys.TipoLiquidacion.Cash;
+    }
+    /**
+     * Whether this is an in-kind settlement (assets)
+     */
+    get isInKindSettlement() {
+        return this.settlementType === jys.TipoLiquidacion.InKind;
+    }
+    /**
+     * Monetary instrument (for cash settlements)
+     */
+    get monetaryInstrument() {
+        const data = this.jysData;
+        if (!data || !("monetaryInstrument" in data))
+            return undefined;
+        return data.monetaryInstrument;
+    }
+    /**
+     * Asset type (for in-kind settlements)
+     */
+    get assetType() {
+        const data = this.jysData;
+        if (!data || !("assetType" in data))
+            return undefined;
+        return data.assetType;
+    }
+    /**
+     * Real estate type (for real estate in-kind settlements)
+     */
+    get realEstateType() {
+        const data = this.jysData;
+        if (!data || !("realEstateType" in data))
+            return undefined;
+        return data.realEstateType;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `MexJYSTransaction(${this.id}, ${this.formattedAmount}, ${this.operationType ?? "unknown"})`;
+    }
+}
+/**
+ * Check if transaction is a JYS (Juegos y Sorteos) transaction
+ */
+export function isMexJYSTransaction(txn) {
+    return txn instanceof MexJYSTransaction;
+}

package/dist/models/mex/actividad-vulnerable/tsc/MexTSCClient.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Mexico TSC (Tarjetas de Servicio y Crédito) Client
+ *
+ * Specialized for service and credit card operations.
+ */
+import type { ClientRelationshipType, tsc } from "@artu-ai/shared";
+import { MexActividadVulnerableClient } from "../MexActividadVulnerableClient";
+/**
+ * Mexico TSC Client Model.
+ *
+ * Provides typed accessors for service/credit card specific data.
+ *
+ * @example
+ * ```typescript
+ * if (client instanceof MexTSCClient) {
+ *   console.log(`TSC Client: ${client.name}`);
+ * }
+ * ```
+ */
+export declare class MexTSCClient extends MexActividadVulnerableClient {
+    /**
+     * TSC-specific activity data
+     */
+    protected get tscData(): tsc.TSCClientData | undefined;
+    toString(): string;
+    /**
+     * Linked clients (if included) instantiated as MexTSCClient
+     */
+    get linkedClients(): {
+        relationshipType: ClientRelationshipType;
+        client: MexTSCClient;
+    }[] | undefined;
+}
+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/mex/actividad-vulnerable/tsc/MexTSCClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MexTSCClient.d.ts","sourceRoot":"","sources":["../../../../../src/models/mex/actividad-vulnerable/tsc/MexTSCClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAM/E;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,4BAA4B;IAK5D;;OAEG;IACH,SAAS,KAAK,OAAO,IAAI,GAAG,CAAC,aAAa,GAAG,SAAS,CAErD;IAMQ,QAAQ,IAAI,MAAM;IAI3B;;OAEG;IACH,IAAa,aAAa,IACtB;QACE,gBAAgB,EAAE,sBAAsB,CAAC;QACzC,MAAM,EAAE,YAAY,CAAC;KACtB,EAAE,GACH,SAAS,CAKZ;CACF;AAMD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,IAAI,YAAY,CAE1E"}