@datalayer/core 1.2.12 → 1.2.14

package/lib/hooks/useCache.js

@@ -58,6 +58,19 @@ const DEFAULT_QUERY_OPTIONS = {
     // Ensure queries prioritize cache over network when data is fresh
     networkMode: 'online',
 };
+/**
+ * A list of what a space holds — all of it, or the items of one type. Every
+ * such list takes these options (`spaceListsRefetchOnMount.unit.test.ts`
+ * holds them to it). Refetched every time a page mounts it: an item
+ * created elsewhere — a cell has no create mutation here to clear this cache —
+ * would otherwise stay missing from the list for the five minutes the default
+ * options keep it fresh, and coming back to the list is exactly when somebody
+ * looks for it.
+ */
+const LIST_QUERY_OPTIONS = {
+    ...DEFAULT_QUERY_OPTIONS,
+    refetchOnMount: 'always',
+};
 /**
  * Refresh what a visitor sees, not just what the editor is looking at.
  *
@@ -294,6 +307,7 @@ export const queryKeys = {
         publicProfileByHandle: (handle) => [...queryKeys.organizations.all(), 'public-profile', handle],
         userOrgs: () => [...queryKeys.organizations.all(), 'user'],
         members: (orgId) => [...queryKeys.organizations.detail(orgId), 'members'],
+        pluginsOff: (orgId) => [...queryKeys.organizations.detail(orgId), 'plugins-off'],
     },
     // Teams
     teams: {
@@ -863,6 +877,32 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             owner: toItemOwner(raw),
         };
     };
+    /**
+     * A published agentic UI application: what it answers, and its definition
+     * as the library hands it over — `model_s`, the string the Studio reads
+     * the definition from, left unparsed because the Studio owns its shape.
+     */
+    const toApp = (raw) => {
+        return {
+            id: raw.uid,
+            type: 'app',
+            name: raw.name_t,
+            description: raw.description_t,
+            tags: Array.isArray(raw.tags_ss) ? raw.tags_ss : [],
+            public: raw.is_public_b ?? false,
+            model_s: raw.model_s,
+            creationDate: raw.creation_ts_dt
+                ? new Date(raw.creation_ts_dt)
+                : undefined,
+            lastUpdateDate: raw.last_update_ts_dt
+                ? new Date(raw.last_update_ts_dt)
+                : undefined,
+            lastPublicationDate: raw.published_ts_dt
+                ? new Date(raw.published_ts_dt)
+                : undefined,
+            owner: toItemOwner(raw),
+        };
+    };
     /** An evaluator of the platform's catalogue (B5-01), published as an agent is. */
     const toEvaluator = (raw) => {
         return {
@@ -1375,6 +1415,10 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 return toInvestigation(item);
             case 'evaluator':
                 return toEvaluator(item);
+            // Without this a published app answered `{}`, as a deck once did: a
+            // card with no type and no name.
+            case 'app':
+                return toApp(item);
             case 'sitecard':
                 return toSiteCard(item);
             default:
@@ -2345,7 +2389,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 }
                 return [];
             },
-            ...DEFAULT_QUERY_OPTIONS,
+            ...LIST_QUERY_OPTIONS,
             enabled: !!spaceId,
         });
     };
@@ -2477,7 +2521,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 }
                 return [];
             },
-            ...DEFAULT_QUERY_OPTIONS,
+            ...LIST_QUERY_OPTIONS,
             enabled: !!spaceId,
         });
     };
@@ -2652,7 +2696,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 }
                 return [];
             },
-            ...DEFAULT_QUERY_OPTIONS,
+            ...LIST_QUERY_OPTIONS,
             enabled: !!spaceId,
         });
     };
@@ -4160,7 +4204,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 return [];
             },
             enabled: !!spaceId,
-            ...DEFAULT_QUERY_OPTIONS,
+            ...LIST_QUERY_OPTIONS,
         });
     };
     /**
@@ -4347,7 +4391,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 return [];
             },
             enabled: !!spaceId,
-            ...DEFAULT_QUERY_OPTIONS,
+            ...LIST_QUERY_OPTIONS,
         });
     };
     /**
@@ -4438,7 +4482,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 return [];
             },
             enabled: !!spaceId,
-            ...DEFAULT_QUERY_OPTIONS,
+            ...LIST_QUERY_OPTIONS,
         });
     };
     /**
@@ -4478,7 +4522,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 return [];
             },
             enabled: !!spaceId,
-            ...DEFAULT_QUERY_OPTIONS,
+            ...LIST_QUERY_OPTIONS,
         });
     };
     /**
@@ -4547,7 +4591,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 return [];
             },
             enabled: !!spaceId,
-            ...DEFAULT_QUERY_OPTIONS,
+            ...LIST_QUERY_OPTIONS,
         });
     };
     /**
@@ -4641,7 +4685,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 return [];
             },
             enabled: !!spaceId,
-            ...DEFAULT_QUERY_OPTIONS,
+            ...LIST_QUERY_OPTIONS,
         });
     };
     /**
@@ -6332,6 +6376,8 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         'evalset',
         'dataset',
         'agent',
+        // An agentic UI application, published from the Studio.
+        'app',
     ];
     const librarySearchQueryString = ({ q, types, max = 20, offset = 0, sort = 'relevance', featured = false, owner, }) => {
         const normalizedTypes = Array.from(new Set((types || [])
@@ -6906,6 +6952,59 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             enabled: Boolean(configuration.libraryUrl) && Boolean(itemId) && enabled,
         });
     };
+    /**
+     * Post a public artifact to X through the Library's saga: the author's
+     * text, then the artifact's attributed share-card link (X draws the card),
+     * and optionally one picked result as an image.
+     */
+    const usePublishXShare = () => {
+        return useMutation({
+            mutationFn: async ({ itemId, text, idempotencyKey, imageDataUrl, }) => {
+                const resp = await requestDatalayer({
+                    url: `${configuration.libraryUrl}/api/library/v1/items/${encodeURIComponent(itemId)}/shares/x`,
+                    method: 'POST',
+                    headers: { 'Idempotency-Key': idempotencyKey },
+                    body: { text, imageDataUrl },
+                });
+                if (!resp.success) {
+                    throw new Error(resp.message || 'Failed to post to X');
+                }
+                return resp.share;
+            },
+        });
+    };
+    const useUnpublishXShare = () => {
+        return useMutation({
+            mutationFn: async (idempotencyKey) => {
+                const resp = await requestDatalayer({
+                    url: `${configuration.libraryUrl}/api/library/v1/shares/x/${encodeURIComponent(idempotencyKey)}`,
+                    method: 'DELETE',
+                });
+                if (!resp.success) {
+                    throw new Error(resp.message || 'Failed to remove the X post');
+                }
+                return resp.share;
+            },
+        });
+    };
+    const useXShares = (itemId, enabled = true) => {
+        return useQuery({
+            queryKey: ['library', 'social-shares', 'x', itemId],
+            queryFn: async () => {
+                const resp = await requestDatalayer({
+                    url: `${configuration.libraryUrl}/api/library/v1/items/${encodeURIComponent(itemId)}/shares/x`,
+                    method: 'GET',
+                    notifyOnError: false,
+                });
+                if (!resp.success) {
+                    throw new Error(resp.message || 'Failed to load X posts');
+                }
+                return Array.isArray(resp.shares) ? resp.shares : [];
+            },
+            ...DEFAULT_QUERY_OPTIONS,
+            enabled: Boolean(configuration.libraryUrl) && Boolean(itemId) && enabled,
+        });
+    };
     /** Publish one selected public result through the durable Bluesky saga. */
     const usePublishBlueskyShare = () => {
         return useMutation({
@@ -7241,6 +7340,39 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             method: 'DELETE',
         }),
     });
+    /**
+     * The X connection, as IAM reports it: whether X is configured on this
+     * deployment, whether the caller connected it, and the account (no token).
+     */
+    const useXConnection = (enabled = true) => useQuery({
+        queryKey: ['iam', 'social', 'x', 'status'],
+        queryFn: async () => requestDatalayer({
+            url: `${configuration.iamUrl}/api/iam/v1/social/x/status`,
+            method: 'GET',
+            notifyOnError: false,
+        }),
+        ...DEFAULT_QUERY_OPTIONS,
+        enabled: Boolean(configuration.iamUrl) && enabled,
+    });
+    /**
+     * Begin connecting X. Answers the start link to open at top level;
+     * `returnOrigin` is where to come back to (an origin only: IAM builds the
+     * path, so this cannot ask to be sent anywhere).
+     */
+    const useConnectX = () => useMutation({
+        mutationFn: async (returnOrigin) => requestDatalayer({
+            url: `${configuration.iamUrl}/api/iam/v1/social/x/connect`,
+            method: 'POST',
+            body: returnOrigin ? { return_origin: returnOrigin } : {},
+        }),
+    });
+    const useDisconnectX = () => useMutation({
+        mutationFn: async () => requestDatalayer({
+            url: `${configuration.iamUrl}/api/iam/v1/social/x/connection`,
+            method: 'DELETE',
+        }),
+        onSuccess: () => queryClient.invalidateQueries({ queryKey: ['iam', 'social', 'x'] }),
+    });
     // ============================================================================
     // Waiting List & Growth
     // ============================================================================
@@ -8292,6 +8424,12 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         useGetBlueskyConnection,
         useConnectBluesky,
         useDisconnectBluesky,
+        useXConnection,
+        useConnectX,
+        useDisconnectX,
+        usePublishXShare,
+        useUnpublishXShare,
+        useXShares,
         usePublishLinkedInShare,
         useUnpublishLinkedInShare,
         useLinkedInShares,

package/lib/hooks/useContents.js

@@ -156,6 +156,9 @@ export const useContentSources = (filters = {}) => {
         queryFn: () => listSources(token ?? '', filters, contentsUrl),
         enabled: Boolean(token && contentsUrl),
         staleTime: 30_000,
+        // Coming back to a list is when somebody looks for what they just made:
+        // it is read again, whatever made it.
+        refetchOnMount: 'always',
         refetchOnWindowFocus: true,
     });
 };

package/lib/hooks/useOrganizationPlugins.d.ts

@@ -0,0 +1,4 @@
+/** The plugin ids the organization has turned off; no query without an organization. */
+export declare const useOrganizationPluginsOff: (orgUid: string) => import("@tanstack/react-query").UseQueryResult<string[], Error>;
+/** Replace the list: the plugins named are off, every other is on. */
+export declare const useSetOrganizationPluginsOff: (orgUid: string) => import("@tanstack/react-query").UseMutationResult<string[], Error, readonly string[], unknown>;

package/lib/hooks/useOrganizationPlugins.js

@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2023-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * The plugins an organization has turned off (LOOP C-12), read and replaced
+ * through IAM with the signed-in person's token.
+ *
+ * @module hooks/useOrganizationPlugins
+ */
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { getOrganizationPluginsOff, setOrganizationPluginsOff, } from '../api/iam/organizationPlugins.js';
+import { useCoreStore, useIAMStore } from '../state/index.js';
+import { queryKeys } from './useCache.js';
+/** The plugin ids the organization has turned off; no query without an organization. */
+export const useOrganizationPluginsOff = (orgUid) => {
+    const token = useIAMStore(state => state.token);
+    const iamUrl = useCoreStore(state => state.configuration.iamUrl);
+    return useQuery({
+        queryKey: queryKeys.organizations.pluginsOff(orgUid),
+        queryFn: () => getOrganizationPluginsOff(token ?? '', orgUid, iamUrl),
+        enabled: Boolean(token && iamUrl && orgUid),
+        staleTime: 30_000,
+    });
+};
+/** Replace the list: the plugins named are off, every other is on. */
+export const useSetOrganizationPluginsOff = (orgUid) => {
+    const queryClient = useQueryClient();
+    const token = useIAMStore(state => state.token);
+    const iamUrl = useCoreStore(state => state.configuration.iamUrl);
+    return useMutation({
+        mutationFn: pluginsOff => setOrganizationPluginsOff(token ?? '', orgUid, pluginsOff, iamUrl),
+        onSuccess: pluginsOff => {
+            queryClient.setQueryData(queryKeys.organizations.pluginsOff(orgUid), pluginsOff);
+        },
+    });
+};

package/lib/hooks/usePrincipalCacheStore.d.ts

@@ -1,4 +1,4 @@
-export type PrincipalCacheKind = 'personal' | 'team' | 'organization';
+export type PrincipalCacheKind = 'personal' | 'team' | 'organization' | 'service';
 /**
  * A resolved principal snapshot kept in memory so repeated renders (across
  * views) can paint instantly instead of waiting for a network round trip.

package/lib/hooks/usePrincipalCacheStore.js

@@ -96,4 +96,6 @@ export const usePrincipalCacheStore = create((set, get) => ({
 }));
 export default usePrincipalCacheStore;
 // What one session resolved is not the next one's to paint.
-registerSessionState({ forget: () => usePrincipalCacheStore.getState().reset() });
+registerSessionState({
+    forget: () => usePrincipalCacheStore.getState().reset(),
+});

package/lib/models/URN.d.ts

@@ -1,3 +1,6 @@
+import type { IIAMProviderName } from './IAMProvidersSpecs';
+/** What an identity provider's account URN starts with, before its name. */
+export declare const IAM_PROVIDER_URN_PREFIX = "urn:dla:iam:ext::";
 export declare class URN implements IURN {
     private _partition;
     private _service;
@@ -12,7 +15,41 @@ export declare class URN implements IURN {
     get account(): string;
     get type(): string;
     get uid(): string;
+    /** An identity provider's account (`urn:dla:iam:ext::github:…`). */
+    get isIAMProviderAccount(): boolean;
+    toString(): string;
 }
+/** A URN, or `undefined` when the value is not one — never a throw. */
+export declare function parseURN(value?: string | null): URN | undefined;
+/**
+ * Where an account came from, read from its `origin`.
+ *
+ * - `datalayer`: made on Datalayer, with a password.
+ * - `iam-provider`: made by signing in with an identity provider, which it
+ *   still signs in through (`urn:dla:iam:ext::<provider>:<account id>`).
+ * - `urn`: any other URN — an AWS Marketplace or enterprise origin.
+ * - `unknown`: nothing recorded, or a value that is none of the above.
+ */
+export type IAccountOrigin = {
+    kind: 'datalayer';
+} | {
+    kind: 'iam-provider';
+    provider: IIAMProviderName;
+    accountId: string;
+    urn: URN;
+} | {
+    kind: 'urn';
+    urn: URN;
+} | {
+    kind: 'unknown';
+    value: string;
+};
+export declare function accountOriginOf(origin?: string | null): IAccountOrigin;
+/**
+ * Whether an account signs in through a provider: disconnecting that
+ * provider would leave it nothing to sign in with.
+ */
+export declare function signsInWith(origin: string | null | undefined, provider: IIAMProviderName): boolean;
 /**
   Datalayer Uniform Resource Name (URN)
 

package/lib/models/URN.js

@@ -2,6 +2,8 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
+/** What an identity provider's account URN starts with, before its name. */
+export const IAM_PROVIDER_URN_PREFIX = 'urn:dla:iam:ext::';
 export class URN {
     _partition;
     _service;
@@ -17,7 +19,8 @@ export class URN {
         this._region = parts[3];
         this._account = parts[4];
         this._type = parts[5];
-        this._uid = parts[6];
+        // The rest, colons and all: a provider's account id may carry them.
+        this._uid = parts.slice(6).join(':');
     }
     get partition() {
         return this._partition;
@@ -37,4 +40,59 @@ export class URN {
     get uid() {
         return this._uid;
     }
+    /** An identity provider's account (`urn:dla:iam:ext::github:…`). */
+    get isIAMProviderAccount() {
+        return this._service === 'iam' && this._region === 'ext' && !!this._type;
+    }
+    toString() {
+        return [
+            'urn',
+            this._partition,
+            this._service,
+            this._region,
+            this._account,
+            this._type,
+            this._uid,
+        ].join(':');
+    }
+}
+/** A URN, or `undefined` when the value is not one — never a throw. */
+export function parseURN(value) {
+    const text = (value ?? '').trim();
+    if (!text.toLowerCase().startsWith('urn:') || text.split(':').length < 7) {
+        return undefined;
+    }
+    return new URN(text);
+}
+const IAM_PROVIDER_NAMES = [
+    'bluesky',
+    'discord',
+    'github',
+    'google',
+    'linkedin',
+    'okta',
+    'x',
+];
+export function accountOriginOf(origin) {
+    const value = (origin ?? '').trim();
+    if (value === 'datalayer') {
+        return { kind: 'datalayer' };
+    }
+    const urn = parseURN(value);
+    if (!urn) {
+        return { kind: 'unknown', value };
+    }
+    const provider = urn.type.toLowerCase();
+    if (urn.isIAMProviderAccount && IAM_PROVIDER_NAMES.includes(provider)) {
+        return { kind: 'iam-provider', provider, accountId: urn.uid, urn };
+    }
+    return { kind: 'urn', urn };
+}
+/**
+ * Whether an account signs in through a provider: disconnecting that
+ * provider would leave it nothing to sign in with.
+ */
+export function signsInWith(origin, provider) {
+    const parsed = accountOriginOf(origin);
+    return parsed.kind === 'iam-provider' && parsed.provider === provider;
 }

package/lib/state/substates/NavigationState.d.ts

@@ -1,5 +1,17 @@
 /** The signed-in shell: the platform, the business cases, or the admin. */
-export type NavigationView = 'home' | 'agentify' | 'admin';
+/**
+ * The five shells of the signed-in application.
+ *
+ * `studio` is where an agentic UI application is composed, validated and
+ * shipped — the default for somebody who has not chosen, and what the root
+ * shows. `home` is the whole platform, shown as *Power*, at `/power`: the key
+ * is kept so a cookie written before the Studio existed still names the
+ * shell it meant. `agentify` is the business cases; `admin` is the
+ * platform's administration. `loop` is LOOP: AI applications built by spec,
+ * by drag and drop or in Python — the Studio's app pages under a sidebar of
+ * their own, and the LOOP workspace at `/loop`.
+ */
+export type NavigationView = 'studio' | 'home' | 'agentify' | 'admin' | 'loop';
 /** The shells, and where each one opens when it has not been visited. */
 export declare const NAVIGATION_VIEW_HOMES: Record<NavigationView, string>;
 /** Well-known view identifiers for {@link NavigationState.tabsByView}. */
@@ -54,6 +66,16 @@ export type NavigationState = {
  * through or on a page that belongs to no shell.
  */
 export declare function isRememberableRoute(route: string): boolean;
+/**
+ * Whether a page belongs to no shell: the settings, the documentation and
+ * the decks.
+ *
+ * They are read from whichever shell the reader is in — its sidebar stays
+ * beside them and the header's selector does not move — so they are never a
+ * shell's own page: opening one does not change the shell, and no shell
+ * returns to one.
+ */
+export declare function isShellNeutralRoute(route: string): boolean;
 /**
  * The shell a route belongs to, read off its first segment.
  *
@@ -62,8 +84,13 @@ export declare function isRememberableRoute(route: string): boolean;
  * reached Home through a sidebar link while the toggle still said Agentify
  * had their Home pages filed under Agentify — and the toggle, seeing
  * "Agentify" already chosen, did nothing when they clicked it.
+ *
+ * A shell-neutral page (the settings, the documentation) has no shell of its
+ * own: given the shell the reader is in (`current`), that is the answer, so
+ * the sidebar and the header stay where they were. Without it the settings
+ * read as the Studio's and the documentation as Power's, as they once were.
  */
-export declare function viewForRoute(route: string): NavigationView;
+export declare function viewForRoute(route: string, current?: NavigationView): NavigationView;
 export declare const navigationStore: import("zustand").StoreApi<NavigationState>;
 /**
  * The hook, shaped like a `zustand` store created with `create`: callable