@ct-agents/worker 0.1.8 → 0.2.0

package/src/worker-http-transport.ts

@@ -0,0 +1,79 @@
+import { platformApiPath } from './platform-api-path.js';
+
+export type WorkerHttpTransportInput = {
+  baseUrl: string;
+  environmentKey: string;
+  fetchImpl?: typeof fetch;
+};
+
+export class WorkerHttpError extends Error {
+  readonly retryable: boolean;
+
+  constructor(
+    message: string,
+    readonly status: number,
+    readonly code?: string,
+    readonly details?: unknown,
+  ) {
+    super(message);
+    this.name = 'WorkerHttpError';
+    this.retryable = status === 408 || status === 429 || status === 504 || status >= 500;
+  }
+}
+
+/** Worker HTTP client 共用的认证、URL 与 Envelope Transport。 */
+export class WorkerHttpTransport {
+  private readonly baseUrl: string;
+  private readonly fetchImpl: typeof fetch;
+
+  constructor(private readonly input: WorkerHttpTransportInput) {
+    this.baseUrl = trimTrailingSlash(input.baseUrl);
+    this.fetchImpl = input.fetchImpl ?? fetch;
+  }
+
+  async requestJson(path: string, init: RequestInit, fallbackMessage: string): Promise<unknown> {
+    const headers = new Headers(init.headers);
+    headers.set('x-api-key', this.input.environmentKey);
+    if (init.body && !headers.has('content-type')) {
+      headers.set('content-type', 'application/json');
+    }
+
+    const response = await this.fetchImpl(`${this.baseUrl}${platformApiPath(`/worker${path}`)}`, {
+      ...init,
+      headers,
+    });
+    return parseApiEnvelope(response, `${fallbackMessage}：${response.status}`);
+  }
+}
+
+async function parseApiEnvelope(response: Response, fallbackMessage: string): Promise<unknown> {
+  const body = await response.json().catch(() => null) as unknown;
+  const envelope = isRecord(body) ? body : null;
+  if (!envelope) {
+    if (!response.ok) {
+      throw new WorkerHttpError(fallbackMessage, response.status);
+    }
+    throw new Error(fallbackMessage);
+  }
+  if (!response.ok || envelope.success !== true) {
+    const error = isRecord(envelope.error) ? envelope.error : {};
+    const message = typeof error.message === 'string'
+      ? error.message
+      : `平台请求失败：${response.status}`;
+    throw new WorkerHttpError(
+      message,
+      response.status,
+      typeof error.code === 'string' ? error.code : undefined,
+      error.details,
+    );
+  }
+  return envelope.data;
+}
+
+function trimTrailingSlash(value: string) {
+  return value.endsWith('/') ? value.slice(0, -1) : value;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}