@artu-ai/compliance-sdk 0.0.5 → 0.2.0

package/dist/resources/mex/actividad-vulnerable/jys/reports.js

@@ -0,0 +1,309 @@
+/**
+ * JYS (Juegos y Sorteos) Reports Resource
+ *
+ * Extends MexReportsResource with JYS-specific behavior:
+ * - Accepts flattened CreateJYSReportInput (JYS fields at root level)
+ * - Returns MexJYSReport models
+ */
+import { z } from "zod";
+import { CodigoActividad, createJYSReportInputSchema, updateJYSReportInputSchema, createJYSReportItemInputSchema, updateJYSReportItemInputSchema, mexJysValidateInputSchema, submitJYSSubmissionInputSchema, } from "@artu-ai/shared";
+import { MexReportsResource } from "../../reports";
+import { MexJYSReport, MexJYSReportItem, } from "../../../../models";
+// ===========================
+// JYSReportsResource
+// ===========================
+/**
+ * JYS (Juegos y Sorteos) scoped reports resource.
+ *
+ * @example
+ * ```typescript
+ * const jysSdk = new ComplianceSDK({
+ *   apiKey,
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.JYS,
+ * });
+ *
+ * // Create with fully flattened input
+ * const report = await jysSdk.reports.create({
+ *   mesReportado: "202401",
+ * });
+ *
+ * // Returns MexJYSReport
+ * console.log(report.mesReportado);
+ * ```
+ */
+export class JYSReportsResource extends MexReportsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // Report CRUD
+    // ─────────────────────────────────────────────────────────────────
+    async create(data) {
+        const validated = this.validate(createJYSReportInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.reports.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.reports.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.reports.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    async update(id, data) {
+        const validated = this.validate(updateJYSReportInputSchema, data);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists JYS reports with optional filtering.
+     *
+     * Accepts flattened JYS filter (future JYS-specific report fields at root level).
+     */
+    async list(options) {
+        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        const response = await this.execute(() => this.trpc.reports.list.query({
+            ...options,
+            filter: scopedFilter,
+        }));
+        return {
+            data: response.data.map((r) => this.instantiate(r)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Iterates over JYS reports.
+     *
+     * Accepts flattened JYS filter (future JYS-specific report fields at root level).
+     */
+    iterate(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        return this.createIterator({ filter: scopedFilter });
+    }
+    async createMany(reports, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createJYSReportInputSchema), reports);
+        const nestedItems = validated.map((r) => this.transformToNested(r));
+        const response = await this.execute(() => this.trpc.reports.createMany.mutate({ items: nestedItems, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((r) => this.instantiate(r)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    async updateMany(updates, options = {}) {
+        const atomic = options.atomic ?? true;
+        const updateItemSchema = z.object({
+            id: z.uuid(),
+            data: updateJYSReportInputSchema,
+        });
+        const validated = this.validate(z.array(updateItemSchema), updates);
+        const nestedUpdates = validated.map((u) => ({
+            id: u.id,
+            data: this.transformUpdateToNested(u.data),
+        }));
+        const response = await this.execute(() => this.trpc.reports.updateMany.mutate({ items: nestedUpdates, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((r) => this.instantiate(r)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Report Items
+    // ─────────────────────────────────────────────────────────────────
+    async addItem(reportId, data) {
+        const validated = this.validate(createJYSReportItemInputSchema, data);
+        const nestedData = this.transformItemToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.addItem.mutate({ reportId, data: nestedData }));
+        return this.instantiateItem(response);
+    }
+    async getItem(reportId, itemId) {
+        const response = await this.execute(() => this.trpc.reports.getItem.query({ reportId, itemId }));
+        return this.instantiateItem(response);
+    }
+    async updateItem(reportId, itemId, data) {
+        const validated = this.validate(updateJYSReportItemInputSchema, data);
+        const nestedData = this.transformItemUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.updateItem.mutate({
+            reportId,
+            itemId,
+            data: nestedData,
+        }));
+        return this.instantiateItem(response);
+    }
+    async listItems(reportId, options) {
+        const response = await this.execute(() => this.trpc.reports.listItems.query({
+            reportId,
+            ...options,
+        }));
+        return {
+            data: response.data.map((i) => this.instantiateItem(i)),
+            pagination: response.pagination,
+        };
+    }
+    async addItems(reportId, items) {
+        const validated = this.validate(z.array(createJYSReportItemInputSchema), items);
+        const nestedItems = validated.map((i) => this.transformItemToNested(i));
+        const response = await this.execute(() => this.trpc.reports.addItems.mutate({ reportId, items: nestedItems }));
+        return {
+            added: response.added,
+            items: response.items.map((i) => this.instantiateItem(i)),
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Validation
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Validates a JYS report.
+     *
+     * Uses JYS-scoped validation input (jurisdiction and activity are implicit).
+     *
+     * @example
+     * ```typescript
+     * const result = await jysSdk.reports.validateReport({
+     *   reportId: report.id,
+     *   defaults: { rfc: "ABC200101XXX" },
+     * });
+     * ```
+     */
+    async validateReport(input) {
+        const validated = this.validate(mexJysValidateInputSchema, input);
+        return this.execute(() => this.trpc.reports.validate.mutate(validated));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Generation
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Generates XML for a JYS report.
+     *
+     * Uses the same input as validateReport.
+     */
+    async generateReport(input) {
+        const validated = this.validate(mexJysValidateInputSchema, input);
+        return this.execute(() => this.trpc.reports.generate.mutate(validated));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Submission
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Submits a validated JYS report.
+     *
+     * Uses JYS-scoped submission input (activity is implicit).
+     */
+    async submit(input) {
+        const validated = this.validate(submitJYSSubmissionInputSchema, input);
+        const jurisdictions = {
+            MX: {
+                actividadVulnerable: {
+                    [CodigoActividad.JYS]: {
+                        acuseRecibo: validated.acuseRecibo,
+                        notes: validated.notes,
+                    },
+                },
+            },
+        };
+        return this.execute(() => this.trpc.reports.submit.mutate({
+            reportId: validated.reportId,
+            jurisdictions,
+        }));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    transformToNested(data) {
+        const { mesReportado, ...baseFields } = data;
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.JYS]: { mesReportado },
+                    },
+                },
+            },
+        };
+    }
+    transformUpdateToNested(data) {
+        return data;
+    }
+    instantiate(data) {
+        return new MexJYSReport(data);
+    }
+    instantiateItem(data) {
+        return new MexJYSReportItem(data);
+    }
+    transformItemToNested(data) {
+        const { alertType, alertDescription, amendment, ...baseFields } = data;
+        const jysData = {};
+        if (alertType !== undefined)
+            jysData.alertType = alertType;
+        if (alertDescription !== undefined)
+            jysData.alertDescription = alertDescription;
+        if (amendment !== undefined)
+            jysData.amendment = amendment;
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.JYS]: jysData,
+                    },
+                },
+            },
+        };
+    }
+    transformItemUpdateToNested(data) {
+        const { alertType, alertDescription, amendment, ...baseFields } = data;
+        const jysData = {};
+        if (alertType !== undefined)
+            jysData.alertType = alertType;
+        if (alertDescription !== undefined)
+            jysData.alertDescription = alertDescription;
+        if (amendment !== undefined)
+            jysData.amendment = amendment;
+        if (Object.keys(jysData).length === 0) {
+            return baseFields;
+        }
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.JYS]: jysData,
+                    },
+                },
+            },
+        };
+    }
+}

package/dist/resources/mex/actividad-vulnerable/jys/transactions.d.ts

@@ -0,0 +1,86 @@
+/**
+ * JYS (Juegos y Sorteos) Transactions Resource
+ *
+ * Extends MexTransactionsResource with JYS-specific behavior:
+ * - Accepts flattened CreateJYSTransactionInput (JYS fields at root level)
+ * - Returns MexJYSTransaction models
+ */
+import type { CreateTransactionInput, UpdateTransactionInput, ListOptions, PaginatedResponse, CreateJYSTransactionInput, UpdateJYSTransactionInput, AtomicBatchResult, PartialBatchResult, RelatedClient, JYSTransactionFilter } from "@artu-ai/shared";
+import { ClientRole } from "@artu-ai/shared";
+import { MexTransactionsResource } from "../../transactions";
+import { MexJYSTransaction, type TransactionData } from "../../../../models";
+/**
+ * JYS (Juegos y Sorteos) scoped transactions resource.
+ *
+ * @example
+ * ```typescript
+ * const jysSdk = new ComplianceSDK({
+ *   apiKey,
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.JYS,
+ * });
+ *
+ * // Create with fully flattened input
+ * const txn = await jysSdk.transactions.create({
+ *   amount: 100000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   branchInformation: { type: "own", postalCode: "06600" },
+ *   operationType: "bet",
+ *   businessLine: "casino",
+ *   operationMethod: "inPerson",
+ *   settlementType: "cash",
+ *   monetaryInstrument: "cash",
+ * });
+ *
+ * // Returns MexJYSTransaction
+ * console.log(txn.settlementType);
+ * ```
+ */
+export declare class JYSTransactionsResource extends MexTransactionsResource {
+    create(data: CreateJYSTransactionInput): Promise<MexJYSTransaction>;
+    retrieve(id: string): Promise<MexJYSTransaction>;
+    retrieveByMetadata(key: string, value: string): Promise<MexJYSTransaction>;
+    update(id: string, data: UpdateJYSTransactionInput): Promise<MexJYSTransaction>;
+    /**
+     * Lists JYS transactions with optional filtering.
+     *
+     * Accepts flattened JYS filter (future JYS-specific transaction fields at root level).
+     */
+    list(options?: ListOptions<JYSTransactionFilter>): Promise<PaginatedResponse<MexJYSTransaction>>;
+    /**
+     * Iterates over JYS transactions.
+     *
+     * Accepts flattened JYS filter (future JYS-specific transaction fields at root level).
+     */
+    iterate(filter?: JYSTransactionFilter): AsyncGenerator<MexJYSTransaction, void, undefined>;
+    listByClient(clientId: string, options?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<PaginatedResponse<MexJYSTransaction>>;
+    linkClient(transactionId: string, clientId: string, role?: ClientRole): Promise<MexJYSTransaction>;
+    unlinkClient(transactionId: string, clientId: string): Promise<MexJYSTransaction>;
+    setClients(transactionId: string, clients: RelatedClient[]): Promise<MexJYSTransaction>;
+    createMany(transactions: CreateJYSTransactionInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexJYSTransaction>>;
+    createMany(transactions: CreateJYSTransactionInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexJYSTransaction>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateJYSTransactionInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexJYSTransaction>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateJYSTransactionInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexJYSTransaction>>;
+    protected transformToNested(data: CreateJYSTransactionInput): CreateTransactionInput;
+    protected transformUpdateToNested(data: UpdateJYSTransactionInput): UpdateTransactionInput;
+    protected instantiate(data: TransactionData): MexJYSTransaction;
+}
+//# sourceMappingURL=transactions.d.ts.map

package/dist/resources/mex/actividad-vulnerable/jys/transactions.d.ts.map

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

package/dist/resources/mex/actividad-vulnerable/jys/transactions.js

@@ -0,0 +1,240 @@
+/**
+ * JYS (Juegos y Sorteos) Transactions Resource
+ *
+ * Extends MexTransactionsResource with JYS-specific behavior:
+ * - Accepts flattened CreateJYSTransactionInput (JYS fields at root level)
+ * - Returns MexJYSTransaction models
+ */
+import { z } from "zod";
+import { Jurisdiction, CodigoActividad, createJYSTransactionInputSchema, updateJYSTransactionInputSchema, } from "@artu-ai/shared";
+import { MexTransactionsResource } from "../../transactions";
+import { MexJYSTransaction } from "../../../../models";
+// ===========================
+// JYSTransactionsResource
+// ===========================
+/**
+ * JYS (Juegos y Sorteos) scoped transactions resource.
+ *
+ * @example
+ * ```typescript
+ * const jysSdk = new ComplianceSDK({
+ *   apiKey,
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.JYS,
+ * });
+ *
+ * // Create with fully flattened input
+ * const txn = await jysSdk.transactions.create({
+ *   amount: 100000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   branchInformation: { type: "own", postalCode: "06600" },
+ *   operationType: "bet",
+ *   businessLine: "casino",
+ *   operationMethod: "inPerson",
+ *   settlementType: "cash",
+ *   monetaryInstrument: "cash",
+ * });
+ *
+ * // Returns MexJYSTransaction
+ * console.log(txn.settlementType);
+ * ```
+ */
+export class JYSTransactionsResource extends MexTransactionsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations
+    // ─────────────────────────────────────────────────────────────────
+    async create(data) {
+        const validated = this.validate(createJYSTransactionInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.transactions.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    async update(id, data) {
+        const validated = this.validate(updateJYSTransactionInputSchema, data);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists JYS transactions with optional filtering.
+     *
+     * Accepts flattened JYS filter (future JYS-specific transaction fields at root level).
+     */
+    async list(options) {
+        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        const response = await this.execute(() => this.trpc.transactions.list.query({
+            ...options,
+            filter: scopedFilter,
+        }));
+        return {
+            data: response.data.map((t) => this.instantiate(t)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Iterates over JYS transactions.
+     *
+     * Accepts flattened JYS filter (future JYS-specific transaction fields at root level).
+     */
+    iterate(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        return this.createIterator({ filter: scopedFilter });
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Client Relationship Management (scoped returns)
+    // ─────────────────────────────────────────────────────────────────
+    async listByClient(clientId, options) {
+        const response = await this.execute(() => this.trpc.transactions.listByClient.query({ clientId, ...options }));
+        return {
+            data: response.data.map((t) => this.instantiate(t)),
+            pagination: response.pagination,
+        };
+    }
+    async linkClient(transactionId, clientId, role) {
+        const response = await this.execute(() => this.trpc.transactions.linkClient.mutate({
+            transactionId,
+            clientId,
+            role,
+        }));
+        return this.instantiate(response);
+    }
+    async unlinkClient(transactionId, clientId) {
+        const response = await this.execute(() => this.trpc.transactions.unlinkClient.mutate({
+            transactionId,
+            clientId,
+        }));
+        return this.instantiate(response);
+    }
+    async setClients(transactionId, clients) {
+        const response = await this.execute(() => this.trpc.transactions.setClients.mutate({
+            transactionId,
+            clients,
+        }));
+        return this.instantiate(response);
+    }
+    async createMany(transactions, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createJYSTransactionInputSchema), transactions);
+        const nestedItems = validated.map((t) => this.transformToNested(t));
+        const response = await this.execute(() => this.trpc.transactions.createMany.mutate({ items: nestedItems, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((t) => this.instantiate(t)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    async updateMany(updates, options = {}) {
+        const atomic = options.atomic ?? true;
+        const updateItemSchema = z.object({
+            id: z.uuid(),
+            data: updateJYSTransactionInputSchema,
+        });
+        const validated = this.validate(z.array(updateItemSchema), updates);
+        const nestedUpdates = validated.map((u) => ({
+            id: u.id,
+            data: this.transformUpdateToNested(u.data),
+        }));
+        const response = await this.execute(() => this.trpc.transactions.updateMany.mutate({ items: nestedUpdates, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((t) => this.instantiate(t)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    transformToNested(data) {
+        const { amount, currency, timestamp, relatedClientIds, description, externalId, metadata, ...jysFields } = data;
+        // Build base fields (relatedClientIds is required)
+        const baseFields = {
+            amount,
+            currency,
+            timestamp,
+            relatedClientIds,
+        };
+        if (description !== undefined)
+            baseFields.description = description;
+        if (externalId !== undefined)
+            baseFields.externalId = externalId;
+        if (metadata !== undefined)
+            baseFields.metadata = metadata;
+        return {
+            ...baseFields,
+            primaryJurisdiction: Jurisdiction.Mexico,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.JYS]: jysFields,
+                    },
+                },
+            },
+        };
+    }
+    transformUpdateToNested(data) {
+        // Cast to access fields - Zod validation ensures correctness
+        const input = data;
+        const { status, description, externalId, metadata, primaryJurisdiction, ...jysFields } = input;
+        // Build base update fields
+        const result = {};
+        if (status !== undefined)
+            result.status = status;
+        if (description !== undefined)
+            result.description = description;
+        if (externalId !== undefined)
+            result.externalId = externalId;
+        if (metadata !== undefined)
+            result.metadata = metadata;
+        if (primaryJurisdiction !== undefined)
+            result.primaryJurisdiction = primaryJurisdiction;
+        // If JYS fields are present (all-or-nothing), nest them in jurisdictions
+        // Check for branchInformation as the indicator that JYS data is being updated
+        if (jysFields.branchInformation !== undefined) {
+            result.jurisdictions = {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.JYS]: jysFields,
+                    },
+                },
+            };
+        }
+        return result;
+    }
+    instantiate(data) {
+        return new MexJYSTransaction(data);
+    }
+}