@datalayer/core 1.0.20 → 1.0.22

package/README.md

@@ -124,6 +124,33 @@ datalayer runtime exec my-script.py --runtime <runtime-id>
 datalayer snapshots create <pod-name> my-snapshot 'AI work!' False
 ```
 
+### 4. Subscription and Credits CLI
+
+Use these commands to inspect billing and manage credits distribution.
+
+```bash
+# End-user billing view
+datalayer subscriptions show
+datalayer subscriptions available
+datalayer subscriptions move
+datalayer subscriptions topups
+datalayer subscriptions dry-run
+
+# Organization and team credits visibility
+datalayer usage org-overview --organization-uid <org_uid>
+datalayer usage team-overview --team-uid <team_uid>
+
+# Monitoring-driven credit management
+datalayer usage org-monitor --organization-uid <org_uid> --window-hours 24
+datalayer usage team-monitor --team-uid <team_uid> --window-hours 24
+
+# Credits transfer operations (owners/admins)
+datalayer usage org-allocate-team --organization-uid <org_uid> --team-uid <team_uid> --amount 50
+datalayer usage org-revoke-team --organization-uid <org_uid> --team-uid <team_uid> --amount 20
+datalayer usage team-allocate-member --team-uid <team_uid> --member-uid <member_uid> --amount 15
+datalayer usage team-revoke-member --team-uid <team_uid> --member-uid <member_uid> --amount 5
+```
+
 ## Examples
 
 ### Python Examples

package/lib/api/DatalayerApi.d.ts

@@ -14,7 +14,7 @@ export declare class RunResponseError extends Error {
     /**
      * Create a new response error.
      */
-    constructor(response: Response, message?: string, warnings?: undefined, errors?: undefined, exceptionMessage?: undefined, traceback?: string);
+    constructor(response: Response, message?: string, warnings?: undefined, errors?: undefined, exceptionMessage?: undefined, traceback?: string, detail?: unknown);
     /**
      * Warnings listed in the response.
      */
@@ -35,6 +35,10 @@ export declare class RunResponseError extends Error {
      * The traceback associated with the error.
      */
     readonly traceback: string;
+    /**
+     * Optional structured backend detail payload.
+     */
+    readonly detail: unknown;
     private static _defaultMessage;
 }
 /**

package/lib/api/DatalayerApi.js

@@ -11,6 +11,24 @@
 import { URLExt } from '@jupyterlab/coreutils';
 import axios from 'axios';
 import { sleep } from '../utils/Sleep.js';
+function isFormDataBody(body) {
+    if (!body || typeof body !== 'object') {
+        return false;
+    }
+    // `instanceof FormData` is not reliable across realms (e.g. jsdom/undici).
+    if (typeof FormData !== 'undefined' && body instanceof FormData) {
+        return true;
+    }
+    const formDataTag = Object.prototype.toString.call(body);
+    if (formDataTag === '[object FormData]') {
+        return true;
+    }
+    const candidate = body;
+    return (typeof candidate.append === 'function' &&
+        typeof candidate.get === 'function' &&
+        typeof candidate.has === 'function' &&
+        typeof candidate.entries === 'function');
+}
 /**
  * Error wrapper for failed HTTP responses.
  * Includes response details, warnings, errors, and tracebacks.
@@ -26,11 +44,17 @@ export class RunResponseError extends Error {
     static async create(response) {
         try {
             const data = await response.json();
-            const { message, errors, warnings, traceback, exception } = data;
+            const { message, errors, warnings, traceback, exception, detail } = data;
+            const resolvedMessage = message ??
+                (typeof detail === 'string'
+                    ? detail
+                    : detail && typeof detail === 'object' && 'message' in detail
+                        ? String(detail.message)
+                        : undefined);
             if (traceback) {
                 console.error(traceback);
             }
-            const responseError = new RunResponseError(response, message ?? RunResponseError._defaultMessage(response), warnings, errors, exception, traceback ?? '');
+            const responseError = new RunResponseError(response, resolvedMessage ?? RunResponseError._defaultMessage(response), warnings, errors, exception, traceback ?? '', detail);
             return responseError;
         }
         catch (e) {
@@ -41,7 +65,7 @@ export class RunResponseError extends Error {
     /**
      * Create a new response error.
      */
-    constructor(response, message = RunResponseError._defaultMessage(response), warnings = undefined, errors = undefined, exceptionMessage = undefined, traceback = '') {
+    constructor(response, message = RunResponseError._defaultMessage(response), warnings = undefined, errors = undefined, exceptionMessage = undefined, traceback = '', detail = undefined) {
         super(message);
         this.name = 'RunResponseError';
         this.warnings = warnings ?? [];
@@ -49,6 +73,7 @@ export class RunResponseError extends Error {
         this.response = response;
         this.exceptionMessage = exceptionMessage;
         this.traceback = traceback;
+        this.detail = detail;
     }
     /**
      * Warnings listed in the response.
@@ -70,6 +95,10 @@ export class RunResponseError extends Error {
      * The traceback associated with the error.
      */
     traceback;
+    /**
+     * Optional structured backend detail payload.
+     */
+    detail;
     static _defaultMessage(response) {
         return `Invalid response: ${response.status} ${response.statusText}`;
     }
@@ -110,7 +139,7 @@ export class NetworkError extends TypeError {
  */
 export async function requestDatalayerAPI({ url, method, body, token, signal, headers = {}, }) {
     // Handle FormData differently from JSON
-    const isFormData = body instanceof FormData;
+    const isFormData = isFormDataBody(body);
     // Prepare axios config
     const axiosConfig = {
         url,
@@ -198,10 +227,28 @@ export async function requestDatalayerAPI({ url, method, body, token, signal, he
 async function handleAxiosRedirection(response, originalConfig) {
     let redirect = response.headers.location;
     if (redirect) {
-        const parsedURL = URLExt.parse(originalConfig.url);
-        const baseUrl = parsedURL.protocol + '//' + parsedURL.hostname;
-        if (!redirect.startsWith(baseUrl)) {
-            redirect = URLExt.join(baseUrl, redirect);
+        const baseUrl = originalConfig.url ?? '';
+        const normalizedRedirect = String(redirect).replace(/^([a-z][a-z0-9+.-]*):\/(?!\/)/i, '$1://');
+        try {
+            const resolved = new URL(normalizedRedirect, baseUrl);
+            const base = new URL(baseUrl, typeof window !== 'undefined' ? window.location.origin : undefined);
+            // If a proxy emits an http Location for the same host while the
+            // original request is https, force https to avoid mixed-content errors
+            // that browsers often report as CORS/network failures.
+            if (base.protocol === 'https:' &&
+                resolved.protocol === 'http:' &&
+                resolved.hostname === base.hostname) {
+                resolved.protocol = 'https:';
+                if (resolved.port === '80') {
+                    resolved.port = '';
+                }
+            }
+            redirect = resolved.toString();
+        }
+        catch {
+            const parsedURL = URLExt.parse(baseUrl);
+            const fallbackBase = parsedURL.protocol + '//' + parsedURL.hostname;
+            redirect = URLExt.join(fallbackBase, normalizedRedirect);
         }
     }
     let sleepTimeout = 1000;

package/lib/api/iam/oauth2.d.ts

@@ -1,7 +1,7 @@
 /**
  * OAuth2 provider types supported by the platform
  */
-export type OAuth2Provider = 'github' | 'linkedin' | 'okta';
+export type OAuth2Provider = 'github' | 'google' | 'linkedin' | 'okta';
 /**
  * Response from the OAuth2 authorization URL endpoint
  */
@@ -26,7 +26,7 @@ export interface OAuth2CallbackParams {
 export type OAuth2CallbackResponse = string;
 /**
  * Get the OAuth2 authorization URL for a specific provider
- * @param provider - OAuth2 provider (bluesky, github, linkedin, okta)
+ * @param provider - OAuth2 provider (github, google, linkedin, okta)
  * @param callbackUri - Server endpoint to call with the authz token
  * @param nonce - Optional nonce for security
  * @param baseUrl - Base URL for the API (defaults to production IAM URL)
@@ -45,7 +45,7 @@ export type OAuth2CallbackResponse = string;
 export declare const getOAuth2AuthzUrl: (provider: OAuth2Provider, callbackUri: string, nonce?: string, baseUrl?: string) => Promise<OAuth2AuthzUrlResponse>;
 /**
  * Get the OAuth2 authorization URL for linking a provider to an existing account
- * @param provider - OAuth2 provider (bluesky, github, linkedin, okta)
+ * @param provider - OAuth2 provider (github, google, linkedin, okta)
  * @param callbackUri - Server endpoint to call with the authz token
  * @param baseUrl - Base URL for the API (defaults to production IAM URL)
  * @returns OAuth2 authorization URL response

package/lib/api/iam/oauth2.js

@@ -13,7 +13,7 @@ import { requestDatalayerAPI } from '../DatalayerApi.js';
 import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants.js';
 /**
  * Get the OAuth2 authorization URL for a specific provider
- * @param provider - OAuth2 provider (bluesky, github, linkedin, okta)
+ * @param provider - OAuth2 provider (github, google, linkedin, okta)
  * @param callbackUri - Server endpoint to call with the authz token
  * @param nonce - Optional nonce for security
  * @param baseUrl - Base URL for the API (defaults to production IAM URL)
@@ -71,7 +71,7 @@ export const getOAuth2AuthzUrl = async (provider, callbackUri, nonce, baseUrl =
 };
 /**
  * Get the OAuth2 authorization URL for linking a provider to an existing account
- * @param provider - OAuth2 provider (bluesky, github, linkedin, okta)
+ * @param provider - OAuth2 provider (github, google, linkedin, okta)
  * @param callbackUri - Server endpoint to call with the authz token
  * @param baseUrl - Base URL for the API (defaults to production IAM URL)
  * @returns OAuth2 authorization URL response

package/lib/api/iam/profile.d.ts

@@ -1,4 +1,4 @@
-import { MembershipsResponse, UserMeResponse, WhoAmIResponse } from '../../models/IAM';
+import { MembershipsResponse, ShareablePrincipalsResponse, UserMeResponse, WhoAmIResponse } from '../../models/IAM';
 /**
  * Get current authenticated user profile
  * @param token - Authentication token (required)
@@ -20,3 +20,11 @@ export declare const whoami: (token: string, baseUrl?: string) => Promise<WhoAmI
  * @returns Current user identity and profile information
  */
 export declare const memberships: (token: string, baseUrl?: string) => Promise<MembershipsResponse>;
+/**
+ * Get the set of principals the authenticated user can share artifacts with
+ * (self + member organizations + member teams).
+ *
+ * @param token - Authentication token (required)
+ * @param baseUrl - Base URL for the API (defaults to production IAM URL)
+ */
+export declare const principalsShareable: (token: string, baseUrl?: string) => Promise<ShareablePrincipalsResponse>;

package/lib/api/iam/profile.js

@@ -54,3 +54,18 @@ export const memberships = async (token, baseUrl = DEFAULT_SERVICE_URLS.IAM) =>
         token,
     });
 };
+/**
+ * Get the set of principals the authenticated user can share artifacts with
+ * (self + member organizations + member teams).
+ *
+ * @param token - Authentication token (required)
+ * @param baseUrl - Base URL for the API (defaults to production IAM URL)
+ */
+export const principalsShareable = async (token, baseUrl = DEFAULT_SERVICE_URLS.IAM) => {
+    validateToken(token);
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.IAM}/principals/shareable`,
+        method: 'GET',
+        token,
+    });
+};

package/lib/api/runtimes/checkpoints.js

@@ -6,7 +6,7 @@
  * Runtime checkpoints API functions for the Datalayer platform.
  *
  * Provides functions for managing CRIU full-pod checkpoints.
- * These are distinct from runtime snapshots (Jupyter sandbox snapshots).
+ * These are distinct from code sandbox snapshots (Jupyter sandbox snapshots).
  *
  * @module api/runtimes/checkpoints
  */

package/lib/api/runtimes/snapshots.d.ts

@@ -1,4 +1,4 @@
-import { CreateRuntimeSnapshotRequest, ListRuntimeSnapshotsResponse, GetRuntimeSnapshotResponse, CreateRuntimeSnapshotResponse } from '../../models/RuntimeSnapshotDTO';
+import { CreateCodeSandboxSnapshotRequest, ListCodeSandboxSnapshotsResponse, GetCodeSandboxSnapshotResponse, CreateCodeSandboxSnapshotResponse } from '../../models/CodeSandboxSnapshotDTO';
 /**
  * Create a snapshot of a runtime instance.
  * @param token - Authentication token
@@ -7,17 +7,17 @@ import { CreateRuntimeSnapshotRequest, ListRuntimeSnapshotsResponse, GetRuntimeS
  * @returns Promise resolving to the created snapshot response
  * @throws {Error} If authentication token is missing or invalid
  */
-export declare const createSnapshot: (token: string, data: CreateRuntimeSnapshotRequest, baseUrl?: string) => Promise<CreateRuntimeSnapshotResponse>;
+export declare const createSnapshot: (token: string, data: CreateCodeSandboxSnapshotRequest, baseUrl?: string) => Promise<CreateCodeSandboxSnapshotResponse>;
 /**
- * List all runtime snapshots.
+ * List all code sandbox snapshots.
  * @param token - Authentication token
  * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
  * @returns Promise resolving to list of snapshots
  * @throws {Error} If authentication token is missing or invalid
  */
-export declare const listSnapshots: (token: string, baseUrl?: string) => Promise<ListRuntimeSnapshotsResponse>;
+export declare const listSnapshots: (token: string, baseUrl?: string) => Promise<ListCodeSandboxSnapshotsResponse>;
 /**
- * Get details for a specific runtime snapshot.
+ * Get details for a specific code sandbox snapshot.
  * @param token - Authentication token
  * @param snapshotId - The unique identifier of the snapshot
  * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
@@ -25,9 +25,9 @@ export declare const listSnapshots: (token: string, baseUrl?: string) => Promise
  * @throws {Error} If authentication token is missing or invalid
  * @throws {Error} If snapshot ID is missing or invalid
  */
-export declare const getSnapshot: (token: string, snapshotId: string, baseUrl?: string) => Promise<GetRuntimeSnapshotResponse>;
+export declare const getSnapshot: (token: string, snapshotId: string, baseUrl?: string) => Promise<GetCodeSandboxSnapshotResponse>;
 /**
- * Delete a runtime snapshot.
+ * Delete a code sandbox snapshot.
  * @param token - Authentication token
  * @param snapshotId - The unique identifier of the snapshot to delete
  * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)

package/lib/api/runtimes/snapshots.js

@@ -3,9 +3,9 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * Runtime snapshots API functions for the Datalayer platform.
+ * Code Sandbox snapshots API functions for the Datalayer platform.
  *
- * Provides functions for managing runtime snapshots (saved runtime states).
+ * Provides functions for managing code sandbox snapshots (saved runtime states).
  *
  * @module api/runtimes/snapshots
  */
@@ -23,14 +23,14 @@ import { validateToken, validateRequiredString } from '../utils/validation.js';
 export const createSnapshot = async (token, data, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
     validateToken(token);
     return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtime-snapshots`,
+        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/sandbox-snapshots`,
         method: 'POST',
         token,
         body: data,
     });
 };
 /**
- * List all runtime snapshots.
+ * List all code sandbox snapshots.
  * @param token - Authentication token
  * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
  * @returns Promise resolving to list of snapshots
@@ -39,13 +39,13 @@ export const createSnapshot = async (token, data, baseUrl = DEFAULT_SERVICE_URLS
 export const listSnapshots = async (token, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
     validateToken(token);
     return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtime-snapshots`,
+        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/sandbox-snapshots`,
         method: 'GET',
         token,
     });
 };
 /**
- * Get details for a specific runtime snapshot.
+ * Get details for a specific code sandbox snapshot.
  * @param token - Authentication token
  * @param snapshotId - The unique identifier of the snapshot
  * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
@@ -57,13 +57,13 @@ export const getSnapshot = async (token, snapshotId, baseUrl = DEFAULT_SERVICE_U
     validateToken(token);
     validateRequiredString(snapshotId, 'Snapshot ID');
     return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtime-snapshots/${snapshotId}`,
+        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/sandbox-snapshots/${snapshotId}`,
         method: 'GET',
         token,
     });
 };
 /**
- * Delete a runtime snapshot.
+ * Delete a code sandbox snapshot.
  * @param token - Authentication token
  * @param snapshotId - The unique identifier of the snapshot to delete
  * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
@@ -75,7 +75,7 @@ export const deleteSnapshot = async (token, snapshotId, baseUrl = DEFAULT_SERVIC
     validateToken(token);
     validateRequiredString(snapshotId, 'Snapshot ID');
     return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtime-snapshots/${snapshotId}`,
+        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/sandbox-snapshots/${snapshotId}`,
         method: 'DELETE',
         token,
     });

package/lib/client/auth/storage.js

@@ -11,6 +11,68 @@
  * Token storage backend implementations
  */
 import { DATALAYER_IAM_TOKEN_KEY, DATALAYER_IAM_USER_KEY, } from '../../state/storage/IAMStorage.js';
+/**
+ * Resolve a real Node `require` function that survives bundling.
+ *
+ * `module.createRequire()` is the documented Node API for obtaining a
+ * require function that resolves modules against `node_modules`. Three
+ * runtimes need to be supported:
+ *
+ *   1. **Native Node ESM** (this package is `"type": "module"`). The
+ *      global `require` is undefined here, so we resolve `module` via
+ *      `process.getBuiltinModule('module')` (added in Node 22.3 / 20.16).
+ *   2. **Native Node CommonJS** and **bundler-injected CJS shims**
+ *      (e.g. webpack with `target: 'node'`). These expose a working
+ *      global `require`, and `require('module')` resolves to the real
+ *      Node builtin even after bundling.
+ *   3. **Native browser**. None of the above is available; we return
+ *      `null`.
+ *
+ * @returns A real Node `require`, or `null` outside Node, or
+ *   `undefined` if Node is detected but no `createRequire` source is
+ *   reachable (extremely old Node, or a hostile sandbox).
+ */
+function resolveNodeRequire() {
+    if (typeof process === 'undefined' || !process.versions?.node) {
+        return null;
+    }
+    const fname = typeof __filename !== 'undefined'
+        ? __filename
+        : process.cwd() + '/__datalayer_keytar_loader__.js';
+    // 1. ESM-safe path: process.getBuiltinModule (Node 22.3+ / 20.16+).
+    //    Lets a `"type": "module"` package reach into `module` without a
+    //    CommonJS-only `require`.
+    const nodeProcess = process;
+    try {
+        const mod = nodeProcess.getBuiltinModule?.('module');
+        if (typeof mod?.createRequire === 'function') {
+            return mod.createRequire(fname);
+        }
+    }
+    catch {
+        // Fall through to the CommonJS / bundler path.
+    }
+    // 2. CommonJS path: `require('module')` is left intact by webpack
+    //    when target: 'node'. Also covers older Node CJS where
+    //    getBuiltinModule does not exist.
+    try {
+        if (typeof require === 'function') {
+            const mod = require('module');
+            if (typeof mod?.createRequire === 'function') {
+                return mod.createRequire(fname);
+            }
+        }
+    }
+    catch {
+        // Fall through to globalThis.require.
+    }
+    // 3. Last-ditch: a globalThis.require shim from some host environments.
+    const g = globalThis;
+    if (typeof g.require === 'function') {
+        return g.require;
+    }
+    return undefined;
+}
 /**
  * Browser localStorage-based token storage
  */
@@ -136,21 +198,50 @@ export class NodeStorage {
             typeof process !== 'undefined' &&
             process.versions?.node) {
             try {
-                // Use eval to hide require from bundlers (Vite/Rollup/webpack)
-                const nodeRequire = eval('require');
-                try {
-                    this.keytar = nodeRequire('keytar');
-                }
-                catch {
-                    try {
-                        this.keytar = nodeRequire('@vscode/keytar');
-                    }
-                    catch {
-                        // Keyring not available
+                // Resolve a real Node `require` even when this module ends up
+                // inside a webpack bundle.
+                //
+                // Why not the previous `string-evaluated require` pattern? Webpack
+                // rewrites that pattern to its own loader (`__webpack_require__`),
+                // which has no entry for these runtime-only keyring modules
+                // (`@github/keytar`, `@vscode/keytar`, or legacy `keytar`)
+                // because the require call is hidden behind a string and is
+                // therefore invisible to webpack's static analysis — even when
+                // consumers declare those package IDs as commonjs/runtime
+                // externals. The result was that `this.keytar` silently stayed
+                // `null` in any webpacked host (e.g. the VS Code extension), so
+                // tokens written via `setAsync()` only landed in the in-memory
+                // `Map` and never made it to the OS keyring. They appeared to
+                // "save" within a session, but vanished on reload.
+                //
+                // `module.createRequire(...)` is the documented Node API for
+                // obtaining the real require, and webpack/Vite/Rollup all leave
+                // it intact when the host targets Node.
+                const nodeRequire = resolveNodeRequire();
+                if (nodeRequire) {
+                    // Try variants in order of preference:
+                    //   1. @github/keytar — actively maintained, ships prebuilt
+                    //      binaries for every platform in the npm tarball, so a
+                    //      single multi-platform VSIX / Electron build can ship
+                    //      it without per-OS rebuilds.
+                    //   2. @vscode/keytar — historically bundled with VS Code,
+                    //      no longer published to npm but still resolvable in
+                    //      some host environments.
+                    //   3. keytar — the original, deprecated upstream. Kept as a
+                    //      fallback so existing CLI installs that still depend
+                    //      on it keep working.
+                    for (const id of ['@github/keytar', '@vscode/keytar', 'keytar']) {
+                        try {
+                            this.keytar = nodeRequire(id);
+                            break;
+                        }
+                        catch {
+                            // Try next variant.
+                        }
                     }
                 }
             }
-            catch (e) {
+            catch {
                 // Keyring not available, tokens will not persist across sessions
                 console.warn('keytar not available, tokens will not persist');
             }

package/lib/client/index.d.ts

@@ -19,7 +19,7 @@ import type { UserDTO } from './../models/UserDTO';
 import type { CreditsDTO } from '../models/CreditsDTO';
 import type { EnvironmentDTO } from '../models/EnvironmentDTO';
 import type { RuntimeDTO } from '../models/RuntimeDTO';
-import type { RuntimeSnapshotDTO } from '../models/RuntimeSnapshotDTO';
+import type { CodeSandboxSnapshotDTO } from '../models/CodeSandboxSnapshotDTO';
 import type { SpaceDTO } from '../models/SpaceDTO';
 import type { NotebookDTO } from '../models/NotebookDTO';
 import type { LexicalDTO } from '../models/LexicalDTO';
@@ -65,8 +65,8 @@ export { RuntimeDTO as Runtime } from '../models/RuntimeDTO';
 export type { RuntimeJSON, RuntimeData, CreateRuntimeRequest, CreateRuntimeResponse, ListRuntimesResponse, } from '../models/RuntimeDTO';
 export { EnvironmentDTO as Environment } from '../models/EnvironmentDTO';
 export type { EnvironmentJSON, EnvironmentData, ListEnvironmentsResponse, } from '../models/EnvironmentDTO';
-export { RuntimeSnapshotDTO as Snapshot } from '../models/RuntimeSnapshotDTO';
-export type { RuntimeSnapshotJSON, RuntimeSnapshotData, CreateRuntimeSnapshotRequest, CreateRuntimeSnapshotResponse, GetRuntimeSnapshotResponse, ListRuntimeSnapshotsResponse, } from '../models/RuntimeSnapshotDTO';
+export { CodeSandboxSnapshotDTO as Snapshot } from '../models/CodeSandboxSnapshotDTO';
+export type { CodeSandboxSnapshotJSON, CodeSandboxSnapshotData, CreateCodeSandboxSnapshotRequest, CreateCodeSandboxSnapshotResponse, GetCodeSandboxSnapshotResponse, ListCodeSandboxSnapshotsResponse, } from '../models/CodeSandboxSnapshotDTO';
 export { SpaceDTO as Space } from '../models/SpaceDTO';
 export type { SpaceJSON, SpaceData, SpaceItem, CreateSpaceRequest, CreateSpaceResponse, SpacesForUserResponse, CollaborationSessionResponse, DeleteSpaceItemResponse, GetSpaceItemResponse, GetSpaceItemsResponse, CreateNotebookRequest, CreateNotebookResponse, GetNotebookResponse, UpdateNotebookRequest, UpdateNotebookResponse, UpdateSpaceRequest, GetSpaceResponse, UpdateSpaceResponse, DeleteSpaceResponse, GetSpaceDefaultItemsResponse, GetSpacesByTypeResponse, } from '../models/SpaceDTO';
 export { ProjectDTO as Project } from '../models/ProjectDTO';
@@ -97,7 +97,7 @@ export type { ISpace, IBaseSpace, IAnySpace, ISpaceVariant, } from '../models/Sp
 export type { IBaseTeam, IAnyTeam } from '../models/Team';
 export type { IOrganization, IAnyOrganization, IBaseOrganization, } from '../models/Organization';
 export type { IRuntimeModel, IRuntimePod, IRuntimeType, IRuntimeLocation, IRuntimeCapabilities, } from '../models/Runtime';
-export type { IRuntimeSnapshot } from '../models/RuntimeSnapshot';
+export type { ICodeSandboxSnapshot } from '../models/CodeSandboxSnapshot';
 export type { IDatalayerEnvironment, IResources, ISnippet, } from '../models/Environment';
 export type { IRole } from '../models/Role';
 export type { IAssignment } from '../models/Assignment';
@@ -170,9 +170,9 @@ export interface DatalayerClient {
     getRuntime(podName: string): Promise<RuntimeDTO>;
     deleteRuntime(podName: string): Promise<void>;
     terminateAllRuntimes(): Promise<PromiseSettledResult<void>[]>;
-    createSnapshot(podName: string, name: string, description: string, stop?: boolean): Promise<RuntimeSnapshotDTO>;
-    listSnapshots(): Promise<RuntimeSnapshotDTO[]>;
-    getSnapshot(id: string): Promise<RuntimeSnapshotDTO>;
+    createSnapshot(podName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
+    listSnapshots(): Promise<CodeSandboxSnapshotDTO[]>;
+    getSnapshot(id: string): Promise<CodeSandboxSnapshotDTO>;
     deleteSnapshot(id: string): Promise<void>;
     checkRuntimesHealth(): Promise<HealthCheck>;
     getMySpaces(): Promise<SpaceDTO[]>;

package/lib/client/index.js

@@ -68,7 +68,7 @@ export { DatalayerClientBase };
 export { UserDTO as User } from './../models/UserDTO.js';
 export { RuntimeDTO as Runtime } from '../models/RuntimeDTO.js';
 export { EnvironmentDTO as Environment } from '../models/EnvironmentDTO.js';
-export { RuntimeSnapshotDTO as Snapshot } from '../models/RuntimeSnapshotDTO.js';
+export { CodeSandboxSnapshotDTO as Snapshot } from '../models/CodeSandboxSnapshotDTO.js';
 export { SpaceDTO as Space } from '../models/SpaceDTO.js';
 export { ProjectDTO as Project } from '../models/ProjectDTO.js';
 export { NotebookDTO as Notebook } from '../models/NotebookDTO.js';

package/lib/client/mixins/RuntimesMixin.d.ts

@@ -1,7 +1,7 @@
 import type { Constructor } from '../utils/mixins';
 import { EnvironmentDTO } from '../../models/EnvironmentDTO';
 import { RuntimeDTO } from '../../models/RuntimeDTO';
-import { RuntimeSnapshotDTO } from '../../models/RuntimeSnapshotDTO';
+import { CodeSandboxSnapshotDTO } from '../../models/CodeSandboxSnapshotDTO';
 import { HealthCheck } from '../../models/HealthCheck';
 /** Options for ensuring a runtime is available. */
 export interface EnsureRuntimeOptions {
@@ -22,7 +22,7 @@ export interface EnsureRuntimeOptions {
 export declare function RuntimesMixin<TBase extends Constructor>(Base: TBase): {
     new (...args: any[]): {
         _extractRuntimePodName(runtimePodNameOrInstance: string | RuntimeDTO): string;
-        _extractSnapshotId(snapshotIdOrInstance: string | RuntimeSnapshotDTO): string;
+        _extractSnapshotId(snapshotIdOrInstance: string | CodeSandboxSnapshotDTO): string;
         /**
          * List all available computational environments.
          * @returns Array of Environment model instances
@@ -67,18 +67,18 @@ export declare function RuntimesMixin<TBase extends Constructor>(Base: TBase): {
          * @param stop - Whether to stop the runtime after creating snapshot (defaults to false)
          * @returns Created snapshot
          */
-        createSnapshot(podName: string, name: string, description: string, stop?: boolean): Promise<RuntimeSnapshotDTO>;
+        createSnapshot(podName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
         /**
-         * List all runtime snapshots.
+         * List all code sandbox snapshots.
          * @returns Array of snapshots
          */
-        listSnapshots(): Promise<RuntimeSnapshotDTO[]>;
+        listSnapshots(): Promise<CodeSandboxSnapshotDTO[]>;
         /**
          * Get details for a specific snapshot by ID.
          * @param id - Snapshot ID
          * @returns Snapshot details
          */
-        getSnapshot(id: string): Promise<RuntimeSnapshotDTO>;
+        getSnapshot(id: string): Promise<CodeSandboxSnapshotDTO>;
         /**
          * Delete a snapshot permanently.
          * @param id - Snapshot ID

package/lib/client/mixins/RuntimesMixin.js

@@ -11,7 +11,7 @@ import * as runtimes from '../../api/runtimes/runtimes.js';
 import * as snapshots from '../../api/runtimes/snapshots.js';
 import { EnvironmentDTO } from '../../models/EnvironmentDTO.js';
 import { RuntimeDTO } from '../../models/RuntimeDTO.js';
-import { RuntimeSnapshotDTO } from '../../models/RuntimeSnapshotDTO.js';
+import { CodeSandboxSnapshotDTO } from '../../models/CodeSandboxSnapshotDTO.js';
 import { HealthCheck } from '../../models/HealthCheck.js';
 /** Runtimes mixin providing computational environment and runtime management. */
 export function RuntimesMixin(Base) {
@@ -148,17 +148,17 @@ export function RuntimesMixin(Base) {
                 stop,
             };
             const response = await snapshots.createSnapshot(token, data, runtimesRunUrl);
-            return new RuntimeSnapshotDTO(response.snapshot, this);
+            return new CodeSandboxSnapshotDTO(response.snapshot, this);
         }
         /**
-         * List all runtime snapshots.
+         * List all code sandbox snapshots.
          * @returns Array of snapshots
          */
         async listSnapshots() {
             const token = this.getToken();
             const runtimesRunUrl = this.getRuntimesRunUrl();
             const response = await snapshots.listSnapshots(token, runtimesRunUrl);
-            return response.snapshots.map(s => new RuntimeSnapshotDTO(s, this));
+            return response.snapshots.map(s => new CodeSandboxSnapshotDTO(s, this));
         }
         /**
          * Get details for a specific snapshot by ID.
@@ -169,7 +169,7 @@ export function RuntimesMixin(Base) {
             const token = this.getToken();
             const runtimesRunUrl = this.getRuntimesRunUrl();
             const response = await snapshots.getSnapshot(token, id, runtimesRunUrl);
-            return new RuntimeSnapshotDTO(response.snapshot, this);
+            return new CodeSandboxSnapshotDTO(response.snapshot, this);
         }
         /**
          * Delete a snapshot permanently.