@datalayer/core 1.0.13 → 1.0.15

package/lib/api/spacer/spaces.js

@@ -9,9 +9,9 @@
  *
  * @module api/spacer/spaces
  */
-import { requestDatalayerAPI } from '../DatalayerApi';
-import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants';
-import { validateToken } from '../utils/validation';
+import { requestDatalayerAPI } from '../DatalayerApi.js';
+import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants.js';
+import { validateToken } from '../utils/validation.js';
 /**
  * Create a new workspace space.
  * @param token - Authentication token
@@ -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/api/spacer/users.js

@@ -9,9 +9,9 @@
  *
  * @module api/spacer/users
  */
-import { requestDatalayerAPI } from '../DatalayerApi';
-import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants';
-import { validateToken } from '../utils/validation';
+import { requestDatalayerAPI } from '../DatalayerApi.js';
+import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants.js';
+import { validateToken } from '../utils/validation.js';
 /**
  * Get all spaces for the current authenticated user.
  * @param token - Authentication token

package/lib/client/auth/AuthenticationManager.js

@@ -5,9 +5,9 @@
 /**
  * Core authentication manager for the Datalayer Client
  */
-import * as authentication from '../../api/iam/authentication';
-import { TokenAuthStrategy, CredentialsAuthStrategy, StorageAuthStrategy, BrowserOAuthStrategy, } from './strategies';
-import { NodeStorage, BrowserStorage } from './storage';
+import * as authentication from '../../api/iam/authentication.js';
+import { TokenAuthStrategy, CredentialsAuthStrategy, StorageAuthStrategy, BrowserOAuthStrategy, } from './strategies.js';
+import { NodeStorage, BrowserStorage } from './storage.js';
 /**
  * Authentication Manager for Datalayer Client
  * Provides a unified interface for all authentication methods

package/lib/client/auth/index.js

@@ -11,7 +11,7 @@
  * Authentication module for Datalayer Client
  * Provides unified authentication interface with multiple strategies
  */
-export * from './types';
-export * from './storage';
-export * from './strategies';
-export * from './AuthenticationManager';
+export * from './types.js';
+export * from './storage.js';
+export * from './strategies.js';
+export * from './AuthenticationManager.js';

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

@@ -10,16 +10,17 @@
 /**
  * Token storage backend implementations
  */
-import { DATALAYER_IAM_TOKEN_KEY, DATALAYER_IAM_USER_KEY, } from '../../state/storage/IAMStorage';
+import { DATALAYER_IAM_TOKEN_KEY, DATALAYER_IAM_USER_KEY, } from '../../state/storage/IAMStorage.js';
 /**
  * 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/auth/strategies.js

@@ -10,9 +10,9 @@
 /**
  * Authentication strategy implementations
  */
-import * as authentication from '../../api/iam/authentication';
-import * as profile from '../../api/iam/profile';
-import { UserDTO } from '../../models/UserDTO';
+import * as authentication from '../../api/iam/authentication.js';
+import * as profile from '../../api/iam/profile.js';
+import { UserDTO } from '../../models/UserDTO.js';
 /**
  * Base authentication strategy with common functionality
  */

package/lib/client/base.js

@@ -6,8 +6,8 @@
  * Base Client class providing core configuration and token management.
  * @module client/base
  */
-import { DEFAULT_SERVICE_URLS } from '../api/constants';
-import { AuthenticationManager } from './auth';
+import { DEFAULT_SERVICE_URLS } from '../api/constants.js';
+import { AuthenticationManager } from './auth/index.js';
 /** Base Client class providing core configuration and token management. */
 export class DatalayerClientBase {
     /** URL for IAM service */

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

@@ -18,10 +18,10 @@
  * const runtime = await client.createRuntime(config);
  * ```
  */
-import { DatalayerClientBase, } from './base';
-import { IAMMixin } from './mixins/IAMMixin';
-import { RuntimesMixin } from './mixins/RuntimesMixin';
-import { SpacerMixin } from './mixins/SpacerMixin';
+import { DatalayerClientBase, } from './base.js';
+import { IAMMixin } from './mixins/IAMMixin.js';
+import { RuntimesMixin } from './mixins/RuntimesMixin.js';
+import { SpacerMixin } from './mixins/SpacerMixin.js';
 /**
  * Helper function to compose mixins in a more readable way.
  * Applies mixins in the order provided.
@@ -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
  * });
  * ```
@@ -65,21 +65,22 @@ export class DatalayerClient extends DatalayerClientWithMixins {
 }
 export { DatalayerClientBase };
 // Export models for use by consumers
-export { UserDTO as User } from './../models/UserDTO';
-export { RuntimeDTO as Runtime } from '../models/RuntimeDTO';
-export { EnvironmentDTO as Environment } from '../models/EnvironmentDTO';
-export { RuntimeSnapshotDTO as Snapshot } from '../models/RuntimeSnapshotDTO';
-export { SpaceDTO as Space } from '../models/SpaceDTO';
-export { NotebookDTO as Notebook } from '../models/NotebookDTO';
-export { LexicalDTO } from '../models/LexicalDTO';
-export { CreditsDTO as Credits } from '../models/CreditsDTO';
-export { ItemDTO as Item } from '../models/ItemDTO';
-export { HealthCheck } from '../models/HealthCheck';
-export { SecretDTO as Secret } from './../models/Secret';
-export { DatasourceDTO as Datasource } from './../models/Datasource';
+export { UserDTO as User } from './../models/UserDTO.js';
+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';
+export { ItemDTO as Item } from '../models/ItemDTO.js';
+export { HealthCheck } from '../models/HealthCheck.js';
+export { SecretDTO as Secret } from './../models/Secret.js';
+export { DatasourceDTO as Datasource } from './../models/Datasource.js';
 // Export auth types
-export { AuthenticationManager } from './auth/AuthenticationManager';
+export { AuthenticationManager } from './auth/AuthenticationManager.js';
 // Constants
-export { ItemTypes } from './constants';
+export { ItemTypes } from './constants.js';
 // Export authentication module
-export * from './auth';
+export * from './auth/index.js';

package/lib/client/mixins/IAMMixin.js

@@ -6,16 +6,16 @@
  * IAM mixin providing authentication and user management functionality.
  * @module client/mixins/IAMMixin
  */
-import * as authentication from '../../api/iam/authentication';
-import * as profile from '../../api/iam/profile';
-import * as usage from '../../api/iam/usage';
-import * as secrets from '../../api/iam/secrets';
-import * as datasources from '../../api/iam/datasources';
-import { UserDTO } from '../../models/UserDTO';
-import { CreditsDTO } from '../../models/CreditsDTO';
-import { HealthCheck } from '../../models/HealthCheck';
-import { SecretDTO } from '../../models/Secret';
-import { DatasourceDTO } from '../../models/Datasource';
+import * as authentication from '../../api/iam/authentication.js';
+import * as profile from '../../api/iam/profile.js';
+import * as usage from '../../api/iam/usage.js';
+import * as secrets from '../../api/iam/secrets.js';
+import * as datasources from '../../api/iam/datasources.js';
+import { UserDTO } from '../../models/UserDTO.js';
+import { CreditsDTO } from '../../models/CreditsDTO.js';
+import { HealthCheck } from '../../models/HealthCheck.js';
+import { SecretDTO } from '../../models/Secret.js';
+import { DatasourceDTO } from '../../models/Datasource.js';
 /** IAM mixin providing authentication and user management. */
 export function IAMMixin(Base) {
     return class extends Base {

package/lib/client/mixins/RuntimesMixin.js

@@ -6,13 +6,13 @@
  * Runtimes mixin for managing computational environments and runtime instances.
  * @module client/mixins/RuntimesMixin
  */
-import * as environments from '../../api/runtimes/environments';
-import * as runtimes from '../../api/runtimes/runtimes';
-import * as snapshots from '../../api/runtimes/snapshots';
-import { EnvironmentDTO } from '../../models/EnvironmentDTO';
-import { RuntimeDTO } from '../../models/RuntimeDTO';
-import { RuntimeSnapshotDTO } from '../../models/RuntimeSnapshotDTO';
-import { HealthCheck } from '../../models/HealthCheck';
+import * as environments from '../../api/runtimes/environments.js';
+import * as runtimes from '../../api/runtimes/runtimes.js';
+import * as snapshots from '../../api/runtimes/snapshots.js';
+import { EnvironmentDTO } from '../../models/EnvironmentDTO.js';
+import { RuntimeDTO } from '../../models/RuntimeDTO.js';
+import { RuntimeSnapshotDTO } from '../../models/RuntimeSnapshotDTO.js';
+import { HealthCheck } from '../../models/HealthCheck.js';
 /** Runtimes mixin providing computational environment and runtime management. */
 export function RuntimesMixin(Base) {
     return class extends Base {

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;