@datalayer/core 0.0.12 → 0.0.14

package/lib/state/substates/RuntimesState.js

@@ -6,7 +6,7 @@ import { useStore } from 'zustand';
 import { createStore } from 'zustand/vanilla';
 import { JSONExt } from '@lumino/coreutils';
 import { Poll } from '@lumino/polling';
-import { getRuntimes } from '../../sdk/stateful/runtimes';
+import { getRuntimes } from '../../stateful/runtimes';
 import { coreStore } from './CoreState';
 import { iamStore } from './IAMState';
 /**

package/lib/{sdk/stateful → stateful}/index.d.ts

@@ -1,3 +1,3 @@
 export * from './jupyter';
 export * from './runtimes';
-export * from '../../api/DatalayerApi';
+export * from '../api/DatalayerApi';

package/lib/{sdk/stateful → stateful}/index.js

@@ -4,4 +4,4 @@
  */
 export * from './jupyter';
 export * from './runtimes';
-export * from '../../api/DatalayerApi';
+export * from '../api/DatalayerApi';

package/lib/{sdk/stateful → stateful}/jupyter/exec/Snippets.d.ts

@@ -5,11 +5,6 @@ export interface IRuntimeSnippets {
     /**
      * Code snippet to change the current working directory.
      *
-     * The code snippet has no returned value.
-     *
-     * The path is relative to the home directory and use
-     * the separator `/`.
-     *
      * @param path New current directory
      * @returns The code snippet
      */
@@ -17,21 +12,12 @@ export interface IRuntimeSnippets {
     /**
      * Code snippet to list the transferable kernel variables.
      *
-     * The code snippet must return a serialized-JSON
-     * dictionary (<variable name>, <variable type>)
-     *
      * @returns The code snippet
      */
     listVariables(): string;
     /**
      * Code snippet to load kernel variables.
      *
-     * The code snippet must return a serialized-JSON list
-     * with successfully loaded variables.
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed from {@link saveVariables}.
-     *
      * @param variables Serialized-JSON dictionary (<variable name>, <variable value blob>)
      * @returns The code snippet
      */
@@ -39,13 +25,6 @@ export interface IRuntimeSnippets {
     /**
      * Code snippet to save kernel variables.
      *
-     * The code snippet must return a serialized-JSON dictionary
-     * (<variable name>, <variable value blob>).
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed to {@link loadVariables}
-     * without modification.
-     *
      * @param variables Variable names.
      * @returns The code snippet
      */
@@ -78,10 +57,7 @@ export declare class RuntimeSnippetsFacade {
     static supports(language: string): boolean;
     private _language;
     /**
-     * Create a kernel snippet generator for a given kernel
-     * language.
-     *
-     * It will raise if the language is not available.
+     * Create a kernel snippet generator for a given kernel language.
      *
      * @param language Kernel language
      */
@@ -102,21 +78,12 @@ export declare class RuntimeSnippetsFacade {
     /**
      * Code snippet to list the transferable kernel variables.
      *
-     * The code snippet must return a serialized-JSON
-     * dictionary (<variable name>, <variable type>)
-     *
      * @returns The code snippet
      */
     listVariables(): string;
     /**
      * Code snippet to load kernel variables.
      *
-     * The code snippet must return a serialized-JSON list
-     * with successfully loaded variables.
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed from {@link saveVariables}.
-     *
      * @param variables Serialized-JSON dictionary (<variable name>, <variable value blob>)
      * @returns The code snippet
      */
@@ -124,13 +91,6 @@ export declare class RuntimeSnippetsFacade {
     /**
      * Code snippet to save kernel variables.
      *
-     * The code snippet must return a serialized-JSON dictionary
-     * (<variable name>, <variable value blob>).
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed to {@link loadVariables}
-     * without modification.
-     *
      * @param variables Variable names.
      * @returns The code snippet
      */

package/lib/{sdk/stateful → stateful}/jupyter/exec/Snippets.js

@@ -27,10 +27,7 @@ export class RuntimeSnippetsFacade {
     }
     _language;
     /**
-     * Create a kernel snippet generator for a given kernel
-     * language.
-     *
-     * It will raise if the language is not available.
+     * Create a kernel snippet generator for a given kernel language.
      *
      * @param language Kernel language
      */
@@ -62,9 +59,6 @@ export class RuntimeSnippetsFacade {
     /**
      * Code snippet to list the transferable kernel variables.
      *
-     * The code snippet must return a serialized-JSON
-     * dictionary (<variable name>, <variable type>)
-     *
      * @returns The code snippet
      */
     listVariables() {
@@ -73,12 +67,6 @@ export class RuntimeSnippetsFacade {
     /**
      * Code snippet to load kernel variables.
      *
-     * The code snippet must return a serialized-JSON list
-     * with successfully loaded variables.
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed from {@link saveVariables}.
-     *
      * @param variables Serialized-JSON dictionary (<variable name>, <variable value blob>)
      * @returns The code snippet
      */
@@ -90,13 +78,6 @@ export class RuntimeSnippetsFacade {
     /**
      * Code snippet to save kernel variables.
      *
-     * The code snippet must return a serialized-JSON dictionary
-     * (<variable name>, <variable value blob>).
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed to {@link loadVariables}
-     * without modification.
-     *
      * @param variables Variable names.
      * @returns The code snippet
      */

package/lib/{sdk/stateful → stateful}/runtimes/actions.d.ts

@@ -1,5 +1,5 @@
 import { IRuntimeOptions } from '..';
-import type { IRuntimeSnapshot, IDatalayerEnvironment, IRuntimePod } from '../../../models';
+import type { IRuntimeSnapshot, IDatalayerEnvironment, IRuntimePod } from '../../models';
 /**
  * Get available Environments.
  */
@@ -42,7 +42,7 @@ export declare function snapshotRuntime(options: {
      */
     description?: string;
     /**
-     * Whether to stop the kernel after the snapshot completion or not.
+     * Whether to stop the runtime after the snapshot completion or not.
      */
     stop?: boolean;
 }): Promise<IRuntimeSnapshot>;
@@ -51,7 +51,7 @@ export declare function snapshotRuntime(options: {
  */
 export declare function getRuntimeSnapshots(): Promise<IRuntimeSnapshot[]>;
 /**
- * Load a Runtime Snapshot within a kernel.
+ * Load a Runtime Snapshot within a Runtime.
  */
 export declare function loadRuntimeSnapshot(options: {
     /**

package/lib/{sdk/stateful → stateful}/runtimes/actions.js

@@ -9,9 +9,9 @@ import { URLExt } from '@jupyterlab/coreutils';
 import { PromiseDelegate } from '@lumino/coreutils';
 import { Upload } from 'tus-js-client';
 import { requestDatalayerAPI, } from '..';
-import { asRuntimeSnapshot } from '../../../models';
-import { iamStore, runtimesStore } from '../../../state';
-import { sleep } from '../../../utils';
+import { asRuntimeSnapshot } from '../../models';
+import { iamStore, runtimesStore } from '../../state';
+import { sleep } from '../../utils';
 /**
  * Get available Environments.
  */
@@ -111,7 +111,7 @@ export async function snapshotRuntime(options) {
         token: iamStore.getState().token,
     });
     if (!data.success || !data.snapshot) {
-        throw new Error(`Failed to pause the kernel snapshot ${options.id} - ${data}`);
+        throw new Error(`Failed to take the runtime snapshot ${options.id} - ${data}`);
     }
     return asRuntimeSnapshot(data.snapshot);
 }
@@ -124,13 +124,13 @@ export async function getRuntimeSnapshots() {
         token: iamStore.getState().token,
     });
     if (!data.success) {
-        console.error('Failed to fetch kernel snapshots.', data);
+        console.error('Failed to fetch runtime snapshots.', data);
         return [];
     }
     return (data.snapshots ?? []).map(asRuntimeSnapshot);
 }
 /**
- * Load a Runtime Snapshot within a kernel.
+ * Load a Runtime Snapshot within a Runtime.
  */
 export async function loadRuntimeSnapshot(options) {
     const data = await requestDatalayerAPI({
@@ -142,7 +142,7 @@ export async function loadRuntimeSnapshot(options) {
         token: iamStore.getState().token,
     });
     if (!data.success) {
-        throw new Error(`Failed to load the kernel snapshot; ${data.message}`);
+        throw new Error(`Failed to load the runtime snapshot; ${data.message}`);
     }
 }
 /**
@@ -181,7 +181,7 @@ export async function deleteRuntimeSnapshot(id) {
         method: 'DELETE',
         token: iamStore.getState().token,
     });
-    // Poll Runtime Snapshot state up-to its deletion
+    // Poll Runtime Snapshot state up-to its deletion.
     try {
         let sleepTimeout = 1000;
         while (true) {

package/lib/{sdk/stateful → stateful}/runtimes/apis.d.ts

@@ -5,7 +5,7 @@ import { ISessionContext } from '@jupyterlab/apputils';
 import { ServiceManager, Kernel, ServerConnection } from '@jupyterlab/services';
 import { IDisposable } from '@lumino/disposable';
 import { ISignal } from '@lumino/signaling';
-import type { IRuntimeSnapshot, IRuntimeCapabilities, IRuntimeModel, IDatalayerEnvironment, IRuntimeType, IRuntimeLocation } from '../../../models';
+import type { IRuntimeSnapshot, IRuntimeCapabilities, IRuntimeModel, IDatalayerEnvironment, IRuntimeType, IRuntimeLocation } from '../../models';
 /**
  * Abstract interface for the Datalayer session context.
  * It extends the JupyterLab session context
@@ -160,16 +160,16 @@ export interface IRemoteRuntimesManager extends IDisposable {
      */
     refreshKernels(): Promise<void>;
     /**
-     * Snapshot a remote kernel
+     * Snapshot a runtime
      *
-     * The remote kernel may be given by its `id` or `podName`.
+     * The runtime may be given by its `id` or `podName`.
      * A custom description for the snapshot can be provided.
      *
      * @returns The snapshot description
      */
-    snapshot(options: {
+    snapshotRuntime(options: {
         /**
-         * The kernel id to snapshot
+         * The runtime id to snapshot
          */
         id?: string;
         /**
@@ -190,11 +190,11 @@ export interface IRemoteRuntimesManager extends IDisposable {
         stop?: boolean;
     }): Promise<IRuntimeSnapshot | undefined>;
     /**
-     * Load a snapshot within a remote kernel
+     * Load a snapshot within a runtim
      *
-     * The remote kernel may be given by its `id` or `podName`.
+     * The runtime may be given by its `id` or `podName`.
      */
-    loadSnapshot(options: {
+    loadRuntimeSnapshot(options: {
         /**
          * The kernel id
          */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/core",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "type": "module",
   "workspaces": [
     ".",
@@ -45,12 +45,14 @@
   },
   "scripts": {
     "dev": "vite",
-    "build": "gulp resources-to-lib && tsc -b && vite build",
-    "build:lib": "gulp resources-to-lib && tsc -b",
-    "build:types": "tsc -b",
+    "clean": "rimraf lib dist build tsconfig.tsbuildinfo",
+    "clean:lib": "rimraf lib tsconfig.tsbuildinfo",
+    "clean:dist": "rimraf dist",
+    "build": "npm run clean && gulp resources-to-lib && tsc -b && vite build",
+    "build:lib": "npm run clean:lib && gulp resources-to-lib && tsc -b",
+    "build:types": "npm run clean:lib && tsc -b",
     "build:nextjs": "npm run build --workspace=nextjs-notebook-example",
-    "build:electron": "npm run build --workspace=@datalayer/desktop",
-    "build:examples": "npm run build:nextjs && npm run build:electron",
+    "build:examples": "npm run build:nextjs",
     "build:all": "npm run build && npm run build:examples",
     "lint": "eslint . --quiet",
     "lint:fix": "eslint . --fix",
@@ -68,7 +70,6 @@
     "check:fix": "npm run format:all && npm run lint:fix && npm run type-check:all",
     "preview": "vite preview",
     "start": "vite",
-    "clean": "rimraf lib tsconfig.tsbuildinfo",
     "test": "vitest run --project=unit --project=general",
     "test:watch": "vitest --project=unit --project=general",
     "test:ui": "vitest --ui --project=unit --project=general",
@@ -81,11 +82,10 @@
     "typedoc": "typedoc --options typedoc.json --out docs/docs/typescript_api",
     "watch:lib": "run-p 'watch:lib:*'",
     "watch:lib:res": "gulp resources-to-lib-watch",
-    "watch:lib:src": "echo 'Type checking moved to separate command. Use npm run type-check:watch'",
+    "watch:lib:src": "tsc -b -w",
     "type-check:watch": "tsc -b -w --noEmit",
     "example": "vite --config vite.examples.config.ts",
     "example:nextjs": "npm run dev --workspace=nextjs-notebook-example",
-    "example:electron": "cd examples/electron && npm run dev",
     "prepare": "husky"
   },
   "dependencies": {
@@ -101,8 +101,9 @@
     "@primer/octicons-react": "^19.15.1",
     "@primer/primitives": "^10.5.0",
     "@primer/react": "^37.19.0",
-    "@primer/react-brand": "^0.51.0",
+    "@primer/react-brand": "^0.58.0",
     "@stripe/react-stripe-js": "^2.7.1",
+    "@tanstack/react-query": "^5.90.6",
     "axios": "^1.7.7",
     "boring-avatars": "^2.0.1",
     "buffer": "^6.0.3",
@@ -118,10 +119,12 @@
     "react": "18.3.1",
     "react-confetti": "^6.4.0",
     "react-dom": "18.3.1",
+    "react-toastify": "^11.0.5",
     "tus-js-client": "^4.2.3",
     "ulid": "^2.3.0",
     "unique-names-generator": "^4.7.1",
     "usehooks-ts": "^2.9.1",
+    "uuid": "^13.0.0",
     "validator": "^13.7.0",
     "zustand": "^4.4.1"
   },

package/lib/__tests__/hooks.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/__tests__/hooks.test.js

@@ -1,19 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { describe, it, expect } from 'vitest';
-import { useCache } from '../hooks';
-describe('hooks', () => {
-    it('should export qfds constant', () => {
-        expect(useCache).toBeDefined();
-    });
-    /*
-    it('useCache should have correct value', () => {
-      expect(useCache).toBe('');
-    });
-    it('useCache should be a string', () => {
-      expect(typeof useCache).toBe('string');
-    });
-    */
-});

package/lib/__tests__/index.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/__tests__/index.test.js

@@ -1,27 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { describe, it, expect } from 'vitest';
-import * as coreIndex from '../index';
-describe('@datalayer/core - index', () => {
-    it('should export BackdropContext from hooks', () => {
-        expect(coreIndex.BackdropContext).toBeDefined();
-        expect(coreIndex.BackdropContext).toHaveProperty('$$typeof');
-        expect(typeof coreIndex.BackdropContext).toBe('object');
-    });
-    it('should export utils functions', () => {
-        expect(coreIndex.convertToLargestUnit).toBeDefined();
-        expect(coreIndex.asArray).toBeDefined();
-    });
-    it('should export DatalayerServiceManager from services', () => {
-        expect(coreIndex.createDatalayerServiceManager).toBeDefined();
-        expect(typeof coreIndex.createDatalayerServiceManager).toBe('function');
-    });
-    it('should have all expected exports', () => {
-        const exports = Object.keys(coreIndex);
-        expect(exports).toContain('convertToLargestUnit');
-        expect(exports).toContain('asArray');
-        expect(exports).toContain('createDatalayerServiceManager');
-    });
-});

package/lib/__tests__/integration.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/__tests__/integration.test.js

@@ -1,57 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { describe, it, expect } from 'vitest';
-describe('@datalayer/core - Integration Tests', () => {
-    it('should have proper TypeScript compilation', () => {
-        // This test ensures TypeScript compilation is working
-        const testNumber = 42;
-        const testString = 'hello';
-        const testBoolean = true;
-        expect(typeof testNumber).toBe('number');
-        expect(typeof testString).toBe('string');
-        expect(typeof testBoolean).toBe('boolean');
-    });
-    it('should support modern JavaScript features', () => {
-        // Test arrow functions
-        const add = (a, b) => a + b;
-        expect(add(2, 3)).toBe(5);
-        // Test template literals
-        const name = 'Datalayer';
-        const greeting = `Hello, ${name}!`;
-        expect(greeting).toBe('Hello, Datalayer!');
-        // Test destructuring
-        const obj = { x: 1, y: 2 };
-        const { x, y } = obj;
-        expect(x).toBe(1);
-        expect(y).toBe(2);
-        // Test spread operator
-        const arr1 = [1, 2, 3];
-        const arr2 = [...arr1, 4, 5];
-        expect(arr2).toEqual([1, 2, 3, 4, 5]);
-    });
-    it('should support async/await', async () => {
-        const asyncFunction = async () => {
-            return new Promise(resolve => {
-                setTimeout(() => resolve('async result'), 10);
-            });
-        };
-        const result = await asyncFunction();
-        expect(result).toBe('async result');
-    });
-    it('should support generics', () => {
-        function identity(arg) {
-            return arg;
-        }
-        expect(identity('test')).toBe('test');
-        expect(identity(123)).toBe(123);
-        expect(identity(true)).toBe(true);
-    });
-    it('should handle error cases', () => {
-        const throwError = () => {
-            throw new Error('Test error');
-        };
-        expect(throwError).toThrow('Test error');
-    });
-});

package/lib/__tests__/shared/cleanup-shared.d.ts

@@ -1,4 +0,0 @@
-/**
- * Shared cleanup logic for both setup and teardown
- */
-export declare function performCleanup(phase: 'setup' | 'teardown'): Promise<void>;