picoclaw/web/frontend/src/components/channels/channel-forms/weixin-form.tsx
wenjie ba6992234f
feat(web): support list editing for channel array fields (#2595)
Add reusable channel array list controls and parsing utilities for channel forms.
Normalize channel string-array payloads in the backend, including pasted values,
numeric IDs, hidden characters, duplicates, and empty clears.
Also allow FlexibleStringSlice to unmarshal null values and cover the new behavior
with backend and config tests.
2026-04-21 16:04:28 +08:00

360 lines
11 KiB
TypeScript

import {
IconCheck,
IconLoader2,
IconQrcode,
IconRefresh,
IconX,
} from "@tabler/icons-react"
import { useCallback, useEffect, useRef, useState } from "react"
import { useTranslation } from "react-i18next"
import type { ChannelConfig } from "@/api/channels"
import { pollWeixinFlow, startWeixinFlow } from "@/api/channels"
import {
type ArrayFieldFlusher,
ChannelArrayListField,
} from "@/components/channels/channel-array-list-field"
import {
asStringArray,
parseAllowFromInput,
} from "@/components/channels/channel-array-utils"
import { Field } from "@/components/shared-form"
import { Button } from "@/components/ui/button"
import {
Card,
CardContent,
CardDescription,
CardHeader,
CardTitle,
} from "@/components/ui/card"
import { Input } from "@/components/ui/input"
type BindingState =
| "idle"
| "loading"
| "waiting"
| "scaned"
| "confirmed"
| "expired"
| "error"
interface WeixinFormProps {
config: ChannelConfig
onChange: (key: string, value: unknown) => void
isEdit: boolean
onBindSuccess?: () => void
registerArrayFieldFlusher?: (
fieldPath: string,
flusher: ArrayFieldFlusher | null,
) => void
arrayFieldResetVersion?: number
}
function asString(value: unknown): string {
return typeof value === "string" ? value : ""
}
export function WeixinForm({
config,
onChange,
isEdit,
onBindSuccess,
registerArrayFieldFlusher,
arrayFieldResetVersion,
}: WeixinFormProps) {
const { t } = useTranslation()
const [bindState, setBindState] = useState<BindingState>("idle")
const [qrDataURI, setQrDataURI] = useState<string | null>(null)
const [accountID, setAccountID] = useState<string | null>(null)
const [errorMsg, setErrorMsg] = useState("")
const pollTimerRef = useRef<ReturnType<typeof setInterval> | null>(null)
const pollGenerationRef = useRef(0)
const isBound = isEdit && asString(config.account_id) !== ""
const existingAccountID = asString(config.account_id)
const stopPolling = useCallback(() => {
pollGenerationRef.current += 1
if (pollTimerRef.current !== null) {
clearInterval(pollTimerRef.current)
pollTimerRef.current = null
}
}, [])
useEffect(() => () => stopPolling(), [stopPolling])
useEffect(() => {
if (!existingAccountID) return
stopPolling()
setAccountID(existingAccountID)
setBindState("confirmed")
setErrorMsg("")
}, [existingAccountID, stopPolling])
const startPolling = useCallback(
(id: string) => {
stopPolling()
const generation = pollGenerationRef.current
let inFlight = false
pollTimerRef.current = setInterval(async () => {
if (inFlight) return
inFlight = true
try {
const resp = await pollWeixinFlow(id)
if (generation !== pollGenerationRef.current) {
return
}
if (resp.status === "scaned") {
setBindState("scaned")
} else if (resp.status === "confirmed") {
stopPolling()
setAccountID(resp.account_id ?? existingAccountID ?? null)
setBindState("confirmed")
onBindSuccess?.()
} else if (resp.status === "expired") {
stopPolling()
setBindState("expired")
} else if (resp.status === "error") {
stopPolling()
setBindState("error")
setErrorMsg(resp.error ?? t("channels.weixin.errorGeneric"))
}
} catch {
// transient network error — keep polling
} finally {
inFlight = false
}
}, 2000)
},
[existingAccountID, stopPolling, onBindSuccess, t],
)
const handleBind = async () => {
setBindState("loading")
setErrorMsg("")
setQrDataURI(null)
stopPolling()
try {
const resp = await startWeixinFlow()
setQrDataURI(resp.qr_data_uri ?? null)
setBindState("waiting")
startPolling(resp.flow_id)
} catch (e) {
setBindState("error")
setErrorMsg(
e instanceof Error ? e.message : t("channels.weixin.errorGeneric"),
)
}
}
const handleRebind = () => {
stopPolling()
setBindState("idle")
setQrDataURI(null)
setAccountID(null)
setErrorMsg("")
void handleBind()
}
const renderBindSection = () => {
if (bindState === "idle") {
if (isBound) {
return (
<div className="flex flex-col items-center gap-3 py-6">
<div className="flex items-center gap-2 rounded-full bg-emerald-500/10 px-4 py-2 text-sm font-medium text-emerald-600 dark:text-emerald-400">
<IconCheck size={16} />
{t("channels.weixin.bound")}
</div>
{existingAccountID && (
<p className="text-muted-foreground font-mono text-xs">
{existingAccountID}
</p>
)}
<Button
variant="outline"
size="sm"
onClick={handleRebind}
className="mt-1 gap-2"
>
<IconRefresh size={14} />
{t("channels.weixin.rebind")}
</Button>
</div>
)
}
return (
<div className="flex flex-col items-center gap-4 py-6">
<p className="text-muted-foreground text-sm">
{t("channels.weixin.notBound")}
</p>
<Button onClick={handleBind} className="gap-2">
<IconQrcode size={16} />
{t("channels.weixin.bind")}
</Button>
</div>
)
}
if (bindState === "loading") {
return (
<div className="flex flex-col items-center gap-3 py-8">
<IconLoader2
className="text-muted-foreground animate-spin"
size={32}
/>
<p className="text-muted-foreground text-sm">
{t("channels.weixin.generating")}
</p>
</div>
)
}
if (bindState === "waiting" || bindState === "scaned") {
return (
<div className="flex flex-col items-center gap-4 py-4">
{qrDataURI ? (
<img
src={qrDataURI}
alt="WeChat QR Code"
className="border-border/60 h-48 w-48 rounded-xl border bg-white p-2 shadow-sm"
/>
) : (
<div className="border-border/60 bg-muted flex h-48 w-48 items-center justify-center rounded-xl border">
<IconLoader2
className="text-muted-foreground animate-spin"
size={32}
/>
</div>
)}
{bindState === "scaned" ? (
<div className="flex items-center gap-2 rounded-full bg-amber-500/10 px-4 py-2 text-sm font-medium text-amber-600 dark:text-amber-400">
<IconLoader2 size={14} className="animate-spin" />
{t("channels.weixin.scanned")}
</div>
) : (
<p className="text-muted-foreground text-sm">
{t("channels.weixin.scanHint")}
</p>
)}
<Button
variant="ghost"
size="sm"
onClick={handleRebind}
className="text-muted-foreground"
>
<IconRefresh size={14} className="mr-1" />
{t("channels.weixin.refresh")}
</Button>
</div>
)
}
if (bindState === "confirmed") {
return (
<div className="flex flex-col items-center gap-3 py-6">
<div className="flex h-14 w-14 items-center justify-center rounded-full bg-emerald-500/10">
<IconCheck
size={28}
className="text-emerald-600 dark:text-emerald-400"
/>
</div>
<p className="text-sm font-medium text-emerald-600 dark:text-emerald-400">
{t("channels.weixin.bound")}
</p>
{accountID && (
<p className="text-muted-foreground font-mono text-xs">
{accountID}
</p>
)}
<Button
variant="outline"
size="sm"
onClick={handleRebind}
className="mt-1 gap-2"
>
<IconRefresh size={14} />
{t("channels.weixin.rebind")}
</Button>
</div>
)
}
if (bindState === "expired") {
return (
<div className="flex flex-col items-center gap-4 py-6">
<div className="flex h-14 w-14 items-center justify-center rounded-full bg-amber-500/10">
<IconX size={28} className="text-amber-600 dark:text-amber-400" />
</div>
<p className="text-sm text-amber-600 dark:text-amber-400">
{t("channels.weixin.expired")}
</p>
<Button onClick={handleRebind} className="gap-2">
<IconRefresh size={14} />
{t("channels.weixin.retry")}
</Button>
</div>
)
}
if (bindState === "error") {
return (
<div className="flex flex-col items-center gap-4 py-6">
<div className="bg-destructive/10 flex h-14 w-14 items-center justify-center rounded-full">
<IconX size={28} className="text-destructive" />
</div>
<p className="text-destructive text-sm">
{errorMsg || t("channels.weixin.errorGeneric")}
</p>
<Button variant="outline" onClick={handleRebind} className="gap-2">
<IconRefresh size={14} />
{t("channels.weixin.retry")}
</Button>
</div>
)
}
return null
}
return (
<div className="space-y-6">
<Card className="shadow-sm">
<CardHeader className="border-border/60 border-b px-6">
<CardTitle className="text-foreground text-sm font-medium">
{t("channels.weixin.bindTitle")}
</CardTitle>
<CardDescription>{t("channels.weixin.bindDesc")}</CardDescription>
</CardHeader>
<CardContent className="p-0">{renderBindSection()}</CardContent>
</Card>
<Card className="shadow-sm">
<CardContent className="divide-border/60 divide-y px-6 py-0 [&>div]:py-5">
<ChannelArrayListField
label={t("channels.field.allowFrom")}
hint={t("channels.form.desc.allowFrom")}
value={asStringArray(config.allow_from)}
onChange={(value) => onChange("allow_from", value)}
placeholder={t("channels.field.allowFromPlaceholder")}
parser={parseAllowFromInput}
fieldPath="allow_from"
registerFlusher={registerArrayFieldFlusher}
resetVersion={arrayFieldResetVersion}
/>
<Field
label={t("channels.field.proxy")}
hint={t("channels.form.desc.proxy")}
>
<Input
value={asString(config.proxy)}
onChange={(e) => onChange("proxy", e.target.value)}
placeholder="http://localhost:7890"
/>
</Field>
</CardContent>
</Card>
</div>
)
}