import { APIResource } from "../core/resource.mjs";
import { APIPromise } from "../core/api-promise.mjs";
import { DefaultPagination, type DefaultPaginationParams, PagePromise } from "../core/pagination.mjs";
import { RequestOptions } from "../internal/request-options.mjs";
/**
 * Endpoints to programmatically manage API tokens
 */
export declare class Tokens extends APIResource {
    /**
     * Create a new API token to access the Grid APIs.
     *
     * @example
     * ```ts
     * const apiToken = await client.tokens.create({
     *   name: 'Sandbox read-only',
     *   permissions: ['VIEW'],
     * });
     * ```
     */
    create(body: TokenCreateParams, options?: RequestOptions): APIPromise<APIToken>;
    /**
     * Retrieve an API token by their system-generated ID
     *
     * @example
     * ```ts
     * const apiToken = await client.tokens.retrieve('tokenId');
     * ```
     */
    retrieve(tokenID: string, options?: RequestOptions): APIPromise<APIToken>;
    /**
     * Retrieve a list of API tokens with optional filtering parameters. Returns all
     * tokens that match the specified filters. If no filters are provided, returns all
     * tokens (paginated).
     *
     * @example
     * ```ts
     * // Automatically fetches more pages as needed.
     * for await (const apiToken of client.tokens.list()) {
     *   // ...
     * }
     * ```
     */
    list(query?: TokenListParams | null | undefined, options?: RequestOptions): PagePromise<APITokensDefaultPagination, APIToken>;
    /**
     * Delete an API token by their system-generated ID
     *
     * @example
     * ```ts
     * await client.tokens.delete('tokenId');
     * ```
     */
    delete(tokenID: string, options?: RequestOptions): APIPromise<void>;
}
export type APITokensDefaultPagination = DefaultPagination<APIToken>;
export interface APIToken {
    /**
     * System-generated unique identifier
     */
    id: string;
    /**
     * An opaque identifier that should be used as a client_id (or username) in the
     * HTTP Basic Authentication scheme when issuing http requests to Grid.
     */
    clientId: string;
    /**
     * Creation timestamp
     */
    createdAt: string;
    /**
     * Name of the token
     */
    name: string;
    /**
     * A list of permissions granted to the token
     */
    permissions: Array<Permission>;
    /**
     * Last update timestamp
     */
    updatedAt: string;
    /**
     * The secret that should be used to authenticate against Grid API. This secret is
     * not stored and will never be available again after creation. Platform must keep
     * this secret secure as it grants access to the account.
     */
    clientSecret?: string;
}
/**
 * Permission of an API token that determines what actions the token can perform:
 * VIEW: Can view all data, including platform config, customers and transactions
 * TRANSACT: Can send payments MANAGE: Can manage platform config, api tokens and
 * customers
 */
export type Permission = 'VIEW' | 'TRANSACT' | 'MANAGE';
export interface TokenCreateParams {
    /**
     * Name of the token to help identify it
     */
    name: string;
    /**
     * A list of permissions to grant to the token
     */
    permissions: Array<Permission>;
}
export interface TokenListParams extends DefaultPaginationParams {
    /**
     * Filter customers created after this timestamp (inclusive)
     */
    createdAfter?: string;
    /**
     * Filter customers created before this timestamp (inclusive)
     */
    createdBefore?: string;
    /**
     * Maximum number of results to return (default 20, max 100)
     */
    limit?: number;
    /**
     * Filter by name of the token
     */
    name?: string;
    /**
     * Filter customers updated after this timestamp (inclusive)
     */
    updatedAfter?: string;
    /**
     * Filter customers updated before this timestamp (inclusive)
     */
    updatedBefore?: string;
}
export declare namespace Tokens {
    export { type APIToken as APIToken, type Permission as Permission, type APITokensDefaultPagination as APITokensDefaultPagination, type TokenCreateParams as TokenCreateParams, type TokenListParams as TokenListParams, };
}
//# sourceMappingURL=tokens.d.mts.map