@datalayer/jupyter-react 1.0.7 → 1.1.0

package/lib/jupyter/JupyterConfig.js

@@ -4,21 +4,17 @@
  * MIT License
  */
 import { PageConfig } from '@jupyterlab/coreutils';
-import { DEFAULT_JUPYTER_SERVER_URL, DEFAULT_JUPYTER_SERVER_TOKEN, DEFAULT_API_KERNEL_PREFIX_URL } from './JupyterDefaults';
+import { DEFAULT_JUPYTER_SERVER_URL, DEFAULT_JUPYTER_SERVER_TOKEN, DEFAULT_API_KERNEL_PREFIX_URL, } from './JupyterDefaults';
 /**
  * The current Jupyter configuration.
  */
 let config = undefined;
-/**
- * Datalayer configuration is loaded.
- */
-let datalayerConfigLoaded = false;
 /**
  * Setter for jupyterServerUrl.
  */
 export const setJupyterServerUrl = (jupyterServerUrl) => {
     if (!config) {
-        throw new Error("Jupyter React Config must be loaded first.");
+        throw new Error('Jupyter React Config must be loaded first.');
     }
     PageConfig.setOption('baseUrl', jupyterServerUrl);
     PageConfig.setOption('wsUrl', jupyterServerUrl.replace(/^http/, 'ws'));
@@ -29,7 +25,7 @@ export const setJupyterServerUrl = (jupyterServerUrl) => {
  */
 export const getJupyterServerUrl = () => {
     if (!config) {
-        throw new Error("Jupyter React Config must be loaded first.");
+        throw new Error('Jupyter React Config must be loaded first.');
     }
     return config.jupyterServerUrl;
 };
@@ -38,7 +34,7 @@ export const getJupyterServerUrl = () => {
  */
 export const setJupyterServerToken = (jupyterServerToken) => {
     if (!config) {
-        throw new Error("Jupyter React Config must be loaded first.");
+        throw new Error('Jupyter React Config must be loaded first.');
     }
     PageConfig.setOption('token', jupyterServerToken);
     config.jupyterServerToken = jupyterServerToken;
@@ -48,40 +44,10 @@ export const setJupyterServerToken = (jupyterServerToken) => {
  */
 export const getJupyterServerToken = () => {
     if (!config) {
-        throw new Error("Jupyter React Config must be loaded first.");
+        throw new Error('Jupyter React Config must be loaded first.');
     }
     return config.jupyterServerToken;
 };
-/**
- * Get the datalayer configuration fully
- * or for a particular parameter.
- *
- * @param name The parameter name
- * @returns The parameter value if {@link name} is specified, otherwise the full configuration.
- */
-function loadDatalayerConfig(name) {
-    if (!datalayerConfigLoaded) {
-        const datalayerConfigData = document.getElementById('datalayer-config-data');
-        if (datalayerConfigData?.textContent) {
-            console.log('Found Datalayer config data in page', datalayerConfigData);
-            try {
-                config = {
-                    ...config,
-                    ...JSON.parse(datalayerConfigData.textContent)
-                };
-                datalayerConfigLoaded = true;
-            }
-            catch (error) {
-                console.error('Failed to parse the Datalayer configuration.', error);
-            }
-        }
-        else {
-            console.log('No Datalayer config data found in page');
-        }
-    }
-    // @ts-expect-error IJupyterConfig does not have index signature
-    return name ? config[name] : config;
-}
 /**
  * Method to load the Jupyter configuration from the host HTML page.
  */
@@ -106,32 +72,19 @@ export const loadJupyterConfig = (props = {}) => {
     }
     // Hub related information ('hubHost' 'hubPrefix' 'hubUser' ,'hubServerName').
     config.insideJupyterHub = PageConfig.getOption('hubHost') !== '';
-    // Load the Datalayer config.
-    loadDatalayerConfig();
-    if (datalayerConfigLoaded) {
-        // There is a Datalayer config, mix the configs...
-        setJupyterServerUrl(jupyterServerUrl || config.jupyterServerUrl);
-        setJupyterServerToken(jupyterServerToken || config.jupyterServerToken);
+    // Look for a Jupyter config...
+    if (jupyterConfig) {
+        setJupyterServerUrl(jupyterServerUrl ??
+            jupyterConfig.baseUrl ??
+            location.protocol + '//' + location.host + jupyterConfig.baseUrl);
+        setJupyterServerToken(jupyterServerToken ?? jupyterConfig.token ?? '');
     }
     else {
-        // No Datalayer config, look for a Jupyter config...
-        if (jupyterConfig) {
-            setJupyterServerUrl(jupyterServerUrl ??
-                jupyterConfig.jupyterServerUrl ??
-                location.protocol + '//' + location.host + jupyterConfig.baseUrl);
-            setJupyterServerToken(jupyterServerToken ??
-                jupyterConfig.token ??
-                '');
-        }
-        else {
-            // No Datalayer and no Jupyter config, rely on location...
-            setJupyterServerUrl(jupyterServerUrl ??
-                config.jupyterServerUrl ??
-                location.protocol + '//' + location.host + DEFAULT_API_KERNEL_PREFIX_URL);
-            setJupyterServerToken(jupyterServerToken ??
-                config.jupyterServerToken ??
-                '');
-        }
+        // No Jupyter config, rely on location...
+        setJupyterServerUrl(jupyterServerUrl ??
+            config.jupyterServerUrl ??
+            location.protocol + '//' + location.host + DEFAULT_API_KERNEL_PREFIX_URL);
+        setJupyterServerToken(jupyterServerToken ?? config.jupyterServerToken ?? '');
     }
     if (lite) {
         setJupyterServerUrl(location.protocol + '//' + location.host);

package/lib/jupyter/JupyterConfig.js.map

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

package/lib/jupyter/JupyterContext.js

@@ -5,7 +5,7 @@ import { jsxs as _jsxs } from "react/jsx-runtime";
  * MIT License
  */
 import { createContext, useContext } from 'react';
-import { ServerConnection } from '@jupyterlab/services';
+import { ServerConnection, } from '@jupyterlab/services';
 import { useJupyterReactStoreFromProps } from '../state';
 import { requestAPI } from './JupyterHandlers';
 /**
@@ -25,6 +25,8 @@ const JupyterProvider = JupyterContext.Provider;
  */
 export const useJupyter = (props) => {
     const context = useContext(JupyterContext);
+    // Always call the hook, but only use its result if there's no context
+    const { jupyterConfig, kernel, kernelIsLoading, serviceManager } = useJupyterReactStoreFromProps(props ?? {});
     if (context) {
         // We are within a React Context, just return the JupyterContext.
         // The provided props are irrelevant in this case.
@@ -32,7 +34,6 @@ export const useJupyter = (props) => {
     }
     // We are not within a React Context....
     // so create a JupyterContext from the store based on the provided props.
-    const { jupyterConfig, kernel, kernelIsLoading, serviceManager, } = useJupyterReactStoreFromProps(props ?? {});
     const storeContext = {
         defaultKernel: kernel,
         jupyterServerUrl: jupyterConfig.jupyterServerUrl,
@@ -79,7 +80,7 @@ export const createServerSettings = (jupyterServerUrl, jupyterServerToken) => {
 /**
  * The Jupyter context provider.
  */
-export const JupyterContextProvider = (props) => {
+export const JupyterContextProvider = props => {
     const { children, skeleton } = props;
     const { jupyterServerUrl, kernel, kernelIsLoading, lite, serverSettings, serviceManager, } = useJupyter(props);
     return (_jsxs(JupyterProvider, { value: {

package/lib/jupyter/JupyterContext.js.map

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

package/lib/jupyter/JupyterDefaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"JupyterDefaults.js","sourceRoot":"","sources":["../../src/jupyter/JupyterDefaults.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,8CAA8C,CAAC;AAEzF,MAAM,CAAC,MAAM,4BAA4B,GAAG,kEAAkE,CAAC;AAE/G;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AAEnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"JupyterDefaults.js","sourceRoot":"","sources":["../../src/jupyter/JupyterDefaults.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,0BAA0B,GACrC,8CAA8C,CAAC;AAEjD,MAAM,CAAC,MAAM,4BAA4B,GACvC,kEAAkE,CAAC;AAErE;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AAEnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC"}

package/lib/jupyter/collaboration/CollaborationContext.d.ts

@@ -0,0 +1,70 @@
+import React from 'react';
+import { YNotebook } from '@jupyter/ydoc';
+import { ICollaborationProvider, CollaborationStatus } from './ICollaborationProvider';
+/**
+ * Collaboration context value
+ */
+export interface ICollaborationContext {
+    /**
+     * The collaboration provider instance
+     */
+    provider: ICollaborationProvider | null;
+    /**
+     * Current connection status
+     */
+    status: CollaborationStatus;
+    /**
+     * Whether the provider is connected
+     */
+    isConnected: boolean;
+    /**
+     * Whether the document is synchronized
+     */
+    isSynced: boolean;
+    /**
+     * Error if any
+     */
+    error: Error | null;
+    /**
+     * Connect to collaboration service
+     */
+    connect: (sharedModel: YNotebook, documentId: string, options?: Record<string, any>) => Promise<void>;
+    /**
+     * Disconnect from collaboration service
+     */
+    disconnect: () => void;
+}
+/**
+ * Props for CollaborationProvider component
+ */
+export interface ICollaborationProviderProps {
+    /**
+     * Collaboration provider instance
+     */
+    provider?: ICollaborationProvider;
+    /**
+     * Children components
+     */
+    children: React.ReactNode;
+}
+/**
+ * Collaboration provider component
+ *
+ * This component provides collaboration context to its children.
+ */
+export declare function CollaborationProvider({ provider: providerProp, children, }: ICollaborationProviderProps): JSX.Element;
+/**
+ * Hook to use collaboration context
+ *
+ * @returns The collaboration context value
+ * @throws Error if used outside of CollaborationProvider
+ */
+export declare function useCollaboration(): ICollaborationContext;
+/**
+ * Hook to get collaboration status
+ */
+export declare function useCollaborationStatus(): CollaborationStatus;
+/**
+ * Hook to check if collaboration is connected
+ */
+export declare function useIsCollaborationConnected(): boolean;

package/lib/jupyter/collaboration/CollaborationContext.js

@@ -0,0 +1,110 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { createContext, useContext, useEffect, useMemo, useState, } from 'react';
+import { CollaborationStatus, } from './ICollaborationProvider';
+const CollaborationContext = createContext(undefined);
+/**
+ * Collaboration provider component
+ *
+ * This component provides collaboration context to its children.
+ */
+export function CollaborationProvider({ provider: providerProp, children, }) {
+    const [status, setStatus] = useState(CollaborationStatus.Disconnected);
+    const [isSynced, setIsSynced] = useState(false);
+    const [error, setError] = useState(null);
+    // Use the provider instance
+    const provider = useMemo(() => {
+        return providerProp || null;
+    }, [providerProp]);
+    // Subscribe to provider events
+    useEffect(() => {
+        if (!provider) {
+            return;
+        }
+        const statusHandler = (sender, newStatus) => {
+            setStatus(newStatus);
+        };
+        const errorHandler = (sender, error) => {
+            setError(error);
+        };
+        const syncHandler = (sender, synced) => {
+            setIsSynced(synced);
+        };
+        provider.events.statusChanged.connect(statusHandler);
+        provider.events.errorOccurred.connect(errorHandler);
+        provider.events.syncStateChanged.connect(syncHandler);
+        // Set initial status
+        setStatus(provider.status);
+        return () => {
+            provider.events.statusChanged.disconnect(statusHandler);
+            provider.events.errorOccurred.disconnect(errorHandler);
+            provider.events.syncStateChanged.disconnect(syncHandler);
+        };
+    }, [provider]);
+    // Cleanup on unmount
+    useEffect(() => {
+        return () => {
+            provider?.dispose();
+        };
+    }, [provider]);
+    const connect = async (sharedModel, documentId, options) => {
+        if (!provider) {
+            throw new Error('No collaboration provider configured');
+        }
+        setError(null);
+        try {
+            await provider.connect(sharedModel, documentId, options);
+        }
+        catch (err) {
+            setError(err);
+            throw err;
+        }
+    };
+    const disconnect = () => {
+        provider?.disconnect();
+        setIsSynced(false);
+        setError(null);
+    };
+    const value = {
+        provider,
+        status,
+        isConnected: status === CollaborationStatus.Connected,
+        isSynced,
+        error,
+        connect,
+        disconnect,
+    };
+    return (_jsx(CollaborationContext.Provider, { value: value, children: children }));
+}
+/**
+ * Hook to use collaboration context
+ *
+ * @returns The collaboration context value
+ * @throws Error if used outside of CollaborationProvider
+ */
+export function useCollaboration() {
+    const context = useContext(CollaborationContext);
+    if (!context) {
+        throw new Error('useCollaboration must be used within a CollaborationProvider');
+    }
+    return context;
+}
+/**
+ * Hook to get collaboration status
+ */
+export function useCollaborationStatus() {
+    const { status } = useCollaboration();
+    return status;
+}
+/**
+ * Hook to check if collaboration is connected
+ */
+export function useIsCollaborationConnected() {
+    const { isConnected } = useCollaboration();
+    return isConnected;
+}
+//# sourceMappingURL=CollaborationContext.js.map

package/lib/jupyter/collaboration/CollaborationContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollaborationContext.js","sourceRoot":"","sources":["../../../src/jupyter/collaboration/CollaborationContext.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAc,EACZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,OAAO,EACP,QAAQ,GACT,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAwClC,MAAM,oBAAoB,GAAG,aAAa,CACxC,SAAS,CACV,CAAC;AAgBF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,QAAQ,EAAE,YAAY,EACtB,QAAQ,GACoB;IAC5B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAClC,mBAAmB,CAAC,YAAY,CACjC,CAAC;IACF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5B,OAAO,YAAY,IAAI,IAAI,CAAC;IAC9B,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,+BAA+B;IAC/B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,CACpB,MAA8B,EAC9B,SAA8B,EAC9B,EAAE;YACF,SAAS,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,CAAC,MAA8B,EAAE,KAAY,EAAE,EAAE;YACpE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,CAAC,MAA8B,EAAE,MAAe,EAAE,EAAE;YACtE,WAAW,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC,CAAC;QAEF,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACrD,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACpD,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAEtD,qBAAqB;QACrB,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE3B,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YACxD,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YACvD,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC3D,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,qBAAqB;IACrB,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,QAAQ,EAAE,OAAO,EAAE,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,MAAM,OAAO,GAAG,KAAK,EACnB,WAAsB,EACtB,UAAkB,EAClB,OAA6B,EACd,EAAE;QACjB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAY,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,QAAQ,EAAE,UAAU,EAAE,CAAC;QACvB,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,KAAK,GAA0B;QACnC,QAAQ;QACR,MAAM;QACN,WAAW,EAAE,MAAM,KAAK,mBAAmB,CAAC,SAAS;QACrD,QAAQ;QACR,KAAK;QACL,OAAO;QACP,UAAU;KACX,CAAC;IAEF,OAAO,CACL,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACxC,QAAQ,GACqB,CACjC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC3C,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/lib/jupyter/collaboration/ICollaborationProvider.d.ts

@@ -0,0 +1,120 @@
+import { YNotebook } from '@jupyter/ydoc';
+import { WebsocketProvider } from 'y-websocket';
+import { IDisposable } from '@lumino/disposable';
+import { ISignal, Signal } from '@lumino/signaling';
+/**
+ * Collaboration provider connection status
+ */
+export declare enum CollaborationStatus {
+    Disconnected = "disconnected",
+    Connecting = "connecting",
+    Connected = "connected",
+    Error = "error"
+}
+/**
+ * Events emitted by collaboration providers
+ */
+export interface ICollaborationProviderEvents {
+    /**
+     * Signal emitted when connection status changes
+     */
+    statusChanged: ISignal<ICollaborationProvider, CollaborationStatus>;
+    /**
+     * Signal emitted when an error occurs
+     */
+    errorOccurred: ISignal<ICollaborationProvider, Error>;
+    /**
+     * Signal emitted when synchronization state changes
+     */
+    syncStateChanged: ISignal<ICollaborationProvider, boolean>;
+}
+/**
+ * Interface for collaboration providers
+ *
+ * This interface defines the contract that all collaboration providers must implement.
+ * It provides a uniform way to connect to different collaboration backends while
+ * maintaining the same API for the notebook components.
+ */
+export interface ICollaborationProvider extends IDisposable {
+    /**
+     * Provider type identifier
+     */
+    readonly type: string;
+    /**
+     * Current connection status
+     */
+    readonly status: CollaborationStatus;
+    /**
+     * Whether the provider is currently connected
+     */
+    readonly isConnected: boolean;
+    /**
+     * Provider events
+     */
+    readonly events: ICollaborationProviderEvents;
+    /**
+     * Connect to the collaboration service
+     *
+     * @param sharedModel - The shared notebook model
+     * @param documentId - Document identifier
+     * @param options - Additional connection options
+     * @returns Promise that resolves when connected
+     */
+    connect(sharedModel: YNotebook, documentId: string, options?: Record<string, any>): Promise<void>;
+    /**
+     * Disconnect from the collaboration service
+     */
+    disconnect(): void;
+    /**
+     * Get the underlying WebSocket provider
+     *
+     * @returns The WebSocket provider or null if not connected
+     */
+    getProvider(): WebsocketProvider | null;
+    /**
+     * Get the shared model
+     *
+     * @returns The shared model or null if not connected
+     */
+    getSharedModel(): YNotebook | null;
+    /**
+     * Handle connection close event
+     *
+     * @param event - Close event
+     */
+    handleConnectionClose(event: CloseEvent): void;
+    /**
+     * Handle synchronization event
+     *
+     * @param isSynced - Whether the document is synchronized
+     */
+    handleSync(isSynced: boolean): void;
+}
+/**
+ * Abstract base class for collaboration providers
+ *
+ * This class provides common functionality for all collaboration providers.
+ */
+export declare abstract class CollaborationProviderBase implements ICollaborationProvider {
+    readonly type: string;
+    protected _status: CollaborationStatus;
+    protected _provider: WebsocketProvider | null;
+    protected _sharedModel: YNotebook | null;
+    protected _statusChanged: Signal<this, CollaborationStatus>;
+    protected _errorOccurred: Signal<this, Error>;
+    protected _syncStateChanged: Signal<this, boolean>;
+    protected _isDisposed: boolean;
+    constructor(type: string);
+    get status(): CollaborationStatus;
+    get isConnected(): boolean;
+    get isDisposed(): boolean;
+    get events(): ICollaborationProviderEvents;
+    abstract connect(sharedModel: YNotebook, documentId: string, options?: Record<string, any>): Promise<void>;
+    disconnect(): void;
+    getProvider(): WebsocketProvider | null;
+    getSharedModel(): YNotebook | null;
+    handleConnectionClose(event: CloseEvent): void;
+    handleSync(isSynced: boolean): void;
+    dispose(): void;
+    protected setStatus(status: CollaborationStatus): void;
+}

package/lib/jupyter/collaboration/ICollaborationProvider.js

@@ -0,0 +1,93 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { Signal } from '@lumino/signaling';
+/**
+ * Collaboration provider connection status
+ */
+export var CollaborationStatus;
+(function (CollaborationStatus) {
+    CollaborationStatus["Disconnected"] = "disconnected";
+    CollaborationStatus["Connecting"] = "connecting";
+    CollaborationStatus["Connected"] = "connected";
+    CollaborationStatus["Error"] = "error";
+})(CollaborationStatus || (CollaborationStatus = {}));
+/**
+ * Abstract base class for collaboration providers
+ *
+ * This class provides common functionality for all collaboration providers.
+ */
+export class CollaborationProviderBase {
+    type;
+    _status = CollaborationStatus.Disconnected;
+    _provider = null;
+    _sharedModel = null;
+    _statusChanged = new Signal(this);
+    _errorOccurred = new Signal(this);
+    _syncStateChanged = new Signal(this);
+    _isDisposed = false;
+    constructor(type) {
+        this.type = type;
+    }
+    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,
+        };
+    }
+    disconnect() {
+        if (this._provider) {
+            this._provider.disconnect();
+            this._provider.destroy();
+            this._provider = null;
+        }
+        this._sharedModel = null;
+        this.setStatus(CollaborationStatus.Disconnected);
+    }
+    getProvider() {
+        return this._provider;
+    }
+    getSharedModel() {
+        return this._sharedModel;
+    }
+    handleConnectionClose(event) {
+        if (event.code > 1000) {
+            console.error('Connection closed unexpectedly:', event);
+            this.setStatus(CollaborationStatus.Error);
+            this._errorOccurred.emit(new Error(`Connection closed: ${event.reason}`));
+        }
+    }
+    handleSync(isSynced) {
+        this._syncStateChanged.emit(isSynced);
+        if (isSynced) {
+            this.setStatus(CollaborationStatus.Connected);
+        }
+    }
+    dispose() {
+        if (this._isDisposed) {
+            return;
+        }
+        this.disconnect();
+        Signal.clearData(this);
+        this._isDisposed = true;
+    }
+    setStatus(status) {
+        if (this._status !== status) {
+            this._status = status;
+            this._statusChanged.emit(status);
+        }
+    }
+}
+//# sourceMappingURL=ICollaborationProvider.js.map

package/lib/jupyter/collaboration/ICollaborationProvider.js.map

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

package/lib/jupyter/collaboration/JupyterCollaboration.d.ts

@@ -1,5 +1,5 @@
 import { Contents, ServerConnection } from '@jupyterlab/services';
-export declare const COLLABORATION_ROOM_URL_PATH = "api/collaboration/document";
+export declare const COLLABORATION_ROOM_URL_PATH = "api/collaboration/room";
 export declare const COLLABORATION_SESSION_URL_PATH = "api/collaboration/session";
 /**
  * Document session model

package/lib/jupyter/collaboration/JupyterCollaboration.js

@@ -5,7 +5,7 @@
  */
 import { URLExt } from '@jupyterlab/coreutils';
 import { ServerConnection } from '@jupyterlab/services';
-export const COLLABORATION_ROOM_URL_PATH = 'api/collaboration/document';
+export const COLLABORATION_ROOM_URL_PATH = 'api/collaboration/room';
 export const COLLABORATION_SESSION_URL_PATH = 'api/collaboration/session';
 export async function requestJupyterCollaborationSession(format, type, path, serverSettings) {
     const settings = serverSettings ?? ServerConnection.makeSettings();

package/lib/jupyter/collaboration/JupyterCollaboration.js.map

@@ -1 +1 @@
-{"version":3,"file":"JupyterCollaboration.js","sourceRoot":"","sources":["../../../src/jupyter/collaboration/JupyterCollaboration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAY,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAElE,MAAM,CAAC,MAAM,2BAA2B,GAAG,4BAA4B,CAAC;AAExE,MAAM,CAAC,MAAM,8BAA8B,GAAG,2BAA2B,CAAC;AAwB1E,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,MAAc,EACd,IAAY,EACZ,IAAY,EACZ,cAA2C;IAE3C,MAAM,QAAQ,GAAG,cAAc,IAAI,gBAAgB,CAAC,YAAY,EAAE,CAAC;IACnE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,8BAA8B,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;IACpG,MAAM,IAAI,GAAG;QACX,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KACvC,CAAC;IACF,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,gBAAgB,CAAC,YAAY,CAAC,KAAc,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,eAAe,EAAE,CAAC"}
+{"version":3,"file":"JupyterCollaboration.js","sourceRoot":"","sources":["../../../src/jupyter/collaboration/JupyterCollaboration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAY,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAElE,MAAM,CAAC,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AAEpE,MAAM,CAAC,MAAM,8BAA8B,GAAG,2BAA2B,CAAC;AAwB1E,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,MAAc,EACd,IAAY,EACZ,IAAY,EACZ,cAA2C;IAE3C,MAAM,QAAQ,GAAG,cAAc,IAAI,gBAAgB,CAAC,YAAY,EAAE,CAAC;IACnE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CACrB,QAAQ,CAAC,OAAO,EAChB,8BAA8B,EAC9B,kBAAkB,CAAC,IAAI,CAAC,CACzB,CAAC;IACF,MAAM,IAAI,GAAG;QACX,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KACvC,CAAC;IACF,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,gBAAgB,CAAC,YAAY,CAAC,KAAc,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,eAAe,EAAE,CAAC"}

package/lib/jupyter/collaboration/index.d.ts

@@ -1,3 +1,4 @@
-export * from './DatalayerCollaboration';
-export * from './ICollaborative';
 export * from './JupyterCollaboration';
+export * from './ICollaborationProvider';
+export * from './CollaborationContext';
+export * from './providers';

package/lib/jupyter/collaboration/index.js

@@ -3,7 +3,8 @@
  *
  * MIT License
  */
-export * from './DatalayerCollaboration';
-export * from './ICollaborative';
 export * from './JupyterCollaboration';
+export * from './ICollaborationProvider';
+export * from './CollaborationContext';
+export * from './providers';
 //# sourceMappingURL=index.js.map