@datalayer/core 0.0.12 → 0.0.13

package/lib/sdk/client/models/Lexical.js

@@ -1,275 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { lexicals } from '../../../api/spacer';
-import { items } from '../../../api/spacer';
-/**
- * Lexical domain model that wraps API responses with convenient methods.
- *
- * Provides a rich, object-oriented interface for managing Lexical documents
- * with automatic data refresh and lifecycle operations.
- *
- * @example
- * ```typescript
- * const formData = new FormData();
- * formData.append('spaceId', 'space-123');
- * formData.append('name', 'Project Documentation');
- * const lexical = await sdk.createLexical(formData);
- *
- * // Static properties - instant access
- * console.log(lexical.id);
- * console.log(lexical.spaceId);
- *
- * // Dynamic data - always fresh from API
- * const currentName = await lexical.getName();
- * const content = await lexical.getContent();
- *
- * // Update document
- * const updated = await lexical.update({ name: 'Updated Documentation' });
- * ```
- */
-export class Lexical {
-    _data;
-    _sdk;
-    _deleted = false;
-    _freshData = null;
-    _lastFetch = 0;
-    _cacheTimeout = 5000; // 5 seconds cache timeout
-    /**
-     * Create a Lexical instance.
-     *
-     * @param data - Raw lexical data from API
-     * @param sdk - DatalayerSDK instance for making API calls
-     */
-    constructor(data, sdk) {
-        this._data = data;
-        this._sdk = sdk;
-    }
-    // ========================================================================
-    // Deletion State
-    // ========================================================================
-    /**
-     * Check if this lexical document has been deleted.
-     */
-    get isDeleted() {
-        return this._deleted;
-    }
-    // ========================================================================
-    // Helper Methods
-    // ========================================================================
-    /**
-     * Check if this lexical document has been deleted and throw error if so.
-     * @throws Error if the document has been deleted
-     */
-    _checkDeleted() {
-        if (this._deleted) {
-            throw new Error(`Lexical ${this._data.id} has been deleted and no longer exists`);
-        }
-    }
-    /**
-     * Get fresh data from API with caching to avoid redundant calls.
-     * @returns Current LexicalData from API or cache
-     */
-    async _getFreshData() {
-        this._checkDeleted();
-        const now = Date.now();
-        if (this._freshData && now - this._lastFetch < this._cacheTimeout) {
-            // Return cached data if recent enough
-            return this._freshData;
-        }
-        // Fetch fresh data from API
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
-        const response = await lexicals.getLexical(token, this.uid, spacerRunUrl);
-        if (response.document) {
-            this._freshData = response.document;
-            this._data = response.document; // Keep internal data up to date
-            this._lastFetch = now;
-            return this._freshData;
-        }
-        return this._data; // Fallback to existing data
-    }
-    // ========================================================================
-    // Static Properties (set at creation, never change)
-    // ========================================================================
-    /**
-     * Lexical document ID.
-     */
-    get id() {
-        this._checkDeleted();
-        return this._data.id;
-    }
-    /**
-     * Unique identifier for the document.
-     */
-    get uid() {
-        this._checkDeleted();
-        return this._data.uid;
-    }
-    /**
-     * Parent space ID.
-     */
-    get spaceId() {
-        this._checkDeleted();
-        // Try the direct field first (if API provides it)
-        if (this._data.space_id) {
-            return this._data.space_id;
-        }
-        // Extract from s3_path_s if available: "datalayer.app/SPACE_ID/documents/..."
-        const s3Path = this._data.s3_path_s;
-        if (s3Path && typeof s3Path === 'string') {
-            const match = s3Path.match(/^datalayer\.app\/([^/]+)\//);
-            if (match) {
-                return match[1];
-            }
-        }
-        // Fallback to empty string if no space ID can be determined
-        return '';
-    }
-    /**
-     * Owner user ID.
-     */
-    get ownerId() {
-        this._checkDeleted();
-        return this._data.owner_id || this._data.creator_uid || '';
-    }
-    /**
-     * When the document was created.
-     */
-    get createdAt() {
-        this._checkDeleted();
-        const dateStr = this._data.creation_ts_dt || this._data.created_at;
-        if (!dateStr) {
-            throw new Error('No creation timestamp available for lexical document');
-        }
-        return new Date(dateStr);
-    }
-    // ========================================================================
-    // Dynamic Methods (always fetch fresh data and update internal state)
-    // ========================================================================
-    /**
-     * Get the current name of the document.
-     *
-     * This method fetches fresh data from the API (with caching) and updates
-     * the internal data to keep everything in sync.
-     *
-     * @returns Promise resolving to current document name
-     * @throws Error if the document has been deleted
-     */
-    async getName() {
-        const freshData = await this._getFreshData();
-        return freshData.name_t || freshData.name || '';
-    }
-    /**
-     * Get the document content.
-     *
-     * @returns Promise resolving to document content
-     */
-    async getContent() {
-        const freshData = await this._getFreshData();
-        // Try to parse model_s if content is not available
-        if (!freshData.content && freshData.model_s) {
-            try {
-                return JSON.parse(freshData.model_s);
-            }
-            catch {
-                // Fall back to raw model_s if parsing fails
-                return freshData.model_s;
-            }
-        }
-        return freshData.content;
-    }
-    /**
-     * Get when the document was last updated.
-     *
-     * @returns Promise resolving to last update time
-     */
-    async getUpdatedAt() {
-        const freshData = await this._getFreshData();
-        const dateStr = freshData.last_update_ts_dt ||
-            freshData.updated_at ||
-            freshData.creation_ts_dt ||
-            freshData.created_at;
-        if (!dateStr) {
-            throw new Error('No timestamp available for lexical document');
-        }
-        return new Date(dateStr);
-    }
-    // ========================================================================
-    // Action Methods
-    // ========================================================================
-    /**
-     * Update the document name and/or description.
-     *
-     * @param data - Update data containing name and/or description
-     * @returns Promise resolving to updated Lexical instance
-     *
-     * @example
-     * ```typescript
-     * const updated = await lexical.update({
-     *   name: 'Updated Documentation',
-     *   description: 'Updated document description'
-     * });
-     * ```
-     */
-    async update(data) {
-        this._checkDeleted();
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
-        const response = await lexicals.updateLexical(token, this.uid, data, spacerRunUrl);
-        return new Lexical(response.document, this._sdk);
-    }
-    /**
-     * Delete this document permanently.
-     *
-     * After deletion, this object will be marked as deleted and subsequent
-     * calls to dynamic methods will throw errors.
-     *
-     * @example
-     * ```typescript
-     * await lexical.delete();
-     * console.log('Document deleted');
-     * // lexical.getName() will now throw an error
-     * ```
-     */
-    async delete() {
-        this._checkDeleted();
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
-        await items.deleteItem(token, this.uid, spacerRunUrl);
-        this._deleted = true;
-    }
-    // ========================================================================
-    // Utility Methods
-    // ========================================================================
-    /**
-     * Get raw document data object with latest information.
-     *
-     * This method ensures the returned data includes the most recent information
-     * by refreshing from the API before returning.
-     *
-     * @returns Promise resolving to raw document data
-     *
-     * @example
-     * ```typescript
-     * const latestData = await lexical.toJSON();
-     * console.log('Current name:', latestData.name);
-     * ```
-     */
-    async toJSON() {
-        this._checkDeleted();
-        await this.getName(); // This updates internal data
-        return this._data;
-    }
-    /**
-     * String representation of the document.
-     *
-     * @returns String representation for logging/debugging
-     */
-    toString() {
-        this._checkDeleted();
-        const name = this._data.name_t || this._data.name || 'Unnamed';
-        return `Lexical(${this.id}, ${name})`;
-    }
-}

package/lib/sdk/client/models/Notebook.d.ts

@@ -1,174 +0,0 @@
-/**
- * @module sdk/client/models/Notebook
- * @description Notebook domain model for the Datalayer SDK.
- *
- * This model provides a rich, object-oriented interface for working with
- * Jupyter notebooks, including content management and lifecycle operations.
- */
-import type { Notebook as NotebookData, UpdateNotebookRequest } from '../../../api/types/spacer';
-import type { DatalayerSDK } from '../index';
-/**
- * Notebook domain model that wraps API responses with convenient methods.
- *
- * Provides a rich, object-oriented interface for managing Jupyter notebooks
- * with automatic data refresh and lifecycle operations.
- *
- * @example
- * ```typescript
- * const formData = new FormData();
- * formData.append('spaceId', 'space-123');
- * formData.append('name', 'Data Analysis');
- * const notebook = await sdk.createNotebook(formData);
- *
- * // Static properties - instant access
- * console.log(notebook.id);
- * console.log(notebook.spaceId);
- *
- * // Dynamic data - always fresh from API
- * const currentName = await notebook.getName();
- * const content = await notebook.getContent();
- *
- * // Update notebook
- * const updated = await notebook.update({ name: 'New Analysis' });
- * ```
- */
-export declare class Notebook {
-    protected _data: NotebookData;
-    private _sdk;
-    private _deleted;
-    private _freshData;
-    private _lastFetch;
-    private _cacheTimeout;
-    /**
-     * Create a Notebook instance.
-     *
-     * @param data - Raw notebook data from API
-     * @param sdk - DatalayerSDK instance for making API calls
-     */
-    constructor(data: NotebookData, sdk: DatalayerSDK);
-    /**
-     * Check if this notebook has been deleted.
-     */
-    get isDeleted(): boolean;
-    /**
-     * Check if this notebook has been deleted and throw error if so.
-     * @throws Error if the notebook has been deleted
-     */
-    private _checkDeleted;
-    /**
-     * Get fresh data from API with caching to avoid redundant calls.
-     * @returns Current NotebookData from API or cache
-     */
-    private _getFreshData;
-    /**
-     * Notebook ID.
-     */
-    get id(): string;
-    /**
-     * Unique identifier for the notebook.
-     */
-    get uid(): string;
-    /**
-     * File path within the space.
-     */
-    get path(): string;
-    /**
-     * Parent space ID.
-     */
-    get spaceId(): string;
-    /**
-     * Owner user ID.
-     */
-    get ownerId(): string;
-    /**
-     * When the notebook was created.
-     */
-    get createdAt(): Date;
-    /**
-     * Version number.
-     */
-    get version(): number;
-    /**
-     * Notebook metadata.
-     */
-    get metadata(): Record<string, any>;
-    /**
-     * Get the current name of the notebook.
-     *
-     * This method fetches fresh data from the API (with caching) and updates
-     * the internal data to keep everything in sync.
-     *
-     * @returns Promise resolving to current notebook name
-     * @throws Error if the notebook has been deleted
-     */
-    getName(): Promise<string>;
-    /**
-     * Get the notebook content (cells, etc.).
-     *
-     * @returns Promise resolving to notebook content
-     */
-    getContent(): Promise<any>;
-    /**
-     * Get the kernel specification.
-     *
-     * @returns Promise resolving to kernel spec
-     */
-    getKernelSpec(): Promise<any>;
-    /**
-     * Get when the notebook was last updated.
-     *
-     * @returns Promise resolving to last update time
-     */
-    getUpdatedAt(): Promise<Date>;
-    /**
-     * Update the notebook name and/or description.
-     *
-     * @param data - Update data containing name and/or description
-     * @returns Promise resolving to updated Notebook instance
-     *
-     * @example
-     * ```typescript
-     * const updated = await notebook.update({
-     *   name: 'Advanced Analysis',
-     *   description: 'Updated analysis notebook'
-     * });
-     * ```
-     */
-    update(data: UpdateNotebookRequest): Promise<Notebook>;
-    /**
-     * Delete this notebook permanently.
-     *
-     * After deletion, this object will be marked as deleted and subsequent
-     * calls to dynamic methods will throw errors.
-     *
-     * @example
-     * ```typescript
-     * await notebook.delete();
-     * console.log('Notebook deleted');
-     * // notebook.getName() will now throw an error
-     * ```
-     */
-    delete(): Promise<void>;
-    /**
-     * Get raw notebook data object with latest information.
-     *
-     * This method ensures the returned data includes the most recent information
-     * by refreshing from the API before returning.
-     *
-     * @returns Promise resolving to raw notebook data
-     *
-     * @example
-     * ```typescript
-     * const latestData = await notebook.toJSON();
-     * console.log('Current name:', latestData.name);
-     * ```
-     */
-    toJSON(): Promise<NotebookData>;
-    /**
-     * String representation of the notebook.
-     *
-     * @returns String representation for logging/debugging
-     */
-    toString(): string;
-}
-export type { NotebookData };