@datalayer/core 0.0.13 → 0.0.15

package/lib/hooks/useIAM.js

@@ -14,7 +14,9 @@ export const useIAM = (props = { user: undefined, token: undefined }) => {
     const layoutStore = useLayoutStore();
     const organizationStore = useOrganizationStore();
     const spaceStore = useSpaceStore();
-    const { clearAllCaches, whoami } = useCache();
+    const { useWhoami, useLogout } = useCache();
+    const { data: whoamiData } = useWhoami();
+    const logoutMutation = useLogout();
     const loginAndNavigate = async (token, logout, refresh, navigate, homeRoute) => {
         try {
             const resp = await requestDatalayerAPI({
@@ -60,27 +62,26 @@ export const useIAM = (props = { user: undefined, token: undefined }) => {
         layoutStore.reset();
         organizationStore.updateOrganizations([]);
         spaceStore.updateSpaces([]);
-        clearAllCaches();
+        // Call TanStack Query logout mutation which will clear all caches
+        logoutMutation.mutate();
         setIAMState({ user: ANONYMOUS_USER, token: ANONYMOUS_USER_TOKEN });
     };
     useEffect(() => {
-        if (token) {
-            whoami().then(resp => {
-                if (resp.success) {
-                    const user = asUser(resp.profile);
-                    setIAMState({ user, token });
-                    iamStore.setLogin(user, token);
-                    // TODO centralize user settings management.
-                    const aiagentsRunUrl = user.settings?.aiAgentsUrl;
-                    if (aiagentsRunUrl) {
-                        coreStore.getState().setConfiguration({
-                            aiagentsRunUrl,
-                        });
-                    }
+        if (token && whoamiData) {
+            if (whoamiData.success) {
+                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]);
     return {
         user: iamState.user,
         token: iamState.token,

package/lib/index.d.ts

@@ -7,9 +7,8 @@ export * from './hooks';
 export { requestDatalayerAPI, RunResponseError, NetworkError, } from './api/DatalayerApi';
 export type { IRequestDatalayerAPIOptions } from './api/DatalayerApi';
 export { API_BASE_PATHS } from './api/constants';
-export * from './api/types';
 export * as runtimesApi from './api/runtimes';
 export * as iamApi from './api/iam';
 export * as spacerApi from './api/spacer';
-export { DatalayerClient, type DatalayerClientConfig, type SDKHandlers, User, Runtime, Environment, Snapshot, Space, Notebook, Lexical, Credits, Item, type RuntimeJSON, type EnvironmentJSON, type UserJSON, } from './client';
+export { DatalayerClient, type DatalayerClientConfig, type SDKHandlers, User, Runtime, Environment, Snapshot, Space, Notebook, LexicalDTO, Credits, Item, type RuntimeJSON, type EnvironmentJSON, type UserJSON, } from './client';
 export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getRuntimeSnapshots, loadRuntimeSnapshot, } from './stateful/runtimes/actions';

package/lib/index.js

@@ -12,12 +12,11 @@ export * from './hooks';
 // Export API and SDK layers
 export { requestDatalayerAPI, RunResponseError, NetworkError, } from './api/DatalayerApi';
 export { API_BASE_PATHS } from './api/constants';
-export * from './api/types';
 export * as runtimesApi from './api/runtimes';
 export * as iamApi from './api/iam';
 export * as spacerApi from './api/spacer';
 export { DatalayerClient, 
 // Export SDK models
-User, Runtime, Environment, Snapshot, Space, Notebook, Lexical, Credits, Item, } from './client';
+User, Runtime, Environment, Snapshot, Space, Notebook, LexicalDTO, Credits, Item, } from './client';
 // Export commonly used SDK functions directly for convenience
 export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getRuntimeSnapshots, loadRuntimeSnapshot, } from './stateful/runtimes/actions';

package/lib/{client/models/Credits.d.ts → models/CreditsDTO.d.ts}

@@ -1,9 +1,42 @@
 /**
- * Credits model for the Datalayer SDK.
- *
- * @module client/models/Credits
+ * Credit information for a user.
+ */
+export interface CreditsInfo {
+    /** Available credits */
+    credits: number;
+    /** Credit quota (null if unlimited) */
+    quota: number | null;
+    /** Last update timestamp */
+    last_update: string;
+}
+/**
+ * Credit reservation information.
  */
-import type { CreditsInfo, CreditReservation } from '../../api/iam/usage';
+export interface CreditReservation {
+    /** Reservation ID */
+    id: string;
+    /** Reserved credits */
+    credits: number;
+    /** Resource ID (e.g., runtime ID) */
+    resource: string;
+    /** Last update timestamp */
+    last_update: string;
+    /** Burning rate (credits per hour) for this reservation */
+    burning_rate: number;
+    /** Start date of the reservation */
+    start_date: string;
+}
+/**
+ * Response from the credits endpoint.
+ */
+export interface CreditsResponse {
+    /** Operation success status */
+    success: boolean;
+    /** Credit information */
+    credits: CreditsInfo;
+    /** Active credit reservations */
+    reservations: CreditReservation[];
+}
 /**
  * Credits model representing user's available credits and usage.
  *
@@ -17,7 +50,7 @@ import type { CreditsInfo, CreditReservation } from '../../api/iam/usage';
  * const maxMinutes = credits.calculateMaxRuntimeMinutes(environment.burningRate);
  * ```
  */
-export declare class Credits {
+export declare class CreditsDTO {
     /** @internal */
     _data: CreditsInfo;
     private _reservations;

package/lib/{client/models/Credits.js → models/CreditsDTO.js}

@@ -2,7 +2,12 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { validateJSON } from '../../api/utils/validation';
+/**
+ * Credits model for the Datalayer SDK.
+ *
+ * @module models/CreditsDTO
+ */
+import { validateJSON } from '../api/utils/validation';
 /**
  * Credits model representing user's available credits and usage.
  *
@@ -16,7 +21,7 @@ import { validateJSON } from '../../api/utils/validation';
  * const maxMinutes = credits.calculateMaxRuntimeMinutes(environment.burningRate);
  * ```
  */
-export class Credits {
+export class CreditsDTO {
     /** @internal */
     _data;
     _reservations;

package/lib/models/Environment.d.ts

@@ -60,7 +60,7 @@ export interface IDatalayerEnvironment {
     /**
      * Associate kernel attributes
      */
-    kernel?: {
+    runtime?: {
         /**
          * Proposed display name
          */

package/lib/{client/models/Environment.d.ts → models/EnvironmentDTO.d.ts}

@@ -1,10 +1,50 @@
 /**
  * Environment domain model for the Datalayer SDK.
  *
- * @module client/models/Environment
+ * @module models/EnvironmentDTO
  */
-import type { Environment as EnvironmentData } from '../../api/types/runtimes';
 import type { DatalayerClient } from '../index';
+/**
+ * Represents a computing environment available in the Datalayer platform.
+ * @interface EnvironmentData
+ */
+export interface EnvironmentData {
+    /** Human-readable title for the environment */
+    title: string;
+    /** Detailed description of the environment */
+    description: string;
+    /** Docker image used for this environment */
+    dockerImage: string;
+    /** Example usage or description */
+    example?: string;
+    /** Code snippets for this environment */
+    snippets?: any[];
+    /** Content mounts for this environment */
+    contents?: any[];
+    /** Kernel configuration */
+    runtime?: {
+        /** Template for kernel naming */
+        givenNameTemplate?: string;
+    };
+    /** Programming language (e.g., "python", "r") */
+    language: string;
+    /** Resource ranges configuration */
+    resourcesRanges?: any;
+    /** Credits consumed per hour when running */
+    burning_rate: number;
+    /** Simple resource specification */
+    resources?: any;
+    /** Name identifier for the environment */
+    name: string;
+    /** Docker registry for the image */
+    dockerRegistry?: string;
+    /** Icon or avatar URL for the environment */
+    icon?: string;
+    /** Whether the environment is enabled */
+    enabled?: boolean;
+    /** Tags associated with the environment */
+    tags?: string[];
+}
 /**
  * Stable public interface for Environment data.
  * This is the contract that SDK consumers can rely on.
@@ -22,6 +62,18 @@ export interface EnvironmentJSON {
     /** Rich description of the environment (contains HTML markup) */
     richDescription: string;
 }
+/**
+ * Response from listing available environments
+ * @interface ListEnvironmentsResponse
+ */
+export interface ListEnvironmentsResponse {
+    /** Whether the request was successful */
+    success: boolean;
+    /** Response message from the server */
+    message: string;
+    /** Array of available environments */
+    environments: EnvironmentData[];
+}
 /**
  * Environment domain model that wraps API responses with convenient methods.
  * Provides information about available computational environments.
@@ -33,7 +85,7 @@ export interface EnvironmentJSON {
  * console.log(aiEnv.title); // "AI Environment"
  * ```
  */
-export declare class Environment {
+export declare class EnvironmentDTO {
     /** @internal */
     _data: EnvironmentData;
     /**

package/lib/{client/models/Environment.js → models/EnvironmentDTO.js}

@@ -2,7 +2,7 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { validateJSON } from '../../api/utils/validation';
+import { validateJSON } from '../api/utils/validation';
 /**
  * Environment domain model that wraps API responses with convenient methods.
  * Provides information about available computational environments.
@@ -14,7 +14,7 @@ import { validateJSON } from '../../api/utils/validation';
  * console.log(aiEnv.title); // "AI Environment"
  * ```
  */
-export class Environment {
+export class EnvironmentDTO {
     /** @internal */
     _data;
     /**

package/lib/{client/models → models}/HealthCheck.js

@@ -2,7 +2,7 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { validateJSON } from '../../api/utils/validation';
+import { validateJSON } from '../api/utils/validation';
 /**
  * Represents a health check response from a Datalayer service.
  * Provides standardized health status information across all services.

package/lib/{api/types/iam.d.ts → models/IAM.d.ts}

@@ -1,89 +1,4 @@
-/**
- * Represents a user in the Datalayer platform
- * @interface User
- */
-export interface User {
-    /** uuid for the user */
-    id: string;
-    /** ulid for the user */
-    uid: string;
-    /** User's handle or nickname */
-    handle_s: string;
-    /** User's email address */
-    email_s: string;
-    /** User's first name */
-    first_name_t: string;
-    /** User's last name */
-    last_name_t: string;
-    /** Display name shown in the UI */
-    avatar_url_s: string;
-    /** Additional fields that may be present in the response */
-    [key: string]: any;
-}
-/**
- * Represents a user profile in the Datalayer platform
- * @interface Profile
- */
-interface Profile {
-    /** ISO 8601 timestamp of when the user was created */
-    creation_ts_dt: string;
-    /** Unique identifier for the user */
-    id: string;
-    /** ISO 8601 timestamp of when the user requested to join */
-    join_request_ts_dt: string | null;
-    /** ISO 8601 timestamp of when the user joined */
-    join_ts_dt: string;
-    /** ISO 8601 timestamp of last update */
-    last_update_ts_dt: string;
-    /** Origin of the user account */
-    origin_s: string;
-    /** Type of the record */
-    type_s: string;
-    /** User ID */
-    uid: string;
-    /** Email address */
-    email_s: string;
-    /** First name */
-    first_name_t: string;
-    /** User handle */
-    handle_s: string;
-    /** Last name */
-    last_name_t: string;
-    /** User roles array */
-    roles_ss?: string[];
-    /** Avatar URL */
-    avatar_url_s?: string;
-    /** Onboarding state as JSON string */
-    onboarding_s?: string;
-    /** New password request timestamp */
-    new_password_request_ts_dt?: string | null;
-    /** New password confirmation timestamp */
-    new_password_confirmation_ts_dt?: string | null;
-    /** Customer UID */
-    customer_uid?: string | null;
-    /** Credits customer UID for billing */
-    credits_customer_uid?: string | null;
-    /** Email unsubscription status */
-    unsubscribed_from_outbounds_b?: boolean;
-    /** Linked contact UID */
-    linked_contact_uid?: string | null;
-    /** MFA URL */
-    mfa_url_s?: string | null;
-    /** MFA secret */
-    mfa_secret_s?: string | null;
-    /** Email verification token */
-    email_token_s?: string | null;
-    /** Pending email update */
-    email_update_s?: string | null;
-    /** IAM providers (nested structure - not typed in detail) */
-    iam_providers?: any[];
-    /** User settings (nested structure - not typed in detail) */
-    settings?: any;
-    /** User events (nested structure - not typed in detail) */
-    events?: any[];
-    /** Allow additional fields that may come from the server */
-    [key: string]: any;
-}
+import { Profile } from './Profile';
 /**
  * Request payload for user login
  * @interface LoginRequest
@@ -200,4 +115,3 @@ export interface MembershipsResponse {
     /** Memberships information */
     memberships: any[];
 }
-export {};

package/lib/{client/models/Item.d.ts → models/ItemDTO.d.ts}

@@ -1,3 +1,8 @@
+/**
+ * Abstract base class for all Datalayer content items.
+ *
+ * @module models/ItemDTO
+ */
 import type { DatalayerClient } from '../index';
 /**
  * Abstract base class for all Datalayer content items.
@@ -6,7 +11,7 @@ import type { DatalayerClient } from '../index';
  * @template TData - Raw data type from API
  * @template TUpdateRequest - Update request type for API
  */
-export declare abstract class Item<TData> {
+export declare abstract class ItemDTO<TData> {
     protected _data: TData;
     private _sdk;
     private _deleted;

package/lib/{client/models/Item.js → models/ItemDTO.js}

@@ -2,12 +2,7 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-/**
- * Abstract base class for all Datalayer content items.
- *
- * @module client/models/Item
- */
-import * as items from '../../api/spacer/items';
+import * as items from '../api/spacer/items';
 /**
  * Abstract base class for all Datalayer content items.
  * Provides common functionality for content management including lifecycle tracking.
@@ -15,7 +10,7 @@ import * as items from '../../api/spacer/items';
  * @template TData - Raw data type from API
  * @template TUpdateRequest - Update request type for API
  */
-export class Item {
+export class ItemDTO {
     _data;
     _sdk;
     _deleted = false;

package/lib/{client/models/Lexical.d.ts → models/LexicalDTO.d.ts}

@@ -1,11 +1,83 @@
+import type { DatalayerClient } from '../index';
+import { ItemDTO } from './ItemDTO';
 /**
- * Lexical domain model for the Datalayer SDK.
- *
- * @module client/models/Lexical
+ * Represents a Lexical document (rich text editor)
+ * @interface Lexical
  */
-import type { Lexical as LexicalData } from '../../api/types/spacer';
-import type { DatalayerClient } from '../index';
-import { Item } from './Item';
+export interface LexicalData {
+    id: string;
+    uid: string;
+    name?: string;
+    name_t?: string;
+    content?: any;
+    space_id?: string;
+    owner_id?: string;
+    creator_uid?: string;
+    creator_handle_s?: string;
+    created_at?: string;
+    creation_ts_dt?: string;
+    updated_at?: string;
+    last_update_ts_dt?: string;
+    cdn_url_s: string;
+    type_s?: string;
+    public_b?: boolean;
+    description_t?: string;
+    document_name_s?: string;
+    document_extension_s: string;
+    document_format_s?: string;
+    content_length_i?: number;
+    content_type_s?: string;
+    mime_type_s?: string;
+    s3_path_s?: string;
+    s3_url_s?: string;
+    model_s?: string;
+}
+/**
+ * Request payload for creating a Lexical document
+ * @interface CreateLexicalRequest
+ */
+export interface CreateLexicalRequest {
+    spaceId: string;
+    documentType: string;
+    name: string;
+    description: string;
+    file?: File | Blob;
+}
+/**
+ * Response from creating a Lexical document
+ * @interface CreateLexicalResponse
+ */
+export interface CreateLexicalResponse {
+    success: boolean;
+    message: string;
+    document?: LexicalData;
+}
+/**
+ * Response from getting a Lexical document
+ * @interface GetLexicalResponse
+ */
+export interface GetLexicalResponse {
+    success: boolean;
+    message: string;
+    document?: LexicalData;
+}
+/**
+ * Request payload for updating a Lexical document
+ * @interface UpdateLexicalRequest
+ */
+export interface UpdateLexicalRequest {
+    name?: string;
+    description?: string;
+}
+/**
+ * Response from updating a Lexical document
+ * @interface UpdateLexicalResponse
+ */
+export interface UpdateLexicalResponse {
+    success: boolean;
+    message: string;
+    document: LexicalData;
+}
 /**
  * Stable public interface for Lexical data.
  * This is the contract that SDK consumers can rely on.
@@ -41,7 +113,7 @@ export interface LexicalJSON {
  * await lexical.update({ name: 'Updated Documentation' });
  * ```
  */
-export declare class Lexical extends Item<LexicalData> {
+export declare class LexicalDTO extends ItemDTO<LexicalData> {
     /**
      * Create a Lexical instance.
      *

package/lib/{client/models/Lexical.js → models/LexicalDTO.js}

@@ -2,10 +2,15 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import * as lexicals from '../../api/spacer/lexicals';
-import { Item } from './Item';
-import { ItemTypes } from '../constants';
-import { validateJSON } from '../../api/utils/validation';
+/**
+ * Lexical domain model for the Datalayer SDK.
+ *
+ * @module models/LexicalDTO
+ */
+import * as lexicals from '../api/spacer/lexicals';
+import { ItemTypes } from '../client';
+import { ItemDTO } from './ItemDTO';
+import { validateJSON } from '../api/utils/validation';
 /**
  * Lexical domain model that extends the base Item class.
  * Provides lexical document functionality for managing rich text documents.
@@ -16,7 +21,7 @@ import { validateJSON } from '../../api/utils/validation';
  * await lexical.update({ name: 'Updated Documentation' });
  * ```
  */
-export class Lexical extends Item {
+export class LexicalDTO extends ItemDTO {
     /**
      * Create a Lexical instance.
      *

package/lib/{client/models/Notebook.d.ts → models/NotebookDTO.d.ts}

@@ -1,11 +1,20 @@
+import type { DatalayerClient } from '../index';
+import { ItemDTO } from './ItemDTO';
 /**
- * Notebook domain model for the Datalayer SDK.
- *
- * @module client/models/Notebook
+ * Represents a Jupyter notebook document
+ * @interface NotebookData
  */
-import type { Notebook as NotebookData } from '../../api/types/spacer';
-import type { DatalayerClient } from '../index';
-import { Item } from './Item';
+export interface NotebookData {
+    id: string;
+    uid: string;
+    name_t: string;
+    description_t: string;
+    type_s: string;
+    notebook_extension_s: string;
+    s3_path_s: string;
+    s3_url_s: string;
+    cdn_url_s: string;
+}
 /**
  * Stable public interface for Notebook data.
  * This is the contract that SDK consumers can rely on.
@@ -37,7 +46,7 @@ export interface NotebookJSON {
  * const kernelSpec = await notebook.getKernelSpec();
  * ```
  */
-export declare class Notebook extends Item<NotebookData> {
+export declare class NotebookDTO extends ItemDTO<NotebookData> {
     /**
      * Create a Notebook instance.
      *

package/lib/{client/models/Notebook.js → models/NotebookDTO.js}

@@ -2,10 +2,10 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import * as notebooks from '../../api/spacer/notebooks';
-import { Item } from './Item';
-import { ItemTypes } from '../constants';
-import { validateJSON } from '../../api/utils/validation';
+import * as notebooks from '../api/spacer/notebooks';
+import { ItemDTO } from './ItemDTO';
+import { ItemTypes } from '../client/constants';
+import { validateJSON } from '../api/utils/validation';
 /**
  * Notebook domain model that extends the base Item class.
  * Provides notebook-specific functionality for managing Jupyter notebooks.
@@ -16,7 +16,7 @@ import { validateJSON } from '../../api/utils/validation';
  * const kernelSpec = await notebook.getKernelSpec();
  * ```
  */
-export class Notebook extends Item {
+export class NotebookDTO extends ItemDTO {
     /**
      * Create a Notebook instance.
      *

package/lib/models/Profile.d.ts

@@ -1 +1,66 @@
 export type IProfileType = 'user' | 'organization' | undefined;
+/**
+ * Represents a user profile in the Datalayer platform
+ * @interface Profile
+ */
+export interface Profile {
+    /** ISO 8601 timestamp of when the user was created */
+    creation_ts_dt: string;
+    /** Unique identifier for the user */
+    id: string;
+    /** ISO 8601 timestamp of when the user requested to join */
+    join_request_ts_dt: string | null;
+    /** ISO 8601 timestamp of when the user joined */
+    join_ts_dt: string;
+    /** ISO 8601 timestamp of last update */
+    last_update_ts_dt: string;
+    /** Origin of the user account */
+    origin_s: string;
+    /** Type of the record */
+    type_s: string;
+    /** User ID */
+    uid: string;
+    /** Email address */
+    email_s: string;
+    /** First name */
+    first_name_t: string;
+    /** User handle */
+    handle_s: string;
+    /** Last name */
+    last_name_t: string;
+    /** User roles array */
+    roles_ss?: string[];
+    /** Avatar URL */
+    avatar_url_s?: string;
+    /** Onboarding state as JSON string */
+    onboarding_s?: string;
+    /** New password request timestamp */
+    new_password_request_ts_dt?: string | null;
+    /** New password confirmation timestamp */
+    new_password_confirmation_ts_dt?: string | null;
+    /** Customer UID */
+    customer_uid?: string | null;
+    /** Credits customer UID for billing */
+    credits_customer_uid?: string | null;
+    /** Email unsubscription status */
+    unsubscribed_from_outbounds_b?: boolean;
+    /** Linked contact UID */
+    linked_contact_uid?: string | null;
+    /** MFA URL */
+    mfa_url_s?: string | null;
+    /** MFA secret */
+    mfa_secret_s?: string | null;
+    /** Email verification token */
+    email_token_s?: string | null;
+    /** Pending email update */
+    email_update_s?: string | null;
+    /** IAM providers (nested structure - not typed in detail) */
+    iam_providers?: any[];
+    /** User settings (nested structure - not typed in detail) */
+    settings?: any;
+    /** User events (nested structure - not typed in detail) */
+    events?: any[];
+    /** Allow additional fields that may come from the server */
+    [key: string]: any;
+}
+export default Profile;