feat: let Feishu onboarding create projects in folders

hub/src/feishu/projectOnboardingCard.ts

@@ -4,31 +4,42 @@ export interface OnboardingProjectOption {
   readonly folderName?: string | undefined;
 }
 
+export interface OnboardingFolderOption {
+  readonly folderId: string;
+  readonly name: string;
+}
+
 export interface ProjectOnboardingActionValue {
   readonly action: "create_project_from_chat" | "bind_project";
   readonly organization_id: string;
   readonly project_id?: string | undefined;
+  readonly folder_id?: string | undefined;
 }
 
 export function buildUnboundChatOnboardingCard(params: {
   readonly organizationId: string;
   readonly organizationName: string;
+  readonly folders: readonly OnboardingFolderOption[];
   readonly projects: readonly OnboardingProjectOption[];
   readonly canCreateProject: boolean;
 }): Record<string, unknown> {
   const actions: unknown[] = [];
   if (params.canCreateProject) {
-    actions.push({
-      tag: "button",
-      text: { tag: "plain_text", content: "新建并绑定项目" },
-      type: "primary",
-      value: {
-        project_onboarding: {
-          action: "create_project_from_chat",
-          organization_id: params.organizationId,
+    const folders = params.folders.length === 0 ? [{ folderId: undefined, name: "默认位置" }] : params.folders.slice(0, 3);
+    for (const folder of folders) {
+      actions.push({
+        tag: "button",
+        text: { tag: "plain_text", content: `新建到 ${buttonLabel(folder.name, 14)}` },
+        type: "primary",
+        value: {
+          project_onboarding: {
+            action: "create_project_from_chat",
+            organization_id: params.organizationId,
+            ...(folder.folderId !== undefined ? { folder_id: folder.folderId } : {}),
+          },
         },
-      },
-    });
+      });
+    }
   }
 
   for (const project of params.projects.slice(0, 5)) {
@@ -53,7 +64,7 @@ export function buildUnboundChatOnboardingCard(params: {
         `这个飞书群还没有绑定项目。`,
         ``,
         `组织: **${escapeMarkdown(params.organizationName)}**`,
-        `可以新建一个项目并绑定到本群，或绑定你已经有管理权限的未绑定项目。`,
+        `可以选择 folder 新建项目并绑定到本群，或绑定你已经有管理权限的未绑定项目。`,
       ].join("\n"),
     },
   ];
@@ -101,16 +112,21 @@ export function projectOnboardingActionFromValue(value: unknown): ProjectOnboard
   const rawAction = (action as { action?: unknown }).action;
   const organizationId = (action as { organization_id?: unknown }).organization_id;
   const projectId = (action as { project_id?: unknown }).project_id;
+  const folderId = (action as { folder_id?: unknown }).folder_id;
   if ((rawAction !== "create_project_from_chat" && rawAction !== "bind_project") || typeof organizationId !== "string" || organizationId === "") {
     return null;
   }
   if (rawAction === "bind_project" && (typeof projectId !== "string" || projectId === "")) {
     return null;
   }
+  if (folderId !== undefined && (typeof folderId !== "string" || folderId === "")) {
+    return null;
+  }
   return {
     action: rawAction,
     organization_id: organizationId,
     ...(typeof projectId === "string" && projectId !== "" ? { project_id: projectId } : {}),
+    ...(typeof folderId === "string" && folderId !== "" ? { folder_id: folderId } : {}),
   };
 }
 
@@ -126,7 +142,11 @@ function unwrapValue(value: unknown): unknown {
 function buttonProjectLabel(project: OnboardingProjectOption): string {
   const folderPrefix = project.folderName === undefined ? "" : `${project.folderName} / `;
   const label = `${folderPrefix}${project.name}`;
-  return label.length <= 24 ? label : `${label.slice(0, 21)}...`;
+  return buttonLabel(label, 24);
+}
+
+function buttonLabel(label: string, maxLength: number): string {
+  return label.length <= maxLength ? label : `${label.slice(0, maxLength - 3)}...`;
 }
 
 function escapeMarkdown(value: string): string {