/**
 * MJR (Metales y Joyas - Precious Metals and Jewelry) Clients Resource
 *
 * Extends MexClientsResource with MJR-specific behavior.
 * MJR clients have the same fields as Mexico clients (no additional activity fields).
 * Returns MexMJRClient models.
 */
import type { AtomicBatchResult, ClientRelationshipType, ClientSort, CreateBankAccountInput, CreateClientInput, CreateContactMethodInput, CreateMexAddressInput, CreateMJRClientInput, LinkedClient as LinkedClientInput, ListOptions, MJRClientFilter, MJRClientSort, PaginatedResponse, PartialBatchResult, SyncCreateDocumentInput, SyncItem, SyncResult, SyncUpdateDocumentInput, UpdateBankAccountInput, UpdateClientInput, UpdateContactMethodInput, UpdateMexAddressInput, UpdateMJRClientInput, UpsertMJRClientInput, UpsertResult } from "@artu-ai/shared";
import { type ClientData, ContactMethod, Document, LinkedClient, MexAddress, MexBankAccount, MexMJRClient } from "../../../../models";
import { type ClientIncludeMap } from "../../../clients";
import type { RelatedPartyParent, RelatedPartySubresource } from "../../../related-parties/base";
import { AVClientsResource } from "../clients";
/**
 * MJR (Metales y Joyas) scoped clients resource.
 *
 * @example
 * ```typescript
 * const mjrSdk = new ComplianceSDK({
 *   apiKey,
 *   environment: "test",
 *   scope: "MX",
 *   actividadVulnerable: CodigoActividad.MJR,
 * });
 *
 * const client = await mjrSdk.clients.create({
 *   type: ClientType.Person,
 *   name: "Juan García",
 *   rfc: "GAJL850101ABC",
 * });
 *
 * // Returns MexMJRClient
 * ```
 */
export declare class MJRClientsResource extends AVClientsResource {
    readonly legalRepresentatives: RelatedPartySubresource<MexMJRClient, CreateMJRClientInput>;
    readonly controllingBeneficiaries: RelatedPartySubresource<MexMJRClient, CreateMJRClientInput>;
    protected relatedPartyParent(): RelatedPartyParent<MexMJRClient, CreateMJRClientInput>;
    create(data: CreateMJRClientInput): Promise<MexMJRClient>;
    retrieve(id: string, options?: {
        include?: ClientIncludeMap;
        crossScope?: boolean;
    }): Promise<MexMJRClient>;
    retrieveByExternalId(externalId: string, opts?: {
        crossScope?: boolean;
    }): Promise<MexMJRClient>;
    update(id: string, data: UpdateMJRClientInput): Promise<MexMJRClient>;
    /**
     * Lists MJR clients with optional filtering.
     *
     * Accepts flattened MJR filter (MX fields at root level) and automatically
     * transforms to nested format before calling the API.
     */
    list(options?: ListOptions<MJRClientFilter, MJRClientSort> & {
        includePrimaryContacts?: boolean;
        includeNonPrimary?: boolean;
        crossScope?: boolean;
    }): Promise<PaginatedResponse<MexMJRClient>>;
    /**
     * Iterates over MJR clients.
     *
     * Accepts flattened MJR filter (MX fields at root level) and automatically
     * transforms to nested format before calling the API.
     */
    iterate(options?: {
        filter?: MJRClientFilter;
        sort?: MJRClientSort;
        pageSize?: number;
        crossScope?: boolean;
    }): AsyncGenerator<MexMJRClient, void, undefined>;
    /**
     * Counts MJR clients matching the given filter.
     *
     * @param filter - Optional filter criteria (with MJR fields at root level)
     * @returns The count of matching clients
     */
    count(filter?: MJRClientFilter, options?: {
        includeNonPrimary?: boolean;
        crossScope?: boolean;
    }): Promise<number>;
    createMany(clients: CreateMJRClientInput[], options?: {
        atomic?: true;
    }): Promise<AtomicBatchResult<MexMJRClient>>;
    createMany(clients: CreateMJRClientInput[], options: {
        atomic: false;
    }): Promise<PartialBatchResult<MexMJRClient>>;
    updateMany(updates: {
        id: string;
        data: UpdateMJRClientInput;
    }[], options?: {
        atomic?: true;
    }): Promise<AtomicBatchResult<MexMJRClient>>;
    updateMany(updates: {
        id: string;
        data: UpdateMJRClientInput;
    }[], options: {
        atomic: false;
    }): Promise<PartialBatchResult<MexMJRClient>>;
    /**
     * Creates or updates a MJR client by externalId.
     *
     * @param data - Client upsert data with MJR fields at root level (must include externalId)
     * @returns The created or updated client with action indicator
     */
    upsertByExternalId(data: UpsertMJRClientInput): Promise<UpsertResult<MexMJRClient>>;
    /**
     * Creates or updates multiple MJR clients by externalId.
     *
     * @param clients - Array of client 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(clients: UpsertMJRClientInput[], options?: {
        atomic?: true;
    }): Promise<AtomicBatchResult<UpsertResult<MexMJRClient>>>;
    upsertManyByExternalId(clients: UpsertMJRClientInput[], options: {
        atomic: false;
    }): Promise<PartialBatchResult<UpsertResult<MexMJRClient>>>;
    linkClient(parentClientId: string, childClientId: string, relationshipType: ClientRelationshipType, metadata?: Record<string, unknown>): Promise<MexMJRClient>;
    unlinkClient(parentClientId: string, childClientId: string, relationshipType: ClientRelationshipType): Promise<MexMJRClient>;
    listLinkedClients(parentClientId: string, relationshipType?: ClientRelationshipType): Promise<LinkedClient[]>;
    setLinkedClients(parentClientId: string, linkedClients: LinkedClientInput[]): Promise<MexMJRClient>;
    syncAll(clientId: undefined, data: {
        client: CreateMJRClientInput;
        addresses?: SyncItem<CreateMexAddressInput>[];
        contactMethods?: SyncItem<CreateContactMethodInput>[];
        bankAccounts?: SyncItem<CreateBankAccountInput>[];
        documents?: SyncItem<SyncCreateDocumentInput>[];
        linkedClients?: LinkedClientInput[];
    }, options?: {
        replaceMode?: boolean;
    }): Promise<{
        client: MexMJRClient;
        addresses: SyncResult<MexAddress>;
        contactMethods: SyncResult<ContactMethod>;
        bankAccounts: SyncResult<MexBankAccount>;
        documents: SyncResult<Document>;
    }>;
    syncAll(clientId: string, data: {
        client?: UpdateMJRClientInput;
        addresses?: SyncItem<CreateMexAddressInput>[];
        contactMethods?: SyncItem<CreateContactMethodInput>[];
        bankAccounts?: SyncItem<CreateBankAccountInput>[];
        documents?: SyncItem<SyncCreateDocumentInput>[];
        linkedClients?: LinkedClientInput[];
    }, options: {
        replaceMode: true;
    }): Promise<{
        client: MexMJRClient;
        addresses: SyncResult<MexAddress>;
        contactMethods: SyncResult<ContactMethod>;
        bankAccounts: SyncResult<MexBankAccount>;
        documents: SyncResult<Document>;
    }>;
    syncAll(clientId: string, data: {
        client?: UpdateMJRClientInput;
        addresses?: SyncItem<UpdateMexAddressInput>[];
        contactMethods?: SyncItem<UpdateContactMethodInput>[];
        bankAccounts?: SyncItem<UpdateBankAccountInput>[];
        documents?: SyncItem<SyncUpdateDocumentInput>[];
        linkedClients?: LinkedClientInput[];
    }, options?: {
        replaceMode?: boolean;
    }): Promise<{
        client: MexMJRClient;
        addresses: SyncResult<MexAddress>;
        contactMethods: SyncResult<ContactMethod>;
        bankAccounts: SyncResult<MexBankAccount>;
        documents: SyncResult<Document>;
    }>;
    /**
     * Transforms MJR input to nested API format.
     * MJR has no additional fields, but we add the MJR activity marker.
     */
    protected transformToNested(data: CreateMJRClientInput): CreateClientInput;
    /**
     * Transforms flattened MJR update input to nested API format.
     *
     * NOTE: Always includes `actividadVulnerable: { MJR: {} }` even if no
     * MJR-specific fields are provided. This ensures that records touched via
     * the MJR SDK can be filtered by `activityCodes: { in: ["MJR"] }`.
     */
    protected transformUpdateToNested(data: UpdateMJRClientInput): UpdateClientInput;
    protected instantiate(data: ClientData): MexMJRClient;
    /** Materializes a raw payload into a {@link MexMJRClient} (return type narrowed via the `instantiate` override). */
    materialize(data: ClientData): MexMJRClient;
    /**
     * Transforms a flattened MJRClientSort to nested ClientSort format.
     *
     * Maps flattened field names to their full API paths using MJR-specific field mapping.
     */
    protected applyScopeToSort(sort?: MJRClientSort): ClientSort | undefined;
}