@artu-ai/compliance-sdk 0.4.1 → 0.4.2

package/src/resources/transactions.ts

@@ -1,358 +0,0 @@
-/**
- * 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 type {
-  CreateTransactionInput,
-  UpdateTransactionInput,
-  TransactionFilter,
-  TransactionSort,
-  ListOptions,
-  PaginatedResponse,
-  AtomicBatchResult,
-  PartialBatchResult,
-  RelatedClient,
-} from "@artu-ai/shared";
-import {
-  createTransactionInputSchema,
-  updateTransactionInputSchema,
-  ClientRole,
-} from "@artu-ai/shared";
-import type { BatchOptions } from "./clients";
-import { BaseResource } from "./base";
-import { Transaction, type TransactionData } 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<
-  TSort = TransactionSort,
-> extends BaseResource<
-  Transaction,
-  CreateTransactionInput,
-  UpdateTransactionInput,
-  TransactionFilter,
-  TSort
-> {
-  // ─────────────────────────────────────────────────────────────────
-  // CRUD Operations
-  // ─────────────────────────────────────────────────────────────────
-
-  /**
-   * Creates a new transaction.
-   *
-   * @param data - Transaction creation data in nested format
-   * @returns The created transaction model
-   */
-  async create(data: CreateTransactionInput): Promise<Transaction> {
-    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: string): Promise<Transaction> {
-    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: string, value: string): Promise<Transaction> {
-    const response = await this.execute(() =>
-      this.trpc.transactions.retrieveByMetadata.query({ key, value })
-    );
-    return this.instantiate(response);
-  }
-
-  /**
-   * Retrieves a transaction by externalId.
-   */
-  async retrieveByExternalId(externalId: string): Promise<Transaction> {
-    const response = await this.execute(() =>
-      this.trpc.transactions.retrieveByExternalId.query({ externalId })
-    );
-    return this.instantiate(response);
-  }
-
-  /**
-   * Updates a transaction.
-   */
-  async update(id: string, data: UpdateTransactionInput): Promise<Transaction> {
-    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: string): Promise<void> {
-    await this.execute(() => this.trpc.transactions.delete.mutate({ id }));
-  }
-
-  // ─────────────────────────────────────────────────────────────────
-  // List & Pagination
-  // ─────────────────────────────────────────────────────────────────
-
-  /**
-   * Lists transactions with optional filtering and pagination.
-   */
-  async list(
-    options?: ListOptions<TransactionFilter, TSort>
-  ): Promise<PaginatedResponse<Transaction>> {
-    const response = await this.execute(() =>
-      this.trpc.transactions.list.query(options as ListOptions<TransactionFilter, TransactionSort>)
-    );
-
-    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: string,
-    options?: { cursor?: string; limit?: number }
-  ): Promise<PaginatedResponse<Transaction>> {
-    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?: TransactionFilter
-  ): AsyncGenerator<Transaction, void, undefined> {
-    return this.createIterator({ filter });
-  }
-
-  // ─────────────────────────────────────────────────────────────────
-  // Client Relationship Management
-  // ─────────────────────────────────────────────────────────────────
-
-  /**
-   * Links a client to a transaction with an optional role.
-   */
-  async linkClient(
-    transactionId: string,
-    clientId: string,
-    role?: ClientRole
-  ): Promise<Transaction> {
-    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: string,
-    clientId: string
-  ): Promise<Transaction> {
-    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: string,
-    clients: RelatedClient[]
-  ): Promise<Transaction> {
-    const response = await this.execute(() =>
-      this.trpc.transactions.setClients.mutate({
-        transactionId,
-        clients,
-      })
-    );
-    return this.instantiate(response);
-  }
-
-  // ─────────────────────────────────────────────────────────────────
-  // Batch Operations
-  // ─────────────────────────────────────────────────────────────────
-
-  /**
-   * 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
-   */
-  async createMany(
-    transactions: CreateTransactionInput[],
-    options?: { atomic?: true }
-  ): Promise<AtomicBatchResult<Transaction>>;
-  async createMany(
-    transactions: CreateTransactionInput[],
-    options: { atomic: false }
-  ): Promise<PartialBatchResult<Transaction>>;
-  async createMany(
-    transactions: CreateTransactionInput[],
-    options: BatchOptions = {}
-  ): Promise<AtomicBatchResult<Transaction> | PartialBatchResult<Transaction>> {
-    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,
-      };
-    }
-  }
-
-  /**
-   * 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
-   */
-  async updateMany(
-    updates: { id: string; data: UpdateTransactionInput }[],
-    options?: { atomic?: true }
-  ): Promise<AtomicBatchResult<Transaction>>;
-  async updateMany(
-    updates: { id: string; data: UpdateTransactionInput }[],
-    options: { atomic: false }
-  ): Promise<PartialBatchResult<Transaction>>;
-  async updateMany(
-    updates: { id: string; data: UpdateTransactionInput }[],
-    options: BatchOptions = {}
-  ): Promise<AtomicBatchResult<Transaction> | PartialBatchResult<Transaction>> {
-    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.
-   */
-  protected instantiate(data: TransactionData): Transaction {
-    return new Transaction(data);
-  }
-}