@stigmer/react 0.0.36 → 0.0.40

package/github/GitHubRepoPicker.js

@@ -0,0 +1,248 @@
+"use client";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback, useEffect, useRef, useMemo, } from "react";
+import { useGitHubRepos } from "./useGitHubRepos";
+const RECENT_REPOS_KEY = "stigmer:github:recent-repos";
+const MAX_RECENT = 3;
+function getRecentRepos() {
+    try {
+        const stored = localStorage.getItem(RECENT_REPOS_KEY);
+        return stored ? JSON.parse(stored) : [];
+    }
+    catch {
+        return [];
+    }
+}
+function addRecentRepo(repo) {
+    const current = getRecentRepos().filter((r) => !(r.owner === repo.owner && r.name === repo.name));
+    const updated = [repo, ...current].slice(0, MAX_RECENT);
+    localStorage.setItem(RECENT_REPOS_KEY, JSON.stringify(updated));
+}
+function groupRepos(filteredRepos, recentEntries) {
+    const groups = [];
+    const repoLookup = new Map(filteredRepos.map((r) => [`${r.owner}/${r.name}`, r]));
+    // Recent group — only include entries that exist in the filtered set
+    const recentMatched = recentEntries
+        .map((r) => repoLookup.get(`${r.owner}/${r.name}`))
+        .filter((r) => r !== undefined);
+    if (recentMatched.length > 0) {
+        groups.push({
+            key: "recent",
+            label: "Recent",
+            isRecent: true,
+            repos: recentMatched,
+        });
+    }
+    // Owner groups — personal (User) repos first, then orgs by repo count
+    const ownerMap = new Map();
+    for (const repo of filteredRepos) {
+        const existing = ownerMap.get(repo.owner);
+        if (existing) {
+            existing.repos.push(repo);
+        }
+        else {
+            ownerMap.set(repo.owner, { ownerType: repo.ownerType, repos: [repo] });
+        }
+    }
+    const sortedOwners = [...ownerMap.entries()].sort(([, a], [, b]) => {
+        if (a.ownerType !== b.ownerType)
+            return a.ownerType === "User" ? -1 : 1;
+        return b.repos.length - a.repos.length;
+    });
+    for (const [owner, { repos }] of sortedOwners) {
+        groups.push({ key: owner, label: owner, isRecent: false, repos });
+    }
+    return groups;
+}
+// ---------------------------------------------------------------------------
+// Search highlighting
+// ---------------------------------------------------------------------------
+function HighlightMatch({ text, query }) {
+    if (!query)
+        return _jsx(_Fragment, { children: text });
+    const idx = text.toLowerCase().indexOf(query.toLowerCase());
+    if (idx === -1)
+        return _jsx(_Fragment, { children: text });
+    return (_jsxs(_Fragment, { children: [text.slice(0, idx), _jsx("span", { className: "text-foreground font-medium", children: text.slice(idx, idx + query.length) }), text.slice(idx + query.length)] }));
+}
+// ---------------------------------------------------------------------------
+// Main component
+// ---------------------------------------------------------------------------
+const LIST_ID = "stgm-repo-list";
+/**
+ * Styled component for browsing and selecting a GitHub repository.
+ *
+ * Features:
+ * - Owner-grouped sections (personal repos first, then orgs)
+ * - Recently selected repos pinned at top
+ * - Fixed 300px max-height with scroll shadow indicators
+ * - Keyboard navigation (Arrow keys, Enter, Escape)
+ * - Search with match highlighting
+ * - Branch selector after repo selection
+ *
+ * All visual properties flow through `--stgm-*` tokens.
+ */
+export function GitHubRepoPicker({ token, onSelect, onCancel, className, }) {
+    const { repos, isLoading, isBackgroundLoading, error, search, setSearch, fetchBranches, } = useGitHubRepos(token);
+    // Branch selection state
+    const [selectedRepo, setSelectedRepo] = useState(null);
+    const [branches, setBranches] = useState([]);
+    const [selectedBranch, setSelectedBranch] = useState("");
+    const [loadingBranches, setLoadingBranches] = useState(false);
+    // Keyboard navigation
+    const [focusIndex, setFocusIndex] = useState(-1);
+    const listRef = useRef(null);
+    const searchRef = useRef(null);
+    // Scroll shadow state
+    const [canScrollUp, setCanScrollUp] = useState(false);
+    const [canScrollDown, setCanScrollDown] = useState(false);
+    // Recent repos
+    const [recentRepos, setRecentRepos] = useState(getRecentRepos);
+    // Group and flatten repos for rendering + keyboard nav
+    const groups = useMemo(() => groupRepos(repos, recentRepos), [repos, recentRepos]);
+    const flatItems = useMemo(() => {
+        const items = [];
+        for (const group of groups) {
+            for (const repo of group.repos) {
+                items.push(repo);
+            }
+        }
+        return items;
+    }, [groups]);
+    // Reset focus index when search changes
+    useEffect(() => {
+        setFocusIndex(-1);
+    }, [search]);
+    // Scroll focused item into view
+    useEffect(() => {
+        if (focusIndex >= 0) {
+            const el = listRef.current?.querySelector(`[data-idx="${focusIndex}"]`);
+            el?.scrollIntoView({ block: "nearest" });
+        }
+    }, [focusIndex]);
+    // Scroll shadow tracking
+    const updateScrollShadows = useCallback(() => {
+        const el = listRef.current;
+        if (!el)
+            return;
+        setCanScrollUp(el.scrollTop > 0);
+        setCanScrollDown(el.scrollTop + el.clientHeight < el.scrollHeight - 1);
+    }, []);
+    useEffect(() => {
+        const el = listRef.current;
+        if (!el)
+            return;
+        el.addEventListener("scroll", updateScrollShadows, { passive: true });
+        updateScrollShadows();
+        return () => el.removeEventListener("scroll", updateScrollShadows);
+    }, [updateScrollShadows]);
+    // Re-check shadows when repo data changes
+    useEffect(() => {
+        updateScrollShadows();
+    }, [repos, updateScrollShadows]);
+    const handleRepoClick = useCallback(async (repo) => {
+        setSelectedRepo({
+            owner: repo.owner,
+            name: repo.name,
+            cloneUrl: repo.cloneUrl,
+            defaultBranch: repo.defaultBranch,
+        });
+        setSelectedBranch(repo.defaultBranch);
+        setLoadingBranches(true);
+        const b = await fetchBranches(repo.owner, repo.name);
+        setBranches(b);
+        setLoadingBranches(false);
+    }, [fetchBranches]);
+    const handleAdd = useCallback(() => {
+        if (selectedRepo && selectedBranch) {
+            addRecentRepo({
+                owner: selectedRepo.owner,
+                name: selectedRepo.name,
+                cloneUrl: selectedRepo.cloneUrl,
+                defaultBranch: selectedRepo.defaultBranch,
+            });
+            setRecentRepos(getRecentRepos());
+            onSelect(selectedRepo.cloneUrl, selectedBranch);
+            setSelectedRepo(null);
+            setBranches([]);
+            setSelectedBranch("");
+        }
+    }, [selectedRepo, selectedBranch, onSelect]);
+    // Combobox keyboard handler — all keyboard interaction goes through the
+    // search input so focus never leaves it.
+    const handleSearchKeyDown = useCallback((e) => {
+        if (e.key === "ArrowDown") {
+            e.preventDefault();
+            setFocusIndex((prev) => prev < flatItems.length - 1 ? prev + 1 : prev);
+        }
+        else if (e.key === "ArrowUp") {
+            e.preventDefault();
+            setFocusIndex((prev) => (prev > 0 ? prev - 1 : -1));
+        }
+        else if (e.key === "Enter" &&
+            focusIndex >= 0 &&
+            focusIndex < flatItems.length) {
+            e.preventDefault();
+            handleRepoClick(flatItems[focusIndex]);
+        }
+        else if (e.key === "Enter") {
+            // Prevent form submission when no item is focused
+            e.preventDefault();
+        }
+        else if (e.key === "Escape") {
+            e.preventDefault();
+            if (search) {
+                setSearch("");
+                setFocusIndex(-1);
+            }
+            else {
+                onCancel?.();
+            }
+        }
+    }, [flatItems, focusIndex, handleRepoClick, onCancel, search, setSearch]);
+    // --- Branch selection view ---
+    if (selectedRepo) {
+        return (_jsxs("div", { className: ["space-y-2", className].filter(Boolean).join(" "), children: [_jsxs("div", { className: "flex items-center gap-2 text-xs text-foreground", children: [_jsx("button", { type: "button", onClick: () => {
+                                setSelectedRepo(null);
+                                setBranches([]);
+                                // Restore focus to search
+                                setTimeout(() => searchRef.current?.focus(), 0);
+                            }, className: "text-muted-foreground hover:text-foreground transition-colors", "aria-label": "Back to repo list", children: _jsx(ChevronLeftIcon, {}) }), _jsxs("span", { className: "font-medium truncate", children: [selectedRepo.owner, "/", selectedRepo.name] })] }), _jsxs("div", { className: "space-y-1.5", children: [_jsx("label", { className: "text-[0.65rem] text-muted-foreground", children: "Branch" }), loadingBranches ? (_jsx("div", { className: "text-xs text-muted-foreground", children: "Loading branches..." })) : (_jsx("select", { value: selectedBranch, onChange: (e) => setSelectedBranch(e.target.value), className: "w-full rounded-md border border-input bg-background px-2.5 py-1.5 text-xs text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: branches.map((b) => (_jsx("option", { value: b.name, children: b.name }, b.name))) }))] }), _jsx("div", { className: "flex justify-end", children: _jsx("button", { type: "button", onClick: handleAdd, disabled: !selectedBranch, className: "rounded-md bg-primary px-2.5 py-1 text-xs text-primary-foreground hover:bg-primary/90 transition-colors disabled:opacity-40", children: "Add" }) })] }));
+    }
+    // --- Compute flat index offsets per group for rendering ---
+    let runningIndex = 0;
+    const groupOffsets = groups.map((g) => {
+        const offset = runningIndex;
+        runningIndex += g.repos.length;
+        return offset;
+    });
+    // --- Main repo list view ---
+    return (_jsxs("div", { className: ["space-y-1.5", className].filter(Boolean).join(" "), children: [_jsx("input", { ref: searchRef, type: "text", role: "combobox", "aria-expanded": true, "aria-controls": LIST_ID, "aria-activedescendant": focusIndex >= 0 ? `stgm-repo-${focusIndex}` : undefined, placeholder: "Search repositories...", value: search, onChange: (e) => setSearch(e.target.value), onKeyDown: handleSearchKeyDown, className: "w-full rounded-md border border-input bg-background px-2.5 py-1.5 text-xs text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", autoFocus: true }), error && (_jsx("p", { className: "text-xs text-destructive", children: error })), _jsxs("div", { className: "relative", children: [canScrollUp && (_jsx("div", { className: "absolute inset-x-0 top-0 h-3 z-10 pointer-events-none", style: {
+                            background: "linear-gradient(to bottom, var(--color-card, hsl(0 0% 9%)), transparent)",
+                        } })), _jsx("div", { ref: listRef, id: LIST_ID, role: "listbox", "aria-label": "Repositories", className: "max-h-64 overflow-y-auto", children: isLoading ? (_jsx(LoadingSkeleton, {})) : flatItems.length === 0 ? (_jsx("div", { className: "py-4 text-center text-xs text-muted-foreground", children: search
+                                ? "No repos match your search"
+                                : "No repositories found" })) : (_jsxs(_Fragment, { children: [groups.map((group, gi) => (_jsxs("div", { children: [_jsxs("div", { className: "sticky top-0 z-[1] bg-card/95 px-2 py-1 text-[0.65rem] font-medium text-muted-foreground backdrop-blur-sm", children: [group.label, !group.isRecent && (_jsxs("span", { className: "ml-1 opacity-50", children: ["(", group.repos.length, ")"] }))] }), group.repos.map((repo, ri) => {
+                                            const flatIdx = groupOffsets[gi] + ri;
+                                            return (_jsxs("button", { id: `stgm-repo-${flatIdx}`, type: "button", "data-idx": flatIdx, onClick: () => handleRepoClick(repo), className: [
+                                                    "flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-xs transition-colors",
+                                                    flatIdx === focusIndex
+                                                        ? "bg-accent text-foreground"
+                                                        : "text-foreground hover:bg-accent/50",
+                                                ].join(" "), role: "option", "aria-selected": flatIdx === focusIndex, children: [_jsx("span", { className: "min-w-0 flex-1 truncate", children: group.isRecent ? (_jsx(HighlightMatch, { text: repo.fullName, query: search })) : (_jsx(HighlightMatch, { text: repo.name, query: search })) }), _jsx("span", { className: "shrink-0 rounded px-1 py-0.5 text-[0.6rem] bg-muted text-muted-foreground", children: repo.isPrivate ? "private" : "public" })] }, `${group.key}-${repo.id}`));
+                                        })] }, group.key))), isBackgroundLoading && (_jsx("div", { className: "py-1 text-center text-[0.6rem] text-muted-foreground", children: "Loading more..." }))] })) }), canScrollDown && (_jsx("div", { className: "absolute inset-x-0 bottom-0 h-3 z-10 pointer-events-none", style: {
+                            background: "linear-gradient(to top, var(--color-card, hsl(0 0% 9%)), transparent)",
+                        } }))] })] }));
+}
+// ---------------------------------------------------------------------------
+// Loading skeleton
+// ---------------------------------------------------------------------------
+function LoadingSkeleton() {
+    return (_jsxs("div", { className: "space-y-1 py-1", children: [_jsx("div", { className: "px-2 py-1", children: _jsx("div", { className: "h-2.5 w-16 rounded bg-muted animate-pulse" }) }), [55, 70, 40, 62].map((w, i) => (_jsx("div", { className: "flex items-center gap-2 px-2 py-1.5", children: _jsx("div", { className: "h-3 rounded bg-muted animate-pulse", style: { width: `${w}%` } }) }, i))), _jsx("div", { className: "px-2 py-1", children: _jsx("div", { className: "h-2.5 w-20 rounded bg-muted animate-pulse" }) }), [48, 65, 53].map((w, i) => (_jsx("div", { className: "flex items-center gap-2 px-2 py-1.5", children: _jsx("div", { className: "h-3 rounded bg-muted animate-pulse", style: { width: `${w}%` } }) }, i + 4)))] }));
+}
+// ---------------------------------------------------------------------------
+// Icons
+// ---------------------------------------------------------------------------
+function ChevronLeftIcon() {
+    return (_jsx("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M9 3L5 7L9 11" }) }));
+}
+//# sourceMappingURL=GitHubRepoPicker.js.map

package/github/GitHubRepoPicker.js.map

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

package/github/index.d.ts

@@ -0,0 +1,4 @@
+export { useGitHubConnection, GITHUB_CALLBACK_MESSAGE_TYPE, type GitHubUser, type GitHubConnectOptions, type UseGitHubConnectionReturn, } from "./useGitHubConnection";
+export { useGitHubRepos, type GitHubRepo, type GitHubBranch, type UseGitHubReposReturn, } from "./useGitHubRepos";
+export { GitHubRepoPicker, type GitHubRepoPickerProps, } from "./GitHubRepoPicker";
+//# sourceMappingURL=index.d.ts.map

package/github/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC"}

package/github/index.js

@@ -0,0 +1,4 @@
+export { useGitHubConnection, GITHUB_CALLBACK_MESSAGE_TYPE, } from "./useGitHubConnection";
+export { useGitHubRepos, } from "./useGitHubRepos";
+export { GitHubRepoPicker, } from "./GitHubRepoPicker";
+//# sourceMappingURL=index.js.map

package/github/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAI7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,GAIf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC"}

package/github/useGitHubConnection.d.ts

@@ -0,0 +1,72 @@
+/** Message type sent from the OAuth callback popup to the opener. */
+export declare const GITHUB_CALLBACK_MESSAGE_TYPE = "stigmer:github:callback-success";
+/** Minimal GitHub user profile for display. */
+export interface GitHubUser {
+    readonly login: string;
+    readonly avatarUrl: string;
+    readonly name: string | null;
+}
+export interface GitHubConnectOptions {
+    /**
+     * When `true`, open the OAuth authorization page in a popup window
+     * instead of redirecting the current page. The callback page signals
+     * success via `postMessage` and the hook re-reconciles the token
+     * from the personal environment — keeping the user on the same page.
+     *
+     * Falls back to redirect if the popup is blocked by the browser.
+     *
+     * @default false
+     */
+    readonly popup?: boolean;
+}
+export interface UseGitHubConnectionReturn {
+    /** Whether a valid GitHub token exists. */
+    readonly isConnected: boolean;
+    /** Whether the connection state is being validated on mount. */
+    readonly isLoading: boolean;
+    /** Whether an OAuth popup is open and the flow is in progress. */
+    readonly isConnecting: boolean;
+    /**
+     * Whether the last popup `connect()` attempt was blocked by the
+     * browser. When `true`, the UI should prompt the user to allow
+     * popups or offer a redirect fallback (call `connect` without
+     * `{ popup: true }`).
+     */
+    readonly popupBlocked: boolean;
+    /** The connected GitHub user profile, if connected. */
+    readonly user: GitHubUser | null;
+    /** The current access token (null if not connected). */
+    readonly token: string | null;
+    /** Initiate the OAuth flow — redirect or popup based on options. */
+    readonly connect: (redirectUri: string, options?: GitHubConnectOptions) => Promise<void>;
+    /** Handle the OAuth callback — exchange code for token. */
+    readonly handleCallback: (code: string, state: string, redirectUri: string) => Promise<void>;
+    /** Clear the stored token and user info. */
+    readonly disconnect: () => void;
+}
+/**
+ * Behavior hook that manages the GitHub OAuth connection lifecycle.
+ *
+ * Handles the full OAuth flow: generating the authorize URL via the
+ * Stigmer backend, exchanging the code for a token, validating it,
+ * and persisting it in the user's server-side personal
+ * {@link Environment}.
+ *
+ * **Storage strategy:** The token is stored encrypted in the personal
+ * environment (server-side). On OAuth callback the token is written
+ * directly to the personal environment via `getOrCreate` /
+ * `addVariables`. On subsequent mounts the token is revealed from the
+ * personal environment and validated against the GitHub API.
+ *
+ * Pass `null` as `org` to disable server-side storage (the hook will
+ * report as not connected until org context is available).
+ *
+ * Platform builders who need custom GitHub integration UI use this
+ * hook directly. The styled `WorkspaceEditor` component accepts the
+ * return value as a prop.
+ *
+ * @param org - The active organization slug. Required for server-side
+ *   token storage. Pass `null` to skip all server operations.
+ */
+export declare function useGitHubConnection(org: string | null): UseGitHubConnectionReturn;
+//# sourceMappingURL=useGitHubConnection.d.ts.map

package/github/useGitHubConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGitHubConnection.d.ts","sourceRoot":"","sources":["../../src/github/useGitHubConnection.ts"],"names":[],"mappings":"AAYA,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,oCAAoC,CAAC;AAM9E,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,CAChB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,oBAAoB,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,EAAE,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AA8BD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,yBAAyB,CAgP3B"}

package/github/useGitHubConnection.js

@@ -0,0 +1,268 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { EnvironmentSecretValueInputSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { usePersonalEnvironment } from "../environment/usePersonalEnvironment";
+const STORAGE_KEY_STATE = "stigmer:github:oauth-state";
+const GITHUB_USER_API = "https://api.github.com/user";
+const GITHUB_TOKEN_KEY = "GITHUB_TOKEN";
+/** Message type sent from the OAuth callback popup to the opener. */
+export const GITHUB_CALLBACK_MESSAGE_TYPE = "stigmer:github:callback-success";
+const POPUP_WIDTH = 600;
+const POPUP_HEIGHT = 700;
+const POPUP_CLOSE_POLL_MS = 500;
+async function fetchGitHubUser(token) {
+    try {
+        const resp = await fetch(GITHUB_USER_API, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!resp.ok)
+            return null;
+        const data = await resp.json();
+        return {
+            login: data.login,
+            avatarUrl: data.avatar_url,
+            name: data.name ?? null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Checks whether the personal environment's redacted data contains a given key.
+ * The key is present even when the value is redacted (`***REDACTED***`).
+ */
+function personalEnvHasKey(env, key) {
+    return env?.spec?.data != null && key in env.spec.data;
+}
+/**
+ * Behavior hook that manages the GitHub OAuth connection lifecycle.
+ *
+ * Handles the full OAuth flow: generating the authorize URL via the
+ * Stigmer backend, exchanging the code for a token, validating it,
+ * and persisting it in the user's server-side personal
+ * {@link Environment}.
+ *
+ * **Storage strategy:** The token is stored encrypted in the personal
+ * environment (server-side). On OAuth callback the token is written
+ * directly to the personal environment via `getOrCreate` /
+ * `addVariables`. On subsequent mounts the token is revealed from the
+ * personal environment and validated against the GitHub API.
+ *
+ * Pass `null` as `org` to disable server-side storage (the hook will
+ * report as not connected until org context is available).
+ *
+ * Platform builders who need custom GitHub integration UI use this
+ * hook directly. The styled `WorkspaceEditor` component accepts the
+ * return value as a prop.
+ *
+ * @param org - The active organization slug. Required for server-side
+ *   token storage. Pass `null` to skip all server operations.
+ */
+export function useGitHubConnection(org) {
+    const stigmer = useStigmer();
+    const [token, setToken] = useState(null);
+    const [user, setUser] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [isConnecting, setIsConnecting] = useState(false);
+    const [popupBlocked, setPopupBlocked] = useState(false);
+    const personalEnv = usePersonalEnvironment(org || null);
+    const personalEnvRef = useRef(personalEnv);
+    personalEnvRef.current = personalEnv;
+    const reconciled = useRef(false);
+    const popupRef = useRef(null);
+    const popupPollRef = useRef(null);
+    // Synchronously reset loading state when org changes so callers
+    // (like the callback page) see the correct value in the same
+    // render — not deferred to the next render via an effect.
+    const [prevOrg, setPrevOrg] = useState(org);
+    if (org !== prevOrg) {
+        setPrevOrg(org);
+        setIsLoading(!!org);
+        reconciled.current = false;
+    }
+    // ── Server reconciliation ────────────────────────────────────────────
+    // Runs once after the personal environment finishes loading.
+    // If GITHUB_TOKEN exists in the personal env, reveals it and sets
+    // React state. If the revealed token is invalid, cleans it up.
+    // If no token exists, marks the hook as not connected.
+    useEffect(() => {
+        if (!org || personalEnv.isLoading)
+            return;
+        if (reconciled.current)
+            return;
+        reconciled.current = true;
+        const env = personalEnv.environment;
+        const hasServerToken = personalEnvHasKey(env, GITHUB_TOKEN_KEY);
+        if (!hasServerToken || !env) {
+            setIsLoading(false);
+            return;
+        }
+        let cancelled = false;
+        async function reveal() {
+            try {
+                const result = await stigmer.environment.getSecretValue(create(EnvironmentSecretValueInputSchema, {
+                    environmentId: env.metadata.id,
+                    key: GITHUB_TOKEN_KEY,
+                }));
+                if (cancelled)
+                    return;
+                const serverToken = result.value;
+                if (serverToken) {
+                    const u = await fetchGitHubUser(serverToken);
+                    if (cancelled)
+                        return;
+                    if (u) {
+                        setToken(serverToken);
+                        setUser(u);
+                    }
+                    else {
+                        try {
+                            await personalEnvRef.current.removeVariables([
+                                GITHUB_TOKEN_KEY,
+                            ]);
+                        }
+                        catch {
+                            // Best-effort cleanup.
+                        }
+                        setToken(null);
+                        setUser(null);
+                    }
+                }
+            }
+            catch {
+                // getSecretValue failed — leave state as-is.
+            }
+            if (!cancelled)
+                setIsLoading(false);
+        }
+        reveal();
+        return () => {
+            cancelled = true;
+        };
+    }, [org, personalEnv.isLoading, personalEnv.environment, stigmer]);
+    // ── Popup OAuth message listener ──────────────────────────────────────
+    // Listens for success signals from the OAuth callback page running
+    // in a popup window. On success, triggers re-reconciliation from the
+    // personal environment (where the popup already persisted the token).
+    useEffect(() => {
+        function handleMessage(event) {
+            if (event.origin !== window.location.origin)
+                return;
+            if (event.data?.type !== GITHUB_CALLBACK_MESSAGE_TYPE)
+                return;
+            if (popupPollRef.current) {
+                clearInterval(popupPollRef.current);
+                popupPollRef.current = null;
+            }
+            popupRef.current = null;
+            setIsConnecting(false);
+            // Re-reconcile: the popup persisted the token server-side, so
+            // refetch the personal environment and let the reconciliation
+            // effect reveal and validate it.
+            setIsLoading(true);
+            reconciled.current = false;
+            personalEnvRef.current.refetch();
+        }
+        window.addEventListener("message", handleMessage);
+        return () => window.removeEventListener("message", handleMessage);
+    }, []);
+    // Clean up popup resources on unmount.
+    useEffect(() => {
+        return () => {
+            if (popupPollRef.current) {
+                clearInterval(popupPollRef.current);
+            }
+        };
+    }, []);
+    const connect = useCallback(async (redirectUri, options) => {
+        const { authorizeUrl, state } = await stigmer.github.getOAuthAuthorizeUrl({ redirectUri });
+        sessionStorage.setItem(STORAGE_KEY_STATE, state);
+        if (!options?.popup) {
+            window.location.href = authorizeUrl;
+            return;
+        }
+        // If a popup is already open, bring it to focus.
+        if (popupRef.current && !popupRef.current.closed) {
+            popupRef.current.focus();
+            return;
+        }
+        const left = window.screenX + (window.outerWidth - POPUP_WIDTH) / 2;
+        const top = window.screenY + (window.outerHeight - POPUP_HEIGHT) / 2;
+        const popup = window.open(authorizeUrl, "stigmer-github-auth", `width=${POPUP_WIDTH},height=${POPUP_HEIGHT},left=${left},top=${top},popup=yes`);
+        if (!popup || popup.closed) {
+            setPopupBlocked(true);
+            return;
+        }
+        setPopupBlocked(false);
+        setIsConnecting(true);
+        popupRef.current = popup;
+        const pollId = setInterval(() => {
+            if (!popup.closed)
+                return;
+            clearInterval(pollId);
+            if (popupPollRef.current === pollId) {
+                popupPollRef.current = null;
+                popupRef.current = null;
+                setIsConnecting(false);
+            }
+        }, POPUP_CLOSE_POLL_MS);
+        popupPollRef.current = pollId;
+    }, [stigmer]);
+    const handleCallback = useCallback(async (code, state, redirectUri) => {
+        const savedState = sessionStorage.getItem(STORAGE_KEY_STATE);
+        if (savedState && savedState !== state) {
+            throw new Error("OAuth state mismatch — possible CSRF attack");
+        }
+        sessionStorage.removeItem(STORAGE_KEY_STATE);
+        const { accessToken } = await stigmer.github.exchangeOAuthCode({
+            code,
+            state,
+            redirectUri,
+        });
+        const tokenVar = {
+            [GITHUB_TOKEN_KEY]: { value: accessToken, isSecret: true },
+        };
+        const env = await personalEnvRef.current.getOrCreate(tokenVar);
+        if (!personalEnvHasKey(env, GITHUB_TOKEN_KEY)) {
+            await personalEnvRef.current.addVariables(tokenVar);
+        }
+        setToken(accessToken);
+        const u = await fetchGitHubUser(accessToken);
+        setUser(u);
+    }, [stigmer]);
+    const disconnect = useCallback(() => {
+        sessionStorage.removeItem(STORAGE_KEY_STATE);
+        setToken(null);
+        setUser(null);
+        if (popupRef.current && !popupRef.current.closed) {
+            popupRef.current.close();
+        }
+        popupRef.current = null;
+        if (popupPollRef.current) {
+            clearInterval(popupPollRef.current);
+            popupPollRef.current = null;
+        }
+        setIsConnecting(false);
+        const env = personalEnvRef.current.environment;
+        if (env && personalEnvHasKey(env, GITHUB_TOKEN_KEY)) {
+            personalEnvRef.current
+                .removeVariables([GITHUB_TOKEN_KEY])
+                .catch(() => { });
+        }
+    }, []);
+    return {
+        isConnected: token !== null,
+        isLoading,
+        isConnecting,
+        popupBlocked,
+        user,
+        token,
+        connect,
+        handleCallback,
+        disconnect,
+    };
+}
+//# sourceMappingURL=useGitHubConnection.js.map