@datalayer/core 0.0.26 → 1.0.1

package/lib/models/IAMProvidersSpecs.js

@@ -12,6 +12,9 @@ export class IAMProvidersSpecs {
             case 'github': {
                 return this.GitHub;
             }
+            case 'google': {
+                return this.Google;
+            }
             case 'linkedin': {
                 return this.LinkedIn;
             }
@@ -46,6 +49,17 @@ export class IAMProvidersSpecs {
         postShareURL: '',
         registerUploadURL: '',
     };
+    static Google = {
+        name: 'google',
+        oauth2CallbackServerRoute: 'jupyter_iam/oauth2/callback',
+        oauth2CallbackUIRoute: '/iam/oauth2/google/callback',
+        accessTokenCookieName: (user) => `__datalayer__google_access_token_${user.id}`,
+        refreshTokenCookieName: '__datalayer__google_refresh_token',
+        userInfoURL: 'https://openidconnect.googleapis.com/v1/userinfo',
+        tokenRefreshURL: 'https://oauth2.googleapis.com/token',
+        postShareURL: '',
+        registerUploadURL: '',
+    };
     static LinkedIn = {
         name: 'linkedin',
         oauth2CallbackServerRoute: 'jupyter_iam/oauth2/callback',

package/lib/models/ItemDTO.d.ts

@@ -13,14 +13,14 @@ import type { DatalayerClient } from '../index';
  */
 export declare abstract class ItemDTO<TData> {
     protected _data: TData;
-    private _sdk;
+    private _client;
     private _deleted;
     /**
      * Create an Item instance.
      * @param data - Item data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: TData, sdk: DatalayerClient);
+    constructor(data: TData, client: DatalayerClient);
     /** Check if this item has been deleted. */
     get isDeleted(): boolean;
     /**

package/lib/models/ItemDTO.js

@@ -12,16 +12,16 @@ import * as items from '../api/spacer/items';
  */
 export class ItemDTO {
     _data;
-    _sdk;
+    _client;
     _deleted = false;
     /**
      * Create an Item instance.
      * @param data - Item data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
-        this._sdk = sdk;
+        this._client = client;
     }
     // ========================================================================
     // Deletion State Management
@@ -105,8 +105,8 @@ export class ItemDTO {
      */
     async delete() {
         this._checkDeleted();
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
+        const token = this._client.getToken();
+        const spacerRunUrl = this._client.getSpacerRunUrl();
         await items.deleteItem(token, this.uid, spacerRunUrl);
         this._deleted = true;
     }
@@ -137,8 +137,8 @@ export class ItemDTO {
         }
         // Third try: Fetch full item details from API
         try {
-            const token = this._sdk.getToken();
-            const spacerRunUrl = this._sdk.getSpacerRunUrl();
+            const token = this._client.getToken();
+            const spacerRunUrl = this._client.getSpacerRunUrl();
             const response = await items.getItem(token, this.uid, spacerRunUrl);
             // Update internal data with full item details
             if (response.success && response.item) {
@@ -173,11 +173,11 @@ export class ItemDTO {
     // ========================================================================
     /** Get Client token for API calls. */
     _getToken() {
-        return this._sdk.getToken();
+        return this._client.getToken();
     }
     /** Get spacer API URL for API calls. */
     _getSpacerRunUrl() {
-        return this._sdk.getSpacerRunUrl();
+        return this._client.getSpacerRunUrl();
     }
     /** Update internal data after API call. */
     _updateData(newData) {

package/lib/models/LexicalDTO.d.ts

@@ -109,7 +109,7 @@ export interface LexicalJSON {
  *
  * @example
  * ```typescript
- * const lexical = await sdk.createLexical(formData);
+ * const lexical = await client.createLexical(formData);
  * await lexical.update({ name: 'Updated Documentation' });
  * ```
  */
@@ -118,9 +118,9 @@ export declare class LexicalDTO extends ItemDTO<LexicalData> {
      * Create a Lexical instance.
      *
      * @param data - Lexical data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: LexicalData, sdk: DatalayerClient);
+    constructor(data: LexicalData, client: DatalayerClient);
     /** Document type identifier. */
     get type(): string;
     /** The cached name of the document. */

package/lib/models/LexicalDTO.js

@@ -17,7 +17,7 @@ import { validateJSON } from '../api/utils/validation';
  *
  * @example
  * ```typescript
- * const lexical = await sdk.createLexical(formData);
+ * const lexical = await client.createLexical(formData);
  * await lexical.update({ name: 'Updated Documentation' });
  * ```
  */
@@ -26,10 +26,10 @@ export class LexicalDTO extends ItemDTO {
      * Create a Lexical instance.
      *
      * @param data - Lexical data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
-        super(data, sdk);
+    constructor(data, client) {
+        super(data, client);
     }
     // ========================================================================
     // Abstract Method Implementations

package/lib/models/NotebookDTO.d.ts

@@ -42,7 +42,7 @@ export interface NotebookJSON {
  *
  * @example
  * ```typescript
- * const notebook = await sdk.createNotebook(formData);
+ * const notebook = await client.createNotebook(formData);
  * const kernelSpec = await notebook.getKernelSpec();
  * ```
  */
@@ -51,9 +51,9 @@ export declare class NotebookDTO extends ItemDTO<NotebookData> {
      * Create a Notebook instance.
      *
      * @param data - Notebook data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: NotebookData, sdk: DatalayerClient);
+    constructor(data: NotebookData, client: DatalayerClient);
     /** Document type identifier. */
     get type(): string;
     /** The cached name of the notebook. */

package/lib/models/NotebookDTO.js

@@ -12,7 +12,7 @@ import { validateJSON } from '../api/utils/validation';
  *
  * @example
  * ```typescript
- * const notebook = await sdk.createNotebook(formData);
+ * const notebook = await client.createNotebook(formData);
  * const kernelSpec = await notebook.getKernelSpec();
  * ```
  */
@@ -21,10 +21,10 @@ export class NotebookDTO extends ItemDTO {
      * Create a Notebook instance.
      *
      * @param data - Notebook data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
-        super(data, sdk);
+    constructor(data, client) {
+        super(data, client);
     }
     // ========================================================================
     // Abstract Method Implementations
@@ -74,8 +74,8 @@ export class NotebookDTO extends ItemDTO {
     async update(name, description) {
         // FIXME: check if both are needed, and use the existing values if only one provided
         this._checkDeleted();
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
+        const token = this._client.getToken();
+        const spacerRunUrl = this._client.getSpacerRunUrl();
         const updateData = {};
         if (name !== undefined)
             updateData.name = name;

package/lib/models/Page.js

@@ -13,7 +13,7 @@ export const asPage = (s) => {
         description: s.description_t,
         theme: s.theme_s,
         nbformat: s.nbformat_s ? JSON.parse(s.nbformat_s) : undefined,
-        screenCapture: s.screen_capture_s,
+        screenCapture: s.screen_capture_cdn_url_s || s.screen_capture_s,
         tags: s.tags_ss ?? [],
         creator: s.creator ? asUser(s.creator) : undefined,
         creatorId: s.creator_uid,

package/lib/models/PageTag.d.ts

@@ -4,7 +4,7 @@ type CardIconColorsType = (typeof CardIconColors)[number];
 export type PageTagMetadata = {
     fillColor: React.CSSProperties['backgroundColor'];
 };
-export type PageTagName = 'ai' | 'deep-learning' | 'example' | 'llm' | 'python' | 'pytorch' | 'spatial' | 'tutorial';
+export type PageTagName = 'agent' | 'ai' | 'ai-agent' | 'deep-learning' | 'example' | 'llm' | 'notebook' | 'python' | 'pytorch' | 'spatial' | 'tutorial';
 export type PageTag = {
     id: string;
     text?: PageTagName;

package/lib/models/PageTag.js

@@ -9,12 +9,24 @@ export const PAGE_TAGE_NONE = {
     Icon: CopilotIcon,
     color: 'pink',
 };
+const PAGE_TAGE_AGENT = {
+    id: '9',
+    text: 'agent',
+    Icon: CopilotIcon,
+    color: 'teal',
+};
 const PAGE_TAGE_AI = {
     id: '1',
     text: 'ai',
     Icon: CopilotIcon,
     color: 'pink',
 };
+const PAGE_TAGE_AI_AGENT = {
+    id: '10',
+    text: 'ai-agent',
+    Icon: CopilotIcon,
+    color: 'purple',
+};
 const PAGE_TAGE_DEEP_LEARNING = {
     id: '2',
     text: 'deep-learning',
@@ -33,6 +45,12 @@ const PAGE_TAGE_LLM = {
     Icon: CopilotIcon,
     color: 'coral',
 };
+const PAGE_TAGE_NOTEBOOK = {
+    id: '11',
+    text: 'notebook',
+    Icon: CopilotIcon,
+    color: 'blue',
+};
 const PAGE_TAGE_PYTHON = {
     id: '5',
     text: 'python',
@@ -60,10 +78,13 @@ const PAGE_TAGE_TUTORIAL = {
     metadata: { fillColor: 'yellow' },
 };
 export const PAGE_TAGS = [
+    PAGE_TAGE_AGENT,
     PAGE_TAGE_AI,
+    PAGE_TAGE_AI_AGENT,
     PAGE_TAGE_DEEP_LEARNING,
     PAGE_TAGE_EXAMPLE,
     PAGE_TAGE_LLM,
+    PAGE_TAGE_NOTEBOOK,
     PAGE_TAGE_PYTHON,
     PAGE_TAGE_PYTORCH,
     PAGE_TAGE_SPATIAL,

package/lib/models/RuntimeDTO.d.ts

@@ -105,22 +105,22 @@ export interface ListRuntimesResponse {
  *
  * @example
  * ```typescript
- * const runtime = await sdk.createRuntime({ environment_name: 'python-cpu' });
+ * const runtime = await client.createRuntime({ environment_name: 'python-cpu' });
  * await runtime.waitUntilReady();
  * ```
  */
 export declare class RuntimeDTO {
     /** @internal */
     _data: RuntimeData;
-    private _sdk;
+    private _client;
     private _deleted;
     /**
      * Create a Runtime instance.
      *
      * @param data - Runtime data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: RuntimeData, sdk: DatalayerClient);
+    constructor(data: RuntimeData, client: DatalayerClient);
     /**
      * Check if this runtime has been deleted and throw error if so.
      * @throws Error if deleted

package/lib/models/RuntimeDTO.js

@@ -15,24 +15,24 @@ import { validateJSON } from '../api/utils/validation';
  *
  * @example
  * ```typescript
- * const runtime = await sdk.createRuntime({ environment_name: 'python-cpu' });
+ * const runtime = await client.createRuntime({ environment_name: 'python-cpu' });
  * await runtime.waitUntilReady();
  * ```
  */
 export class RuntimeDTO {
     /** @internal */
     _data;
-    _sdk;
+    _client;
     _deleted = false;
     /**
      * Create a Runtime instance.
      *
      * @param data - Runtime data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
-        this._sdk = sdk;
+        this._client = client;
     }
     // ========================================================================
     // Helper Methods
@@ -112,7 +112,7 @@ export class RuntimeDTO {
      * After deletion, subsequent calls to dynamic methods will throw errors.
      */
     async delete() {
-        await this._sdk.deleteRuntime(this.podName);
+        await this._client.deleteRuntime(this.podName);
         this._deleted = true;
     }
     /**
@@ -123,8 +123,8 @@ export class RuntimeDTO {
      */
     async update(from) {
         this._checkDeleted();
-        const updated = await updateRuntime(this._sdk.getToken(), this.podName, from, this._sdk.getRuntimesRunUrl());
-        return new RuntimeDTO(updated, this._sdk);
+        const updated = await updateRuntime(this._client.getToken(), this.podName, from, this._client.getRuntimesRunUrl());
+        return new RuntimeDTO(updated, this._client);
     }
     /**
      * Create a snapshot of this runtime.
@@ -136,7 +136,7 @@ export class RuntimeDTO {
      */
     async createSnapshot(name, description, stop) {
         this._checkDeleted();
-        return await this._sdk.createSnapshot(this.podName, name, description, stop);
+        return await this._client.createSnapshot(this.podName, name, description, stop);
     }
     // ========================================================================
     // Utility Methods

package/lib/models/RuntimeSnapshotDTO.d.ts

@@ -116,15 +116,15 @@ export interface ListRuntimeSnapshotsResponse {
  */
 export declare class RuntimeSnapshotDTO {
     protected _data: RuntimeSnapshotData;
-    private _sdk;
+    private _client;
     private _deleted;
     /**
      * Create a Runtime Snapshot instance.
      *
      * @param data - Snapshot data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: RuntimeSnapshotData, sdk: DatalayerClient);
+    constructor(data: RuntimeSnapshotData, client: DatalayerClient);
     /**
      * Check if this snapshot has been deleted and throw error if so.
      * @throws Error if deleted

package/lib/models/RuntimeSnapshotDTO.js

@@ -16,17 +16,17 @@ import { validateJSON } from '../api/utils/validation';
  */
 export class RuntimeSnapshotDTO {
     _data;
-    _sdk;
+    _client;
     _deleted = false;
     /**
      * Create a Runtime Snapshot instance.
      *
      * @param data - Snapshot data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
-        this._sdk = sdk;
+        this._client = client;
     }
     // ========================================================================
     // Helper Methods
@@ -77,8 +77,8 @@ export class RuntimeSnapshotDTO {
      */
     async delete() {
         this._checkDeleted();
-        const token = this._sdk.getToken();
-        const runtimesRunUrl = this._sdk.getRuntimesRunUrl();
+        const token = this._client.getToken();
+        const runtimesRunUrl = this._client.getRuntimesRunUrl();
         await snapshots.deleteSnapshot(token, this.uid, runtimesRunUrl);
         this._deleted = true;
     }
@@ -90,7 +90,7 @@ export class RuntimeSnapshotDTO {
      */
     async restore(minutesLimit) {
         this._checkDeleted();
-        return await this._sdk.createRuntime({
+        return await this._client.createRuntime({
             environmentName: this.environment,
             type: 'notebook',
             givenName: `Restored from ${this.name}`,

package/lib/models/Secret.d.ts

@@ -116,7 +116,7 @@ export interface DeleteSecretResponse {
  *
  * @example
  * ```typescript
- * const secret = await sdk.createSecret({
+ * const secret = await client.createSecret({
  *   variant: 'password',
  *   name: 'db_password',
  *   description: 'Production DB password',
@@ -131,14 +131,14 @@ export interface DeleteSecretResponse {
 export declare class SecretDTO {
     /** @internal */
     _data: SecretData;
-    private _sdk;
+    private _client;
     private _deleted;
     /**
      * Create a Secret instance.
      * @param data - Secret data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: SecretData, sdk: DatalayerClient);
+    constructor(data: SecretData, client: DatalayerClient);
     private _checkDeleted;
     private _decodeValue;
     get uid(): string;

package/lib/models/Secret.js

@@ -21,7 +21,7 @@ import { validateJSON } from '../api/utils/validation';
  *
  * @example
  * ```typescript
- * const secret = await sdk.createSecret({
+ * const secret = await client.createSecret({
  *   variant: 'password',
  *   name: 'db_password',
  *   description: 'Production DB password',
@@ -36,16 +36,16 @@ import { validateJSON } from '../api/utils/validation';
 export class SecretDTO {
     /** @internal */
     _data;
-    _sdk;
+    _client;
     _deleted = false;
     /**
      * Create a Secret instance.
      * @param data - Secret data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
-        this._sdk = sdk;
+        this._client = client;
     }
     // ========================================================================
     // Helper Methods
@@ -105,7 +105,7 @@ export class SecretDTO {
      */
     async update(updates) {
         this._checkDeleted();
-        const updated = await this._sdk.updateSecret(this.uid, updates);
+        const updated = await this._client.updateSecret(this.uid, updates);
         return updated;
     }
     /**
@@ -113,7 +113,7 @@ export class SecretDTO {
      */
     async delete() {
         this._checkDeleted();
-        await this._sdk.deleteSecret(this.uid);
+        await this._client.deleteSecret(this.uid);
         this._deleted = true;
     }
     // ========================================================================

package/lib/models/Space.js

@@ -34,6 +34,9 @@ export const asSpace = (raw_space) => {
         organization: {
             handle: raw_space.handle_s,
         },
+        // Preserve raw Solr fields so consumers can access dynamic fields
+        // (e.g. attached_agent_pod_name_s for project-agent assignment)
+        ...raw_space,
     };
     return space;
 };

package/lib/models/SpaceDTO.d.ts

@@ -48,16 +48,16 @@ export interface SpaceJSON {
  */
 export declare class SpaceDTO {
     protected _data: SpaceData;
-    private _sdk;
+    private _client;
     private _items;
     private _deleted;
     /**
      * Create a Space instance.
      *
      * @param data - Space data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: SpaceData, sdk: DatalayerClient);
+    constructor(data: SpaceData, client: DatalayerClient);
     /**
      * Check if this space has been deleted and throw error if so.
      * @throws Error if deleted

package/lib/models/SpaceDTO.js

@@ -29,18 +29,18 @@ import { validateJSON } from '../api/utils/validation';
  */
 export class SpaceDTO {
     _data;
-    _sdk;
+    _client;
     _items = null;
     _deleted = false;
     /**
      * Create a Space instance.
      *
      * @param data - Space data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
-        this._sdk = sdk;
+        this._client = client;
     }
     // ========================================================================
     // Helper Methods
@@ -58,8 +58,8 @@ export class SpaceDTO {
      * Refresh space data from the API by fetching user's spaces.
      */
     async refresh() {
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
+        const token = this._client.getToken();
+        const spacerRunUrl = this._client.getSpacerRunUrl();
         const response = await users.getMySpaces(token, spacerRunUrl);
         const freshSpace = response.spaces.find(s => s.uid === this.uid);
         if (freshSpace) {
@@ -110,8 +110,8 @@ export class SpaceDTO {
     async _createItem(data) {
         this._checkDeleted();
         // Get necessary configuration from Client
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
+        const token = this._client.getToken();
+        const spacerRunUrl = this._client.getSpacerRunUrl();
         if (data.type === ItemTypes.NOTEBOOK) {
             const requestData = {
                 spaceId: this.uid,
@@ -125,7 +125,7 @@ export class SpaceDTO {
                 throw new Error('Failed to create notebook: No notebook returned');
             }
             else {
-                return new NotebookDTO(response.notebook, this._sdk);
+                return new NotebookDTO(response.notebook, this._client);
             }
         }
         else if (data.type === ItemTypes.LEXICAL) {
@@ -141,7 +141,7 @@ export class SpaceDTO {
                 throw new Error('Failed to create lexical document: No document returned');
             }
             else {
-                return new LexicalDTO(response.document, this._sdk);
+                return new LexicalDTO(response.document, this._client);
             }
         }
         else {
@@ -155,11 +155,11 @@ export class SpaceDTO {
      */
     async getItems() {
         this._checkDeleted();
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
+        const token = this._client.getToken();
+        const spacerRunUrl = this._client.getSpacerRunUrl();
         const response = await items.getSpaceItems(token, this.uid, spacerRunUrl);
         // Use shared utility function to convert items to model instances
-        this._items = convertSpaceItemsToModels(response.items || [], this._sdk);
+        this._items = convertSpaceItemsToModels(response.items || [], this._client);
         return this._items;
     }
     /**
@@ -215,7 +215,7 @@ export class SpaceDTO {
             variant: this.variant,
             handle: this.handle,
             items: this._data.items
-                ? convertSpaceItemsToModels(this._data.items, this._sdk).map(item => item.toJSON())
+                ? convertSpaceItemsToModels(this._data.items, this._client).map(item => item.toJSON())
                 : [],
         };
         validateJSON(obj, 'Space');

package/lib/models/UserDTO.d.ts

@@ -54,9 +54,9 @@ export declare class UserDTO {
      * Create a User instance.
      *
      * @param data - User data from API
-     * @param sdk - Client instance (currently unused but kept for compatibility)
+     * @param client - Client instance (currently unused but kept for compatibility)
      */
-    constructor(data: UserData, sdk?: DatalayerClient);
+    constructor(data: UserData, client?: DatalayerClient);
     get id(): string;
     get uid(): string;
     get email(): string;

package/lib/models/UserDTO.js

@@ -13,9 +13,9 @@ export class UserDTO {
      * Create a User instance.
      *
      * @param data - User data from API
-     * @param sdk - Client instance (currently unused but kept for compatibility)
+     * @param client - Client instance (currently unused but kept for compatibility)
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
     }
     // Basic properties