@artu-ai/compliance-sdk 0.5.4 → 0.6.1

package/dist/resources/transactions.js

@@ -10,7 +10,7 @@
  * - TSCTransactionsResource - Mexico TSC-scoped with flattened TSC fields
  */
 import { z } from "zod";
-import { createTransactionInputSchema, updateTransactionInputSchema, } from "@artu-ai/shared";
+import { createTransactionInputSchema, updateTransactionInputSchema, upsertTransactionInputSchema, } from "@artu-ai/shared";
 import { BaseResource } from "./base";
 import { Transaction } from "../models";
 // ===========================
@@ -125,8 +125,12 @@ export class TransactionsResource extends BaseResource {
     /**
      * Returns an async iterator over all transactions matching the filter.
      */
-    iterate(filter) {
-        return this.createIterator({ filter });
+    iterate(options) {
+        return this.createIterator({
+            filter: options?.filter,
+            sort: options?.sort,
+            pageSize: options?.pageSize,
+        });
     }
     // ─────────────────────────────────────────────────────────────────
     // Client Relationship Management
@@ -209,6 +213,56 @@ export class TransactionsResource extends BaseResource {
         }
     }
     // ─────────────────────────────────────────────────────────────────
+    // Upsert Operations
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Creates or updates a transaction by externalId.
+     *
+     * If a transaction with the given externalId exists, it will be updated.
+     * Otherwise, a new transaction will be created.
+     *
+     * @param data - Transaction upsert data (must include externalId)
+     * @returns The created or updated transaction with action indicator
+     */
+    async upsertByExternalId(data) {
+        const validated = this.validate(upsertTransactionInputSchema, data);
+        const response = await this.execute(() => this.trpc.transactions.upsertByExternalId.mutate(validated));
+        return {
+            data: this.instantiate(response.data),
+            action: response.action,
+        };
+    }
+    async upsertManyByExternalId(transactions, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(upsertTransactionInputSchema), transactions);
+        const response = await this.execute(() => this.trpc.transactions.upsertManyByExternalId.mutate({
+            items: validated,
+            atomic,
+        }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((item) => ({
+                    data: this.instantiate(item.data),
+                    action: item.action,
+                })),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: {
+                        data: this.instantiate(item.data.data),
+                        action: item.data.action,
+                    },
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
     // Instantiation (protected for subclasses to override)
     // ─────────────────────────────────────────────────────────────────
     /**

package/dist/sdk/ComplianceSDK.d.ts.map

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

package/dist/sdk/ComplianceSDK.js

@@ -510,6 +510,8 @@ export class ComplianceSDKImpl {
             baseUrl: this._baseUrl,
             environment: this._environment,
             // Cookie mode: use credentials and headers; API key mode: omit them
+            // _credentials is always defined for cookie mode (constructor guarantees "include" default)
+            // The fallback is for type safety only
             credentials: this._authMode === "cookie"
                 ? (this._credentials ?? "include")
                 : "omit",