import { APIResource } from "../core/resource.js";
import { APIPromise } from "../core/api-promise.js";
import { RequestOptions } from "../internal/request-options.js";
export declare class EndUsers extends APIResource {
    /**
     * Creates an end-user.
     *
     * @example
     * ```ts
     * const endUser = await conductor.endUsers.create({
     *   companyName: 'Acme Inc.',
     *   email: 'alice@acme.com',
     *   sourceId: '12345678-abcd-abcd-example-1234567890ab',
     * });
     * ```
     */
    create(body: EndUserCreateParams, options?: RequestOptions): APIPromise<EndUser>;
    /**
     * Retrieves an end-user object.
     *
     * @example
     * ```ts
     * const endUser = await conductor.endUsers.retrieve(
     *   'end_usr_1234567abcdefg',
     * );
     * ```
     */
    retrieve(id: string, options?: RequestOptions): APIPromise<EndUser>;
    /**
     * Returns a list of your end-users.
     *
     * @example
     * ```ts
     * const endUsers = await conductor.endUsers.list();
     * ```
     */
    list(options?: RequestOptions): APIPromise<EndUserListResponse>;
    /**
     * Permanently deletes an end-user object and all of its connections.
     *
     * @example
     * ```ts
     * const endUser = await conductor.endUsers.delete(
     *   'end_usr_1234567abcdefg',
     * );
     * ```
     */
    delete(id: string, options?: RequestOptions): APIPromise<EndUserDeleteResponse>;
    /**
     * Rare escape hatch for sending raw QuickBooks Desktop qbXML request objects
     * directly. Prefer Conductor's native QuickBooks Desktop endpoints whenever
     * possible: Conductor already exposes more than 250 typed QBD endpoints, covers
     * nearly the entire underlying qbXML API surface, returns all documented response
     * fields in a stable typed JSON shape, and powers Conductor SDK types,
     * documentation, IDE autocomplete, and the API Playground. Use passthrough only
     * when you need one of the few qbXML operations that is not yet available as a
     * native Conductor endpoint, or while testing an unsupported qbXML operation.
     * Known gaps are listed in [Missing QBD types](/api-ref/missing-qbd-types).
     *
     * @example
     * ```ts
     * const response = await conductor.endUsers.passthrough(
     *   'quickbooks_desktop',
     *   {
     *     id: 'end_usr_1234567abcdefg',
     *     qbd_payload: { foo: 'bar' },
     *   },
     * );
     * ```
     */
    passthrough(integrationSlug: 'quickbooks_desktop', params: EndUserPassthroughParams, options?: RequestOptions): APIPromise<EndUserPassthroughResponse>;
}
export interface EndUser {
    /**
     * The unique identifier for this end-user. You must save this value to your
     * database because it is how you identify which of your users to receive your API
     * requests.
     */
    id: string;
    /**
     * The end-user's company name that will be shown elsewhere in Conductor.
     */
    companyName: string;
    /**
     * The date and time when this end-user record was created.
     */
    createdAt: string;
    /**
     * The end-user's email address for identification purposes.
     */
    email: string;
    /**
     * The end-user's integration connections.
     */
    integrationConnections: Array<EndUser.IntegrationConnection>;
    /**
     * The type of object. This value is always `"end_user"`.
     */
    objectType: 'end_user';
    /**
     * The end-user's unique identifier from your system. Maps users between your
     * database and Conductor.
     */
    sourceId: string;
}
export declare namespace EndUser {
    interface IntegrationConnection {
        /**
         * The unique identifier for this integration connection.
         */
        id: string;
        /**
         * The date and time when this integration connection record was created.
         */
        createdAt: string;
        /**
         * The identifier of the third-party platform to integrate.
         */
        integrationSlug: 'quickbooks_desktop';
        /**
         * The date and time of your last API request to this integration connection.
         */
        lastRequestAt: string | null;
        /**
         * The date and time of your last _successful_ API request to this integration
         * connection. A successful request means the integration fully processed and
         * returned a response without any errors end-to-end.
         */
        lastSuccessfulRequestAt: string | null;
        /**
         * The type of object. This value is always `"integration_connection"`.
         */
        objectType: 'integration_connection';
    }
}
export interface EndUserListResponse {
    /**
     * The array of end-users.
     */
    data: Array<EndUser>;
    /**
     * The type of object. This value is always `"list"`.
     */
    objectType: 'list';
    /**
     * The endpoint URL where this list can be accessed.
     */
    url: string;
}
export interface EndUserDeleteResponse {
    /**
     * The ID of the deleted end-user.
     */
    id: string;
    /**
     * Indicates whether the end-user was deleted.
     */
    deleted: boolean;
    /**
     * The type of object. This value is always `"end_user"`.
     */
    objectType: 'end_user';
}
/**
 * The raw response from the integration connection. For QuickBooks Desktop, this
 * is the qbXML response converted to JSON.
 */
export type EndUserPassthroughResponse = {
    [key: string]: unknown;
};
export interface EndUserCreateParams {
    /**
     * The end-user's company name that will be shown elsewhere in Conductor.
     */
    companyName: string;
    /**
     * The end-user's email address for identification purposes. Setting this field
     * will not cause any emails to be sent.
     */
    email: string;
    /**
     * The end-user's unique identifier from your system. Maps users between your
     * database and Conductor. Must be unique for each user. If you have only one user,
     * you may use any string value.
     */
    sourceId: string;
}
export interface EndUserPassthroughParams {
    /**
     * Path param: The ID of the end-user who owns the integration connection.
     */
    id: string;
    /**
     * Body param: The raw qbXML request object to send to the integration connection.
     * For QuickBooks Desktop, use a qbXML request wrapper such as `InvoiceQueryRq` or
     * `CustomerQueryRq`. This body is forwarded directly and does not use Conductor
     * field names.
     */
    qbd_payload: {
        [key: string]: unknown;
    };
}
export declare namespace EndUsers {
    export { type EndUser as EndUser, type EndUserListResponse as EndUserListResponse, type EndUserDeleteResponse as EndUserDeleteResponse, type EndUserPassthroughResponse as EndUserPassthroughResponse, type EndUserCreateParams as EndUserCreateParams, type EndUserPassthroughParams as EndUserPassthroughParams, };
}
//# sourceMappingURL=end-users.d.ts.map