@csntgao/uni-base 0.1.0

package/packages/web-components/tests/notification-center-transport.test.ts

@@ -0,0 +1,271 @@
+import { describe, expect, it, vi } from 'vitest'
+import { createUniplatBaseNotificationCenterTransport } from '../src/uniplat-base-notification-center-transport'
+
+const SERVICE_BASE = 'https://gateway.example.com/api/general/project/uniplat_base/service'
+
+interface FakeCall {
+  url: string
+  init: RequestInit
+}
+
+function jsonResponse(data: unknown): Response {
+  return {
+    ok: true,
+    async json() {
+      return { rescode: 0, data }
+    },
+    async blob() {
+      return new Blob(['x'])
+    },
+  } as unknown as Response
+}
+
+describe('createUniplatBaseNotificationCenterTransport', () => {
+  it('posts inbox with application_name in body and JWT only in the Authorization header', async () => {
+    const calls: FakeCall[] = []
+    const fetchMock = vi.fn(async (url: string, init: RequestInit) => {
+      calls.push({ url, init })
+      return jsonResponse({
+        items: [
+          {
+            notification_id: '301',
+            notification_type: 'alert',
+            notification_type_name: '预警',
+            title: '合同到期预警',
+            summary: '陈晓劳动合同 6/30 到期',
+            content: '正文',
+            content_type: 'markdown',
+            read_status: 'unread',
+            created_at: '2026-05-30T16:35:00.000Z',
+            source: { type: 'ai_employee', code: 'archive', name: '档案管理专员' },
+            resources: [{ type: 'service_order', id: 'so-1', title: '服务单' }],
+            attachments: [
+              { file_id: 'f1', name: 'report.pdf', size_bytes: 1600, mime_type: 'application/pdf' },
+            ],
+          },
+        ],
+        has_more: true,
+        next_id: '299',
+      })
+    })
+    const transport = createUniplatBaseNotificationCenterTransport({
+      serviceBaseUrl: SERVICE_BASE,
+      getAccessToken: () => 'notify.jwt',
+      fetch: fetchMock as unknown as typeof fetch,
+    })
+    const result = await transport.listInbox({
+      pageSize: 20,
+      beforeId: null,
+      applicationName: 'HrSaas',
+    })
+
+    expect(calls[0]?.url).toBe(`${SERVICE_BASE}/messaging.notification_api/inbox`)
+    const body = JSON.parse(String(calls[0]?.init.body))
+    expect(body.application_name).toBe('HrSaas')
+    expect(body.page_size).toBe(20)
+    const headers = calls[0]?.init.headers as Record<string, string>
+    expect(headers.authorization).toBe('Bearer notify.jwt')
+    expect(calls[0]?.url).not.toContain('notify.jwt')
+
+    expect(result.items).toHaveLength(1)
+    const item = result.items[0]
+    expect(item?.id).toBe('301')
+    // 分类展示名来自后端 notification_type_name，前端不再维护中文映射。
+    expect(item?.typeName).toBe('预警')
+    expect(item?.contentType).toBe('markdown')
+    expect(item?.resources[0]?.type).toBe('service_order')
+    expect(item?.attachments[0]?.fileId).toBe('f1')
+    expect(result.hasMore).toBe(true)
+    expect(result.nextId).toBe('299')
+  })
+
+  it('requests include_type_facets and maps type_facets into the type catalog', async () => {
+    const calls: FakeCall[] = []
+    const fetchMock = vi.fn(async (url: string, init: RequestInit) => {
+      calls.push({ url, init })
+      return jsonResponse({
+        items: [],
+        has_more: false,
+        next_id: null,
+        type_facets: [
+          { notification_type: 'alert', notification_type_name: '预警', total: 12, unread: 3 },
+          { notification_type: 'sales_lead_assigned', notification_type_name: '新线索', total: 2 },
+          // 字典未登记的分类展示名为空，由 UI 回退到 code。
+          { notification_type: 'interview', notification_type_name: '', total: 1 },
+          { notification_type: '', notification_type_name: '脏数据', total: 9 },
+        ],
+      })
+    })
+    const transport = createUniplatBaseNotificationCenterTransport({
+      serviceBaseUrl: SERVICE_BASE,
+      getAccessToken: () => 'notify.jwt',
+      fetch: fetchMock as unknown as typeof fetch,
+    })
+    const result = await transport.listInbox({
+      pageSize: 20,
+      beforeId: null,
+      includeTypeFacets: true,
+      applicationName: 'HrSaas',
+    })
+    const body = JSON.parse(String(calls[0]?.init.body))
+    expect(body.include_type_facets).toBe(true)
+    // 空 code 被丢弃；total/unread 不进入 UI 投影。
+    expect(result.types).toEqual([
+      { type: 'alert', name: '预警' },
+      { type: 'sales_lead_assigned', name: '新线索' },
+      { type: 'interview', name: '' },
+    ])
+  })
+
+  it('omits include_type_facets and type catalog when not requested', async () => {
+    const calls: FakeCall[] = []
+    const fetchMock = vi.fn(async (url: string, init: RequestInit) => {
+      calls.push({ url, init })
+      return jsonResponse({ items: [], has_more: false, next_id: null })
+    })
+    const transport = createUniplatBaseNotificationCenterTransport({
+      serviceBaseUrl: SERVICE_BASE,
+      getAccessToken: () => 'notify.jwt',
+      fetch: fetchMock as unknown as typeof fetch,
+    })
+    const result = await transport.listInbox({
+      pageSize: 20,
+      beforeId: null,
+      applicationName: 'HrSaas',
+    })
+    expect(JSON.parse(String(calls[0]?.init.body))).not.toHaveProperty('include_type_facets')
+    expect(result.types).toBeUndefined()
+  })
+
+  it('maps unread_count, mark_read and mark_all_read responses', async () => {
+    const fetchMock = vi.fn(async (url: string) => {
+      if (url.endsWith('/unread_count')) return jsonResponse({ unread_count: 7 })
+      if (url.endsWith('/mark_read'))
+        return jsonResponse({ unread_count: 6, read_at: '2026-05-30T17:00:00.000Z' })
+      if (url.endsWith('/mark_all_read')) return jsonResponse({ marked_count: 6, unread_count: 0 })
+      return jsonResponse({})
+    })
+    const transport = createUniplatBaseNotificationCenterTransport({
+      serviceBaseUrl: SERVICE_BASE,
+      getAccessToken: () => 'notify.jwt',
+      fetch: fetchMock as unknown as typeof fetch,
+    })
+    expect(await transport.getUnreadCount({ applicationName: 'HrSaas' })).toEqual({
+      unreadCount: 7,
+    })
+    expect(await transport.markRead({ notificationId: '1', applicationName: 'HrSaas' })).toEqual({
+      unreadCount: 6,
+      readAt: '2026-05-30T17:00:00.000Z',
+    })
+    expect(await transport.markAllRead({ applicationName: 'HrSaas' })).toEqual({
+      markedCount: 6,
+      unreadCount: 0,
+    })
+  })
+
+  it('omits application_name for the all-applications projection', async () => {
+    const calls: FakeCall[] = []
+    const fetchMock = vi.fn(async (url: string, init: RequestInit) => {
+      calls.push({ url, init })
+      if (url.endsWith('/inbox')) {
+        return jsonResponse({ items: [], has_more: false, next_id: null })
+      }
+      if (url.endsWith('/unread_count')) return jsonResponse({ unread_count: 2 })
+      if (url.endsWith('/mark_read')) return jsonResponse({ unread_count: 1, read_at: null })
+      if (url.endsWith('/mark_all_read')) return jsonResponse({ marked_count: 1, unread_count: 0 })
+      if (url.endsWith('/archive')) return jsonResponse({ unread_count: 0 })
+      return jsonResponse({})
+    })
+    const transport = createUniplatBaseNotificationCenterTransport({
+      serviceBaseUrl: SERVICE_BASE,
+      getAccessToken: () => 'notify.jwt',
+      fetch: fetchMock as unknown as typeof fetch,
+    })
+
+    await transport.listInbox({ pageSize: 4, applicationName: '' })
+    await transport.getUnreadCount({ applicationName: '' })
+    await transport.markRead({ notificationId: '1', applicationName: '' })
+    await transport.markAllRead({ applicationName: '' })
+    await transport.archive?.({ notificationId: '1', applicationName: '' })
+
+    expect(calls).toHaveLength(5)
+    for (const call of calls) {
+      expect(JSON.parse(String(call.init.body))).not.toHaveProperty('application_name')
+    }
+  })
+
+  it('downloads an attachment via a short-lived ticket, keeping the ticket out of the return value', async () => {
+    const calls: FakeCall[] = []
+    const fetchMock = vi.fn(async (url: string, init?: RequestInit) => {
+      calls.push({ url, init: init ?? {} })
+      if (url.endsWith('/filesystem.api/create_download_ticket')) {
+        return jsonResponse({
+          ticket: 'secret-ticket',
+          download_url:
+            '/api/general/project/uniplat_base/service/anonymous/filesystem.api/download_by_ticket?ticket=secret-ticket',
+        })
+      }
+      return {
+        ok: true,
+        async blob() {
+          return new Blob(['file-bytes'])
+        },
+        async json() {
+          return {}
+        },
+      } as unknown as Response
+    })
+    const transport = createUniplatBaseNotificationCenterTransport({
+      serviceBaseUrl: SERVICE_BASE,
+      getAccessToken: () => 'notify.jwt',
+      fetch: fetchMock as unknown as typeof fetch,
+    })
+    const blob = await transport.downloadAttachment({ fileId: 'f1', name: 'report.pdf' })
+    expect(blob).toBeInstanceOf(Blob)
+
+    const ticketCall = calls[0]
+    expect(ticketCall?.url).toBe(`${SERVICE_BASE}/filesystem.api/create_download_ticket`)
+    expect(JSON.parse(String(ticketCall?.init.body)).file_id).toBe('f1')
+    const downloadCall = calls[1]
+    expect(downloadCall?.url).toContain('download_by_ticket?ticket=secret-ticket')
+    // The download GET carries no Authorization header (anonymous ticket endpoint).
+    expect(
+      (downloadCall?.init.headers as Record<string, string> | undefined)?.authorization,
+    ).toBeUndefined()
+  })
+
+  it('parses realtime notification events into stable DTO changes', () => {
+    const transport = createUniplatBaseNotificationCenterTransport({
+      serviceBaseUrl: SERVICE_BASE,
+      getAccessToken: () => 'notify.jwt',
+      fetch: vi.fn() as unknown as typeof fetch,
+    })
+    const created = transport.parseRealtimeEvent?.({
+      event_type: 'notification_created',
+      unread_count: 5,
+      notification: {
+        notification_id: '9',
+        notification_type: 'todo',
+        title: '待办',
+        read_status: 'unread',
+      },
+    })
+    expect(created).toEqual(expect.objectContaining({ kind: 'created', unreadCount: 5 }))
+    const read = transport.parseRealtimeEvent?.({
+      event_type: 'notification_read',
+      notification_ids: ['9', '10'],
+      unread_count: 2,
+    })
+    expect(read).toEqual({
+      kind: 'read',
+      notificationIds: ['9', '10'],
+      unreadCount: 2,
+      readAt: null,
+    })
+    const archived = transport.parseRealtimeEvent?.({
+      event_type: 'notification_archived',
+      notification_id: '9',
+    })
+    expect(archived).toEqual({ kind: 'archived', notificationIds: ['9'], unreadCount: undefined })
+  })
+})