/**
 * Mexico Transactions Resource
 *
 * Extends TransactionsResource with Mexico-specific behavior:
 * - Accepts flattened CreateMexTransactionInput (MX fields at root level)
 * - Automatically injects scopes: ["MX"]
 * - Transforms flattened filters to nested format
 * - Returns MexTransaction models
 */
import type { AtomicBatchResult, CreateMexTransactionInput, CreateTransactionInput, ListOptions, MexTransactionFilter, MexTransactionSort, PaginatedResponse, PartialBatchResult, RelatedClient, TransactionFilter, TransactionSort, UpdateMexTransactionInput, UpdateTransactionInput, UpsertMexTransactionInput, UpsertResult } from "@artu-ai/shared";
import { ClientRole } from "@artu-ai/shared";
import { MexTransaction, type TransactionData } from "../../models";
import { TransactionsResource } from "../transactions";
/**
 * Mexico-scoped transactions resource.
 *
 * Provides the same operations as TransactionsResource but with:
 * - Flattened input types (MX fields at root level)
 * - Automatic scopes injection on create/update
 * - MexTransaction model return type
 *
 * @example
 * ```typescript
 * // Using the Mexico SDK entry point
 * import { ComplianceSDK } from "@artu-ai/compliance-sdk/mx";
 *
 * const mexSdk = new ComplianceSDK({
 *   apiKey,
 *   environment: "test",
 * });
 *
 * // Create with flattened input
 * const txn = await mexSdk.transactions.create({
 *   amount: 50000,
 *   currency: "MXN",
 *   timestamp: new Date(),
 *   actividadVulnerable: {
 *     AVI: { tipoOperacion: "compra" },
 *   },
 * });
 *
 * // List transactions
 * const { data } = await mexSdk.transactions.list();
 * // data is MexTransaction[]
 * ```
 */
export declare class MexTransactionsResource<TSort = MexTransactionSort> extends TransactionsResource<TSort> {
    protected static readonly SCOPE_PATH: string[];
    /**
     * Creates a new Mexico transaction with flattened input.
     */
    create(data: CreateMexTransactionInput): Promise<MexTransaction>;
    /**
     * Retrieves a transaction by ID.
     */
    retrieve(id: string, opts?: {
        crossScope?: boolean;
    }): Promise<MexTransaction>;
    retrieveByMetadata(key: string, value: string, opts?: {
        crossScope?: boolean;
    }): Promise<MexTransaction>;
    retrieveByExternalId(externalId: string, opts?: {
        crossScope?: boolean;
    }): 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> & {
        crossScope?: boolean;
    }): Promise<PaginatedResponse<MexTransaction>>;
    /**
     * Counts Mexico transactions matching the given filter.
     *
     * @param filter - Optional filter criteria (with MX fields at root level)
     * @returns The count of matching transactions
     */
    count(filter?: MexTransactionFilter, options?: {
        crossScope?: boolean;
    }): Promise<number>;
    /**
     * Iterates over Mexico transactions.
     *
     * Accepts flattened MX filter (future MX-specific transaction fields at root level).
     */
    iterate(options?: {
        filter?: MexTransactionFilter;
        sort?: TSort;
        pageSize?: number;
        crossScope?: boolean;
    }): 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>>;
    /**
     * Creates or updates a Mexico transaction by externalId.
     *
     * @param data - Transaction upsert data with MX fields at root level (must include externalId)
     * @returns The created or updated transaction with action indicator
     */
    upsertByExternalId(data: UpsertMexTransactionInput): Promise<UpsertResult<MexTransaction>>;
    /**
     * Creates or updates multiple Mexico transactions by externalId.
     *
     * @param transactions - Array of transaction upsert data (each must include externalId)
     * @param options - Batch options (atomic: true by default)
     * @returns Atomic result with data array, or partial result with succeeded/failed
     */
    upsertManyByExternalId(transactions: UpsertMexTransactionInput[], options?: {
        atomic?: true;
    }): Promise<AtomicBatchResult<UpsertResult<MexTransaction>>>;
    upsertManyByExternalId(transactions: UpsertMexTransactionInput[], options: {
        atomic: false;
    }): Promise<PartialBatchResult<UpsertResult<MexTransaction>>>;
    /**
     * Transforms a flattened MexTransactionFilter to nested TransactionFilter format.
     *
     * Currently MexTransactionFilter has the same fields as the base filter.
     *
     * Note: This method only transforms filters, it does not automatically add
     * scope scoping. Use explicit filters if you need to scope by scope.
     */
    protected applyScopeToFilter(filter?: MexTransactionFilter): TransactionFilter | undefined;
    /**
     * 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.
     *
     * NOTE: Always includes `scopeData: { MX: {} }` even if no MX-specific
     * fields are provided. This ensures that records touched via the Mexico SDK
     * can be filtered by `availableJurisdictions: { in: ["MX"] }`.
     */
    protected transformUpdateToNested(data: UpdateMexTransactionInput): UpdateTransactionInput;
    /**
     * Instantiates a MexTransaction model.
     */
    protected instantiate(data: TransactionData): MexTransaction;
    /** Materializes a raw payload into a {@link MexTransaction} (return type narrowed via the `instantiate` override). */
    materialize(data: TransactionData): MexTransaction;
}