@datalayer/core 1.0.25 → 1.1.43

package/lib/client/index.d.ts

@@ -17,41 +17,31 @@
 import { DatalayerClientBase, type DatalayerClientConfig, type ClientHandlers } from './base';
 import type { UserDTO } from './../models/UserDTO';
 import type { CreditsDTO } from '../models/CreditsDTO';
-import type { EnvironmentDTO } from '../models/EnvironmentDTO';
-import type { RuntimeDTO } from '../models/RuntimeDTO';
-import type { CodeSandboxSnapshotDTO } from '../models/CodeSandboxSnapshotDTO';
-import type { SpaceDTO } from '../models/SpaceDTO';
-import type { NotebookDTO } from '../models/NotebookDTO';
-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;
+declare const DatalayerCoreClientWithMixins: typeof DatalayerClientBase;
 /**
- * Main Datalayer Client providing unified access to all platform services.
- * Uses TypeScript mixins to provide a flat, discoverable API.
+ * Core Datalayer Client providing access to identity, plans and account
+ * services (IAM). Runtime and workspace/content features are provided by
+ * `AgentRuntimesClient` in `@datalayer/agent-runtimes`, which extends this
+ * class.
  *
  * @example
  * ```typescript
- * const client = new DatalayerClient({
+ * const client = new DatalayerCoreClient({
  *   token: 'your-token'
  * });
  *
  * const user = await client.whoami();
- * const runtime = await client.createRuntime({
- *   environment_name: 'ai-agents-env',
- *   credits_limit: 100
- * });
+ * const credits = await client.getCredits();
  * ```
  */
-export declare class DatalayerClient extends DatalayerClientWithMixins {
+export declare class DatalayerCoreClient extends DatalayerCoreClientWithMixins {
     /**
-     * Create a DatalayerClient instance.
+     * Create a DatalayerCoreClient instance.
      *
      * @param config - Client configuration options
      */
@@ -61,23 +51,8 @@ export type { DatalayerClientConfig, ClientHandlers };
 export { DatalayerClientBase };
 export { UserDTO as User } from './../models/UserDTO';
 export type { UserJSON, UserData } from './../models/UserDTO';
-export { RuntimeDTO as Runtime } from '../models/RuntimeDTO';
-export type { RuntimeJSON, RuntimeData, CreateRuntimeRequest, CreateRuntimeResponse, ListRuntimesResponse, } from '../models/RuntimeDTO';
-export { EnvironmentDTO as Environment } from '../models/EnvironmentDTO';
-export type { EnvironmentJSON, EnvironmentData, ListEnvironmentsResponse, } from '../models/EnvironmentDTO';
-export { CodeSandboxSnapshotDTO as Snapshot } from '../models/CodeSandboxSnapshotDTO';
-export type { CodeSandboxSnapshotJSON, CodeSandboxSnapshotData, CreateCodeSandboxSnapshotRequest, CreateCodeSandboxSnapshotResponse, GetCodeSandboxSnapshotResponse, ListCodeSandboxSnapshotsResponse, } from '../models/CodeSandboxSnapshotDTO';
-export { SpaceDTO as Space } 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';
-export type { LexicalJSON, LexicalData, CreateLexicalRequest, CreateLexicalResponse, GetLexicalResponse, UpdateLexicalRequest, UpdateLexicalResponse, } from '../models/LexicalDTO';
 export { CreditsDTO as Credits } from '../models/CreditsDTO';
 export type { CreditsInfo, CreditReservation, CreditsResponse, } from '../models/CreditsDTO';
-export { ItemDTO as Item } from '../models/ItemDTO';
 export { HealthCheck } from '../models/HealthCheck';
 export type { HealthCheckJSON } from '../models/HealthCheck';
 export { SecretDTO as Secret } from './../models/Secret';
@@ -88,62 +63,40 @@ export type { LoginRequest, LoginResponse, UserMeResponse, MembershipsResponse,
 export type { HealthzPingResponse } from '../models/Common';
 export { AuthenticationManager } from './auth/AuthenticationManager';
 export type { IUser, IBaseUser } from '../models/User';
-export type { ICell } from '../models/Cell';
 export type { IDatasource, IDatasourceVariant } from '../models/Datasource';
 export type { ICredits, ICreditsReservation } from '../models/Credits';
-export type { ISpaceItem } from '../models/SpaceItem';
 export type { ISurvey } from '../models/Survey';
-export type { ISpace, IBaseSpace, IAnySpace, ISpaceVariant, } from '../models/Space';
 export type { IBaseTeam, IAnyTeam } from '../models/Team';
 export type { IOrganization, IAnyOrganization, IBaseOrganization, } from '../models/Organization';
-export type { IRuntimeModel, IRuntimePod, IRuntimeType, IRuntimeLocation, IRuntimeCapabilities, } from '../models/Runtime';
-export type { ICodeSandboxSnapshot } from '../models/CodeSandboxSnapshot';
-export type { IDatalayerEnvironment, IResources, ISnippet, } from '../models/Environment';
 export type { IRole } from '../models/Role';
-export type { IAssignment } from '../models/Assignment';
 export type { IContact } from '../models/Contact';
-export type { ICourse } from '../models/Course';
 export type { IOrganizationMember } from '../models/OrganizationMember';
-export type { IPage, PageTheme, PageVariant } from '../models/Page';
-export type { PageTagName } from '../models/PageTag';
 export type { ISecret, ISecretVariant } from '../models/Secret';
 export type { IIAMToken, IIAMTokenVariant } from '../models/IAMToken';
-export type { IDocument, IBaseDocument } from '../models/Document';
-export type { IEnvironment } from '../models/Environment';
-export type { IExercise, ICode, IHelp } from '../models/Exercise';
 export type { IInvite } from '../models/Invite';
-export type { ILesson } from '../models/Lesson';
-export type { INotebook, IBaseNotebook } from '../models/Notebook';
 export type { ISchool } from '../models/School';
 export type { ITeam } from '../models/Team';
 export type { TeamMember } from '../models/TeamMember';
 export type { IUserOnboarding, IClient, IOnboardingPosition, IOnboardingTours, ITour, ITourStatus, } from '../models/UserOnboarding';
 export type { IUserSettings } from '../models/UserSettings';
-export type { IDataset } from '../models/Dataset';
 export type { IUsage } from '../models/Usage';
-export type { IItem } from '../models/Item';
-export type { IItemType } from '../models/ItemType';
 export type { Member } from '../models/Member';
 export type { Profile } from '../models/Profile';
-export type { SpaceMember } from '../models/SpaceMember';
 export type { IContactEvent } from '../models/ContactEvent';
 export type { IContactIAMProvider } from '../models/ContactIAMProvider';
-export type { IStudentItem } from '../models/StudentItem';
 export type { Instructor } from '../models/Instructor';
 export type { IStudent } from '../models/Student';
 export type { IDean } from '../models/Dean';
 export type { IUserEvent } from '../models/UserEvent';
 export type { IIAMProviderLinked } from '../models/IAMProviderLinked';
-export type { IContent } from '../models/Content';
 export type { AuthResult, TokenValidationResult, AuthOptions, TokenStorage, } from './auth/types';
-export type { IRuntimeOptions, IMultiServiceManager, IRemoteServicesManager, IEnvironmentsManager, IRemoteRuntimesManager, } from '../stateful/runtimes/apis';
 export type { IDatalayerCoreConfig, IRuntimesConfiguration, } from '../config/Configuration';
 export type { IIAMProviderName } from '../models/IAMProvidersSpecs';
 export type { NavigationLinkProps } from '../navigation/components';
 export { ItemTypes } from './constants';
 export type { ItemType } from './constants';
 export * from './auth';
-export interface DatalayerClient {
+export interface DatalayerCoreClient {
     getToken(): string | undefined;
     setToken(token: string): Promise<void>;
     whoami(): Promise<UserDTO>;
@@ -163,46 +116,5 @@ export interface DatalayerClient {
     getDatasource(datasourceId: string): Promise<DatasourceDTO>;
     updateDatasource(datasourceId: string, updates: UpdateDatasourceRequest): Promise<DatasourceDTO>;
     deleteDatasource(datasourceId: string): Promise<void>;
-    listEnvironments(): Promise<EnvironmentDTO[]>;
-    ensureRuntime(environmentName?: string, creditsLimit?: number, waitForReady?: boolean, maxWaitTime?: number, reuseExisting?: boolean, snapshotId?: string): Promise<RuntimeDTO>;
-    createRuntime(environmentName: string, type: 'notebook' | 'terminal' | 'job', givenName: string, minutesLimit: number, fromSnapshotId?: string): Promise<RuntimeDTO>;
-    listRuntimes(): Promise<RuntimeDTO[]>;
-    getRuntime(podName: string): Promise<RuntimeDTO>;
-    deleteRuntime(podName: string): Promise<void>;
-    terminateAllRuntimes(): Promise<PromiseSettledResult<void>[]>;
-    createSnapshot(podName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
-    listSnapshots(): Promise<CodeSandboxSnapshotDTO[]>;
-    getSnapshot(id: string): Promise<CodeSandboxSnapshotDTO>;
-    deleteSnapshot(id: string): Promise<void>;
-    checkRuntimesHealth(): Promise<HealthCheck>;
-    getMySpaces(): Promise<SpaceDTO[]>;
-    createSpace(name: string, description: string, variant: string, spaceHandle: string, organizationId: string, seedSpaceId: string, isPublic: boolean): Promise<SpaceDTO>;
-    createNotebook(spaceId: string, name: string, description: string, file?: File | Blob): Promise<NotebookDTO>;
-    getNotebook(id: string): Promise<NotebookDTO>;
-    updateNotebook(id: string, name?: string, description?: string): Promise<NotebookDTO>;
-    createLexical(spaceId: string, name: string, description: string, file?: File | Blob): Promise<LexicalDTO>;
-    getLexical(id: string): Promise<LexicalDTO>;
-    updateLexical(id: string, name?: string, description?: string): Promise<LexicalDTO>;
-    getSpaceItems(spaceId: string): Promise<(NotebookDTO | LexicalDTO)[]>;
-    getSpaceItem(itemId: string): Promise<NotebookDTO | LexicalDTO>;
-    deleteSpaceItem(itemId: string): Promise<void>;
-    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

@@ -20,8 +20,6 @@
  */
 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.
@@ -32,28 +30,29 @@ import { SpacerMixin } from './mixins/SpacerMixin.js';
 function composeMixins(...mixins) {
     return mixins.reduce((base, mixin) => mixin(base), DatalayerClientBase);
 }
-// Apply mixins to the base class using the helper
-const DatalayerClientWithMixins = composeMixins(IAMMixin, RuntimesMixin, SpacerMixin);
+// Apply the IAM mixin to the base class. Runtime and content (Spacer) features
+// live in @datalayer/agent-runtimes, which composes AgentRuntimesClient on top
+// of this core client.
+const DatalayerCoreClientWithMixins = composeMixins(IAMMixin);
 /**
- * Main Datalayer Client providing unified access to all platform services.
- * Uses TypeScript mixins to provide a flat, discoverable API.
+ * Core Datalayer Client providing access to identity, plans and account
+ * services (IAM). Runtime and workspace/content features are provided by
+ * `AgentRuntimesClient` in `@datalayer/agent-runtimes`, which extends this
+ * class.
  *
  * @example
  * ```typescript
- * const client = new DatalayerClient({
+ * const client = new DatalayerCoreClient({
  *   token: 'your-token'
  * });
  *
  * const user = await client.whoami();
- * const runtime = await client.createRuntime({
- *   environment_name: 'ai-agents-env',
- *   credits_limit: 100
- * });
+ * const credits = await client.getCredits();
  * ```
  */
-export class DatalayerClient extends DatalayerClientWithMixins {
+export class DatalayerCoreClient extends DatalayerCoreClientWithMixins {
     /**
-     * Create a DatalayerClient instance.
+     * Create a DatalayerCoreClient instance.
      *
      * @param config - Client configuration options
      */
@@ -66,15 +65,7 @@ export class DatalayerClient extends DatalayerClientWithMixins {
 export { DatalayerClientBase };
 // Export models for use by consumers
 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 { CodeSandboxSnapshotDTO as Snapshot } from '../models/CodeSandboxSnapshotDTO.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';

package/lib/client/mixins/IAMMixin.js

@@ -29,8 +29,8 @@ export function IAMMixin(Base) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const token = this.getToken();
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await profile.whoami(token, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await profile.whoami(token, iamUrl);
             // Handle the whoami response format
             let userData;
             if (!response) {
@@ -83,8 +83,8 @@ export function IAMMixin(Base) {
         /** Log out the current user. */
         async logout() {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            await authentication.logout(token, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            await authentication.logout(token, iamUrl);
             // Clear the token from the Client and cached user
             this.setToken('');
             this.currentUserCache = undefined;
@@ -95,8 +95,8 @@ export function IAMMixin(Base) {
          */
         async getCredits() {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await usage.getCredits(token, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await usage.getCredits(token, iamUrl);
             if (!response || !response.credits) {
                 throw new Error('Invalid response from credits API');
             }
@@ -191,8 +191,8 @@ export function IAMMixin(Base) {
          */
         async createSecret(data) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await secrets.createSecret(token, data, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await secrets.createSecret(token, data, iamUrl);
             return new SecretDTO(response.secret, this);
         }
         /**
@@ -201,8 +201,8 @@ export function IAMMixin(Base) {
          */
         async listSecrets() {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await secrets.listSecrets(token, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await secrets.listSecrets(token, iamUrl);
             return response.secrets.map(s => new SecretDTO(s, this));
         }
         /**
@@ -212,8 +212,8 @@ export function IAMMixin(Base) {
          */
         async getSecret(secretId) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await secrets.getSecret(token, secretId, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await secrets.getSecret(token, secretId, iamUrl);
             return new SecretDTO(response.secret, this);
         }
         /**
@@ -224,8 +224,8 @@ export function IAMMixin(Base) {
          */
         async updateSecret(secretId, updates) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await secrets.updateSecret(token, secretId, updates, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await secrets.updateSecret(token, secretId, updates, iamUrl);
             return new SecretDTO(response.secret, this);
         }
         /**
@@ -234,8 +234,8 @@ export function IAMMixin(Base) {
          */
         async deleteSecret(secretId) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            await secrets.deleteSecret(token, secretId, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            await secrets.deleteSecret(token, secretId, iamUrl);
         }
         // ========================================================================
         // Datasources Management
@@ -247,8 +247,8 @@ export function IAMMixin(Base) {
          */
         async createDatasource(data) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await datasources.createDatasource(token, data, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await datasources.createDatasource(token, data, iamUrl);
             return new DatasourceDTO(response.datasource, this);
         }
         /**
@@ -257,8 +257,8 @@ export function IAMMixin(Base) {
          */
         async listDatasources() {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await datasources.listDatasources(token, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await datasources.listDatasources(token, iamUrl);
             return response.datasources.map(d => new DatasourceDTO(d, this));
         }
         /**
@@ -268,8 +268,8 @@ export function IAMMixin(Base) {
          */
         async getDatasource(datasourceId) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await datasources.getDatasource(token, datasourceId, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await datasources.getDatasource(token, datasourceId, iamUrl);
             return new DatasourceDTO(response.datasource, this);
         }
         /**
@@ -280,8 +280,8 @@ export function IAMMixin(Base) {
          */
         async updateDatasource(datasourceId, updates) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await datasources.updateDatasource(token, datasourceId, updates, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await datasources.updateDatasource(token, datasourceId, updates, iamUrl);
             return new DatasourceDTO(response.datasource, this);
         }
         /**
@@ -290,8 +290,8 @@ export function IAMMixin(Base) {
          */
         async deleteDatasource(datasourceId) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            await datasources.deleteDatasource(token, datasourceId, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            await datasources.deleteDatasource(token, datasourceId, iamUrl);
         }
     };
 }

package/lib/components/auth/Login.js

@@ -22,7 +22,7 @@ export const Login = (props) => {
     const loginMutation = useLogin();
     const getOAuth2URLMutation = useOAuth2AuthorizationURL();
     const { loginAndNavigate, setLogin } = useIAM();
-    const { externalToken, iamProvidersAuthorizationURL, addIAMProviderAuthorizationURL, iamRunUrl, logout, checkIAMToken, } = useIAMStore();
+    const { externalToken, iamProvidersAuthorizationURL, addIAMProviderAuthorizationURL, iamUrl, logout, checkIAMToken, } = useIAMStore();
     const { enqueueToast } = useToast();
     const navigate = useNavigate();
     const [loading, setLoading] = useState(false);
@@ -76,7 +76,7 @@ export const Login = (props) => {
         if (!iamProvidersAuthorizationURL[IAMProvidersSpecs.LinkedIn.name]) {
             initIAMProvider(IAMProvidersSpecs.LinkedIn);
         }
-    }, [iamRunUrl, iamProvidersAuthorizationURL, addIAMProviderAuthorizationURL]);
+    }, [iamUrl, iamProvidersAuthorizationURL, addIAMProviderAuthorizationURL]);
     useEffect(() => {
         if (externalToken) {
             setLoadingWithToken(1);

package/lib/components/avatars/UserAvatar.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns `true` when the given URL points to a real user avatar (i.e. not a
+ * Gravatar default placeholder).
+ */
+export declare function hasRealAvatar(url?: string): boolean;
+export type UserAvatarProps = {
+    avatarUrl?: string;
+    /** Avatar edge length in pixels. Defaults to 100. */
+    size?: number;
+    /** Render with rounded square corners instead of a circle. Defaults to true. */
+    square?: boolean;
+    /** Fallback icon size. Defaults to ~48% of `size`. */
+    iconSize?: number;
+};
+export declare const UserAvatar: ({ avatarUrl, size, square, iconSize, }: UserAvatarProps) => JSX.Element;
+export default UserAvatar;

package/lib/components/avatars/UserAvatar.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * UserAvatar – Single source of truth for rendering a user's avatar.
+ *
+ * When a real (non-Gravatar) avatar URL is available it renders a
+ * {@link DLAvatar}. Otherwise it falls back to a themed, colormoded
+ * {@link AlienIcon} placeholder so every consumer (profile, sidebar,
+ * principal overlay, …) shares the same default look.
+ */
+import { AlienIcon } from '@datalayer/icons-react';
+import { Box, useColorPalette } from '@datalayer/primer-addons';
+import { DLAvatar } from './DLAvatar.js';
+/**
+ * Returns `true` when the given URL points to a real user avatar (i.e. not a
+ * Gravatar default placeholder).
+ */
+export function hasRealAvatar(url) {
+    if (!url) {
+        return false;
+    }
+    if (url.startsWith('https://www.gravatar.com/avatar')) {
+        return false;
+    }
+    return true;
+}
+export const UserAvatar = ({ avatarUrl, size = 100, square = true, iconSize, }) => {
+    const palette = useColorPalette();
+    if (hasRealAvatar(avatarUrl)) {
+        return _jsx(DLAvatar, { square: square, src: avatarUrl, size: size });
+    }
+    const resolvedIconSize = iconSize ?? Math.round(size * 0.48);
+    return (_jsx(Box, { sx: {
+            width: size,
+            height: size,
+            borderRadius: square ? 2 : '50%',
+            bg: 'accent.subtle',
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            '--datalayer-icon-fg': palette.primary,
+        }, children: _jsx(AlienIcon, { size: resolvedIconSize, themed: true, colormoded: true }) }));
+};
+export default UserAvatar;

package/lib/components/avatars/index.d.ts

@@ -1,3 +1,4 @@
 export * from './BoringAvatar';
 export * from './DLAvatar';
+export * from './UserAvatar';
 export * from './UserProfileAvatar';

package/lib/components/avatars/index.js

@@ -4,4 +4,5 @@
  */
 export * from './BoringAvatar.js';
 export * from './DLAvatar.js';
+export * from './UserAvatar.js';
 export * from './UserProfileAvatar.js';

package/lib/components/billing/BillableAccountSelect.js

@@ -1,4 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
 /*
  * Copyright (c) 2023-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.

package/lib/components/billing/index.js

@@ -1,3 +1,7 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
 /*
  * Copyright (c) 2023-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.

package/lib/components/context/index.d.ts

@@ -1,2 +1 @@
 export * from './OrganizationSelect';
-export * from './SpaceSelect';

package/lib/components/context/index.js

@@ -3,4 +3,3 @@
  * Distributed under the terms of the Modified BSD License.
  */
 export * from './OrganizationSelect.js';
-export * from './SpaceSelect.js';

package/lib/components/display/DisplayHandle.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+export type DisplayHandleProps = {
+    handle?: string;
+    withAt?: boolean;
+    fallback?: string;
+};
+export declare const displayHandleText: (handle?: string, options?: {
+    withAt?: boolean;
+    fallback?: string;
+}) => string;
+export declare const DisplayHandle: React.FC<DisplayHandleProps>;
+export default DisplayHandle;

package/lib/components/display/DisplayHandle.js

@@ -0,0 +1,11 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { formatFriendlyHandle } from '../../utils/Handles.js';
+export const displayHandleText = (handle, options) => {
+    const withAt = options?.withAt ?? true;
+    const fallback = options?.fallback ?? 'unknown';
+    const friendly = formatFriendlyHandle(handle);
+    const normalized = String(friendly || '').trim() || fallback;
+    return withAt ? `@${normalized}` : normalized;
+};
+export const DisplayHandle = ({ handle, withAt = true, fallback = 'unknown', }) => _jsx(_Fragment, { children: displayHandleText(handle, { withAt, fallback }) });
+export default DisplayHandle;

package/lib/components/display/LiveRelativeTime.js

@@ -1,3 +1,7 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
 /*
  * Copyright (c) 2023-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.

package/lib/components/display/index.d.ts

@@ -2,6 +2,7 @@ export * from './AvatarSkeleton';
 export * from './CenteredSpinner';
 export * from './CodePreview';
 export * from './DatalayerBox';
+export * from './DisplayHandle';
 export * from './HorizontalCenter';
 export * from './JupyterDialog';
 export * from './LiveRelativeTime';

package/lib/components/display/index.js

@@ -6,6 +6,7 @@ export * from './AvatarSkeleton.js';
 export * from './CenteredSpinner.js';
 export * from './CodePreview.js';
 export * from './DatalayerBox.js';
+export * from './DisplayHandle.js';
 export * from './HorizontalCenter.js';
 export * from './JupyterDialog.js';
 export * from './LiveRelativeTime.js';

package/lib/components/flashes/index.d.ts

@@ -1,6 +1,5 @@
 export * from './surveys';
 export * from './FlashClosable';
-export * from './FlashDisclaimer';
 export * from './FlashGuest';
 export * from './FlashSurveys';
 export * from './FlashUnauthorized';

package/lib/components/flashes/index.js

@@ -4,7 +4,6 @@
  */
 export * from './surveys/index.js';
 export * from './FlashClosable.js';
-export * from './FlashDisclaimer.js';
 export * from './FlashGuest.js';
 export * from './FlashSurveys.js';
 export * from './FlashUnauthorized.js';

package/lib/components/index.d.ts

@@ -1,6 +1,5 @@
 export * from './auth';
 export * from './billing';
-export * from './scheduler';
 export * from './sharing';
 export * from './sparklines';
 export * from './time';

package/lib/components/index.js

@@ -4,7 +4,6 @@
  */
 export * from './auth/index.js';
 export * from './billing/index.js';
-export * from './scheduler/index.js';
 export * from './sharing/index.js';
 export * from './sparklines/index.js';
 export * from './time/index.js';

package/lib/components/principal/Principal.d.ts

@@ -17,6 +17,8 @@ export type PrincipalDescriptor = {
     kind: PrincipalKind;
     uid?: string;
     displayName: string;
+    name?: string;
+    description?: string;
     handle?: string;
     accountHandle?: string;
     firstName?: string;
@@ -31,6 +33,11 @@ export type PrincipalProps = {
     avatarSize?: number;
     gap?: number;
     square?: boolean;
+    /**
+     * Maximum length of the placeholder (handle or uid) shown before the real
+     * display name resolves. Defaults to {@link DEFAULT_PLACEHOLDER_MAX_LENGTH}.
+     */
+    placeholderMaxLength?: number;
     sx?: any;
 };
 export declare const Principal: React.FC<PrincipalProps>;