@csntgao/uni-base 0.1.0

package/packages/web-components/src/customer-support-transport.ts

@@ -0,0 +1,269 @@
+import type {
+  CustomerSupportAgent,
+  CustomerSupportCreateSessionResult,
+  CustomerSupportMessage,
+  CustomerSupportMessagePage,
+  CustomerSupportSenderType,
+  CustomerSupportSession,
+  CustomerSupportSessionStatus,
+  CustomerSupportTransport,
+} from '@uniplat/ai-employee-client'
+
+export interface HrSaasCustomerSupportTransportOptions {
+  serviceBaseUrl: string
+  getAccessToken(): string | Promise<string>
+  fetch?: typeof fetch
+}
+
+const SESSION_PAGE_ACTION = 'user_session_page'
+const SESSION_CREATE_ACTION = 'user_session_create'
+const SESSION_DETAIL_ACTION = 'user_session_detail'
+const MESSAGE_PAGE_ACTION = 'user_message_page'
+const MESSAGE_SEND_ACTION = 'user_message_send'
+const MARK_READ_ACTION = 'user_mark_read'
+
+export function createHrSaasCustomerSupportTransport(
+  options: HrSaasCustomerSupportTransportOptions,
+): CustomerSupportTransport {
+  if (!options || typeof options.getAccessToken !== 'function') {
+    throw new TypeError('Customer support transport requires getAccessToken()')
+  }
+  const serviceBaseUrl = validateServiceBaseUrl(options.serviceBaseUrl)
+  const fetchImplementation = options.fetch ?? globalThis.fetch
+  const request = async (action: string, body: Record<string, unknown>): Promise<unknown> => {
+    const token = await resolveAccessToken(options.getAccessToken)
+    return requestData(fetchImplementation, `${serviceBaseUrl}/${action}`, token, body)
+  }
+
+  return {
+    async getAccessToken() {
+      return resolveAccessToken(options.getAccessToken)
+    },
+    async listSessions() {
+      const data = record(await request(SESSION_PAGE_ACTION, { page_index: 1, page_size: 100 }))
+      return Array.isArray(data.list)
+        ? data.list
+            .map(parseSession)
+            .filter((value): value is CustomerSupportSession => value !== null)
+        : []
+    },
+    async createSession(createRequest) {
+      const body: Record<string, unknown> = {
+        client_request_id: requiredText(createRequest.clientRequestId, 128),
+      }
+      const title = optionalText(createRequest.title, 200)
+      const initialMessage = optionalText(createRequest.initialMessage, 8_000)
+      if (title) body.title = title
+      if (initialMessage) body.initial_message = initialMessage
+      const data = record(await request(SESSION_CREATE_ACTION, body))
+      const session = parseSession(data.session ?? data)
+      if (!session) throw new Error('Invalid customer support session response')
+      const parsedInitialMessage = parseMessage(data.initial_message)
+      const result: CustomerSupportCreateSessionResult = { session }
+      if (parsedInitialMessage) result.initialMessage = parsedInitialMessage
+      return result
+    },
+    async getSession(sessionId) {
+      const data = await request(SESSION_DETAIL_ACTION, {
+        session_id: requiredText(sessionId, 128),
+      })
+      const session = parseSession(data)
+      if (!session) throw new Error('Invalid customer support session response')
+      return session
+    },
+    async listMessages(sessionId) {
+      const data = record(
+        await request(MESSAGE_PAGE_ACTION, {
+          session_id: requiredText(sessionId, 128),
+          page_size: 100,
+          before_sequence: null,
+        }),
+      )
+      const page: CustomerSupportMessagePage = {
+        messages: Array.isArray(data.messages)
+          ? data.messages
+              .map(parseMessage)
+              .filter((value): value is CustomerSupportMessage => value !== null)
+          : [],
+        latestSequence: text(data.latest_sequence),
+        sessionVersion: text(data.session_version),
+      }
+      return page
+    },
+    async sendMessage(sessionId, clientMessageId, content) {
+      const data = record(
+        await request(MESSAGE_SEND_ACTION, {
+          session_id: requiredText(sessionId, 128),
+          client_message_id: requiredText(clientMessageId, 128),
+          content: requiredText(content, 8_000),
+          attachments: [],
+        }),
+      )
+      const message = parseMessage(data.message)
+      if (!message) throw new Error('Invalid customer support message response')
+      return message
+    },
+    async markRead(sessionId, lastReadSequence) {
+      await request(MARK_READ_ACTION, {
+        session_id: requiredText(sessionId, 128),
+        last_read_sequence: requiredText(lastReadSequence, 128),
+      })
+    },
+  }
+}
+
+function parseSession(value: unknown): CustomerSupportSession | null {
+  const data = record(value)
+  const id = text(data.session_id ?? data.id)
+  if (!id) return null
+  const primaryAgent = parseAgent(data.primary_agent)
+  const lastMessage = record(data.last_message)
+  return {
+    id,
+    sessionNo: text(data.session_no),
+    title: text(data.title) || '企业服务顾问',
+    status: sessionStatus(data.status),
+    statusText: text(data.status_text),
+    primaryAgent,
+    lastMessage: text(lastMessage.content_preview),
+    unreadCount: nonNegativeInteger(data.unread_count),
+    openedAt: text(data.opened_at),
+    updatedAt: text(data.updated_at),
+    version: text(data.version),
+  }
+}
+
+function parseAgent(value: unknown): CustomerSupportAgent | null {
+  const data = record(value)
+  const id = text(data.agent_id)
+  const name = text(data.name)
+  if (!id && !name) return null
+  return {
+    id,
+    name: name || '人工顾问',
+    avatarUrl: safeImageUrl(data.avatar_url),
+    roleName: text(data.role_name) || '客服专员',
+  }
+}
+
+function parseMessage(value: unknown): CustomerSupportMessage | null {
+  const data = record(value)
+  const id = text(data.message_id ?? data.id)
+  const sessionId = text(data.session_id)
+  if (!id || !sessionId) return null
+  return {
+    id,
+    sessionId,
+    sequence: text(data.sequence),
+    clientMessageId: text(data.client_message_id),
+    senderType: senderType(data.sender_type),
+    senderName: text(data.sender_name),
+    content: text(data.content),
+    createdAt: text(data.created_at),
+  }
+}
+
+async function requestData(
+  fetchImplementation: typeof fetch | undefined,
+  endpoint: string,
+  accessToken: string,
+  body: Record<string, unknown>,
+): Promise<unknown> {
+  if (!fetchImplementation) throw new Error('Fetch is unavailable')
+  const response = await fetchImplementation(endpoint, {
+    method: 'POST',
+    credentials: 'include',
+    headers: {
+      accept: 'application/json',
+      authorization: `Bearer ${accessToken}`,
+      'content-type': 'application/json',
+    },
+    body: JSON.stringify(body),
+  })
+  if (!response.ok) throw new Error('Customer support request failed')
+  const payload: unknown = await response.json()
+  const envelope = record(payload)
+  if ('rescode' in envelope) {
+    if (Number(envelope.rescode) !== 0) throw new Error('Customer support request failed')
+    return envelope.data
+  }
+  return payload
+}
+
+function validateServiceBaseUrl(value: string): string {
+  const raw = typeof value === 'string' ? value.trim() : ''
+  if (!raw) throw new TypeError('Customer support serviceBaseUrl is required')
+  const base = typeof document === 'undefined' ? 'https://localhost/' : document.baseURI
+  let parsed: URL
+  try {
+    parsed = new URL(raw, base)
+  } catch {
+    throw new TypeError('Customer support serviceBaseUrl is invalid')
+  }
+  if (!['http:', 'https:'].includes(parsed.protocol) || parsed.username || parsed.password) {
+    throw new TypeError('Customer support serviceBaseUrl must use safe HTTP(S)')
+  }
+  if (parsed.search || parsed.hash) {
+    throw new TypeError('Customer support serviceBaseUrl must not contain query or hash')
+  }
+  return parsed.href.replace(/\/$/, '')
+}
+
+async function resolveAccessToken(provider: () => string | Promise<string>): Promise<string> {
+  let value = ''
+  try {
+    value = (await provider()).trim()
+  } catch {
+    // Provider details may contain credentials and are intentionally discarded.
+  }
+  if (!value) throw new Error('Access token is unavailable')
+  return value
+}
+
+function requiredText(value: unknown, maximumLength: number): string {
+  const normalized = optionalText(value, maximumLength)
+  if (!normalized) throw new Error('Required customer support field is missing')
+  return normalized
+}
+
+function optionalText(value: unknown, maximumLength: number): string {
+  return typeof value === 'string' ? value.trim().slice(0, maximumLength) : ''
+}
+
+function text(value: unknown): string {
+  return typeof value === 'string' || typeof value === 'number' ? String(value).trim() : ''
+}
+
+function record(value: unknown): Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : {}
+}
+
+function sessionStatus(value: unknown): CustomerSupportSessionStatus {
+  return value === 'active' || value === 'closed' ? value : 'waiting'
+}
+
+function senderType(value: unknown): CustomerSupportSenderType {
+  return value === 'customer' || value === 'agent' ? value : 'system'
+}
+
+function nonNegativeInteger(value: unknown): number {
+  const parsed = Number(value)
+  return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : 0
+}
+
+function safeImageUrl(value: unknown): string {
+  const raw = text(value)
+  if (!raw) return ''
+  try {
+    const base = typeof document === 'undefined' ? 'https://localhost/' : document.baseURI
+    const url = new URL(raw, base)
+    if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.hash) {
+      return ''
+    }
+    return url.href
+  } catch {
+    return ''
+  }
+}

package/packages/web-components/src/index.ts

@@ -0,0 +1,256 @@
+import { UniplatAccountContext } from './account-context'
+import { UniplatAiEmployeeChat } from './chat'
+import { UniplatCustomerSupportChat } from './customer-support-chat'
+import { UniplatNotificationCenter } from './notification-center'
+import { UniplatNotificationPopover } from './notification-popover'
+import { UniplatOrganizationMultiEmployeeSelectorElement } from './organization-multi-employee-selector'
+import { UniplatOrganizationSingleEmployeeSelectorElement } from './organization-single-employee-selector'
+import { UniplatOrganizationSelector } from './organization-selector'
+import { UniplatUserLogin } from './user-login'
+import { UniplatUserMenu } from './user-menu'
+
+export {
+  UniplatAccountContext,
+  UniplatAiEmployeeChat,
+  UniplatCustomerSupportChat,
+  UniplatNotificationCenter,
+  UniplatNotificationPopover,
+  UniplatOrganizationMultiEmployeeSelectorElement,
+  UniplatOrganizationSingleEmployeeSelectorElement,
+  UniplatOrganizationSelector,
+  UniplatUserLogin,
+  UniplatUserMenu,
+}
+export type {
+  AccountContextConfig,
+  AccountContextEmployeeInfo,
+  AccountContextEventMap,
+  AccountContextOrganization,
+  AccountContextOrganizationType,
+  AccountContextProjection,
+  AccountContextTransport,
+  AccountContextUser,
+} from './account-context'
+export {
+  createUniplatBaseAccountContextTransport,
+  UniplatBaseAccountContextTransportError,
+} from './uniplat-base-account-context-transport'
+export type {
+  AccountContextApplicationScope,
+  UniplatBaseAccountContextIdentity,
+  UniplatBaseAccountContextProjection,
+  UniplatBaseAccountContextTransport,
+  UniplatBaseAccountContextTransportErrorCode,
+  UniplatBaseAccountContextTransportOptions,
+} from './uniplat-base-account-context-transport'
+export {
+  MOCK_APPLICATION_ENTRIES,
+  MOCK_ORGANIZATIONS,
+  createHttpApplicationSwitcherTransport,
+  createMockApplicationSwitcherTransport,
+} from './application-switcher-transport'
+export {
+  UNIPLAT_APPLICATION_TICKET_FRAGMENT_KEY,
+  UNIPLAT_APPLICATION_TICKET_SOURCE_SYSTEM_FRAGMENT_KEY,
+  exchangeUniplatBaseApplicationTicket,
+} from './uniplat-base-application-ticket'
+export { createUniplatBaseApplicationSwitcherTransport } from './uniplat-base-application-switcher-transport'
+export {
+  loginWithUniplatBaseIdentityTicket,
+  UNIPLAT_IDENTITY_TICKET_FRAGMENT_KEY,
+  UNIPLAT_IDENTITY_TICKET_SOURCE_SYSTEM_FRAGMENT_KEY,
+} from './uniplat-base-identity-ticket'
+export type {
+  ApplicationEntry,
+  ApplicationLaunchResult,
+  ApplicationSwitcherConfig,
+  ApplicationSwitcherTransport,
+  HttpApplicationSwitcherTransportOptions,
+  OrganizationEntry,
+  OrganizationListResult,
+} from './application-switcher-transport'
+export type { UniplatBaseApplicationTicketExchangeOptions } from './uniplat-base-application-ticket'
+export type { UniplatBaseApplicationSwitcherTransportOptions } from './uniplat-base-application-switcher-transport'
+export type { UniplatBaseIdentityTicketLoginOptions } from './uniplat-base-identity-ticket'
+export type { AiEmployeeChatConfig, AiEmployeeChatEventMap } from './chat'
+export type {
+  CustomerSupportChatConfig,
+  CustomerSupportChatEventMap,
+} from './customer-support-chat'
+export { createHrSaasCustomerSupportTransport } from './customer-support-transport'
+export type { HrSaasCustomerSupportTransportOptions } from './customer-support-transport'
+export type {
+  NotificationCenterConfig,
+  NotificationCenterEventMap,
+  NotificationCenterTypeIconMap,
+  NotificationResourceRequestedDetail,
+} from './notification-center'
+export type {
+  NotificationCenterRequestedDetail,
+  NotificationPopoverConfig,
+  NotificationPopoverEventMap,
+} from './notification-popover'
+export { createUniplatBaseNotificationCenterTransport } from './uniplat-base-notification-center-transport'
+export type { UniplatBaseNotificationCenterTransportOptions } from './uniplat-base-notification-center-transport'
+export { OrganizationMultiEmployeeSelectorTransportError } from './organization-multi-employee-selector'
+export type {
+  OrganizationDepartmentNode,
+  OrganizationEmployeeAvatar,
+  OrganizationEmployeeEmploymentStatus,
+  OrganizationEmployeePage,
+  OrganizationEmployeeSelectionItem,
+  OrganizationMultiEmployeeSelectionConfirmedDetail,
+  OrganizationMultiEmployeeSelectorConfig,
+  OrganizationMultiEmployeeSelectorDisabledSelection,
+  OrganizationMultiEmployeeSelectorErrorDetail,
+  OrganizationMultiEmployeeSelectorEventMap,
+  OrganizationMultiEmployeeSelectorOpenOptions,
+  UniplatOrganizationMultiEmployeeSelectorTransport,
+} from './organization-multi-employee-selector'
+export { createUniplatBaseOrganizationMultiEmployeeSelectorTransport } from './uniplat-base-organization-multi-employee-selector-transport'
+export type { UniplatBaseOrganizationMultiEmployeeSelectorTransportOptions } from './uniplat-base-organization-multi-employee-selector-transport'
+export type {
+  OrganizationSingleEmployeeSelectionConfirmedDetail,
+  OrganizationSingleEmployeeSelectorConfig,
+  OrganizationSingleEmployeeSelectorDisabledSelection,
+  OrganizationSingleEmployeeSelectorErrorDetail,
+  OrganizationSingleEmployeeSelectorEventMap,
+  OrganizationSingleEmployeeSelectorOpenOptions,
+  UniplatOrganizationSingleEmployeeSelectorTransport,
+} from './organization-single-employee-selector'
+export { createUniplatBaseOrganizationSingleEmployeeSelectorTransport } from './uniplat-base-organization-single-employee-selector-transport'
+export type { UniplatBaseOrganizationSingleEmployeeSelectorTransportOptions } from './uniplat-base-organization-single-employee-selector-transport'
+export {
+  createMockOrganizationOnboardingTransport,
+  OrganizationOnboardingTransportError,
+} from './organization-onboarding-transport'
+export { createUniplatBaseOrganizationOnboardingTransport } from './uniplat-base-organization-onboarding-transport'
+export type {
+  CreatedOnboardingOrganization,
+  CreateEnterpriseRequest,
+  CreateTeamRequest,
+  OnboardingOrganizationType,
+  OrganizationOnboardingTransport,
+  OrganizationOnboardingTransportErrorCode,
+} from './organization-onboarding-transport'
+export type { UniplatBaseOrganizationOnboardingTransportOptions } from './uniplat-base-organization-onboarding-transport'
+export type {
+  EnterpriseVerificationStatus,
+  OrganizationSelectorConfig,
+  OrganizationSelectorEntry,
+  OrganizationSelectorEventMap,
+  OrganizationSelectorType,
+} from './organization-selector'
+export type {
+  UserLoginConfig,
+  UserLoginErrorCode,
+  UserLoginErrorDetail,
+  UserLoginEventMap,
+  UserLoginMethod,
+} from './user-login'
+export {
+  createUniplatBaseUserLoginTransport,
+  UserLoginTransportError,
+} from './user-login-transport'
+export type {
+  UniplatBaseUserLoginDeviceInfo,
+  UniplatBaseUserLoginMetadata,
+  UniplatBaseUserLoginTransportOptions,
+  UserLoginCaptcha,
+  UserLoginPasswordRequest,
+  UserLoginQrChallenge,
+  UserLoginQrChallengeRequest,
+  UserLoginQrPollResult,
+  UserLoginQrStatus,
+  UserLoginRequest,
+  UserLoginSmsRequest,
+  UserLoginSuccess,
+  UserLoginTransport,
+  UserLoginTransportErrorCode,
+} from './user-login-transport'
+export type {
+  UserMenuConfig,
+  UserMenuEventMap,
+  UserMenuOrganization,
+  UserMenuOrganizationType,
+} from './user-menu'
+
+export const AI_EMPLOYEE_CHAT_TAG = 'uniplat-ai-employee-chat' as const
+export const CUSTOMER_SUPPORT_CHAT_TAG = 'uniplat-customer-support-chat' as const
+export const NOTIFICATION_CENTER_TAG = 'uniplat-notification-center' as const
+export const NOTIFICATION_POPOVER_TAG = 'uniplat-notification-popover' as const
+export const ACCOUNT_CONTEXT_TAG = 'uniplat-account-context' as const
+export const ORGANIZATION_MULTI_EMPLOYEE_SELECTOR_TAG =
+  'uniplat-organization-multi-employee-selector' as const
+export const ORGANIZATION_SINGLE_EMPLOYEE_SELECTOR_TAG =
+  'uniplat-organization-single-employee-selector' as const
+export const ORGANIZATION_SELECTOR_TAG = 'uniplat-organization-selector' as const
+export const USER_LOGIN_TAG = 'uniplat-user-login' as const
+export const USER_MENU_TAG = 'uniplat-user-menu' as const
+
+if (typeof customElements !== 'undefined' && !customElements.get(ACCOUNT_CONTEXT_TAG)) {
+  customElements.define(ACCOUNT_CONTEXT_TAG, UniplatAccountContext)
+}
+
+if (typeof customElements !== 'undefined' && !customElements.get(AI_EMPLOYEE_CHAT_TAG)) {
+  customElements.define(AI_EMPLOYEE_CHAT_TAG, UniplatAiEmployeeChat)
+}
+
+if (typeof customElements !== 'undefined' && !customElements.get(CUSTOMER_SUPPORT_CHAT_TAG)) {
+  customElements.define(CUSTOMER_SUPPORT_CHAT_TAG, UniplatCustomerSupportChat)
+}
+
+if (typeof customElements !== 'undefined' && !customElements.get(NOTIFICATION_CENTER_TAG)) {
+  customElements.define(NOTIFICATION_CENTER_TAG, UniplatNotificationCenter)
+}
+
+if (typeof customElements !== 'undefined' && !customElements.get(NOTIFICATION_POPOVER_TAG)) {
+  customElements.define(NOTIFICATION_POPOVER_TAG, UniplatNotificationPopover)
+}
+
+if (
+  typeof customElements !== 'undefined' &&
+  !customElements.get(ORGANIZATION_MULTI_EMPLOYEE_SELECTOR_TAG)
+) {
+  customElements.define(
+    ORGANIZATION_MULTI_EMPLOYEE_SELECTOR_TAG,
+    UniplatOrganizationMultiEmployeeSelectorElement,
+  )
+}
+
+if (
+  typeof customElements !== 'undefined' &&
+  !customElements.get(ORGANIZATION_SINGLE_EMPLOYEE_SELECTOR_TAG)
+) {
+  customElements.define(
+    ORGANIZATION_SINGLE_EMPLOYEE_SELECTOR_TAG,
+    UniplatOrganizationSingleEmployeeSelectorElement,
+  )
+}
+
+if (typeof customElements !== 'undefined' && !customElements.get(ORGANIZATION_SELECTOR_TAG)) {
+  customElements.define(ORGANIZATION_SELECTOR_TAG, UniplatOrganizationSelector)
+}
+
+if (typeof customElements !== 'undefined' && !customElements.get(USER_LOGIN_TAG)) {
+  customElements.define(USER_LOGIN_TAG, UniplatUserLogin)
+}
+
+if (typeof customElements !== 'undefined' && !customElements.get(USER_MENU_TAG)) {
+  customElements.define(USER_MENU_TAG, UniplatUserMenu)
+}
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'uniplat-account-context': UniplatAccountContext
+    'uniplat-ai-employee-chat': UniplatAiEmployeeChat
+    'uniplat-customer-support-chat': UniplatCustomerSupportChat
+    'uniplat-notification-center': UniplatNotificationCenter
+    'uniplat-notification-popover': UniplatNotificationPopover
+    'uniplat-organization-multi-employee-selector': UniplatOrganizationMultiEmployeeSelectorElement
+    'uniplat-organization-single-employee-selector': UniplatOrganizationSingleEmployeeSelectorElement
+    'uniplat-organization-selector': UniplatOrganizationSelector
+    'uniplat-user-login': UniplatUserLogin
+    'uniplat-user-menu': UniplatUserMenu
+  }
+}