@ckeditor/ckeditor5-ckbox 39.0.1 → 40.0.0

package/src/ckboxuploadadapter.js

@@ -1,275 +1,275 @@
-/**
- * @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
- */
-/* globals AbortController, FormData, URL, XMLHttpRequest, window */
-/**
- * @module ckbox/ckboxuploadadapter
- */
-import { Plugin } from 'ckeditor5/src/core';
-import { FileRepository } from 'ckeditor5/src/upload';
-import { logError } from 'ckeditor5/src/utils';
-import CKBoxEditing from './ckboxediting';
-import { getImageUrls, getWorkspaceId } from './utils';
-/**
- * A plugin that enables file uploads in CKEditor 5 using the CKBox server–side connector.
- * See the {@glink features/file-management/ckbox CKBox file manager integration} guide to learn how to configure
- * and use this feature as well as find out more about the full integration with the file manager
- * provided by the {@link module:ckbox/ckbox~CKBox} plugin.
- *
- * Check out the {@glink features/images/image-upload/image-upload Image upload overview} guide to learn about
- * other ways to upload images into CKEditor 5.
- */
-export default class CKBoxUploadAdapter extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires() {
-        return ['ImageUploadEditing', 'ImageUploadProgress', FileRepository, CKBoxEditing];
-    }
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'CKBoxUploadAdapter';
-    }
-    /**
-     * @inheritDoc
-     */
-    async afterInit() {
-        const editor = this.editor;
-        const hasConfiguration = !!editor.config.get('ckbox');
-        const isLibraryLoaded = !!window.CKBox;
-        // Editor supports only one upload adapter. Register the CKBox upload adapter (and potentially overwrite other one) only when the
-        // integrator intentionally wants to use the CKBox plugin, i.e. when the `config.ckbox` exists or the CKBox JavaScript library is
-        // loaded.
-        if (!hasConfiguration && !isLibraryLoaded) {
-            return;
-        }
-        const fileRepository = editor.plugins.get(FileRepository);
-        const ckboxEditing = editor.plugins.get(CKBoxEditing);
-        fileRepository.createUploadAdapter = loader => {
-            return new Adapter(loader, ckboxEditing.getToken(), editor);
-        };
-        const shouldInsertDataId = !editor.config.get('ckbox.ignoreDataId');
-        const imageUploadEditing = editor.plugins.get('ImageUploadEditing');
-        // Mark uploaded assets with the `ckboxImageId` attribute. Its value represents an ID in CKBox.
-        if (shouldInsertDataId) {
-            imageUploadEditing.on('uploadComplete', (evt, { imageElement, data }) => {
-                editor.model.change(writer => {
-                    writer.setAttribute('ckboxImageId', data.ckboxImageId, imageElement);
-                });
-            });
-        }
-    }
-}
-/**
- * Upload adapter for CKBox.
- */
-class Adapter {
-    /**
-     * Creates a new adapter instance.
-     */
-    constructor(loader, token, editor) {
-        this.loader = loader;
-        this.token = token;
-        this.editor = editor;
-        this.controller = new AbortController();
-        this.serviceOrigin = editor.config.get('ckbox.serviceOrigin');
-    }
-    /**
-     * The ID of workspace to use.
-     */
-    getWorkspaceId() {
-        const t = this.editor.t;
-        const cannotAccessDefaultWorkspaceError = t('Cannot access default workspace.');
-        const defaultWorkspaceId = this.editor.config.get('ckbox.defaultUploadWorkspaceId');
-        const workspaceId = getWorkspaceId(this.token, defaultWorkspaceId);
-        if (workspaceId == null) {
-            /**
-             * The user is not authorized to access workspace defined in `ckbox.defaultUploadWorkspaceId` configuration.
-             *
-             * @error ckbox-access-default-workspace-error
-             */
-            logError('ckbox-access-default-workspace-error');
-            throw cannotAccessDefaultWorkspaceError;
-        }
-        return workspaceId;
-    }
-    /**
-     * Resolves a promise with an array containing available categories with which the uploaded file can be associated.
-     *
-     * If the API returns limited results, the method will collect all items.
-     */
-    async getAvailableCategories(offset = 0) {
-        const ITEMS_PER_REQUEST = 50;
-        const categoryUrl = new URL('categories', this.serviceOrigin);
-        categoryUrl.searchParams.set('limit', ITEMS_PER_REQUEST.toString());
-        categoryUrl.searchParams.set('offset', offset.toString());
-        categoryUrl.searchParams.set('workspaceId', this.getWorkspaceId());
-        return this._sendHttpRequest({ url: categoryUrl })
-            .then(async (data) => {
-            const remainingItems = data.totalCount - (offset + ITEMS_PER_REQUEST);
-            if (remainingItems > 0) {
-                const offsetItems = await this.getAvailableCategories(offset + ITEMS_PER_REQUEST);
-                return [
-                    ...data.items,
-                    ...offsetItems
-                ];
-            }
-            return data.items;
-        })
-            .catch(() => {
-            this.controller.signal.throwIfAborted();
-            /**
-             * Fetching a list of available categories with which an uploaded file can be associated failed.
-             *
-             * @error ckbox-fetch-category-http-error
-             */
-            logError('ckbox-fetch-category-http-error');
-        });
-    }
-    /**
-     * Resolves a promise with an object containing a category with which the uploaded file is associated or an error code.
-     */
-    async getCategoryIdForFile(file) {
-        const extension = getFileExtension(file.name);
-        const allCategories = await this.getAvailableCategories();
-        // Couldn't fetch all categories. Perhaps the authorization token is invalid.
-        if (!allCategories) {
-            return null;
-        }
-        // The plugin allows defining to which category the uploaded file should be assigned.
-        const defaultCategories = this.editor.config.get('ckbox.defaultUploadCategories');
-        // If a user specifies the plugin configuration, find the first category that accepts the uploaded file.
-        if (defaultCategories) {
-            const userCategory = Object.keys(defaultCategories).find(category => {
-                return defaultCategories[category].find(e => e.toLowerCase() == extension);
-            });
-            // If found, return its ID if the category exists on the server side.
-            if (userCategory) {
-                const serverCategory = allCategories.find(category => category.id === userCategory || category.name === userCategory);
-                if (!serverCategory) {
-                    return null;
-                }
-                return serverCategory.id;
-            }
-        }
-        // Otherwise, find the first category that accepts the uploaded file and returns its ID.
-        const category = allCategories.find(category => category.extensions.find(e => e.toLowerCase() == extension));
-        if (!category) {
-            return null;
-        }
-        return category.id;
-    }
-    /**
-     * Starts the upload process.
-     *
-     * @see module:upload/filerepository~UploadAdapter#upload
-     */
-    async upload() {
-        const t = this.editor.t;
-        const cannotFindCategoryError = t('Cannot determine a category for the uploaded file.');
-        const file = (await this.loader.file);
-        const category = await this.getCategoryIdForFile(file);
-        if (!category) {
-            return Promise.reject(cannotFindCategoryError);
-        }
-        const uploadUrl = new URL('assets', this.serviceOrigin);
-        const formData = new FormData();
-        uploadUrl.searchParams.set('workspaceId', this.getWorkspaceId());
-        formData.append('categoryId', category);
-        formData.append('file', file);
-        const requestConfig = {
-            method: 'POST',
-            url: uploadUrl,
-            data: formData,
-            onUploadProgress: (evt) => {
-                /* istanbul ignore else -- @preserve */
-                if (evt.lengthComputable) {
-                    this.loader.uploadTotal = evt.total;
-                    this.loader.uploaded = evt.loaded;
-                }
-            }
-        };
-        return this._sendHttpRequest(requestConfig)
-            .then(async (data) => {
-            const imageUrls = getImageUrls(data.imageUrls);
-            return {
-                ckboxImageId: data.id,
-                default: imageUrls.imageFallbackUrl,
-                sources: imageUrls.imageSources
-            };
-        })
-            .catch(() => {
-            const genericError = t('Cannot upload file:') + ` ${file.name}.`;
-            return Promise.reject(genericError);
-        });
-    }
-    /**
-     * Aborts the upload process.
-     *
-     * @see module:upload/filerepository~UploadAdapter#abort
-     */
-    abort() {
-        this.controller.abort();
-    }
-    /**
-     * Sends the HTTP request.
-     *
-     * @param config.url the URL where the request will be sent.
-     * @param config.method The HTTP method.
-     * @param config.data Additional data to send.
-     * @param config.onUploadProgress A callback informing about the upload progress.
-     */
-    _sendHttpRequest({ url, method = 'GET', data, onUploadProgress }) {
-        const signal = this.controller.signal;
-        const xhr = new XMLHttpRequest();
-        xhr.open(method, url.toString(), true);
-        xhr.setRequestHeader('Authorization', this.token.value);
-        xhr.setRequestHeader('CKBox-Version', 'CKEditor 5');
-        xhr.responseType = 'json';
-        // The callback is attached to the `signal#abort` event.
-        const abortCallback = () => {
-            xhr.abort();
-        };
-        return new Promise((resolve, reject) => {
-            signal.addEventListener('abort', abortCallback);
-            xhr.addEventListener('loadstart', () => {
-                signal.addEventListener('abort', abortCallback);
-            });
-            xhr.addEventListener('loadend', () => {
-                signal.removeEventListener('abort', abortCallback);
-            });
-            xhr.addEventListener('error', () => {
-                reject();
-            });
-            xhr.addEventListener('abort', () => {
-                reject();
-            });
-            xhr.addEventListener('load', async () => {
-                const response = xhr.response;
-                if (!response || response.statusCode >= 400) {
-                    return reject(response && response.message);
-                }
-                return resolve(response);
-            });
-            /* istanbul ignore else -- @preserve */
-            if (onUploadProgress) {
-                xhr.upload.addEventListener('progress', evt => {
-                    onUploadProgress(evt);
-                });
-            }
-            // Send the request.
-            xhr.send(data);
-        });
-    }
-}
-/**
- * Returns an extension from the given value.
- */
-function getFileExtension(value) {
-    const extensionRegExp = /\.(?<ext>[^.]+)$/;
-    const match = value.match(extensionRegExp);
-    return match.groups.ext.toLowerCase();
-}
+/**
+ * @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
+ */
+/* globals AbortController, FormData, URL, XMLHttpRequest, window */
+/**
+ * @module ckbox/ckboxuploadadapter
+ */
+import { Plugin } from 'ckeditor5/src/core';
+import { FileRepository } from 'ckeditor5/src/upload';
+import { logError } from 'ckeditor5/src/utils';
+import CKBoxEditing from './ckboxediting';
+import { getImageUrls, getWorkspaceId } from './utils';
+/**
+ * A plugin that enables file uploads in CKEditor 5 using the CKBox server–side connector.
+ * See the {@glink features/file-management/ckbox CKBox file manager integration} guide to learn how to configure
+ * and use this feature as well as find out more about the full integration with the file manager
+ * provided by the {@link module:ckbox/ckbox~CKBox} plugin.
+ *
+ * Check out the {@glink features/images/image-upload/image-upload Image upload overview} guide to learn about
+ * other ways to upload images into CKEditor 5.
+ */
+export default class CKBoxUploadAdapter extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return ['ImageUploadEditing', 'ImageUploadProgress', FileRepository, CKBoxEditing];
+    }
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'CKBoxUploadAdapter';
+    }
+    /**
+     * @inheritDoc
+     */
+    async afterInit() {
+        const editor = this.editor;
+        const hasConfiguration = !!editor.config.get('ckbox');
+        const isLibraryLoaded = !!window.CKBox;
+        // Editor supports only one upload adapter. Register the CKBox upload adapter (and potentially overwrite other one) only when the
+        // integrator intentionally wants to use the CKBox plugin, i.e. when the `config.ckbox` exists or the CKBox JavaScript library is
+        // loaded.
+        if (!hasConfiguration && !isLibraryLoaded) {
+            return;
+        }
+        const fileRepository = editor.plugins.get(FileRepository);
+        const ckboxEditing = editor.plugins.get(CKBoxEditing);
+        fileRepository.createUploadAdapter = loader => {
+            return new Adapter(loader, ckboxEditing.getToken(), editor);
+        };
+        const shouldInsertDataId = !editor.config.get('ckbox.ignoreDataId');
+        const imageUploadEditing = editor.plugins.get('ImageUploadEditing');
+        // Mark uploaded assets with the `ckboxImageId` attribute. Its value represents an ID in CKBox.
+        if (shouldInsertDataId) {
+            imageUploadEditing.on('uploadComplete', (evt, { imageElement, data }) => {
+                editor.model.change(writer => {
+                    writer.setAttribute('ckboxImageId', data.ckboxImageId, imageElement);
+                });
+            });
+        }
+    }
+}
+/**
+ * Upload adapter for CKBox.
+ */
+class Adapter {
+    /**
+     * Creates a new adapter instance.
+     */
+    constructor(loader, token, editor) {
+        this.loader = loader;
+        this.token = token;
+        this.editor = editor;
+        this.controller = new AbortController();
+        this.serviceOrigin = editor.config.get('ckbox.serviceOrigin');
+    }
+    /**
+     * The ID of workspace to use.
+     */
+    getWorkspaceId() {
+        const t = this.editor.t;
+        const cannotAccessDefaultWorkspaceError = t('Cannot access default workspace.');
+        const defaultWorkspaceId = this.editor.config.get('ckbox.defaultUploadWorkspaceId');
+        const workspaceId = getWorkspaceId(this.token, defaultWorkspaceId);
+        if (workspaceId == null) {
+            /**
+             * The user is not authorized to access the workspace defined in  the`ckbox.defaultUploadWorkspaceId` configuration.
+             *
+             * @error ckbox-access-default-workspace-error
+             */
+            logError('ckbox-access-default-workspace-error');
+            throw cannotAccessDefaultWorkspaceError;
+        }
+        return workspaceId;
+    }
+    /**
+     * Resolves a promise with an array containing available categories with which the uploaded file can be associated.
+     *
+     * If the API returns limited results, the method will collect all items.
+     */
+    async getAvailableCategories(offset = 0) {
+        const ITEMS_PER_REQUEST = 50;
+        const categoryUrl = new URL('categories', this.serviceOrigin);
+        categoryUrl.searchParams.set('limit', ITEMS_PER_REQUEST.toString());
+        categoryUrl.searchParams.set('offset', offset.toString());
+        categoryUrl.searchParams.set('workspaceId', this.getWorkspaceId());
+        return this._sendHttpRequest({ url: categoryUrl })
+            .then(async (data) => {
+            const remainingItems = data.totalCount - (offset + ITEMS_PER_REQUEST);
+            if (remainingItems > 0) {
+                const offsetItems = await this.getAvailableCategories(offset + ITEMS_PER_REQUEST);
+                return [
+                    ...data.items,
+                    ...offsetItems
+                ];
+            }
+            return data.items;
+        })
+            .catch(() => {
+            this.controller.signal.throwIfAborted();
+            /**
+             * Fetching a list of available categories with which an uploaded file can be associated failed.
+             *
+             * @error ckbox-fetch-category-http-error
+             */
+            logError('ckbox-fetch-category-http-error');
+        });
+    }
+    /**
+     * Resolves a promise with an object containing a category with which the uploaded file is associated or an error code.
+     */
+    async getCategoryIdForFile(file) {
+        const extension = getFileExtension(file.name);
+        const allCategories = await this.getAvailableCategories();
+        // Couldn't fetch all categories. Perhaps the authorization token is invalid.
+        if (!allCategories) {
+            return null;
+        }
+        // The plugin allows defining to which category the uploaded file should be assigned.
+        const defaultCategories = this.editor.config.get('ckbox.defaultUploadCategories');
+        // If a user specifies the plugin configuration, find the first category that accepts the uploaded file.
+        if (defaultCategories) {
+            const userCategory = Object.keys(defaultCategories).find(category => {
+                return defaultCategories[category].find(e => e.toLowerCase() == extension);
+            });
+            // If found, return its ID if the category exists on the server side.
+            if (userCategory) {
+                const serverCategory = allCategories.find(category => category.id === userCategory || category.name === userCategory);
+                if (!serverCategory) {
+                    return null;
+                }
+                return serverCategory.id;
+            }
+        }
+        // Otherwise, find the first category that accepts the uploaded file and returns its ID.
+        const category = allCategories.find(category => category.extensions.find(e => e.toLowerCase() == extension));
+        if (!category) {
+            return null;
+        }
+        return category.id;
+    }
+    /**
+     * Starts the upload process.
+     *
+     * @see module:upload/filerepository~UploadAdapter#upload
+     */
+    async upload() {
+        const t = this.editor.t;
+        const cannotFindCategoryError = t('Cannot determine a category for the uploaded file.');
+        const file = (await this.loader.file);
+        const category = await this.getCategoryIdForFile(file);
+        if (!category) {
+            return Promise.reject(cannotFindCategoryError);
+        }
+        const uploadUrl = new URL('assets', this.serviceOrigin);
+        const formData = new FormData();
+        uploadUrl.searchParams.set('workspaceId', this.getWorkspaceId());
+        formData.append('categoryId', category);
+        formData.append('file', file);
+        const requestConfig = {
+            method: 'POST',
+            url: uploadUrl,
+            data: formData,
+            onUploadProgress: (evt) => {
+                /* istanbul ignore else -- @preserve */
+                if (evt.lengthComputable) {
+                    this.loader.uploadTotal = evt.total;
+                    this.loader.uploaded = evt.loaded;
+                }
+            }
+        };
+        return this._sendHttpRequest(requestConfig)
+            .then(async (data) => {
+            const imageUrls = getImageUrls(data.imageUrls);
+            return {
+                ckboxImageId: data.id,
+                default: imageUrls.imageFallbackUrl,
+                sources: imageUrls.imageSources
+            };
+        })
+            .catch(() => {
+            const genericError = t('Cannot upload file:') + ` ${file.name}.`;
+            return Promise.reject(genericError);
+        });
+    }
+    /**
+     * Aborts the upload process.
+     *
+     * @see module:upload/filerepository~UploadAdapter#abort
+     */
+    abort() {
+        this.controller.abort();
+    }
+    /**
+     * Sends the HTTP request.
+     *
+     * @param config.url the URL where the request will be sent.
+     * @param config.method The HTTP method.
+     * @param config.data Additional data to send.
+     * @param config.onUploadProgress A callback informing about the upload progress.
+     */
+    _sendHttpRequest({ url, method = 'GET', data, onUploadProgress }) {
+        const signal = this.controller.signal;
+        const xhr = new XMLHttpRequest();
+        xhr.open(method, url.toString(), true);
+        xhr.setRequestHeader('Authorization', this.token.value);
+        xhr.setRequestHeader('CKBox-Version', 'CKEditor 5');
+        xhr.responseType = 'json';
+        // The callback is attached to the `signal#abort` event.
+        const abortCallback = () => {
+            xhr.abort();
+        };
+        return new Promise((resolve, reject) => {
+            signal.addEventListener('abort', abortCallback);
+            xhr.addEventListener('loadstart', () => {
+                signal.addEventListener('abort', abortCallback);
+            });
+            xhr.addEventListener('loadend', () => {
+                signal.removeEventListener('abort', abortCallback);
+            });
+            xhr.addEventListener('error', () => {
+                reject();
+            });
+            xhr.addEventListener('abort', () => {
+                reject();
+            });
+            xhr.addEventListener('load', async () => {
+                const response = xhr.response;
+                if (!response || response.statusCode >= 400) {
+                    return reject(response && response.message);
+                }
+                return resolve(response);
+            });
+            /* istanbul ignore else -- @preserve */
+            if (onUploadProgress) {
+                xhr.upload.addEventListener('progress', evt => {
+                    onUploadProgress(evt);
+                });
+            }
+            // Send the request.
+            xhr.send(data);
+        });
+    }
+}
+/**
+ * Returns an extension from the given value.
+ */
+function getFileExtension(value) {
+    const extensionRegExp = /\.(?<ext>[^.]+)$/;
+    const match = value.match(extensionRegExp);
+    return match.groups.ext.toLowerCase();
+}

package/src/index.d.ts

@@ -1,13 +1,13 @@
-/**
- * @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 ckbox
- */
-export { default as CKBox } from './ckbox';
-export { default as CKBoxEditing } from './ckboxediting';
-export { default as CKBoxUI } from './ckboxui';
-export type { default as CKBoxCommand } from './ckboxcommand';
-export type { CKBoxConfig } from './ckboxconfig';
-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 ckbox
+ */
+export { default as CKBox } from './ckbox';
+export { default as CKBoxEditing } from './ckboxediting';
+export { default as CKBoxUI } from './ckboxui';
+export type { default as CKBoxCommand } from './ckboxcommand';
+export type { CKBoxConfig } from './ckboxconfig';
+import './augmentation';

package/src/index.js

@@ -1,11 +1,11 @@
-/**
- * @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 ckbox
- */
-export { default as CKBox } from './ckbox';
-export { default as CKBoxEditing } from './ckboxediting';
-export { default as CKBoxUI } from './ckboxui';
-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 ckbox
+ */
+export { default as CKBox } from './ckbox';
+export { default as CKBoxEditing } from './ckboxediting';
+export { default as CKBoxUI } from './ckboxui';
+import './augmentation';

package/src/utils.d.ts

@@ -1,28 +1,28 @@
-/**
- * @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 ckbox/utils
- */
-import type { InitializedToken } from '@ckeditor/ckeditor5-cloud-services';
-import type { CKBoxImageUrls } from './ckboxconfig';
-/**
- * Converts image source set provided by the CKBox into an object containing:
- * - responsive URLs for the "webp" image format,
- * - one fallback URL for browsers that do not support the "webp" format.
- */
-export declare function getImageUrls(imageUrls: CKBoxImageUrls): {
-    imageFallbackUrl: string;
-    imageSources: Array<{
-        srcset: string;
-        sizes: string;
-        type: string;
-    }>;
-};
-/**
- * Returns workspace id to use for communication with the CKBox service.
- *
- * @param defaultWorkspaceId The default workspace to use taken from editor config.
- */
-export declare function getWorkspaceId(token: InitializedToken, defaultWorkspaceId?: string): string | null;
+/**
+ * @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 ckbox/utils
+ */
+import type { InitializedToken } from '@ckeditor/ckeditor5-cloud-services';
+import type { CKBoxImageUrls } from './ckboxconfig';
+/**
+ * Converts image source set provided by the CKBox into an object containing:
+ * - responsive URLs for the "webp" image format,
+ * - one fallback URL for browsers that do not support the "webp" format.
+ */
+export declare function getImageUrls(imageUrls: CKBoxImageUrls): {
+    imageFallbackUrl: string;
+    imageSources: Array<{
+        srcset: string;
+        sizes: string;
+        type: string;
+    }>;
+};
+/**
+ * Returns a workspace id to use for communication with the CKBox service.
+ *
+ * @param defaultWorkspaceId The default workspace to use taken from editor config.
+ */
+export declare function getWorkspaceId(token: InitializedToken, defaultWorkspaceId?: string): string | null;