@datalayer/core 1.0.20 → 1.0.22

package/lib/hooks/useDatalayer.js

@@ -11,6 +11,23 @@ import { requestDatalayerAPI } from '../api/DatalayerApi.js';
 export function useDatalayer(props = {}) {
     const { loginRoute = '/login', notifyOnError = true } = props;
     const location = useLocation();
+    const resolveLoginRoute = (candidateRoute) => {
+        if (candidateRoute !== '/login') {
+            return candidateRoute;
+        }
+        const pathname = location.pathname || '';
+        const kernelsPrefix = '/jupyter/kernels';
+        const iamPrefix = '/jupyter/iam';
+        if (pathname.includes(kernelsPrefix)) {
+            const [base] = pathname.split(kernelsPrefix);
+            return `${base}${kernelsPrefix}/login`;
+        }
+        if (pathname.includes(iamPrefix)) {
+            const [base] = pathname.split(iamPrefix);
+            return `${base}${iamPrefix}/login`;
+        }
+        return candidateRoute;
+    };
     /*
     // TODO Fix the conditional hook call.
     const coreStore = useCoreStore();
@@ -35,15 +52,19 @@ export function useDatalayer(props = {}) {
             .catch(error => {
             if (error.name === 'RunResponseError') {
                 const responseError = error;
+                const isForbidden = responseError.response.status === 403;
                 if (responseError.response.status === 401) {
                     console.log('Datalayer sent a 401 return code.');
-                    if (location.pathname !== loginRoute_) {
+                    const resolvedLoginRoute = resolveLoginRoute(loginRoute_);
+                    const alreadyOnLoginRoute = location.pathname === resolvedLoginRoute ||
+                        location.pathname.endsWith('/login');
+                    if (!alreadyOnLoginRoute) {
                         iamStore.logout();
-                        navigate(loginRoute_);
+                        navigate(resolvedLoginRoute);
                     }
                 }
                 else {
-                    if (notifyOnError_) {
+                    if (notifyOnError_ && !isForbidden) {
                         if (responseError.warnings) {
                             responseError.warnings.forEach(warning => enqueueToast(`${warning}`, { variant: 'warning' }));
                         }
@@ -64,9 +85,16 @@ export function useDatalayer(props = {}) {
                     }
                 }
                 const response = {
+                    success: false,
                     sucess: false,
                     message: responseError.message,
                     errors: responseError.errors,
+                    warnings: responseError.warnings,
+                    detail: responseError.detail,
+                    status: responseError.response.status,
+                    code: responseError.response.status === 403
+                        ? 'FORBIDDEN'
+                        : `HTTP_${responseError.response.status}`,
                 };
                 return response;
             }

package/lib/hooks/useIAM.js

@@ -4,7 +4,7 @@
  */
 import { useEffect, useState } from 'react';
 import { useCache } from './useCache.js';
-import { coreStore, useIAMStore, useLayoutStore, useOrganizationStore, useSpaceStore, } from '../state/index.js';
+import { useIAMStore, useLayoutStore, useOrganizationStore, useSpaceStore, } from '../state/index.js';
 import { asUser, ANONYMOUS_USER, ANONYMOUS_USER_TOKEN, } from '../models/index.js';
 import { requestDatalayerAPI, } from '../api/DatalayerApi.js';
 export const useIAM = (props = { user: undefined, token: undefined }) => {
@@ -72,13 +72,6 @@ export const useIAM = (props = { user: undefined, token: undefined }) => {
                 const user = asUser(whoamiData.profile);
                 setIAMState({ user, token });
                 iamStore.setLogin(user, token);
-                // TODO centralize user settings management.
-                const aiagentsRunUrl = user.settings?.aiAgentsUrl;
-                if (aiagentsRunUrl) {
-                    coreStore.getState().setConfiguration({
-                        aiagentsRunUrl,
-                    });
-                }
             }
         }
     }, [token, whoamiData, iamStore]);

package/lib/hooks/usePrincipalStore.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The kind of principal currently selected in the Principal Switcher.
+ *
+ * A principal is the entity used for *UI scoping* — visibility, creation,
+ * and sharing of artifacts. Only user / organization / team are principals.
+ * Agents are NOT principals (an agent is owned by an account).
+ */
+export type PrincipalKind = 'user' | 'organization' | 'team';
+export type PrincipalState = {
+    /** Kind of the currently selected principal. */
+    selectedPrincipalKind: PrincipalKind;
+    /** UID of the selected principal (user UID, org UID, or team UID). */
+    selectedPrincipalUid?: string;
+    /** Handle of the selected principal. */
+    selectedPrincipalHandle?: string;
+    /** Parent organization UID — set only when `selectedPrincipalKind === 'team'`. */
+    selectedTeamParentOrganizationUid?: string;
+    /** Parent organization handle — set only when `selectedPrincipalKind === 'team'`. */
+    selectedTeamParentOrganizationHandle?: string;
+    selectUserPrincipal: (uid: string, handle: string) => void;
+    selectOrganizationPrincipal: (uid: string, handle: string) => void;
+    selectTeamPrincipal: (args: {
+        teamUid: string;
+        teamHandle: string;
+        organizationUid: string;
+        organizationHandle: string;
+    }) => void;
+    resetPrincipal: () => void;
+};
+export declare const usePrincipalStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<PrincipalState>, "persist"> & {
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<PrincipalState, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: PrincipalState) => void) => () => void;
+        onFinishHydration: (fn: (state: PrincipalState) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<PrincipalState, unknown>>;
+    };
+}>;
+export default usePrincipalStore;

package/lib/hooks/usePrincipalStore.js

@@ -0,0 +1,101 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { create } from 'zustand';
+import { createJSONStorage, persist } from 'zustand/middleware';
+import { useUsageRefreshStore } from './useUsageRefreshStore.js';
+export const usePrincipalStore = create()(persist(set => ({
+    selectedPrincipalKind: 'user',
+    selectedPrincipalUid: undefined,
+    selectedPrincipalHandle: undefined,
+    selectedTeamParentOrganizationUid: undefined,
+    selectedTeamParentOrganizationHandle: undefined,
+    selectUserPrincipal: (uid, handle) => set(state => {
+        const unchanged = state.selectedPrincipalKind === 'user' &&
+            state.selectedPrincipalUid === uid &&
+            state.selectedPrincipalHandle === handle;
+        if (unchanged) {
+            return state;
+        }
+        useUsageRefreshStore
+            .getState()
+            .requestUsageRefresh('principal-user-changed');
+        return {
+            selectedPrincipalKind: 'user',
+            selectedPrincipalUid: uid,
+            selectedPrincipalHandle: handle,
+            selectedTeamParentOrganizationUid: undefined,
+            selectedTeamParentOrganizationHandle: undefined,
+        };
+    }),
+    selectOrganizationPrincipal: (uid, handle) => set(state => {
+        const unchanged = state.selectedPrincipalKind === 'organization' &&
+            state.selectedPrincipalUid === uid &&
+            state.selectedPrincipalHandle === handle;
+        if (unchanged) {
+            return state;
+        }
+        useUsageRefreshStore
+            .getState()
+            .requestUsageRefresh('principal-organization-changed');
+        return {
+            selectedPrincipalKind: 'organization',
+            selectedPrincipalUid: uid,
+            selectedPrincipalHandle: handle,
+            selectedTeamParentOrganizationUid: undefined,
+            selectedTeamParentOrganizationHandle: undefined,
+        };
+    }),
+    selectTeamPrincipal: ({ teamUid, teamHandle, organizationUid, organizationHandle, }) => set(state => {
+        const unchanged = state.selectedPrincipalKind === 'team' &&
+            state.selectedPrincipalUid === teamUid &&
+            state.selectedPrincipalHandle === teamHandle &&
+            state.selectedTeamParentOrganizationUid === organizationUid &&
+            state.selectedTeamParentOrganizationHandle === organizationHandle;
+        if (unchanged) {
+            return state;
+        }
+        useUsageRefreshStore
+            .getState()
+            .requestUsageRefresh('principal-team-changed');
+        return {
+            selectedPrincipalKind: 'team',
+            selectedPrincipalUid: teamUid,
+            selectedPrincipalHandle: teamHandle,
+            selectedTeamParentOrganizationUid: organizationUid,
+            selectedTeamParentOrganizationHandle: organizationHandle,
+        };
+    }),
+    resetPrincipal: () => set(state => {
+        const unchanged = state.selectedPrincipalKind === 'user' &&
+            state.selectedPrincipalUid === undefined &&
+            state.selectedPrincipalHandle === undefined &&
+            state.selectedTeamParentOrganizationUid === undefined &&
+            state.selectedTeamParentOrganizationHandle === undefined;
+        if (unchanged) {
+            return state;
+        }
+        useUsageRefreshStore
+            .getState()
+            .requestUsageRefresh('principal-reset');
+        return {
+            selectedPrincipalKind: 'user',
+            selectedPrincipalUid: undefined,
+            selectedPrincipalHandle: undefined,
+            selectedTeamParentOrganizationUid: undefined,
+            selectedTeamParentOrganizationHandle: undefined,
+        };
+    }),
+}), {
+    name: 'datalayer-principal',
+    storage: createJSONStorage(() => localStorage),
+    partialize: state => ({
+        selectedPrincipalKind: state.selectedPrincipalKind,
+        selectedPrincipalUid: state.selectedPrincipalUid,
+        selectedPrincipalHandle: state.selectedPrincipalHandle,
+        selectedTeamParentOrganizationUid: state.selectedTeamParentOrganizationUid,
+        selectedTeamParentOrganizationHandle: state.selectedTeamParentOrganizationHandle,
+    }),
+}));
+export default usePrincipalStore;

package/lib/hooks/useProjects.d.ts

@@ -385,6 +385,10 @@ export declare function useCreateProject(): {
     mutate: import("@tanstack/react-query").UseMutateFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
     reset: () => void;
     context: unknown;
@@ -395,6 +399,10 @@ export declare function useCreateProject(): {
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
 } | {
     createProject: (request: CreateProjectRequest) => Promise<any>;
@@ -402,6 +410,10 @@ export declare function useCreateProject(): {
     variables: {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     };
     error: null;
     isError: false;
@@ -412,6 +424,10 @@ export declare function useCreateProject(): {
     mutate: import("@tanstack/react-query").UseMutateFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
     reset: () => void;
     context: unknown;
@@ -422,6 +438,10 @@ export declare function useCreateProject(): {
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
 } | {
     createProject: (request: CreateProjectRequest) => Promise<any>;
@@ -430,6 +450,10 @@ export declare function useCreateProject(): {
     variables: {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     };
     isError: true;
     isIdle: false;
@@ -439,6 +463,10 @@ export declare function useCreateProject(): {
     mutate: import("@tanstack/react-query").UseMutateFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
     reset: () => void;
     context: unknown;
@@ -449,6 +477,10 @@ export declare function useCreateProject(): {
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
 } | {
     createProject: (request: CreateProjectRequest) => Promise<any>;
@@ -457,6 +489,10 @@ export declare function useCreateProject(): {
     variables: {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     };
     isError: false;
     isIdle: false;
@@ -466,6 +502,10 @@ export declare function useCreateProject(): {
     mutate: import("@tanstack/react-query").UseMutateFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
     reset: () => void;
     context: unknown;
@@ -476,6 +516,10 @@ export declare function useCreateProject(): {
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
 };
 /**

package/lib/hooks/useProjects.js

@@ -16,6 +16,31 @@ import { useMemo, useCallback } from 'react';
 import { useCache } from './useCache.js';
 /** The space type value used to identify project spaces in Solr */
 export const PROJECT_SPACE_VARIANT = 'project';
+const normalizeProjectItems = (items) => {
+    if (Array.isArray(items)) {
+        return items;
+    }
+    if (items && typeof items === 'object') {
+        return [items];
+    }
+    return [];
+};
+const isProjectSpace = (space) => {
+    const variant = space?.variant ?? space?.variant_s;
+    if (variant !== PROJECT_SPACE_VARIANT) {
+        return false;
+    }
+    const items = normalizeProjectItems(space?.items);
+    if (items.length === 0) {
+        return true;
+    }
+    const hasNotebook = items.some(item => (item?.type_s ?? item?.type) === 'notebook');
+    const hasDocument = items.some(item => {
+        const type = item?.type_s ?? item?.type;
+        return type === 'document' || type === 'lexical';
+    });
+    return hasNotebook && hasDocument;
+};
 /**
  * Hook to fetch user's projects (spaces with type "project").
  *
@@ -29,8 +54,7 @@ export function useProjects() {
         if (!allSpaces)
             return [];
         return allSpaces
-            .filter((space) => space.variant === PROJECT_SPACE_VARIANT ||
-            space.type_s === PROJECT_SPACE_VARIANT)
+            .filter((space) => isProjectSpace(space))
             .map((space) => ({
             uid: space.uid,
             id: space.id ?? space.uid,

package/lib/hooks/useSelectedBillableAccount.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Read-only selector for the currently scoped billable account.
+ *
+ * Use this for billing, quotas, plans, credits, agents, and runtime capacity.
+ * For visibility/creation/sharing scope, use {@link useSelectedPrincipal}.
+ */
+export declare function useSelectedBillableAccount(): {
+    billableAccountKind: string;
+    billableAccountUid: string | undefined;
+    billableAccountHandle: string | undefined;
+    isUserAccount: boolean;
+    isOrganizationAccount: boolean;
+};
+export default useSelectedBillableAccount;

package/lib/hooks/useSelectedBillableAccount.js

@@ -0,0 +1,36 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { useBillableAccountStore } from './useBillableAccountStore.js';
+import { useSelectedPrincipal } from './useSelectedPrincipal.js';
+/**
+ * Read-only selector for the currently scoped billable account.
+ *
+ * Use this for billing, quotas, plans, credits, agents, and runtime capacity.
+ * For visibility/creation/sharing scope, use {@link useSelectedPrincipal}.
+ */
+export function useSelectedBillableAccount() {
+    const persistedUid = useBillableAccountStore(state => state.billableAccountUid);
+    const persistedHandle = useBillableAccountStore(state => state.billableAccountHandle);
+    const { selectedPrincipalKind, selectedPrincipalUid, selectedPrincipalHandle, selectedTeamParentOrganizationUid, selectedTeamParentOrganizationHandle, } = useSelectedPrincipal();
+    const billableAccountKind = selectedPrincipalKind === 'team'
+        ? 'organization'
+        : selectedPrincipalKind === 'organization'
+            ? 'organization'
+            : 'user';
+    const billableAccountUid = selectedPrincipalKind === 'team'
+        ? selectedTeamParentOrganizationUid || persistedUid
+        : selectedPrincipalUid || persistedUid;
+    const billableAccountHandle = selectedPrincipalKind === 'team'
+        ? selectedTeamParentOrganizationHandle || persistedHandle
+        : selectedPrincipalHandle || persistedHandle;
+    return {
+        billableAccountKind,
+        billableAccountUid,
+        billableAccountHandle,
+        isUserAccount: billableAccountKind === 'user',
+        isOrganizationAccount: billableAccountKind === 'organization',
+    };
+}
+export default useSelectedBillableAccount;

package/lib/hooks/useSelectedPrincipal.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Read-only selector for the currently selected principal (UI scope).
+ *
+ * Use this for visibility, creation, and sharing of artifacts.
+ * For billing, quotas, plans, and agents, use {@link useSelectedBillableAccount}.
+ */
+export declare function useSelectedPrincipal(): {
+    selectedPrincipalKind: import("./usePrincipalStore").PrincipalKind;
+    selectedPrincipalUid: string | undefined;
+    selectedPrincipalHandle: string | undefined;
+    selectedTeamParentOrganizationUid: string | undefined;
+    selectedTeamParentOrganizationHandle: string | undefined;
+    isUserSelected: boolean;
+    isOrganizationSelected: boolean;
+    isTeamSelected: boolean;
+};
+export default useSelectedPrincipal;

package/lib/hooks/useSelectedPrincipal.js

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { usePrincipalStore } from './usePrincipalStore.js';
+/**
+ * Read-only selector for the currently selected principal (UI scope).
+ *
+ * Use this for visibility, creation, and sharing of artifacts.
+ * For billing, quotas, plans, and agents, use {@link useSelectedBillableAccount}.
+ */
+export function useSelectedPrincipal() {
+    const selectedPrincipalKind = usePrincipalStore(state => state.selectedPrincipalKind);
+    const selectedPrincipalUid = usePrincipalStore(state => state.selectedPrincipalUid);
+    const selectedPrincipalHandle = usePrincipalStore(state => state.selectedPrincipalHandle);
+    const selectedTeamParentOrganizationUid = usePrincipalStore(state => state.selectedTeamParentOrganizationUid);
+    const selectedTeamParentOrganizationHandle = usePrincipalStore(state => state.selectedTeamParentOrganizationHandle);
+    return {
+        selectedPrincipalKind,
+        selectedPrincipalUid,
+        selectedPrincipalHandle,
+        selectedTeamParentOrganizationUid,
+        selectedTeamParentOrganizationHandle,
+        isUserSelected: selectedPrincipalKind === 'user',
+        isOrganizationSelected: selectedPrincipalKind === 'organization',
+        isTeamSelected: selectedPrincipalKind === 'team',
+    };
+}
+export default useSelectedPrincipal;

package/lib/hooks/useUsageRefreshStore.d.ts

@@ -0,0 +1,8 @@
+export type UsageRefreshState = {
+    refreshToken: number;
+    lastReason?: string;
+    lastRequestedAt?: number;
+    requestUsageRefresh: (reason?: string) => void;
+};
+export declare const useUsageRefreshStore: import("zustand").UseBoundStore<import("zustand").StoreApi<UsageRefreshState>>;
+export default useUsageRefreshStore;

package/lib/hooks/useUsageRefreshStore.js

@@ -0,0 +1,16 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { create } from 'zustand';
+export const useUsageRefreshStore = create()(set => ({
+    refreshToken: 0,
+    lastReason: undefined,
+    lastRequestedAt: undefined,
+    requestUsageRefresh: (reason) => set(state => ({
+        refreshToken: state.refreshToken + 1,
+        lastReason: reason,
+        lastRequestedAt: Date.now(),
+    })),
+}));
+export default useUsageRefreshStore;

package/lib/index.d.ts

@@ -11,7 +11,7 @@ export { API_BASE_PATHS } from './api/constants';
 export * as runtimesApi from './api/runtimes';
 export * as iamApi from './api/iam';
 export * as spacerApi from './api/spacer';
-export { DatalayerClient, type DatalayerClientConfig, type ClientHandlers, User, Runtime, Environment, Snapshot, Space, Project, Notebook, LexicalDTO, Secret, Credits, Item, type RuntimeJSON, type EnvironmentJSON, type UserJSON, type RuntimeData, type EnvironmentData, type UserData, type SpaceData, type SpaceItem, type NotebookData, type LexicalData, type RuntimeSnapshotData, type CreditsInfo, type CreditReservation, type CreateRuntimeRequest, type CreateRuntimeResponse, type ListRuntimesResponse, type ListEnvironmentsResponse, type CreateRuntimeSnapshotRequest, type CreateRuntimeSnapshotResponse, type GetRuntimeSnapshotResponse, type ListRuntimeSnapshotsResponse, type CreateSpaceRequest, type CreateSpaceResponse, type SpacesForUserResponse, type CollaborationSessionResponse, type DeleteSpaceItemResponse, type GetSpaceItemResponse, type GetSpaceItemsResponse, type CreateNotebookRequest, type CreateNotebookResponse, type GetNotebookResponse, type UpdateNotebookRequest, type UpdateNotebookResponse, type CreateLexicalRequest, type CreateLexicalResponse, type GetLexicalResponse, type UpdateLexicalRequest, type UpdateLexicalResponse, type CreditsResponse, type CreateDatasourceResponse, type GetDatasourceResponse, type ListDatasourcesResponse, type UpdateDatasourceResponse, type CreateSecretRequest, type CreateSecretResponse, type GetSecretResponse, type ListSecretsResponse, type UpdateSecretRequest, type UpdateSecretResponse, type SpaceJSON, type ProjectJSON, type ProjectDefaultItems, type UpdateSpaceRequest, type GetSpaceResponse, type UpdateSpaceResponse, type DeleteSpaceResponse, type GetSpaceDefaultItemsResponse, type GetSpacesByTypeResponse, type NotebookJSON, type LexicalJSON, type RuntimeSnapshotJSON, HealthCheck, type HealthCheckJSON, type LoginRequest, type LoginResponse, type UserMeResponse, type MembershipsResponse, type WhoAmIResponse, type HealthzPingResponse, AuthenticationManager, type IUser, type IBaseUser, type ICell, type IDatasource, type IDatasourceVariant, type ICredits, type ICreditsReservation, type ISpaceItem, type ISurvey, type ISpace, type IBaseSpace, type IAnySpace, type ISpaceVariant, type IBaseTeam, type IAnyTeam, type IOrganization, type IAnyOrganization, type IBaseOrganization, type IRuntimeModel, type IRuntimePod, type IRuntimeType, type IRuntimeLocation, type IRuntimeCapabilities, type IRuntimeSnapshot, type IDatalayerEnvironment, type IResources, type ISnippet, type IRole, type IAssignment, type IContact, type ICourse, type IOrganizationMember, type IPage, type PageTagName, type PageTheme, type PageVariant, type ISecret, type ISecretVariant, type SecretData, type SecretJSON, type DatasourceData, type DatasourceJSON, type DatasourceType, type CreateDatasourceRequest, type UpdateDatasourceRequest, Datasource, type IIAMToken, type IIAMTokenVariant, type IDocument, type IBaseDocument, type IEnvironment, type IExercise, type ICode, type IHelp, type IInvite, type ILesson, type INotebook, type IBaseNotebook, type ISchool, type ITeam, type TeamMember, type IUserOnboarding, type IClient, type IOnboardingPosition, type IOnboardingTours, type ITour, type ITourStatus, type IUserSettings, type IDataset, type IUsage, type IItem, type IItemType, type Member, type Profile, type SpaceMember, type IContactEvent, type IContactIAMProvider, type IStudentItem, type Instructor, type IStudent, type IDean, type IUserEvent, type IIAMProviderLinked, type IContent, type AuthResult, type TokenValidationResult, type AuthOptions, type TokenStorage, type IRuntimeOptions, type IMultiServiceManager, type IRemoteServicesManager, type IEnvironmentsManager, type IRemoteRuntimesManager, type NavigationLinkProps, type IDatalayerCoreConfig, type IRuntimesConfiguration, type IIAMProviderName, } from './client';
-export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getRuntimeSnapshots, loadRuntimeSnapshot, } from './stateful/runtimes/actions';
+export { DatalayerClient, type DatalayerClientConfig, type ClientHandlers, User, Runtime, Environment, Snapshot, Space, Project, Notebook, LexicalDTO, Secret, Credits, Item, type RuntimeJSON, type EnvironmentJSON, type UserJSON, type RuntimeData, type EnvironmentData, type UserData, type SpaceData, type SpaceItem, type NotebookData, type LexicalData, type CodeSandboxSnapshotData, type CreditsInfo, type CreditReservation, type CreateRuntimeRequest, type CreateRuntimeResponse, type ListRuntimesResponse, type ListEnvironmentsResponse, type CreateCodeSandboxSnapshotRequest, type CreateCodeSandboxSnapshotResponse, type GetCodeSandboxSnapshotResponse, type ListCodeSandboxSnapshotsResponse, type CreateSpaceRequest, type CreateSpaceResponse, type SpacesForUserResponse, type CollaborationSessionResponse, type DeleteSpaceItemResponse, type GetSpaceItemResponse, type GetSpaceItemsResponse, type CreateNotebookRequest, type CreateNotebookResponse, type GetNotebookResponse, type UpdateNotebookRequest, type UpdateNotebookResponse, type CreateLexicalRequest, type CreateLexicalResponse, type GetLexicalResponse, type UpdateLexicalRequest, type UpdateLexicalResponse, type CreditsResponse, type CreateDatasourceResponse, type GetDatasourceResponse, type ListDatasourcesResponse, type UpdateDatasourceResponse, type CreateSecretRequest, type CreateSecretResponse, type GetSecretResponse, type ListSecretsResponse, type UpdateSecretRequest, type UpdateSecretResponse, type SpaceJSON, type ProjectJSON, type ProjectDefaultItems, type UpdateSpaceRequest, type GetSpaceResponse, type UpdateSpaceResponse, type DeleteSpaceResponse, type GetSpaceDefaultItemsResponse, type GetSpacesByTypeResponse, type NotebookJSON, type LexicalJSON, type CodeSandboxSnapshotJSON, HealthCheck, type HealthCheckJSON, type LoginRequest, type LoginResponse, type UserMeResponse, type MembershipsResponse, type WhoAmIResponse, type HealthzPingResponse, AuthenticationManager, type IUser, type IBaseUser, type ICell, type IDatasource, type IDatasourceVariant, type ICredits, type ICreditsReservation, type ISpaceItem, type ISurvey, type ISpace, type IBaseSpace, type IAnySpace, type ISpaceVariant, type IBaseTeam, type IAnyTeam, type IOrganization, type IAnyOrganization, type IBaseOrganization, type IRuntimeModel, type IRuntimePod, type IRuntimeType, type IRuntimeLocation, type IRuntimeCapabilities, type ICodeSandboxSnapshot, type IDatalayerEnvironment, type IResources, type ISnippet, type IRole, type IAssignment, type IContact, type ICourse, type IOrganizationMember, type IPage, type PageTagName, type PageTheme, type PageVariant, type ISecret, type ISecretVariant, type SecretData, type SecretJSON, type DatasourceData, type DatasourceJSON, type DatasourceType, type CreateDatasourceRequest, type UpdateDatasourceRequest, Datasource, type IIAMToken, type IIAMTokenVariant, type IDocument, type IBaseDocument, type IEnvironment, type IExercise, type ICode, type IHelp, type IInvite, type ILesson, type INotebook, type IBaseNotebook, type ISchool, type ITeam, type TeamMember, type IUserOnboarding, type IClient, type IOnboardingPosition, type IOnboardingTours, type ITour, type ITourStatus, type IUserSettings, type IDataset, type IUsage, type IItem, type IItemType, type Member, type Profile, type SpaceMember, type IContactEvent, type IContactIAMProvider, type IStudentItem, type Instructor, type IStudent, type IDean, type IUserEvent, type IIAMProviderLinked, type IContent, type AuthResult, type TokenValidationResult, type AuthOptions, type TokenStorage, type IRuntimeOptions, type IMultiServiceManager, type IRemoteServicesManager, type IEnvironmentsManager, type IRemoteRuntimesManager, type NavigationLinkProps, type IDatalayerCoreConfig, type IRuntimesConfiguration, type IIAMProviderName, } from './client';
+export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getSandboxSnapshots, loadSandboxSnapshot, } from './stateful/runtimes/actions';
 export * from './otel';
 export * from './views';

package/lib/index.js

@@ -25,7 +25,7 @@ User, Runtime, Environment, Snapshot, Space, Project, Notebook, LexicalDTO, Secr
 // Export auth
 AuthenticationManager, Datasource, } from './client/index.js';
 // Export commonly used functions directly for convenience
-export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getRuntimeSnapshots, loadRuntimeSnapshot, } from './stateful/runtimes/actions.js';
+export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getSandboxSnapshots, loadSandboxSnapshot, } from './stateful/runtimes/actions.js';
 // OTEL observability components, hooks, and types
 export * from './otel/index.js';
 // Reusable views (sign-in pages, etc.)

package/lib/mocks/components/FlashMock.js

@@ -4,10 +4,16 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * Distributed under the terms of the Modified BSD License.
  */
 import { AlertIcon } from '@primer/octicons-react';
-import { Flash, Link } from '@primer/react';
+import { Box, Button, Flash } from '@primer/react';
 import { useNavigate } from '../../hooks/index.js';
 export const FlashMock = () => {
     const navigate = useNavigate();
-    return (_jsxs(Flash, { variant: "warning", style: { marginBottom: 10 }, children: [_jsx(AlertIcon, {}), " This is a mock content.", ' ', _jsx(Link, { href: "#", onClick: e => navigate('/contact', e), children: "Contact us" }), ' ', "if you'd like to know more about this feature."] }));
+    return (_jsx(Flash, { variant: "warning", style: { marginBottom: 10 }, children: _jsxs(Box, { sx: {
+                display: 'flex',
+                alignItems: 'center',
+                justifyContent: 'space-between',
+                gap: 3,
+                width: '100%',
+            }, children: [_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 2 }, children: [_jsx(AlertIcon, {}), _jsx("span", { children: "This is placeholder content. Contact us to learn more about this feature." })] }), _jsx(Button, { size: "small", onClick: () => navigate('/contact'), children: "Contact Us" })] }) }));
 };
 export default FlashMock;

package/lib/models/{RuntimeSnapshot.d.ts → CodeSandboxSnapshot.d.ts}

@@ -1,7 +1,7 @@
 /**
- * Runtime snapshot from API.
+ * Code Sandbox snapshot from API.
  */
-export interface IAPIRuntimeSnapshot {
+export interface IAPICodeSandboxSnapshot {
     /**
      * Snapshot UID
      */
@@ -44,9 +44,9 @@ export interface IAPIRuntimeSnapshot {
     status: string;
 }
 /**
- * Runtime snapshot model.
+ * Code Sandbox snapshot model.
  */
-export interface IRuntimeSnapshot {
+export interface ICodeSandboxSnapshot {
     /**
      * Snapshot UID
      */
@@ -89,4 +89,4 @@ export interface IRuntimeSnapshot {
      */
     status: string;
 }
-export declare function asRuntimeSnapshot(s: IAPIRuntimeSnapshot): IRuntimeSnapshot;
+export declare function asCodeSandboxSnapshot(s: IAPICodeSandboxSnapshot): ICodeSandboxSnapshot;

package/lib/models/{RuntimeSnapshot.js → CodeSandboxSnapshot.js}

@@ -2,7 +2,7 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export function asRuntimeSnapshot(s) {
+export function asCodeSandboxSnapshot(s) {
     const { uid, updated_at, format_version, ...others } = s;
     return {
         ...others,