import { HttpTypes } from "@medusajs/types";
import { Client } from "../client.js";
import { ClientHeaders, Config } from "../types.js";
export declare class Auth {
    private client;
    private config;
    constructor(client: Client, config: Config);
    /**
     * This method is used to retrieve a registration JWT token for a user, customer, or custom actor type. It sends a request to the
     * [Retrieve Registration Token API route](https://docs.medusajs.com/api/store#auth_postactor_typeauth_provider_register).
     *
     * Then, it stores the returned token and passes it in the header of subsequent requests. So, you can call the
     * [store.customer.create](https://docs.medusajs.com/resources/references/js-sdk/store/customer#create) method,
     * for example, after calling this method.
     *
     * Learn more in the [JS SDK Authentication](https://docs.medusajs.com/resources/js-sdk/auth/overview) guide.
     *
     * @param actor - The actor type. For example, `user` for admin user, or `customer` for customer.
     * @param method - The authentication provider to use. For example, `emailpass` or `google`.
     * @param payload - The data to pass in the request's body for authentication. When using the `emailpass` provider,
     * you pass the email and password.
     * @returns The JWT token used for registration later.
     *
     * @tags auth
     *
     * @example
     * await sdk.auth.register(
     *   "customer",
     *   "emailpass",
     *   {
     *     email: "customer@gmail.com",
     *     password: "supersecret"
     *   }
     * )
     *
     * // all subsequent requests will use the token in the header
     * const { customer } = await sdk.store.customer.create({
     *   email: "customer@gmail.com",
     *   password: "supersecret"
     * })
     */
    register: (actor: string, method: string, payload: HttpTypes.AdminSignUpWithEmailPassword | Record<string, unknown>) => Promise<string>;
    /**
     * This method retrieves the JWT authenticated token for an admin user, customer, or custom
     * actor type. It sends a request to the [Authenticate API Route](https://docs.medusajs.com/api/admin#auth_postactor_typeauth_provider).
     *
     * ### Third-Party Authentication
     *
     * If the API route returns a `location` property, it means that the authentication requires additional steps,
     * typically in a third-party service. The `location` property is returned so that you
     * can redirect the user to the appropriate page.
     *
     * :::note
     *
     * For an example of implementing third-party authentication, refer to the
     * [Third-Party Login in Storefront](https://docs.medusajs.com/resources/storefront-development/customers/third-party-login) guide.
     *
     * :::
     *
     * ### Session Authentication
     *
     * If the `auth.type` of the SDK is set to `session`, this method will also send a request to the
     * [Set Authentication Session API route](https://docs.medusajs.com/api/admin#auth_postsession).
     *
     * Learn more in the [JS SDK Authentication](https://docs.medusajs.com/resources/js-sdk/auth/overview) guide.
     *
     * ### Automatic Authentication
     *
     * If the authentication was successful, subsequent requests using the SDK will automatically have the necessary authentication headers / session
     * set, based on your JS SDK authentication configurations.
     *
     * Learn more in the [JS SDK Authentication](https://docs.medusajs.com/resources/js-sdk/auth/overview) guide.
     *
     * @param actor - The actor type. For example, `user` for admin user, or `customer` for customer.
     * @param method - The authentication provider to use. For example, `emailpass` or `google`.
     * @param payload - The data to pass in the request's body for authentication. When using the `emailpass` provider,
     * you pass the email and password.
     * @returns The authentication JWT token
     *
     * @tags auth
     *
     * @example
     * const result = await sdk.auth.login(
     *   "customer",
     *   "emailpass",
     *   {
     *     email: "customer@gmail.com",
     *     password: "supersecret"
     *   }
     * )
     *
     * if (typeof result !== "string") {
     *   alert("Authentication requires additional steps")
     *   // replace with the redirect logic of your application
     *   window.location.href = result.location
     *   return
     * }
     *
     * // customer is now authenticated
     * // all subsequent requests will use the token in the header
     * const { customer } = await sdk.store.customer.retrieve()
     */
    login: (actor: string, method: string, payload: HttpTypes.AdminSignInWithEmailPassword | Record<string, unknown>) => Promise<string | {
        location: string;
    }>;
    /**
     * This method is used to validate an Oauth callback from a third-party service, such as Google, for an admin user, customer, or custom actor types.
     * It sends a request to the [Validate Authentication Callback](https://docs.medusajs.com/api/admin#auth_postactor_typeauth_providercallback).
     *
     * The method stores the returned token and passes it in the header of subsequent requests. So, you can call the
     * [store.customer.create](https://docs.medusajs.com/resources/references/js-sdk/store/customer#create) or {@link refresh} methods,
     * for example, after calling this method.
     *
     * Learn more in the [JS SDK Authentication](https://docs.medusajs.com/resources/js-sdk/auth/overview) guide.
     *
     * @param actor - The actor type. For example, `user` for admin user, or `customer` for customer.
     * @param method - The authentication provider to use. For example, `google`.
     * @param query - The query parameters from the Oauth callback, which should be passed to the API route. This includes query parameters like
     * `code` and `state`.
     * @returns The authentication JWT token
     *
     * @tags auth
     *
     * @example
     * await sdk.auth.callback(
     *   "customer",
     *   "google",
     *   {
     *     code: "123",
     *     state: "456"
     *   }
     * )
     *
     * // all subsequent requests will use the token in the header
     * const { customer } = await sdk.store.customer.create({
     *   email: "customer@gmail.com",
     *   password: "supersecret"
     * })
     *
     * @privateRemarks
     * The callback expects all query parameters from the Oauth callback to be passed to
     * the backend, and the provider is in charge of parsing and validating them
     */
    callback: (actor: string, method: string, query?: Record<string, unknown>) => Promise<string>;
    /**
     * This method refreshes a JWT authentication token, which is useful after validating the Oauth callback
     * with {@link callback}. It sends a request to the [Refresh Authentication Token API route](https://docs.medusajs.com/api/admin#auth_postadminauthtokenrefresh).
     *
     * The method stores the returned token and passes it in the header of subsequent requests. So, you can call other
     * methods that require authentication after calling this method.
     *
     * Learn more in the [JS SDK Authentication](https://docs.medusajs.com/resources/js-sdk/auth/overview) guide.
     *
     * For an example of implementing third-party authentication, refer to the
     * [Third-Party Login in Storefront](https://docs.medusajs.com/resources/storefront-development/customers/third-party-login) guide.
     *
     * @param headers - Headers to pass in the request
     *
     * @returns The refreshed JWT authentication token.
     *
     * @tags auth
     *
     * @example
     * const token = await sdk.auth.refresh()
     *
     * // all subsequent requests will use the token in the header
     * const { customer } = await sdk.store.customer.retrieve()
     */
    refresh: (headers?: ClientHeaders) => Promise<string>;
    /**
     * This method logs out the currently authenticated user based on your JS SDK authentication configurations.
     *
     * If the `auth.type` of the SDK is set to `session`, this method will also send a request to the
     * [Delete Authentication Session API route](https://docs.medusajs.com/api/admin#auth_deletesession).
     *
     * The method also clears any stored tokens or sessions, based on your JS SDK authentication configurations.
     *
     * Learn more in the [JS SDK Authentication](https://docs.medusajs.com/resources/js-sdk/auth/overview) guide.
     *
     * @tags auth
     *
     * @example
     * await sdk.auth.logout()
     *
     * // user is now logged out
     * // you can't send any requests that require authentication
     */
    logout: () => Promise<void>;
    /**
     * This method requests a reset password token for an admin user, customer, or custom actor type.
     * It sends a request to the [Generate Reset Password Token API route](https://docs.medusajs.com/api/admin#auth_postactor_typeauth_providerresetpassword).
     *
     * To reset the password later using the token delivered to the user, use the {@link updateProvider} method.
     *
     * Related guide: [How to allow customers to reset their passwords in a storefront](https://docs.medusajs.com/resources/storefront-development/customers/reset-password).
     *
     * @param actor - The actor type. For example, `user` for admin user, or `customer` for customer.
     * @param provider - The authentication provider to use. For example, `emailpass`.
     * @param body - The data required to identify the user.
     *
     * @tags auth
     *
     * @example
     * sdk.auth.resetPassword(
     *   "customer",
     *   "emailpass",
     *   {
     *     identifier: "customer@gmail.com"
     *   }
     * )
     * .then(() => {
     *   // user receives token
     * })
     */
    resetPassword: (actor: string, provider: string, body: {
        /**
         * The user's identifier. For example, when using the `emailpass` provider,
         * this would be the user's email.
         */
        identifier: string;
        /**
         * Optional metadata to include in the reset password request.
         *
         * @since 2.12.4
         */
        metadata?: Record<string, unknown>;
    }) => Promise<void>;
    /**
     * This method is used to update user-related data authentication data.
     *
     * More specifically, use this method when updating the password of an admin user, customer, or
     * custom actor type after requesting to reset their password with {@link resetPassword}.
     *
     * This method sends a request to [this API route](https://docs.medusajs.com/api/admin#auth_postactor_typeauth_providerupdate).
     *
     * Related guide: [How to allow customers to reset their passwords in a storefront](https://docs.medusajs.com/resources/storefront-development/customers/reset-password).
     *
     * @param actor - The actor type. For example, `user` for admin user, or `customer` for customer.
     * @param provider - The authentication provider to use. For example, `emailpass`.
     * @param body - The data necessary to update the user's authentication data. When resetting the user's password,
     * send the `password` property.
     *
     * @tags auth
     *
     * @example
     * sdk.auth.updateProvider(
     *   "customer",
     *   "emailpass",
     *   {
     *     password: "supersecret"
     *   },
     *   token
     * )
     * .then(() => {
     *   // password updated
     * })
     */
    updateProvider: (actor: string, provider: string, body: HttpTypes.AdminUpdateProvider, token: string) => Promise<void>;
    /**
     * @ignore
     */
    private setToken_;
}
//# sourceMappingURL=index.d.ts.map