create-bubbles 0.1.25 → 0.1.27

package/template-vp-monorepo-react-nestjs/apps/web/src/utils/request/core/utils.ts

@@ -1,4 +1,6 @@
+/** 递归合并普通对象，数组等非普通对象由目标值整体替换。 */
 export function deepMergeObject<T = any>(source: T, target: Partial<T>): T {
+  /** 递归复制并合并目标对象属性，目标值未定义时沿用源值。 */
   const merge = (src: any, tgt: any): any => {
     if (!isPlainObject(src) || !isPlainObject(tgt)) return tgt === undefined ? src : tgt
 
@@ -14,15 +16,18 @@ export function deepMergeObject<T = any>(source: T, target: Partial<T>): T {
   return merge(source, target)
 }
 
+/** 通过对象标签判断值是否为普通对象形态。 */
 export function isPlainObject(data: unknown): data is Record<string, any> {
   return Object.prototype.toString.call(data) === '[object Object]'
 }
 
+/** 在运行环境支持 ReadableStream 时判断响应体是否为流。 */
 export function isReadableStream(data: unknown): boolean {
   if (typeof ReadableStream === 'undefined') return false
   return data instanceof ReadableStream
 }
 
+/** 仅尝试解析对象或数组形式的 JSON 字符串，解析失败时保留原值。 */
 export function tryParseJsonString(data: unknown): unknown {
   if (typeof data !== 'string') return data
 

package/template-vp-monorepo-react-nestjs/apps/web/src/utils/request/index.ts

@@ -2,8 +2,9 @@ import { axiosRequestAdapter, type AlovaAxiosRequestConfig } from '@alova/adapte
 import reactHook, { type ReactHookExportType } from 'alova/react'
 import { message } from 'antd'
 import type { AxiosResponse, AxiosResponseHeaders } from 'axios'
-import { navigator } from '@/router'
+import { tr } from '@/i18n'
 import { envVariables } from '@/utils/env'
+import { cookie } from '@/utils/storage/cookie'
 import { createDualCallInstance, type BaseRequestOption } from './core/index.ts'
 
 type WebRequestOption = BaseRequestOption<
@@ -13,6 +14,7 @@ type WebRequestOption = BaseRequestOption<
   ReactHookExportType<unknown>
 >
 
+/** 保留完整 URL 和绝对路径，为相对接口前缀补齐开头斜杠。 */
 function normalizeBaseUrl(apiAffix?: string) {
   if (!apiAffix) return '/'
   if (/^https?:\/\//.test(apiAffix) || apiAffix.startsWith('/')) {
@@ -22,11 +24,12 @@ function normalizeBaseUrl(apiAffix?: string) {
   return `/${apiAffix}`
 }
 
+/** 组装 Web 请求配置，绑定登录凭据、提示方式及未授权跳转。 */
 function getBaseConfig(): WebRequestOption {
   return {
     baseUrl: normalizeBaseUrl(envVariables.API_AFFIX),
+    isWrapped: false,
     statusMap: {
-      success: [200, 201, 204],
       unAuthorized: 401,
     },
     codeMap: {
@@ -34,17 +37,24 @@ function getBaseConfig(): WebRequestOption {
       unAuthorized: [401],
     },
     responseDataKey: 'data',
-    responseMessageKey: 'msg',
-    commonHeaders: () => ({}),
+    responseMessageKey: 'message',
+    errorDefaultMessage: () => tr('请求失败，请稍后重试'),
+    /** 在发送请求时读取最新登录令牌，存在时附加 Bearer 鉴权头。 */
+    commonHeaders: () => {
+      const token = cookie.get('token')
+      return token ? { Authorization: `Bearer ${token}` } : {}
+    },
     successMessageFunc: (msg) => {
       message.success(msg)
     },
     errorMessageFunc: (msg) => {
       message.error(msg)
     },
+    /** 清除失效登录令牌，提示登录过期并跳转到登录页。 */
     unAuthorizedResponseFunc: () => {
-      void navigator('/login')
-      message.error('登录过期或未登录')
+      cookie.remove('token')
+      message.error(tr('登录过期或未登录'))
+      window.location.assign('/login')
     },
     statesHook: reactHook,
     requestAdapter: axiosRequestAdapter(),

package/template-vp-monorepo-react-nestjs/apps/web/src/utils/request/workspace.ts

@@ -0,0 +1,82 @@
+import request from './index'
+import { cookie } from '@/utils/storage/cookie'
+
+/** 权限和管理数据不进入 alova 缓存；每个工作空间代次都有独立的在途请求集合。 */
+export const workspaceRequest = request({
+  cacheFor: { GET: 0, POST: 0, PUT: 0, PATCH: 0, DELETE: 0, HEAD: 0, OPTIONS: 0 },
+  cacheLogger: false,
+  isShowErrorMessage: false,
+  /** 延后到请求代次校验后再处理 401，防止旧会话的迟到失败退出新会话。 */
+  unAuthorizedResponseFunc: () => {},
+})
+
+let currentKey = ''
+let generation = 0
+const pending = new Set<() => void>()
+
+/** 推进工作空间代次并中止所有在途请求，使迟到结果立即失效。 */
+export function clearWorkspaceRequests() {
+  generation += 1
+  for (const abort of pending) abort()
+  pending.clear()
+  currentKey = ''
+}
+
+/** 按会话令牌和工作空间键识别切换，切换时清理旧空间请求。 */
+export function enterWorkspace(key: string) {
+  const identityKey = `${cookie.get('token') ?? ''}:${key}`
+  if (identityKey !== currentKey) {
+    clearWorkspaceRequests()
+    currentKey = identityKey
+  }
+}
+
+/** 通知工作空间布局重新校验权限及导航数据。 */
+export function refreshAccess() {
+  window.dispatchEvent(new Event('workspace-access-refresh'))
+}
+
+export const freshRequest = { cacheFor: 0, shareRequest: false } as const
+
+/**
+ * 在指定工作空间代次内发送请求，丢弃跨账号、跨空间或已取消的结果。
+ * `workspaceKey` 必须由 API 创建时绑定，不能在实际发送时读取当前空间后补写。
+ */
+export async function runWorkspaceRequest<T>(options: {
+  method: { send: (force?: boolean) => Promise<T>; abort: () => void }
+  workspaceKey: string
+  signal?: AbortSignal
+  accessRequest?: boolean
+}): Promise<T> {
+  const { method, workspaceKey, signal, accessRequest } = options
+  const startedAt = generation
+  const token = cookie.get('token')
+  const identityKey = `${token ?? ''}:${workspaceKey}`
+  const abort = () => method.abort()
+  /** 检查取消信号、调用方空间、工作空间代次及登录令牌，判断请求是否已经过期。 */
+  const stale = () =>
+    signal?.aborted ||
+    currentKey !== identityKey ||
+    generation !== startedAt ||
+    token !== cookie.get('token')
+  if (stale()) throw new DOMException('请求已取消', 'AbortError')
+  pending.add(abort)
+  signal?.addEventListener('abort', abort, { once: true })
+  try {
+    const result = await method.send(true)
+    if (stale()) throw new DOMException('工作空间已切换', 'AbortError')
+    return result
+  } catch (error) {
+    if (stale()) throw new DOMException('工作空间已切换', 'AbortError')
+    if ((error as { status?: number }).status === 401) {
+      clearWorkspaceRequests()
+      cookie.remove('token')
+      window.location.assign('/login')
+    }
+    if (!accessRequest && (error as { status?: number }).status === 403) refreshAccess()
+    throw error
+  } finally {
+    pending.delete(abort)
+    signal?.removeEventListener('abort', abort)
+  }
+}

package/template-vp-monorepo-react-nestjs/apps/web/src/utils/safe-next.ts

@@ -0,0 +1,36 @@
+const INTERNAL_NAVIGATION_ORIGIN = 'https://wanwu.internal'
+
+export interface AuthPathOptions {
+  next?: string | null
+  registered?: boolean
+}
+
+/**
+ * 将外部输入约束为站内绝对路径，拒绝协议地址、协议相对地址及反斜杠绕过。
+ * @param value 查询参数中待校验的跳转目标。
+ * @param fallback 输入不安全或为空时使用的站内回退路径。
+ */
+export function safeNextPath(value: string | null | undefined, fallback = '/'): string {
+  const candidate = value?.trim()
+  if (!candidate?.startsWith('/') || candidate.startsWith('//') || candidate.includes('\\')) {
+    return fallback
+  }
+
+  try {
+    const parsed = new URL(candidate, INTERNAL_NAVIGATION_ORIGIN)
+    if (parsed.origin !== INTERNAL_NAVIGATION_ORIGIN) return fallback
+    return `${parsed.pathname}${parsed.search}${parsed.hash}`
+  } catch {
+    return fallback
+  }
+}
+
+/** 为登录或注册入口附加经过校验的站内 next，并可标记注册完成状态。 */
+export function buildAuthPath(path: '/login' | '/register', options: AuthPathOptions = {}): string {
+  const params = new URLSearchParams()
+  const next = safeNextPath(options.next)
+  if (next !== '/') params.set('next', next)
+  if (options.registered) params.set('registered', '1')
+  const query = params.toString()
+  return query ? `${path}?${query}` : path
+}

package/template-vp-monorepo-react-nestjs/apps/web/src/utils/storage/cookie.ts

@@ -0,0 +1,51 @@
+export interface CookieOptions {
+  path?: string
+  domain?: string
+  expires?: Date
+  /** 有效期，单位为秒；优先于 expires。 */
+  maxAge?: number
+  secure?: boolean
+  sameSite?: 'Strict' | 'Lax' | 'None'
+}
+
+export const cookie = {
+  /** 按编码后的名称查找 Cookie 并解码值，格式损坏时保留原值。 */
+  get(key: string): string | null {
+    const prefix = `${encodeURIComponent(key)}=`
+    const entry = document.cookie.split(';').find((item) => item.trim().startsWith(prefix))
+    if (entry === undefined) return null
+
+    const value = entry.trim().slice(prefix.length)
+    try {
+      return decodeURIComponent(value)
+    } catch {
+      return value
+    }
+  },
+
+  /** 同名 Cookie 在相同 path、domain 下写入即为更新。 */
+  set(key: string, value: string, options: CookieOptions = {}): void {
+    const { path = '/', domain, expires, maxAge, sameSite = 'Lax' } = options
+    const secure = options.secure ?? window.location.protocol === 'https:'
+    const attributes = [
+      `${encodeURIComponent(key)}=${encodeURIComponent(value)}`,
+      `Path=${path}`,
+      `SameSite=${sameSite}`,
+    ]
+
+    if (domain) attributes.push(`Domain=${domain}`)
+    if (expires) attributes.push(`Expires=${expires.toUTCString()}`)
+    if (maxAge !== undefined) attributes.push(`Max-Age=${Math.trunc(maxAge)}`)
+    if (secure) attributes.push('Secure')
+
+    document.cookie = attributes.join('; ')
+  },
+
+  /** 删除时的 path、domain 必须与写入时一致。 */
+  remove(
+    key: string,
+    options: Pick<CookieOptions, 'path' | 'domain' | 'secure' | 'sameSite'> = {},
+  ): void {
+    cookie.set(key, '', { ...options, maxAge: 0, expires: new Date(0) })
+  },
+}

package/template-vp-monorepo-react-nestjs/apps/web/src/utils/storage/session.ts

@@ -0,0 +1,34 @@
+/** 为本地或会话存储提供 JSON 序列化读写封装。 */
+function createStorage(type: 'localStorage' | 'sessionStorage') {
+  return {
+    /** 自动序列化为 JSON；同名写入即为更新。 */
+    set<T>(key: string, value: T): void {
+      const serialized = JSON.stringify(value)
+      if (serialized === undefined) throw new TypeError('存储值必须能够序列化为 JSON')
+      window[type].setItem(key, serialized)
+    },
+
+    /** 不存在或内容不是有效 JSON 时返回 null。 */
+    get<T = unknown>(key: string): T | null {
+      const value = window[type].getItem(key)
+      if (value === null) return null
+
+      try {
+        return JSON.parse(value) as T
+      } catch {
+        return null
+      }
+    },
+
+    remove(key: string): void {
+      window[type].removeItem(key)
+    },
+
+    clear(): void {
+      window[type].clear()
+    },
+  }
+}
+
+export const local = createStorage('localStorage')
+export const session = createStorage('sessionStorage')

package/template-vp-monorepo-react-nestjs/apps/web/test/draft-projects.spec.ts

@@ -0,0 +1,89 @@
+import { describe, expect, it } from 'vite-plus/test'
+import {
+  currentUser,
+  initialRecords,
+  type DraftProjectRecord,
+} from '../src/pages/examples/pro-table/draft/config'
+import {
+  filterProjectRecords,
+  saveProjectRecord,
+} from '../src/pages/examples/pro-table/draft/config/projects'
+
+describe('项目草稿演示', () => {
+  it('允许保存未填完的草稿，并与正式项目分开显示', () => {
+    const records = saveProjectRecord(initialRecords, {
+      values: { name: '  测试草稿  ' },
+      stage: 'draft',
+    })
+    const drafts = filterProjectRecords({ records, view: 'draft', search: {} })
+    expect(drafts).toHaveLength(4)
+    expect(drafts.find((record) => record.name === '测试草稿')).toMatchObject({
+      stage: 'draft',
+      createdBy: currentUser,
+    })
+    expect(drafts.find((record) => record.name === '测试草稿')?.owner).toBeUndefined()
+    expect(filterProjectRecords({ records, view: 'list', search: {} })).toHaveLength(18)
+  })
+
+  it('继续保存同一草稿不会产生重复记录，提交后保留编号并移入正式列表', () => {
+    const original = initialRecords.find((record) => record.id === 'PRJ-019')!
+    const saved = saveProjectRecord(initialRecords, {
+      original,
+      values: { name: '继续完善' },
+      stage: 'draft',
+    })
+    const updated = saved.find((record) => record.id === original.id)!
+    expect(saved).toHaveLength(initialRecords.length)
+    const submitted = saveProjectRecord(saved, {
+      original: updated,
+      values: {
+        name: '已完成项目',
+        owner: currentUser,
+        status: 'completed',
+        priority: 'medium',
+        progress: 75,
+        dueDate: '2026-10-01',
+        description: '',
+      },
+      stage: 'published',
+    })
+    expect(submitted.filter((record) => record.id === original.id)).toHaveLength(1)
+    expect(submitted.find((record) => record.id === original.id)).toMatchObject({
+      stage: 'published',
+      progress: 100,
+    })
+    expect(filterProjectRecords({ records: submitted, view: 'draft', search: {} })).toHaveLength(2)
+    expect(filterProjectRecords({ records: submitted, view: 'list', search: {} })).toHaveLength(19)
+  })
+
+  it('草稿可见性取决于创建人，负责人筛选不能显示其他人的草稿', () => {
+    const otherDraft: DraftProjectRecord = {
+      id: 'PRJ-099',
+      name: '其他人的草稿',
+      stage: 'draft',
+      createdBy: '其他人',
+      owner: currentUser,
+      savedAt: new Date().toISOString(),
+    }
+    const records = [...initialRecords, otherDraft]
+    expect(
+      filterProjectRecords({ records, view: 'draft', search: { owner: currentUser } }),
+    ).toHaveLength(3)
+    expect(
+      filterProjectRecords({ records, view: 'list', search: { name: 'PRJ-099' } }),
+    ).toHaveLength(0)
+  })
+
+  it('未填写业务状态的草稿仍可按编号搜索，状态筛选不把它当作待启动', () => {
+    expect(
+      filterProjectRecords({ records: initialRecords, view: 'draft', search: { name: 'prj-020' } }),
+    ).toHaveLength(1)
+    expect(
+      filterProjectRecords({
+        records: initialRecords,
+        view: 'draft',
+        search: { status: 'planning' },
+      }),
+    ).toHaveLength(2)
+  })
+})

package/template-vp-monorepo-react-nestjs/apps/web/test/i18n-locale.spec.ts

@@ -0,0 +1,22 @@
+import { describe, expect, it } from 'vitest'
+import { getUiLocale } from '@/i18n/ui-locale'
+
+describe('getUiLocale', () => {
+  it('maps Simplified Chinese to all supported locale adapters', () => {
+    const locale = getUiLocale('zh_CN')
+
+    expect(locale.antd.locale).toBe('zh-cn')
+    expect(locale.pro.locale).toBe('zh_CN')
+    expect(locale.dayjs).toBe('zh-cn')
+    expect(locale.document).toBe('zh-CN')
+  })
+
+  it('maps English to all supported locale adapters', () => {
+    const locale = getUiLocale('en_US')
+
+    expect(locale.antd.locale).toBe('en')
+    expect(locale.pro.locale).toBe('en_US')
+    expect(locale.dayjs).toBe('en')
+    expect(locale.document).toBe('en')
+  })
+})

package/template-vp-monorepo-react-nestjs/apps/web/test/icon-selector.spec.tsx

@@ -0,0 +1,23 @@
+import { describe, expect, it, vi } from 'vite-plus/test'
+import { IconSelector } from '../src/components/Icon/SvgAsset'
+import { svgAssets } from '../src/components/Icon/SvgAsset/SvgAssetRegistry'
+
+describe('菜单图标选择器', () => {
+  it('展示 SVG 目录中的全部资源并支持搜索、清空和回显', () => {
+    const onChange = vi.fn()
+    const element = IconSelector({ value: 'organization-template', onChange })
+    const props = element.props
+
+    expect(props.allowClear).toBe(true)
+    expect(props.showSearch).toBe(true)
+    expect(props.optionFilterProp).toBe('label')
+    expect(props.options.map((option: { value: string }) => option.value)).toEqual(
+      svgAssets.map((asset) => asset.key),
+    )
+    expect(
+      props.labelRender({ value: 'organization-template', label: 'organization-template' }),
+    ).toBeTruthy()
+    props.onChange?.('', { value: '' })
+    expect(onChange).toHaveBeenCalledWith('', { value: '' })
+  })
+})

package/template-vp-monorepo-react-nestjs/apps/web/test/latest-dialog-request.spec.ts

@@ -0,0 +1,89 @@
+import { describe, expect, it, vi } from 'vite-plus/test'
+import { createLatestDialogRequestController } from '../src/hooks/useLatestDialogRequest'
+
+interface Deferred<T> {
+  promise: Promise<T>
+  resolve: (value: T) => void
+}
+
+/** 创建可由测试控制完成时机的 Promise。 */
+function deferred<T>(): Deferred<T> {
+  let resolve: (value: T) => void = () => undefined
+  const promise = new Promise<T>((complete) => {
+    resolve = complete
+  })
+  return { promise, resolve }
+}
+
+/** 创建记录成功与失败回调的弹窗请求参数。 */
+function requestOptions(
+  targetId: string,
+  request: Deferred<string>,
+  opened: string[],
+  onError = vi.fn(),
+) {
+  return {
+    targetId,
+    load: () => request.promise,
+    onSuccess: (result: string) => opened.push(result),
+    onError,
+  }
+}
+
+describe('最新弹窗请求协调器', () => {
+  it('A 慢 B 快时只允许 B 打开弹窗', async () => {
+    const loading: Array<string | undefined> = []
+    const opened: string[] = []
+    const first = deferred<string>()
+    const second = deferred<string>()
+    const controller = createLatestDialogRequestController((targetId) => loading.push(targetId))
+
+    const firstRun = controller.run(requestOptions('A', first, opened))
+    const secondRun = controller.run(requestOptions('B', second, opened))
+    second.resolve('B')
+    await secondRun
+    first.resolve('A')
+    await firstRun
+
+    expect(opened).toEqual(['B'])
+    expect(loading).toEqual(['A', 'B', undefined])
+  })
+
+  it('A 的旧 finally 不会清除仍在加载的 B', async () => {
+    const loading: Array<string | undefined> = []
+    const opened: string[] = []
+    const first = deferred<string>()
+    const second = deferred<string>()
+    const controller = createLatestDialogRequestController((targetId) => loading.push(targetId))
+
+    const firstRun = controller.run(requestOptions('A', first, opened))
+    const secondRun = controller.run(requestOptions('B', second, opened))
+    first.resolve('A')
+    await firstRun
+
+    expect(opened).toEqual([])
+    expect(loading).toEqual(['A', 'B'])
+
+    second.resolve('B')
+    await secondRun
+    expect(opened).toEqual(['B'])
+    expect(loading).toEqual(['A', 'B', undefined])
+  })
+
+  it('失效后的请求不再执行成功或失败回调', async () => {
+    const loading: Array<string | undefined> = []
+    const opened: string[] = []
+    const pending = deferred<string>()
+    const onError = vi.fn()
+    const controller = createLatestDialogRequestController((targetId) => loading.push(targetId))
+
+    const run = controller.run(requestOptions('A', pending, opened, onError))
+    controller.invalidate()
+    pending.resolve('A')
+    await run
+
+    expect(opened).toEqual([])
+    expect(onError).not.toHaveBeenCalled()
+    expect(loading).toEqual(['A'])
+  })
+})

package/template-vp-monorepo-react-nestjs/apps/web/test/member-invitation-navigation.spec.ts

@@ -0,0 +1,34 @@
+import { describe, expect, it } from 'vite-plus/test'
+import { buildCompanyMemberInvitationLink } from '../src/pages/access/components/MemberOnboarding/CompanyMemberInvitation/invitation-link'
+import { buildAuthPath, safeNextPath } from '../src/utils/safe-next'
+
+describe('企业成员邀请导航', () => {
+  it('仅保留站内绝对路径作为登录后跳转目标', () => {
+    const invitationPath = '/member-invitations/accept?token=abc_123-xyz'
+    expect(safeNextPath(invitationPath)).toBe(invitationPath)
+    expect(safeNextPath('https://example.com/steal')).toBe('/')
+    expect(safeNextPath('//example.com/steal')).toBe('/')
+    expect(safeNextPath('/\\example.com/steal')).toBe('/')
+    expect(safeNextPath(undefined, '/workspaces')).toBe('/workspaces')
+  })
+
+  it('在登录与注册之间完整传递邀请返回路径', () => {
+    const next = '/member-invitations/accept?token=abc_123-xyz'
+    const loginPath = buildAuthPath('/login', { next, registered: true })
+    const params = new URL(loginPath, 'https://wanwu.test').searchParams
+
+    expect(loginPath.startsWith('/login?')).toBe(true)
+    expect(params.get('next')).toBe(next)
+    expect(params.get('registered')).toBe('1')
+    expect(buildAuthPath('/register', { next: 'https://example.com' })).toBe('/register')
+  })
+
+  it('用 URLSearchParams 安全组装一次性邀请链接', () => {
+    const link = buildCompanyMemberInvitationLink('abc_123-xyz', 'https://wanwu.test')
+    const url = new URL(link)
+
+    expect(url.origin).toBe('https://wanwu.test')
+    expect(url.pathname).toBe('/member-invitations/accept')
+    expect(url.searchParams.get('token')).toBe('abc_123-xyz')
+  })
+})