@datalayer/core 1.0.14 → 1.0.15

package/lib/api/DatalayerApi.js

@@ -121,6 +121,11 @@ export async function requestDatalayerAPI({ url, method, body, token, signal, he
         // CORS mode is handled automatically by axios
         // Cache control headers
     };
+    // In Vitest+jsdom, axios may pick the XHR adapter and fail with browser-like
+    // network restrictions. Force the fetch adapter for integration reliability.
+    if (typeof process !== 'undefined' && process.env.VITEST) {
+        axiosConfig.adapter = 'fetch';
+    }
     // Add cache control headers only for GET requests (equivalent to cache: 'no-store')
     if (method === 'GET' || !method) {
         if (!axiosConfig.headers['Cache-Control']) {

package/lib/api/constants.d.ts

@@ -19,7 +19,7 @@ export declare const DEFAULT_SERVICE_URLS: {
     /** Default URL for OTEL (OpenTelemetry observability) service */
     readonly OTEL: "https://prod1.datalayer.run";
     /** Default URL for Runtimes service */
-    readonly RUNTIMES: "https://prod1.datalayer.run";
+    readonly RUNTIMES: "https://r1.datalayer.run";
     /** Default URL for Spacer (workspaces and collaboration) service */
     readonly SPACER: "https://prod1.datalayer.run";
 };

package/lib/api/constants.js

@@ -23,7 +23,7 @@ export const DEFAULT_SERVICE_URLS = {
     /** Default URL for OTEL (OpenTelemetry observability) service */
     OTEL: 'https://prod1.datalayer.run',
     /** Default URL for Runtimes service */
-    RUNTIMES: 'https://prod1.datalayer.run',
+    RUNTIMES: 'https://r1.datalayer.run',
     /** Default URL for Spacer (workspaces and collaboration) service */
     SPACER: 'https://prod1.datalayer.run',
 };

package/lib/api/spacer/lexicals.d.ts

@@ -24,3 +24,11 @@ export declare const getLexical: (token: string, id: string, baseUrl?: string) =
  * @returns Promise resolving to the updated document response
  */
 export declare const updateLexical: (token: string, id: string, data: UpdateLexicalRequest, baseUrl?: string) => Promise<UpdateLexicalResponse>;
+/**
+ * Clone a lexical document.
+ * @param token - Authentication token
+ * @param id - The document ID to clone
+ * @param baseUrl - Base URL for the API (defaults to production)
+ * @returns Promise resolving to the cloned document response
+ */
+export declare const cloneLexical: (token: string, id: string, baseUrl?: string) => Promise<CreateLexicalResponse>;

package/lib/api/spacer/lexicals.js

@@ -73,3 +73,17 @@ export const updateLexical = async (token, id, data, baseUrl = DEFAULT_SERVICE_U
         body: data,
     });
 };
+/**
+ * Clone a lexical document.
+ * @param token - Authentication token
+ * @param id - The document ID to clone
+ * @param baseUrl - Base URL for the API (defaults to production)
+ * @returns Promise resolving to the cloned document response
+ */
+export const cloneLexical = async (token, id, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SPACER}/lexicals/${id}/clone`,
+        method: 'POST',
+        token,
+    });
+};

package/lib/api/spacer/notebooks.d.ts

@@ -24,3 +24,11 @@ export declare const getNotebook: (token: string, id: string, baseUrl?: string)
  * @returns Promise resolving to the updated notebook response
  */
 export declare const updateNotebook: (token: string, id: string, data: UpdateNotebookRequest, baseUrl?: string) => Promise<UpdateNotebookResponse>;
+/**
+ * Clone a notebook.
+ * @param token - Authentication token
+ * @param id - The notebook ID to clone
+ * @param baseUrl - Base URL for the API (defaults to production)
+ * @returns Promise resolving to the cloned notebook response
+ */
+export declare const cloneNotebook: (token: string, id: string, baseUrl?: string) => Promise<CreateNotebookResponse>;

package/lib/api/spacer/notebooks.js

@@ -73,3 +73,17 @@ export const updateNotebook = async (token, id, data, baseUrl = DEFAULT_SERVICE_
         body: data,
     });
 };
+/**
+ * Clone a notebook.
+ * @param token - Authentication token
+ * @param id - The notebook ID to clone
+ * @param baseUrl - Base URL for the API (defaults to production)
+ * @returns Promise resolving to the cloned notebook response
+ */
+export const cloneNotebook = async (token, id, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SPACER}/notebooks/${id}/clone`,
+        method: 'POST',
+        token,
+    });
+};

package/lib/api/spacer/spaces.d.ts

@@ -1,4 +1,4 @@
-import { CreateSpaceRequest, CreateSpaceResponse } from '../../models/SpaceDTO';
+import { CreateSpaceRequest, CreateSpaceResponse, GetSpaceResponse, UpdateSpaceRequest, UpdateSpaceResponse, DeleteSpaceResponse, GetSpaceDefaultItemsResponse, GetSpacesByTypeResponse } from '../../models/SpaceDTO';
 /**
  * Create a new workspace space.
  * @param token - Authentication token
@@ -7,3 +7,78 @@ import { CreateSpaceRequest, CreateSpaceResponse } from '../../models/SpaceDTO';
  * @returns Promise resolving to the created space response
  */
 export declare const createSpace: (token: string, data: CreateSpaceRequest, baseUrl?: string) => Promise<CreateSpaceResponse>;
+/**
+ * Get a space by UID.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the space response
+ */
+export declare const getSpace: (token: string, uid: string, baseUrl?: string) => Promise<GetSpaceResponse>;
+/**
+ * Update a space (owner updating their own space).
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param data - Update data (supports arbitrary Solr fields)
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the updated space response
+ */
+export declare const updateSpace: (token: string, uid: string, data: UpdateSpaceRequest, baseUrl?: string) => Promise<UpdateSpaceResponse>;
+/**
+ * Update a user-specific space (e.g., org admin managing another user's space).
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param userId - User ID
+ * @param data - Update data (supports arbitrary Solr fields)
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the updated space response
+ */
+export declare const updateUserSpace: (token: string, uid: string, userId: string, data: UpdateSpaceRequest, baseUrl?: string) => Promise<UpdateSpaceResponse>;
+/**
+ * Delete a space and all its contents.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the delete response
+ */
+export declare const deleteSpace: (token: string, uid: string, baseUrl?: string) => Promise<DeleteSpaceResponse>;
+/**
+ * Get default items (notebook UID and document UID) for a space.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the default items response
+ */
+export declare const getSpaceDefaultItems: (token: string, uid: string, baseUrl?: string) => Promise<GetSpaceDefaultItemsResponse>;
+/**
+ * Get spaces by type (e.g., 'project', 'workspace', 'course').
+ * @param token - Authentication token
+ * @param type - Space type to filter by
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the spaces response
+ */
+export declare const getSpacesByType: (token: string, type: string, baseUrl?: string) => Promise<GetSpacesByTypeResponse>;
+/**
+ * Make a space public.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the updated space response
+ */
+export declare const makeSpacePublic: (token: string, uid: string, baseUrl?: string) => Promise<UpdateSpaceResponse>;
+/**
+ * Make a space private.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the updated space response
+ */
+export declare const makeSpacePrivate: (token: string, uid: string, baseUrl?: string) => Promise<UpdateSpaceResponse>;
+/**
+ * Export a space and its contents.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the export data
+ */
+export declare const exportSpace: (token: string, uid: string, baseUrl?: string) => Promise<any>;

package/lib/api/spacer/spaces.js

@@ -28,3 +28,143 @@ export const createSpace = async (token, data, baseUrl = DEFAULT_SERVICE_URLS.SP
         body: data,
     });
 };
+/**
+ * Get a space by UID.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the space response
+ */
+export const getSpace = async (token, uid, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
+    validateToken(token);
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SPACER}/spaces/${uid}`,
+        method: 'GET',
+        token,
+    });
+};
+/**
+ * Update a space (owner updating their own space).
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param data - Update data (supports arbitrary Solr fields)
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the updated space response
+ */
+export const updateSpace = async (token, uid, data, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
+    validateToken(token);
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SPACER}/spaces/${uid}`,
+        method: 'PUT',
+        token,
+        body: data,
+    });
+};
+/**
+ * Update a user-specific space (e.g., org admin managing another user's space).
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param userId - User ID
+ * @param data - Update data (supports arbitrary Solr fields)
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the updated space response
+ */
+export const updateUserSpace = async (token, uid, userId, data, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
+    validateToken(token);
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SPACER}/spaces/${uid}/users/${userId}`,
+        method: 'PUT',
+        token,
+        body: data,
+    });
+};
+/**
+ * Delete a space and all its contents.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the delete response
+ */
+export const deleteSpace = async (token, uid, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
+    validateToken(token);
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SPACER}/spaces/${uid}`,
+        method: 'DELETE',
+        token,
+    });
+};
+/**
+ * Get default items (notebook UID and document UID) for a space.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the default items response
+ */
+export const getSpaceDefaultItems = async (token, uid, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
+    validateToken(token);
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SPACER}/spaces/${uid}/default-items`,
+        method: 'GET',
+        token,
+    });
+};
+/**
+ * Get spaces by type (e.g., 'project', 'workspace', 'course').
+ * @param token - Authentication token
+ * @param type - Space type to filter by
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the spaces response
+ */
+export const getSpacesByType = async (token, type, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
+    validateToken(token);
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SPACER}/spaces/types/${type}`,
+        method: 'GET',
+        token,
+    });
+};
+/**
+ * Make a space public.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the updated space response
+ */
+export const makeSpacePublic = async (token, uid, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
+    validateToken(token);
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SPACER}/spaces/${uid}/public`,
+        method: 'PUT',
+        token,
+    });
+};
+/**
+ * Make a space private.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the updated space response
+ */
+export const makeSpacePrivate = async (token, uid, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
+    validateToken(token);
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SPACER}/spaces/${uid}/private`,
+        method: 'PUT',
+        token,
+    });
+};
+/**
+ * Export a space and its contents.
+ * @param token - Authentication token
+ * @param uid - Space UID
+ * @param baseUrl - Base URL for the API
+ * @returns Promise resolving to the export data
+ */
+export const exportSpace = async (token, uid, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
+    validateToken(token);
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SPACER}/spaces/${uid}/export`,
+        method: 'GET',
+        token,
+    });
+};

package/lib/client/auth/storage.d.ts

@@ -4,6 +4,7 @@ import { UserDTO } from '../../models/UserDTO';
  * Browser localStorage-based token storage
  */
 export declare class BrowserStorage implements TokenStorage {
+    private _available;
     /**
      * Get token from browser localStorage
      */
@@ -17,7 +18,8 @@ export declare class BrowserStorage implements TokenStorage {
      */
     delete(key: string): void;
     /**
-     * Check if browser localStorage is available
+     * Check if browser localStorage is available and functional.
+     * Result is cached after the first probe to avoid repeated writes.
      */
     isAvailable(): boolean;
     /**

package/lib/client/auth/storage.js

@@ -15,11 +15,12 @@ import { DATALAYER_IAM_TOKEN_KEY, DATALAYER_IAM_USER_KEY, } from '../../state/st
  * Browser localStorage-based token storage
  */
 export class BrowserStorage {
+    _available;
     /**
      * Get token from browser localStorage
      */
     get(key) {
-        if (typeof window === 'undefined') {
+        if (!this.isAvailable()) {
             return null;
         }
         return window.localStorage.getItem(key);
@@ -28,7 +29,7 @@ export class BrowserStorage {
      * Set token in browser localStorage
      */
     set(key, value) {
-        if (typeof window === 'undefined') {
+        if (!this.isAvailable()) {
             return;
         }
         window.localStorage.setItem(key, value);
@@ -37,16 +38,34 @@ export class BrowserStorage {
      * Delete token from browser localStorage
      */
     delete(key) {
-        if (typeof window === 'undefined') {
+        if (!this.isAvailable()) {
             return;
         }
         window.localStorage.removeItem(key);
     }
     /**
-     * Check if browser localStorage is available
+     * Check if browser localStorage is available and functional.
+     * Result is cached after the first probe to avoid repeated writes.
      */
     isAvailable() {
-        return typeof window !== 'undefined' && !!window.localStorage;
+        if (this._available !== undefined) {
+            return this._available;
+        }
+        try {
+            if (typeof window === 'undefined' || !window.localStorage) {
+                this._available = false;
+                return false;
+            }
+            const testKey = '__datalayer_storage_test__';
+            window.localStorage.setItem(testKey, 'test');
+            window.localStorage.removeItem(testKey);
+            this._available = true;
+            return true;
+        }
+        catch {
+            this._available = false;
+            return false;
+        }
     }
     /**
      * Get stored authentication token
@@ -395,16 +414,18 @@ export class ElectronStorage {
  */
 export function getDefaultStorage() {
     if (typeof window !== 'undefined') {
-        // Browser environment
-        return new BrowserStorage();
+        const browserStorage = new BrowserStorage();
+        if (browserStorage.isAvailable()) {
+            return browserStorage;
+        }
+        // window exists but localStorage is not functional (e.g., Node 22 with --localstorage-file)
+        // Fall through to Node.js storage
     }
-    else if (typeof process !== 'undefined') {
+    if (typeof process !== 'undefined') {
         // Node.js environment
         return new NodeStorage();
     }
-    else {
-        // Unknown environment, use in-memory storage
-        console.warn('Unknown environment, using in-memory storage (data will not persist)');
-        return new NodeStorage(); // NodeStorage has in-memory fallback
-    }
+    // Unknown environment, use in-memory storage
+    console.warn('Unknown environment, using in-memory storage (data will not persist)');
+    return new NodeStorage(); // NodeStorage has in-memory fallback
 }

package/lib/client/index.d.ts

@@ -26,6 +26,9 @@ import type { LexicalDTO } from '../models/LexicalDTO';
 import type { HealthCheck } from '../models/HealthCheck';
 import type { SecretDTO } from '../models/Secret';
 import type { CreateSecretRequest, UpdateSecretRequest } from '../models/Secret';
+import type { ProjectDTO } from '../models/ProjectDTO';
+import type { ProjectDefaultItems } from '../models/ProjectDTO';
+import type { UpdateSpaceRequest } from '../models/SpaceDTO';
 import type { DatasourceDTO } from '../models/Datasource';
 import type { CreateDatasourceRequest, UpdateDatasourceRequest } from '../models/Datasource';
 declare const DatalayerClientWithMixins: typeof DatalayerClientBase;
@@ -41,7 +44,7 @@ declare const DatalayerClientWithMixins: typeof DatalayerClientBase;
  *
  * const user = await client.whoami();
  * const runtime = await client.createRuntime({
- *   environment_name: 'python-cpu-env',
+ *   environment_name: 'ai-agents-env',
  *   credits_limit: 100
  * });
  * ```
@@ -65,7 +68,9 @@ export type { EnvironmentJSON, EnvironmentData, ListEnvironmentsResponse, } from
 export { RuntimeSnapshotDTO as Snapshot } from '../models/RuntimeSnapshotDTO';
 export type { RuntimeSnapshotJSON, RuntimeSnapshotData, CreateRuntimeSnapshotRequest, CreateRuntimeSnapshotResponse, GetRuntimeSnapshotResponse, ListRuntimeSnapshotsResponse, } from '../models/RuntimeSnapshotDTO';
 export { SpaceDTO as Space } from '../models/SpaceDTO';
-export type { SpaceJSON, SpaceData, SpaceItem, CreateSpaceRequest, CreateSpaceResponse, SpacesForUserResponse, CollaborationSessionResponse, DeleteSpaceItemResponse, GetSpaceItemResponse, GetSpaceItemsResponse, CreateNotebookRequest, CreateNotebookResponse, GetNotebookResponse, UpdateNotebookRequest, UpdateNotebookResponse, } from '../models/SpaceDTO';
+export type { SpaceJSON, SpaceData, SpaceItem, CreateSpaceRequest, CreateSpaceResponse, SpacesForUserResponse, CollaborationSessionResponse, DeleteSpaceItemResponse, GetSpaceItemResponse, GetSpaceItemsResponse, CreateNotebookRequest, CreateNotebookResponse, GetNotebookResponse, UpdateNotebookRequest, UpdateNotebookResponse, UpdateSpaceRequest, GetSpaceResponse, UpdateSpaceResponse, DeleteSpaceResponse, GetSpaceDefaultItemsResponse, GetSpacesByTypeResponse, } from '../models/SpaceDTO';
+export { ProjectDTO as Project } from '../models/ProjectDTO';
+export type { ProjectJSON, ProjectDefaultItems } from '../models/ProjectDTO';
 export { NotebookDTO as Notebook } from '../models/NotebookDTO';
 export type { NotebookJSON, NotebookData } from '../models/NotebookDTO';
 export { LexicalDTO } from '../models/LexicalDTO';
@@ -184,5 +189,20 @@ export interface DatalayerClient {
     getCollaborationSessionId(documentId: string): Promise<string>;
     getContent(itemId: string): Promise<any>;
     checkSpacerHealth(): Promise<HealthCheck>;
+    getSpace(uid: string): Promise<SpaceDTO>;
+    updateSpace(uid: string, data: UpdateSpaceRequest): Promise<SpaceDTO>;
+    updateUserSpace(uid: string, userId: string, data: UpdateSpaceRequest): Promise<SpaceDTO>;
+    deleteSpace(uid: string): Promise<void>;
+    makeSpacePublic(uid: string): Promise<SpaceDTO>;
+    makeSpacePrivate(uid: string): Promise<SpaceDTO>;
+    exportSpace(uid: string): Promise<any>;
+    cloneNotebook(id: string): Promise<NotebookDTO>;
+    cloneLexical(id: string): Promise<LexicalDTO>;
+    getProjects(): Promise<ProjectDTO[]>;
+    getProject(uid: string): Promise<ProjectDTO>;
+    createProject(name: string, description?: string): Promise<ProjectDTO>;
+    updateProject(uid: string, data: UpdateSpaceRequest): Promise<ProjectDTO>;
+    renameProject(uid: string, newName: string, description?: string): Promise<ProjectDTO>;
+    getProjectDefaultItems(uid: string): Promise<ProjectDefaultItems>;
     calculateCreditsFromMinutes(minutes: number, burningRate: number): number;
 }

package/lib/client/index.js

@@ -46,7 +46,7 @@ const DatalayerClientWithMixins = composeMixins(IAMMixin, RuntimesMixin, SpacerM
  *
  * const user = await client.whoami();
  * const runtime = await client.createRuntime({
- *   environment_name: 'python-cpu-env',
+ *   environment_name: 'ai-agents-env',
  *   credits_limit: 100
  * });
  * ```
@@ -70,6 +70,7 @@ export { RuntimeDTO as Runtime } from '../models/RuntimeDTO.js';
 export { EnvironmentDTO as Environment } from '../models/EnvironmentDTO.js';
 export { RuntimeSnapshotDTO as Snapshot } from '../models/RuntimeSnapshotDTO.js';
 export { SpaceDTO as Space } from '../models/SpaceDTO.js';
+export { ProjectDTO as Project } from '../models/ProjectDTO.js';
 export { NotebookDTO as Notebook } from '../models/NotebookDTO.js';
 export { LexicalDTO } from '../models/LexicalDTO.js';
 export { CreditsDTO as Credits } from '../models/CreditsDTO.js';

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

@@ -1,7 +1,9 @@
+import type { UpdateSpaceRequest } from '../../models/SpaceDTO';
 import type { Constructor } from '../utils/mixins';
 import { NotebookDTO } from '../../models/NotebookDTO';
 import { LexicalDTO } from '../../models/LexicalDTO';
 import { SpaceDTO } from '../../models/SpaceDTO';
+import { ProjectDTO, type ProjectDefaultItems } from '../../models/ProjectDTO';
 import { HealthCheck } from '../../models/HealthCheck';
 /** Options for content loading with CDN support. */
 export interface ContentLoadingOptions {
@@ -107,5 +109,102 @@ export declare function SpacerMixin<TBase extends Constructor>(Base: TBase): {
          * Get collaboration session ID for a document
          */
         getCollaborationSessionId(documentId: string): Promise<string>;
+        /**
+         * Get a space by UID.
+         * @param uid - Space UID
+         * @returns Space instance
+         */
+        getSpace(uid: string): Promise<SpaceDTO>;
+        /**
+         * Update a space (owner updating their own space).
+         * @param uid - Space UID
+         * @param data - Update data (supports arbitrary Solr fields)
+         * @returns Updated Space instance
+         */
+        updateSpace(uid: string, data: UpdateSpaceRequest): Promise<SpaceDTO>;
+        /**
+         * Update a user-specific space (e.g., org admin context).
+         * @param uid - Space UID
+         * @param userId - User ID
+         * @param data - Update data (supports arbitrary Solr fields)
+         * @returns Updated Space instance
+         */
+        updateUserSpace(uid: string, userId: string, data: UpdateSpaceRequest): Promise<SpaceDTO>;
+        /**
+         * Delete a space and all its contents.
+         * @param uid - Space UID
+         */
+        deleteSpace(uid: string): Promise<void>;
+        /**
+         * Make a space public.
+         * @param uid - Space UID
+         * @returns Updated Space instance
+         */
+        makeSpacePublic(uid: string): Promise<SpaceDTO>;
+        /**
+         * Make a space private.
+         * @param uid - Space UID
+         * @returns Updated Space instance
+         */
+        makeSpacePrivate(uid: string): Promise<SpaceDTO>;
+        /**
+         * Export a space and its contents.
+         * @param uid - Space UID
+         * @returns Export data
+         */
+        exportSpace(uid: string): Promise<any>;
+        /**
+         * Clone a notebook.
+         * @param id - Notebook ID to clone
+         * @returns Cloned Notebook instance
+         */
+        cloneNotebook(id: string): Promise<NotebookDTO>;
+        /**
+         * Clone a lexical document.
+         * @param id - Document ID to clone
+         * @returns Cloned Lexical instance
+         */
+        cloneLexical(id: string): Promise<LexicalDTO>;
+        /**
+         * Get all projects for the authenticated user.
+         * Projects are spaces with variant='project'.
+         * @returns Array of Project instances
+         */
+        getProjects(): Promise<ProjectDTO[]>;
+        /**
+         * Get a project by UID.
+         * @param uid - Project UID
+         * @returns Project instance
+         */
+        getProject(uid: string): Promise<ProjectDTO>;
+        /**
+         * Create a new project.
+         * @param name - Project name
+         * @param description - Project description
+         * @returns Created Project instance
+         */
+        createProject(name: string, description?: string): Promise<ProjectDTO>;
+        /**
+         * Update a project.
+         * @param uid - Project UID
+         * @param data - Update data (supports arbitrary Solr fields)
+         * @returns Updated Project instance
+         */
+        updateProject(uid: string, data: UpdateSpaceRequest): Promise<ProjectDTO>;
+        /**
+         * Rename a project.
+         * @param uid - Project UID
+         * @param newName - New project name
+         * @param description - Project description to preserve.
+         * @param userId - Authenticated user ID for user-scoped update.
+         * @returns Updated Project instance
+         */
+        renameProject(uid: string, newName: string, description?: string): Promise<ProjectDTO>;
+        /**
+         * Get default items (notebook UID and document UID) for a project.
+         * @param uid - Project UID
+         * @returns Default notebook and document UIDs
+         */
+        getProjectDefaultItems(uid: string): Promise<ProjectDefaultItems>;
     };
 } & TBase;