front-cpu 0.1.1

package/src/utils/abortable.ts

@@ -0,0 +1,89 @@
+/**
+ * 可取消的 Promise 包装器
+ * 
+ * 将任意 Promise 与 AbortSignal 结合，使其可以被外部取消
+ */
+
+/**
+ * 将 AbortSignal 转换为 Promise
+ * 当 abort 事件触发时，Promise 会 reject
+ */
+function abortSignalToPromise(signal: AbortSignal): Promise<never> {
+  return new Promise((_, reject) => {
+    // 如果已经被 abort，立即 reject
+    if (signal.aborted) {
+      reject(new Error('Operation was aborted'))
+      return
+    }
+
+    // 监听 abort 事件
+    const abortHandler = () => {
+      reject(new Error('Operation was aborted'))
+    }
+    
+    signal.addEventListener('abort', abortHandler, { once: true })
+  })
+}
+
+/**
+ * 将 Promise 包装为可取消的版本
+ * 
+ * @param promise 原始 Promise
+ * @param abortSignal 取消信号
+ * @returns 可取消的 Promise
+ * 
+ * 工作原理：
+ * - 使用 Promise.race 让 promise 和 abortPromise 竞争
+ * - 如果 abort 先触发，整个操作会立即被 reject
+ * - 如果 promise 先完成，正常返回结果
+ * 
+ * 效果：
+ * - 对 fetch：网络请求会被立即取消
+ * - 对自定义 execute：即使不处理 signal，也会被中断
+ */
+export function makeAbortable<T>(
+  promise: Promise<T>,
+  abortSignal?: AbortSignal
+): Promise<T> {
+  // 如果没有提供 signal，直接返回原 promise
+  if (!abortSignal) {
+    return promise
+  }
+
+  // 如果 signal 已经 aborted，立即 reject
+  if (abortSignal.aborted) {
+    return Promise.reject(new Error('Operation was aborted'))
+  }
+
+  // 使用 Promise.race 让执行和取消竞争
+  return Promise.race([
+    promise,
+    abortSignalToPromise(abortSignal)
+  ])
+}
+
+/**
+ * 创建一个可取消的延迟函数
+ * 
+ * @param ms 延迟毫秒数
+ * @param abortSignal 取消信号
+ */
+export function cancellableDelay(ms: number, abortSignal?: AbortSignal): Promise<void> {
+  return new Promise((resolve, reject) => {
+    if (abortSignal?.aborted) {
+      reject(new Error('Operation was aborted'))
+      return
+    }
+
+    const timeoutId = setTimeout(() => {
+      resolve()
+    }, ms)
+
+    abortSignal?.addEventListener('abort', () => {
+      clearTimeout(timeoutId)
+      reject(new Error('Operation was aborted'))
+    }, { once: true })
+  })
+}
+
+

package/src/utils/request.ts

@@ -0,0 +1,125 @@
+/**
+ * FrontCPU 统一请求工具（解耦版）
+ *
+ * 通过依赖注入实现HTTP客户端解耦
+ *
+ * 支持：
+ * 1. 单个请求
+ * 2. 多个请求（并发/串行）
+ * 3. 自动添加 correlation-id
+ */
+
+import type { IHttpClient } from '../interfaces'
+import type { InstructionContext } from '../types'
+import type { RequestConfig, MultiRequestConfig } from '../isa/types'
+
+// 全局HTTP客户端（通过setHttpClient注入）
+let httpClient: IHttpClient | null = null
+
+/**
+ * 设置HTTP客户端（必须在使用前调用）
+ */
+export function setHttpClient(client: IHttpClient): void {
+  httpClient = client
+}
+
+/**
+ * 执行单个 HTTP 请求
+ */
+async function executeSingleRequest(
+  config: RequestConfig,
+  payload: any,
+  context: InstructionContext,
+  abortSignal?: AbortSignal
+): Promise<any> {
+  if (!httpClient) {
+    throw new Error('HttpClient未初始化，请先调用setHttpClient()')
+  }
+
+  // 解析 URL
+  const url = typeof config.url === 'function' ? config.url(payload) : config.url
+
+  // 解析请求体
+  const body = config.body ? config.body(payload) : payload
+
+  // 统一添加 correlation-id
+  const headers = {
+    'X-Correlation-ID': context.correlationId,
+    ...config.headers,
+  }
+
+  const requestConfig = { 
+    headers,
+    signal: abortSignal  // 传递取消信号
+  }
+
+  // 根据方法执行请求
+  switch (config.method) {
+    case 'GET':
+      return await httpClient.get(url, requestConfig)
+    case 'POST':
+      return await httpClient.post(url, body, requestConfig)
+    case 'PUT':
+      return await httpClient.put(url, body, requestConfig)
+    case 'PATCH':
+      return await httpClient.patch(url, body, requestConfig)
+    case 'DELETE':
+      return await httpClient.delete(url, requestConfig)
+    default:
+      throw new Error(`Unsupported HTTP method: ${config.method}`)
+  }
+}
+
+/**
+ * 判断是否是多请求配置
+ */
+function isMultiRequestConfig(
+  config: RequestConfig | MultiRequestConfig
+): config is MultiRequestConfig {
+  return 'requests' in config && Array.isArray(config.requests)
+}
+
+/**
+ * 执行 HTTP 请求（单个或多个）
+ *
+ * @param config 请求配置（单个或多个）
+ * @param payload 指令负载
+ * @param context 指令上下文
+ * @returns 请求结果
+ */
+export async function executeRequest(
+  config: RequestConfig | MultiRequestConfig,
+  payload: any,
+  context: InstructionContext,
+  abortSignal?: AbortSignal
+): Promise<any> {
+  // 单个请求
+  if (!isMultiRequestConfig(config)) {
+    return await executeSingleRequest(config, payload, context, abortSignal)
+  }
+
+  // 多个请求
+  const { requests, mode, combineResults } = config
+
+  let results: any[]
+
+  if (mode === 'parallel') {
+    // 🔥 并发执行所有请求
+    results = await Promise.all(requests.map((req) => executeSingleRequest(req, payload, context, abortSignal)))
+  } else {
+    // 🔥 串行执行所有请求
+    results = []
+    for (const req of requests) {
+      const result = await executeSingleRequest(req, payload, context, abortSignal)
+      results.push(result)
+    }
+  }
+
+  // 合并结果（如果提供了合并函数）
+  if (combineResults) {
+    return combineResults(results)
+  }
+
+  // 默认：返回结果数组
+  return results
+}