@hereugo/open-collaboration-monaco 0.3.3

package/lib/collaboration-peer.js

@@ -0,0 +1,113 @@
+// ******************************************************************************
+// Copyright 2024 TypeFox GmbH
+// This program and the accompanying materials are made available under the
+// terms of the MIT License, which is available in the project root.
+// ******************************************************************************
+export class DisposablePeer {
+    peer;
+    color;
+    yjsAwareness;
+    decoration;
+    get clientId() {
+        const states = this.yjsAwareness.getStates();
+        for (const [clientID, state] of states.entries()) {
+            if (state.peer === this.peer.id) {
+                return clientID;
+            }
+        }
+        return undefined;
+    }
+    get lastUpdated() {
+        const clientId = this.clientId;
+        if (clientId !== undefined) {
+            const meta = this.yjsAwareness.meta.get(clientId);
+            if (meta) {
+                return meta.lastUpdated;
+            }
+        }
+        return undefined;
+    }
+    constructor(yAwareness, peer) {
+        this.peer = peer;
+        this.yjsAwareness = yAwareness;
+        this.decoration = this.createDecorations();
+    }
+    createDecorations() {
+        const color = createColor();
+        const colorCss = typeof color === 'string' ? color : `rgb(${color[0]}, ${color[1]}, ${color[2]})`;
+        this.color = colorCss;
+        const className = `peer-${this.peer.id}`;
+        const cursorClassName = `${className}-cursor`;
+        const cursorInvertedClassName = `${className}-cursor-inverted`;
+        const selectionClassName = `${className}-selection`;
+        const cursorCss = `.${cursorClassName} {
+            background-color: ${colorCss} !important;
+            border-color: ${colorCss} !important;
+            position: absolute;
+            border-right: solid 2px;
+            border-top: solid 2px;
+            border-bottom: solid 2px;
+            height: 100%;
+            box-sizing: border-box;
+        }`;
+        generateCSS(cursorCss);
+        const cursorAfterCss = `.${cursorClassName}::after {
+            content: "${this.peer.name}";
+            position: absolute;
+            transform: translateY(-100%);
+            padding: 0 4px;
+            border-radius: 4px 4px 4px 0px;
+            background-color: ${colorCss};
+        }`;
+        generateCSS(cursorAfterCss);
+        const cursorAfterInvertedCss = `.${cursorClassName}.${cursorInvertedClassName}::after {
+            transform: translateY(100%);
+            margin-top: -2px;
+            border-radius: 0px 4px 4px 4px;
+            z-index: 1;
+        }`;
+        generateCSS(cursorAfterInvertedCss);
+        const selectionCss = `.${selectionClassName} {
+            background: ${colorCss} !important;
+            opacity: 0.25;
+        }`;
+        generateCSS(selectionCss);
+        return {
+            cursorClassName,
+            cursorInvertedClassName,
+            selectionClassName
+        };
+    }
+}
+let colorIndex = 0;
+const defaultColors = [
+    'yellow', // Yellow
+    'green', // Green
+    'magenta', // Magenta
+    'lightGreen', // Light green
+    [255, 178, 123], // Light orange
+    [255, 157, 242], // Light magenta
+    [92, 45, 145], // Purple
+    [0, 178, 148], // Light teal
+    [255, 241, 0], // Light yellow
+    [180, 160, 255] // Light purple
+];
+const knownColors = new Set();
+function createColor() {
+    if (colorIndex < defaultColors.length) {
+        return defaultColors[colorIndex++];
+    }
+    const o = Math.round, r = Math.random, s = 255;
+    let color;
+    do {
+        color = [o(r() * s), o(r() * s), o(r() * s)];
+    } while (knownColors.has(JSON.stringify(color)));
+    knownColors.add(JSON.stringify(color));
+    return color;
+}
+function generateCSS(cssText) {
+    const style = document.createElement('style');
+    style.textContent = cssText;
+    document.head.appendChild(style);
+}
+//# sourceMappingURL=collaboration-peer.js.map

package/lib/collaboration-peer.js.map

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

package/lib/example.d.ts

@@ -0,0 +1,2 @@
+export type WorkerLoader = () => Worker;
+//# sourceMappingURL=example.d.ts.map

package/lib/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,YAAY,GAAG,MAAM,MAAM,CAAA"}

package/lib/example.js

@@ -0,0 +1,84 @@
+// ******************************************************************************
+// Copyright 2024 TypeFox GmbH
+// This program and the accompanying materials are made available under the
+// terms of the MIT License, which is available in the project root.
+// ******************************************************************************
+import * as monaco from 'monaco-editor';
+import { monacoCollab } from './monaco-api.js';
+const value = `function sayHello(): string {
+    return "Hello";
+};`;
+const workerLoaders = {
+    editorWorkerService: () => new Worker(new URL('monaco-editor/esm/vs/editor/editor.worker.js', import.meta.url), {
+        type: 'module'
+    }),
+    typescript: () => new Worker(new URL('monaco-editor/esm/vs/language/typescript/ts.worker.js', import.meta.url), {
+        type: 'module'
+    })
+};
+window.MonacoEnvironment = {
+    getWorker: function (moduleId, label) {
+        const workerFactory = workerLoaders[label];
+        if (workerFactory !== undefined && workerFactory !== null) {
+            return workerFactory();
+        }
+        throw new Error(`Unimplemented worker ${label} (${moduleId})`);
+    }
+};
+const container = document.getElementById('container');
+if (container) {
+    const myEditor = monaco.editor.create(container, {
+        value,
+        language: 'typescript'
+    });
+    const monacoCollabApi = monacoCollab({
+        serverUrl: 'http://localhost:8100',
+        callbacks: {
+            onUserRequestsAccess: (user) => {
+                console.log('User requests access', user);
+                return Promise.resolve(true);
+            }
+        }
+    });
+    // on click of button with id create create room, call createRoom, take the value from response and set it in textfield with id token
+    const createRoomButton = document.getElementById('create');
+    createRoomButton?.addEventListener('click', () => {
+        monacoCollabApi.createRoom().then(token => {
+            if (token) {
+                monacoCollabApi.setEditor(myEditor);
+                document.getElementById('token').value = token ?? '';
+            }
+        });
+    });
+    // on click of join room button take value from textfield with id room and call joinRoom
+    const joinRoomButton = document.getElementById('join');
+    joinRoomButton?.addEventListener('click', () => {
+        const roomToken = document.getElementById('room').value;
+        monacoCollabApi.joinRoom(roomToken).then(state => {
+            if (state) {
+                monacoCollabApi.setEditor(myEditor);
+                monacoCollabApi.onUsersChanged(() => {
+                    monacoCollabApi.getUserData().then(userData => {
+                        const host = userData?.others.find(u => u.peer.host);
+                        if (host && monacoCollabApi.getFollowedUser() === undefined) {
+                            monacoCollabApi.followUser(host.peer.id);
+                        }
+                    });
+                });
+            }
+            console.log('Joined room');
+        });
+    });
+    // on click of button with id login call login
+    const loginButton = document.getElementById('login');
+    loginButton?.addEventListener('click', () => {
+        monacoCollabApi.login().then((userAuthToken) => {
+            let loginText = 'Failed to login';
+            if (userAuthToken) {
+                loginText = 'Successfully logged in';
+            }
+            document.getElementById('user').innerText = loginText;
+        });
+    });
+}
+//# sourceMappingURL=example.js.map

package/lib/example.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+export * from './collaboration-connection.js';
+export * from './collaboration-instance.js';
+export * from './collaboration-peer.js';
+export * from './types.js';
+export * from './monaco-api.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/lib/index.js

@@ -0,0 +1,11 @@
+// ******************************************************************************
+// Copyright 2024 TypeFox GmbH
+// This program and the accompanying materials are made available under the
+// terms of the MIT License, which is available in the project root.
+// ******************************************************************************
+export * from './collaboration-connection.js';
+export * from './collaboration-instance.js';
+export * from './collaboration-peer.js';
+export * from './types.js';
+export * from './monaco-api.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,8BAA8B;AAC9B,2EAA2E;AAC3E,oEAAoE;AACpE,iFAAiF;AAEjF,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/lib/monaco-api.d.ts

@@ -0,0 +1,49 @@
+import { UsersChangeEvent, FileNameChangeEvent } from './collaboration-instance.js';
+import * as types from '@hereugo/open-collaboration-protocol';
+import * as monaco from 'monaco-editor';
+export type MonacoCollabCallbacks = {
+    onUserRequestsAccess: (user: types.User) => Promise<boolean>;
+    /**
+     * reports the status when joining or creating a room
+     * @param info information about the changed status
+     */
+    statusReporter?: (info: types.Info) => void;
+};
+export type MonacoCollabOptions = {
+    serverUrl: string;
+    callbacks: MonacoCollabCallbacks;
+    userToken?: string;
+    roomToken?: string;
+    useCookieAuth?: boolean;
+    loginPageOpener?: (token: string, authenticationMetadata: types.AuthMetadata) => Promise<boolean>;
+};
+export type OtherUserData = {
+    peer: types.Peer;
+    color: string;
+};
+export type UserData = {
+    me: types.Peer;
+    others: OtherUserData[];
+};
+export type MonacoCollabApi = {
+    createRoom: () => Promise<string | undefined>;
+    joinRoom: (roomToken: string) => Promise<string | undefined>;
+    leaveRoom: () => void;
+    login: () => Promise<string | undefined>;
+    logout: () => Promise<void | undefined>;
+    isLoggedIn: () => Promise<boolean>;
+    setEditor: (editor: monaco.editor.IStandaloneCodeEditor) => void;
+    getUserData: () => Promise<UserData | undefined>;
+    onUsersChanged: (evt: UsersChangeEvent) => void;
+    onFileNameChange: (callback: FileNameChangeEvent) => void;
+    getCurrentConnection: () => types.ProtocolBroadcastConnection | undefined;
+    followUser: (id?: string) => void;
+    getFollowedUser: () => string | undefined;
+    setFileName: (fileName: string) => void;
+    getFileName: () => string | undefined;
+    setWorkspaceName: (workspaceName: string) => void;
+    getWorkspaceName: () => string | undefined;
+};
+export declare function monacoCollab(options: MonacoCollabOptions): MonacoCollabApi;
+export declare function deactivate(): void;
+//# sourceMappingURL=monaco-api.d.ts.map

package/lib/monaco-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monaco-api.d.ts","sourceRoot":"","sources":["../src/monaco-api.ts"],"names":[],"mappings":"AAOA,OAAO,EAAyB,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAC3G,OAAO,KAAK,KAAK,MAAM,sCAAsC,CAAC;AAE9D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AASxC,MAAM,MAAM,qBAAqB,GAAG;IAChC,oBAAoB,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;CAC/C,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,qBAAqB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,KAAK,CAAC,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACrG,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,EAAE,CAAA;CAAC,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG;IAC1B,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC7C,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC5D,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAA;IACvC,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAClC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,qBAAqB,KAAK,IAAI,CAAA;IAChE,WAAW,EAAE,MAAM,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAA;IAChD,cAAc,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC/C,gBAAgB,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAA;IACzD,oBAAoB,EAAE,MAAM,KAAK,CAAC,2BAA2B,GAAG,SAAS,CAAA;IACzE,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,eAAe,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IACzC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,WAAW,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IACrC,gBAAgB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAA;IACjD,gBAAgB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;CAC7C,CAAA;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,eAAe,CA0K1E;AAED,wBAAgB,UAAU,SAEzB"}

package/lib/monaco-api.js

@@ -0,0 +1,168 @@
+// ******************************************************************************
+// Copyright 2024 TypeFox GmbH
+// This program and the accompanying materials are made available under the
+// terms of the MIT License, which is available in the project root.
+// ******************************************************************************
+import { ConnectionProvider, SocketIoTransportProvider } from '@hereugo/open-collaboration-protocol';
+import * as types from '@hereugo/open-collaboration-protocol';
+import { createRoom, joinRoom, login } from './collaboration-connection.js';
+let connectionProvider;
+let instance;
+types.initializeProtocol({
+    cryptoModule: globalThis.crypto
+});
+export function monacoCollab(options) {
+    connectionProvider = new ConnectionProvider({
+        url: options.serverUrl,
+        authenticationHandler: options.loginPageOpener ?? (async (_token, metaData) => {
+            // If this returns null, it means the window could not be opened and the authentication failed
+            return window.open(metaData.loginPageUrl, '_blank') !== null;
+        }),
+        transports: [SocketIoTransportProvider],
+        userToken: options.userToken,
+        useCookieAuth: options.useCookieAuth,
+        fetch: async (url, options) => {
+            const response = await fetch(url, options);
+            return {
+                ok: response.ok,
+                status: response.status,
+                json: async () => response.json(),
+                text: async () => response.text()
+            };
+        }
+    });
+    const doCreateRoom = async () => {
+        console.log('Creating room');
+        if (!connectionProvider) {
+            console.log('No OCT Server configured.');
+            throw new Error('No OCT Server configured.');
+        }
+        instance = await createRoom(connectionProvider, options.callbacks);
+        if (instance) {
+            return instance.roomId;
+        }
+        throw new Error('Failed to create room');
+    };
+    const doJoinRoom = async (roomToken) => {
+        console.log('Joining room', roomToken);
+        if (!connectionProvider) {
+            console.log('No OCT Server configured.');
+            throw new Error('No OCT Server configured.');
+        }
+        const res = await joinRoom(connectionProvider, options.callbacks, roomToken);
+        if (res && 'message' in res) {
+            console.log('Failed to join room: ', res.message);
+            throw new Error('Failed to join room: ' + res.message);
+        }
+        else {
+            instance = res;
+            return instance.roomId;
+        }
+    };
+    const doLogin = async () => {
+        if (!connectionProvider) {
+            console.log('No OCT Server configured.');
+            throw new Error('No OCT Server configured.');
+        }
+        await login(connectionProvider);
+        return connectionProvider.authToken;
+    };
+    const doSetEditor = (editor) => {
+        if (instance) {
+            instance.setEditor(editor);
+        }
+    };
+    const doGetUserData = async () => {
+        let data;
+        if (instance) {
+            const me = await instance.ownUserData;
+            const others = instance.connectedUsers.map(user => ({
+                peer: user.peer,
+                color: user.color ?? 'rgba(0, 0, 0, 0.5)'
+            }));
+            data = { me, others };
+        }
+        return data;
+    };
+    const registerUserChangeHandler = (evt) => {
+        if (instance) {
+            instance.onUsersChanged(evt);
+        }
+    };
+    const doFollowUser = (id) => {
+        if (instance) {
+            instance.followUser(id);
+        }
+    };
+    const doGetFollowedUser = () => {
+        if (instance) {
+            return instance.following;
+        }
+        return undefined;
+    };
+    const doSetFileName = (fileName) => {
+        if (instance) {
+            instance.setFileName(fileName);
+        }
+    };
+    const doGetWorkspaceName = () => {
+        if (instance) {
+            return instance.workspaceName;
+        }
+        return undefined;
+    };
+    const doGetFileName = () => {
+        if (instance) {
+            return instance.fileName;
+        }
+        return undefined;
+    };
+    const registerFileNameChangeHandler = (callback) => {
+        if (instance) {
+            instance.onFileNameChange(callback);
+        }
+    };
+    const doSetWorkspaceName = (workspaceName) => {
+        if (instance) {
+            instance.workspaceName = workspaceName;
+        }
+    };
+    const isLoggedIn = async () => {
+        if (!connectionProvider) {
+            return false;
+        }
+        if (options.useCookieAuth) {
+            const valid = await fetch(options.serverUrl + '/api/login/validate', {
+                credentials: 'include',
+                method: 'POST',
+            });
+            return valid.ok && (await valid.json())?.valid;
+        }
+        else {
+            return !!connectionProvider.authToken;
+        }
+    };
+    return {
+        createRoom: doCreateRoom,
+        joinRoom: doJoinRoom,
+        leaveRoom: () => instance?.leaveRoom(),
+        login: doLogin,
+        logout: async () => connectionProvider?.logout(),
+        isLoggedIn: isLoggedIn,
+        setEditor: doSetEditor,
+        getUserData: doGetUserData,
+        onUsersChanged: registerUserChangeHandler,
+        onFileNameChange: registerFileNameChangeHandler,
+        followUser: doFollowUser,
+        getFollowedUser: doGetFollowedUser,
+        getCurrentConnection: () => instance?.getCurrentConnection(),
+        setFileName: doSetFileName,
+        getFileName: doGetFileName,
+        getWorkspaceName: doGetWorkspaceName,
+        setWorkspaceName: doSetWorkspaceName
+    };
+}
+export function deactivate() {
+    instance?.dispose();
+}
+//# sourceMappingURL=monaco-api.js.map

package/lib/monaco-api.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,4 @@
+export type { Peer } from '@hereugo/open-collaboration-protocol';
+export type { User } from '@hereugo/open-collaboration-protocol';
+export type { AuthMetadata } from '@hereugo/open-collaboration-protocol';
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAMA,YAAY,EAAE,IAAI,EAAE,MAAM,sCAAsC,CAAC;AACjE,YAAY,EAAE,IAAI,EAAE,MAAM,sCAAsC,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC"}

package/lib/types.js

@@ -0,0 +1,7 @@
+// ******************************************************************************
+// Copyright 2025 TypeFox GmbH
+// This program and the accompanying materials are made available under the
+// terms of the MIT License, which is available in the project root.
+// ******************************************************************************
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,8BAA8B;AAC9B,2EAA2E;AAC3E,oEAAoE;AACpE,iFAAiF"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@hereugo/open-collaboration-monaco",
+  "version": "0.3.3",
+  "license": "MIT",
+  "description": "Connect a single Monaco Editor to an Open Collaboration Tools session",
+  "files": [
+    "lib",
+    "src"
+  ],
+  "type": "module",
+  "main": "./lib/index.js",
+  "module": "./lib/index.js",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./example": {
+      "types": "./lib/example.d.ts",
+      "default": "./lib/example.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "lib/index.d.ts"
+      ],
+      "example": [
+        "lib/example.d.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "echo 'open-collaboration-protocol: Nothing extra to build.'"
+  },
+  "dependencies": {
+    "lodash": "~4.17.21",
+    "@hereugo/open-collaboration-protocol": "~0.3.1",
+    "@hereugo/open-collaboration-yjs": "~0.3.0"
+  },
+  "devDependencies": {
+    "@types/vscode": "^1.89.0"
+  },
+  "peerDependencies": {
+    "monaco-editor": ">= 0.44.0"
+  },
+  "keywords": [
+    "collaboration",
+    "live-share",
+    "real-time",
+    "pair-programming",
+    "monaco-editor"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eclipse-oct/open-collaboration-tools",
+    "directory": "packages/open-collaboration-monaco"
+  },
+  "bugs": {
+    "url": "https://github.com/eclipse-oct/open-collaboration-tools/issues"
+  },
+  "homepage": "https://www.open-collab.tools/",
+  "author": {
+    "name": "TypeFox",
+    "url": "https://www.typefox.io/"
+  },
+  "volta": {
+    "node": "22.14.0",
+    "npm": "10.9.2"
+  },
+  "engines": {
+    "node": ">=20.10.0",
+    "npm": ">=10.2.3"
+  }
+}

package/src/collaboration-connection.ts

@@ -0,0 +1,69 @@
+// ******************************************************************************
+// Copyright 2024 TypeFox GmbH
+// This program and the accompanying materials are made available under the
+// terms of the MIT License, which is available in the project root.
+// ******************************************************************************
+
+import { ConnectionProvider, CreateRoomResponse, JoinRoomResponse, stringifyError } from '@hereugo/open-collaboration-protocol';
+import { CollaborationInstance } from './collaboration-instance.js';
+import { MonacoCollabCallbacks } from './monaco-api.js';
+
+export async function login(connectionProvider: ConnectionProvider): Promise<void> {
+    const valid = await connectionProvider.validate();
+    if (!valid) {
+        await connectionProvider.login({});
+    }
+}
+
+export async function createRoom(connectionProvider: ConnectionProvider, callbacks: MonacoCollabCallbacks): Promise<CollaborationInstance | undefined> {
+    if (!connectionProvider) {
+        return undefined;
+    }
+    const roomClaim = await connectionProvider.createRoom({reporter: callbacks.statusReporter});
+    if (roomClaim.loginToken) {
+        const userToken = roomClaim.loginToken;
+        console.log('User Token:', userToken);
+    }
+
+    console.log('Room ID:', roomClaim.roomId);
+    return await connectToRoom(connectionProvider, roomClaim, true, callbacks);
+}
+
+export async function joinRoom(connectionProvider: ConnectionProvider, callbacks: MonacoCollabCallbacks, roomId?: string): Promise<CollaborationInstance | {message: string}> {
+    if (!roomId) {
+        console.log('No room ID provided');
+        // TODO show input box to enter the room ID
+        // roomId = await vscode.window.showInputBox({ placeHolder: 'Enter the room ID' })
+    }
+    if (roomId && connectionProvider) {
+        try {
+            const roomClaim = await connectionProvider.joinRoom({roomId, reporter: callbacks.statusReporter});
+            const instance = await connectToRoom(connectionProvider, roomClaim, false, callbacks);
+            if (!instance) {
+                console.log('No collaboration instance found');
+                return {message: 'Joining room failed'};
+            }
+            const workspace = roomClaim.workspace;
+            console.log('Workspace:', workspace);
+            return instance;
+        } catch (error) {
+            return {message: stringifyError(error)};
+        }
+    }
+    return {message: 'No room ID provided'};
+}
+
+export async function connectToRoom(connectionProvider: ConnectionProvider, roomClaim: CreateRoomResponse | JoinRoomResponse, isHost: boolean, callbacks: MonacoCollabCallbacks) {
+    const host = 'host' in roomClaim ? roomClaim.host : undefined;
+    const connection = await connectionProvider.connect(roomClaim.roomToken, host);
+    const instance = new CollaborationInstance({
+        connection,
+        host: isHost,
+        callbacks,
+        roomClaim
+    });
+    connection.onDisconnect(() => {
+        instance?.dispose();
+    });
+    return instance;
+}