@datalayer/core 1.1.66 → 1.2.10

package/lib/hooks/cacheConverters.js

@@ -30,31 +30,6 @@ export function asCodeSandboxSnapshot(s) {
         formatVersion: format_version,
     };
 }
-/**
- * Convert a raw page payload into its client shape.
- *
- * @param s - The raw page payload from the API.
- * @returns The converted page object.
- */
-export const asPage = (s) => {
-    return {
-        id: s.uid,
-        type: 'page',
-        variant: s.variant_s,
-        name: s.name_t,
-        description: s.description_t,
-        theme: s.theme_s,
-        nbformat: s.nbformat_s ? JSON.parse(s.nbformat_s) : undefined,
-        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,
-        kernelSnapshot: s.kernel_snapshot
-            ? asCodeSandboxSnapshot(s.kernel_snapshot)
-            : undefined,
-        kernelSnapshotId: s.kernel_snapshot_uid,
-    };
-};
 /**
  * Convert a raw space payload into its client shape.
  *

package/lib/hooks/index.d.ts

@@ -31,6 +31,7 @@ export * from './useMobile';
 export * from './useUsageRefreshStore';
 export * from './usePrincipalStore';
 export * from './usePrincipalCacheStore';
+export * from './useSpaceCacheStore';
 export * from './useBillingEntityStore';
 export * from './useSelectedPrincipal';
 export * from './useSelectedBillingEntity';

package/lib/hooks/index.js

@@ -36,6 +36,7 @@ export * from './useMobile.js';
 export * from './useUsageRefreshStore.js';
 export * from './usePrincipalStore.js';
 export * from './usePrincipalCacheStore.js';
+export * from './useSpaceCacheStore.js';
 export * from './useBillingEntityStore.js';
 export * from './useSelectedPrincipal.js';
 export * from './useSelectedBillingEntity.js';

package/lib/hooks/useBillingEntityStore.js

@@ -5,6 +5,7 @@
 import { create } from 'zustand';
 import { createJSONStorage, persist } from 'zustand/middleware';
 import { useUsageRefreshStore } from './useUsageRefreshStore.js';
+import { registerSessionState } from '../state/sessionEnd.js';
 export const useBillingEntityStore = create()(persist(set => ({
     billingEntityKind: 'user',
     billingEntityUid: undefined,
@@ -51,3 +52,5 @@ export const useBillingEntityStore = create()(persist(set => ({
     }),
 }));
 export default useBillingEntityStore;
+// The billing entity is the signed-in person's: forgotten when the session ends.
+registerSessionState({ forget: () => useBillingEntityStore.getState().resetBillingEntity() });

package/lib/hooks/useCache.d.ts

@@ -32,7 +32,7 @@
  * }
  * ```
  */
-import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { QueryClient, UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
 import { IAnyOrganization, IContact, IIAMToken, IOrganization, ISchool, ISecret, IStudent, ITeam, IUser, IUserOnboarding, IUserSettings } from '../models';
 type IAnySpace = any;
 export type CacheProps = {
@@ -44,6 +44,25 @@ export type ISearchOpts = {
     max: number;
     public: boolean;
 };
+/**
+ * Forget everything a session was told, without orphaning what is on screen.
+ *
+ * `queryClient.clear()` is the obvious way to end a session and the wrong
+ * one. It destroys the query objects themselves, and an observer whose query
+ * is destroyed while its fetch is in flight is never answered and never asks
+ * again: it sits at `isLoading` for as long as the page stays open.
+ *
+ * Signing out is exactly that race. Ending the session swaps the whole tree
+ * for the anonymous one, which mounts the home page and starts fetching the
+ * featured ribbon; the logout response then lands on top of that fetch. The
+ * ribbon stayed a row of empty placeholders until the reader reloaded.
+ *
+ * So: drop what nobody is looking at, and reset what is on screen. A reset
+ * forgets the answer the person who has left was given and asks the question
+ * again as whoever is here now, which is what signing out means for a page
+ * that is still open.
+ */
+export declare const forgetSession: (client: QueryClient) => void;
 /**
  * Centralized query key factories for all entities
  * Following TanStack Query best practices for key structure
@@ -174,6 +193,9 @@ export declare const queryKeys: {
         readonly serviceAgents: (orgUid: string) => readonly ["mcp", "service-agents", string];
         readonly policyLayer: (scope: string, subjectUid: string) => readonly ["mcp", "policy-layer", string, string];
         readonly alertRules: (orgUid: string) => readonly ["mcp", "alert-rules", string];
+        readonly identityProviders: (orgUid: string) => readonly ["mcp", "identity-providers", string];
+        readonly scimTokens: (orgUid: string) => readonly ["mcp", "scim-tokens", string];
+        readonly admittedClients: (scope: string, subjectUid: string) => readonly ["mcp", "admitted-clients", string, string];
         readonly forwarding: (orgUid: string) => readonly ["mcp", "audit-forwarding", string];
         readonly auditSettings: (orgUid: string) => readonly ["mcp", "audit-settings", string];
         readonly organizationTeams: (orgUid: string) => readonly ["mcp", "organization-teams", string];
@@ -253,6 +275,13 @@ export declare const queryKeys: {
         readonly bySpace: (spaceId: string) => readonly ["documents", "space", string];
         readonly model: (documentId: string) => readonly ["documents", "detail", string, "model"];
     };
+    readonly decks: {
+        readonly all: () => readonly ["decks"];
+        readonly details: () => readonly ["decks", "detail"];
+        readonly detail: (id: string) => readonly ["decks", "detail", string];
+        readonly bySpace: (spaceId: string) => readonly ["decks", "space", string];
+        readonly model: (deckId: string) => readonly ["decks", "detail", string, "model"];
+    };
     readonly cells: {
         readonly all: () => readonly ["cells"];
         readonly details: () => readonly ["cells", "detail"];
@@ -285,11 +314,6 @@ export declare const queryKeys: {
         readonly detail: (id: string) => readonly ["environments", "detail", string];
         readonly bySpace: (spaceId: string) => readonly ["environments", "space", string];
     };
-    readonly pages: {
-        readonly all: () => readonly ["pages"];
-        readonly details: () => readonly ["pages", "detail"];
-        readonly detail: (id: string) => readonly ["pages", "detail", string];
-    };
     readonly secrets: {
         readonly all: () => readonly ["secrets"];
         readonly details: () => readonly ["secrets", "detail"];
@@ -338,8 +362,14 @@ export declare const queryKeys: {
     readonly items: {
         readonly all: () => readonly ["items"];
         readonly public: () => readonly ["items", "public"];
+        readonly publicItem: (uid: string) => readonly ["items", "public", string];
         readonly bySpace: (spaceId: string) => readonly ["items", "space", string];
         readonly search: (opts: ISearchOpts) => readonly ["items", "search", ISearchOpts];
+        readonly featured: () => readonly ["items", "featured"];
+        readonly orbits: () => readonly ["items", "orbits"];
+        readonly orbiters: (uid: string) => readonly ["items", "orbiters", string];
+        readonly derivations: (uid: string) => readonly ["items", "derivations", string];
+        readonly byOwner: (handle: string) => readonly ["items", "owner", string];
     };
     readonly layout: {
         readonly byAccount: (accountHandle: string, spaceHandle?: string) => readonly ["layout", string, string] | readonly ["layout", string];
@@ -399,6 +429,7 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         lastName: string;
         avatarIcon?: string;
         banner?: string;
+        showOrbits?: boolean;
     }, unknown>;
     useWhoami: () => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useChangePassword: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
@@ -667,7 +698,6 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         name: string;
         description: string;
     }, unknown>;
-    usePublicCourses: () => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useInstructorCourses: (userId?: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useCourseEnrollments: () => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useEnrollStudentToCourse: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
@@ -691,7 +721,6 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         itemIds: string[];
     }, unknown>;
     useRefreshCourse: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
-    useRefreshPublicCourses: (options?: UseMutationOptions<unknown, Error, void>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, void, unknown>;
     useRefreshInstructorCourses: (options?: UseMutationOptions<unknown, Error, void>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, void, unknown>;
     useRefreshCoursesEnrollments: (options?: UseMutationOptions<unknown, Error, void>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, void, unknown>;
     useRefreshStudent: (options?: UseMutationOptions<unknown, Error, {
@@ -722,6 +751,25 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     useCloneNotebook: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useRefreshNotebook: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
     useRefreshSpaceNotebooks: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
+    useDeck: (deckId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+    useDecksBySpace: (spaceId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+    useCreateDeck: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        spaceId: string;
+        name: string;
+        description?: string;
+        deckType?: string;
+        file?: File;
+    }, unknown>;
+    useUpdateDeck: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        id: string;
+        name: string;
+        description: string;
+    }, unknown>;
+    useUpdateDeckModel: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        deckId: string;
+        spec: unknown;
+    }, unknown>;
+    useCloneDeck: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useDocument: (documentId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useDocumentsBySpace: (spaceId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useCreateDocument: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
@@ -822,25 +870,106 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     }, Error>;
     useMakeItemPublic: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useMakeItemPrivate: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useSearchPublicItems: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+    useSearchPublicItems: () => import("@tanstack/react-query").UseMutationResult<{
+        items: any;
+        total: number;
+        offset: number;
+    }, Error, {
         q?: string;
         types?: string[];
         max?: number;
-    }, unknown>;
-    usePublicItems: (options?: UseQueryOptions<unknown, Error>) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
+        offset?: number;
+        /** `relevance`, `recent` or `orbits`. */
+        sort?: string;
+        featured?: boolean;
+        /** Only this account's artifacts: what a public profile page lists. */
+        owner?: string;
+    }, unknown>;
+    useLibraryArtifacts: (max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
     usePublications: (options?: UseQueryOptions<unknown, Error>) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
-    useRefreshPublicItems: (options?: UseMutationOptions<unknown, Error, void>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, void, unknown>;
+    useFeaturedItems: (max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useAllFeaturedItems: (options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    usePublicItem: (itemId?: string, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useAccountPublications: (handle?: string, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useMyOrbits: (offset?: number, max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useAccountOrbits: (handle?: string, offset?: number, max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useItemOrbiters: (itemId?: string, offset?: number, max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useItemDerivations: (itemId?: string, offset?: number, max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useOrbitItem: () => import("@tanstack/react-query").UseMutationResult<{
+        itemId: string;
+        orbits: number;
+        orbited: boolean;
+    }, Error, string, {
+        itemId: string;
+    }>;
+    useUnorbitItem: () => import("@tanstack/react-query").UseMutationResult<{
+        itemId: string;
+        orbits: number;
+        orbited: boolean;
+    }, Error, string, {
+        itemId: string;
+    }>;
+    useFeatureItem: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        rank?: number;
+    }, unknown>;
+    useUnfeatureItem: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useSetFeaturedRank: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        rank: number;
+    }, unknown>;
+    useSetItemImage: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        kind: "capture" | "box" | "icon";
+        ref?: string;
+        data?: string;
+    }, unknown>;
+    useResetItemImage: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useCountItemReuse: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        kind: "clone" | "instantiate";
+    }, unknown>;
+    useSyncArtifactCatalogue: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        artifacts: Array<Record<string, any>>;
+        artifactType?: string;
+    }, unknown>;
+    usePublishArtifact: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        image?: {
+            kind: "capture" | "box" | "icon";
+            ref?: string;
+            data?: string;
+        };
+        /**
+         * The publisher's own words for their work, which is what somebody
+         * else will search for.
+         *
+         * Sent with the visibility rather than in a write of their own: the
+         * service writes them onto the artifact in the same operation that
+         * makes it public, so publishing still costs what it cost. Omitted
+         * entirely, they are left as they were — which is what withdrawing
+         * wants, and what an older caller gets.
+         */
+        tags?: string[];
+        /**
+         * What the artifact says about itself, in the publisher's words.
+         *
+         * Sent with the visibility for the same reason the tags are: the
+         * service writes it onto the artifact in the operation that makes it
+         * public. Omitted entirely, it is left as it was.
+         */
+        description?: string;
+    }, unknown>;
+    useUnpublishArtifact: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useUpdateArtifactDetails: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        name?: string;
+        description?: string;
+        tags?: string[];
+    }, unknown>;
     useRefreshSpaceItems: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
     useClearCachedPublicItems: (options?: UseMutationOptions<void, Error, void>) => import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
     useClearCachedItems: (options?: UseMutationOptions<void, Error, void>) => import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
-    usePage: (pageId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
-    usePages: (scope?: {
-        selectedPrincipalUid?: string;
-        selectedPrincipalKind?: "personal" | "organization" | "team";
-    }) => import("@tanstack/react-query").UseQueryResult<any, Error>;
-    useCreatePage: () => import("@tanstack/react-query").UseMutationResult<any, Error, Omit<any, "id">, unknown>;
-    useUpdatePage: () => import("@tanstack/react-query").UseMutationResult<any, Error, Pick<any, "name" | "id" | "tags" | "description">, unknown>;
-    useDeletePage: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useSecret: (secretId: string, options?: {
         principalUid?: string;
         principalKind?: "personal" | "organization" | "team";
@@ -1156,6 +1285,9 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
             readonly serviceAgents: (orgUid: string) => readonly ["mcp", "service-agents", string];
             readonly policyLayer: (scope: string, subjectUid: string) => readonly ["mcp", "policy-layer", string, string];
             readonly alertRules: (orgUid: string) => readonly ["mcp", "alert-rules", string];
+            readonly identityProviders: (orgUid: string) => readonly ["mcp", "identity-providers", string];
+            readonly scimTokens: (orgUid: string) => readonly ["mcp", "scim-tokens", string];
+            readonly admittedClients: (scope: string, subjectUid: string) => readonly ["mcp", "admitted-clients", string, string];
             readonly forwarding: (orgUid: string) => readonly ["mcp", "audit-forwarding", string];
             readonly auditSettings: (orgUid: string) => readonly ["mcp", "audit-settings", string];
             readonly organizationTeams: (orgUid: string) => readonly ["mcp", "organization-teams", string];
@@ -1235,6 +1367,13 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
             readonly bySpace: (spaceId: string) => readonly ["documents", "space", string];
             readonly model: (documentId: string) => readonly ["documents", "detail", string, "model"];
         };
+        readonly decks: {
+            readonly all: () => readonly ["decks"];
+            readonly details: () => readonly ["decks", "detail"];
+            readonly detail: (id: string) => readonly ["decks", "detail", string];
+            readonly bySpace: (spaceId: string) => readonly ["decks", "space", string];
+            readonly model: (deckId: string) => readonly ["decks", "detail", string, "model"];
+        };
         readonly cells: {
             readonly all: () => readonly ["cells"];
             readonly details: () => readonly ["cells", "detail"];
@@ -1267,11 +1406,6 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
             readonly detail: (id: string) => readonly ["environments", "detail", string];
             readonly bySpace: (spaceId: string) => readonly ["environments", "space", string];
         };
-        readonly pages: {
-            readonly all: () => readonly ["pages"];
-            readonly details: () => readonly ["pages", "detail"];
-            readonly detail: (id: string) => readonly ["pages", "detail", string];
-        };
         readonly secrets: {
             readonly all: () => readonly ["secrets"];
             readonly details: () => readonly ["secrets", "detail"];
@@ -1320,8 +1454,14 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         readonly items: {
             readonly all: () => readonly ["items"];
             readonly public: () => readonly ["items", "public"];
+            readonly publicItem: (uid: string) => readonly ["items", "public", string];
             readonly bySpace: (spaceId: string) => readonly ["items", "space", string];
             readonly search: (opts: ISearchOpts) => readonly ["items", "search", ISearchOpts];
+            readonly featured: () => readonly ["items", "featured"];
+            readonly orbits: () => readonly ["items", "orbits"];
+            readonly orbiters: (uid: string) => readonly ["items", "orbiters", string];
+            readonly derivations: (uid: string) => readonly ["items", "derivations", string];
+            readonly byOwner: (handle: string) => readonly ["items", "owner", string];
         };
         readonly layout: {
             readonly byAccount: (accountHandle: string, spaceHandle?: string) => readonly ["layout", string, string] | readonly ["layout", string];
@@ -1362,5 +1502,8 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     documentUploadLoading: boolean;
     documentUploadProgress: number;
     resetDocumentUpload: () => void;
+    deckUploadLoading: boolean;
+    deckUploadProgress: number;
+    resetDeckUpload: () => void;
 };
 export default useCache;