mioku-plugin-admin 3.0.2 → 3.0.3

package/notify/index.ts

@@ -16,8 +16,8 @@ interface NotifyPayload {
 }
 
 interface PendingFriendRequest {
-  selfId: number;
-  userId: number;
+  selfId: string;
+  userId: string;
   flag: string;
   createdAt: number;
   approve: () => Promise<void>;
@@ -25,9 +25,9 @@ interface PendingFriendRequest {
 }
 
 interface PendingGroupInvite {
-  selfId: number;
-  groupId: number;
-  userId: number;
+  selfId: string;
+  groupId: string;
+  userId: string;
   flag: string;
   subType: string;
   createdAt: number;
@@ -50,10 +50,12 @@ function normalizeErrorMessage(error: unknown): string {
 }
 
 /** 获取应该通知的主人列表 */
-function getNotifyOwners(config: AdminConfig): number[] {
+function getNotifyOwners(config: AdminConfig): string[] {
   if (config.notifyTarget.length > 0) return config.notifyTarget;
   const owners = Array.isArray(botConfig?.owners) ? botConfig.owners : [];
-  return owners.map((v: any) => Number(v)).filter((n: number) => n > 0);
+  return owners
+    .map((v: unknown) => String(v ?? "").trim())
+    .filter((id: string) => id.length > 0);
 }
 
 /** 注册所有事件通知处理器 */
@@ -65,7 +67,7 @@ export function registerNotificationHandlers(
   const pendingGroupInvites: PendingGroupInvite[] = [];
   const recentEventKeys = new Map<string, number>();
 
-  function owners(): number[] {
+  function owners(): string[] {
     return getNotifyOwners(getConfig());
   }
 
@@ -187,8 +189,8 @@ export function registerNotificationHandlers(
     if (ctx.isMaster?.(event)) {
       return true;
     }
-    const userId = Number(event.user_id || 0);
-    if (userId <= 0) {
+    const userId = String(event.user_id ?? "").trim();
+    if (!userId) {
       return false;
     }
     return owners().includes(userId);
@@ -206,8 +208,8 @@ export function registerNotificationHandlers(
   }
 
   function pushPendingFriendRequest(event: RequestEvent) {
-    const selfId = Number(event.self_id || 0);
-    const userId = Number(event.user_id || 0);
+    const selfId = String(event.self_id ?? "").trim();
+    const userId = String(event.user_id ?? "").trim();
     const flag = String(event.flag || "").trim();
     if (!selfId || !userId || !flag) return;
     pendingFriendRequests.push({
@@ -222,9 +224,9 @@ export function registerNotificationHandlers(
   }
 
   function pushPendingGroupInvite(event: RequestEvent) {
-    const selfId = Number(event.self_id || 0);
-    const groupId = Number(event.group_id || 0);
-    const userId = Number(event.user_id || 0);
+    const selfId = String(event.self_id ?? "").trim();
+    const groupId = String(event.group_id ?? "").trim();
+    const userId = String(event.user_id ?? "").trim();
     const flag = String(event.flag || "").trim();
     const subType = String(event.sub_type || "invite").trim() || "invite";
     if (!selfId || !groupId || !userId || !flag) return;
@@ -242,8 +244,8 @@ export function registerNotificationHandlers(
   }
 
   function shiftLatestFriendRequest(
-    selfId: number,
-    userId: number,
+    selfId: string,
+    userId: string,
   ): PendingFriendRequest | undefined {
     prunePendingRequests();
     for (let i = pendingFriendRequests.length - 1; i >= 0; i--) {
@@ -257,9 +259,9 @@ export function registerNotificationHandlers(
   }
 
   function shiftLatestGroupInvite(
-    selfId: number,
-    groupId: number,
-    userId?: number,
+    selfId: string,
+    groupId: string,
+    userId?: string,
   ): PendingGroupInvite | undefined {
     prunePendingRequests();
     for (let i = pendingGroupInvites.length - 1; i >= 0; i--) {
@@ -296,47 +298,53 @@ export function registerNotificationHandlers(
   function parseQuotedApprovalTarget(
     quotedText: string,
   ):
-    | { type: "friend_message"; userId: number }
-    | { type: "friend_request"; userId: number }
-    | { type: "group_invite"; groupId: number; userId?: number }
-    | { type: "group_ban"; groupId: number }
+    | { type: "friend_message"; userId: string }
+    | { type: "friend_request"; userId: string }
+    | { type: "group_invite"; groupId: string; userId?: string }
+    | { type: "group_ban"; groupId: string }
     | null {
     const text = String(quotedText || "");
     if (!text) return null;
 
+    // 文本里的 id 可能是 QQ 号,也可能是 openid
+    const ID_PATTERN = "([A-Za-z0-9_-]{4,64})";
+
     if (text.includes("[好友消息]")) {
       const userIdMatch =
-        text.match(/好友QQ[：:]\s*(\d+)/) ||
-        text.match(/QQ[：:]\s*(\d+)/);
-      const userId = Number(userIdMatch?.[1] || 0);
-      return userId > 0 ? { type: "friend_message", userId } : null;
+        text.match(new RegExp(`好友(?:QQ|ID)[：:]\\s*${ID_PATTERN}`)) ||
+        text.match(new RegExp(`(?:QQ|ID)[：:]\\s*${ID_PATTERN}`));
+      const userId = String(userIdMatch?.[1] ?? "").trim();
+      return userId ? { type: "friend_message", userId } : null;
     }
 
     if (text.includes("[好友申请]")) {
       const userIdMatch =
-        text.match(/好友QQ[：:]\s*(\d+)/) ||
-        text.match(/QQ[：:]\s*(\d+)/) ||
-        text.match(/\[好友申请\]\s*(\d+)/);
-      const userId = Number(userIdMatch?.[1] || 0);
-      return userId > 0 ? { type: "friend_request", userId } : null;
+        text.match(new RegExp(`好友(?:QQ|ID)[：:]\\s*${ID_PATTERN}`)) ||
+        text.match(new RegExp(`(?:QQ|ID)[：:]\\s*${ID_PATTERN}`)) ||
+        text.match(new RegExp(`\\[好友申请\\]\\s*${ID_PATTERN}`));
+      const userId = String(userIdMatch?.[1] ?? "").trim();
+      return userId ? { type: "friend_request", userId } : null;
     }
 
     if (text.includes("[群邀请]")) {
       const groupIdMatch =
-        text.match(/群号[：:]\s*(\d+)/) || text.match(/\[群邀请\][^\d]*(\d+)/);
-      const inviterIdMatch = text.match(/邀请人QQ[：:]\s*(\d+)/);
-      const groupId = Number(groupIdMatch?.[1] || 0);
-      const userId = Number(inviterIdMatch?.[1] || 0);
-      if (groupId <= 0) return null;
-      return userId > 0
+        text.match(new RegExp(`群号[：:]\\s*${ID_PATTERN}`)) ||
+        text.match(new RegExp(`\\[群邀请\\][^A-Za-z0-9_-]*${ID_PATTERN}`));
+      const inviterIdMatch = text.match(
+        new RegExp(`邀请人(?:QQ|ID)[：:]\\s*${ID_PATTERN}`),
+      );
+      const groupId = String(groupIdMatch?.[1] ?? "").trim();
+      const userId = String(inviterIdMatch?.[1] ?? "").trim();
+      if (!groupId) return null;
+      return userId
         ? { type: "group_invite", groupId, userId }
         : { type: "group_invite", groupId };
     }
 
     if (text.includes("[Bot被禁言]")) {
-      const groupIdMatch = text.match(/群号[：:]\s*(\d+)/);
-      const groupId = Number(groupIdMatch?.[1] || 0);
-      return groupId > 0 ? { type: "group_ban", groupId } : null;
+      const groupIdMatch = text.match(new RegExp(`群号[：:]\\s*${ID_PATTERN}`));
+      const groupId = String(groupIdMatch?.[1] ?? "").trim();
+      return groupId ? { type: "group_ban", groupId } : null;
     }
 
     return null;
@@ -363,9 +371,9 @@ export function registerNotificationHandlers(
   ): Promise<void> {
     if (!getConfig().notifyGroupInvite) return;
 
-    const selfId = Number(event.self_id || 0);
-    const groupId = Number(event.group_id || 0);
-    const userId = Number(event.user_id || 0);
+    const selfId = String(event.self_id ?? "").trim();
+    const groupId = String(event.group_id ?? "").trim();
+    const userId = String(event.user_id ?? "").trim();
     const flag = String(event.flag || "").trim();
     if (!selfId || !groupId || !userId || !flag) return;
 
@@ -380,7 +388,7 @@ export function registerNotificationHandlers(
       lines: [
         "[群邀请]",
         `群号：${groupId}`,
-        `邀请人QQ：${userId}`,
+        `邀请人QQ：${userId}`,  // 可能是 openid,保留原值便于引用回复
         `验证消息：${comment}`,
         "备注：引用该消息回复「同意」或「拒绝」",
       ],
@@ -388,15 +396,15 @@ export function registerNotificationHandlers(
   }
 
   async function notifyGroupBan(event: NoticeEvent): Promise<void> {
-    const selfId = Number(event.self_id || 0);
-    const groupId = Number(event.group_id || 0);
-    const userId = Number(event.user_id || 0);
+    const selfId = String(event.self_id ?? "").trim();
+    const groupId = String(event.group_id ?? "").trim();
+    const userId = String(event.user_id ?? "").trim();
     const rawBan = event.raw as { action_type?: string; duration?: number } | undefined;
     const duration = Number(rawBan?.duration || 0);
     if (!selfId || !groupId) return;
     if (userId !== selfId) return;
 
-    const operatorId = Number(event.operator_id || 0);
+    const operatorId = String(event.operator_id ?? "").trim();
     const isUnban = rawBan?.action_type === "lift_ban";
     if (isUnban) {
       if (!getConfig().notifyGroupUnban) return;
@@ -424,22 +432,21 @@ export function registerNotificationHandlers(
   ): Promise<void> {
     if (!getConfig().notifyGroupKick) return;
 
-    const selfId = Number(event.self_id || 0);
-    const groupId = Number(event.group_id || 0);
-    const userId = Number(event.user_id || 0);
+    const selfId = String(event.self_id ?? "").trim();
+    const groupId = String(event.group_id ?? "").trim();
+    const userId = String(event.user_id ?? "").trim();
     const rawKick = event.raw as { action_type?: string } | undefined;
     const leaveType = String(rawKick?.action_type || "").trim();
     if (!selfId || !groupId) return;
     if (userId !== selfId) return;
     if (leaveType !== "kick" && leaveType !== "kick_me") return;
 
-    const operatorId = Number(event.operator_id || 0);
+    const operatorId = String(event.operator_id ?? "").trim();
     const eventKey = `group-kick:${selfId}:${groupId}:${operatorId}:${leaveType}:${Number(event.time || 0)}`;
     if (!markEventOnce(eventKey)) return;
 
     await sendNotify(event.bot, {
-      avatarUrl:
-        operatorId > 0 ? getAvatarUrl(operatorId) : getGroupAvatarUrl(groupId),
+      avatarUrl: operatorId ? getAvatarUrl(operatorId) : getGroupAvatarUrl(groupId),
       lines: ["[Bot被踢]", `群号：${groupId}`, `操作者QQ：${operatorId}`],
     });
   }
@@ -520,7 +527,7 @@ export function registerNotificationHandlers(
     }
     const text = (ctx.text(event) || "").trim();
 
-    const selfId = Number(event.self_id || 0);
+    const selfId = String(event.self_id ?? "").trim();
     const bot = event.bot;
     if (!bot) {
       await event.reply("Bot不可用", true);

package/notify/welcome.ts

@@ -5,8 +5,8 @@ import type { AdminConfig } from "../config";
 export async function resolveMemberName(
   ctx: MiokuContext,
   bot: import("mioku").Bot | undefined,
-  groupId: number,
-  userId: number,
+  groupId: string,
+  userId: string,
 ): Promise<string> {
   try {
     if (!bot) return String(userId);
@@ -22,7 +22,7 @@ export async function resolveMemberName(
 }
 
 interface PendingMember {
-  userId: number;
+  userId: string;
   memberName: string;
 }
 
@@ -42,7 +42,7 @@ function getBatchMap(): Map<string, BatchState> {
   return state[RUNTIME_KEY] as Map<string, BatchState>;
 }
 
-function batchKey(selfId: string | number, groupId: number): string {
+function batchKey(selfId: string, groupId: string): string {
   return `${selfId}:${groupId}`;
 }
 
@@ -68,16 +68,16 @@ async function flushBatch(options: {
   ctx: MiokuContext;
   aiService?: AIService;
   config: AdminConfig;
-  selfId: string | number;
-  groupId: number;
+  selfId: string;
+  groupId: string;
   groupName: string;
   members: PendingMember[];
   promptInjections?: { content: string; title?: string }[];
   bot?: import("mioku").Bot;
   tryCustomPrompt?: (info: {
-    selfId: string | number;
-    groupId: number;
-    userId: number;
+    selfId: string;
+    groupId: string;
+    userId: string;
     groupName: string;
   }, bot?: import("mioku").Bot) => Promise<boolean>;
 }): Promise<string> {
@@ -135,13 +135,13 @@ async function flushBatch(options: {
 
   try {
     await chatRuntime.generateNotice({
-      selfId: Number(selfId),
+      selfId,
       groupId,
       send: true,
       instruction: [
         `当前有 ${members.length} 位新成员同时入群，请一次性发送一段统一的欢迎语（不要逐个 @ 欢迎、不要重复点名）不要长篇大论，精简即可。`,
         `新成员昵称：${userList}`,
-        `新成员 QQ：${userIdList}`,
+        `新成员 ID：${userIdList}`,
         `所在群：${groupName}`,
         `${config.welcome.aiPrompt || ""}`,
       ].join("\n"),
@@ -159,17 +159,17 @@ async function sendSingleWelcome(options: {
   ctx: MiokuContext;
   aiService?: AIService;
   config: AdminConfig;
-  selfId: string | number;
-  groupId: number;
+  selfId: string;
+  groupId: string;
   groupName: string;
-  userId: number;
+  userId: string;
   memberName: string;
   promptInjections?: { content: string; title?: string }[];
   bot?: import("mioku").Bot;
   tryCustomPrompt?: (info: {
-    selfId: string | number;
-    groupId: number;
-    userId: number;
+    selfId: string;
+    groupId: string;
+    userId: string;
     groupName: string;
   }, bot?: import("mioku").Bot) => Promise<boolean>;
 }): Promise<void> {
@@ -211,16 +211,16 @@ export async function triggerSingleWelcome(options: {
   ctx: MiokuContext;
   aiService?: AIService;
   getConfig: () => AdminConfig;
-  selfId: string | number;
-  groupId: number;
+  selfId: string;
+  groupId: string;
   groupName: string;
-  userId: number;
+  userId: string;
   memberName?: string;
   promptInjections?: { content: string; title?: string }[];
   tryCustomPrompt?: (info: {
-    selfId: string | number;
-    groupId: number;
-    userId: number;
+    selfId: string;
+    groupId: string;
+    userId: string;
     groupName: string;
   }, bot?: import("mioku").Bot) => Promise<boolean>;
 }, bot?: import("mioku").Bot): Promise<void> {
@@ -252,15 +252,15 @@ export function registerWelcomeHandler(
   aiService: AIService | undefined,
   getConfig: () => AdminConfig,
   shouldSuppress?: (info: {
-    selfId: string | number;
-    groupId: number;
-    userId: number;
+    selfId: string;
+    groupId: string;
+    userId: string;
     groupName: string;
   }, bot?: import("mioku").Bot) => Promise<boolean> | boolean,
   tryCustomPrompt?: (info: {
-    selfId: string | number;
-    groupId: number;
-    userId: number;
+    selfId: string;
+    groupId: string;
+    userId: string;
     groupName: string;
   }, bot?: import("mioku").Bot) => Promise<boolean>,
 ): () => void {
@@ -272,13 +272,13 @@ export function registerWelcomeHandler(
       const cfg = getConfig();
       const bot = event.bot;
       const selfId = event?.self_id || ctx.self_id || "";
-      const groupId = Number(event?.group_id || 0);
-      const userId = Number(event?.user_id || 0);
+      const groupId = String(event?.group_id ?? "").trim();
+      const userId = String(event?.user_id ?? "").trim();
       if (!groupId || !userId) return;
       if (selfId != null && String(userId) === String(selfId)) return;
 
       const groupName =
-        String((event.raw as { group_name?: string } | undefined)?.group_name || "").trim() || String(groupId);
+        String((event.raw as { group_name?: string } | undefined)?.group_name || "").trim() || groupId;
 
       if (
         shouldSuppress &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-plugin-admin",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "管理插件，提供事件通知与群管/个人管理指令",
   "main": "index.ts",
   "type": "module",

package/skills/group.ts

@@ -7,8 +7,8 @@ interface GroupRuntime {
   ctx: { logger?: { error?: (...args: unknown[]) => void } };
   event: MessageEvent;
   bot: Bot;
-  groupId: number;
-  selfId: number;
+  groupId: string;
+  selfId: string;
 }
 
 interface SkillRuntimeContext {
@@ -24,10 +24,10 @@ function resolveGroupRuntime(runtimeCtx: SkillRuntimeContext | undefined):
   if (!ctx) return { error: "无法获取上下文" };
 
   const event = runtimeCtx?.event ?? runtimeCtx?.rawEvent;
-  const groupId = Number(event?.group_id ?? 0);
+  const groupId = String(event?.group_id ?? "").trim();
   if (!groupId) return { error: "这个工具只能在群聊中使用" };
 
-  const selfId = Number(event?.self_id ?? 0);
+  const selfId = String(event?.self_id ?? "").trim();
   if (!selfId) return { error: "无法获取Bot ID" };
 
   const bot = event?.bot;
@@ -161,7 +161,7 @@ const groupAdminSkill: AISkill = {
               return { success: true, message: `已将 ${userId} 的头衔设为 "${title}"` };
             }
             case "set_self_title": {
-              const userId = Number(event.user_id);
+              const userId = String(event.user_id ?? "").trim();
               if (!userId) return { error: "无法获取当前用户ID" };
               const title = String((args as { title?: unknown })?.title ?? "").trim();
               if (!title) return { error: "set_self_title 需要提供 title" };
@@ -244,8 +244,10 @@ const groupAdminSkill: AISkill = {
               return { success: true, message: `Bot在当前群的群名片已修改为 ${card}` };
             }
             case "set_group_avatar": {
-              const messageId = Number((args as { message_id?: unknown })?.message_id);
-              if (!Number.isFinite(messageId) || messageId <= 0) {
+              const messageId = String(
+                (args as { message_id?: unknown })?.message_id ?? "",
+              ).trim();
+              if (!messageId) {
                 return { error: "set_group_avatar 需要提供有效的 message_id" };
               }
               const imageUrl = await getImageUrlByMessageId(bot, messageId);

package/skills/message-image.ts

@@ -1,18 +1,28 @@
 import type { Bot } from "mioku";
 
+/** 通过框架能力取消息里的第一张图片(适配器各自实现,不依赖 OneBot 原生 action) */
 export async function getImageUrlByMessageId(
   bot: Bot,
-  messageId: number,
+  messageId: string,
 ): Promise<string | null> {
   try {
-    const msg = await bot.sendApi<{
-      message?: Array<{ type?: string; url?: string; file?: string }>;
-    }>("get_msg", { message_id: messageId });
+    const msg = await bot.getMessage(messageId);
     const segments = Array.isArray(msg?.message) ? msg.message : [];
-    const imageSeg = segments.find((seg) => seg?.type === "image");
-    if (!imageSeg) return null;
-
-    return imageSeg.url || imageSeg.file || null;
+    for (const segment of segments) {
+      if (segment?.type !== "image") continue;
+      const data = (segment.data ?? {}) as Record<string, unknown>;
+      const attachment = segment.attachment as
+        | { url?: string; file?: string }
+        | undefined;
+      const url =
+        (typeof data.url === "string" && data.url) ||
+        (typeof data.file === "string" && data.file) ||
+        attachment?.url ||
+        attachment?.file ||
+        "";
+      if (url) return url;
+    }
+    return null;
   } catch {
     return null;
   }

package/skills/personal.ts

@@ -101,8 +101,8 @@ const personalSkill: AISkill = {
         try {
           switch (action) {
             case "set_avatar": {
-              const messageId = Number(a?.message_id);
-              if (!Number.isFinite(messageId) || messageId <= 0) {
+              const messageId = String(a?.message_id ?? "").trim();
+              if (!messageId) {
                 return { error: "set_avatar 需要提供有效的 message_id" };
               }
               const imageUrl = await getImageUrlByMessageId(bot, messageId);

package/utils/prompt-image-store.ts

@@ -20,7 +20,7 @@ export interface SavedPromptImage {
   size: number;
 }
 
-export function getGroupPromptImageDir(groupId: number): string {
+export function getGroupPromptImageDir(groupId: string): string {
   return path.join(
     getPluginDataDir("admin"),
     String(groupId),
@@ -28,13 +28,13 @@ export function getGroupPromptImageDir(groupId: number): string {
   );
 }
 
-export function ensureGroupPromptImageDir(groupId: number): string {
+export function ensureGroupPromptImageDir(groupId: string): string {
   const dir = getGroupPromptImageDir(groupId);
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
   return dir;
 }
 
-export function getGroupPromptImagePath(groupId: number, filename: string): string {
+export function getGroupPromptImagePath(groupId: string, filename: string): string {
   return path.join(getGroupPromptImageDir(groupId), filename);
 }
 
@@ -57,7 +57,7 @@ function generateFilename(ext: string): string {
 }
 
 export async function saveRemoteImageAsPrompt(
-  groupId: number,
+  groupId: string,
   sourceUrl: string,
 ): Promise<SavedPromptImage | null> {
   const trimmed = String(sourceUrl || "").trim();
@@ -95,7 +95,7 @@ export async function saveRemoteImageAsPrompt(
 }
 
 async function copyLocalFileAsPrompt(
-  groupId: number,
+  groupId: string,
   filePath: string,
 ): Promise<SavedPromptImage | null> {
   try {
@@ -171,7 +171,7 @@ function downloadToFile(url: string, savePath: string): Promise<number> {
 }
 
 export async function deletePromptImage(
-  groupId: number,
+  groupId: string,
   filename: string,
 ): Promise<void> {
   if (!filename) return;
@@ -182,7 +182,7 @@ export async function deletePromptImage(
 }
 
 export async function pruneGroupPromptImages(
-  groupId: number,
+  groupId: string,
   keep: readonly string[],
 ): Promise<void> {
   const dir = getGroupPromptImageDir(groupId);

package/verify/config.ts

@@ -3,7 +3,7 @@ export type VerifyMode = "reaction" | "number" | "chiral";
 export const MAX_CUSTOM_PROMPT_LENGTH = 50;
 
 export interface VerifyGroupConfig {
-  groupId: number;
+  groupId: string;
   enabled: boolean;
   mode: VerifyMode;
   customPrompt: string;
@@ -71,14 +71,14 @@ export function normalizeVerifyMode(value: unknown): VerifyMode {
 }
 
 function normalizeVerifyGroup(raw: any): VerifyGroupConfig {
-  const groupId = Number(raw?.groupId || raw?.group_id || 0);
+  const groupId = String(raw?.groupId ?? raw?.group_id ?? "").trim();
   const promptImageRaw =
     raw?.promptImage ??
     raw?.prompt_image ??
     (Array.isArray(raw?.promptImages) ? raw.promptImages[0] : undefined) ??
     (Array.isArray(raw?.images) ? raw.images[0] : undefined);
   return {
-    groupId: groupId > 0 ? groupId : 0,
+    groupId,
     enabled: raw?.enabled === true,
     mode: normalizeVerifyMode(raw?.mode),
     customPrompt: normalizeCustomPrompt(
@@ -92,7 +92,7 @@ export function normalizeVerifyConfig(raw: any): VerifyConfig {
   const groups: VerifyGroupConfig[] = Array.isArray(raw?.groups)
     ? raw.groups
         .map((g: any) => normalizeVerifyGroup(g))
-        .filter((g: VerifyGroupConfig) => g.groupId > 0)
+        .filter((g: VerifyGroupConfig) => g.groupId.length > 0)
     : [];
 
   const numOr = (value: unknown, fallback: number): number => {
@@ -142,7 +142,7 @@ export function normalizeVerifyConfig(raw: any): VerifyConfig {
 
 export function getGroupVerifyConfig(
   config: VerifyConfig,
-  groupId: number,
+  groupId: string,
 ): VerifyGroupConfig {
   const found = config.groups.find((g) => g.groupId === groupId);
   if (found) return found;
@@ -157,7 +157,7 @@ export function getGroupVerifyConfig(
 
 export function upsertGroupVerifyConfig(
   config: VerifyConfig,
-  groupId: number,
+  groupId: string,
   patch: Partial<Omit<VerifyGroupConfig, "groupId">>,
 ): VerifyConfig {
   const idx = config.groups.findIndex((g) => g.groupId === groupId);