@lark-apaas/coding-template-nestjs-react-fullstack 0.1.36-alpha.20260903095202 → 0.1.36-alpha.20260903185731

package/template/client/src/components/business-ui/api/chats/queries.ts

@@ -1,39 +0,0 @@
-'use client';
-
-import { useQuery, queryOptions, type QueryClient } from '@tanstack/react-query';
-
-import { listChatsByIds, searchChats } from './service';
-
-export const chatQueries = {
-  all: () => ['chats'] as const,
-  search: (query: string, pageSize: number = 100) =>
-    queryOptions({
-      queryKey: [...chatQueries.all(), 'search', query, pageSize],
-      queryFn: () => searchChats({ query, pageSize }),
-      staleTime: 1 * 60 * 1000,
-      gcTime: 5 * 60 * 1000,
-      enabled: query.length > 0,
-    }),
-  byIds: (chatIds: string[]) =>
-    queryOptions({
-      queryKey: [...chatQueries.all(), 'byIds', chatIds.join(',')],
-      queryFn: () => listChatsByIds(chatIds),
-      staleTime: 1 * 60 * 1000,
-      gcTime: 5 * 60 * 1000,
-      enabled: chatIds.length > 0,
-    }),
-};
-
-/**
- * 批量获取群组信息的 hook
- */
-export function useChatsByIds(chatIds: string[]) {
-  return useQuery(chatQueries.byIds(chatIds));
-}
-
-/**
- * 清除群组缓存
- */
-export function clearChatCache(queryClient: QueryClient): void {
-  queryClient.invalidateQueries({ queryKey: chatQueries.all() });
-}

package/template/client/src/components/business-ui/api/chats/service.ts

@@ -1,29 +0,0 @@
-import {
-  ChatService,
-  type BatchGetChatsResponse,
-  type ChatInfo,
-  type SearchChatsParams,
-  type SearchChatsResponse,
-} from '@lark-apaas/client-toolkit/tools/services';
-
-const chatService = new ChatService();
-
-/**
- * 搜索群组
- */
-export async function searchChats(
-  params: SearchChatsParams,
-): Promise<SearchChatsResponse> {
-  return chatService.searchChats(params);
-}
-
-/**
- * 批量根据群组 ID 查询群组信息
- */
-export async function listChatsByIds(
-  chatIds: string[],
-): Promise<BatchGetChatsResponse> {
-  return chatService.listChatsByIds(chatIds);
-}
-
-export type { BatchGetChatsResponse, ChatInfo, SearchChatsParams, SearchChatsResponse };

package/template/client/src/components/business-ui/api/departments/queries.ts

@@ -1,42 +0,0 @@
-'use client';
-
-import { useQuery, queryOptions, type QueryClient } from '@tanstack/react-query';
-
-import { searchDepartments } from './service';
-
-export const departmentQueries = {
-  all: () => ['departments'] as const,
-  search: (query: string, pageSize: number = 100) =>
-    queryOptions({
-      queryKey: [...departmentQueries.all(), 'search', query, pageSize],
-      queryFn: () => searchDepartments({ query, pageSize }),
-      staleTime: 1 * 60 * 1000,
-      gcTime: 5 * 60 * 1000,
-      enabled: query.length > 0,
-    }),
-};
-
-export type UseSearchDepartmentsOptions = {
-  query: string;
-  pageSize?: number;
-  enabled?: boolean;
-};
-
-/**
- * 搜索部门的 hook
- */
-export function useSearchDepartments(options: UseSearchDepartmentsOptions) {
-  const { query, pageSize = 100, enabled = true } = options;
-
-  return useQuery({
-    ...departmentQueries.search(query, pageSize),
-    enabled: enabled && query.length > 0,
-  });
-}
-
-/**
- * 清除部门缓存
- */
-export function clearDepartmentCache(queryClient: QueryClient): void {
-  queryClient.invalidateQueries({ queryKey: departmentQueries.all() });
-}

package/template/client/src/components/business-ui/api/departments/service.ts

@@ -1,18 +0,0 @@
-import {
-  DepartmentService,
-  type SearchDepartmentsParams,
-  type SearchDepartmentsResponse,
-} from '@lark-apaas/client-toolkit/tools/services';
-
-const departmentService = new DepartmentService();
-
-/**
- * 搜索部门
- */
-export async function searchDepartments(
-  params: SearchDepartmentsParams,
-): Promise<SearchDepartmentsResponse> {
-  return departmentService.searchDepartments(params);
-}
-
-export type { SearchDepartmentsParams, SearchDepartmentsResponse };

package/template/client/src/components/business-ui/api/files/service.ts

@@ -1,28 +0,0 @@
-'use client';
-import { getDataloom } from '@lark-apaas/client-toolkit/dataloom';
-import { getDefaultBucketId } from '@lark-apaas/client-toolkit/tools/storage';
-
-export interface UploadFileData {
-  id: string;
-  filePath: string;
-  bucketId: string;
-  url: string;
-}
-
-export async function uploadFile(file: File): Promise<UploadFileData> {
-  const dataloom = await getDataloom();
-  const bucket = dataloom.storage.from(getDefaultBucketId());
-
-  const result = await bucket.uploadFile(file);
-
-  if (result.error) {
-    throw result.error;
-  }
-
-  return {
-    id: result.data.id,
-    filePath: result.data.file_path,
-    bucketId: result.data.bucket_id,
-    url: result.data.download_url,
-  };
-}

package/template/client/src/components/business-ui/api/user-profiles/queries.ts

@@ -1,42 +0,0 @@
-'use client';
-
-import { useQuery, queryOptions, type QueryClient } from '@tanstack/react-query';
-
-import { fetchUserProfile, type AccountType } from './service';
-
-export const userProfileQueries = {
-  all: () => ['userProfiles'] as const,
-  byId: (userId: string, accountType: AccountType = 'apaas') =>
-    queryOptions({
-      queryKey: [...userProfileQueries.all(), 'byId', accountType, userId],
-      queryFn: ({ signal }) => fetchUserProfile(userId, accountType, signal),
-      staleTime: 1 * 60 * 1000,
-      gcTime: 5 * 60 * 1000,
-      enabled: !!userId,
-    }),
-};
-
-export type UseUserProfileOptions = {
-  userId: string;
-  accountType?: AccountType;
-  enabled?: boolean;
-};
-
-/**
- * 获取用户 Profile 卡片数据的 hook
- */
-export function useUserProfile(options: UseUserProfileOptions) {
-  const { userId, accountType = 'apaas', enabled = true } = options;
-
-  return useQuery({
-    ...userProfileQueries.byId(userId, accountType),
-    enabled: enabled && !!userId,
-  });
-}
-
-/**
- * 清除用户 Profile 缓存
- */
-export function clearUserProfileCache(queryClient: QueryClient): void {
-  queryClient.invalidateQueries({ queryKey: userProfileQueries.all() });
-}

package/template/client/src/components/business-ui/api/user-profiles/service.ts

@@ -1,23 +0,0 @@
-import {
-  UserProfileService,
-  getAssetsUrl,
-  type AccountType,
-  type UserProfileData,
-} from '@lark-apaas/client-toolkit/tools/services';
-
-const userProfileService = new UserProfileService();
-
-/**
- * 获取用户 Profile 卡片数据
- */
-export async function fetchUserProfile(
-  userId: string,
-  accountType: AccountType = 'apaas',
-  signal?: AbortSignal,
-): Promise<UserProfileData> {
-  return userProfileService.getUserProfile(userId, accountType, signal);
-}
-
-// Re-export for convenience
-export { getAssetsUrl };
-export type { AccountType, UserProfileData };

package/template/client/src/components/business-ui/api/users/queries.ts

@@ -1,34 +0,0 @@
-'use client';
-
-import { useQuery, queryOptions, type QueryClient } from '@tanstack/react-query';
-
-import { listUsersByIds, type AccountType } from './service';
-
-export const userQueries = {
-  all: () => ['users'] as const,
-  byIds: (userIds: string[], accountType: AccountType = 'apaas') =>
-    queryOptions({
-      queryKey: [...userQueries.all(), 'byIds', accountType, userIds.join(',')],
-      queryFn: () => listUsersByIds(userIds),
-      staleTime: 1 * 60 * 1000,
-      gcTime: 5 * 60 * 1000,
-      enabled: userIds.length > 0,
-    }),
-};
-
-/**
- * 批量获取用户信息的 hook
- */
-export function useUsersByIds(
-  userIds: string[],
-  accountType: AccountType = 'apaas',
-) {
-  return useQuery(userQueries.byIds(userIds, accountType));
-}
-
-/**
- * 清除用户缓存
- */
-export function clearUserCache(queryClient: QueryClient): void {
-  queryClient.invalidateQueries({ queryKey: userQueries.all() });
-}

package/template/client/src/components/business-ui/api/users/service.ts

@@ -1,40 +0,0 @@
-import {
-  UserService,
-  type AccountType,
-  type SearchUsersParams,
-  type SearchUsersResponse,
-  type BatchGetUsersResponse,
-  type ConvertExternalContactResponse,
-} from '@lark-apaas/client-toolkit/tools/services';
-
-const userService = new UserService();
-
-/**
- * 搜索用户
- */
-export async function searchUsers(
-  params: SearchUsersParams,
-): Promise<SearchUsersResponse> {
-  return userService.searchUsers({ ...params, searchExternalContact: true });
-}
-
-/**
- * 批量根据用户 ID 查询用户信息
- */
-export async function listUsersByIds(
-  userIds: string[],
-): Promise<BatchGetUsersResponse> {
-  const numericIds = userIds.filter((id) => !isNaN(Number(id)));
-  return userService.listUsersByIds(numericIds);
-}
-
-/**
- * 调用开户接口，将外部联系人的 larkUserID 转换为已注册用户
- */
-export async function convertExternalContact(
-  larkUserID: string,
-): Promise<ConvertExternalContactResponse> {
-  return userService.convertExternalContact(larkUserID);
-}
-
-export type { AccountType, SearchUsersParams, SearchUsersResponse, BatchGetUsersResponse, ConvertExternalContactResponse };

package/template/client/src/components/business-ui/chat-select/README.md

@@ -1,128 +0,0 @@
-# ChatSelect 群组选择组件
-
-**组件路径**：`@/components/business-ui/chat-select`
-
----
-
-## 群组类型
-
-```typescript
-/** 群组数据结构 */
-interface Chat {
-  /** 唯一标识：对应 chatID */
-  id: string;
-  /** 群组名称：内部优先 zh_cn，其次 en_us */
-  name: string;
-  /** 头像：URL 或 16 进制 RGB 颜色 */
-  avatar: string;
-}
-```
-
----
-
-## 功能概述
-
-- 群组字段选择组件，用于表单中录入"群组"字段
-- 通过触发器打开弹层，弹层内置搜索功能（始终可用）
-- **仅支持 ID 模式**：`value/onChange` 只使用群组 `chatID`（string），该 ID 为飞书群聊 ID。
-- 组件在 UI 上可展示群组信息（头像/名称），但对外值仅返回/接收 `chatID`
-- 选择后自动回显已选群组信息：群头像 + 群名称（多选以 tag 形式展示）
-- 组件自带群组检索能力，无需额外传搜索接口/数据源
-
-## 类型定义
-
-```typescript
-/** 触发器类型 */
-type TriggerType = 'button' | 'search' | 'custom';
-
-/** 单选模式 Props */
-interface ChatSelectSingleProps {
-  /** 当前选中的群组 ID，空值为 null */
-  value: string | null;
-  /** 选中变化回调 */
-  onChange: (value: string | null) => void;
-  /** 是否多选，单选时为 false 或不传 */
-  multiple?: false;
-  /** 触发器类型，仅影响样式，不影响搜索功能 */
-  triggerType?: TriggerType;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 占位文本 */
-  placeholder?: string;
-}
-
-/** 多选模式 Props */
-interface ChatSelectMultipleProps {
-  /** 当前选中的群组 ID 列表，空值为 [] */
-  value: string[];
-  /** 选中变化回调 */
-  onChange: (value: string[]) => void;
-  /** 是否多选，多选时为 true */
-  multiple: true;
-  /** 触发器类型 */
-  triggerType?: TriggerType;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 占位文本 */
-  placeholder?: string;
-}
-
-type ChatSelectProps = ChatSelectSingleProps | ChatSelectMultipleProps;
-```
-
-## Props 说明
-
-| 属性 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `value` | `string \| null` / `string[]` | - | **必填**。单选传 `string \| null`（群组 ID），多选传 `string[]` |
-| `onChange` | `function` | - | **必填**。值变化回调，返回值形态与 `value` 匹配 |
-| `multiple` | `boolean` | `false` | 是否多选 |
-| `triggerType` | `'button' \| 'search' \| 'custom'` | `'button'` | 触发器类型，仅影响样式 |
-| `disabled` | `boolean` | `false` | 是否禁用 |
-| `placeholder` | `string` | `'请选择'` | 占位文本 |
-| `getOptionDisabled` | `(chat) => boolean` | - | 判断选项是否禁用 |
-
-## 受控规范
-
-> ⚠️ **强约束**
-
-1. **必须受控**：始终传 `value` + `onChange`
-2. **禁止传**：`undefined` / 群组对象 / 其他类型
-3. **空值规则**：
-   - 单选清空：`null`
-   - 多选清空：`[]`
-
-## 使用示例
-
-```tsx
-import { useState } from 'react';
-import { ChatSelect } from '@/components/business-ui/chat-select';
-
-// 单选
-function SingleSelectExample() {
-  const [chatId, setChatId] = useState<string | null>(null);
-
-  return (
-    <ChatSelect
-      value={chatId}
-      onChange={setChatId}
-      placeholder="请选择群组"
-    />
-  );
-}
-
-// 多选
-function MultipleSelectExample() {
-  const [chatIds, setChatIds] = useState<string[]>([]);
-
-  return (
-    <ChatSelect
-      multiple
-      value={chatIds}
-      onChange={setChatIds}
-      placeholder="请选择群组"
-      getOptionDisabled={(chat) => chat.id === 'disabled-id'}
-    />
-  );
-}
-```

package/template/client/src/components/business-ui/chat-select/chat-item.tsx

@@ -1,85 +0,0 @@
-'use client';
-
-import React from 'react';
-
-import type { Chat } from '@client/src/components/business-ui/chat-select/types';
-import { BaseComboboxItem } from '@client/src/components/business-ui/entity-combobox/base-combobox-item';
-import { HighlightText } from '@client/src/components/business-ui/entity-combobox/highlight-text';
-import { isHexColor } from '@client/src/components/business-ui/entity-combobox/item-pill';
-import {
-  listItemAvatarVariants,
-  listItemNameVariants,
-  listItemSubTextVariants,
-  listItemVariants,
-  type ComboboxSize,
-} from '@client/src/components/business-ui/entity-combobox/size-variants';
-import { cn } from '@/lib/utils';
-import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar';
-
-const ExternalChatTag = () => (
-  <span className="inline-flex shrink-0 items-center rounded-sm bg-blue-500/20 px-1.5 py-0.5 text-xs leading-4 text-blue-900 dark:text-blue-200">
-    外部
-  </span>
-);
-
-export const ChatItem = ({
-  chatValue,
-  isSelected,
-  className,
-  size = 'medium',
-  searchKeyword,
-  disabled,
-}: {
-  chatValue: Chat;
-  isSelected: boolean;
-  className?: string;
-  size?: ComboboxSize;
-  searchKeyword?: string;
-  disabled?: boolean;
-}) => {
-  const chat = chatValue.raw;
-  const displayName = chat?.name?.zh_cn || chat?.name?.en_us || chatValue.name;
-  const userCount = chat?.userCount;
-  const isExternal = chat?.isExternal;
-
-  const isHex = isHexColor(chat?.avatar);
-
-  const avatarImage = !isHex ? (
-    <AvatarImage src={chat?.avatar} alt={displayName} loading="eager" />
-  ) : (
-    <AvatarFallback style={{ backgroundColor: chat?.avatar }}>
-      {displayName?.charAt?.(0).toUpperCase()}
-    </AvatarFallback>
-  );
-
-  return (
-    <BaseComboboxItem
-      item={chatValue}
-      getItemValue={(item) => item}
-      isSelected={isSelected}
-      className={cn(listItemVariants({ size }), className)}
-      disabled={disabled}
-    >
-      <Avatar className={listItemAvatarVariants({ size })}>
-        {chat?.avatar ? (
-          avatarImage
-        ) : (
-          <AvatarFallback>{displayName?.charAt?.(0)}</AvatarFallback>
-        )}
-      </Avatar>
-      <div className="flex min-w-0 flex-1 items-center gap-1">
-        <HighlightText
-          text={chatValue.name}
-          highlight={searchKeyword}
-          className={cn(listItemNameVariants({ size }), 'truncate')}
-        />
-        {userCount != null && (
-          <span className={cn(listItemSubTextVariants({ size }), 'shrink-0')}>
-            ({userCount})
-          </span>
-        )}
-        {isExternal && <ExternalChatTag />}
-      </div>
-    </BaseComboboxItem>
-  );
-};

package/template/client/src/components/business-ui/chat-select/chat-select-tag.tsx

@@ -1,83 +0,0 @@
-'use client';
-
-import React from 'react';
-
-import { X } from 'lucide-react';
-
-import type { Chat } from '@client/src/components/business-ui/chat-select/types';
-import {
-  ItemPill,
-  renderPillAvatar,
-} from '@client/src/components/business-ui/entity-combobox/item-pill';
-import {
-  tagCloseIconVariants,
-  type ComboboxSize,
-} from '@client/src/components/business-ui/entity-combobox/size-variants';
-import { Skeleton } from '@/components/ui/skeleton';
-
-export const ChatSelectTag = ({
-  chatValue,
-  onClose,
-  maxTextLength,
-  className,
-  size = 'medium',
-  disabled,
-  isLoading,
-}: {
-  chatValue: Chat;
-  onClose: (value: Chat, e: React.MouseEvent) => void;
-  maxTextLength?: number;
-  className?: string;
-  size?: ComboboxSize;
-  disabled?: boolean;
-  /**
-   * 是否正在加载群组信息（ID 模式下查询中）
-   */
-  isLoading?: boolean;
-}) => {
-  const chat = chatValue.raw;
-
-  const handleClose = (e: React.MouseEvent) => {
-    e.stopPropagation();
-    onClose(chatValue, e);
-  };
-
-  const closeButton = !disabled ? (
-    <button
-      type="button"
-      className="rounded-sm text-foreground opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none"
-      onClick={handleClose}
-    >
-      <X className={tagCloseIconVariants({ size })} />
-      <span className="sr-only">移除 {chatValue.name}</span>
-    </button>
-  ) : null;
-
-  // 加载中状态显示 Skeleton
-  if (isLoading && !chat) {
-    return (
-      <div className="inline-flex items-center gap-1 rounded-md bg-secondary px-1.5 py-0.5">
-        <Skeleton className="h-4 w-4 rounded-full" />
-        <Skeleton className="h-3 w-12" />
-      </div>
-    );
-  }
-
-  const avatarElement = renderPillAvatar({
-    avatarUrl: chatValue.avatar || chat?.avatar,
-    label: chatValue.name,
-    size,
-  });
-
-  return (
-    <ItemPill
-      label={chatValue.name}
-      avatar={avatarElement}
-      className={className}
-      maxTextLength={maxTextLength}
-      suffix={closeButton}
-      size={size}
-      disabled={disabled}
-    />
-  );
-};