@artu-ai/compliance-sdk 0.13.4 → 0.17.0

package/dist/resources/mx/av/mpc/transactions.d.ts

@@ -0,0 +1,107 @@
+/**
+ * MPC (Mutuo, Préstamos y Créditos) Transactions Resource
+ *
+ * Extends MexTransactionsResource with MPC-specific behavior:
+ * - Accepts flattened CreateMPCTransactionInput (MPC fields at root level)
+ * - Returns MexMPCTransaction models
+ * - Handles operationType, postalCode, collateral[] array, disbursements[] array
+ */
+import type { AtomicBatchResult, CreateMPCTransactionInput, CreateTransactionInput, ListOptions, MPCTransactionFilter, MPCTransactionSort, PaginatedResponse, PartialBatchResult, RelatedClient, TransactionSort, UpdateMPCTransactionInput, UpdateTransactionInput, UpsertMPCTransactionInput, UpsertResult } from "@artu-ai/shared";
+import { MexMPCTransaction, type TransactionData } from "../../../../models";
+import { AVTransactionsResource } from "../transactions";
+/**
+ * MPC (Mutuo, Préstamos y Créditos) scoped transactions resource.
+ *
+ * @example
+ * ```typescript
+ * const mpcSdk = new ComplianceSDK({
+ *   apiKey,
+ *   scope: "MX:AV:MPC",
+ * });
+ *
+ * const txn = await mpcSdk.transactions.create({
+ *   amount: 1500000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   operationType: "402",
+ *   postalCode: "06700",
+ *   collateral: [
+ *     {
+ *       tipoGarantia: "2",
+ *       bienMutuo: {
+ *         kind: "inmueble",
+ *         tipoInmueble: "1",
+ *         valorReferencia: "1500000.00",
+ *         postalCode: "06700",
+ *         folioReal: "FR-001",
+ *       },
+ *     },
+ *   ],
+ *   disbursements: [
+ *     { monetaryInstrument: "1", currency: "MXN", amount: "1500000.00" }
+ *   ],
+ *   relatedClientIds: [client.id],
+ * });
+ * ```
+ */
+export declare class MPCTransactionsResource extends AVTransactionsResource {
+    protected static readonly SCOPE_PATH: string[];
+    create(data: CreateMPCTransactionInput): Promise<MexMPCTransaction>;
+    retrieve(id: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexMPCTransaction>;
+    retrieveByMetadata(key: string, value: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexMPCTransaction>;
+    update(id: string, data: UpdateMPCTransactionInput): Promise<MexMPCTransaction>;
+    list(options?: ListOptions<MPCTransactionFilter, MPCTransactionSort> & {
+        crossScope?: boolean;
+    }): Promise<PaginatedResponse<MexMPCTransaction>>;
+    iterate(options?: {
+        filter?: MPCTransactionFilter;
+        sort?: MPCTransactionSort;
+        pageSize?: number;
+        crossScope?: boolean;
+    }): AsyncGenerator<MexMPCTransaction, void, undefined>;
+    count(filter?: MPCTransactionFilter, options?: {
+        crossScope?: boolean;
+    }): Promise<number>;
+    listByClient(clientId: string, options?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<PaginatedResponse<MexMPCTransaction>>;
+    linkClient(transactionId: string, clientId: string, role?: import("@artu-ai/shared").ClientRole): Promise<MexMPCTransaction>;
+    unlinkClient(transactionId: string, clientId: string): Promise<MexMPCTransaction>;
+    setClients(transactionId: string, clients: RelatedClient[]): Promise<MexMPCTransaction>;
+    createMany(transactions: CreateMPCTransactionInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexMPCTransaction>>;
+    createMany(transactions: CreateMPCTransactionInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexMPCTransaction>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMPCTransactionInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexMPCTransaction>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMPCTransactionInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexMPCTransaction>>;
+    upsertByExternalId(data: UpsertMPCTransactionInput): Promise<UpsertResult<MexMPCTransaction>>;
+    upsertManyByExternalId(transactions: UpsertMPCTransactionInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<UpsertResult<MexMPCTransaction>>>;
+    upsertManyByExternalId(transactions: UpsertMPCTransactionInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<UpsertResult<MexMPCTransaction>>>;
+    protected transformToNested(data: CreateMPCTransactionInput): CreateTransactionInput;
+    protected transformUpdateToNested(data: UpdateMPCTransactionInput): UpdateTransactionInput;
+    protected instantiate(data: TransactionData): MexMPCTransaction;
+    /** Materializes a raw payload into a {@link MexMPCTransaction} (return type narrowed via the `instantiate` override). */
+    materialize(data: TransactionData): MexMPCTransaction;
+    protected applyScopeToSort(sort?: MPCTransactionSort): TransactionSort | undefined;
+}

package/dist/resources/mx/av/mpc/transactions.js

@@ -0,0 +1,291 @@
+/**
+ * MPC (Mutuo, Préstamos y Créditos) Transactions Resource
+ *
+ * Extends MexTransactionsResource with MPC-specific behavior:
+ * - Accepts flattened CreateMPCTransactionInput (MPC fields at root level)
+ * - Returns MexMPCTransaction models
+ * - Handles operationType, postalCode, collateral[] array, disbursements[] array
+ */
+import { CodigoActividad, createMPCTransactionInputSchema, mpcTransactionSortingFieldMapping, transformSort, updateMPCTransactionInputSchema, upsertMPCTransactionInputSchema, } from "@artu-ai/shared";
+import { z } from "zod";
+import { MexMPCTransaction } from "../../../../models";
+import { splitTransactionCreateFields, splitTransactionUpdateFields, } from "../../update-split";
+import { AVTransactionsResource } from "../transactions";
+// ===========================
+// MPCTransactionsResource
+// ===========================
+/**
+ * MPC (Mutuo, Préstamos y Créditos) scoped transactions resource.
+ *
+ * @example
+ * ```typescript
+ * const mpcSdk = new ComplianceSDK({
+ *   apiKey,
+ *   scope: "MX:AV:MPC",
+ * });
+ *
+ * const txn = await mpcSdk.transactions.create({
+ *   amount: 1500000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   operationType: "402",
+ *   postalCode: "06700",
+ *   collateral: [
+ *     {
+ *       tipoGarantia: "2",
+ *       bienMutuo: {
+ *         kind: "inmueble",
+ *         tipoInmueble: "1",
+ *         valorReferencia: "1500000.00",
+ *         postalCode: "06700",
+ *         folioReal: "FR-001",
+ *       },
+ *     },
+ *   ],
+ *   disbursements: [
+ *     { monetaryInstrument: "1", currency: "MXN", amount: "1500000.00" }
+ *   ],
+ *   relatedClientIds: [client.id],
+ * });
+ * ```
+ */
+export class MPCTransactionsResource extends AVTransactionsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations
+    // ─────────────────────────────────────────────────────────────────
+    static SCOPE_PATH = [
+        "MX",
+        "actividadVulnerable",
+        CodigoActividad.MPC,
+    ];
+    async create(data) {
+        const merged = await this.mergeProductDataFlat(data, MPCTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(createMPCTransactionInputSchema, merged);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    async retrieve(id, opts) {
+        const response = await this.execute(() => this.trpc.transactions.retrieve.query({
+            id,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
+        return this.instantiate(response);
+    }
+    async retrieveByMetadata(key, value, opts) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({
+            key,
+            value,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
+        return this.instantiate(response);
+    }
+    async update(id, data) {
+        const merged = await this.mergeProductDataFlat(data, MPCTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(updateMPCTransactionInputSchema, 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 { crossScope, ...rest } = options ?? {};
+        const scopedFilter = this.applyAutoScope(this.applyScopeToFilter(rest.filter), crossScope);
+        const scopedSort = this.applyScopeToSort(rest.sort);
+        const response = await this.execute(() => this.trpc.transactions.list.query({
+            ...rest,
+            filter: scopedFilter,
+            sort: scopedSort,
+        }));
+        return {
+            data: response.data.map((t) => this.instantiate(t)),
+            pagination: response.pagination,
+        };
+    }
+    iterate(options) {
+        // Do NOT apply scope here — createIterator calls this.list(), which
+        // applies the flatten transform AND auto-scope exactly once.
+        return this.createIterator({
+            filter: options?.filter,
+            sort: options?.sort,
+            pageSize: options?.pageSize,
+            crossScope: options?.crossScope,
+        });
+    }
+    async count(filter, options) {
+        const scopedFilter = this.applyAutoScope(this.applyScopeToFilter(filter), options?.crossScope);
+        const response = await this.execute(() => this.trpc.transactions.count.query({ filter: scopedFilter }));
+        return response.count;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Client Relationship Management
+    // ─────────────────────────────────────────────────────────────────
+    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, MPCTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(z.array(createMPCTransactionInputSchema), 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: updateMPCTransactionInputSchema,
+        });
+        const mergedData = await this.mergeProductDataFlatBatch(updates.map((u) => u.data), MPCTransactionsResource.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, MPCTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(upsertMPCTransactionInputSchema, 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,
+        };
+    }
+    async upsertManyByExternalId(transactions, options = {}) {
+        const atomic = options.atomic ?? true;
+        const merged = await this.mergeProductDataFlatBatch(transactions, MPCTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(z.array(upsertMPCTransactionInputSchema), merged);
+        const nestedItems = validated.map((t) => this.transformToNested(t));
+        const response = await this.execute(() => this.trpc.transactions.upsertManyByExternalId.mutate({
+            items: nestedItems,
+            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,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    transformToNested(data) {
+        const { base, scopeData } = splitTransactionCreateFields(data, MPCTransactionsResource.SCOPE_PATH);
+        return {
+            ...base,
+            scopes: ["MX", "MX:AV", "MX:AV:MPC"],
+            scopeData,
+        };
+    }
+    transformUpdateToNested(data) {
+        const { base, scopeData } = splitTransactionUpdateFields(data, MPCTransactionsResource.SCOPE_PATH);
+        return {
+            ...base,
+            scopes: ["MX", "MX:AV", "MX:AV:MPC"],
+            scopeData,
+        };
+    }
+    instantiate(data) {
+        return new MexMPCTransaction(data);
+    }
+    /** Materializes a raw payload into a {@link MexMPCTransaction} (return type narrowed via the `instantiate` override). */
+    materialize(data) {
+        return this.instantiate(data);
+    }
+    applyScopeToSort(sort) {
+        if (!sort || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, mpcTransactionSortingFieldMapping);
+    }
+}

package/dist/resources/mx/av/products.d.ts

@@ -15,19 +15,29 @@ import { MexProductsResource } from "../products";
  */
 export declare class AVProductsResource extends MexProductsResource<ProductSort> {
     create(data: CreateMexProductInput): Promise<MexAVProduct>;
-    retrieve(id: string): Promise<MexAVProduct>;
-    retrieveByExternalId(externalId: string): Promise<MexAVProduct>;
+    retrieve(id: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVProduct>;
+    retrieveByExternalId(externalId: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVProduct>;
     update(id: string, data: UpdateMexProductInput): Promise<MexAVProduct>;
-    list(options?: ListOptions<ProductFilter, ProductSort>): Promise<PaginatedResponse<MexAVProduct>>;
-    count(filter?: ProductFilter): Promise<number>;
+    list(options?: ListOptions<ProductFilter, ProductSort> & {
+        crossScope?: boolean;
+    }): Promise<PaginatedResponse<MexAVProduct>>;
+    count(filter?: ProductFilter, options?: {
+        crossScope?: boolean;
+    }): Promise<number>;
     iterate(options?: {
         filter?: ProductFilter;
         sort?: ProductSort;
         pageSize?: number;
+        crossScope?: boolean;
     }): AsyncGenerator<MexAVProduct, void, undefined>;
     upsertByExternalId(data: UpsertMexProductInput): Promise<UpsertResult<MexAVProduct>>;
     protected transformToNested(data: CreateMexProductInput): CreateProductInput;
     protected transformUpdateToNested(data: UpdateMexProductInput): UpdateProductInput;
     protected instantiate(data: ProductData): MexAVProduct;
+    /** Materializes a raw payload into a {@link MexAVProduct} (return type narrowed via the `instantiate` override). */
+    materialize(data: ProductData): MexAVProduct;
 }
-//# sourceMappingURL=products.d.ts.map

package/dist/resources/mx/av/products.js

@@ -26,12 +26,18 @@ export class AVProductsResource extends MexProductsResource {
         const response = await this.execute(() => this.trpc.products.create.mutate(nestedData));
         return this.instantiate(response);
     }
-    async retrieve(id) {
-        const response = await this.execute(() => this.trpc.products.retrieve.query({ id }));
+    async retrieve(id, opts) {
+        const response = await this.execute(() => this.trpc.products.retrieve.query({
+            id,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
-    async retrieveByExternalId(externalId) {
-        const response = await this.execute(() => this.trpc.products.retrieveByExternalId.query({ externalId }));
+    async retrieveByExternalId(externalId, opts) {
+        const response = await this.execute(() => this.trpc.products.retrieveByExternalId.query({
+            externalId,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
     async update(id, data) {
@@ -44,14 +50,17 @@ export class AVProductsResource extends MexProductsResource {
     // List & Pagination
     // ─────────────────────────────────────────────────────────────────
     async list(options) {
-        const response = await this.execute(() => this.trpc.products.list.query(options));
+        const { crossScope, ...rest } = options ?? {};
+        const filter = this.applyAutoScope(rest.filter, crossScope);
+        const response = await this.execute(() => this.trpc.products.list.query({ ...rest, filter }));
         return {
             data: response.data.map((p) => this.instantiate(p)),
             pagination: response.pagination,
         };
     }
-    async count(filter) {
-        const response = await this.execute(() => this.trpc.products.count.query({ filter }));
+    async count(filter, options) {
+        const scopedFilter = this.applyAutoScope(filter, options?.crossScope);
+        const response = await this.execute(() => this.trpc.products.count.query({ filter: scopedFilter }));
         return response.count;
     }
     iterate(options) {
@@ -59,6 +68,7 @@ export class AVProductsResource extends MexProductsResource {
             filter: options?.filter,
             sort: options?.sort,
             pageSize: options?.pageSize,
+            crossScope: options?.crossScope,
         });
     }
     // ─────────────────────────────────────────────────────────────────
@@ -93,4 +103,8 @@ export class AVProductsResource extends MexProductsResource {
     instantiate(data) {
         return new MexAVProduct(data);
     }
+    /** Materializes a raw payload into a {@link MexAVProduct} (return type narrowed via the `instantiate` override). */
+    materialize(data) {
+        return this.instantiate(data);
+    }
 }

package/dist/resources/mx/av/tenant.d.ts

@@ -30,4 +30,3 @@ export interface AVUpdateTenantInput extends Omit<MexUpdateTenantInput, "activid
 export declare class AVTenantResource extends MexTenantResource {
     update(data: AVUpdateTenantInput): Promise<TenantResponse>;
 }
-//# sourceMappingURL=tenant.d.ts.map

package/dist/resources/mx/av/transactions.d.ts

@@ -17,16 +17,25 @@ import { MexTransactionsResource } from "../transactions";
 export declare class AVTransactionsResource extends MexTransactionsResource<MexTransactionSort> {
     protected static readonly SCOPE_PATH: string[];
     create(data: CreateMexTransactionInput): Promise<MexAVTransaction>;
-    retrieve(id: string): Promise<MexAVTransaction>;
-    retrieveByMetadata(key: string, value: string): Promise<MexAVTransaction>;
+    retrieve(id: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVTransaction>;
+    retrieveByMetadata(key: string, value: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexAVTransaction>;
     update(id: string, data: UpdateMexTransactionInput): Promise<MexAVTransaction>;
-    list(options?: ListOptions<MexTransactionFilter, MexTransactionSort>): Promise<PaginatedResponse<MexAVTransaction>>;
+    list(options?: ListOptions<MexTransactionFilter, MexTransactionSort> & {
+        crossScope?: boolean;
+    }): Promise<PaginatedResponse<MexAVTransaction>>;
     iterate(options?: {
         filter?: MexTransactionFilter;
         sort?: MexTransactionSort;
         pageSize?: number;
+        crossScope?: boolean;
     }): AsyncGenerator<MexAVTransaction, void, undefined>;
-    count(filter?: MexTransactionFilter): Promise<number>;
+    count(filter?: MexTransactionFilter, options?: {
+        crossScope?: boolean;
+    }): Promise<number>;
     listByClient(clientId: string, options?: {
         cursor?: string;
         limit?: number;
@@ -63,5 +72,6 @@ export declare class AVTransactionsResource extends MexTransactionsResource<MexT
     protected transformToNested(data: CreateMexTransactionInput): CreateTransactionInput;
     protected transformUpdateToNested(data: UpdateMexTransactionInput): UpdateTransactionInput;
     protected instantiate(data: TransactionData): MexAVTransaction;
+    /** Materializes a raw payload into a {@link MexAVTransaction} (return type narrowed via the `instantiate` override). */
+    materialize(data: TransactionData): MexAVTransaction;
 }
-//# sourceMappingURL=transactions.d.ts.map

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

@@ -29,12 +29,19 @@ export class AVTransactionsResource extends MexTransactionsResource {
         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 }));
+    async retrieve(id, opts) {
+        const response = await this.execute(() => this.trpc.transactions.retrieve.query({
+            id,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
-    async retrieveByMetadata(key, value) {
-        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({ key, value }));
+    async retrieveByMetadata(key, value, opts) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({
+            key,
+            value,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
     async update(id, data) {
@@ -48,10 +55,11 @@ export class AVTransactionsResource extends MexTransactionsResource {
     // List & Pagination
     // ─────────────────────────────────────────────────────────────────
     async list(options) {
-        const scopedFilter = this.applyScopeToFilter(options?.filter);
-        const scopedSort = this.applyScopeToSort(options?.sort);
+        const { crossScope, ...rest } = options ?? {};
+        const scopedFilter = this.applyAutoScope(this.applyScopeToFilter(rest.filter), crossScope);
+        const scopedSort = this.applyScopeToSort(rest.sort);
         const response = await this.execute(() => this.trpc.transactions.list.query({
-            ...options,
+            ...rest,
             filter: scopedFilter,
             sort: scopedSort,
         }));
@@ -61,15 +69,17 @@ export class AVTransactionsResource extends MexTransactionsResource {
         };
     }
     iterate(options) {
-        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        // Do NOT apply scope here — createIterator calls this.list(), which
+        // applies the flatten transform AND auto-scope exactly once.
         return this.createIterator({
-            filter: scopedFilter,
+            filter: options?.filter,
             sort: options?.sort,
             pageSize: options?.pageSize,
+            crossScope: options?.crossScope,
         });
     }
-    async count(filter) {
-        const scopedFilter = this.applyScopeToFilter(filter);
+    async count(filter, options) {
+        const scopedFilter = this.applyAutoScope(this.applyScopeToFilter(filter), options?.crossScope);
         const response = await this.execute(() => this.trpc.transactions.count.query({ filter: scopedFilter }));
         return response.count;
     }
@@ -236,4 +246,8 @@ export class AVTransactionsResource extends MexTransactionsResource {
     instantiate(data) {
         return new MexAVTransaction(data);
     }
+    /** Materializes a raw payload into a {@link MexAVTransaction} (return type narrowed via the `instantiate` override). */
+    materialize(data) {
+        return this.instantiate(data);
+    }
 }