@datalayer/core 1.0.24 → 1.1.41

package/lib/collaboration/DatalayerCollaboration.js

@@ -1,28 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Fetch the session ID of a collaborative documents from Datalayer.
- */
-export async function requestDatalayerCollaborationSessionId({ url, token, fetchFn = fetch, }) {
-    const headers = {
-        Accept: 'application/json',
-    };
-    if (token) {
-        headers['Authorization'] = `Bearer ${token}`;
-    }
-    const response = await fetchFn(url, {
-        method: 'GET',
-        headers,
-        credentials: token ? 'include' : 'omit',
-        mode: 'cors',
-        cache: 'no-store',
-    });
-    if (response.ok) {
-        const content = await response.json();
-        return content['sessionId'];
-    }
-    console.error('Failed to fetch session ID.', response);
-    throw new Error('Failed to fetch session ID.');
-}

package/lib/collaboration/DatalayerCollaborationProvider.d.ts

@@ -1,60 +0,0 @@
-import { WebsocketProvider } from 'y-websocket';
-import type { ICollaborationProvider, ICollaborationProviderEvents } from '@datalayer/jupyter-react';
-export declare enum CollaborationStatus {
-    Disconnected = "disconnected",
-    Connecting = "connecting",
-    Connected = "connected",
-    Error = "error"
-}
-type SharedModel = Parameters<ICollaborationProvider['connect']>[0];
-type ConnectOptions = Parameters<ICollaborationProvider['connect']>[2];
-/**
- * Configuration for Datalayer collaboration provider
- */
-export interface IDatalayerCollaborationConfig {
-    /**
-     * Base URL for the Datalayer server (optional, uses config from store if not provided)
-     */
-    runUrl?: string;
-    /**
-     * Authentication token (optional, uses config from store if not provided)
-     */
-    token?: string;
-    /**
-     * Custom fetch function to use for HTTP requests.
-     * Useful for proxying requests in environments with CORS restrictions (e.g., VS Code webviews).
-     */
-    fetchFn?: typeof fetch;
-}
-/**
- * Datalayer collaboration provider
- *
- * This provider connects to Datalayer's collaboration service using WebSockets.
- */
-export declare class DatalayerCollaborationProvider implements ICollaborationProvider {
-    readonly type = "datalayer";
-    private _status;
-    private _provider;
-    private _sharedModel;
-    private _statusChanged;
-    private _errorOccurred;
-    private _syncStateChanged;
-    private _isDisposed;
-    private _config;
-    private _onSync;
-    private _onConnectionClose;
-    constructor(config: IDatalayerCollaborationConfig);
-    get status(): CollaborationStatus;
-    get isConnected(): boolean;
-    get isDisposed(): boolean;
-    get events(): ICollaborationProviderEvents;
-    private setStatus;
-    connect(sharedModel: SharedModel, documentId: string, options?: ConnectOptions): Promise<void>;
-    disconnect(): void;
-    getProvider(): WebsocketProvider | null;
-    getSharedModel(): SharedModel | null;
-    handleConnectionClose(event: CloseEvent): void;
-    handleSync(isSynced: boolean): void;
-    dispose(): void;
-}
-export default DatalayerCollaborationProvider;

package/lib/collaboration/DatalayerCollaborationProvider.js

@@ -1,163 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { WebsocketProvider } from 'y-websocket';
-import { URLExt } from '@jupyterlab/coreutils';
-import { Signal } from '@lumino/signaling';
-// Import CollaborationStatus enum separately since it's exported
-export var CollaborationStatus;
-(function (CollaborationStatus) {
-    CollaborationStatus["Disconnected"] = "disconnected";
-    CollaborationStatus["Connecting"] = "connecting";
-    CollaborationStatus["Connected"] = "connected";
-    CollaborationStatus["Error"] = "error";
-})(CollaborationStatus || (CollaborationStatus = {}));
-import { requestDatalayerCollaborationSessionId } from './DatalayerCollaboration.js';
-/**
- * Datalayer collaboration provider
- *
- * This provider connects to Datalayer's collaboration service using WebSockets.
- */
-export class DatalayerCollaborationProvider {
-    type = 'datalayer';
-    _status = CollaborationStatus.Disconnected;
-    _provider = null;
-    _sharedModel = null;
-    _statusChanged = new Signal(this);
-    _errorOccurred = new Signal(this);
-    _syncStateChanged = new Signal(this);
-    _isDisposed = false;
-    _config;
-    _onSync = null;
-    _onConnectionClose = null;
-    constructor(config) {
-        this._config = config;
-    }
-    get status() {
-        return this._status;
-    }
-    get isConnected() {
-        return this._status === CollaborationStatus.Connected;
-    }
-    get isDisposed() {
-        return this._isDisposed;
-    }
-    get events() {
-        return {
-            statusChanged: this._statusChanged,
-            errorOccurred: this._errorOccurred,
-            syncStateChanged: this._syncStateChanged,
-        };
-    }
-    setStatus(status) {
-        if (this._status !== status) {
-            this._status = status;
-            this._statusChanged.emit(status);
-        }
-    }
-    async connect(sharedModel, documentId, options) {
-        if (this.isConnected) {
-            console.warn('Already connected to Datalayer collaboration service');
-            return;
-        }
-        this.setStatus(CollaborationStatus.Connecting);
-        try {
-            // Use ONLY explicitly provided configuration
-            // NO fallback to coreStore - if config is wrong, we want to fail fast
-            // This is critical for VS Code extension where config must come from settings
-            const runUrl = this._config.runUrl;
-            const token = this._config.token;
-            if (!runUrl) {
-                throw new Error('Datalayer runUrl is not configured - must be explicitly provided in DatalayerCollaborationProvider config');
-            }
-            if (!token) {
-                throw new Error('Datalayer token is not configured - must be explicitly provided in DatalayerCollaborationProvider config');
-            }
-            const { ydoc, awareness } = sharedModel;
-            // Build URLs.
-            const documentURL = URLExt.join(runUrl, '/api/spacer/v1/documents');
-            const wsUrl = URLExt.join(runUrl, '/api/spacer/v1/documents/ws').replace(/^http/, 'ws');
-            // Request collaboration session from Datalayer
-            const sessionId = await requestDatalayerCollaborationSessionId({
-                url: URLExt.join(documentURL, documentId),
-                token,
-                fetchFn: this._config.fetchFn,
-            });
-            // Create WebSocket provider
-            this._provider = new WebsocketProvider(wsUrl, documentId, ydoc, {
-                disableBc: true,
-                params: {
-                    sessionId,
-                    token,
-                },
-                awareness,
-                ...options,
-            });
-            this._sharedModel = sharedModel;
-            // Set up event handlers
-            this._onSync = (isSynced) => {
-                this.handleSync(isSynced);
-            };
-            this._onConnectionClose = (event) => {
-                if (event) {
-                    this.handleConnectionClose(event);
-                }
-            };
-            this._provider.on('sync', this._onSync);
-            this._provider.on('connection-close', this._onConnectionClose);
-            console.log('Connected to Datalayer collaboration service');
-        }
-        catch (error) {
-            this.setStatus(CollaborationStatus.Error);
-            this._errorOccurred.emit(error);
-            throw error;
-        }
-    }
-    disconnect() {
-        if (this._provider) {
-            if (this._onSync) {
-                this._provider.off('sync', this._onSync);
-            }
-            if (this._onConnectionClose) {
-                this._provider.off('connection-close', this._onConnectionClose);
-            }
-            this._provider.disconnect();
-            this._provider = null;
-        }
-        this._sharedModel = null;
-        this.setStatus(CollaborationStatus.Disconnected);
-    }
-    getProvider() {
-        return this._provider;
-    }
-    getSharedModel() {
-        return this._sharedModel;
-    }
-    handleConnectionClose(event) {
-        console.warn('Collaboration connection closed:', event);
-        this.setStatus(CollaborationStatus.Disconnected);
-        // Handle session expiration (code 4002)
-        if (event.code === 4002) {
-            console.warn('Datalayer collaboration session expired');
-            // Attempt to reconnect could be implemented here
-        }
-    }
-    handleSync(isSynced) {
-        this._syncStateChanged.emit(isSynced);
-        if (isSynced) {
-            this.setStatus(CollaborationStatus.Connected);
-        }
-    }
-    dispose() {
-        if (this._isDisposed) {
-            return;
-        }
-        this.disconnect();
-        // Signals don't need explicit disposal in Lumino
-        // They are cleaned up when the object is garbage collected
-        this._isDisposed = true;
-    }
-}
-// Export the provider for direct instantiation
-export default DatalayerCollaborationProvider;

package/lib/collaboration/index.d.ts

@@ -1,2 +0,0 @@
-export * from './DatalayerCollaboration';
-export * from './DatalayerCollaborationProvider';

package/lib/collaboration/index.js

@@ -1,6 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-export * from './DatalayerCollaboration.js';
-export * from './DatalayerCollaborationProvider.js';

package/lib/components/context/SpaceSelect.d.ts

@@ -1,2 +0,0 @@
-export declare const SpaceSelect: () => import("react/jsx-runtime").JSX.Element;
-export default SpaceSelect;

package/lib/components/context/SpaceSelect.js

@@ -1,42 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { useCallback, useEffect } from 'react';
-import { FormControl, Select } from '@primer/react';
-import { Box } from '@datalayer/primer-addons';
-import { useCache, useUser } from './../../hooks/index.js';
-import { useLayoutStore } from '../../state/index.js';
-export const SpaceSelect = () => {
-    const user = useUser();
-    const { organization, space, updateLayoutSpace } = useLayoutStore();
-    const { useRefreshUserSpaces, useUserSpaces, useRefreshOrganizationSpaces, useOrganizationSpaces, } = useCache();
-    const { mutate: refreshUserSpacesMutate } = useRefreshUserSpaces();
-    const { mutate: refreshOrganizationSpacesMutate } = useRefreshOrganizationSpaces();
-    const { data: organizationSpaces = [] } = useOrganizationSpaces(organization?.id ?? '');
-    const { data: userSpaces = [] } = useUserSpaces();
-    const spaces = organization ? organizationSpaces : userSpaces;
-    useEffect(() => {
-        if (organization?.id) {
-            refreshOrganizationSpacesMutate(organization.id);
-        }
-        else if (user) {
-            refreshUserSpacesMutate();
-        }
-    }, [
-        organization?.id,
-        refreshOrganizationSpacesMutate,
-        refreshUserSpacesMutate,
-        user,
-    ]);
-    const onSelectionChange = useCallback((event) => {
-        const selectedSpaceIndex = Number.parseInt(event.target.value, 10);
-        const selectedSpace = Number.isNaN(selectedSpaceIndex) || selectedSpaceIndex < 0
-            ? undefined
-            : spaces[selectedSpaceIndex];
-        updateLayoutSpace(selectedSpace);
-    }, [spaces, updateLayoutSpace]);
-    return (_jsx(_Fragment, { children: _jsx(Box, { as: "form", children: _jsxs(FormControl, { children: [_jsx(FormControl.Label, { children: "Select a space" }), _jsx(FormControl.Caption, { children: "This will go with you while you navigate" }), _jsx(Select, { block: true, width: "medium", onChange: onSelectionChange, placeholder: "Please select an space...", children: spaces.map((sp, index) => (_jsx(Select.Option, { value: `${index}`, selected: sp.id === space?.id, children: sp.name }, sp.id))) })] }) }) }));
-};
-export default SpaceSelect;

package/lib/components/flashes/FlashDisclaimer.d.ts

@@ -1,2 +0,0 @@
-export declare const FlashDisclaimer: () => import("react/jsx-runtime").JSX.Element;
-export default FlashDisclaimer;

package/lib/components/flashes/FlashDisclaimer.js

@@ -1,17 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { Label, Link } from '@primer/react';
-import { Box } from '@datalayer/primer-addons';
-import { Banner } from '@primer/react/experimental';
-import { useCoreStore, useRuntimesStore } from '../../state/index.js';
-import { useNavigate } from '../../hooks/index.js';
-export const FlashDisclaimer = () => {
-    const { configuration } = useCoreStore();
-    const { showDisclaimer, setShowDisclaimer } = useRuntimesStore();
-    const navigate = useNavigate();
-    return (_jsx(_Fragment, { children: configuration?.whiteLabel === false && showDisclaimer && (_jsx(Banner, { variant: "info", title: "AI Agents for Data Analysis", description: _jsxs(Box, { children: [_jsx(Label, { style: { marginRight: 10 }, children: "PRIVATE BETA" }), "Create Kernels and use them from your JupyterLab, VS Code or CLI. Read the", ' ', _jsx(Link, { href: "javascript: return false;", onClick: e => navigate('/docs', e), children: "documentation" }), ' ', "for any question or", ' ', _jsx(Link, { href: "javascript: return false;", onClick: e => navigate('/support/request', e), children: "contact us for support" }), "."] }), onDismiss: () => setShowDisclaimer(false) })) }));
-};
-export default FlashDisclaimer;

package/lib/components/icons/ArtifactIcon.d.ts

@@ -1,10 +0,0 @@
-import { Icon } from '@primer/octicons-react';
-import { IAnyItem, IItemType } from '../../models';
-type IArtifactIconClassProp = {
-    item?: IAnyItem;
-    type?: IItemType;
-    size?: number | 'small' | 'medium' | 'large';
-};
-export declare const ArtifactIconClass: (props: IArtifactIconClassProp) => Icon;
-export declare function ArtifactIcon(props: IArtifactIconClassProp): JSX.Element;
-export default ArtifactIcon;

package/lib/components/icons/ArtifactIcon.js

@@ -1,58 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { createElement } from 'react';
-import { DatabaseIcon, RowsIcon, BookIcon, DiffModifiedIcon, PencilIcon, FeedIssueDraftIcon, FeedRocketIcon, MilestoneIcon, OrganizationIcon, PeopleIcon, RocketIcon, FileIcon, StackIcon, GearIcon, GraphIcon, NumberIcon, PaperAirplaneIcon, ArchiveIcon, TagIcon, MortarBoardIcon, ContainerIcon, HomeIcon, ShareIcon, FileDirectoryIcon, TrophyIcon, QuestionIcon, PersonIcon, MailIcon, ZapIcon, } from '@primer/octicons-react';
-import { GalileoIcon, CircleWhiteIcon, BookOpenIcon, CameraIcon, CellIcon, NotebookOutlineIcon, } from '@datalayer/icons-react';
-const ARTIFACT_ICONS = new Map([
-    ['assignment', MilestoneIcon],
-    ['authoring', PencilIcon],
-    ['cell', CellIcon],
-    ['content', ArchiveIcon],
-    ['credits', NumberIcon],
-    ['dataset', StackIcon],
-    ['datasource', DatabaseIcon],
-    ['document', FileIcon],
-    ['documentation', BookOpenIcon],
-    ['environment', ContainerIcon],
-    ['exercise', DiffModifiedIcon],
-    ['growth', FeedRocketIcon],
-    ['home', HomeIcon],
-    ['invite', PaperAirplaneIcon],
-    ['runtime', RocketIcon],
-    ['runtime-snapshot', CameraIcon],
-    ['library', BookIcon],
-    ['lesson', MortarBoardIcon],
-    ['mail', MailIcon],
-    ['management', FeedIssueDraftIcon],
-    ['notebook', RowsIcon],
-    ['organization', OrganizationIcon],
-    ['onboarding', ZapIcon],
-    ['page', NotebookOutlineIcon],
-    ['settings', GearIcon],
-    ['share', ShareIcon],
-    ['space', GalileoIcon],
-    ['success', TrophyIcon],
-    ['support', QuestionIcon],
-    ['storage', FileDirectoryIcon],
-    ['tag', TagIcon],
-    ['team', PeopleIcon],
-    ['usage', GraphIcon],
-    ['user', PersonIcon],
-    ['undefined', CircleWhiteIcon],
-]);
-export const ArtifactIconClass = (props) => {
-    const { item, type } = props;
-    const itemType = item?.type ?? type ?? 'undefined';
-    const icon = ARTIFACT_ICONS.get(itemType);
-    return icon ?? CircleWhiteIcon;
-};
-export function ArtifactIcon(props) {
-    const { size } = props;
-    const artifactIconClass = ArtifactIconClass(props);
-    return createElement(artifactIconClass, {
-        size: size ?? 16,
-    });
-}
-export default ArtifactIcon;

package/lib/components/icons/index.d.ts

@@ -1 +0,0 @@
-export * from './ArtifactIcon';

package/lib/components/icons/index.js

@@ -1,5 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-export * from './ArtifactIcon.js';

package/lib/components/nbgrader/NbGradesDetails.d.ts

@@ -1,5 +0,0 @@
-import { IStudentItem } from '../../models';
-export declare const NbGradesDetails: (props: {
-    studentItem?: IStudentItem;
-}) => import("react/jsx-runtime").JSX.Element;
-export default NbGradesDetails;

package/lib/components/nbgrader/NbGradesDetails.js

@@ -1,14 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { Heading, Text } from '@primer/react';
-import { Box } from '@datalayer/primer-addons';
-export const NbGradesDetails = (props) => {
-    const { studentItem } = props;
-    return studentItem && studentItem?.nbgrades ? (_jsxs(Box, { children: [_jsx(Box, { children: _jsx(Heading, { sx: { fontSize: 1 }, children: "Grades" }) }), _jsx(Box, { mt: 3, children: studentItem?.nbgrades.map(nb => {
-                    return (_jsx(Box, { children: _jsxs(Text, { sx: { fontSize: 'small' }, children: [nb.grade_id_s, ": ", nb.score_f] }) }));
-                }) }), _jsx(Box, { mt: 3, children: _jsx(Heading, { sx: { fontSize: 1 }, children: "Total" }) }), _jsxs(Box, { mt: 3, children: [studentItem?.nbgradesTotalScore, " / ", studentItem?.nbgradesTotalPoints] })] })) : (_jsxs(Box, { children: [_jsx(Box, { children: _jsx(Heading, { sx: { fontSize: 1 }, children: "Grades" }) }), _jsx(Box, { mt: 3, children: "Please grade your assignment." })] }));
-};
-export default NbGradesDetails;

package/lib/components/nbgrader/index.d.ts

@@ -1 +0,0 @@
-export * from './NbGradesDetails';

package/lib/components/nbgrader/index.js

@@ -1,5 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-export * from './NbGradesDetails.js';

package/lib/components/progress/CreditsIndicator.d.ts

@@ -1,33 +0,0 @@
-import type { IRemoteServicesManager } from '../../stateful/runtimes';
-type ICreditsIndicatorProps = {
-    /**
-     * Kernel service manager
-     */
-    serviceManager: IRemoteServicesManager;
-    /**
-     * Kernel ID
-     */
-    kernelId: string;
-    /**
-     * Route to navigate to when the indicator is clicked.
-     * Ignored if `onClick` is provided.
-     */
-    navigateTo?: string;
-    /**
-     * Callback on progress bar click event.
-     * Takes precedence over `navigateTo`.
-     */
-    onClick?: () => void;
-    /**
-     * Callback on progress update.
-     *
-     * Progress is a percentage between 0 and 100.
-     * Duration is the kernel max duration
-     */
-    onUpdate?: (progress: number, duration: number) => void;
-};
-/**
- * Credits indicator component.
- */
-export declare function CreditsIndicator(props: ICreditsIndicatorProps): JSX.Element | null;
-export {};

package/lib/components/progress/CreditsIndicator.js

@@ -1,23 +0,0 @@
-import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { useState, useEffect } from 'react';
-import { Box } from '@datalayer/primer-addons';
-import { useNavigate } from '../../hooks/useNavigate.js';
-import { ConsumptionBar } from './ConsumptionBar.js';
-/**
- * Credits indicator component.
- */
-export function CreditsIndicator(props) {
-    const { serviceManager, kernelId, navigateTo, onClick, onUpdate } = props;
-    const navigate = useNavigate();
-    const [model, setModel] = useState();
-    useEffect(() => {
-        serviceManager.runtimesManager.findById(kernelId).then(model => {
-            setModel(model);
-        });
-    }, [kernelId, serviceManager]);
-    return model ? (_jsx(Box, { display: "flex", style: { alignItems: 'center' }, children: _jsx(ConsumptionBar, { startedAt: parseFloat(model.started_at), expiredAt: model.expired_at ? parseFloat(model.expired_at) : undefined, burningRate: model.burning_rate, onClick: onClick ?? (navigateTo ? () => navigate(navigateTo) : undefined), onUpdate: onUpdate, style: { cursor: 'pointer' } }) })) : (_jsx(_Fragment, {}));
-}

package/lib/components/runtimes/RuntimeCellVariables.d.ts

@@ -1,39 +0,0 @@
-import { ITranslator } from '@jupyterlab/translation';
-/**
- * {@link RuntimeCellVariables} properties
- */
-interface IRuntimeCellVariablesProps {
-    /**
-     * Variable names to be imported
-     */
-    inputs: string[];
-    /**
-     * Importable variable names
-     */
-    getInputOptions?: () => Promise<string[]>;
-    /**
-     * Set the variable names to be imported
-     */
-    setInputs: (values: string[]) => void;
-    /**
-     * Variable name to be exported
-     */
-    output?: string;
-    /**
-     * Exportable variable names
-     */
-    getOutputOptions?: () => Promise<string[]>;
-    /**
-     * Set the variable name to be exported
-     */
-    setOutput: (value?: string) => void;
-    /**
-     * Application translator object
-     */
-    translator?: ITranslator;
-}
-/**
- * Runtime Cell Variables Picker.
- */
-export declare function RuntimeCellVariables(props: IRuntimeCellVariablesProps): JSX.Element;
-export default RuntimeCellVariables;