@artu-ai/compliance-sdk 0.13.2 → 0.13.4

package/dist/resources/mx/cnbv/transactions.js

@@ -0,0 +1,217 @@
+/**
+ * CNBV Transactions Resource
+ *
+ * Extends MexTransactionsResource with CNBV-specific behavior:
+ * - Sets scopes to ["MX", "MX:CNBV"]
+ * - Nests data under jurisdictions.MX.cnbv
+ * - Returns MexCNBVTransaction models
+ *
+ * This is a passthrough to MX level (no CNBV-specific transaction fields).
+ */
+import { createMexTransactionInputSchema, mexTransactionSortingFieldMapping, transformSort, updateMexTransactionInputSchema, upsertMexTransactionInputSchema, } from "@artu-ai/shared";
+import { z } from "zod";
+import { MexCNBVTransaction } from "../../../models";
+import { MexTransactionsResource } from "../transactions";
+// ===========================
+// CNBVTransactionsResource
+// ===========================
+export class CNBVTransactionsResource extends MexTransactionsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations
+    // ─────────────────────────────────────────────────────────────────
+    static SCOPE_PATH = ["MX", "cnbv"];
+    async create(data) {
+        const merged = await this.mergeProductDataFlat(data, CNBVTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(createMexTransactionInputSchema, merged);
+        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 merged = await this.mergeProductDataFlat(data, CNBVTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(updateMexTransactionInputSchema, merged);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    async list(options) {
+        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        const scopedSort = this.applyScopeToSort(options?.sort);
+        const response = await this.execute(() => this.trpc.transactions.list.query({
+            ...options,
+            filter: scopedFilter,
+            sort: scopedSort,
+        }));
+        return {
+            data: response.data.map((t) => this.instantiate(t)),
+            pagination: response.pagination,
+        };
+    }
+    iterate(options) {
+        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        return this.createIterator({
+            filter: scopedFilter,
+            sort: options?.sort,
+            pageSize: options?.pageSize,
+        });
+    }
+    async count(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        const response = await this.execute(() => this.trpc.transactions.count.query({ filter: scopedFilter }));
+        return response.count;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Client Relationships
+    // ─────────────────────────────────────────────────────────────────
+    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 merged = await this.mergeProductDataFlatBatch(transactions, CNBVTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(z.array(createMexTransactionInputSchema), merged);
+        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: updateMexTransactionInputSchema,
+        });
+        const mergedData = await this.mergeProductDataFlatBatch(updates.map((u) => u.data), CNBVTransactionsResource.SCOPE_PATH);
+        const mergedUpdates = updates.map((u, i) => ({
+            id: u.id,
+            data: mergedData[i],
+        }));
+        const validated = this.validate(z.array(updateItemSchema), mergedUpdates);
+        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,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Upsert Operations
+    // ─────────────────────────────────────────────────────────────────
+    async upsertByExternalId(data) {
+        const merged = await this.mergeProductDataFlat(data, CNBVTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(upsertMexTransactionInputSchema, merged);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.upsertByExternalId.mutate(nestedData));
+        return {
+            data: this.instantiate(response.data),
+            action: response.action,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    applyScopeToSort(sort) {
+        if (!sort || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, mexTransactionSortingFieldMapping);
+    }
+    transformToNested(data) {
+        const nested = super.transformToNested(data);
+        const jurisdictions = nested.jurisdictions;
+        const mexData = jurisdictions?.MX ?? {};
+        return {
+            ...nested,
+            scopes: ["MX", "MX:CNBV"],
+            jurisdictions: {
+                MX: {
+                    ...mexData,
+                    cnbv: {},
+                },
+            },
+        };
+    }
+    transformUpdateToNested(data) {
+        const nested = super.transformUpdateToNested(data);
+        const result = nested;
+        result.scopes = ["MX", "MX:CNBV"];
+        const jurisdictions = result.jurisdictions ?? {};
+        const mx = jurisdictions.MX ?? {};
+        mx.cnbv = mx.cnbv ?? {};
+        jurisdictions.MX = mx;
+        result.jurisdictions = jurisdictions;
+        return nested;
+    }
+    instantiate(data) {
+        return new MexCNBVTransaction(data);
+    }
+}