@datalayer/core 1.0.20 → 1.0.22

package/lib/models/{RuntimeSnapshotDTO.d.ts → CodeSandboxSnapshotDTO.d.ts}

@@ -1,15 +1,15 @@
 /**
  * Snapshot domain model for the Datalayer Client.
  *
- * @module models/RuntimeSnapshotDTO
+ * @module models/CodeSandboxSnapshotDTO
  */
 import type { DatalayerClient } from '../index';
 import { RuntimeDTO } from './RuntimeDTO';
 /**
  * Represents a runthime snapshot of a runtime's state and files.
- * @interface RuntimeSnapshotData
+ * @interface CodeSandboxSnapshotData
  */
-export interface RuntimeSnapshotData {
+export interface CodeSandboxSnapshotData {
     /** Unique identifier for the snapshot */
     uid: string;
     /** Name of the snapshot */
@@ -42,7 +42,7 @@ export interface RuntimeSnapshotData {
  * This is the contract that Client consumers can rely on.
  * The raw API may change, but this interface remains stable.
  */
-export interface RuntimeSnapshotJSON {
+export interface CodeSandboxSnapshotJSON {
     /** Unique identifier for the snapshot */
     uid: string;
     /** Name of the snapshot */
@@ -55,10 +55,10 @@ export interface RuntimeSnapshotJSON {
     updatedAt: string;
 }
 /**
- * Request payload for creating a runtime snapshot
- * @interface CreateRuntimeSnapshotRequest
+ * Request payload for creating a code sandbox snapshot
+ * @interface CreateCodeSandboxSnapshotRequest
  */
-export interface CreateRuntimeSnapshotRequest {
+export interface CreateCodeSandboxSnapshotRequest {
     /** Pod name of the runtime to snapshot */
     pod_name: string;
     /** Name for the snapshot */
@@ -69,44 +69,44 @@ export interface CreateRuntimeSnapshotRequest {
     stop: boolean;
 }
 /**
- * Response for getting a specific runtime snapshot
- * @interface GetRuntimeSnapshotResponse
+ * Response for getting a specific code snapshot snapshot
+ * @interface GetCodeSandboxSnapshotResponse
  */
-export interface GetRuntimeSnapshotResponse {
+export interface GetCodeSandboxSnapshotResponse {
     /** Indicates if the request was successful */
     success: boolean;
     /** Response message */
     message: string;
     /** The snapshot details */
-    snapshot: RuntimeSnapshotData;
+    snapshot: CodeSandboxSnapshotData;
 }
 /**
- * Response for creating a runtime snapshot
- * @interface CreateRuntimeSnapshotResponse
+ * Response for creating a code sandbox snapshot
+ * @interface CreateCodeSandboxSnapshotResponse
  */
-export interface CreateRuntimeSnapshotResponse {
+export interface CreateCodeSandboxSnapshotResponse {
     /** Indicates if the request was successful */
     success: boolean;
     /** Response message */
     message: string;
     /** The created snapshot details */
-    snapshot: RuntimeSnapshotData;
+    snapshot: CodeSandboxSnapshotData;
 }
 /**
- * Response from listing runtime snapshots
- * @interface RuntimeSnapshotsListResponse
+ * Response from listing code sandbox snapshots
+ * @interface ListCodeSandboxSnapshotsResponse
  */
-export interface ListRuntimeSnapshotsResponse {
+export interface ListCodeSandboxSnapshotsResponse {
     /** Whether the request was successful */
     success: boolean;
     /** Response message from the server */
     message: string;
-    /** Array of runtime snapshots */
-    snapshots: RuntimeSnapshotData[];
+    /** Array of code sandbox snapshots */
+    snapshots: CodeSandboxSnapshotData[];
 }
 /**
  * Snapshot domain model that wraps API responses with convenient methods.
- * Provides runtime snapshot management with data refresh and lifecycle operations.
+ * Provides code sandbox snapshot management with data refresh and lifecycle operations.
  *
  * @example
  * ```typescript
@@ -114,17 +114,17 @@ export interface ListRuntimeSnapshotsResponse {
  * const runtime = await snapshot.restore();
  * ```
  */
-export declare class RuntimeSnapshotDTO {
-    protected _data: RuntimeSnapshotData;
+export declare class CodeSandboxSnapshotDTO {
+    protected _data: CodeSandboxSnapshotData;
     private _client;
     private _deleted;
     /**
-     * Create a Runtime Snapshot instance.
+     * Create a Code Sandbox Snapshot instance.
      *
      * @param data - Snapshot data from API
      * @param client - Client instance
      */
-    constructor(data: RuntimeSnapshotData, client: DatalayerClient);
+    constructor(data: CodeSandboxSnapshotData, client: DatalayerClient);
     /**
      * Check if this snapshot has been deleted and throw error if so.
      * @throws Error if deleted
@@ -146,28 +146,28 @@ export declare class RuntimeSnapshotDTO {
      */
     delete(): Promise<void>;
     /**
-     * Create a runtime from this snapshot (restore functionality).
+     * Create a code sandbox from this snapshot (restore functionality).
      *
      * @param minutesLimit - Time limit in minutes for the restored runtime
      * @returns Created Runtime instance
      */
     restore(minutesLimit: number): Promise<RuntimeDTO>;
     /**
-     * Get snapshot data in camelCase format.
+     * Get code snapshot snapshot data in camelCase format.
      * Returns only the core fields that consumers need.
      * This provides a stable interface regardless of API changes.
      * Note: Returns current cached state - call getStatus() first if you need fresh data.
      *
-     * @returns Core snapshot data with camelCase properties
+     * @returns Core code snapshot snapshot data with camelCase properties
      */
-    toJSON(): RuntimeSnapshotJSON;
+    toJSON(): CodeSandboxSnapshotJSON;
     /**
      * Get the raw snapshot data exactly as received from the API.
      * This preserves the original snake_case naming from the API response.
      *
      * @returns Raw snapshot data from API
      */
-    rawData(): RuntimeSnapshotData;
+    rawData(): CodeSandboxSnapshotData;
     /** String representation of the snapshot. */
     toString(): string;
 }

package/lib/models/{RuntimeSnapshotDTO.js → CodeSandboxSnapshotDTO.js}

@@ -6,7 +6,7 @@ import { snapshots } from '../api/runtimes/index.js';
 import { validateJSON } from '../api/utils/validation.js';
 /**
  * Snapshot domain model that wraps API responses with convenient methods.
- * Provides runtime snapshot management with data refresh and lifecycle operations.
+ * Provides code sandbox snapshot management with data refresh and lifecycle operations.
  *
  * @example
  * ```typescript
@@ -14,12 +14,12 @@ import { validateJSON } from '../api/utils/validation.js';
  * const runtime = await snapshot.restore();
  * ```
  */
-export class RuntimeSnapshotDTO {
+export class CodeSandboxSnapshotDTO {
     _data;
     _client;
     _deleted = false;
     /**
-     * Create a Runtime Snapshot instance.
+     * Create a Code Sandbox Snapshot instance.
      *
      * @param data - Snapshot data from API
      * @param client - Client instance
@@ -83,7 +83,7 @@ export class RuntimeSnapshotDTO {
         this._deleted = true;
     }
     /**
-     * Create a runtime from this snapshot (restore functionality).
+     * Create a code sandbox from this snapshot (restore functionality).
      *
      * @param minutesLimit - Time limit in minutes for the restored runtime
      * @returns Created Runtime instance
@@ -102,12 +102,12 @@ export class RuntimeSnapshotDTO {
     // Utility Methods
     // ========================================================================
     /**
-     * Get snapshot data in camelCase format.
+     * Get code snapshot snapshot data in camelCase format.
      * Returns only the core fields that consumers need.
      * This provides a stable interface regardless of API changes.
      * Note: Returns current cached state - call getStatus() first if you need fresh data.
      *
-     * @returns Core snapshot data with camelCase properties
+     * @returns Core code snapshot snapshot data with camelCase properties
      */
     toJSON() {
         this._checkDeleted();

package/lib/models/Environment.d.ts

@@ -41,6 +41,10 @@ export interface IDatalayerEnvironment {
      * Description
      */
     description: string;
+    /**
+     * Icon key (e.g. ai-agent -> AiAgentIcon)
+     */
+    icon?: string;
     /**
      * Execution language
      */

package/lib/models/IAM.d.ts

@@ -115,3 +115,69 @@ export interface MembershipsResponse {
     /** Memberships information */
     memberships: any[];
 }
+/**
+ * A principal (self / member organization / member team) the authenticated
+ * user can share artifacts with.
+ */
+export interface ShareablePrincipal {
+    kind: 'user' | 'organization' | 'team';
+    uid: string;
+    handle: string;
+    name?: string | null;
+    description?: string | null;
+    email?: string | null;
+    avatar_url?: string | null;
+    /** Parent organization UID — set when kind === 'team'. */
+    organization_uid?: string | null;
+    /** Parent organization handle — set when kind === 'team'. */
+    organization_handle?: string | null;
+}
+/**
+ * Response from the /principals/shareable endpoint.
+ */
+export interface ShareablePrincipalsResponse {
+    success: boolean;
+    message?: string;
+    principals: ShareablePrincipal[];
+}
+export interface PrincipalSearchUser {
+    uid: string;
+    handle_s: string;
+    first_name_t?: string;
+    last_name_t?: string;
+    display_name_t?: string;
+    display_name?: string;
+    origin_s?: string;
+    origin?: string;
+    avatar_url_s?: string;
+    avatarUrl?: string;
+    [key: string]: any;
+}
+export interface PrincipalSearchTeam {
+    uid: string;
+    handle_s: string;
+    name_t?: string;
+    description_t?: string;
+    organization_uid?: string;
+    organization_handle_s?: string;
+    [key: string]: any;
+}
+export interface PrincipalSearchOrganization {
+    uid: string;
+    handle_s: string;
+    name_t?: string;
+    description_t?: string;
+    [key: string]: any;
+}
+export interface PrincipalSearchResponseData {
+    users: PrincipalSearchUser[];
+    teams: PrincipalSearchTeam[];
+    organizations: PrincipalSearchOrganization[];
+    principalTypes: string[];
+    total: number;
+}
+export interface PrincipalSearchResponse {
+    success: boolean;
+    message: string;
+    data: PrincipalSearchResponseData;
+}

package/lib/models/Organization.d.ts

@@ -14,6 +14,7 @@ export type IBaseOrganization = {
     handle: string;
     type: string;
     name: string;
+    displayName?: string;
     description: string;
     public: boolean;
     creationDate: Date;

package/lib/models/Organization.js

@@ -23,6 +23,7 @@ export function asOrganization(org) {
         handle: org.handle_s,
         type: 'organization',
         name: org.name_t,
+        displayName: org.display_name_t || org.name_t,
         description: org.description_t,
         public: org.public_b,
         members,

package/lib/models/Page.d.ts

@@ -1,7 +1,7 @@
 import { INotebookContent } from '@jupyterlab/nbformat';
 import { IUser } from './User';
 import { PageTagName } from './PageTag';
-import { IRuntimeSnapshot } from './RuntimeSnapshot';
+import { ICodeSandboxSnapshot } from './CodeSandboxSnapshot';
 export type PageTheme = 'default';
 export type PageVariant = 'document' | 'cell' | 'notebook';
 /**
@@ -29,7 +29,7 @@ export type IPage = {
     screenCapture?: string;
     creator?: IUser;
     creatorId?: string;
-    kernelSnapshot?: IRuntimeSnapshot;
+    kernelSnapshot?: ICodeSandboxSnapshot;
     kernelSnapshotId?: string;
     createdAt?: string;
     updatedAt?: string;

package/lib/models/Page.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 import { asUser } from './User.js';
-import { asRuntimeSnapshot } from './RuntimeSnapshot.js';
+import { asCodeSandboxSnapshot, } from './CodeSandboxSnapshot.js';
 export const asPage = (s) => {
     return {
         id: s.uid,
@@ -18,7 +18,7 @@ export const asPage = (s) => {
         creator: s.creator ? asUser(s.creator) : undefined,
         creatorId: s.creator_uid,
         kernelSnapshot: s.kernel_snapshot
-            ? asRuntimeSnapshot(s.kernel_snapshot)
+            ? asCodeSandboxSnapshot(s.kernel_snapshot)
             : undefined,
         kernelSnapshotId: s.kernel_snapshot_uid,
     };

package/lib/models/Profile.d.ts

@@ -41,7 +41,7 @@ export interface Profile {
     /** Customer UID */
     customer_uid?: string | null;
     /** Credits customer UID for billing */
-    credits_customer_uid?: string | null;
+    stripe_customer_id_s?: string | null;
     /** Email unsubscription status */
     unsubscribed_from_outbounds_b?: boolean;
     /** Linked contact UID */

package/lib/models/RuntimeDTO.d.ts

@@ -1,5 +1,5 @@
 import type { DatalayerClient } from '../index';
-import { RuntimeSnapshotDTO } from './RuntimeSnapshotDTO';
+import { CodeSandboxSnapshotDTO } from './CodeSandboxSnapshotDTO';
 /**
  * Represents a running instance of a computing environment.
  * @interface RuntimeData
@@ -168,7 +168,7 @@ export declare class RuntimeDTO {
      * @param stop - Whether to stop runtime after snapshotting
      * @returns Created Snapshot instance
      */
-    createSnapshot(name: string, description?: string, stop?: boolean): Promise<RuntimeSnapshotDTO>;
+    createSnapshot(name: string, description?: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
     /**
      * Get runtime data in camelCase format.
      * Returns only the core fields that consumers need.

package/lib/models/Space.d.ts

@@ -24,6 +24,7 @@ export type IBaseSpace = {
     owner: IUser;
     organization?: Partial<IOrganization>;
     members?: SpaceMember[];
+    sharedOwnerUserUids?: string[];
 };
 export type ISpace = IBaseSpace & {
     type: 'space';

package/lib/models/Space.js

@@ -4,7 +4,6 @@
  */
 import { asUser } from './User.js';
 import { asArray } from '../utils/index.js';
-import { newUserMock } from './../mocks/models/index.js';
 /**
  * Convert the raw space object to {@link ISpace}.
  *
@@ -12,7 +11,31 @@ import { newUserMock } from './../mocks/models/index.js';
  * @returns Space
  */
 export const asSpace = (raw_space) => {
-    const owner = newUserMock();
+    const sharedOwnerUserUids = asArray(raw_space?.shared_owner_user_uids_ss ||
+        raw_space?.shared_ower_user_uids_ss ||
+        []).filter((uid) => typeof uid === 'string' && uid.length > 0);
+    // The backend resolves the canonical (friendly) account handles and exposes
+    // them as `space.owner` and `space.organization`. Trust those single sources
+    // of truth; do not invent fallbacks here.
+    const organizationHandle = raw_space?.organization?.handle;
+    const owner = raw_space?.owner
+        ? asUser(raw_space.owner)
+        : {
+            id: '',
+            handle: '',
+            email: '',
+            firstName: '',
+            lastName: '',
+            initials: '',
+            displayName: '',
+            roles: [],
+            iamProviders: [],
+            setRoles: () => { },
+            unsubscribedFromOutbounds: false,
+            onboarding: {},
+            events: [],
+            settings: {},
+        };
     let members = new Array();
     if (raw_space.members) {
         members = asArray(raw_space.members).map(m => {
@@ -31,9 +54,10 @@ export const asSpace = (raw_space) => {
         members,
         creationDate: new Date(raw_space.creation_ts_dt),
         owner,
-        organization: {
-            handle: raw_space.handle_s,
-        },
+        organization: organizationHandle
+            ? { handle: organizationHandle }
+            : undefined,
+        sharedOwnerUserUids,
         // Preserve raw Solr fields so consumers can access dynamic fields
         // (e.g. attached_agent_pod_name_s for project-agent assignment)
         ...raw_space,

package/lib/models/SpaceDTO.d.ts

@@ -21,6 +21,8 @@ export interface SpaceData {
     attached_agent_pod_name_s?: string;
     attached_agent_spec_id_s?: string;
     attached_agent_given_name_s?: string;
+    shared_owner_user_uids_ss?: string[];
+    shared_ower_user_uids_ss?: string[];
 }
 /**
  * Stable public interface for Space data.
@@ -40,6 +42,8 @@ export interface SpaceJSON {
     description: string;
     /** Items contained in the space (as JSON) */
     items: Array<NotebookJSON | LexicalJSON>;
+    /** Owner user UIDs for this space */
+    ownerUserUids?: string[];
 }
 /**
  * Space domain model that wraps API responses with convenient methods.

package/lib/models/SpaceDTO.js

@@ -208,12 +208,17 @@ export class SpaceDTO {
      */
     toJSON() {
         this._checkDeleted();
+        const ownerUserUids = Array.from(new Set([
+            ...(this._data.shared_owner_user_uids_ss || []),
+            ...(this._data.shared_ower_user_uids_ss || []),
+        ].filter(uid => typeof uid === 'string' && uid.length > 0)));
         const obj = {
             uid: this.uid,
             name: this.name,
             description: this.description,
             variant: this.variant,
             handle: this.handle,
+            ownerUserUids,
             items: this._data.items
                 ? convertSpaceItemsToModels(this._data.items, this._client).map(item => item.toJSON())
                 : [],

package/lib/models/Usage.d.ts

@@ -12,6 +12,11 @@ export interface IRawUsage {
     resource_given_name?: string;
     resource_state?: string;
     pod_resources?: IResources;
+    plan?: string;
+    usage_period_key?: string;
+    usage_period_label?: string;
+    usage_period_start?: string;
+    usage_period_end?: string;
     metadata: Map<string, string>;
 }
 export declare const asUsage: (u: any) => {
@@ -27,6 +32,11 @@ export declare const asUsage: (u: any) => {
     endDate: Date | undefined;
     resourceState: any;
     resources: any;
+    plan: any;
+    usagePeriodKey: any;
+    usagePeriodLabel: any;
+    usagePeriodStart: Date | undefined;
+    usagePeriodEnd: Date | undefined;
     metadata: Map<string, string>;
 };
 export interface IUsage {
@@ -42,5 +52,10 @@ export interface IUsage {
     givenName: string;
     resourceState: string;
     resources?: IResources;
+    plan?: string;
+    usagePeriodKey?: string;
+    usagePeriodLabel?: string;
+    usagePeriodStart?: Date;
+    usagePeriodEnd?: Date;
     metadata: Map<string, string>;
 }

package/lib/models/Usage.js

@@ -3,6 +3,10 @@
  * Distributed under the terms of the Modified BSD License.
  */
 export const asUsage = (u) => {
+    const usagePeriodKey = u.usage_period_key;
+    const usagePeriodLabel = u.usage_period_label;
+    const usagePeriodStart = u.usage_period_start;
+    const usagePeriodEnd = u.usage_period_end;
     return {
         id: u.resource_uid,
         accountId: u.account_uid ?? '',
@@ -16,6 +20,11 @@ export const asUsage = (u) => {
         endDate: u.end_date ? new Date(u.end_date) : undefined,
         resourceState: u.resource_state,
         resources: u.pod_resources,
+        plan: u.plan ?? 'free_plan',
+        usagePeriodKey,
+        usagePeriodLabel,
+        usagePeriodStart: usagePeriodStart ? new Date(usagePeriodStart) : undefined,
+        usagePeriodEnd: usagePeriodEnd ? new Date(usagePeriodEnd) : undefined,
         metadata: new Map(Object.entries(u.metadata ?? {})),
     };
 };

package/lib/models/User.d.ts

@@ -12,6 +12,7 @@ export declare const ANONYMOUS_USER_EXTERNAL_TOKEN: undefined;
 export declare const getUserRandomColor: () => string;
 export declare class User implements IUser {
     id: string;
+    uid?: string;
     handle: string;
     email: string;
     firstName: string;
@@ -33,6 +34,7 @@ export declare class User implements IUser {
     onboarding: IUserOnboarding;
     linkedContactId?: string;
     events: Array<IUserEvent>;
+    subscription?: IUserSubscription;
     constructor(u: any);
     setRoles(roles: string[]): void;
 }
@@ -56,6 +58,7 @@ export type IBaseUser = {
 };
 export type IUser = IBaseUser & {
     id: string;
+    uid?: string;
     handle: string;
     credits?: number;
     creditsCustomerId?: string;
@@ -69,5 +72,23 @@ export type IUser = IBaseUser & {
     onboarding: IUserOnboarding;
     linkedContactId?: string;
     events: Array<IUserEvent>;
+    subscription?: IUserSubscription;
+};
+export type IUserSubscription = {
+    plan_name?: string;
+    plan?: {
+        name?: string;
+    } | string;
+    tier?: string;
+    included_runs?: number;
+    current_runs?: number;
+    used_runs?: number;
+    current_credits?: number;
+    used_credits?: number;
+    usage?: {
+        included_runs?: number;
+        current_runs?: number;
+        current_credits?: number;
+    };
 };
 export default IUser;

package/lib/models/User.js

@@ -28,6 +28,7 @@ const USER_COLORS = [
 export const getUserRandomColor = () => USER_COLORS[Math.floor(Math.random() * USER_COLORS.length)];
 export class User {
     id;
+    uid;
     handle;
     email;
     firstName;
@@ -49,8 +50,10 @@ export class User {
     onboarding;
     linkedContactId;
     events;
+    subscription;
     constructor(u) {
-        this.id = u.uid;
+        this.id = u.uid || u.id;
+        this.uid = u.uid || u.id;
         this.handle = u.handle_s;
         this.email = u.email_s;
         this.firstName = u.first_name_t;
@@ -64,7 +67,7 @@ export class User {
         this.origin = u.origin_s;
         this.joinDate = u.join_ts_dt ? new Date(u.join_ts_dt) : undefined;
         this.credits = u.credits_i ? Number(u.credits_i) : 0;
-        this.creditsCustomerId = u.credits_customer_uid;
+        this.creditsCustomerId = u.stripe_customer_id_s;
         this.roles = u.roles_ss ?? [];
         let iamProviders = [];
         try {
@@ -81,6 +84,7 @@ export class User {
             ? JSON.parse(u.onboarding_s)
             : BOOTSTRAP_USER_ONBOARDING;
         this.linkedContactId = u.linked_contact_uid;
+        this.subscription = u.subscription;
         let events = u.events ?? [];
         if (!Array.isArray(events)) {
             events = [events];

package/lib/models/index.d.ts

@@ -82,8 +82,8 @@ export * from './RolesPlatform';
 export * from './RolesTeam';
 export * from './Runtime';
 export * from './RuntimeDTO';
-export * from './RuntimeSnapshot';
-export * from './RuntimeSnapshotDTO';
+export * from './CodeSandboxSnapshot';
+export * from './CodeSandboxSnapshotDTO';
 export * from './School';
 export * from './Secret';
 export * from './Space';

package/lib/models/index.js

@@ -86,8 +86,8 @@ export * from './RolesPlatform.js';
 export * from './RolesTeam.js';
 export * from './Runtime.js';
 export * from './RuntimeDTO.js';
-export * from './RuntimeSnapshot.js';
-export * from './RuntimeSnapshotDTO.js';
+export * from './CodeSandboxSnapshot.js';
+export * from './CodeSandboxSnapshotDTO.js';
 export * from './School.js';
 export * from './Secret.js';
 export * from './Space.js';

package/lib/otel/auth.js

@@ -2,10 +2,6 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-/*
- * Copyright (c) 2023-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
 import { getDatalayerJwtUser, parseJwtPayload } from '../utils/Jwt.js';
 function normalizeBaseUrl(baseUrl) {
     const normalized = baseUrl.startsWith('ws://') || baseUrl.startsWith('wss://')

package/lib/services/index.d.ts

@@ -1,4 +1,4 @@
 export { createDatalayerServiceManager } from './DatalayerServiceManager';
-export { default as DatalayerServiceManager } from './DatalayerServiceManager';
 export { reconnectToRuntime } from './reconnectToRuntime';
 export type { RuntimeInfo } from './reconnectToRuntime';
+export { default as DatalayerServiceManager } from './DatalayerServiceManager';

package/lib/services/index.js

@@ -3,5 +3,5 @@
  * Distributed under the terms of the Modified BSD License.
  */
 export { createDatalayerServiceManager } from './DatalayerServiceManager.js';
-export { default as DatalayerServiceManager } from './DatalayerServiceManager.js';
 export { reconnectToRuntime } from './reconnectToRuntime.js';
+export { default as DatalayerServiceManager } from './DatalayerServiceManager.js';