feat(patient-h5): 接入签署令牌与签名上传

patient-h5/src/api/index.ts

@@ -1,6 +1,52 @@
-import axios from 'axios'
+import { unwrapApiResponse } from '@/utils/api-response'
+import { request } from '@/utils/request'
 
-export const apiClient = axios.create({
-  baseURL: import.meta.env.VITE_API_BASE_URL || '/api',
-  timeout: 10_000,
-})
+import type {
+  ApiResponse,
+  SignatureUploadInput,
+  SignatureUploadResponse,
+  TokenConsumeRequest,
+  TokenConsumeResponse,
+} from './types'
+
+export function consumeSigningToken(payload: TokenConsumeRequest): Promise<TokenConsumeResponse> {
+  return request
+    .post<ApiResponse<TokenConsumeResponse>>('/v1/sign-deliveries/token/consume', payload)
+    .then(unwrapApiResponse)
+}
+
+function createIdempotencyKey(value?: string) {
+  if (value) {
+    return value
+  }
+
+  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+    return `patient-h5-${crypto.randomUUID()}`
+  }
+
+  return `patient-h5-${Date.now()}-${Math.random().toString(36).slice(2)}`
+}
+
+export function uploadSigningSignature(
+  payload: SignatureUploadInput,
+): Promise<SignatureUploadResponse> {
+  const formData = new FormData()
+  formData.append('file', payload.file, 'signature.png')
+  formData.append('metadata', payload.metadata)
+
+  return request
+    .post<ApiResponse<SignatureUploadResponse>>(
+      `/v1/sign-deliveries/${encodeURIComponent(payload.taskId)}/signature`,
+      formData,
+      {
+        params: {
+          deliveryId: payload.deliveryId,
+          uploadToken: payload.uploadToken,
+        },
+        headers: {
+          'Idempotency-Key': createIdempotencyKey(payload.idempotencyKey),
+        },
+      },
+    )
+    .then(unwrapApiResponse)
+}

patient-h5/src/api/types.ts

@@ -0,0 +1,51 @@
+export interface ApiResponse<T> {
+  code: number | string
+  message: string
+  data: T | null
+  traceId?: string
+  timestamp?: string
+}
+
+export type SignDeliveryChannel = 'PAD' | 'SMS'
+
+export interface TokenConsumeRequest {
+  token: string
+  channel?: SignDeliveryChannel
+  taskId?: string
+}
+
+export interface TokenConsumeResponse {
+  deliveryId: string
+  taskId: string
+  channel: SignDeliveryChannel
+  uploadToken: string
+  traceId?: string | null
+  timestamp?: string | null
+}
+
+export type SignatureUploadStatus =
+  'CREATED' | 'WAITING_SIGN' | 'SIGNED' | 'EXPIRED' | 'VOIDED' | 'GENERATING' | 'FAILED' | string
+
+export interface SignatureUploadResponse {
+  taskId: string
+  pipelineId: string
+  status: SignatureUploadStatus
+  originalPdfArtifactId: string
+  signedPdfArtifactId: string
+  signatureImageArtifactId: string
+  originalPdfSha256: string
+  signedPdfSha256: string
+  signatureImageSha256: string
+  completedAt: string | null
+  traceId?: string | null
+  timestamp?: string | null
+}
+
+export interface SignatureUploadInput {
+  taskId: string
+  deliveryId: string
+  uploadToken: string
+  file: Blob
+  metadata: string
+  idempotencyKey?: string
+}