@jini-ai/ui 0.1.0

package/dist/features/connectors/dependencies.js

@@ -0,0 +1,147 @@
+/**
+ * The only file in this feature allowed to touch a concrete adapter.
+ *
+ * `data` (the catalog/connect/disconnect transport) is genuinely
+ * host-specific — OD's real implementation calls `providers/registry`
+ * (REST endpoints + a popup-window OAuth flow). Per the canary plan, this
+ * package ships a fake/in-memory double instead of a real transport; a real
+ * host supplies its own `ConnectorsPort` implementation.
+ *
+ * `authPendingStorage` and `authBridge`, by contrast, only touch generic
+ * browser APIs (sessionStorage, postMessage, focus/visibility) with no
+ * backend-specific shape, so this package ships real SSR-guarded browser
+ * implementations for those two — a host only needs to supply its own
+ * `data` port.
+ */
+import { isTrustedConnectorCallbackOrigin } from './rules.js';
+import { CONNECTOR_AUTH_PENDING_STORAGE_KEY } from './constants.js';
+import { parseConnectorAuthorizationPendingState } from './rules.js';
+/**
+ * An in-memory test double: connect/disconnect mutate a local array and
+ * report `connected`/`available` directly (no real OAuth round trip). Good
+ * enough for demos and for driving this feature's own hook/component tests.
+ */
+export function createFakeConnectorsPort(options = {}) {
+    let connectors = options.connectors ? options.connectors.map((c) => ({ ...c })) : [];
+    const latencyMs = options.latencyMs ?? 0;
+    const delay = (value) => latencyMs > 0 ? new Promise((resolve) => setTimeout(() => resolve(value), latencyMs)) : Promise.resolve(value);
+    return {
+        fetchConnectors() {
+            return delay(connectors.map((c) => ({ ...c })));
+        },
+        fetchConnectorEnrichment() {
+            return delay(connectors.map((c) => ({ ...c })));
+        },
+        fetchConnectorStatuses() {
+            const statuses = {};
+            for (const c of connectors) {
+                statuses[c.id] = { status: c.status, ...(c.accountLabel ? { accountLabel: c.accountLabel } : {}) };
+            }
+            return delay(statuses);
+        },
+        fetchConnectorDetail(connectorId, _options) {
+            const found = connectors.find((c) => c.id === connectorId) ?? null;
+            return delay(found ? { ...found } : null);
+        },
+        connectConnector(connectorId) {
+            const idx = connectors.findIndex((c) => c.id === connectorId);
+            if (idx === -1)
+                return delay({ connector: null, error: 'Connector not found' });
+            connectors[idx] = { ...connectors[idx], status: 'connected' };
+            return delay({ connector: { ...connectors[idx] }, auth: { kind: 'connected' } });
+        },
+        disconnectConnector(connectorId) {
+            const idx = connectors.findIndex((c) => c.id === connectorId);
+            if (idx === -1)
+                return delay(null);
+            connectors[idx] = { ...connectors[idx], status: 'available' };
+            return delay({ ...connectors[idx] });
+        },
+        cancelConnectorAuthorization(connectorId) {
+            const idx = connectors.findIndex((c) => c.id === connectorId);
+            if (idx === -1)
+                return delay(null);
+            connectors[idx] = { ...connectors[idx], status: 'available' };
+            return delay({ ...connectors[idx] });
+        },
+        openExternalUrl(_url) {
+            return delay(true);
+        },
+    };
+}
+export function createBrowserConnectorAuthPendingStorage() {
+    return {
+        load() {
+            if (typeof window === 'undefined')
+                return {};
+            try {
+                const raw = window.sessionStorage.getItem(CONNECTOR_AUTH_PENDING_STORAGE_KEY);
+                if (!raw)
+                    return {};
+                return parseConnectorAuthorizationPendingState(raw);
+            }
+            catch {
+                return {};
+            }
+        },
+        save(state) {
+            if (typeof window === 'undefined')
+                return;
+            try {
+                if (Object.keys(state).length === 0) {
+                    window.sessionStorage.removeItem(CONNECTOR_AUTH_PENDING_STORAGE_KEY);
+                }
+                else {
+                    window.sessionStorage.setItem(CONNECTOR_AUTH_PENDING_STORAGE_KEY, JSON.stringify(state));
+                }
+            }
+            catch {
+                /* Ignore unavailable sessionStorage. */
+            }
+        },
+    };
+}
+const CONNECTOR_CALLBACK_MESSAGE_TYPE = 'jini:connector-connected';
+export function createBrowserConnectorAuthBridge() {
+    return {
+        subscribeAuthCallback(onTrustedCallback) {
+            if (typeof window === 'undefined')
+                return () => { };
+            function onMessage(event) {
+                const data = event.data;
+                if (!data || typeof data !== 'object' || data.type !== CONNECTOR_CALLBACK_MESSAGE_TYPE)
+                    return;
+                if (!isTrustedConnectorCallbackOrigin(event.origin, window.location.origin))
+                    return;
+                onTrustedCallback();
+            }
+            window.addEventListener('message', onMessage);
+            return () => window.removeEventListener('message', onMessage);
+        },
+        subscribeWindowRefocus(onRefocus) {
+            if (typeof window === 'undefined')
+                return () => { };
+            function onVisibilityChange() {
+                if (document.visibilityState !== 'visible')
+                    return;
+                onRefocus();
+            }
+            window.addEventListener('focus', onRefocus);
+            window.addEventListener('pageshow', onRefocus);
+            document.addEventListener('visibilitychange', onVisibilityChange);
+            return () => {
+                window.removeEventListener('focus', onRefocus);
+                window.removeEventListener('pageshow', onRefocus);
+                document.removeEventListener('visibilitychange', onVisibilityChange);
+            };
+        },
+    };
+}
+export function createFakeConnectorsDependencies(options = {}) {
+    return {
+        data: createFakeConnectorsPort(options),
+        authPendingStorage: createBrowserConnectorAuthPendingStorage(),
+        authBridge: createBrowserConnectorAuthBridge(),
+    };
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/features/connectors/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../src/features/connectors/dependencies.ts"],"names":[],"mappings":"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"}

package/dist/features/connectors/hooks/useConnectorAuthorization.d.ts

@@ -0,0 +1,29 @@
+import type { Dispatch, SetStateAction } from 'react';
+import type { ConnectorAuthBridgePort, ConnectorAuthPendingStoragePort, ConnectorsPort } from '../ports.js';
+import type { Connector, ConnectorAction, ConnectorAuthorizationPendingState, ConnectorAuthResultEvent, ConnectorStatusMap, PendingConnectorAction } from '../types.js';
+export interface UseConnectorAuthorizationParams {
+    connectors: Connector[];
+    setConnectors: Dispatch<SetStateAction<Connector[]>>;
+    /** Fired when a status refresh detects a real connect/disconnect change (for cross-surface refresh). */
+    onConnectorsChanged?: () => void;
+    onAuthResult?: (event: ConnectorAuthResultEvent) => void;
+    pollMs?: number;
+}
+export interface ConnectorAuthorizationController {
+    pending: ConnectorAuthorizationPendingState;
+    cancelFailed: Record<string, boolean>;
+    authError: Record<string, string>;
+    pendingConnectorAction: PendingConnectorAction | null;
+    reloadStatuses: () => Promise<ConnectorStatusMap>;
+    runConnectorAction: (connectorId: string, action: ConnectorAction) => Promise<void>;
+    cancelAuthorization: (connectorId: string) => Promise<void>;
+}
+/**
+ * The concurrency-correctness core: persists in-flight OAuth authorization
+ * state, polls statuses while anything is pending, listens for the OAuth
+ * popup's postMessage callback, and refreshes + auto-cancels stale
+ * authorizations on window refocus (a system-browser auth flow has no
+ * opener to post back to, so this is the only way that path resolves).
+ */
+export declare function useConnectorAuthorization(port: ConnectorsPort, authPendingStorage: ConnectorAuthPendingStoragePort, authBridge: ConnectorAuthBridgePort, params: UseConnectorAuthorizationParams): ConnectorAuthorizationController;
+//# sourceMappingURL=useConnectorAuthorization.d.ts.map

package/dist/features/connectors/hooks/useConnectorAuthorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectorAuthorization.d.ts","sourceRoot":"","sources":["../../../../src/features/connectors/hooks/useConnectorAuthorization.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5G,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,kCAAkC,EAClC,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAerB,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACrD,wGAAwG;IACxG,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,kCAAkC,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,sBAAsB,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtD,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClD,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,mBAAmB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,cAAc,EACpB,kBAAkB,EAAE,+BAA+B,EACnD,UAAU,EAAE,uBAAuB,EACnC,MAAM,EAAE,+BAA+B,GACtC,gCAAgC,CAkOlC"}

package/dist/features/connectors/hooks/useConnectorAuthorization.js

@@ -0,0 +1,226 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { applyConnectorStatuses, clearConnectorAuthorizationCancelFailuresForConnected, clearConnectorAuthorizationErrorsForConnected, clearConnectorAuthorizationPending, findStaleAuthorizations, hasConnectorStatusChanges, mergeConnectorActionResult, pruneConnectorAuthorizationPending, updateConnectorAuthorizationPendingFromConnectResponse, updateConnectorAuthorizationPendingFromStatuses, } from '../rules.js';
+import { CONNECTOR_AUTH_PENDING_POLL_MS } from '../constants.js';
+/**
+ * The concurrency-correctness core: persists in-flight OAuth authorization
+ * state, polls statuses while anything is pending, listens for the OAuth
+ * popup's postMessage callback, and refreshes + auto-cancels stale
+ * authorizations on window refocus (a system-browser auth flow has no
+ * opener to post back to, so this is the only way that path resolves).
+ */
+export function useConnectorAuthorization(port, authPendingStorage, authBridge, params) {
+    const { connectors, setConnectors, onConnectorsChanged, onAuthResult, pollMs = CONNECTOR_AUTH_PENDING_POLL_MS } = params;
+    const [pending, setPending] = useState(() => pruneConnectorAuthorizationPending(authPendingStorage.load(), Date.now()));
+    const [cancelFailed, setCancelFailed] = useState({});
+    const [authError, setAuthError] = useState({});
+    const [pendingConnectorAction, setPendingConnectorAction] = useState(null);
+    const connectorsRef = useRef(connectors);
+    useEffect(() => {
+        connectorsRef.current = connectors;
+    }, [connectors]);
+    const pendingRef = useRef(pending);
+    useEffect(() => {
+        pendingRef.current = pending;
+    }, [pending]);
+    const updateConnector = useCallback((next) => {
+        if (!next)
+            return;
+        setConnectors((curr) => curr.map((c) => (c.id === next.id ? mergeConnectorActionResult(c, next) : c)));
+    }, [setConnectors]);
+    const reloadStatuses = useCallback(async () => {
+        const statuses = await port.fetchConnectorStatuses();
+        const statusChanged = hasConnectorStatusChanges(connectorsRef.current, statuses);
+        setConnectors((curr) => applyConnectorStatuses(curr, statuses));
+        setPending((curr) => updateConnectorAuthorizationPendingFromStatuses(curr, statuses, Date.now()));
+        setAuthError((curr) => clearConnectorAuthorizationErrorsForConnected(curr, statuses));
+        setCancelFailed((curr) => clearConnectorAuthorizationCancelFailuresForConnected(curr, statuses));
+        if (statusChanged)
+            onConnectorsChanged?.();
+        return statuses;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [port, setConnectors, onConnectorsChanged]);
+    const cancelStaleAuthorizations = useCallback(async (pendingBeforeReload, statuses) => {
+        const stuck = findStaleAuthorizations(pendingBeforeReload, statuses, Date.now());
+        if (stuck.length === 0)
+            return;
+        await Promise.allSettled(stuck.map(async (connectorId) => {
+            let connector = null;
+            try {
+                connector = await port.cancelConnectorAuthorization(connectorId);
+            }
+            catch {
+                connector = null;
+            }
+            if (!connector) {
+                setCancelFailed((curr) => ({ ...curr, [connectorId]: true }));
+                return;
+            }
+            updateConnector(connector);
+            setCancelFailed((curr) => {
+                if (curr[connectorId] === undefined)
+                    return curr;
+                const next = { ...curr };
+                delete next[connectorId];
+                return next;
+            });
+            // This clear's `curr[connectorId] !== undefined` guard is
+            // structurally unreachable as *true*: `authError[connectorId]`
+            // and `pending[connectorId]` (this function only ever runs for
+            // ids that were in `pendingBeforeReload`) can never both be set
+            // for the same id at the same time. Every path that sets
+            // `authError[id]` (`runConnectorAction`'s connect-failure branch)
+            // unconditionally clears `pending[id]` in that same update, and
+            // the only path that ever sets `pending[id]` to a new truthy
+            // value again (a later connect call's success branch)
+            // unconditionally clears `authError[id]` first, before ever
+            // reaching its own success branch. So by the time any id reaches
+            // this stale-sweep success path with a real `pending[id]` entry,
+            // `authError[id]` is guaranteed already absent. Left in place
+            // (not stripped) as a guard against a future refactor breaking
+            // that invariant — see packages/ui/source-map.md's 2026-07-22
+            // dated entry for the full proof.
+            setAuthError((curr) => {
+                if (curr[connectorId] === undefined)
+                    return curr;
+                const next = { ...curr };
+                delete next[connectorId];
+                return next;
+            });
+            setPending((curr) => clearConnectorAuthorizationPending(curr, connectorId));
+        }));
+    }, [port, updateConnector]);
+    // Persist pending state whenever it changes.
+    useEffect(() => {
+        authPendingStorage.save(pending);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [pending]);
+    // Poll statuses while any authorization is in flight.
+    useEffect(() => {
+        if (Object.keys(pending).length === 0)
+            return;
+        const interval = setInterval(() => {
+            setPending((curr) => pruneConnectorAuthorizationPending(curr, Date.now()));
+            void reloadStatuses();
+        }, pollMs);
+        return () => clearInterval(interval);
+    }, [pending, pollMs, reloadStatuses]);
+    // OAuth popup/system-browser callback.
+    useEffect(() => authBridge.subscribeAuthCallback(() => void reloadStatuses()), [authBridge, reloadStatuses]);
+    // Refresh + auto-cancel stale authorizations on window refocus.
+    useEffect(() => authBridge.subscribeWindowRefocus(() => {
+        void (async () => {
+            const pendingBeforeReload = pendingRef.current;
+            const statuses = await reloadStatuses();
+            await cancelStaleAuthorizations(pendingBeforeReload, statuses);
+        })();
+    }), [authBridge, reloadStatuses, cancelStaleAuthorizations]);
+    const runConnectorAction = useCallback(async (connectorId, action) => {
+        if (pendingConnectorAction)
+            return;
+        setPendingConnectorAction({ connectorId, action });
+        try {
+            if (action === 'connect') {
+                setCancelFailed((curr) => {
+                    if (curr[connectorId] === undefined)
+                        return curr;
+                    const next = { ...curr };
+                    delete next[connectorId];
+                    return next;
+                });
+                setAuthError((curr) => {
+                    if (curr[connectorId] === undefined)
+                        return curr;
+                    const next = { ...curr };
+                    delete next[connectorId];
+                    return next;
+                });
+                try {
+                    const result = await port.connectConnector(connectorId);
+                    updateConnector(result.connector);
+                    if (result.connector && !result.error) {
+                        if (result.connector.status === 'connected')
+                            onConnectorsChanged?.();
+                        setPending((curr) => updateConnectorAuthorizationPendingFromConnectResponse(curr, result, Date.now()));
+                        onAuthResult?.({ connectorId, action: 'connect', result: 'success' });
+                    }
+                    else {
+                        setPending((curr) => clearConnectorAuthorizationPending(curr, connectorId));
+                        if (result.error) {
+                            setAuthError((curr) => ({ ...curr, [connectorId]: result.error }));
+                        }
+                        onAuthResult?.({ connectorId, action: 'connect', result: 'failed', ...(result.error ? { errorCode: result.error } : {}) });
+                    }
+                }
+                catch (err) {
+                    onAuthResult?.({
+                        connectorId,
+                        action: 'connect',
+                        result: 'failed',
+                        errorCode: err instanceof Error ? err.message : String(err),
+                    });
+                    throw err;
+                }
+            }
+            else {
+                setPending((curr) => clearConnectorAuthorizationPending(curr, connectorId));
+                setAuthError((curr) => {
+                    if (curr[connectorId] === undefined)
+                        return curr;
+                    const next = { ...curr };
+                    delete next[connectorId];
+                    return next;
+                });
+                try {
+                    updateConnector(await port.disconnectConnector(connectorId));
+                    onConnectorsChanged?.();
+                    onAuthResult?.({ connectorId, action: 'disconnect', result: 'success' });
+                }
+                catch (err) {
+                    onAuthResult?.({
+                        connectorId,
+                        action: 'disconnect',
+                        result: 'failed',
+                        errorCode: err instanceof Error ? err.message : String(err),
+                    });
+                    throw err;
+                }
+            }
+        }
+        finally {
+            setPendingConnectorAction(null);
+        }
+    }, [pendingConnectorAction, port, updateConnector, onConnectorsChanged, onAuthResult]);
+    const cancelAuthorization = useCallback(async (connectorId) => {
+        const connector = await port.cancelConnectorAuthorization(connectorId);
+        if (connector) {
+            updateConnector(connector);
+            setCancelFailed((curr) => {
+                if (curr[connectorId] === undefined)
+                    return curr;
+                const next = { ...curr };
+                delete next[connectorId];
+                return next;
+            });
+            setAuthError((curr) => {
+                if (curr[connectorId] === undefined)
+                    return curr;
+                const next = { ...curr };
+                delete next[connectorId];
+                return next;
+            });
+            setPending((curr) => clearConnectorAuthorizationPending(curr, connectorId));
+            return;
+        }
+        try {
+            const statuses = await reloadStatuses();
+            if (statuses[connectorId]?.status === 'connected')
+                return;
+        }
+        catch {
+            // Keep the local failure visible when the status refresh itself fails.
+        }
+        setCancelFailed((curr) => ({ ...curr, [connectorId]: true }));
+    }, [port, updateConnector, reloadStatuses]);
+    return { pending, cancelFailed, authError, pendingConnectorAction, reloadStatuses, runConnectorAction, cancelAuthorization };
+}
+//# sourceMappingURL=useConnectorAuthorization.js.map

package/dist/features/connectors/hooks/useConnectorAuthorization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectorAuthorization.js","sourceRoot":"","sources":["../../../../src/features/connectors/hooks/useConnectorAuthorization.ts"],"names":[],"mappings":"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"}

package/dist/features/connectors/hooks/useConnectorCatalog.d.ts

@@ -0,0 +1,24 @@
+import type { Dispatch, SetStateAction } from 'react';
+import type { ConnectorsPort } from '../ports.js';
+import type { Connector } from '../types.js';
+export interface ConnectorCatalogOptions {
+    /** Whether the host's provider is configured (e.g. an API key is saved) — gates lazy enrichment. */
+    unlocked: boolean;
+    /** Bump to force both the base catalog and the enrichment pass to re-run. */
+    refreshKey?: string | number;
+}
+export interface ConnectorCatalogController {
+    connectors: Connector[];
+    setConnectors: Dispatch<SetStateAction<Connector[]>>;
+    loading: boolean;
+    enriching: boolean;
+    enriched: boolean;
+}
+/**
+ * Owns the connector catalog's two-phase load: an always-on lightweight
+ * fetch (so already-configured connectors render immediately), then a lazy
+ * enrichment pass gated on `unlocked` — heavier, only worth it once the
+ * host's provider is actually configured.
+ */
+export declare function useConnectorCatalog(port: ConnectorsPort, options: ConnectorCatalogOptions): ConnectorCatalogController;
+//# sourceMappingURL=useConnectorCatalog.d.ts.map

package/dist/features/connectors/hooks/useConnectorCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectorCatalog.d.ts","sourceRoot":"","sources":["../../../../src/features/connectors/hooks/useConnectorCatalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,WAAW,uBAAuB;IACtC,oGAAoG;IACpG,QAAQ,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,uBAAuB,GAAG,0BAA0B,CAgDtH"}

package/dist/features/connectors/hooks/useConnectorCatalog.js

@@ -0,0 +1,57 @@
+import { useEffect, useState } from 'react';
+import { mergeConnectors } from '../rules.js';
+/**
+ * Owns the connector catalog's two-phase load: an always-on lightweight
+ * fetch (so already-configured connectors render immediately), then a lazy
+ * enrichment pass gated on `unlocked` — heavier, only worth it once the
+ * host's provider is actually configured.
+ */
+export function useConnectorCatalog(port, options) {
+    const { unlocked, refreshKey = 0 } = options;
+    const [connectors, setConnectors] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [enriching, setEnriching] = useState(false);
+    const [enriched, setEnriched] = useState(false);
+    useEffect(() => {
+        let cancelled = false;
+        setLoading(true);
+        setEnriched(false);
+        (async () => {
+            const next = await port.fetchConnectors();
+            if (cancelled)
+                return;
+            setConnectors((curr) => mergeConnectors(curr, next));
+            setLoading(false);
+        })();
+        return () => {
+            cancelled = true;
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [unlocked, refreshKey]);
+    useEffect(() => {
+        if (!unlocked || !port.fetchConnectorEnrichment) {
+            setEnriched(false);
+            setEnriching(false);
+            return;
+        }
+        if (enriched)
+            return;
+        let cancelled = false;
+        setEnriching(true);
+        (async () => {
+            const next = await port.fetchConnectorEnrichment({ refresh: true });
+            if (cancelled)
+                return;
+            setConnectors((curr) => mergeConnectors(curr, next));
+            setEnriched(true);
+            setEnriching(false);
+        })();
+        return () => {
+            cancelled = true;
+            setEnriching(false);
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [unlocked, refreshKey, enriched]);
+    return { connectors, setConnectors, loading, enriching, enriched };
+}
+//# sourceMappingURL=useConnectorCatalog.js.map

package/dist/features/connectors/hooks/useConnectorCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectorCatalog.js","sourceRoot":"","sources":["../../../../src/features/connectors/hooks/useConnectorCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAI5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAiB9C;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAoB,EAAE,OAAgC;IACxF,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAc,EAAE,CAAC,CAAC;IAC9D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,KAAK,IAAI,EAAE;YACV,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,IAAI,SAAS;gBAAE,OAAO;YACtB,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACrD,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;QACF,uDAAuD;IACzD,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IAE3B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAChD,WAAW,CAAC,KAAK,CAAC,CAAC;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,QAAQ;YAAE,OAAO;QAErB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC,KAAK,IAAI,EAAE;YACV,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,wBAAyB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACrE,IAAI,SAAS;gBAAE,OAAO;YACtB,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACrD,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC;QACF,uDAAuD;IACzD,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IAErC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACrE,CAAC"}

package/dist/features/connectors/hooks/useConnectorDetail.d.ts

@@ -0,0 +1,25 @@
+import type { Dispatch, SetStateAction } from 'react';
+import type { ConnectorsPort } from '../ports.js';
+import type { Connector } from '../types.js';
+export interface UseConnectorDetailParams {
+    connectors: Connector[];
+    setConnectors: Dispatch<SetStateAction<Connector[]>>;
+    /** Gates tool-preview hydration (e.g. the host's provider must be configured). */
+    unlocked: boolean;
+    /** Changes whenever a previously-failed preview fetch should be retried (e.g. catalog refresh). */
+    retryToken: string;
+    /** Page size requested per tool-preview fetch. Defaults to {@link CONNECTOR_TOOL_PREVIEW_LIMIT}. */
+    toolsLimit?: number;
+}
+export interface ConnectorDetailController {
+    detailConnectorId: string | null;
+    detailConnector: Connector | null;
+    toolPreviewLoading: boolean;
+    toolsLoaded: boolean;
+    openDetails: (connectorId: string) => void;
+    closeDetails: () => void;
+    loadMoreTools: (connectorId: string, cursor?: string) => Promise<void>;
+}
+/** Owns the detail drawer's open/close state and its paginated tool-preview hydration. */
+export declare function useConnectorDetail(port: ConnectorsPort, params: UseConnectorDetailParams): ConnectorDetailController;
+//# sourceMappingURL=useConnectorDetail.d.ts.map

package/dist/features/connectors/hooks/useConnectorDetail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectorDetail.d.ts","sourceRoot":"","sources":["../../../../src/features/connectors/hooks/useConnectorDetail.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACrD,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;IAClB,mGAAmG;IACnG,UAAU,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,EAAE,SAAS,GAAG,IAAI,CAAC;IAClC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,wBAAwB,GAAG,yBAAyB,CAkFpH"}

package/dist/features/connectors/hooks/useConnectorDetail.js

@@ -0,0 +1,88 @@
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { hasLoadedAllAdvertisedConnectorTools, mergeConnectorToolPreview } from '../rules.js';
+import { CONNECTOR_TOOL_PREVIEW_LIMIT } from '../constants.js';
+/** Owns the detail drawer's open/close state and its paginated tool-preview hydration. */
+export function useConnectorDetail(port, params) {
+    const { connectors, setConnectors, unlocked, retryToken, toolsLimit = CONNECTOR_TOOL_PREVIEW_LIMIT } = params;
+    const [detailConnectorId, setDetailConnectorId] = useState(null);
+    const [loadingIds, setLoadingIds] = useState({});
+    const [fetchedIds, setFetchedIds] = useState({});
+    const [failedIds, setFailedIds] = useState({});
+    const detailConnector = useMemo(() => (detailConnectorId ? connectors.find((c) => c.id === detailConnectorId) ?? null : null), [detailConnectorId, connectors]);
+    const hydrateToolPreview = useCallback(async (connectorId, cursor) => {
+        if (!unlocked)
+            return;
+        if (loadingIds[connectorId])
+            return;
+        setLoadingIds((curr) => ({ ...curr, [connectorId]: true }));
+        try {
+            const next = await port.fetchConnectorDetail(connectorId, {
+                hydrateTools: true,
+                toolsLimit,
+                ...(cursor === undefined ? {} : { toolsCursor: cursor }),
+            });
+            if (next) {
+                setConnectors((curr) => curr.map((c) => (c.id === next.id ? mergeConnectorToolPreview(c, next, cursor !== undefined) : c)));
+                setFetchedIds((curr) => ({ ...curr, [connectorId]: true }));
+                setFailedIds((curr) => {
+                    if (curr[connectorId] === undefined)
+                        return curr;
+                    const nextFailed = { ...curr };
+                    delete nextFailed[connectorId];
+                    return nextFailed;
+                });
+            }
+            else {
+                setFailedIds((curr) => ({ ...curr, [connectorId]: retryToken }));
+            }
+        }
+        catch {
+            setFailedIds((curr) => ({ ...curr, [connectorId]: retryToken }));
+        }
+        finally {
+            setLoadingIds((curr) => ({ ...curr, [connectorId]: false }));
+        }
+    }, [unlocked, loadingIds, port, setConnectors, retryToken, toolsLimit]);
+    useEffect(() => {
+        if (!detailConnector)
+            return;
+        if (!unlocked)
+            return;
+        if (hasLoadedAllAdvertisedConnectorTools(detailConnector))
+            return;
+        if (fetchedIds[detailConnector.id])
+            return;
+        if (failedIds[detailConnector.id] === retryToken)
+            return;
+        if (loadingIds[detailConnector.id])
+            return;
+        void hydrateToolPreview(detailConnector.id);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [unlocked, detailConnector, failedIds, fetchedIds, loadingIds, retryToken]);
+    const openDetails = useCallback((connectorId) => {
+        setFailedIds((curr) => {
+            if (curr[connectorId] === undefined)
+                return curr;
+            const next = { ...curr };
+            delete next[connectorId];
+            return next;
+        });
+        setDetailConnectorId(connectorId);
+    }, []);
+    const closeDetails = useCallback(() => setDetailConnectorId(null), []);
+    const toolsLoaded = detailConnector
+        ? Boolean(fetchedIds[detailConnector.id]) ||
+            failedIds[detailConnector.id] === retryToken ||
+            hasLoadedAllAdvertisedConnectorTools(detailConnector)
+        : false;
+    return {
+        detailConnectorId,
+        detailConnector,
+        toolPreviewLoading: detailConnector ? Boolean(loadingIds[detailConnector.id]) : false,
+        toolsLoaded,
+        openDetails,
+        closeDetails,
+        loadMoreTools: hydrateToolPreview,
+    };
+}
+//# sourceMappingURL=useConnectorDetail.js.map