@ckeditor/ckeditor5-cloud-services 40.0.0 → 40.2.0

package/src/cloudservicesconfig.d.ts

@@ -1,121 +1,121 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module cloud-services/cloudservicesconfig
- */
-/**
- * Endpoint address to download the token or a callback that provides the token.
- */
-export type TokenUrl = string | (() => Promise<string>);
-/**
- * The configuration for all plugins using CKEditor Cloud Services.
- *
- * ```ts
- * ClassicEditor
- * 	.create( document.querySelector( '#editor' ), {
- * 		cloudServices: {
- * 			tokenUrl: 'https://example.com/cs-token-endpoint',
- * 			uploadUrl: 'https://your-organization-id.cke-cs.com/easyimage/upload/'
- * 		}
- * 	} )
- * 	.then( ... )
- * 	.catch( ... );
- * ```
- *
- * See {@link module:core/editor/editorconfig~EditorConfig all editor options}.
- */
-export interface CloudServicesConfig {
-    /**
-     * A token URL or a token request function.
-     *
-     * As a string, it should be a URL to the security token endpoint in your application.
-     * The role of this endpoint is to securely authorize
-     * the end users of your application to use [CKEditor Cloud Services](https://ckeditor.com/ckeditor-cloud-services) only
-     * if they should have access e.g. to upload files with {@glink @cs guides/easy-image/quick-start Easy Image} or to use the
-     * {@glink @cs guides/collaboration/quick-start Collaboration} service.
-     *
-     * ```ts
-     * ClassicEditor
-     * 	.create( document.querySelector( '#editor' ), {
-     * 		cloudServices: {
-     * 			tokenUrl: 'https://example.com/cs-token-endpoint',
-     * 			...
-     * 		}
-     * 	} )
-     * 	.then( ... )
-     * 	.catch( ... );
-     * ```
-     *
-     * As a function, it should provide a promise to the token value,
-     * so you can highly customize the token and provide your token URL endpoint.
-     * By using this approach you can set your own headers for the request.
-     *
-     * ```ts
-     * ClassicEditor
-     * 	.create( document.querySelector( '#editor' ), {
-     * 		cloudServices: {
-     * 			tokenUrl: () => new Promise( ( resolve, reject ) => {
-     * 				const xhr = new XMLHttpRequest();
-     *
-     * 				xhr.open( 'GET', 'https://example.com/cs-token-endpoint' );
-     *
-     * 				xhr.addEventListener( 'load', () => {
-     * 					const statusCode = xhr.status;
-     * 					const xhrResponse = xhr.response;
-     *
-     * 					if ( statusCode < 200 || statusCode > 299 ) {
-     * 						return reject( new Error( 'Cannot download new token!' ) );
-     * 					}
-     *
-     * 					return resolve( xhrResponse );
-     * 				} );
-     *
-     * 				xhr.addEventListener( 'error', () => reject( new Error( 'Network Error' ) ) );
-     * 				xhr.addEventListener( 'abort', () => reject( new Error( 'Abort' ) ) );
-     *
-     * 				xhr.setRequestHeader( customHeader, customValue );
-     *
-     * 				xhr.send();
-     * 			} ),
-     * 			...
-     * 		}
-     * 	} )
-     * ```
-     *
-     * You can find more information about token endpoints in the
-     * {@glink @cs guides/easy-image/quick-start#create-token-endpoint Cloud Services - Quick start}
-     * and {@glink @cs developer-resources/security/token-endpoint Cloud Services - Token endpoint} documentation.
-     *
-     * Without a properly working token endpoint (token URL) CKEditor plugins will not be able to connect to CKEditor Cloud Services.
-     */
-    tokenUrl?: TokenUrl;
-    /**
-     * The endpoint URL for [CKEditor Cloud Services](https://ckeditor.com/ckeditor-cloud-services) uploads.
-     * This option must be set for Easy Image to work correctly.
-     *
-     * The upload URL is unique for each customer and can be found in the
-     * [CKEditor Ecosystem customer dashboard](https://dashboard.ckeditor.com) after subscribing to the Easy Image service.
-     * To learn how to start using Easy Image, check the {@glink @cs guides/easy-image/quick-start Easy Image - Quick start} documentation.
-     *
-     * Note: Make sure to also set the {@link module:cloud-services/cloudservicesconfig~CloudServicesConfig#tokenUrl} configuration option.
-     */
-    uploadUrl?: string;
-    /**
-     * The URL for web socket communication, used by the `RealTimeCollaborativeEditing` plugin. Every customer (organization in the CKEditor
-     * Ecosystem dashboard) has their own, unique URLs to communicate with CKEditor Cloud Services. The URL can be found in the
-     * CKEditor Ecosystem customer dashboard.
-     *
-     * Note: Unlike most plugins, `RealTimeCollaborativeEditing` is not included in any CKEditor 5 build and needs to be installed manually.
-     * Check [Collaboration overview](https://ckeditor.com/docs/ckeditor5/latest/features/collaboration/overview.html) for more details.
-     */
-    webSocketUrl?: string;
-    /**
-     * An optional parameter used for integration with CKEditor Cloud Services when uploading the editor build to cloud services.
-     *
-     * Whenever the editor build or the configuration changes, this parameter should be set to a new, unique value to differentiate
-     * the new bundle (build + configuration) from the old ones.
-     */
-    bundleVersion?: string;
-}
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module cloud-services/cloudservicesconfig
+ */
+/**
+ * Endpoint address to download the token or a callback that provides the token.
+ */
+export type TokenUrl = string | (() => Promise<string>);
+/**
+ * The configuration for all plugins using CKEditor Cloud Services.
+ *
+ * ```ts
+ * ClassicEditor
+ * 	.create( document.querySelector( '#editor' ), {
+ * 		cloudServices: {
+ * 			tokenUrl: 'https://example.com/cs-token-endpoint',
+ * 			uploadUrl: 'https://your-organization-id.cke-cs.com/easyimage/upload/'
+ * 		}
+ * 	} )
+ * 	.then( ... )
+ * 	.catch( ... );
+ * ```
+ *
+ * See {@link module:core/editor/editorconfig~EditorConfig all editor options}.
+ */
+export interface CloudServicesConfig {
+    /**
+     * A token URL or a token request function.
+     *
+     * As a string, it should be a URL to the security token endpoint in your application.
+     * The role of this endpoint is to securely authorize
+     * the end users of your application to use [CKEditor Cloud Services](https://ckeditor.com/ckeditor-cloud-services) only
+     * if they should have access e.g. to upload files with {@glink features/file-management/ckbox CKBox} or to use the
+     * {@glink @cs guides/collaboration/quick-start Collaboration} service.
+     *
+     * ```ts
+     * ClassicEditor
+     * 	.create( document.querySelector( '#editor' ), {
+     * 		cloudServices: {
+     * 			tokenUrl: 'https://example.com/cs-token-endpoint',
+     * 			...
+     * 		}
+     * 	} )
+     * 	.then( ... )
+     * 	.catch( ... );
+     * ```
+     *
+     * As a function, it should provide a promise to the token value,
+     * so you can highly customize the token and provide your token URL endpoint.
+     * By using this approach you can set your own headers for the request.
+     *
+     * ```ts
+     * ClassicEditor
+     * 	.create( document.querySelector( '#editor' ), {
+     * 		cloudServices: {
+     * 			tokenUrl: () => new Promise( ( resolve, reject ) => {
+     * 				const xhr = new XMLHttpRequest();
+     *
+     * 				xhr.open( 'GET', 'https://example.com/cs-token-endpoint' );
+     *
+     * 				xhr.addEventListener( 'load', () => {
+     * 					const statusCode = xhr.status;
+     * 					const xhrResponse = xhr.response;
+     *
+     * 					if ( statusCode < 200 || statusCode > 299 ) {
+     * 						return reject( new Error( 'Cannot download new token!' ) );
+     * 					}
+     *
+     * 					return resolve( xhrResponse );
+     * 				} );
+     *
+     * 				xhr.addEventListener( 'error', () => reject( new Error( 'Network Error' ) ) );
+     * 				xhr.addEventListener( 'abort', () => reject( new Error( 'Abort' ) ) );
+     *
+     * 				xhr.setRequestHeader( customHeader, customValue );
+     *
+     * 				xhr.send();
+     * 			} ),
+     * 			...
+     * 		}
+     * 	} )
+     * ```
+     *
+     * You can find more information about token endpoints in the
+     * {@glink @cs guides/easy-image/quick-start#create-token-endpoint Cloud Services - Quick start}
+     * and {@glink @cs developer-resources/security/token-endpoint Cloud Services - Token endpoint} documentation.
+     *
+     * Without a properly working token endpoint (token URL) CKEditor plugins will not be able to connect to CKEditor Cloud Services.
+     */
+    tokenUrl?: TokenUrl;
+    /**
+     * The endpoint URL for [CKEditor Cloud Services](https://ckeditor.com/ckeditor-cloud-services) uploads.
+     * This option must be set for Easy Image to work correctly.
+     *
+     * The upload URL is unique for each customer and can be found in the
+     * [CKEditor Ecosystem customer dashboard](https://dashboard.ckeditor.com) after subscribing to the Easy Image service.
+     * To learn how to start using Easy Image, check the {@glink @cs guides/easy-image/quick-start Easy Image - Quick start} documentation.
+     *
+     * Note: Make sure to also set the {@link module:cloud-services/cloudservicesconfig~CloudServicesConfig#tokenUrl} configuration option.
+     */
+    uploadUrl?: string;
+    /**
+     * The URL for web socket communication, used by the `RealTimeCollaborativeEditing` plugin. Every customer (organization in the CKEditor
+     * Ecosystem dashboard) has their own, unique URLs to communicate with CKEditor Cloud Services. The URL can be found in the
+     * CKEditor Ecosystem customer dashboard.
+     *
+     * Note: Unlike most plugins, `RealTimeCollaborativeEditing` is not included in any CKEditor 5 build and needs to be installed manually.
+     * Check [Collaboration overview](https://ckeditor.com/docs/ckeditor5/latest/features/collaboration/overview.html) for more details.
+     */
+    webSocketUrl?: string;
+    /**
+     * An optional parameter used for integration with CKEditor Cloud Services when uploading the editor build to cloud services.
+     *
+     * Whenever the editor build or the configuration changes, this parameter should be set to a new, unique value to differentiate
+     * the new bundle (build + configuration) from the old ones.
+     */
+    bundleVersion?: string;
+}

package/src/cloudservicesconfig.js

@@ -1,5 +1,5 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-export {};
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export {};

package/src/cloudservicescore.d.ts

@@ -1,36 +1,36 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module cloud-services/cloudservicescore
- */
-import { ContextPlugin } from 'ckeditor5/src/core';
-import type { TokenUrl } from './cloudservicesconfig';
-import Token, { type InitializedToken, type TokenOptions } from './token/token';
-import UploadGateway from './uploadgateway/uploadgateway';
-/**
- * The `CloudServicesCore` plugin exposes the base API for communication with CKEditor Cloud Services.
- */
-export default class CloudServicesCore extends ContextPlugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "CloudServicesCore";
-    /**
-     * Creates the {@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.
-     * @param options.initValue Initial value of the token.
-     * @param options.autoRefresh Specifies whether to start the refresh automatically.
-     */
-    createToken(tokenUrlOrRefreshToken: TokenUrl, options?: TokenOptions): Token;
-    /**
-     * Creates the {@link module:cloud-services/uploadgateway/uploadgateway~UploadGateway} instance.
-     *
-     * @param token Token used for authentication.
-     * @param apiAddress API address.
-     */
-    createUploadGateway(token: InitializedToken, apiAddress: string): UploadGateway;
-}
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module cloud-services/cloudservicescore
+ */
+import { ContextPlugin } from 'ckeditor5/src/core';
+import type { TokenUrl } from './cloudservicesconfig';
+import Token, { type InitializedToken, type TokenOptions } from './token/token';
+import UploadGateway from './uploadgateway/uploadgateway';
+/**
+ * The `CloudServicesCore` plugin exposes the base API for communication with CKEditor Cloud Services.
+ */
+export default class CloudServicesCore extends ContextPlugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "CloudServicesCore";
+    /**
+     * Creates the {@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.
+     * @param options.initValue Initial value of the token.
+     * @param options.autoRefresh Specifies whether to start the refresh automatically.
+     */
+    createToken(tokenUrlOrRefreshToken: TokenUrl, options?: TokenOptions): Token;
+    /**
+     * Creates the {@link module:cloud-services/uploadgateway/uploadgateway~UploadGateway} instance.
+     *
+     * @param token Token used for authentication.
+     * @param apiAddress API address.
+     */
+    createUploadGateway(token: InitializedToken, apiAddress: string): UploadGateway;
+}

package/src/cloudservicescore.js

@@ -1,41 +1,41 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module cloud-services/cloudservicescore
- */
-import { ContextPlugin } from 'ckeditor5/src/core';
-import Token from './token/token';
-import UploadGateway from './uploadgateway/uploadgateway';
-/**
- * The `CloudServicesCore` plugin exposes the base API for communication with CKEditor Cloud Services.
- */
-export default class CloudServicesCore extends ContextPlugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'CloudServicesCore';
-    }
-    /**
-     * Creates the {@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.
-     * @param options.initValue Initial value of the token.
-     * @param options.autoRefresh Specifies whether to start the refresh automatically.
-     */
-    createToken(tokenUrlOrRefreshToken, options) {
-        return new Token(tokenUrlOrRefreshToken, options);
-    }
-    /**
-     * Creates the {@link module:cloud-services/uploadgateway/uploadgateway~UploadGateway} instance.
-     *
-     * @param token Token used for authentication.
-     * @param apiAddress API address.
-     */
-    createUploadGateway(token, apiAddress) {
-        return new UploadGateway(token, apiAddress);
-    }
-}
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module cloud-services/cloudservicescore
+ */
+import { ContextPlugin } from 'ckeditor5/src/core';
+import Token from './token/token';
+import UploadGateway from './uploadgateway/uploadgateway';
+/**
+ * The `CloudServicesCore` plugin exposes the base API for communication with CKEditor Cloud Services.
+ */
+export default class CloudServicesCore extends ContextPlugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'CloudServicesCore';
+    }
+    /**
+     * Creates the {@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.
+     * @param options.initValue Initial value of the token.
+     * @param options.autoRefresh Specifies whether to start the refresh automatically.
+     */
+    createToken(tokenUrlOrRefreshToken, options) {
+        return new Token(tokenUrlOrRefreshToken, options);
+    }
+    /**
+     * Creates the {@link module:cloud-services/uploadgateway/uploadgateway~UploadGateway} instance.
+     *
+     * @param token Token used for authentication.
+     * @param apiAddress API address.
+     */
+    createUploadGateway(token, apiAddress) {
+        return new UploadGateway(token, apiAddress);
+    }
+}

package/src/index.d.ts

@@ -1,14 +1,14 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module cloud-services
- */
-export { default as CloudServices } from './cloudservices';
-export { default as CloudServicesCore } from './cloudservicescore';
-export { TokenUrl, type CloudServicesConfig } from './cloudservicesconfig';
-export type { default as Token, InitializedToken } from './token/token';
-export type { default as UploadGateway } from './uploadgateway/uploadgateway';
-export type { default as FileUploader } from './uploadgateway/fileuploader';
-import './augmentation';
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module cloud-services
+ */
+export { default as CloudServices } from './cloudservices';
+export { default as CloudServicesCore } from './cloudservicescore';
+export { TokenUrl, type CloudServicesConfig } from './cloudservicesconfig';
+export type { default as Token, InitializedToken } from './token/token';
+export type { default as UploadGateway } from './uploadgateway/uploadgateway';
+export type { default as FileUploader } from './uploadgateway/fileuploader';
+import './augmentation';

package/src/index.js

@@ -1,10 +1,10 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module cloud-services
- */
-export { default as CloudServices } from './cloudservices';
-export { default as CloudServicesCore } from './cloudservicescore';
-import './augmentation';
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module cloud-services
+ */
+export { default as CloudServices } from './cloudservices';
+export { default as CloudServicesCore } from './cloudservicescore';
+import './augmentation';

package/src/token/token.d.ts

@@ -1,96 +1,96 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-import type { TokenUrl } from '../cloudservicesconfig';
-declare const Token_base: {
-    new (): import("ckeditor5/src/utils").Observable;
-    prototype: import("ckeditor5/src/utils").Observable;
-};
-/**
- * Class representing the token used for communication with CKEditor Cloud Services.
- * Value of the token is retrieving from the specified URL and is refreshed every 1 hour by default.
- */
-export default class Token extends Token_base {
-    /**
-     * 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;
-    private _options;
-    private _tokenRefreshTimeout?;
-    /**
-     * 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?: TokenOptions);
-    /**
-     * Initializes the token.
-     */
-    init(): Promise<InitializedToken>;
-    /**
-     * Refresh token method. Useful in a method form as it can be override in tests.
-     */
-    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?: TokenOptions): Promise<InitializedToken>;
-}
-/**
- * A {@link ~Token} instance that has been initialized.
- */
-export type InitializedToken = Token & {
-    value: string;
-};
-/**
- * Options for creating tokens.
- */
-export interface TokenOptions {
-    /**
-     * Initial value of the token.
-     */
-    initValue?: string;
-    /**
-     * Specifies whether to start the refresh automatically.
-     *
-     * @default true
-     */
-    autoRefresh?: boolean;
-}
-export {};
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import type { TokenUrl } from '../cloudservicesconfig';
+declare const Token_base: {
+    new (): import("ckeditor5/src/utils").Observable;
+    prototype: import("ckeditor5/src/utils").Observable;
+};
+/**
+ * Class representing the token used for communication with CKEditor Cloud Services.
+ * Value of the token is retrieving from the specified URL and is refreshed every 1 hour by default.
+ */
+export default class Token extends Token_base {
+    /**
+     * 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;
+    private _options;
+    private _tokenRefreshTimeout?;
+    /**
+     * 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?: TokenOptions);
+    /**
+     * Initializes the token.
+     */
+    init(): Promise<InitializedToken>;
+    /**
+     * Refresh token method. Useful in a method form as it can be override in tests.
+     */
+    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?: TokenOptions): Promise<InitializedToken>;
+}
+/**
+ * A {@link ~Token} instance that has been initialized.
+ */
+export type InitializedToken = Token & {
+    value: string;
+};
+/**
+ * Options for creating tokens.
+ */
+export interface TokenOptions {
+    /**
+     * Initial value of the token.
+     */
+    initValue?: string;
+    /**
+     * Specifies whether to start the refresh automatically.
+     *
+     * @default true
+     */
+    autoRefresh?: boolean;
+}
+export {};