/**
* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
*/
/**
* @module cloud-services/token/token
*/
import { type ObservableMixinConstructor } from "@ckeditor/ckeditor5-utils";
import type { TokenUrl } from "../cloudservicesconfig.js";
declare const TokenBase: ObservableMixinConstructor;
/**
* The class representing the token used for communication with CKEditor Cloud Services.
* The value of the token is retrieved from the specified URL and refreshed every 1 hour by default.
* If the token retrieval fails, the token will automatically retry in 5 seconds intervals.
*/
export declare class Token extends TokenBase {
	/**
	* Value of the token.
	* The value of the token is undefined if `initValue` is not provided or `init` method was not called.
	* `create` method creates token with initialized value from url.
	*
	* @see module:cloud-services/token/token~InitializedToken
	* @observable
	* @readonly
	*/
	value: string | undefined;
	/**
	* Base refreshing function.
	*/
	private _refresh;
	/**
	* Cached token options.
	*/
	private _options;
	/**
	* `setTimeout()` id for a token refresh when {@link module:cloud-services/token/token~CloudServicesTokenOptions auto refresh}
	* is enabled.
	*/
	private _tokenRefreshTimeout?;
	/**
	* Flag indicating whether the token has been destroyed.
	*/
	private _isDestroyed;
	/**
	* Creates `Token` instance.
	* Method `init` should be called after using the constructor or use `create` method instead.
	*
	* @param tokenUrlOrRefreshToken Endpoint address to download the token or a callback that provides the token. If the
	* value is a function it has to match the {@link module:cloud-services/token/token~Token#refreshToken} interface.
	*/
	constructor(tokenUrlOrRefreshToken: TokenUrl, options?: CloudServicesTokenOptions);
	/**
	* Initializes the token.
	*/
	init(): Promise<InitializedToken>;
	/**
	* Refresh token method. Useful in a method form as it can be overridden in tests.
	*
	* This method will be invoked periodically based on the token expiry date after first call to keep the token up-to-date
	* (requires {@link module:cloud-services/token/token~CloudServicesTokenOptions auto refresh option} to be set).
	*
	* If the token refresh fails, the method will retry in 5 seconds intervals until success or the token gets
	* {@link #destroy destroyed}.
	*/
	refreshToken(): Promise<InitializedToken>;
	/**
	* Destroys token instance. Stops refreshing.
	*/
	destroy(): void;
	/**
	* Checks whether the provided token follows the JSON Web Tokens (JWT) format.
	*
	* @param tokenValue The token to validate.
	*/
	private _validateTokenValue;
	/**
	* Registers a refresh token timeout for the time taken from token.
	*/
	private _registerRefreshTokenTimeout;
	/**
	* Returns token refresh timeout time calculated from expire time in the token payload.
	*
	* If the token parse fails or the token payload doesn't contain, the default DEFAULT_TOKEN_REFRESH_TIMEOUT_TIME is returned.
	*/
	private _getTokenRefreshTimeoutTime;
	/**
	* Creates a initialized {@link module:cloud-services/token/token~Token} instance.
	*
	* @param tokenUrlOrRefreshToken Endpoint address to download the token or a callback that provides the token. If the
	* value is a function it has to match the {@link module:cloud-services/token/token~Token#refreshToken} interface.
	*/
	static create(tokenUrlOrRefreshToken: TokenUrl, options?: CloudServicesTokenOptions): Promise<InitializedToken>;
}
/**
* A {@link ~Token} instance that has been initialized.
*/
export type InitializedToken = Token & {
	value: string;
};
/**
* Options for creating tokens.
*/
export interface CloudServicesTokenOptions {
	/**
	* Initial value of the token.
	*/
	initValue?: string;
	/**
	* Specifies whether to start the refresh automatically.
	*
	* @default true
	*/
	autoRefresh?: boolean;
}
export {};