@datalayer/jupyter-react 1.1.8 → 1.2.0

package/lib/jupyter/lite/kernel/kernels.js

@@ -0,0 +1,218 @@
+import { PageConfig, URLExt } from '@jupyterlab/coreutils';
+import { ObservableMap } from '@jupyterlab/observables';
+import { KernelAPI } from '@jupyterlab/services';
+import { deserialize, serialize, } from '@jupyterlab/services/lib/kernel/serialize';
+import { supportedKernelWebSocketProtocols } from '@jupyterlab/services/lib/kernel/messages';
+import { UUID } from '@lumino/coreutils';
+import { Signal } from '@lumino/signaling';
+import { Mutex } from 'async-mutex';
+import { Server as WebSocketServer, } from 'mock-socket';
+/**
+ * Use the default kernel wire protocol.
+ */
+const KERNEL_WEBSOCKET_PROTOCOL = supportedKernelWebSocketProtocols.v1KernelWebsocketJupyterOrg;
+/**
+ * A class to handle requests to /api/kernels
+ */
+export class Kernels {
+    /**
+     * Construct a new Kernels
+     *
+     * @param options The instantiation options
+     */
+    constructor(options) {
+        const { kernelspecs } = options;
+        this._kernelspecs = kernelspecs;
+        // Forward the changed signal from _kernels
+        this._kernels.changed.connect((_, args) => {
+            this._changed.emit(args);
+        });
+    }
+    /**
+     * Signal emitted when the kernels map changes
+     */
+    get changed() {
+        return this._changed;
+    }
+    /**
+     * Start a new kernel.
+     *
+     * @param options The kernel start options.
+     */
+    async startNew(options) {
+        const { id, name, location } = options;
+        const factory = this._kernelspecs.factories.get(name);
+        // bail if there is no factory associated with the requested kernel
+        if (!factory) {
+            console.error('No factory associated with', name, this._kernelspecs.factories);
+            return { id, name };
+        }
+        // create a synchronization mechanism to allow only one message
+        // to be processed at a time
+        const mutex = new Mutex();
+        // hook a new client to a kernel
+        const hook = (kernelId, clientId, socket) => {
+            const kernel = this._kernels.get(kernelId);
+            if (!kernel) {
+                throw Error(`No kernel ${kernelId}`);
+            }
+            this._clients.set(clientId, socket);
+            this._kernelClients.get(kernelId)?.add(clientId);
+            const processMsg = async (msg) => {
+                await mutex.runExclusive(async () => {
+                    await kernel.ready;
+                    await kernel.handleMessage(msg);
+                });
+            };
+            socket.on('message', async (message) => {
+                let msg;
+                if (message instanceof ArrayBuffer) {
+                    message = new Uint8Array(message).buffer;
+                    msg = deserialize(message, KERNEL_WEBSOCKET_PROTOCOL);
+                }
+                else if (typeof message === 'string') {
+                    const encoder = new TextEncoder();
+                    const encodedData = encoder.encode(message);
+                    msg = deserialize(encodedData.buffer, KERNEL_WEBSOCKET_PROTOCOL);
+                }
+                else {
+                    return;
+                }
+                // TODO Find a better solution for this?
+                // input-reply is asynchronous, must not be processed like other messages
+                if (msg.header.msg_type === 'input_reply') {
+                    kernel.handleMessage(msg);
+                }
+                else {
+                    void processMsg(msg);
+                }
+            });
+            const removeClient = () => {
+                this._clients.delete(clientId);
+                this._kernelClients.get(kernelId)?.delete(clientId);
+            };
+            kernel.disposed.connect(removeClient);
+            socket.onclose = removeClient;
+        };
+        // ensure kernel id
+        const kernelId = id ?? UUID.uuid4();
+        // There is one server per kernel which handles multiple clients
+        const kernelUrl = URLExt.join(Kernels.WS_BASE_URL, KernelAPI.KERNEL_SERVICE_URL, encodeURIComponent(kernelId), 'channels');
+        const runningKernel = this._kernels.get(kernelId);
+        if (runningKernel) {
+            return {
+                id: runningKernel.id,
+                name: runningKernel.name,
+            };
+        }
+        // start the kernel
+        const sendMessage = (msg) => {
+            const clientId = msg.header.session;
+            const socket = this._clients.get(clientId);
+            if (!socket) {
+                console.warn(`Trying to send message on removed socket for kernel ${kernelId}`);
+                return;
+            }
+            const message = serialize(msg, KERNEL_WEBSOCKET_PROTOCOL);
+            // process iopub messages
+            if (msg.channel === 'iopub') {
+                const clients = this._kernelClients.get(kernelId);
+                clients?.forEach(id => {
+                    this._clients.get(id)?.send(message);
+                });
+                return;
+            }
+            socket.send(message);
+        };
+        const kernel = await factory({
+            id: kernelId,
+            sendMessage,
+            name,
+            location,
+        });
+        this._kernels.set(kernelId, kernel);
+        this._kernelClients.set(kernelId, new Set());
+        // create the websocket server for the kernel
+        const wsServer = new WebSocketServer(kernelUrl, {
+            mock: false,
+            selectProtocol: () => KERNEL_WEBSOCKET_PROTOCOL,
+        });
+        wsServer.on('connection', (socket) => {
+            const url = new URL(socket.url);
+            const clientId = url.searchParams.get('session_id') ?? '';
+            hook(kernelId, clientId, socket);
+        });
+        // clean up closed connection
+        wsServer.on('close', () => {
+            this._clients.keys().forEach(clientId => {
+                const socket = this._clients.get(clientId);
+                if (socket?.readyState === WebSocket.CLOSED) {
+                    this._clients.delete(clientId);
+                    this._kernelClients.get(kernelId)?.delete(clientId);
+                }
+            });
+        });
+        // cleanup on kernel shutdown
+        kernel.disposed.connect(() => {
+            wsServer.close();
+            this._kernels.delete(kernelId);
+            this._kernelClients.delete(kernelId);
+        });
+        return {
+            id: kernel.id,
+            name: kernel.name,
+        };
+    }
+    /**
+     * Restart a kernel.
+     *
+     * @param kernelId The kernel id.
+     */
+    async restart(kernelId) {
+        const kernel = this._kernels.get(kernelId);
+        if (!kernel) {
+            throw Error(`Kernel ${kernelId} does not exist`);
+        }
+        const { id, name, location } = kernel;
+        kernel.dispose();
+        return this.startNew({ id, name, location });
+    }
+    /**
+     * List the running kernels.
+     */
+    async list() {
+        return [...this._kernels.values()].map(kernel => ({
+            id: kernel.id,
+            name: kernel.name,
+        }));
+    }
+    /**
+     * Shut down a kernel.
+     *
+     * @param id The kernel id.
+     */
+    async shutdown(id) {
+        this._kernels.delete(id)?.dispose();
+    }
+    /**
+     * Get a kernel by id
+     */
+    async get(id) {
+        return this._kernels.get(id);
+    }
+    _kernels = new ObservableMap();
+    _clients = new ObservableMap();
+    _kernelClients = new ObservableMap();
+    _kernelspecs;
+    _changed = new Signal(this);
+}
+/**
+ * A namespace for Kernels statics.
+ */
+(function (Kernels) {
+    /**
+     * The base url for the Kernels manager
+     */
+    Kernels.WS_BASE_URL = PageConfig.getBaseUrl().replace(/^http/, 'ws');
+})(Kernels || (Kernels = {}));
+//# sourceMappingURL=kernels.js.map

package/lib/jupyter/lite/kernel/kernels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernels.js","sourceRoot":"","sources":["../../../../src/jupyter/lite/kernel/kernels.ts"],"names":[],"mappings":"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"}

package/lib/jupyter/lite/kernel/kernelspecs.d.ts

@@ -0,0 +1,53 @@
+import { KernelSpec } from '@jupyterlab/services';
+import { IKernel, IKernelSpecs } from './tokens';
+/**
+ * A class to handle requests to /api/kernelspecs
+ */
+export declare class KernelSpecs implements IKernelSpecs {
+    /**
+     * Get the kernel specs.
+     */
+    get specs(): KernelSpec.ISpecModels | null;
+    /**
+     * Get the default kernel name.
+     */
+    get defaultKernelName(): string;
+    /**
+     * Get the kernel factories for the current kernels.
+     */
+    get factories(): KernelSpecs.KernelFactories;
+    /**
+     * Register a new kernel.
+     *
+     * @param options The options to register a new kernel.
+     */
+    register(options: KernelSpecs.IKernelOptions): void;
+    private _specs;
+    private _factories;
+}
+/**
+ * A namespace for KernelSpecs statics.
+ */
+export declare namespace KernelSpecs {
+    /**
+     * Registration options for a new kernel.
+     */
+    interface IKernelOptions {
+        /**
+         * The kernel spec.
+         */
+        spec: KernelSpec.ISpecModel;
+        /**
+         * The factory function to instantiate a new kernel.
+         */
+        create: KernelFactory;
+    }
+    /**
+     * The type for a kernel factory function used to instantiate new kernels.
+     */
+    type KernelFactory = (options: IKernel.IOptions) => Promise<IKernel>;
+    /**
+     * The type for the record of kernel factory functions.
+     */
+    type KernelFactories = Map<string, KernelFactory>;
+}

package/lib/jupyter/lite/kernel/kernelspecs.js

@@ -0,0 +1,50 @@
+import { PageConfig } from '@jupyterlab/coreutils';
+import { FALLBACK_KERNEL } from './tokens';
+/**
+ * A class to handle requests to /api/kernelspecs
+ */
+export class KernelSpecs {
+    /**
+     * Get the kernel specs.
+     */
+    get specs() {
+        if (this._specs.size === 0) {
+            return null;
+        }
+        return {
+            default: this.defaultKernelName,
+            kernelspecs: Object.fromEntries(this._specs),
+        };
+    }
+    /**
+     * Get the default kernel name.
+     */
+    get defaultKernelName() {
+        let defaultKernelName = PageConfig.getOption('defaultKernelName');
+        if (!defaultKernelName && this._specs.size) {
+            const keys = Array.from(this._specs.keys());
+            keys.sort();
+            defaultKernelName = keys[0];
+        }
+        return defaultKernelName || FALLBACK_KERNEL;
+    }
+    /**
+     * Get the kernel factories for the current kernels.
+     */
+    get factories() {
+        return this._factories;
+    }
+    /**
+     * Register a new kernel.
+     *
+     * @param options The options to register a new kernel.
+     */
+    register(options) {
+        const { spec, create } = options;
+        this._specs.set(spec.name, spec);
+        this._factories.set(spec.name, create);
+    }
+    _specs = new Map();
+    _factories = new Map();
+}
+//# sourceMappingURL=kernelspecs.js.map

package/lib/jupyter/lite/kernel/kernelspecs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernelspecs.js","sourceRoot":"","sources":["../../../../src/jupyter/lite/kernel/kernelspecs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAyB,eAAe,EAAE,MAAM,UAAU,CAAC;AAElE;;GAEG;AACH,MAAM,OAAO,WAAW;IACtB;;OAEG;IACH,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,iBAAiB;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;SAC7C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,iBAAiB;QACnB,IAAI,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAElE,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,iBAAiB,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,iBAAiB,IAAI,eAAe,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,OAAmC;QAC1C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAEO,MAAM,GAAG,IAAI,GAAG,EAAiC,CAAC;IAClD,UAAU,GAAG,IAAI,GAAG,EAAqC,CAAC;CACnE"}

package/lib/jupyter/lite/kernel/tokens.d.ts

@@ -0,0 +1,171 @@
+import type { Remote } from 'comlink';
+import { IObservableMap } from '@jupyterlab/observables';
+import { Kernel, KernelMessage, KernelSpec } from '@jupyterlab/services';
+import { Token } from '@lumino/coreutils';
+import { IObservableDisposable } from '@lumino/disposable';
+import { ISignal } from '@lumino/signaling';
+import { Kernels } from './kernels';
+import { KernelSpecs } from './kernelspecs';
+/**
+ * The token for the kernels service.
+ */
+export declare const IKernels: Token<IKernels>;
+/**
+ * The kernel name of last resort.
+ */
+export declare const FALLBACK_KERNEL = "javascript";
+/**
+ * An interface for the Kernels service.
+ */
+export interface IKernels {
+    /**
+     * Signal emitted when the kernels map changes
+     */
+    readonly changed: ISignal<IKernels, IObservableMap.IChangedArgs<IKernel>>;
+    /**
+     * Start a new kernel.
+     *
+     * @param options The kernel startup options.
+     */
+    startNew: (options: Kernels.IKernelOptions) => Promise<Kernel.IModel>;
+    /**
+     * Restart a kernel.
+     *
+     * @param id The kernel id.
+     */
+    restart: (id: string) => Promise<Kernel.IModel>;
+    /**
+     * List the running kernels.
+     */
+    list: () => Promise<Kernel.IModel[]>;
+    /**
+     * Shut down a kernel.
+     *
+     * @param id The kernel id.
+     */
+    shutdown: (id: string) => Promise<void>;
+    /**
+     * Get a kernel by id
+     *
+     * @param id The kernel id.
+     * @returns the kernel if it exists, undefined otherwise.
+     */
+    get(id: string): Promise<IKernel | undefined>;
+}
+/**
+ * An interface for a kernel running in the browser.
+ */
+export interface IKernel extends IObservableDisposable {
+    /**
+     * The id of the server-side kernel.
+     */
+    readonly id: string;
+    /**
+     * The name of the server-side kernel.
+     */
+    readonly name: string;
+    /**
+     * The location in the virtual filesystem from which the kernel was started.
+     */
+    readonly location: string;
+    /**
+     * A promise that is fulfilled when the kernel is ready.
+     */
+    readonly ready: Promise<void>;
+    /**
+     * Handle an incoming message from the client.
+     *
+     * @param msg The message to handle
+     */
+    handleMessage(msg: KernelMessage.IMessage): Promise<void>;
+}
+/**
+ * A namespace for IKernel statics.
+ */
+export declare namespace IKernel {
+    /**
+     * The type for the send message function.
+     */
+    type SendMessage = (msg: KernelMessage.IMessage) => void;
+    /**
+     * The instantiation options for an IKernel.
+     */
+    interface IOptions {
+        /**
+         * The kernel id.
+         */
+        id: string;
+        /**
+         * The name of the kernel.
+         */
+        name: string;
+        /**
+         * The location in the virtual filesystem from which the kernel was started.
+         */
+        location: string;
+        /**
+         * The method to send messages back to the server.
+         */
+        sendMessage: SendMessage;
+    }
+}
+/**
+ * The token for the kernel spec service.
+ */
+export declare const IKernelSpecs: Token<IKernelSpecs>;
+/**
+ * The interface for the kernel specs service.
+ */
+export interface IKernelSpecs {
+    /**
+     * Get the kernel specs.
+     */
+    readonly specs: KernelSpec.ISpecModels | null;
+    /**
+     * Get the default kernel name.
+     */
+    readonly defaultKernelName: string;
+    /**
+     * Get the kernel factories for the current kernels.
+     */
+    readonly factories: KernelSpecs.KernelFactories;
+    /**
+     * Register a new kernel spec
+     *
+     * @param options The kernel spec options.
+     */
+    register: (options: KernelSpecs.IKernelOptions) => void;
+}
+/**
+ * An interface for a comlink-based worker kernel
+ */
+export interface IWorkerKernel {
+    /**
+     * Handle any lazy setup activities.
+     */
+    initialize(options: IWorkerKernel.IOptions): Promise<void>;
+    execute(content: KernelMessage.IExecuteRequestMsg['content'], parent: any): Promise<KernelMessage.IExecuteReplyMsg['content']>;
+    complete(content: KernelMessage.ICompleteRequestMsg['content'], parent: any): Promise<KernelMessage.ICompleteReplyMsg['content']>;
+    inspect(content: KernelMessage.IInspectRequestMsg['content'], parent: any): Promise<KernelMessage.IInspectReplyMsg['content']>;
+    isComplete(content: KernelMessage.IIsCompleteRequestMsg['content'], parent: any): Promise<KernelMessage.IIsCompleteReplyMsg['content']>;
+    commInfo(content: KernelMessage.ICommInfoRequestMsg['content'], parent: any): Promise<KernelMessage.ICommInfoReplyMsg['content']>;
+    commOpen(content: KernelMessage.ICommOpenMsg, parent: any): Promise<void>;
+    commMsg(content: KernelMessage.ICommMsgMsg, parent: any): Promise<void>;
+    commClose(content: KernelMessage.ICommCloseMsg, parent: any): Promise<void>;
+    inputReply(content: KernelMessage.IInputReplyMsg['content'], parent: any): Promise<void>;
+}
+/**
+ * A namespace for worker kernels.
+ **/
+export declare namespace IWorkerKernel {
+    /**
+     * Common values likely to be required by all kernels.
+     */
+    interface IOptions {
+        /**
+         * The base URL of the kernel server.
+         */
+        baseUrl: string;
+    }
+}
+export type IRemoteKernel = Remote<IWorkerKernel>;

package/lib/jupyter/lite/kernel/tokens.js

@@ -0,0 +1,16 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+import { Token } from '@lumino/coreutils';
+/**
+ * The token for the kernels service.
+ */
+export const IKernels = new Token('@jupyterlite/kernel:IKernels');
+/**
+ * The kernel name of last resort.
+ */
+export const FALLBACK_KERNEL = 'javascript';
+/**
+ * The token for the kernel spec service.
+ */
+export const IKernelSpecs = new Token('@jupyterlite/kernel:IKernelSpecs');
+//# sourceMappingURL=tokens.js.map

package/lib/jupyter/lite/kernel/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../../src/jupyter/lite/kernel/tokens.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAQ3D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAU1C;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAW,8BAA8B,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAiH5C;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,KAAK,CACnC,kCAAkC,CACnC,CAAC"}

package/lib/jupyter/lite/licenses/index.d.ts

@@ -0,0 +1,2 @@
+export * from './licenses';
+export * from './tokens';

package/lib/jupyter/lite/licenses/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+export * from './licenses';
+export * from './tokens';
+//# sourceMappingURL=index.js.map

package/lib/jupyter/lite/licenses/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/jupyter/lite/licenses/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAE3D,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/lib/jupyter/lite/licenses/licenses.d.ts

@@ -0,0 +1,35 @@
+import { IFederatedExtension } from '../types';
+import { ILicenseBundle, ILicenseBundles, ILicenseResponse, ILicenses } from './tokens';
+/**
+ * A JupyterLite implementation of the jupyterlab_server licenses route
+ */
+export declare class Licenses implements ILicenses {
+    /**
+     * A GET handler for the licenses
+     */
+    get(): Promise<ILicenseResponse>;
+    /**
+     * Get the app name (or default).
+     */
+    protected get appName(): string;
+    /**
+     * Get the well-known URL of the app licenses.
+     */
+    protected get appLicensesUrl(): string;
+    /**
+     * Get the lab extension base url.
+     */
+    protected get labExtensionsUrl(): string;
+    /**
+     * Resolve the licenses for the app distribution itself, or the empty bundle.
+     */
+    _getAppLicenses(): Promise<ILicenseBundle>;
+    /**
+     * Resolve the licenses for all federated extensions.
+     */
+    _getFederated(): Promise<ILicenseBundles>;
+    /**
+     * Update the bundles with the extension's licenses, or the empty bundle.
+     */
+    _getOneFederated(ext: IFederatedExtension, bundles: ILicenseBundles): Promise<void>;
+}

package/lib/jupyter/lite/licenses/licenses.js

@@ -0,0 +1,95 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+import { URLExt, PageConfig } from '@jupyterlab/coreutils';
+import { THIRD_PARTY_LICENSES, } from './tokens';
+/**
+ * An empty bundle.
+ */
+const EMPTY_BUNDLE = Object.freeze({ packages: [] });
+/**
+ * A JupyterLite implementation of the jupyterlab_server licenses route
+ */
+export class Licenses {
+    /**
+     * A GET handler for the licenses
+     */
+    async get() {
+        return {
+            bundles: {
+                ...(await this._getFederated()),
+                [this.appName]: await this._getAppLicenses(),
+            },
+        };
+    }
+    /**
+     * Get the app name (or default).
+     */
+    get appName() {
+        return PageConfig.getOption('appName') || 'JupyterLite';
+    }
+    /**
+     * Get the well-known URL of the app licenses.
+     */
+    get appLicensesUrl() {
+        return URLExt.join(PageConfig.getBaseUrl(), 'build', THIRD_PARTY_LICENSES);
+    }
+    /**
+     * Get the lab extension base url.
+     */
+    get labExtensionsUrl() {
+        return PageConfig.getOption('fullLabextensionsUrl');
+    }
+    /**
+     * Resolve the licenses for the app distribution itself, or the empty bundle.
+     */
+    async _getAppLicenses() {
+        let bundle = EMPTY_BUNDLE;
+        try {
+            const response = await fetch(this.appLicensesUrl);
+            bundle = response.json();
+        }
+        catch (err) {
+            console.warn('Could not resolve licenses for', this.appName);
+        }
+        return bundle;
+    }
+    /**
+     * Resolve the licenses for all federated extensions.
+     */
+    async _getFederated() {
+        const bundles = {};
+        let federated;
+        try {
+            federated = JSON.parse(PageConfig.getOption('federated_extensions'));
+        }
+        catch {
+            return bundles;
+        }
+        const promises = [];
+        for (const ext of federated) {
+            promises.push(this._getOneFederated(ext, bundles));
+        }
+        try {
+            await Promise.all(promises);
+        }
+        catch (err) {
+            console.warn('Error resolving licenses', err);
+        }
+        return bundles;
+    }
+    /**
+     * Update the bundles with the extension's licenses, or the empty bundle.
+     */
+    async _getOneFederated(ext, bundles) {
+        try {
+            const url = URLExt.join(this.labExtensionsUrl, ext.name, 'static', THIRD_PARTY_LICENSES);
+            const response = await fetch(url);
+            bundles[ext.name] = await response.json();
+        }
+        catch {
+            console.warn('Could not resolve licenses for', ext);
+            bundles[ext.name] = EMPTY_BUNDLE;
+        }
+    }
+}
+//# sourceMappingURL=licenses.js.map

package/lib/jupyter/lite/licenses/licenses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"licenses.js","sourceRoot":"","sources":["../../../../src/jupyter/lite/licenses/licenses.ts"],"names":[],"mappings":"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"}