@datalayer/core 0.0.15 → 0.0.17

package/lib/components/runtimes/RuntimeSimplePicker.js

@@ -35,7 +35,7 @@ var RuntimeDialogCause;
  * Runtime simple picker component.
  */
 export function RuntimeSimplePicker(props) {
-    const { assignRuntime, sessionConnection } = props;
+    const { assignRuntime, sessionConnection, browserRuntimeAvailable = true, } = props;
     const { runtimeModels, multiServiceManager } = useRuntimesStore();
     const jupyterReactStore = useJupyterReactStore();
     const jupyterLabAdapter = jupyterReactStore.jupyterLabAdapter;
@@ -120,7 +120,7 @@ export function RuntimeSimplePicker(props) {
                                                 sessionConnection === undefined, onSelect: () => {
                                                 setRuntimeLocation(undefined);
                                                 assignRuntime({ runtimeDesc: undefined });
-                                            }, children: [_jsx(ActionList.LeadingVisual, { children: _jsx(EyeIcon, {}) }), "Viewer", _jsx(ActionList.Description, { variant: "block", children: "A simple Notebook Viewer without Runtime." })] }), _jsxs(ActionList.Item, { selected: runtimeLocation === 'browser', onSelect: () => {
+                                            }, children: [_jsx(ActionList.LeadingVisual, { children: _jsx(EyeIcon, {}) }), "Viewer", _jsx(ActionList.Description, { variant: "block", children: "A simple Notebook Viewer without Runtime." })] }), browserRuntimeAvailable && (_jsxs(ActionList.Item, { selected: runtimeLocation === 'browser', onSelect: () => {
                                                 setRuntimeLocation('browser');
                                                 assignRuntime({
                                                     runtimeDesc: {
@@ -129,7 +129,7 @@ export function RuntimeSimplePicker(props) {
                                                         language: 'python',
                                                     },
                                                 });
-                                            }, children: [_jsx(ActionList.LeadingVisual, { children: _jsx(BrowserIcon, {}) }), "Browser Runtime", _jsx(ActionList.Description, { variant: "block", children: "A Browser Runtime based on Pyodide." })] })] }), runtimeModels.length > 0 && (_jsxs(ActionList.Group, { children: [_jsx(ActionList.GroupHeading, { children: "Cloud Runtimes" }), runtimeModels.map(kernelModel => {
+                                            }, children: [_jsx(ActionList.LeadingVisual, { children: _jsx(BrowserIcon, {}) }), "Browser Runtime", _jsx(ActionList.Description, { variant: "block", children: "A Browser Runtime based on Pyodide." })] }))] }), runtimeModels.length > 0 && (_jsxs(ActionList.Group, { children: [_jsx(ActionList.GroupHeading, { children: "Cloud Runtimes" }), runtimeModels.map(kernelModel => {
                                             return (_jsxs(ActionList.Item, { selected: sessionConnection?.kernel?.id === kernelModel.id, onSelect: () => {
                                                     setRuntimeLocation('remote');
                                                     assignRuntime({

package/lib/examples/ChatExample.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Chat Example Component
+ *
+ * Demonstrates the ChatComponent with all necessary providers:
+ * - QueryClientProvider for data fetching
+ */
+declare const ChatExample: React.FC;
+export default ChatExample;

package/lib/examples/ChatExample.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2024-2025 Datalayer, Inc.
+ *
+ * BSD 3-Clause License
+ */
+import { Text } from '@primer/react';
+import { Box } from '@datalayer/primer-addons';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { ChatComponent } from '../components/chat/ChatComponent';
+import { datalayerTheme, DatalayerThemeProvider } from '@/theme';
+// Create a query client for React Query
+const queryClient = new QueryClient({
+    defaultOptions: {
+        queries: {
+            staleTime: 1000 * 60 * 5, // 5 minutes
+            gcTime: 1000 * 60 * 10, // 10 minutes
+            retry: 1,
+            refetchOnWindowFocus: false,
+        },
+    },
+});
+/**
+ * Chat Example Component
+ *
+ * Demonstrates the ChatComponent with all necessary providers:
+ * - QueryClientProvider for data fetching
+ */
+const ChatExample = () => {
+    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(DatalayerThemeProvider, { theme: datalayerTheme, children: _jsxs(Box, { sx: {
+                    display: 'flex',
+                    flexDirection: 'column',
+                    height: '100vh',
+                    backgroundColor: 'canvas.default',
+                }, children: [_jsxs(Box, { as: "header", sx: {
+                            borderBottom: '1px solid',
+                            borderColor: 'border.default',
+                            padding: 3,
+                        }, children: [_jsx(Text, { sx: {
+                                    fontSize: 3,
+                                    fontWeight: 'bold',
+                                    display: 'block',
+                                    marginBottom: 1,
+                                }, children: "Chat Example" }), _jsx(Text, { sx: { fontSize: 1, color: 'fg.muted' }, children: "Interactive chat interface with AI assistance" })] }), _jsx(Box, { as: "main", sx: {
+                            flex: 1,
+                            overflow: 'hidden',
+                            display: 'flex',
+                            flexDirection: 'column',
+                        }, children: _jsx(ChatComponent, {}) })] }) }) }));
+};
+export default ChatExample;

package/lib/examples/example-selector.js

@@ -8,6 +8,7 @@
  */
 export const EXAMPLES = {
     CellExample: () => import('./CellExample'),
+    ChatExample: () => import('./ChatExample'),
     DatalayerNotebookExample: () => import('./DatalayerNotebookExample'),
     NotebookExample: () => import('./NotebookExample'),
     NotebookMutationsKernel: () => import('./NotebookMutationsKernel'),

package/lib/hooks/useAIJupyterChat.d.ts

@@ -0,0 +1,36 @@
+export interface IUseAIJupyterChatOptions {
+    apiUrl?: string;
+    initialMessages?: unknown[];
+}
+/**
+ * Hook to manage chat state with JupyterLab backend.
+ * Adapts Vercel AI SDK's useChat for Datalayer AI context.
+ */
+export declare function useAIJupyterChat(_options?: IUseAIJupyterChatOptions): {
+    messages: import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[];
+    sendMessage: (message?: (Omit<import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>, "id" | "role"> & {
+        id?: string | undefined;
+        role?: "user" | "system" | "assistant" | undefined;
+    } & {
+        text?: never;
+        files?: never;
+        messageId?: string;
+    }) | {
+        text: string;
+        files?: FileList | import("ai").FileUIPart[];
+        metadata?: unknown;
+        parts?: never;
+        messageId?: string;
+    } | {
+        files: FileList | import("ai").FileUIPart[];
+        metadata?: unknown;
+        parts?: never;
+        messageId?: string;
+    } | undefined, options?: import("ai").ChatRequestOptions) => Promise<void>;
+    status: import("ai").ChatStatus;
+    setMessages: (messages: import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[] | ((messages: import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[]) => import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[])) => void;
+    regenerate: ({ messageId, ...options }?: {
+        messageId?: string;
+    } & import("ai").ChatRequestOptions) => Promise<void>;
+    clearChat: () => void;
+};

package/lib/hooks/useAIJupyterChat.js

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2024-2025 Datalayer, Inc.
+ *
+ * BSD 3-Clause License
+ */
+import { useCallback, useMemo } from 'react';
+import { useChat } from '@ai-sdk/react';
+import { DefaultChatTransport } from 'ai';
+import { ServerConnection } from '@jupyterlab/services';
+import { URLExt } from '@jupyterlab/coreutils';
+/**
+ * Hook to manage chat state with JupyterLab backend.
+ * Adapts Vercel AI SDK's useChat for Datalayer AI context.
+ */
+export function useAIJupyterChat(_options = {}) {
+    // Build the full API URL for the chat endpoint
+    const settings = ServerConnection.makeSettings();
+    const chatEndpoint = URLExt.join(settings.baseUrl, 'datalayer', 'chat');
+    const { messages, sendMessage, status, setMessages, regenerate } = useChat({
+        id: 'ai-jupyter-chat',
+        transport: new DefaultChatTransport({
+            api: chatEndpoint,
+            credentials: settings.token ? 'include' : 'omit',
+            headers: {
+                Authorization: `token ${settings.token || ''}`,
+                'X-XSRFToken': settings.token || '',
+            },
+            fetch: async (input, init) => {
+                return fetch(input, {
+                    ...init,
+                    mode: 'cors',
+                    credentials: settings.token ? 'include' : 'omit',
+                });
+            },
+        }),
+    });
+    // Clear chat history
+    const clearChat = useCallback(() => {
+        setMessages([]);
+    }, [setMessages]);
+    return useMemo(() => ({
+        messages,
+        sendMessage,
+        status,
+        setMessages,
+        regenerate,
+        clearChat,
+    }), [messages, sendMessage, status, setMessages, regenerate, clearChat]);
+}

package/lib/hooks/useCache.js

@@ -696,6 +696,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
      * ```
      */
     const useLogin = () => {
+        const iamStore = useIAMStore();
         return useMutation({
             mutationFn: async ({ handle, password, }) => {
                 return requestDatalayer({
@@ -704,7 +705,11 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                     body: { handle, password },
                 });
             },
-            onSuccess: () => {
+            onSuccess: async (resp) => {
+                // Set the token in IAM state
+                if (resp.token) {
+                    await iamStore.refreshUserByToken(resp.token);
+                }
                 // Invalidate all queries on successful login
                 queryClient.invalidateQueries();
             },
@@ -983,7 +988,6 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                     method: 'GET',
                 });
                 if (resp.success && resp.organizations) {
-                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     const orgs = resp.organizations.map((org) => {
                         const organization = toOrganization(org);
                         // Pre-populate caches
@@ -1512,6 +1516,9 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         return useQuery({
             queryKey: queryKeys.documents.bySpace(spaceId),
             queryFn: async () => {
+                if (!spaceId) {
+                    return [];
+                }
                 const resp = await requestDatalayer({
                     url: `${configuration.spacerRunUrl}/api/spacer/v1/spaces/${spaceId}/items/types/document`,
                     method: 'GET',
@@ -2099,7 +2106,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // BATCH 1: Core CRUD Operations - Refresh & Get Methods
+    // Core CRUD Operations - Refresh & Get Methods
     // ============================================================================
     /**
      * Get single datasource by ID
@@ -2385,7 +2392,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // BATCH 2: Member Management & User Extensions
+    // Member Management & User Extensions
     // ============================================================================
     /**
      * Refresh user data by ID (re-fetch from API)
@@ -2686,7 +2693,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // BATCH 3: Authentication, Roles, Schools, and Refresh Methods
+    // Authentication, Roles, Schools, and Refresh Methods
     // ============================================================================
     /**
      * Change user password
@@ -2896,9 +2903,8 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         return useMutation({
             mutationFn: async (organizationId) => {
                 return requestDatalayer({
-                    url: `${configuration.iamRunUrl}/api/iam/v1/teams`,
+                    url: `${configuration.iamRunUrl}/api/iam/v1/organizations/${organizationId}/teams`,
                     method: 'GET',
-                    body: { organizationId },
                 });
             },
             onSuccess: (resp, organizationId) => {
@@ -2950,7 +2956,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         return useMutation({
             mutationFn: async (organizationId) => {
                 return requestDatalayer({
-                    url: `${configuration.spacerRunUrl}/api/spacer/v1/organizations/${organizationId}/spaces`,
+                    url: `${configuration.spacerRunUrl}/api/spacer/v1/spaces/organizations/${organizationId}`,
                     method: 'GET',
                 });
             },
@@ -2996,7 +3002,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // BATCH 4: Courses, Space Items, and Advanced Features
+    // Courses, Space Items, and Advanced Features
     // ============================================================================
     /**
      * Get course by ID
@@ -3215,24 +3221,30 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             },
             onSuccess: (resp, variables) => {
                 if (resp.success) {
+                    // Transform raw API data to typed models
+                    const transformedUser = resp.user ? toUser(resp.user) : undefined;
+                    const transformedOrganization = resp.organization
+                        ? toOrganization(resp.organization)
+                        : undefined;
+                    const transformedSpace = resp.space ? toSpace(resp.space) : undefined;
                     // Set data directly into cache instead of just invalidating
-                    if (resp.user) {
-                        queryClient.setQueryData(queryKeys.users.byHandle(variables.accountHandle), resp.user);
+                    if (transformedUser) {
+                        queryClient.setQueryData(queryKeys.users.byHandle(variables.accountHandle), transformedUser);
                         queryClient.invalidateQueries({ queryKey: queryKeys.users.all() });
                     }
-                    if (resp.organization) {
-                        queryClient.setQueryData(queryKeys.organizations.byHandle(variables.accountHandle), resp.organization);
+                    if (transformedOrganization) {
+                        queryClient.setQueryData(queryKeys.organizations.byHandle(variables.accountHandle), transformedOrganization);
                         queryClient.invalidateQueries({
                             queryKey: queryKeys.organizations.all(),
                         });
                     }
-                    if (resp.space) {
+                    if (transformedSpace) {
                         // Set both user and org space queries based on which type it is
-                        if (resp.user && variables.spaceHandle) {
-                            queryClient.setQueryData(queryKeys.spaces.byHandle(variables.spaceHandle), resp.space);
+                        if (transformedUser && variables.spaceHandle) {
+                            queryClient.setQueryData(queryKeys.spaces.byHandle(variables.spaceHandle), transformedSpace);
                         }
-                        if (resp.organization && variables.spaceHandle) {
-                            queryClient.setQueryData(queryKeys.spaces.orgSpaceByHandle(resp.organization.id, variables.spaceHandle), resp.space);
+                        if (transformedOrganization && variables.spaceHandle) {
+                            queryClient.setQueryData(queryKeys.spaces.orgSpaceByHandle(transformedOrganization.id, variables.spaceHandle), transformedSpace);
                         }
                         queryClient.invalidateQueries({ queryKey: queryKeys.spaces.all() });
                     }
@@ -3254,7 +3266,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // BATCH 5: Cells, Datasets, Environments, and Lessons
+    // Cells, Datasets, Environments, and Lessons
     // ============================================================================
     /**
      * Get cell by ID
@@ -3531,7 +3543,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // BATCH 6: Exercises, Assignments, Invites, and Contacts
+    // Exercises, Assignments, Invites, and Contacts
     // ============================================================================
     /**
      * Get exercise by ID
@@ -3763,7 +3775,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 7] Assignment Student Operations
+    // Assignment Student Operations
     // ============================================================================
     /**
      * Fetch assignment from student perspective with enrollment data
@@ -3846,7 +3858,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 7] Exercise Grading
+    // Exercise Grading
     // ============================================================================
     /**
      * Grade an exercise by assigning points to student code
@@ -3872,7 +3884,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 7] Course Student & Course Items
+    // Course Student & Course Items
     // ============================================================================
     /**
      * Get a student in a course
@@ -3941,7 +3953,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 7] Inbounds & Outbounds
+    // Inbounds & Outbounds
     // ============================================================================
     /**
      * Get all inbound leads
@@ -4020,7 +4032,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 8] Advanced Outbound Operations
+    // Advanced Outbound Operations
     // ============================================================================
     /**
      * Try bulk emails (test mode) for outbound campaign
@@ -4098,7 +4110,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 8] Outbound Subscriptions
+    // Outbound Subscriptions
     // ============================================================================
     /**
      * Subscribe a user to outbound communications
@@ -4153,7 +4165,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 8] MFA (Multi-Factor Authentication)
+    // MFA (Multi-Factor Authentication)
     // ============================================================================
     /**
      * Enable MFA for current user
@@ -4204,7 +4216,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 8] Checkout & Credits
+    // Checkout & Credits
     // ============================================================================
     /**
      * Get Stripe pricing information
@@ -4259,7 +4271,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 8] Support & Surveys
+    // Support & Surveys
     // ============================================================================
     /**
      * Request platform support (first form)
@@ -4313,7 +4325,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 9] Join & Registration
+    // Join & Registration
     // ============================================================================
     /**
      * Request to join platform (standard registration)
@@ -4385,7 +4397,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 9] Password Recovery
+    // Password Recovery
     // ============================================================================
     /**
      * Create token for password change
@@ -4415,7 +4427,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 9] OAuth2 Authentication
+    // OAuth2 Authentication
     // ============================================================================
     /**
      * Get OAuth2 authorization URL
@@ -4451,7 +4463,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 9] Contact Enrichment & Tagging
+    // Contact Enrichment & Tagging
     // ============================================================================
     /**
      * Assign tag to contact
@@ -4566,7 +4578,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 9] Contact-User Linking
+    // Contact-User Linking
     // ============================================================================
     /**
      * Link user with contact
@@ -4613,7 +4625,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 9] Credits Quota & Usage
+    // Credits Quota & Usage
     // ============================================================================
     /**
      * Update user credits quota
@@ -4650,7 +4662,23 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                     url: `${configuration.iamRunUrl}/api/iam/v1/usage/user`,
                     method: 'GET',
                 });
-                return resp.usages || [];
+                // Transform snake_case API response to camelCase IUsage interface
+                const usages = (resp.usages || []).map((u) => ({
+                    id: u.resource_uid,
+                    accountId: u.account_uid,
+                    type: u.resource_type,
+                    burningRate: u.burning_rate,
+                    credits: u.credits,
+                    creditsLimit: u.credits_limit,
+                    startDate: u.start_date ? new Date(u.start_date) : new Date(),
+                    updatedAt: u.updated_at ? new Date(u.updated_at) : new Date(),
+                    endDate: u.end_date ? new Date(u.end_date) : undefined,
+                    givenName: u.given_name || u.resource_given_name || '',
+                    resourceState: u.resource_state,
+                    resources: u.pod_resources,
+                    metadata: new Map(Object.entries(u.metadata || {})),
+                }));
+                return usages;
             },
             ...options,
         });
@@ -4666,7 +4694,23 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                     url: `${configuration.iamRunUrl}/api/iam/v1/usage/users/${userId}`,
                     method: 'GET',
                 });
-                return resp.usages || [];
+                // Transform snake_case API response to camelCase IUsage interface
+                const usages = (resp.usages || []).map((u) => ({
+                    id: u.resource_uid,
+                    accountId: u.account_uid,
+                    type: u.resource_type,
+                    burningRate: u.burning_rate,
+                    credits: u.credits,
+                    creditsLimit: u.credits_limit,
+                    startDate: u.start_date ? new Date(u.start_date) : new Date(),
+                    updatedAt: u.updated_at ? new Date(u.updated_at) : new Date(),
+                    endDate: u.end_date ? new Date(u.end_date) : undefined,
+                    givenName: u.given_name || u.resource_given_name || '',
+                    resourceState: u.resource_state,
+                    resources: u.pod_resources,
+                    metadata: new Map(Object.entries(u.metadata || {})),
+                }));
+                return usages;
             },
             enabled: !!userId,
             ...options,
@@ -4683,13 +4727,29 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                     url: `${configuration.iamRunUrl}/api/iam/v1/usage/platform`,
                     method: 'GET',
                 });
-                return resp.usages || [];
+                // Transform snake_case API response to camelCase IUsage interface
+                const usages = (resp.usages || []).map((u) => ({
+                    id: u.resource_uid,
+                    accountId: u.account_uid,
+                    type: u.resource_type,
+                    burningRate: u.burning_rate,
+                    credits: u.credits,
+                    creditsLimit: u.credits_limit,
+                    startDate: u.start_date ? new Date(u.start_date) : new Date(),
+                    updatedAt: u.updated_at ? new Date(u.updated_at) : new Date(),
+                    endDate: u.end_date ? new Date(u.end_date) : undefined,
+                    givenName: u.given_name || u.resource_given_name || '',
+                    resourceState: u.resource_state,
+                    resources: u.pod_resources,
+                    metadata: new Map(Object.entries(u.metadata || {})),
+                }));
+                return usages;
             },
             ...options,
         });
     };
     // ============================================================================
-    // [BATCH 10] Search Operations
+    // Search Operations
     // ============================================================================
     /**
      * Search public items (notebooks, documents, etc.)
@@ -4717,7 +4777,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 10] Social Media Integrations
+    // Social Media Integrations
     // ============================================================================
     /**
      * Get GitHub profile from access token
@@ -4869,7 +4929,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 10] Proxy Operations
+    // Proxy Operations
     // ============================================================================
     /**
      * Proxy GET request
@@ -4928,7 +4988,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // [BATCH 10] Waiting List & Growth
+    // Waiting List & Growth
     // ============================================================================
     /**
      * Register to waiting list
@@ -4966,7 +5026,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // BATCH 11: Refresh Operations & Additional Methods
+    // Refresh Operations & Additional Methods
     // ============================================================================
     /**
      * Refresh a specific user space
@@ -5406,7 +5466,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // BATCH 12: Additional Refresh Operations
+    // Additional Refresh Operations
     // ============================================================================
     /**
      * Refresh a specific environment
@@ -5641,7 +5701,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
-    // BATCH 13: Final Methods - Invites, Contacts, Inbounds, Outbounds
+    // Invites, Contacts, Inbounds, Outbounds
     // ============================================================================
     /**
      * Request an invite (mutation)

package/lib/hooks/useMobile.d.ts

@@ -0,0 +1 @@
+export declare function useIsMobile(): boolean;

package/lib/hooks/useMobile.js

@@ -0,0 +1,22 @@
+/*
+ * Copyright (c) 2024-2025 Datalayer, Inc.
+ *
+ * BSD 3-Clause License
+ */
+import * as React from 'react';
+const MOBILE_BREAKPOINT = 768;
+export function useIsMobile() {
+    const [isMobile, setIsMobile] = React.useState(undefined);
+    React.useEffect(() => {
+        const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);
+        const onChange = () => {
+            setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
+        };
+        mql.addEventListener('change', onChange);
+        setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
+        return () => {
+            mql.removeEventListener('change', onChange);
+        };
+    }, []);
+    return !!isMobile;
+}