@artu-ai/compliance-sdk 0.0.6 → 0.3.0

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

@@ -0,0 +1,125 @@
+/**
+ * Mexico Transactions Resource
+ *
+ * Extends TransactionsResource with Mexico-specific behavior:
+ * - Accepts flattened CreateMexTransactionInput (MX fields at root level)
+ * - Automatically sets primaryJurisdiction to Mexico
+ * - Filters list/iterate to Mexico transactions only
+ * - Returns MexTransaction models
+ */
+import type { CreateTransactionInput, UpdateTransactionInput, TransactionFilter, TransactionSort, ListOptions, PaginatedResponse, CreateMexTransactionInput, UpdateMexTransactionInput, AtomicBatchResult, PartialBatchResult, RelatedClient, MexTransactionFilter, MexTransactionSort } from "@artu-ai/shared";
+import { ClientRole } from "@artu-ai/shared";
+import { TransactionsResource } from "../transactions";
+import { MexTransaction, type TransactionData } from "../../models";
+/**
+ * Mexico-scoped transactions resource.
+ *
+ * Provides the same operations as TransactionsResource but with:
+ * - Flattened input types (MX fields at root level)
+ * - Automatic jurisdiction scoping
+ * - MexTransaction model return type
+ *
+ * @example
+ * ```typescript
+ * const mexSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: Jurisdiction.Mexico,
+ * });
+ *
+ * // Create with flattened input
+ * const txn = await mexSdk.transactions.create({
+ *   amount: 50000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   actividadVulnerable: {
+ *     AVI: { tipoOperacion: "compra" },
+ *   },
+ * });
+ *
+ * // List returns only Mexico transactions
+ * const { data } = await mexSdk.transactions.list();
+ * // data is MexTransaction[]
+ * ```
+ */
+export declare class MexTransactionsResource<TSort = MexTransactionSort> extends TransactionsResource<TSort> {
+    /**
+     * Creates a new Mexico transaction with flattened input.
+     */
+    create(data: CreateMexTransactionInput): Promise<MexTransaction>;
+    /**
+     * Retrieves a transaction by ID.
+     */
+    retrieve(id: string): Promise<MexTransaction>;
+    retrieveByMetadata(key: string, value: string): Promise<MexTransaction>;
+    retrieveByExternalId(externalId: string): Promise<MexTransaction>;
+    /**
+     * Updates a Mexico transaction with flattened input.
+     */
+    update(id: string, data: UpdateMexTransactionInput): Promise<MexTransaction>;
+    /**
+     * Lists Mexico transactions with optional filtering.
+     *
+     * Accepts flattened MX filter (future MX-specific transaction fields at root level).
+     */
+    list(options?: ListOptions<MexTransactionFilter, TSort>): Promise<PaginatedResponse<MexTransaction>>;
+    /**
+     * Iterates over Mexico transactions.
+     *
+     * Accepts flattened MX filter (future MX-specific transaction fields at root level).
+     */
+    iterate(filter?: MexTransactionFilter): AsyncGenerator<MexTransaction, void, undefined>;
+    listByClient(clientId: string, options?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<PaginatedResponse<MexTransaction>>;
+    linkClient(transactionId: string, clientId: string, role?: ClientRole): Promise<MexTransaction>;
+    unlinkClient(transactionId: string, clientId: string): Promise<MexTransaction>;
+    setClients(transactionId: string, clients: RelatedClient[]): Promise<MexTransaction>;
+    createMany(transactions: CreateMexTransactionInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexTransaction>>;
+    createMany(transactions: CreateMexTransactionInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexTransaction>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMexTransactionInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexTransaction>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMexTransactionInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexTransaction>>;
+    /**
+     * Applies Mexico jurisdiction filter.
+     *
+     * Currently MexTransactionFilter has the same fields as the base filter,
+     * but this method ensures the jurisdiction scope is applied.
+     */
+    protected applyScopeToFilter(filter?: MexTransactionFilter): TransactionFilter;
+    /**
+     * Transforms a flattened MexTransactionSort to nested TransactionSort format.
+     *
+     * Maps flattened field names to their full API paths.
+     *
+     * Note: Uses unknown parameter to allow derived classes to override with their own sort types.
+     */
+    protected applyScopeToSort(sort?: TSort): TransactionSort | undefined;
+    /**
+     * Transforms flattened MX input to nested API format.
+     */
+    protected transformToNested(data: CreateMexTransactionInput): CreateTransactionInput;
+    /**
+     * Transforms flattened MX update input to nested API format.
+     */
+    protected transformUpdateToNested(data: UpdateMexTransactionInput): UpdateTransactionInput;
+    /**
+     * Instantiates a MexTransaction model.
+     */
+    protected instantiate(data: TransactionData): MexTransaction;
+}
+//# sourceMappingURL=transactions.d.ts.map

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

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

package/dist/resources/mex/transactions.js

@@ -0,0 +1,274 @@
+/**
+ * Mexico Transactions Resource
+ *
+ * Extends TransactionsResource with Mexico-specific behavior:
+ * - Accepts flattened CreateMexTransactionInput (MX fields at root level)
+ * - Automatically sets primaryJurisdiction to Mexico
+ * - Filters list/iterate to Mexico transactions only
+ * - Returns MexTransaction models
+ */
+import { z } from "zod";
+import { Jurisdiction, createMexTransactionInputSchema, updateMexTransactionInputSchema, transformSort, mexTransactionFieldMapping, } from "@artu-ai/shared";
+import { TransactionsResource } from "../transactions";
+import { MexTransaction } from "../../models";
+// ===========================
+// MexTransactionsResource
+// ===========================
+/**
+ * Mexico-scoped transactions resource.
+ *
+ * Provides the same operations as TransactionsResource but with:
+ * - Flattened input types (MX fields at root level)
+ * - Automatic jurisdiction scoping
+ * - MexTransaction model return type
+ *
+ * @example
+ * ```typescript
+ * const mexSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: Jurisdiction.Mexico,
+ * });
+ *
+ * // Create with flattened input
+ * const txn = await mexSdk.transactions.create({
+ *   amount: 50000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   actividadVulnerable: {
+ *     AVI: { tipoOperacion: "compra" },
+ *   },
+ * });
+ *
+ * // List returns only Mexico transactions
+ * const { data } = await mexSdk.transactions.list();
+ * // data is MexTransaction[]
+ * ```
+ */
+export class MexTransactionsResource extends TransactionsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations (override with flattened input types)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Creates a new Mexico transaction with flattened input.
+     */
+    async create(data) {
+        const validated = this.validate(createMexTransactionInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.create.mutate(nestedData));
+        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);
+    }
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    /**
+     * Updates a Mexico transaction with flattened input.
+     */
+    async update(id, data) {
+        const validated = this.validate(updateMexTransactionInputSchema, 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 (scoped to Mexico)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists Mexico transactions with optional filtering.
+     *
+     * Accepts flattened MX filter (future MX-specific transaction fields at root level).
+     */
+    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,
+        };
+    }
+    /**
+     * Iterates over Mexico transactions.
+     *
+     * Accepts flattened MX filter (future MX-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(createMexTransactionInputSchema), 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: updateMexTransactionInputSchema,
+        });
+        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
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Applies Mexico jurisdiction filter.
+     *
+     * Currently MexTransactionFilter has the same fields as the base filter,
+     * but this method ensures the jurisdiction scope is applied.
+     */
+    applyScopeToFilter(filter) {
+        if (!filter) {
+            return {
+                availableJurisdictions: Jurisdiction.Mexico,
+            };
+        }
+        // Currently no MX-specific transaction filter fields to nest
+        // Just pass through and add jurisdiction scope
+        return {
+            ...filter,
+            availableJurisdictions: Jurisdiction.Mexico,
+        };
+    }
+    /**
+     * Transforms a flattened MexTransactionSort to nested TransactionSort format.
+     *
+     * Maps flattened field names to their full API paths.
+     *
+     * Note: Uses unknown parameter to allow derived classes to override with their own sort types.
+     */
+    applyScopeToSort(sort) {
+        if (!sort || !Array.isArray(sort) || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, mexTransactionFieldMapping);
+    }
+    /**
+     * Transforms flattened MX input to nested API format.
+     */
+    transformToNested(data) {
+        const { actividadVulnerable, ...baseFields } = data;
+        // Build MX jurisdiction data
+        const mexData = {};
+        if (actividadVulnerable !== undefined) {
+            mexData.actividadVulnerable = actividadVulnerable;
+        }
+        return {
+            ...baseFields,
+            primaryJurisdiction: Jurisdiction.Mexico,
+            jurisdictions: Object.keys(mexData).length > 0
+                ? {
+                    MX: mexData,
+                }
+                : undefined,
+        };
+    }
+    /**
+     * Transforms flattened MX update input to nested API format.
+     */
+    transformUpdateToNested(data) {
+        const { actividadVulnerable, ...baseFields } = data;
+        if (actividadVulnerable === undefined) {
+            return baseFields;
+        }
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: { actividadVulnerable },
+            },
+        };
+    }
+    /**
+     * Instantiates a MexTransaction model.
+     */
+    instantiate(data) {
+        return new MexTransaction(data);
+    }
+}

package/dist/resources/reports.d.ts

@@ -0,0 +1,211 @@
+/**
+ * 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 type { CreateReportInput, UpdateReportInput, UpdateReportStatusInput, CreateReportItemInput, UpdateReportItemInput, ReportFilter, ReportSort, ReportItemFilter, ReportItemSort, ValidationResult, GenerateResult, SubmitReportInput, SubmissionResult, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, ReportDefaultsInput } from "@artu-ai/shared";
+import { BaseResource } from "./base";
+import { Report, ReportItem, type ReportData, type ReportItemData } from "../models";
+export type { ReportFilter, ReportItemFilter, ReportItemSort };
+/**
+ * Add items result
+ */
+export interface AddItemsResult {
+    added: number;
+    items: ReportItem[];
+}
+/**
+ * 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 declare class ReportsResource<TSort = ReportSort, TDefaults = ReportDefaultsInput> extends BaseResource<Report, CreateReportInput, UpdateReportInput, ReportFilter, TSort> {
+    /**
+     * Creates a new report.
+     *
+     * @param data - Report creation data in nested format
+     * @returns The created report model
+     */
+    create(data: CreateReportInput): Promise<Report>;
+    /**
+     * Retrieves a report by ID.
+     */
+    retrieve(id: string): Promise<Report>;
+    /**
+     * Retrieves a report by metadata key/value.
+     */
+    retrieveByMetadata(key: string, value: string): Promise<Report>;
+    /**
+     * Retrieves a report by externalId.
+     */
+    retrieveByExternalId(externalId: string): Promise<Report>;
+    /**
+     * Updates a report.
+     */
+    update(id: string, data: UpdateReportInput): Promise<Report>;
+    /**
+     * 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.
+     */
+    updateStatus(id: string, data: UpdateReportStatusInput): Promise<Report>;
+    /**
+     * Deletes a report.
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Lists reports with optional filtering and pagination.
+     */
+    list(options?: ListOptions<ReportFilter, TSort>): Promise<PaginatedResponse<Report>>;
+    /**
+     * Returns an async iterator over all reports matching the filter.
+     */
+    iterate(filter?: ReportFilter): AsyncGenerator<Report, void, undefined>;
+    /**
+     * Adds an item to a report.
+     */
+    addItem(reportId: string, data: CreateReportItemInput): Promise<ReportItem>;
+    /**
+     * Gets a specific report item.
+     */
+    getItem(reportId: string, itemId: string): Promise<ReportItem>;
+    /**
+     * Updates a report item.
+     */
+    updateItem(reportId: string, itemId: string, data: UpdateReportItemInput): Promise<ReportItem>;
+    /**
+     * Removes an item from a report.
+     */
+    removeItem(reportId: string, itemId: string): Promise<void>;
+    /**
+     * Lists items in a report with filtering, sorting, and pagination.
+     */
+    listItems(reportId: string, options?: ListOptions<ReportItemFilter, ReportItemSort>): Promise<PaginatedResponse<ReportItem>>;
+    /**
+     * Adds multiple items to a report.
+     * Validates all items upfront - fails fast if any item is invalid.
+     */
+    addItems(reportId: string, items: CreateReportItemInput[]): Promise<AddItemsResult>;
+    /**
+     * Removes multiple items from a report.
+     */
+    removeItems(reportId: string, itemIds: string[]): Promise<{
+        removed: number;
+    }>;
+    /**
+     * 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
+     */
+    validateReport(reportId: string, defaults: TDefaults): Promise<ValidationResult>;
+    /**
+     * 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"
+     */
+    generateReport(reportId: string, defaults: TDefaults): Promise<GenerateResult>;
+    /**
+     * 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
+     */
+    submit(input: SubmitReportInput): Promise<SubmissionResult>;
+    /**
+     * Creates multiple reports in a single request.
+     *
+     * @param reports - Array of report creation data
+     * @param options - Batch options (atomic: true by default)
+     * @returns Atomic result with data array, or partial result with succeeded/failed
+     */
+    createMany(reports: CreateReportInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<Report>>;
+    createMany(reports: CreateReportInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<Report>>;
+    /**
+     * Updates multiple reports 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: UpdateReportInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<Report>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateReportInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<Report>>;
+    /**
+     * Instantiates a Report model from API response data.
+     * Subclasses override this to return their specific model type.
+     */
+    protected instantiate(data: ReportData): Report;
+    /**
+     * Instantiates a ReportItem model from API response data.
+     * Subclasses override this to return their specific model type.
+     */
+    protected instantiateItem(data: ReportItemData): ReportItem;
+}
+//# sourceMappingURL=reports.d.ts.map

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

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