@csntgao/uni-base 0.6.3 → 0.6.6

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

@@ -1,13 +1,15 @@
 import type {
   CustomerSupportAgent,
   CustomerSupportCreateSessionResult,
+  CustomerSupportHandoffResult,
   CustomerSupportMessage,
   CustomerSupportMessagePage,
   CustomerSupportSenderType,
   CustomerSupportSession,
   CustomerSupportSessionStatus,
   CustomerSupportTransport,
-} from '@uniplat/ai-employee-client'
+} from '@csntgao/ai-employee-client'
+import { isUuidV4 } from '@csntgao/ai-employee-client'
 
 export interface HrSaasCustomerSupportTransportOptions {
   serviceBaseUrl: string
@@ -15,8 +17,30 @@ export interface HrSaasCustomerSupportTransportOptions {
   fetch?: typeof fetch
 }
 
+export type HrSaasCustomerSupportTransportErrorCode =
+  | 'AUTH_REQUIRED'
+  | 'SOURCE_SESSION_NOT_FOUND'
+  | 'SOURCE_SESSION_ACCESS_DENIED'
+  | 'HANDOFF_ACTION_NOT_FOUND'
+  | 'HANDOFF_ACTION_MISMATCH'
+  | 'UNAUTHORIZED'
+  | 'CUSTOMER_SUPPORT_UNAVAILABLE'
+  | 'REQUEST_FAILED'
+  | 'INVALID_RESPONSE'
+
+export class HrSaasCustomerSupportTransportError extends Error {
+  readonly code: HrSaasCustomerSupportTransportErrorCode
+
+  constructor(code: HrSaasCustomerSupportTransportErrorCode) {
+    super('Customer support request failed')
+    this.name = 'HrSaasCustomerSupportTransportError'
+    this.code = code
+  }
+}
+
 const SESSION_PAGE_ACTION = 'user_session_page'
 const SESSION_CREATE_ACTION = 'user_session_create'
+const SESSION_HANDOFF_CREATE_ACTION = 'user_session_handoff_create'
 const SESSION_DETAIL_ACTION = 'user_session_detail'
 const MESSAGE_PAGE_ACTION = 'user_message_page'
 const MESSAGE_SEND_ACTION = 'user_message_send'
@@ -63,6 +87,37 @@ export function createHrSaasCustomerSupportTransport(
       if (parsedInitialMessage) result.initialMessage = parsedInitialMessage
       return result
     },
+    async createHandoffSession(handoffRequest) {
+      const sourceSessionId = requiredText(handoffRequest.sourceSessionId, 128)
+      const actionTransactionId = requiredText(handoffRequest.actionTransactionId, 36)
+      if (!isUuidV4(actionTransactionId)) {
+        throw new HrSaasCustomerSupportTransportError('INVALID_RESPONSE')
+      }
+      const data = record(
+        await request(SESSION_HANDOFF_CREATE_ACTION, {
+          source_session_id: sourceSessionId,
+          action_transaction_id: actionTransactionId,
+        }),
+      )
+      const session = parseSession(data.session)
+      const initialMessage = parseMessage(data.initial_message)
+      if (
+        !session ||
+        !initialMessage ||
+        initialMessage.sessionId !== session.id ||
+        typeof data.created !== 'boolean' ||
+        typeof data.repaired !== 'boolean'
+      ) {
+        throw new HrSaasCustomerSupportTransportError('INVALID_RESPONSE')
+      }
+      const result: CustomerSupportHandoffResult = {
+        session,
+        initialMessage,
+        created: data.created,
+        repaired: data.repaired,
+      }
+      return result
+    },
     async getSession(sessionId) {
       const data = await request(SESSION_DETAIL_ACTION, {
         session_id: requiredText(sessionId, 128),
@@ -169,27 +224,74 @@ async function requestData(
   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()
+  if (!fetchImplementation) throw new HrSaasCustomerSupportTransportError('REQUEST_FAILED')
+  let response: Response
+  try {
+    response = await fetchImplementation(endpoint, {
+      method: 'POST',
+      credentials: 'include',
+      headers: {
+        accept: 'application/json',
+        authorization: `Bearer ${accessToken}`,
+        'content-type': 'application/json',
+      },
+      body: JSON.stringify(body),
+    })
+  } catch {
+    throw new HrSaasCustomerSupportTransportError('REQUEST_FAILED')
+  }
+  let payload: unknown = null
+  try {
+    payload = await response.json()
+  } catch {
+    if (!response.ok) throw transportResponseError({}, response.status)
+    throw new HrSaasCustomerSupportTransportError('INVALID_RESPONSE')
+  }
   const envelope = record(payload)
+  if (!response.ok) throw transportResponseError(envelope, response.status)
   if ('rescode' in envelope) {
-    if (Number(envelope.rescode) !== 0) throw new Error('Customer support request failed')
+    if (Number(envelope.rescode) !== 0) {
+      throw transportResponseError(envelope, response.status)
+    }
     return envelope.data
   }
   return payload
 }
 
+function transportResponseError(
+  envelope: Record<string, unknown>,
+  status: number,
+): HrSaasCustomerSupportTransportError {
+  const detail = record(envelope.data)
+  const error = record(envelope.error)
+  const candidate = [
+    envelope.error_code,
+    envelope.code,
+    detail.error_code,
+    detail.code,
+    error.error_code,
+    error.code,
+  ].find((value) => typeof value === 'string' && value.trim())
+  const code = typeof candidate === 'string' ? candidate.trim().toUpperCase() : ''
+  if (isTransportErrorCode(code)) return new HrSaasCustomerSupportTransportError(code)
+  if (status === 401) return new HrSaasCustomerSupportTransportError('UNAUTHORIZED')
+  if (status === 503) {
+    return new HrSaasCustomerSupportTransportError('CUSTOMER_SUPPORT_UNAVAILABLE')
+  }
+  return new HrSaasCustomerSupportTransportError('REQUEST_FAILED')
+}
+
+function isTransportErrorCode(value: string): value is HrSaasCustomerSupportTransportErrorCode {
+  return [
+    'SOURCE_SESSION_NOT_FOUND',
+    'SOURCE_SESSION_ACCESS_DENIED',
+    'HANDOFF_ACTION_NOT_FOUND',
+    'HANDOFF_ACTION_MISMATCH',
+    'UNAUTHORIZED',
+    'CUSTOMER_SUPPORT_UNAVAILABLE',
+  ].includes(value)
+}
+
 function validateServiceBaseUrl(value: string): string {
   const raw = typeof value === 'string' ? value.trim() : ''
   if (!raw) throw new TypeError('Customer support serviceBaseUrl is required')
@@ -216,7 +318,7 @@ async function resolveAccessToken(provider: () => string | Promise<string>): Pro
   } catch {
     // Provider details may contain credentials and are intentionally discarded.
   }
-  if (!value) throw new Error('Access token is unavailable')
+  if (!value) throw new HrSaasCustomerSupportTransportError('AUTH_REQUIRED')
   return value
 }
 

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

@@ -77,8 +77,20 @@ export type {
   CustomerSupportChatConfig,
   CustomerSupportChatEventMap,
 } from './customer-support-chat'
-export { createHrSaasCustomerSupportTransport } from './customer-support-transport'
-export type { HrSaasCustomerSupportTransportOptions } from './customer-support-transport'
+export {
+  createHrSaasCustomerSupportTransport,
+  HrSaasCustomerSupportTransportError,
+} from './customer-support-transport'
+export type {
+  HrSaasCustomerSupportTransportErrorCode,
+  HrSaasCustomerSupportTransportOptions,
+} from './customer-support-transport'
+export { isUuidV4, parseAiEmployeeAssistantContent } from '@csntgao/ai-employee-client'
+export type {
+  AiEmployeeAssistantAction,
+  OpenCustomerSupportAssistantAction,
+  ParsedAiEmployeeAssistantContent,
+} from '@csntgao/ai-employee-client'
 export type {
   NotificationCenterConfig,
   NotificationCenterEventMap,

package/packages/web-components/src/notification-center.ts

@@ -4,7 +4,7 @@ import {
   type NotificationCenterErrorDetail,
   type NotificationDto,
   type NotificationTypeSummary,
-} from '@uniplat/ai-employee-client'
+} from '@csntgao/ai-employee-client'
 import { LitElement, css, html, nothing, type TemplateResult } from 'lit'
 import { unsafeSVG } from 'lit/directives/unsafe-svg.js'
 import { renderSafeMarkdown } from './safe-markdown'

package/packages/web-components/src/notification-popover.ts

@@ -3,7 +3,7 @@ import {
   type NotificationCenterErrorDetail,
   type NotificationCenterTransport,
   type NotificationDto,
-} from '@uniplat/ai-employee-client'
+} from '@csntgao/ai-employee-client'
 import { LitElement, css, html, nothing, type TemplateResult } from 'lit'
 import { unsafeSVG } from 'lit/directives/unsafe-svg.js'
 import { prototypeIcon, type PrototypeIconName } from './prototype-icons'

package/packages/web-components/src/uniplat-base-notification-center-transport.ts

@@ -10,7 +10,7 @@ import type {
   NotificationResource,
   NotificationSource,
   NotificationTypeSummary,
-} from '@uniplat/ai-employee-client'
+} from '@csntgao/ai-employee-client'
 
 export interface UniplatBaseNotificationCenterTransportOptions {
   serviceBaseUrl: string