@meetreeve/ui 0.9.0 → 0.10.0

package/dist/index.mjs

@@ -1372,7 +1372,17 @@ var DEFAULT_GRANTS_LOAD_ERROR = "Couldn't load sharing. Please try again.";
 var DEFAULT_GRANT_ERROR = "Couldn't share. Please try again.";
 var DEFAULT_REVOKE_ERROR = "Couldn't revoke access. Please try again.";
 var DEFAULT_ORG_DISABLED_REASON = "Org-wide connections aren't available to you.";
+var DEFAULT_CREDENTIAL_ERROR = "Couldn't save that credential. Please try again.";
+var DEFAULT_CREDENTIAL_TEST_ERROR = "Couldn't test that credential. Please try again.";
+var UNVERIFIABLE_CREDENTIAL_NOTE = "We can't verify this automatically \u2014 saving it is safe, but nothing has checked it yet.";
 var SKELETON_COUNT = 3;
+var UNGROUNDED_PLACEHOLDER = /\{\{[^}]*\}\}/;
+function hasUngroundedPlaceholder(text) {
+  return UNGROUNDED_PLACEHOLDER.test(text);
+}
+function isDevEnvironment() {
+  return typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
+}
 function capabilityLabel(capability) {
   if (capability === "read") return "Read only";
   if (capability === "write") return "Write only";
@@ -1409,6 +1419,8 @@ function ConnectorPicker({
   const [loadError, setLoadError] = useState7(null);
   const [uiState, setUiState] = useState7({});
   const grantsSupported = typeof client.listGrants === "function" && typeof client.grant === "function" && typeof client.revokeGrant === "function";
+  const credentialsSupported = typeof client.submitCredentials === "function";
+  const credentialTestSupported = typeof client.testCredentials === "function";
   const clientRef = useRef5(client);
   clientRef.current = client;
   const purposeRef = useRef5(purpose);
@@ -1492,6 +1504,38 @@ function ConnectorPicker({
     },
     [load]
   );
+  const handleSubmitCredentials = useCallback4(
+    async (entry, values, kind) => {
+      setUiState((prev) => ({ ...prev, [entry.slug]: { kind: "connecting" } }));
+      try {
+        await clientRef.current.submitCredentials?.(entry, values, { kind });
+        const list = await load();
+        const updated = list?.find((e) => e.slug === entry.slug) ?? null;
+        setUiState((prev) => {
+          const next = { ...prev };
+          delete next[entry.slug];
+          return next;
+        });
+        if (updated?.connection.status === "connected") {
+          onConnectedRef.current?.(updated);
+        } else {
+          throw new Error(DEFAULT_CREDENTIAL_ERROR);
+        }
+      } catch (err) {
+        setUiState((prev) => {
+          const next = { ...prev };
+          delete next[entry.slug];
+          return next;
+        });
+        throw err;
+      }
+    },
+    [load]
+  );
+  const testCredentials = useCallback4(
+    (entry, values) => clientRef.current.testCredentials?.(entry, values) ?? Promise.resolve({ valid: null }),
+    []
+  );
   const handleDisconnect = useCallback4(
     async (entry) => {
       setUiState((prev) => ({ ...prev, [entry.slug]: { kind: "disconnecting" } }));
@@ -1564,8 +1608,12 @@ function ConnectorPicker({
           ui: uiState[entry.slug],
           layout,
           grantsSupported,
+          credentialsSupported,
+          credentialTestSupported,
           onConnect: handleConnect,
           onDisconnect: handleDisconnect,
+          onSubmitCredentials: handleSubmitCredentials,
+          onTestCredentials: testCredentials,
           listGrants,
           addGrant,
           revokeGrant
@@ -1583,8 +1631,12 @@ function ConnectorPicker({
           layout,
           shared: true,
           grantsSupported,
+          credentialsSupported,
+          credentialTestSupported,
           onConnect: handleConnect,
           onDisconnect: handleDisconnect,
+          onSubmitCredentials: handleSubmitCredentials,
+          onTestCredentials: testCredentials,
           listGrants,
           addGrant,
           revokeGrant
@@ -1600,8 +1652,12 @@ function ConnectorTile({
   layout,
   shared = false,
   grantsSupported,
+  credentialsSupported,
+  credentialTestSupported,
   onConnect,
   onDisconnect,
+  onSubmitCredentials,
+  onTestCredentials,
   listGrants,
   addGrant,
   revokeGrant
@@ -1612,6 +1668,11 @@ function ConnectorTile({
   const errorMessage = ui?.kind === "error" ? ui.message : null;
   const [kind, setKind] = useState7("personal");
   const [sharingOpen, setSharingOpen] = useState7(false);
+  const [setupOpen, setSetupOpen] = useState7(false);
+  const credentialFields = entry.credential_fields ?? [];
+  const pasteSupported = credentialsSupported && credentialFields.length > 0;
+  const guide = entry.guide ?? null;
+  const canSetUp = !isConnected && (pasteSupported || guide !== null);
   const orgPermitted = entry.org_connect?.permitted === true;
   const orgDisabledReason = entry.org_connect?.reason || DEFAULT_ORG_DISABLED_REASON;
   const attribution = ownerLabel(entry);
@@ -1738,18 +1799,55 @@ function ConnectorTile({
                 children: sharingOpen ? "Hide sharing" : "Manage sharing"
               }
             )
-          ] }) : /* @__PURE__ */ jsx7(
-            "button",
-            {
-              type: "button",
-              "data-testid": `connector-connect-${entry.slug}`,
-              onClick: () => onConnect(entry, kind),
-              disabled: isConnecting,
-              className: "shrink-0 rounded-md bg-primary px-2.5 py-1 text-xs font-medium text-primary-foreground disabled:opacity-50",
-              children: isConnecting ? "Connecting\u2026" : "Connect"
-            }
-          )
+          ] }) : /* @__PURE__ */ jsxs6("div", { className: "flex shrink-0 flex-col items-end gap-1", children: [
+            /* @__PURE__ */ jsx7(
+              "button",
+              {
+                type: "button",
+                "data-testid": `connector-connect-${entry.slug}`,
+                onClick: () => onConnect(entry, kind),
+                disabled: isConnecting,
+                className: "shrink-0 rounded-md bg-primary px-2.5 py-1 text-xs font-medium text-primary-foreground disabled:opacity-50",
+                children: isConnecting ? "Connecting\u2026" : "Connect"
+              }
+            ),
+            canSetUp && /* @__PURE__ */ jsx7(
+              "button",
+              {
+                type: "button",
+                "data-testid": `connector-setup-toggle-${entry.slug}`,
+                "aria-expanded": setupOpen,
+                "aria-controls": `connector-setup-panel-${entry.slug}`,
+                onClick: () => setSetupOpen((open) => !open),
+                className: "shrink-0 rounded-md px-2.5 py-1 text-xs font-medium text-muted-foreground hover:bg-foreground/10",
+                children: setupOpen ? "Hide setup" : pasteSupported ? "Use a token instead" : "Setup guide"
+              }
+            )
+          ] })
         ] }),
+        canSetUp && setupOpen && /* @__PURE__ */ jsxs6(
+          "div",
+          {
+            id: `connector-setup-panel-${entry.slug}`,
+            "data-testid": `connector-setup-panel-${entry.slug}`,
+            className: "mt-2 flex flex-col gap-3 rounded-md border border-border bg-foreground/5 p-2",
+            children: [
+              guide && /* @__PURE__ */ jsx7(SetupGuidePanel, { entry, guide, showVerify: !pasteSupported }),
+              pasteSupported && /* @__PURE__ */ jsx7(
+                CredentialForm,
+                {
+                  entry,
+                  fields: credentialFields,
+                  kind,
+                  verify: guide?.verify ?? null,
+                  testSupported: credentialTestSupported,
+                  onSubmitCredentials,
+                  onTestCredentials
+                }
+              )
+            ]
+          }
+        ),
         canManageSharing && sharingOpen && /* @__PURE__ */ jsx7(
           ManageSharing,
           {
@@ -1763,6 +1861,333 @@ function ConnectorTile({
     }
   );
 }
+function groundGuide(guide) {
+  const ungrounded = [];
+  const keep = (text) => {
+    if (!hasUngroundedPlaceholder(text)) return true;
+    ungrounded.push(text);
+    return false;
+  };
+  const prerequisites = guide.prerequisites.filter(keep);
+  const steps = guide.steps.filter(
+    (step) => keep(step.text) && (!step.copyable || keep(step.copyable))
+  );
+  const scopeNote = keep(guide.scope_note) ? guide.scope_note : null;
+  const verify = keep(guide.verify) ? guide.verify : null;
+  return { prerequisites, steps, scopeNote, verify, ungrounded };
+}
+function CopyableValue({ value, testId }) {
+  const [copied, setCopied] = useState7(false);
+  const timer = useRef5(null);
+  useEffect6(
+    () => () => {
+      if (timer.current) clearTimeout(timer.current);
+    },
+    []
+  );
+  const copy = useCallback4(async () => {
+    try {
+      if (typeof navigator.clipboard?.writeText !== "function") {
+        throw new Error("clipboard unavailable");
+      }
+      await navigator.clipboard.writeText(value);
+      setCopied(true);
+      if (timer.current) clearTimeout(timer.current);
+      timer.current = setTimeout(() => setCopied(false), 1500);
+    } catch {
+      setCopied(false);
+    }
+  }, [value]);
+  return /* @__PURE__ */ jsxs6("span", { className: "mt-1 flex items-center gap-1.5", children: [
+    /* @__PURE__ */ jsx7(
+      "code",
+      {
+        "data-testid": `${testId}-value`,
+        className: "min-w-0 flex-1 truncate rounded bg-foreground/10 px-1.5 py-0.5 text-[11px]",
+        children: value
+      }
+    ),
+    /* @__PURE__ */ jsx7(
+      "button",
+      {
+        type: "button",
+        "data-testid": testId,
+        onClick: () => void copy(),
+        className: "shrink-0 rounded-md px-1.5 py-0.5 text-[11px] font-medium text-muted-foreground hover:bg-foreground/10",
+        children: copied ? "Copied" : "Copy"
+      }
+    )
+  ] });
+}
+function SetupGuidePanel({
+  entry,
+  guide,
+  showVerify
+}) {
+  const { prerequisites, steps, scopeNote, verify, ungrounded } = groundGuide(guide);
+  const leaked = ungrounded.length > 0;
+  useEffect6(() => {
+    if (!leaked) return;
+    console.error(
+      `[ConnectorPicker] setup guide for "${entry.slug}" arrived with ungrounded placeholders:`,
+      ungrounded
+    );
+  }, [entry.slug, guide, leaked]);
+  return /* @__PURE__ */ jsxs6("div", { "data-testid": `connector-guide-${entry.slug}`, className: "flex flex-col gap-2", children: [
+    leaked && isDevEnvironment() && /* @__PURE__ */ jsxs6(
+      "p",
+      {
+        role: "alert",
+        "data-testid": `connector-guide-ungrounded-${entry.slug}`,
+        className: "rounded-md border border-destructive/30 bg-destructive/5 px-2 py-1 text-xs text-destructive",
+        children: [
+          "Setup guide arrived with unresolved placeholders and those lines were dropped: ",
+          ungrounded.join(" \xB7 ")
+        ]
+      }
+    ),
+    prerequisites.length > 0 && /* @__PURE__ */ jsxs6("div", { children: [
+      /* @__PURE__ */ jsx7("h4", { className: "text-xs font-medium", children: "Before you start" }),
+      /* @__PURE__ */ jsx7(
+        "ul",
+        {
+          "data-testid": `connector-guide-prerequisites-${entry.slug}`,
+          className: "mt-1 list-disc pl-4 text-xs text-muted-foreground",
+          children: prerequisites.map((item) => /* @__PURE__ */ jsx7("li", { children: item }, item))
+        }
+      )
+    ] }),
+    steps.length > 0 && /* @__PURE__ */ jsx7(
+      "ol",
+      {
+        "data-testid": `connector-guide-steps-${entry.slug}`,
+        className: "list-decimal pl-4 text-xs",
+        children: steps.map((step, index) => /* @__PURE__ */ jsxs6("li", { className: "mt-1 first:mt-0", children: [
+          /* @__PURE__ */ jsx7("span", { children: step.text }),
+          step.copyable && /* @__PURE__ */ jsx7(
+            CopyableValue,
+            {
+              value: step.copyable,
+              testId: `connector-guide-copy-${entry.slug}-${index}`
+            }
+          )
+        ] }, step.text))
+      }
+    ),
+    scopeNote && /* @__PURE__ */ jsx7(
+      "p",
+      {
+        "data-testid": `connector-guide-scope-note-${entry.slug}`,
+        className: "rounded-md border border-primary/30 bg-primary/5 px-2 py-1 text-xs font-medium",
+        children: scopeNote
+      }
+    ),
+    showVerify && verify && /* @__PURE__ */ jsx7(
+      "p",
+      {
+        "data-testid": `connector-guide-verify-${entry.slug}`,
+        className: "text-xs text-muted-foreground",
+        children: verify
+      }
+    )
+  ] });
+}
+function CredentialForm({
+  entry,
+  fields,
+  kind,
+  verify,
+  testSupported,
+  onSubmitCredentials,
+  onTestCredentials
+}) {
+  const [values, setValues] = useState7(() => {
+    const initial = {};
+    for (const field of fields) {
+      if (field.defaultValue) initial[field.key] = field.defaultValue;
+    }
+    return initial;
+  });
+  const [busy, setBusy] = useState7(false);
+  const [testing, setTesting] = useState7(false);
+  const [error, setError] = useState7(null);
+  const [result, setResult] = useState7(null);
+  const entryRef = useRef5(entry);
+  entryRef.current = entry;
+  const updateField = useCallback4((key, value) => {
+    setValues((prev) => ({ ...prev, [key]: value }));
+    setError(null);
+    setResult(null);
+  }, []);
+  const missingRequired = fields.filter((field) => field.required !== false).some((field) => !values[field.key]?.trim());
+  const failedTest = result?.valid === false;
+  const untested = testSupported && result === null;
+  const fieldErrors = result?.field_errors ?? null;
+  const handleTest = useCallback4(async () => {
+    setTesting(true);
+    setError(null);
+    setResult(null);
+    try {
+      setResult(await onTestCredentials(entryRef.current, values));
+    } catch (err) {
+      setError(errorMessageFrom(err, DEFAULT_CREDENTIAL_TEST_ERROR));
+    } finally {
+      setTesting(false);
+    }
+  }, [onTestCredentials, values]);
+  const handleSubmit = useCallback4(async () => {
+    setBusy(true);
+    setError(null);
+    try {
+      await onSubmitCredentials(entryRef.current, values, kind);
+    } catch (err) {
+      setError(errorMessageFrom(err, DEFAULT_CREDENTIAL_ERROR));
+    } finally {
+      setBusy(false);
+    }
+  }, [kind, onSubmitCredentials, values]);
+  return /* @__PURE__ */ jsxs6(
+    "form",
+    {
+      "data-testid": `connector-credential-form-${entry.slug}`,
+      onSubmit: (event) => {
+        event.preventDefault();
+        if (missingRequired || busy || testing || failedTest || untested) return;
+        void handleSubmit();
+      },
+      className: "flex flex-col gap-2",
+      children: [
+        fields.map((field) => {
+          const inputId = `connector-credential-${entry.slug}-${field.key}`;
+          const fieldError = fieldErrors?.[field.key] ?? null;
+          return /* @__PURE__ */ jsxs6("div", { className: "flex flex-col gap-1", children: [
+            /* @__PURE__ */ jsxs6("label", { htmlFor: inputId, className: "text-xs font-medium", children: [
+              field.label,
+              field.required !== false && /* @__PURE__ */ jsx7("span", { "aria-hidden": "true", className: "ml-0.5 text-destructive", children: "*" })
+            ] }),
+            /* @__PURE__ */ jsx7(
+              "input",
+              {
+                id: inputId,
+                "data-testid": `connector-credential-input-${entry.slug}-${field.key}`,
+                type: field.type ?? "text",
+                value: values[field.key] ?? "",
+                onChange: (event) => updateField(field.key, event.target.value),
+                placeholder: field.placeholder ?? void 0,
+                required: field.required !== false,
+                disabled: busy || testing,
+                autoComplete: "off",
+                "aria-invalid": fieldError ? true : void 0,
+                "aria-describedby": fieldError ? `${inputId}-error` : void 0,
+                className: cn(
+                  "rounded-md border bg-transparent px-1.5 py-1 text-xs disabled:opacity-50",
+                  fieldError ? "border-destructive" : "border-border"
+                )
+              }
+            ),
+            fieldError && /* @__PURE__ */ jsx7(
+              "p",
+              {
+                id: `${inputId}-error`,
+                "data-testid": `connector-credential-field-error-${entry.slug}-${field.key}`,
+                className: "text-xs text-destructive",
+                children: fieldError
+              }
+            )
+          ] }, field.key);
+        }),
+        verify && /* @__PURE__ */ jsx7(
+          "p",
+          {
+            "data-testid": `connector-guide-verify-${entry.slug}`,
+            className: "text-xs text-muted-foreground",
+            children: verify
+          }
+        ),
+        result && /* @__PURE__ */ jsx7(CredentialTestResult, { entry, result }),
+        error && /* @__PURE__ */ jsx7(
+          "p",
+          {
+            role: "alert",
+            "data-testid": `connector-credential-error-${entry.slug}`,
+            className: "text-xs text-destructive",
+            children: error
+          }
+        ),
+        /* @__PURE__ */ jsxs6("div", { className: "flex items-center justify-end gap-1.5", children: [
+          testSupported && /* @__PURE__ */ jsx7(
+            "button",
+            {
+              type: "button",
+              "data-testid": `connector-credential-test-${entry.slug}`,
+              onClick: () => void handleTest(),
+              disabled: missingRequired || busy || testing,
+              className: "rounded-md border border-border px-2.5 py-1 text-xs font-medium disabled:opacity-50",
+              children: testing ? "Testing\u2026" : "Test connection"
+            }
+          ),
+          /* @__PURE__ */ jsx7(
+            "button",
+            {
+              type: "submit",
+              "data-testid": `connector-credential-save-${entry.slug}`,
+              disabled: missingRequired || busy || testing || failedTest || untested,
+              title: failedTest ? "That credential failed its own check \u2014 fix it and test again." : untested ? "Test the credential before saving it." : void 0,
+              className: "rounded-md bg-primary px-2.5 py-1 text-xs font-medium text-primary-foreground disabled:opacity-50",
+              children: busy ? "Saving\u2026" : "Save credential"
+            }
+          )
+        ] })
+      ]
+    }
+  );
+}
+function CredentialTestResult({
+  entry,
+  result
+}) {
+  if (result.valid === true) {
+    return /* @__PURE__ */ jsxs6(
+      "div",
+      {
+        role: "status",
+        "data-testid": `connector-credential-test-pass-${entry.slug}`,
+        className: "rounded-md border border-primary/30 bg-primary/5 px-2 py-1 text-xs",
+        children: [
+          /* @__PURE__ */ jsx7("p", { children: result.account_name ? `Verified \u2014 connected as ${result.account_name}.` : "Verified \u2014 these credentials work." }),
+          result.permissions_note && /* @__PURE__ */ jsx7(
+            "p",
+            {
+              "data-testid": `connector-credential-permissions-${entry.slug}`,
+              className: "mt-0.5 font-medium",
+              children: result.permissions_note
+            }
+          )
+        ]
+      }
+    );
+  }
+  if (result.valid === false) {
+    return /* @__PURE__ */ jsx7(
+      "p",
+      {
+        role: "alert",
+        "data-testid": `connector-credential-test-fail-${entry.slug}`,
+        className: "rounded-md border border-destructive/30 bg-destructive/5 px-2 py-1 text-xs text-destructive",
+        children: result.error || "That credential didn't pass its check."
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx7(
+    "p",
+    {
+      role: "status",
+      "data-testid": `connector-credential-test-unverified-${entry.slug}`,
+      className: "rounded-md border border-border px-2 py-1 text-xs text-muted-foreground",
+      children: UNVERIFIABLE_CREDENTIAL_NOTE
+    }
+  );
+}
 function ManageSharing({
   entry,
   listGrants,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meetreeve/ui",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Shared brand-adaptive UI primitives for MindFortress frontends — min-size tokens, a favicon→logo→monogram BrandGlyph, a responsive header that keeps the search bar usable on mobile, and AppSidebar's viewport-driven auto-collapse ladder.",
   "license": "UNLICENSED",
   "main": "./dist/index.js",
@@ -22,6 +22,11 @@
       "import": "./dist/lockup/index.mjs",
       "require": "./dist/lockup/index.js"
     },
+    "./console": {
+      "types": "./dist/console/index.d.ts",
+      "import": "./dist/console/index.mjs",
+      "require": "./dist/console/index.js"
+    },
     "./tokens.css": "./dist/tokens.css"
   },
   "files": [
@@ -42,6 +47,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@base-ui/react": "^1.6.0",
     "@radix-ui/react-dropdown-menu": "^2.1.16"
   },
   "peerDependencies": {
@@ -59,11 +65,14 @@
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "@vitejs/plugin-react": "^5.1.3",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
     "jsdom": "^28.0.0",
     "lucide-react": "^0.400.0",
     "next": "16.1.6",
     "react": "19.2.3",
     "react-dom": "19.2.3",
+    "tailwind-merge": "^3.6.0",
     "tsup": "^8.0.0",
     "typescript": "5.9.3",
     "vitest": "^4.0.18",