@artu-ai/compliance-sdk 0.0.6 → 0.3.0

package/dist/resources/reports.js

@@ -0,0 +1,308 @@
+/**
+ * Reports Resource
+ *
+ * CRUD operations, report items management, validation, and generation.
+ *
+ * This is the base (unscoped) resource. For jurisdiction-scoped SDKs, use:
+ * - MexReportsResource - Mexico-scoped with flattened MX fields
+ * - AVIReportsResource - Mexico AVI-scoped with flattened AVI fields
+ * - JYSReportsResource - Mexico JYS-scoped with flattened JYS fields
+ * - TSCReportsResource - Mexico TSC-scoped with flattened TSC fields
+ */
+import { z } from "zod";
+import { createReportInputSchema, updateReportInputSchema, updateReportStatusInputSchema, createReportItemInputSchema, updateReportItemInputSchema, reportDefaultsInputSchema, submitReportInputSchema, } from "@artu-ai/shared";
+import { BaseResource } from "./base";
+import { Report, ReportItem, } from "../models";
+// ===========================
+// ReportsResource
+// ===========================
+/**
+ * Base resource manager for report operations.
+ *
+ * Provides:
+ * - CRUD operations (create, retrieve, update, delete)
+ * - Report items management (add, update, remove items)
+ * - Validation and generation
+ *
+ * @example
+ * ```typescript
+ * // Create a report with full nested format
+ * const report = await sdk.reports.create({
+ *   jurisdictions: {
+ *     MX: {
+ *       actividadVulnerable: {
+ *         AVI: { mesReportado: "202401" }
+ *       }
+ *     }
+ *   }
+ * });
+ *
+ * // Add items to the report
+ * await sdk.reports.addItem(report.id, {
+ *   transactionId: "txn_123",
+ * });
+ *
+ * // Validate the report
+ * const result = await sdk.reports.validate(report.id);
+ * if (result.valid) {
+ *   // Generate XML
+ *   const xml = await sdk.reports.generate(report.id);
+ * }
+ * ```
+ */
+export class ReportsResource extends BaseResource {
+    // ─────────────────────────────────────────────────────────────────
+    // Report CRUD
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Creates a new report.
+     *
+     * @param data - Report creation data in nested format
+     * @returns The created report model
+     */
+    async create(data) {
+        const validated = this.validate(createReportInputSchema, data);
+        const response = await this.execute(() => this.trpc.reports.create.mutate(validated));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a report by ID.
+     */
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.reports.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a report by metadata key/value.
+     */
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.reports.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a report by externalId.
+     */
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.reports.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    /**
+     * Updates a report.
+     */
+    async update(id, data) {
+        const validated = this.validate(updateReportInputSchema, data);
+        const response = await this.execute(() => this.trpc.reports.update.mutate({ id, data: validated }));
+        return this.instantiate(response);
+    }
+    /**
+     * Updates a report's status.
+     *
+     * Restrictions:
+     * - Can only manually set to: Draft
+     * - Cannot change from: Accepted (terminal), Submitted (awaiting response)
+     *
+     * Use this to reset a report back to Draft status for re-editing.
+     */
+    async updateStatus(id, data) {
+        const validated = this.validate(updateReportStatusInputSchema, data);
+        const response = await this.execute(() => this.trpc.reports.updateStatus.mutate({ id, data: validated }));
+        return this.instantiate(response);
+    }
+    /**
+     * Deletes a report.
+     */
+    async delete(id) {
+        await this.execute(() => this.trpc.reports.delete.mutate({ id }));
+    }
+    /**
+     * Lists reports with optional filtering and pagination.
+     */
+    async list(options) {
+        const response = await this.execute(() => this.trpc.reports.list.query(options));
+        return {
+            data: response.data.map((r) => this.instantiate(r)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Returns an async iterator over all reports matching the filter.
+     */
+    iterate(filter) {
+        return this.createIterator({ filter });
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Report Items
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Adds an item to a report.
+     */
+    async addItem(reportId, data) {
+        const validated = this.validate(createReportItemInputSchema, data);
+        const response = await this.execute(() => this.trpc.reports.addItem.mutate({ reportId, data: validated }));
+        return this.instantiateItem(response);
+    }
+    /**
+     * Gets a specific report item.
+     */
+    async getItem(reportId, itemId) {
+        const response = await this.execute(() => this.trpc.reports.getItem.query({ reportId, itemId }));
+        return this.instantiateItem(response);
+    }
+    /**
+     * Updates a report item.
+     */
+    async updateItem(reportId, itemId, data) {
+        const validated = this.validate(updateReportItemInputSchema, data);
+        const response = await this.execute(() => this.trpc.reports.updateItem.mutate({ reportId, itemId, data: validated }));
+        return this.instantiateItem(response);
+    }
+    /**
+     * Removes an item from a report.
+     */
+    async removeItem(reportId, itemId) {
+        await this.execute(() => this.trpc.reports.removeItem.mutate({ reportId, itemId }));
+    }
+    /**
+     * Lists items in a report with filtering, sorting, and pagination.
+     */
+    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,
+        };
+    }
+    /**
+     * Adds multiple items to a report.
+     * Validates all items upfront - fails fast if any item is invalid.
+     */
+    async addItems(reportId, items) {
+        const validated = this.validate(z.array(createReportItemInputSchema), items);
+        const response = await this.execute(() => this.trpc.reports.addItems.mutate({ reportId, items: validated }));
+        return {
+            added: response.added,
+            items: response.items.map((i) => this.instantiateItem(i)),
+        };
+    }
+    /**
+     * Removes multiple items from a report.
+     */
+    async removeItems(reportId, itemIds) {
+        return this.execute(() => this.trpc.reports.removeItems.mutate({ reportId, itemIds }));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Validation & Generation
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Validates a report and its items.
+     *
+     * Requires jurisdiction-specific defaults.
+     * For scoped SDKs, use the scoped resource which provides a simpler API.
+     *
+     * @param reportId - The report ID to validate
+     * @param defaults - Jurisdiction-specific defaults for validation
+     */
+    async validateReport(reportId, defaults) {
+        const validated = this.validate(reportDefaultsInputSchema, defaults);
+        return this.execute(() => this.trpc.reports.validate.mutate({ reportId, ...validated }));
+    }
+    /**
+     * Validates and generates the report output (e.g., XML for Mexico reports).
+     *
+     * Performs validation first:
+     * - If validation fails, returns `{ status: "validation_failed", validation: {...} }`
+     * - If validation passes, returns `{ status: "success", xml: "...", ... }`
+     *
+     * Use `validateReport` for dry-run/preview validation without generating XML.
+     *
+     * @param reportId - The report ID to generate
+     * @param defaults - Jurisdiction-specific defaults for generation
+     * @returns GenerateResult with status "success" or "validation_failed"
+     */
+    async generateReport(reportId, defaults) {
+        const validated = this.validate(reportDefaultsInputSchema, defaults);
+        return this.execute(() => this.trpc.reports.generate.mutate({ reportId, ...validated }));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Submission
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Submits a validated report.
+     *
+     * The report must be in "valid" status. After submission, the report
+     * is locked and cannot be edited.
+     *
+     * @param reportId - The report ID
+     * @param input - Submission data with jurisdiction-specific structure
+     */
+    async submit(input) {
+        const validated = this.validate(submitReportInputSchema, input);
+        return this.execute(() => this.trpc.reports.submit.mutate(validated));
+    }
+    async createMany(reports, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createReportInputSchema), reports);
+        const response = await this.execute(() => this.trpc.reports.createMany.mutate({ items: validated, 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: updateReportInputSchema,
+        });
+        const validated = this.validate(z.array(updateItemSchema), updates);
+        const response = await this.execute(() => this.trpc.reports.updateMany.mutate({ items: validated, 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,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Instantiation (protected for subclasses to override)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Instantiates a Report model from API response data.
+     * Subclasses override this to return their specific model type.
+     */
+    instantiate(data) {
+        return new Report(data);
+    }
+    /**
+     * Instantiates a ReportItem model from API response data.
+     * Subclasses override this to return their specific model type.
+     */
+    instantiateItem(data) {
+        return new ReportItem(data);
+    }
+}

package/dist/resources/transactions.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Transactions Resource
+ *
+ * CRUD operations, filtering, pagination, and client relationships.
+ *
+ * This is the base (unscoped) resource. For jurisdiction-scoped SDKs, use:
+ * - MexTransactionsResource - Mexico-scoped with flattened MX fields
+ * - AVITransactionsResource - Mexico AVI-scoped with flattened AVI fields
+ * - JYSTransactionsResource - Mexico JYS-scoped with flattened JYS fields
+ * - TSCTransactionsResource - Mexico TSC-scoped with flattened TSC fields
+ */
+import type { CreateTransactionInput, UpdateTransactionInput, TransactionFilter, TransactionSort, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, RelatedClient } from "@artu-ai/shared";
+import { ClientRole } from "@artu-ai/shared";
+import { BaseResource } from "./base";
+import { Transaction, type TransactionData } from "../models";
+/**
+ * Base resource manager for transaction operations.
+ *
+ * Provides:
+ * - CRUD operations (create, retrieve, update, delete)
+ * - Filtering and pagination
+ * - Client relationship management (linkClient, unlinkClient)
+ *
+ * @example
+ * ```typescript
+ * // Create a transaction with full nested format
+ * const txn = await sdk.transactions.create({
+ *   amount: 50000,
+ *   currency: "MXN",
+ *   primaryJurisdiction: "MX",
+ *   relatedClientIds: ["client_sender"],
+ *   timestamp: new Date(),
+ *   jurisdictions: {
+ *     MX: { actividadVulnerable: { AVI: { ... } } },
+ *   },
+ * });
+ *
+ * // List with filtering
+ * const { data, pagination } = await sdk.transactions.list({
+ *   filter: { status: "completed" },
+ *   limit: 20,
+ * });
+ * ```
+ */
+export declare class TransactionsResource<TSort = TransactionSort> extends BaseResource<Transaction, CreateTransactionInput, UpdateTransactionInput, TransactionFilter, TSort> {
+    /**
+     * Creates a new transaction.
+     *
+     * @param data - Transaction creation data in nested format
+     * @returns The created transaction model
+     */
+    create(data: CreateTransactionInput): Promise<Transaction>;
+    /**
+     * Retrieves a transaction by ID.
+     */
+    retrieve(id: string): Promise<Transaction>;
+    /**
+     * Retrieves a transaction by metadata key/value.
+     */
+    retrieveByMetadata(key: string, value: string): Promise<Transaction>;
+    /**
+     * Retrieves a transaction by externalId.
+     */
+    retrieveByExternalId(externalId: string): Promise<Transaction>;
+    /**
+     * Updates a transaction.
+     */
+    update(id: string, data: UpdateTransactionInput): Promise<Transaction>;
+    /**
+     * Deletes a transaction (soft delete).
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Lists transactions with optional filtering and pagination.
+     */
+    list(options?: ListOptions<TransactionFilter, TSort>): Promise<PaginatedResponse<Transaction>>;
+    /**
+     * Lists all transactions for a specific client.
+     *
+     * @param clientId - The client ID
+     * @param options - Optional pagination options
+     * @returns Paginated list of Transactions
+     */
+    listByClient(clientId: string, options?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<PaginatedResponse<Transaction>>;
+    /**
+     * Returns an async iterator over all transactions matching the filter.
+     */
+    iterate(filter?: TransactionFilter): AsyncGenerator<Transaction, void, undefined>;
+    /**
+     * Links a client to a transaction with an optional role.
+     */
+    linkClient(transactionId: string, clientId: string, role?: ClientRole): Promise<Transaction>;
+    /**
+     * Unlinks a client from a transaction.
+     */
+    unlinkClient(transactionId: string, clientId: string): Promise<Transaction>;
+    /**
+     * Replaces all clients related to a transaction.
+     */
+    setClients(transactionId: string, clients: RelatedClient[]): Promise<Transaction>;
+    /**
+     * Creates multiple transactions in a single request.
+     *
+     * @param transactions - Array of transaction creation data
+     * @param options - Batch options (atomic: true by default)
+     * @returns Atomic result with data array, or partial result with succeeded/failed
+     */
+    createMany(transactions: CreateTransactionInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<Transaction>>;
+    createMany(transactions: CreateTransactionInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<Transaction>>;
+    /**
+     * Updates multiple transactions in a single request.
+     *
+     * @param updates - Array of { id, data } updates
+     * @param options - Batch options (atomic: true by default)
+     * @returns Atomic result with data array, or partial result with succeeded/failed
+     */
+    updateMany(updates: {
+        id: string;
+        data: UpdateTransactionInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<Transaction>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateTransactionInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<Transaction>>;
+    /**
+     * Instantiates a Transaction model from API response data.
+     * Subclasses override this to return their specific model type.
+     */
+    protected instantiate(data: TransactionData): Transaction;
+}
+//# sourceMappingURL=transactions.d.ts.map

package/dist/resources/transactions.d.ts.map

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

package/dist/resources/transactions.js

@@ -0,0 +1,221 @@
+/**
+ * Transactions Resource
+ *
+ * CRUD operations, filtering, pagination, and client relationships.
+ *
+ * This is the base (unscoped) resource. For jurisdiction-scoped SDKs, use:
+ * - MexTransactionsResource - Mexico-scoped with flattened MX fields
+ * - AVITransactionsResource - Mexico AVI-scoped with flattened AVI fields
+ * - JYSTransactionsResource - Mexico JYS-scoped with flattened JYS fields
+ * - TSCTransactionsResource - Mexico TSC-scoped with flattened TSC fields
+ */
+import { z } from "zod";
+import { createTransactionInputSchema, updateTransactionInputSchema, } from "@artu-ai/shared";
+import { BaseResource } from "./base";
+import { Transaction } from "../models";
+// ===========================
+// TransactionsResource
+// ===========================
+/**
+ * Base resource manager for transaction operations.
+ *
+ * Provides:
+ * - CRUD operations (create, retrieve, update, delete)
+ * - Filtering and pagination
+ * - Client relationship management (linkClient, unlinkClient)
+ *
+ * @example
+ * ```typescript
+ * // Create a transaction with full nested format
+ * const txn = await sdk.transactions.create({
+ *   amount: 50000,
+ *   currency: "MXN",
+ *   primaryJurisdiction: "MX",
+ *   relatedClientIds: ["client_sender"],
+ *   timestamp: new Date(),
+ *   jurisdictions: {
+ *     MX: { actividadVulnerable: { AVI: { ... } } },
+ *   },
+ * });
+ *
+ * // List with filtering
+ * const { data, pagination } = await sdk.transactions.list({
+ *   filter: { status: "completed" },
+ *   limit: 20,
+ * });
+ * ```
+ */
+export class TransactionsResource extends BaseResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Creates a new transaction.
+     *
+     * @param data - Transaction creation data in nested format
+     * @returns The created transaction model
+     */
+    async create(data) {
+        const validated = this.validate(createTransactionInputSchema, data);
+        const response = await this.execute(() => this.trpc.transactions.create.mutate(validated));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a transaction by ID.
+     */
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.transactions.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a transaction by metadata key/value.
+     */
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a transaction by externalId.
+     */
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    /**
+     * Updates a transaction.
+     */
+    async update(id, data) {
+        const validated = this.validate(updateTransactionInputSchema, data);
+        const response = await this.execute(() => this.trpc.transactions.update.mutate({ id, data: validated }));
+        return this.instantiate(response);
+    }
+    /**
+     * Deletes a transaction (soft delete).
+     */
+    async delete(id) {
+        await this.execute(() => this.trpc.transactions.delete.mutate({ id }));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists transactions with optional filtering and pagination.
+     */
+    async list(options) {
+        const response = await this.execute(() => this.trpc.transactions.list.query(options));
+        return {
+            data: response.data.map((t) => this.instantiate(t)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Lists all transactions for a specific client.
+     *
+     * @param clientId - The client ID
+     * @param options - Optional pagination options
+     * @returns Paginated list of Transactions
+     */
+    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,
+        };
+    }
+    /**
+     * Returns an async iterator over all transactions matching the filter.
+     */
+    iterate(filter) {
+        return this.createIterator({ filter });
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Client Relationship Management
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Links a client to a transaction with an optional role.
+     */
+    async linkClient(transactionId, clientId, role) {
+        const response = await this.execute(() => this.trpc.transactions.linkClient.mutate({
+            transactionId,
+            clientId,
+            role,
+        }));
+        return this.instantiate(response);
+    }
+    /**
+     * Unlinks a client from a transaction.
+     */
+    async unlinkClient(transactionId, clientId) {
+        const response = await this.execute(() => this.trpc.transactions.unlinkClient.mutate({
+            transactionId,
+            clientId,
+        }));
+        return this.instantiate(response);
+    }
+    /**
+     * Replaces all clients related to a transaction.
+     */
+    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(createTransactionInputSchema), transactions);
+        const response = await this.execute(() => this.trpc.transactions.createMany.mutate({ items: validated, 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: updateTransactionInputSchema,
+        });
+        const validated = this.validate(z.array(updateItemSchema), updates);
+        const response = await this.execute(() => this.trpc.transactions.updateMany.mutate({ items: validated, 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,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Instantiation (protected for subclasses to override)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Instantiates a Transaction model from API response data.
+     * Subclasses override this to return their specific model type.
+     */
+    instantiate(data) {
+        return new Transaction(data);
+    }
+}