* feat(channels): add guided setup flows * test(channels): preserve setup config values * fix(channels): reflect saved setup state * refactor(channels): simplify setup state metadata * fix(channels): harden setup lifecycle * refactor(channels): centralize setup contracts * fix(channels): route setup actions through webui shim * fix(channels): adapt settings for compact screens * fix(models): preserve default preset display * feat(models): add curated Codex catalog * fix(webui): stop attached gateway on interrupt * fix(webui): simplify apps catalog * docs(webui): clarify apps and runtime features * feat(settings): add guided capability setup * fix(webui): harden setup and managed services * test: keep managed runtime checks portable * test: scope POSIX runtime coverage * fix(webui): simplify file settings * feat(files): bundle document reading * fix(webui): harden setup request boundaries * fix(webui): prevent channel setup status squeeze * fix(settings): group provider compatibility aliases * refactor(settings): remove redundant setup surfaces * fix(webui): harden guided setup lifecycle * fix(webui): preserve channel setup compatibility
335 lines
11 KiB
TypeScript
335 lines
11 KiB
TypeScript
import { useCallback, useEffect, useRef, useState } from "react";
|
|
import QRCode from "qrcode";
|
|
import { Check, Loader2, Network, RotateCcw } from "lucide-react";
|
|
import { useTranslation } from "react-i18next";
|
|
|
|
import { Button } from "@/components/ui/button";
|
|
import {
|
|
cancelChannelConnect,
|
|
pollChannelConnect,
|
|
startChannelConnect,
|
|
} from "@/lib/api";
|
|
import type {
|
|
ChannelConnectPayload,
|
|
NanobotFeaturesPayload,
|
|
} from "@/lib/types";
|
|
|
|
export type ChannelQrConnectLabels = {
|
|
qrAlt: string;
|
|
scanTitle: string;
|
|
scanDescription: string;
|
|
waiting: string;
|
|
connected: string;
|
|
stopped: string;
|
|
connecting: string;
|
|
scanAgain: string;
|
|
connect: string;
|
|
};
|
|
|
|
export function ChannelQrConnectFlow({
|
|
token,
|
|
channelName,
|
|
startOptions = {},
|
|
idleLabel,
|
|
connectRequestId,
|
|
labels,
|
|
onFeaturesUpdate,
|
|
}: {
|
|
token: string;
|
|
channelName: "feishu" | "weixin";
|
|
startOptions?: {
|
|
domain?: "feishu" | "lark";
|
|
instanceId?: string;
|
|
mode?: "replace" | "create";
|
|
force?: boolean;
|
|
};
|
|
idleLabel?: string;
|
|
connectRequestId?: number;
|
|
labels: ChannelQrConnectLabels;
|
|
onFeaturesUpdate: (payload: NanobotFeaturesPayload) => void;
|
|
}) {
|
|
const { t } = useTranslation();
|
|
const tx = (key: string, fallback: string) => t(key, { defaultValue: fallback });
|
|
const [connect, setConnect] = useState<ChannelConnectPayload | null>(null);
|
|
const [qrDataUrl, setQrDataUrl] = useState("");
|
|
const [busy, setBusy] = useState(false);
|
|
const [error, setError] = useState<string | null>(null);
|
|
const [handledRequestId, setHandledRequestId] = useState(0);
|
|
const pollInFlight = useRef(false);
|
|
const startDomain = startOptions.domain;
|
|
const startInstanceId = startOptions.instanceId;
|
|
const startMode = startOptions.mode;
|
|
const startForce = startOptions.force;
|
|
|
|
const pending = connect?.status === "pending";
|
|
const succeeded = connect?.status === "succeeded";
|
|
const canStart = !pending && !busy;
|
|
|
|
useEffect(() => {
|
|
if (!connect?.qr_url) {
|
|
setQrDataUrl("");
|
|
return;
|
|
}
|
|
let cancelled = false;
|
|
void QRCode.toDataURL(connect.qr_url, {
|
|
width: 184,
|
|
margin: 1,
|
|
color: { dark: "#111827", light: "#ffffff" },
|
|
})
|
|
.then((url) => {
|
|
if (!cancelled) setQrDataUrl(url);
|
|
})
|
|
.catch(() => {
|
|
if (!cancelled) setQrDataUrl("");
|
|
});
|
|
return () => {
|
|
cancelled = true;
|
|
};
|
|
}, [connect?.qr_url]);
|
|
|
|
useEffect(() => {
|
|
if (!connect?.session_id || connect.status !== "pending") return;
|
|
let cancelled = false;
|
|
const poll = async () => {
|
|
if (pollInFlight.current) return;
|
|
pollInFlight.current = true;
|
|
try {
|
|
const payload = await pollChannelConnect(token, channelName, connect.session_id);
|
|
if (cancelled) return;
|
|
setConnect((current) => ({
|
|
...(current ?? payload),
|
|
...payload,
|
|
qr_url: payload.qr_url ?? current?.qr_url,
|
|
}));
|
|
if (payload.nanobot_features) {
|
|
onFeaturesUpdate(payload.nanobot_features);
|
|
}
|
|
if (payload.status !== "pending") {
|
|
setError(null);
|
|
}
|
|
} catch (err) {
|
|
if (!cancelled) setError((err as Error).message);
|
|
} finally {
|
|
pollInFlight.current = false;
|
|
}
|
|
};
|
|
const initial = window.setTimeout(() => void poll(), 900);
|
|
const interval = window.setInterval(
|
|
() => void poll(),
|
|
Math.max(2500, connect.interval_ms ?? 5000),
|
|
);
|
|
return () => {
|
|
cancelled = true;
|
|
window.clearTimeout(initial);
|
|
window.clearInterval(interval);
|
|
};
|
|
}, [channelName, connect?.interval_ms, connect?.session_id, connect?.status, onFeaturesUpdate, token]);
|
|
|
|
const start = useCallback(async (force = false) => {
|
|
setBusy(true);
|
|
setError(null);
|
|
try {
|
|
const payload = await startChannelConnect(token, channelName, {
|
|
domain: startDomain,
|
|
instanceId: startInstanceId,
|
|
mode: startMode,
|
|
force: force || startForce,
|
|
});
|
|
setConnect(payload);
|
|
} catch (err) {
|
|
setError((err as Error).message);
|
|
} finally {
|
|
setBusy(false);
|
|
}
|
|
}, [channelName, startDomain, startForce, startInstanceId, startMode, token]);
|
|
|
|
useEffect(() => {
|
|
if (!connectRequestId || connectRequestId === handledRequestId) return;
|
|
setHandledRequestId(connectRequestId);
|
|
void start();
|
|
}, [connectRequestId, handledRequestId, start]);
|
|
|
|
const cancel = async () => {
|
|
if (!connect?.session_id) {
|
|
setConnect(null);
|
|
return;
|
|
}
|
|
setBusy(true);
|
|
try {
|
|
const payload = await cancelChannelConnect(token, channelName, connect.session_id);
|
|
setConnect(payload);
|
|
} catch (err) {
|
|
setError((err as Error).message);
|
|
} finally {
|
|
setBusy(false);
|
|
}
|
|
};
|
|
|
|
return (
|
|
<div className="mt-3 space-y-3">
|
|
{pending ? (
|
|
<div className="grid gap-4 rounded-[14px] border border-border/70 p-4 sm:grid-cols-[auto_minmax(0,1fr)]">
|
|
<div className="grid h-[196px] w-[196px] place-items-center rounded-[14px] border border-border/60 bg-background">
|
|
{qrDataUrl ? (
|
|
<img
|
|
src={qrDataUrl}
|
|
alt={labels.qrAlt}
|
|
className="h-[184px] w-[184px]"
|
|
/>
|
|
) : (
|
|
<Loader2 className="h-5 w-5 animate-spin text-muted-foreground" aria-hidden />
|
|
)}
|
|
</div>
|
|
<div className="flex min-w-0 flex-col justify-center">
|
|
<div className="text-[13px] font-semibold text-foreground">
|
|
{labels.scanTitle}
|
|
</div>
|
|
<p className="mt-1 text-[12.5px] leading-5 text-muted-foreground">
|
|
{labels.scanDescription}
|
|
</p>
|
|
<div className="mt-3 flex items-center gap-2 text-[12px] text-muted-foreground">
|
|
<Loader2 className="h-3.5 w-3.5 animate-spin" aria-hidden />
|
|
{labels.waiting}
|
|
</div>
|
|
<div className="mt-4 flex flex-wrap justify-end gap-2">
|
|
<Button
|
|
type="button"
|
|
size="sm"
|
|
variant="outline"
|
|
className="h-8 rounded-full px-3 text-[12px] font-semibold"
|
|
onClick={() => void cancel()}
|
|
disabled={busy}
|
|
>
|
|
{tx("settings.actions.cancel", "Cancel")}
|
|
</Button>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
) : null}
|
|
|
|
{succeeded ? (
|
|
<div className="flex items-center gap-2 rounded-[12px] border border-emerald-500/20 px-3 py-2 text-[12px] font-medium text-emerald-700 dark:text-emerald-200">
|
|
<Check className="h-3.5 w-3.5" aria-hidden />
|
|
{connect.message ?? labels.connected}
|
|
</div>
|
|
) : null}
|
|
|
|
{connect && ["expired", "failed", "cancelled"].includes(connect.status) ? (
|
|
<div className="rounded-[12px] border border-border/60 px-3 py-2 text-[12px] leading-5 text-muted-foreground">
|
|
{connect.message || labels.stopped}
|
|
</div>
|
|
) : null}
|
|
|
|
{error ? (
|
|
<div className="rounded-[12px] border border-destructive/20 px-3 py-2 text-[12px] leading-5 text-destructive">
|
|
{error}
|
|
</div>
|
|
) : null}
|
|
|
|
<div className="flex flex-wrap justify-end gap-2">
|
|
<Button
|
|
type="button"
|
|
size="sm"
|
|
variant="outline"
|
|
className="h-8 rounded-full border-border/65 bg-background/80 px-3 text-[12px] font-semibold hover:bg-muted/70"
|
|
onClick={() => void start(channelName === "weixin" && succeeded)}
|
|
disabled={!canStart}
|
|
>
|
|
{busy ? (
|
|
<Loader2 className="mr-1.5 h-3.5 w-3.5 animate-spin" aria-hidden />
|
|
) : succeeded ? (
|
|
<RotateCcw className="mr-1.5 h-3.5 w-3.5" aria-hidden />
|
|
) : (
|
|
<Network className="mr-1.5 h-3.5 w-3.5" aria-hidden />
|
|
)}
|
|
{pending
|
|
? labels.connecting
|
|
: succeeded
|
|
? labels.scanAgain
|
|
: idleLabel ?? labels.connect}
|
|
</Button>
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
export function FeishuConnectFlow({
|
|
token,
|
|
instanceId = "default",
|
|
mode = "replace",
|
|
idleLabel,
|
|
connectRequestId,
|
|
onFeaturesUpdate,
|
|
}: {
|
|
token: string;
|
|
instanceId?: string;
|
|
mode?: "replace" | "create";
|
|
idleLabel?: string;
|
|
connectRequestId?: number;
|
|
onFeaturesUpdate: (payload: NanobotFeaturesPayload) => void;
|
|
}) {
|
|
const { t } = useTranslation();
|
|
const tx = (key: string, fallback: string) => t(key, { defaultValue: fallback });
|
|
return (
|
|
<ChannelQrConnectFlow
|
|
token={token}
|
|
channelName="feishu"
|
|
startOptions={{ domain: "feishu", instanceId, mode }}
|
|
idleLabel={idleLabel}
|
|
connectRequestId={connectRequestId}
|
|
onFeaturesUpdate={onFeaturesUpdate}
|
|
labels={{
|
|
qrAlt: tx("settings.channels.feishuQrAlt", "Feishu connection QR code"),
|
|
scanTitle: tx("settings.channels.feishuScanTitle", "Scan with Feishu"),
|
|
scanDescription: tx(
|
|
"settings.channels.feishuScanDescription",
|
|
"Use Feishu or Lark on your phone to scan this code. nanobot will finish setup automatically after authorization.",
|
|
),
|
|
waiting: tx("settings.channels.feishuWaiting", "Waiting for authorization..."),
|
|
connected: tx("settings.channels.feishuConnected", "Feishu is connected."),
|
|
stopped: tx("settings.channels.feishuConnectStopped", "Connection stopped."),
|
|
connecting: tx("settings.channels.feishuConnecting", "Connecting..."),
|
|
scanAgain: tx("settings.channels.scanAgain", "Scan again"),
|
|
connect: tx("settings.channels.connect", "Connect"),
|
|
}}
|
|
/>
|
|
);
|
|
}
|
|
|
|
export function WeixinConnectFlow({
|
|
token,
|
|
idleLabel,
|
|
connectRequestId,
|
|
onFeaturesUpdate,
|
|
}: {
|
|
token: string;
|
|
idleLabel?: string;
|
|
connectRequestId?: number;
|
|
onFeaturesUpdate: (payload: NanobotFeaturesPayload) => void;
|
|
}) {
|
|
const { t } = useTranslation();
|
|
const tx = (key: string, fallback: string) => t(key, { defaultValue: fallback });
|
|
return (
|
|
<ChannelQrConnectFlow
|
|
token={token}
|
|
channelName="weixin"
|
|
idleLabel={idleLabel}
|
|
connectRequestId={connectRequestId}
|
|
onFeaturesUpdate={onFeaturesUpdate}
|
|
labels={{
|
|
qrAlt: tx("settings.channels.weixinQrAlt", "WeChat login QR code"),
|
|
scanTitle: tx("settings.channels.weixinScanTitle", "Scan with WeChat"),
|
|
scanDescription: tx(
|
|
"settings.channels.weixinScanDescription",
|
|
"Use WeChat on your phone to scan this code. nanobot saves the account state locally after login.",
|
|
),
|
|
waiting: tx("settings.channels.weixinWaiting", "Waiting for WeChat scan..."),
|
|
connected: tx("settings.channels.weixinConnected", "WeChat is connected."),
|
|
stopped: tx("settings.channels.weixinConnectStopped", "WeChat login stopped."),
|
|
connecting: tx("settings.channels.weixinConnecting", "Connecting..."),
|
|
scanAgain: tx("settings.channels.scanAgain", "Scan again"),
|
|
connect: tx("settings.channels.connect", "Connect"),
|
|
}}
|
|
/>
|
|
);
|
|
}
|