sa2kit 1.6.49 → 1.6.52

package/dist/iflytek/server.js

@@ -0,0 +1,281 @@
+'use strict';
+
+require('../chunk-Z6ZWNWWR.js');
+var crypto = require('crypto');
+var WebSocket = require('ws');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var crypto__default = /*#__PURE__*/_interopDefault(crypto);
+var WebSocket__default = /*#__PURE__*/_interopDefault(WebSocket);
+
+var IflytekServerAdapter = class {
+  constructor(config) {
+    this.sessions = /* @__PURE__ */ new Map();
+    this.appId = config.appId;
+    this.apiKey = config.apiKey;
+    this.apiSecret = config.apiSecret;
+    this.host = config.host ?? "iat-api.xfyun.cn";
+    this.path = config.path ?? "/v2/iat";
+    this.debug = config.debug ?? false;
+  }
+  /**
+   * 将适配器绑定到一个 Socket.IO socket 连接上。
+   * 自动监听 iflytek:start / iflytek:audio / iflytek:stop / disconnect 事件。
+   */
+  attach(socket) {
+    socket.on("iflytek:start", (payload) => {
+      this.handleStart(socket, payload);
+    });
+    socket.on("iflytek:audio", (frame) => {
+      this.handleAudio(socket, frame);
+    });
+    socket.on("iflytek:stop", (payload) => {
+      this.handleStop(socket, payload);
+    });
+    socket.on("disconnect", () => {
+      this.handleDisconnect(socket);
+    });
+  }
+  // ─── 事件处理 ───
+  handleStart(socket, payload) {
+    const sessionId = payload?.sessionId ?? `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    if (!this.appId || !this.apiKey || !this.apiSecret) {
+      socket.emit("iflytek:error", {
+        sessionId,
+        message: "\u670D\u52A1\u7AEF\u672A\u914D\u7F6E IFLYTEK_APP_ID / IFLYTEK_API_KEY / IFLYTEK_API_SECRET"
+      });
+      return;
+    }
+    const existing = this.sessions.get(socket.id);
+    if (existing) {
+      if (existing.ended) {
+        this.log(socket.id, "replace ended session");
+        this.closeUpstream(existing);
+        this.sessions.delete(socket.id);
+      } else if (existing.ws.readyState === WebSocket__default.default.OPEN) {
+        this.log(socket.id, "duplicate start ignored (session open)");
+        socket.emit("iflytek:ready", { sessionId: existing.sessionId });
+        return;
+      } else if (existing.ws.readyState === WebSocket__default.default.CONNECTING) {
+        this.log(socket.id, "duplicate start ignored (session connecting)");
+        return;
+      } else {
+        this.sessions.delete(socket.id);
+      }
+    }
+    const wsUrl = this.buildWsUrl();
+    const ws = new WebSocket__default.default(wsUrl);
+    const state = {
+      ws,
+      sessionId,
+      frameCount: 0,
+      firstFrameSent: false,
+      ended: false,
+      resultText: "",
+      resultSegments: []
+    };
+    this.sessions.set(socket.id, state);
+    this.log(socket.id, "start session", { sessionId });
+    ws.on("open", () => {
+      this.log(socket.id, "upstream open");
+      socket.emit("iflytek:ready", { sessionId });
+    });
+    ws.on("message", (raw) => {
+      try {
+        const msg = JSON.parse(String(raw));
+        this.log(socket.id, "upstream message", {
+          code: msg.code,
+          status: msg?.data?.status
+        });
+        if (msg.code !== 0) {
+          socket.emit("iflytek:error", {
+            sessionId,
+            message: msg.message || `\u8BAF\u98DE\u8FD4\u56DE\u9519\u8BEF code=${msg.code}`
+          });
+          return;
+        }
+        const current = this.sessions.get(socket.id);
+        if (!current || current.ws !== ws) return;
+        const result = this.extractResult(msg.data?.result);
+        const mergedText = this.mergeResult(current, result);
+        const isFinal = msg.data?.status === 2;
+        if (mergedText || isFinal) {
+          socket.emit("iflytek:result", {
+            sessionId,
+            text: mergedText,
+            isFinal
+          });
+        }
+        if (isFinal) {
+          const current2 = this.sessions.get(socket.id);
+          if (current2?.ws === ws) {
+            this.closeUpstream(current2);
+          }
+        }
+      } catch (e) {
+        socket.emit("iflytek:error", { sessionId, message: e.message });
+      }
+    });
+    ws.on("error", (e) => {
+      if (e?.message?.includes("before the connection was established")) {
+        this.log(socket.id, "ignore early-close error");
+        return;
+      }
+      socket.emit("iflytek:error", {
+        sessionId,
+        message: e?.message || "\u8BAF\u98DE WebSocket \u8FDE\u63A5\u5931\u8D25"
+      });
+    });
+    ws.on("close", () => {
+      this.log(socket.id, "upstream close");
+      const current = this.sessions.get(socket.id);
+      if (current?.ws === ws) {
+        this.sessions.delete(socket.id);
+      }
+    });
+  }
+  handleAudio(socket, frame) {
+    const state = this.sessions.get(socket.id);
+    if (!state || state.ws.readyState !== WebSocket__default.default.OPEN) return;
+    if (frame.sessionId && frame.sessionId !== state.sessionId) {
+      this.log(socket.id, "ignore stale audio frame");
+      return;
+    }
+    if (state.ended && frame.status === 2) {
+      this.log(socket.id, "ignore duplicate final frame");
+      return;
+    }
+    if (!state.firstFrameSent && frame.status === 2) {
+      this.log(socket.id, "ignore lonely final frame");
+      return;
+    }
+    const isFirst = !state.firstFrameSent && frame.status !== 2;
+    const status = isFirst ? 0 : frame.status;
+    state.frameCount += 1;
+    if (status === 0) state.firstFrameSent = true;
+    if (status === 2) state.ended = true;
+    this.log(socket.id, "audio frame", {
+      status,
+      hasAudio: Boolean(frame.audio),
+      len: frame.audio?.length ?? 0,
+      count: state.frameCount
+    });
+    const payload = {
+      data: { status }
+    };
+    if (status === 0) {
+      payload.common = { app_id: this.appId };
+      payload.business = {
+        language: frame.language || "zh_cn",
+        domain: frame.domain || "iat",
+        accent: frame.accent || "mandarin",
+        vad_eos: 2e3
+      };
+      payload.data = {
+        status: 0,
+        format: "audio/L16;rate=16000",
+        encoding: "raw",
+        audio: frame.audio || ""
+      };
+    } else if (status === 1) {
+      payload.data = {
+        status: 1,
+        format: "audio/L16;rate=16000",
+        encoding: "raw",
+        audio: frame.audio || ""
+      };
+    } else {
+      payload.data = { status: 2 };
+    }
+    state.ws.send(JSON.stringify(payload));
+  }
+  handleStop(socket, payload) {
+    const state = this.sessions.get(socket.id);
+    if (payload?.sessionId && state?.sessionId && payload.sessionId !== state.sessionId) {
+      this.log(socket.id, "ignore stale stop signal");
+      return;
+    }
+    this.log(socket.id, "stop signal");
+    if (state) {
+      this.closeUpstream(state);
+      this.sessions.delete(socket.id);
+    }
+  }
+  handleDisconnect(socket) {
+    const state = this.sessions.get(socket.id);
+    if (state) {
+      this.closeUpstream(state);
+      this.sessions.delete(socket.id);
+    }
+  }
+  // ─── 工具方法 ───
+  buildWsUrl() {
+    const date = (/* @__PURE__ */ new Date()).toUTCString();
+    const requestLine = `GET ${this.path} HTTP/1.1`;
+    const signatureOrigin = `host: ${this.host}
+date: ${date}
+${requestLine}`;
+    const signatureSha = crypto__default.default.createHmac("sha256", this.apiSecret).update(signatureOrigin).digest("base64");
+    const authOrigin = `api_key="${this.apiKey}", algorithm="hmac-sha256", headers="host date request-line", signature="${signatureSha}"`;
+    const authorization = Buffer.from(authOrigin).toString("base64");
+    const params = new URLSearchParams({ authorization, date, host: this.host });
+    return `wss://${this.host}${this.path}?${params.toString()}`;
+  }
+  extractText(result) {
+    const ws = result?.ws;
+    if (!Array.isArray(ws)) return "";
+    return ws.map((item) => item?.cw?.[0]?.w ?? "").join("").trim();
+  }
+  extractResult(result) {
+    const text = this.extractText(result);
+    const pgs = typeof result?.pgs === "string" ? result.pgs : void 0;
+    const rgRaw = Array.isArray(result?.rg) ? result.rg : void 0;
+    const rg = rgRaw && rgRaw.length === 2 ? [Number(rgRaw[0]), Number(rgRaw[1])] : void 0;
+    const sn = typeof result?.sn === "number" ? result.sn : Number.isFinite(Number(result?.sn)) ? Number(result?.sn) : void 0;
+    return { text, pgs, rg, sn };
+  }
+  mergeResult(state, result) {
+    const text = result.text?.trim() ?? "";
+    const segments = state.resultSegments;
+    if (typeof result.sn === "number") {
+      if (result.pgs === "rpl" && result.rg) {
+        const [start, end] = result.rg;
+        const before = segments.slice(0, start);
+        const after = segments.slice(end + 1);
+        state.resultSegments = [...before, text, ...after];
+      } else {
+        segments[result.sn] = text;
+        state.resultSegments = segments;
+      }
+    } else if (result.pgs === "rpl" && result.rg) {
+      const [start, end] = result.rg;
+      const before = segments.slice(0, start);
+      const after = segments.slice(end + 1);
+      state.resultSegments = [...before, text, ...after];
+    } else if (text) {
+      segments.push(text);
+      state.resultSegments = segments;
+    }
+    state.resultText = state.resultSegments.filter(Boolean).join("");
+    return state.resultText;
+  }
+  closeUpstream(state) {
+    try {
+      state.ws.close();
+    } catch {
+    }
+  }
+  log(socketId, msg, extra) {
+    if (!this.debug) return;
+    if (extra) {
+      console.log(`[sa2kit/iflytek][${socketId}] ${msg}`, extra);
+    } else {
+      console.log(`[sa2kit/iflytek][${socketId}] ${msg}`);
+    }
+  }
+};
+
+exports.IflytekServerAdapter = IflytekServerAdapter;
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/dist/iflytek/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/iflytek/IflytekServerAdapter.ts"],"names":["WebSocket","current","crypto"],"mappings":"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","file":"server.js","sourcesContent":["/**\n * 讯飞语音转文字 — 服务端适配层\n *\n * 运行在 Node.js 上，为每个 Socket.IO 客户端管理一条到讯飞 WebSocket 的上游连接。\n * 纯逻辑，不依赖任何 HTTP 框架。\n *\n * 使用方式：\n * ```ts\n * import { Server } from \"socket.io\";\n * import { IflytekServerAdapter } from \"sa2kit/iflytek/server\";\n *\n * const io = new Server(httpServer, { cors: { origin: \"*\" } });\n * const adapter = new IflytekServerAdapter({\n *   appId: process.env.IFLYTEK_APP_ID!,\n *   apiKey: process.env.IFLYTEK_API_KEY!,\n *   apiSecret: process.env.IFLYTEK_API_SECRET!,\n * });\n *\n * io.on(\"connection\", (socket) => {\n *   adapter.attach(socket);\n * });\n * ```\n */\n\nimport crypto from \"crypto\";\nimport WebSocket from \"ws\";\nimport type {\n  IflytekServerConfig,\n  IflytekAudioFrame,\n  IflytekStartPayload,\n  IflytekStopPayload,\n} from \"./types\";\n\ninterface SessionState {\n  ws: WebSocket;\n  sessionId: string;\n  frameCount: number;\n  firstFrameSent: boolean;\n  ended: boolean;\n  resultText: string;\n  resultSegments: string[];\n}\n\ninterface SocketLike {\n  id: string;\n  emit(event: string, data: unknown): void;\n  on(event: string, handler: (...args: any[]) => void): void;\n}\n\nexport class IflytekServerAdapter {\n  private appId: string;\n  private apiKey: string;\n  private apiSecret: string;\n  private host: string;\n  private path: string;\n  private debug: boolean;\n\n  private sessions = new Map<string, SessionState>();\n\n  constructor(config: IflytekServerConfig) {\n    this.appId = config.appId;\n    this.apiKey = config.apiKey;\n    this.apiSecret = config.apiSecret;\n    this.host = config.host ?? \"iat-api.xfyun.cn\";\n    this.path = config.path ?? \"/v2/iat\";\n    this.debug = config.debug ?? false;\n  }\n\n  /**\n   * 将适配器绑定到一个 Socket.IO socket 连接上。\n   * 自动监听 iflytek:start / iflytek:audio / iflytek:stop / disconnect 事件。\n   */\n  attach(socket: SocketLike): void {\n    socket.on(\"iflytek:start\", (payload?: IflytekStartPayload) => {\n      this.handleStart(socket, payload);\n    });\n\n    socket.on(\"iflytek:audio\", (frame: IflytekAudioFrame) => {\n      this.handleAudio(socket, frame);\n    });\n\n    socket.on(\"iflytek:stop\", (payload?: IflytekStopPayload) => {\n      this.handleStop(socket, payload);\n    });\n\n    socket.on(\"disconnect\", () => {\n      this.handleDisconnect(socket);\n    });\n  }\n\n  // ─── 事件处理 ───\n\n  private handleStart(socket: SocketLike, payload?: IflytekStartPayload) {\n    const sessionId =\n      payload?.sessionId ??\n      `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n\n    if (!this.appId || !this.apiKey || !this.apiSecret) {\n      socket.emit(\"iflytek:error\", {\n        sessionId,\n        message:\n          \"服务端未配置 IFLYTEK_APP_ID / IFLYTEK_API_KEY / IFLYTEK_API_SECRET\",\n      });\n      return;\n    }\n\n    const existing = this.sessions.get(socket.id);\n    if (existing) {\n      if (existing.ended) {\n        this.log(socket.id, \"replace ended session\");\n        this.closeUpstream(existing);\n        this.sessions.delete(socket.id);\n      } else if (existing.ws.readyState === WebSocket.OPEN) {\n        this.log(socket.id, \"duplicate start ignored (session open)\");\n        socket.emit(\"iflytek:ready\", { sessionId: existing.sessionId });\n        return;\n      } else if (existing.ws.readyState === WebSocket.CONNECTING) {\n        this.log(socket.id, \"duplicate start ignored (session connecting)\");\n        return;\n      } else {\n        this.sessions.delete(socket.id);\n      }\n    }\n\n    const wsUrl = this.buildWsUrl();\n    const ws = new WebSocket(wsUrl);\n    const state: SessionState = {\n      ws,\n      sessionId,\n      frameCount: 0,\n      firstFrameSent: false,\n      ended: false,\n      resultText: \"\",\n      resultSegments: [],\n    };\n    this.sessions.set(socket.id, state);\n    this.log(socket.id, \"start session\", { sessionId });\n\n    ws.on(\"open\", () => {\n      this.log(socket.id, \"upstream open\");\n      socket.emit(\"iflytek:ready\", { sessionId });\n    });\n\n    ws.on(\"message\", (raw) => {\n      try {\n        const msg = JSON.parse(String(raw));\n        this.log(socket.id, \"upstream message\", {\n          code: msg.code,\n          status: msg?.data?.status,\n        });\n        if (msg.code !== 0) {\n          socket.emit(\"iflytek:error\", {\n            sessionId,\n            message: msg.message || `讯飞返回错误 code=${msg.code}`,\n          });\n          return;\n        }\n\n        const current = this.sessions.get(socket.id);\n        if (!current || current.ws !== ws) return;\n\n        const result = this.extractResult(msg.data?.result);\n        const mergedText = this.mergeResult(current, result);\n        const isFinal = msg.data?.status === 2;\n        if (mergedText || isFinal) {\n          socket.emit(\"iflytek:result\", {\n            sessionId,\n            text: mergedText,\n            isFinal,\n          });\n        }\n\n        if (isFinal) {\n          const current = this.sessions.get(socket.id);\n          if (current?.ws === ws) {\n            this.closeUpstream(current);\n          }\n        }\n      } catch (e: any) {\n        socket.emit(\"iflytek:error\", { sessionId, message: e.message });\n      }\n    });\n\n    ws.on(\"error\", (e: any) => {\n      if (e?.message?.includes(\"before the connection was established\")) {\n        this.log(socket.id, \"ignore early-close error\");\n        return;\n      }\n      socket.emit(\"iflytek:error\", {\n        sessionId,\n        message: e?.message || \"讯飞 WebSocket 连接失败\",\n      });\n    });\n\n    ws.on(\"close\", () => {\n      this.log(socket.id, \"upstream close\");\n      const current = this.sessions.get(socket.id);\n      if (current?.ws === ws) {\n        this.sessions.delete(socket.id);\n      }\n    });\n  }\n\n  private handleAudio(socket: SocketLike, frame: IflytekAudioFrame) {\n    const state = this.sessions.get(socket.id);\n    if (!state || state.ws.readyState !== WebSocket.OPEN) return;\n\n    if (frame.sessionId && frame.sessionId !== state.sessionId) {\n      this.log(socket.id, \"ignore stale audio frame\");\n      return;\n    }\n    if (state.ended && frame.status === 2) {\n      this.log(socket.id, \"ignore duplicate final frame\");\n      return;\n    }\n    if (!state.firstFrameSent && frame.status === 2) {\n      this.log(socket.id, \"ignore lonely final frame\");\n      return;\n    }\n\n    const isFirst = !state.firstFrameSent && frame.status !== 2;\n    const status: 0 | 1 | 2 = isFirst ? 0 : frame.status;\n\n    state.frameCount += 1;\n    if (status === 0) state.firstFrameSent = true;\n    if (status === 2) state.ended = true;\n\n    this.log(socket.id, \"audio frame\", {\n      status,\n      hasAudio: Boolean(frame.audio),\n      len: frame.audio?.length ?? 0,\n      count: state.frameCount,\n    });\n\n    const payload: Record<string, unknown> = {\n      data: { status },\n    };\n\n    if (status === 0) {\n      payload.common = { app_id: this.appId };\n      payload.business = {\n        language: frame.language || \"zh_cn\",\n        domain: frame.domain || \"iat\",\n        accent: frame.accent || \"mandarin\",\n        vad_eos: 2000,\n      };\n      payload.data = {\n        status: 0,\n        format: \"audio/L16;rate=16000\",\n        encoding: \"raw\",\n        audio: frame.audio || \"\",\n      };\n    } else if (status === 1) {\n      payload.data = {\n        status: 1,\n        format: \"audio/L16;rate=16000\",\n        encoding: \"raw\",\n        audio: frame.audio || \"\",\n      };\n    } else {\n      payload.data = { status: 2 };\n    }\n\n    state.ws.send(JSON.stringify(payload));\n  }\n\n  private handleStop(socket: SocketLike, payload?: IflytekStopPayload) {\n    const state = this.sessions.get(socket.id);\n    if (\n      payload?.sessionId &&\n      state?.sessionId &&\n      payload.sessionId !== state.sessionId\n    ) {\n      this.log(socket.id, \"ignore stale stop signal\");\n      return;\n    }\n    this.log(socket.id, \"stop signal\");\n    if (state) {\n      this.closeUpstream(state);\n      this.sessions.delete(socket.id);\n    }\n  }\n\n  private handleDisconnect(socket: SocketLike) {\n    const state = this.sessions.get(socket.id);\n    if (state) {\n      this.closeUpstream(state);\n      this.sessions.delete(socket.id);\n    }\n  }\n\n  // ─── 工具方法 ───\n\n  private buildWsUrl(): string {\n    const date = new Date().toUTCString();\n    const requestLine = `GET ${this.path} HTTP/1.1`;\n    const signatureOrigin = `host: ${this.host}\\ndate: ${date}\\n${requestLine}`;\n    const signatureSha = crypto\n      .createHmac(\"sha256\", this.apiSecret)\n      .update(signatureOrigin)\n      .digest(\"base64\");\n    const authOrigin = `api_key=\"${this.apiKey}\", algorithm=\"hmac-sha256\", headers=\"host date request-line\", signature=\"${signatureSha}\"`;\n    const authorization = Buffer.from(authOrigin).toString(\"base64\");\n    const params = new URLSearchParams({ authorization, date, host: this.host });\n    return `wss://${this.host}${this.path}?${params.toString()}`;\n  }\n\n  private extractText(result: any): string {\n    const ws = result?.ws;\n    if (!Array.isArray(ws)) return \"\";\n    return ws\n      .map((item: any) => item?.cw?.[0]?.w ?? \"\")\n      .join(\"\")\n      .trim();\n  }\n\n  private extractResult(result: any): {\n    text: string;\n    pgs?: string;\n    rg?: [number, number];\n    sn?: number;\n  } {\n    const text = this.extractText(result);\n    const pgs =\n      typeof result?.pgs === \"string\" ? result.pgs : undefined;\n    const rgRaw = Array.isArray(result?.rg) ? result.rg : undefined;\n    const rg =\n      rgRaw && rgRaw.length === 2\n        ? ([Number(rgRaw[0]), Number(rgRaw[1])] as [number, number])\n        : undefined;\n    const sn =\n      typeof result?.sn === \"number\"\n        ? result.sn\n        : Number.isFinite(Number(result?.sn))\n          ? Number(result?.sn)\n          : undefined;\n    return { text, pgs, rg, sn };\n  }\n\n  private mergeResult(\n    state: SessionState,\n    result: { text: string; pgs?: string; rg?: [number, number]; sn?: number },\n  ): string {\n    const text = result.text?.trim() ?? \"\";\n    const segments = state.resultSegments;\n\n    if (typeof result.sn === \"number\") {\n      if (result.pgs === \"rpl\" && result.rg) {\n        const [start, end] = result.rg;\n        const before = segments.slice(0, start);\n        const after = segments.slice(end + 1);\n        state.resultSegments = [...before, text, ...after];\n      } else {\n        segments[result.sn] = text;\n        state.resultSegments = segments;\n      }\n    } else if (result.pgs === \"rpl\" && result.rg) {\n      const [start, end] = result.rg;\n      const before = segments.slice(0, start);\n      const after = segments.slice(end + 1);\n      state.resultSegments = [...before, text, ...after];\n    } else if (text) {\n      segments.push(text);\n      state.resultSegments = segments;\n    }\n\n    state.resultText = state.resultSegments.filter(Boolean).join(\"\");\n    return state.resultText;\n  }\n\n  private closeUpstream(state: SessionState) {\n    try {\n      state.ws.close();\n    } catch {}\n  }\n\n  private log(socketId: string, msg: string, extra?: Record<string, unknown>) {\n    if (!this.debug) return;\n    if (extra) {\n      console.log(`[sa2kit/iflytek][${socketId}] ${msg}`, extra);\n    } else {\n      console.log(`[sa2kit/iflytek][${socketId}] ${msg}`);\n    }\n  }\n}\n"]}

package/dist/iflytek/server.mjs

@@ -0,0 +1,274 @@
+import '../chunk-WMJKH4XE.mjs';
+import crypto from 'crypto';
+import WebSocket from 'ws';
+
+var IflytekServerAdapter = class {
+  constructor(config) {
+    this.sessions = /* @__PURE__ */ new Map();
+    this.appId = config.appId;
+    this.apiKey = config.apiKey;
+    this.apiSecret = config.apiSecret;
+    this.host = config.host ?? "iat-api.xfyun.cn";
+    this.path = config.path ?? "/v2/iat";
+    this.debug = config.debug ?? false;
+  }
+  /**
+   * 将适配器绑定到一个 Socket.IO socket 连接上。
+   * 自动监听 iflytek:start / iflytek:audio / iflytek:stop / disconnect 事件。
+   */
+  attach(socket) {
+    socket.on("iflytek:start", (payload) => {
+      this.handleStart(socket, payload);
+    });
+    socket.on("iflytek:audio", (frame) => {
+      this.handleAudio(socket, frame);
+    });
+    socket.on("iflytek:stop", (payload) => {
+      this.handleStop(socket, payload);
+    });
+    socket.on("disconnect", () => {
+      this.handleDisconnect(socket);
+    });
+  }
+  // ─── 事件处理 ───
+  handleStart(socket, payload) {
+    const sessionId = payload?.sessionId ?? `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    if (!this.appId || !this.apiKey || !this.apiSecret) {
+      socket.emit("iflytek:error", {
+        sessionId,
+        message: "\u670D\u52A1\u7AEF\u672A\u914D\u7F6E IFLYTEK_APP_ID / IFLYTEK_API_KEY / IFLYTEK_API_SECRET"
+      });
+      return;
+    }
+    const existing = this.sessions.get(socket.id);
+    if (existing) {
+      if (existing.ended) {
+        this.log(socket.id, "replace ended session");
+        this.closeUpstream(existing);
+        this.sessions.delete(socket.id);
+      } else if (existing.ws.readyState === WebSocket.OPEN) {
+        this.log(socket.id, "duplicate start ignored (session open)");
+        socket.emit("iflytek:ready", { sessionId: existing.sessionId });
+        return;
+      } else if (existing.ws.readyState === WebSocket.CONNECTING) {
+        this.log(socket.id, "duplicate start ignored (session connecting)");
+        return;
+      } else {
+        this.sessions.delete(socket.id);
+      }
+    }
+    const wsUrl = this.buildWsUrl();
+    const ws = new WebSocket(wsUrl);
+    const state = {
+      ws,
+      sessionId,
+      frameCount: 0,
+      firstFrameSent: false,
+      ended: false,
+      resultText: "",
+      resultSegments: []
+    };
+    this.sessions.set(socket.id, state);
+    this.log(socket.id, "start session", { sessionId });
+    ws.on("open", () => {
+      this.log(socket.id, "upstream open");
+      socket.emit("iflytek:ready", { sessionId });
+    });
+    ws.on("message", (raw) => {
+      try {
+        const msg = JSON.parse(String(raw));
+        this.log(socket.id, "upstream message", {
+          code: msg.code,
+          status: msg?.data?.status
+        });
+        if (msg.code !== 0) {
+          socket.emit("iflytek:error", {
+            sessionId,
+            message: msg.message || `\u8BAF\u98DE\u8FD4\u56DE\u9519\u8BEF code=${msg.code}`
+          });
+          return;
+        }
+        const current = this.sessions.get(socket.id);
+        if (!current || current.ws !== ws) return;
+        const result = this.extractResult(msg.data?.result);
+        const mergedText = this.mergeResult(current, result);
+        const isFinal = msg.data?.status === 2;
+        if (mergedText || isFinal) {
+          socket.emit("iflytek:result", {
+            sessionId,
+            text: mergedText,
+            isFinal
+          });
+        }
+        if (isFinal) {
+          const current2 = this.sessions.get(socket.id);
+          if (current2?.ws === ws) {
+            this.closeUpstream(current2);
+          }
+        }
+      } catch (e) {
+        socket.emit("iflytek:error", { sessionId, message: e.message });
+      }
+    });
+    ws.on("error", (e) => {
+      if (e?.message?.includes("before the connection was established")) {
+        this.log(socket.id, "ignore early-close error");
+        return;
+      }
+      socket.emit("iflytek:error", {
+        sessionId,
+        message: e?.message || "\u8BAF\u98DE WebSocket \u8FDE\u63A5\u5931\u8D25"
+      });
+    });
+    ws.on("close", () => {
+      this.log(socket.id, "upstream close");
+      const current = this.sessions.get(socket.id);
+      if (current?.ws === ws) {
+        this.sessions.delete(socket.id);
+      }
+    });
+  }
+  handleAudio(socket, frame) {
+    const state = this.sessions.get(socket.id);
+    if (!state || state.ws.readyState !== WebSocket.OPEN) return;
+    if (frame.sessionId && frame.sessionId !== state.sessionId) {
+      this.log(socket.id, "ignore stale audio frame");
+      return;
+    }
+    if (state.ended && frame.status === 2) {
+      this.log(socket.id, "ignore duplicate final frame");
+      return;
+    }
+    if (!state.firstFrameSent && frame.status === 2) {
+      this.log(socket.id, "ignore lonely final frame");
+      return;
+    }
+    const isFirst = !state.firstFrameSent && frame.status !== 2;
+    const status = isFirst ? 0 : frame.status;
+    state.frameCount += 1;
+    if (status === 0) state.firstFrameSent = true;
+    if (status === 2) state.ended = true;
+    this.log(socket.id, "audio frame", {
+      status,
+      hasAudio: Boolean(frame.audio),
+      len: frame.audio?.length ?? 0,
+      count: state.frameCount
+    });
+    const payload = {
+      data: { status }
+    };
+    if (status === 0) {
+      payload.common = { app_id: this.appId };
+      payload.business = {
+        language: frame.language || "zh_cn",
+        domain: frame.domain || "iat",
+        accent: frame.accent || "mandarin",
+        vad_eos: 2e3
+      };
+      payload.data = {
+        status: 0,
+        format: "audio/L16;rate=16000",
+        encoding: "raw",
+        audio: frame.audio || ""
+      };
+    } else if (status === 1) {
+      payload.data = {
+        status: 1,
+        format: "audio/L16;rate=16000",
+        encoding: "raw",
+        audio: frame.audio || ""
+      };
+    } else {
+      payload.data = { status: 2 };
+    }
+    state.ws.send(JSON.stringify(payload));
+  }
+  handleStop(socket, payload) {
+    const state = this.sessions.get(socket.id);
+    if (payload?.sessionId && state?.sessionId && payload.sessionId !== state.sessionId) {
+      this.log(socket.id, "ignore stale stop signal");
+      return;
+    }
+    this.log(socket.id, "stop signal");
+    if (state) {
+      this.closeUpstream(state);
+      this.sessions.delete(socket.id);
+    }
+  }
+  handleDisconnect(socket) {
+    const state = this.sessions.get(socket.id);
+    if (state) {
+      this.closeUpstream(state);
+      this.sessions.delete(socket.id);
+    }
+  }
+  // ─── 工具方法 ───
+  buildWsUrl() {
+    const date = (/* @__PURE__ */ new Date()).toUTCString();
+    const requestLine = `GET ${this.path} HTTP/1.1`;
+    const signatureOrigin = `host: ${this.host}
+date: ${date}
+${requestLine}`;
+    const signatureSha = crypto.createHmac("sha256", this.apiSecret).update(signatureOrigin).digest("base64");
+    const authOrigin = `api_key="${this.apiKey}", algorithm="hmac-sha256", headers="host date request-line", signature="${signatureSha}"`;
+    const authorization = Buffer.from(authOrigin).toString("base64");
+    const params = new URLSearchParams({ authorization, date, host: this.host });
+    return `wss://${this.host}${this.path}?${params.toString()}`;
+  }
+  extractText(result) {
+    const ws = result?.ws;
+    if (!Array.isArray(ws)) return "";
+    return ws.map((item) => item?.cw?.[0]?.w ?? "").join("").trim();
+  }
+  extractResult(result) {
+    const text = this.extractText(result);
+    const pgs = typeof result?.pgs === "string" ? result.pgs : void 0;
+    const rgRaw = Array.isArray(result?.rg) ? result.rg : void 0;
+    const rg = rgRaw && rgRaw.length === 2 ? [Number(rgRaw[0]), Number(rgRaw[1])] : void 0;
+    const sn = typeof result?.sn === "number" ? result.sn : Number.isFinite(Number(result?.sn)) ? Number(result?.sn) : void 0;
+    return { text, pgs, rg, sn };
+  }
+  mergeResult(state, result) {
+    const text = result.text?.trim() ?? "";
+    const segments = state.resultSegments;
+    if (typeof result.sn === "number") {
+      if (result.pgs === "rpl" && result.rg) {
+        const [start, end] = result.rg;
+        const before = segments.slice(0, start);
+        const after = segments.slice(end + 1);
+        state.resultSegments = [...before, text, ...after];
+      } else {
+        segments[result.sn] = text;
+        state.resultSegments = segments;
+      }
+    } else if (result.pgs === "rpl" && result.rg) {
+      const [start, end] = result.rg;
+      const before = segments.slice(0, start);
+      const after = segments.slice(end + 1);
+      state.resultSegments = [...before, text, ...after];
+    } else if (text) {
+      segments.push(text);
+      state.resultSegments = segments;
+    }
+    state.resultText = state.resultSegments.filter(Boolean).join("");
+    return state.resultText;
+  }
+  closeUpstream(state) {
+    try {
+      state.ws.close();
+    } catch {
+    }
+  }
+  log(socketId, msg, extra) {
+    if (!this.debug) return;
+    if (extra) {
+      console.log(`[sa2kit/iflytek][${socketId}] ${msg}`, extra);
+    } else {
+      console.log(`[sa2kit/iflytek][${socketId}] ${msg}`);
+    }
+  }
+};
+
+export { IflytekServerAdapter };
+//# sourceMappingURL=server.mjs.map
+//# sourceMappingURL=server.mjs.map

package/dist/iflytek/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/iflytek/IflytekServerAdapter.ts"],"names":["current"],"mappings":";;;;AAiDO,IAAM,uBAAN,MAA2B;AAAA,EAUhC,YAAY,MAAA,EAA6B;AAFzC,IAAA,IAAA,CAAQ,QAAA,uBAAe,GAAA,EAA0B;AAG/C,IAAA,IAAA,CAAK,QAAQ,MAAA,CAAO,KAAA;AACpB,IAAA,IAAA,CAAK,SAAS,MAAA,CAAO,MAAA;AACrB,IAAA,IAAA,CAAK,YAAY,MAAA,CAAO,SAAA;AACxB,IAAA,IAAA,CAAK,IAAA,GAAO,OAAO,IAAA,IAAQ,kBAAA;AAC3B,IAAA,IAAA,CAAK,IAAA,GAAO,OAAO,IAAA,IAAQ,SAAA;AAC3B,IAAA,IAAA,CAAK,KAAA,GAAQ,OAAO,KAAA,IAAS,KAAA;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,MAAA,EAA0B;AAC/B,IAAA,MAAA,CAAO,EAAA,CAAG,eAAA,EAAiB,CAAC,OAAA,KAAkC;AAC5D,MAAA,IAAA,CAAK,WAAA,CAAY,QAAQ,OAAO,CAAA;AAAA,IAClC,CAAC,CAAA;AAED,IAAA,MAAA,CAAO,EAAA,CAAG,eAAA,EAAiB,CAAC,KAAA,KAA6B;AACvD,MAAA,IAAA,CAAK,WAAA,CAAY,QAAQ,KAAK,CAAA;AAAA,IAChC,CAAC,CAAA;AAED,IAAA,MAAA,CAAO,EAAA,CAAG,cAAA,EAAgB,CAAC,OAAA,KAAiC;AAC1D,MAAA,IAAA,CAAK,UAAA,CAAW,QAAQ,OAAO,CAAA;AAAA,IACjC,CAAC,CAAA;AAED,IAAA,MAAA,CAAO,EAAA,CAAG,cAAc,MAAM;AAC5B,MAAA,IAAA,CAAK,iBAAiB,MAAM,CAAA;AAAA,IAC9B,CAAC,CAAA;AAAA,EACH;AAAA;AAAA,EAIQ,WAAA,CAAY,QAAoB,OAAA,EAA+B;AACrE,IAAA,MAAM,YACJ,OAAA,EAAS,SAAA,IACT,CAAA,EAAG,IAAA,CAAK,KAAK,CAAA,CAAA,EAAI,IAAA,CAAK,MAAA,GAAS,QAAA,CAAS,EAAE,EAAE,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA,CAAA;AAEzD,IAAA,IAAI,CAAC,KAAK,KAAA,IAAS,CAAC,KAAK,MAAA,IAAU,CAAC,KAAK,SAAA,EAAW;AAClD,MAAA,MAAA,CAAO,KAAK,eAAA,EAAiB;AAAA,QAC3B,SAAA;AAAA,QACA,OAAA,EACE;AAAA,OACH,CAAA;AACD,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,OAAO,EAAE,CAAA;AAC5C,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,IAAI,SAAS,KAAA,EAAO;AAClB,QAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,uBAAuB,CAAA;AAC3C,QAAA,IAAA,CAAK,cAAc,QAAQ,CAAA;AAC3B,QAAA,IAAA,CAAK,QAAA,CAAS,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAAA,MAChC,CAAA,MAAA,IAAW,QAAA,CAAS,EAAA,CAAG,UAAA,KAAe,UAAU,IAAA,EAAM;AACpD,QAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,wCAAwC,CAAA;AAC5D,QAAA,MAAA,CAAO,KAAK,eAAA,EAAiB,EAAE,SAAA,EAAW,QAAA,CAAS,WAAW,CAAA;AAC9D,QAAA;AAAA,MACF,CAAA,MAAA,IAAW,QAAA,CAAS,EAAA,CAAG,UAAA,KAAe,UAAU,UAAA,EAAY;AAC1D,QAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,8CAA8C,CAAA;AAClE,QAAA;AAAA,MACF,CAAA,MAAO;AACL,QAAA,IAAA,CAAK,QAAA,CAAS,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAAA,MAChC;AAAA,IACF;AAEA,IAAA,MAAM,KAAA,GAAQ,KAAK,UAAA,EAAW;AAC9B,IAAA,MAAM,EAAA,GAAK,IAAI,SAAA,CAAU,KAAK,CAAA;AAC9B,IAAA,MAAM,KAAA,GAAsB;AAAA,MAC1B,EAAA;AAAA,MACA,SAAA;AAAA,MACA,UAAA,EAAY,CAAA;AAAA,MACZ,cAAA,EAAgB,KAAA;AAAA,MAChB,KAAA,EAAO,KAAA;AAAA,MACP,UAAA,EAAY,EAAA;AAAA,MACZ,gBAAgB;AAAC,KACnB;AACA,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,KAAK,CAAA;AAClC,IAAA,IAAA,CAAK,IAAI,MAAA,CAAO,EAAA,EAAI,eAAA,EAAiB,EAAE,WAAW,CAAA;AAElD,IAAA,EAAA,CAAG,EAAA,CAAG,QAAQ,MAAM;AAClB,MAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,eAAe,CAAA;AACnC,MAAA,MAAA,CAAO,IAAA,CAAK,eAAA,EAAiB,EAAE,SAAA,EAAW,CAAA;AAAA,IAC5C,CAAC,CAAA;AAED,IAAA,EAAA,CAAG,EAAA,CAAG,SAAA,EAAW,CAAC,GAAA,KAAQ;AACxB,MAAA,IAAI;AACF,QAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAA;AAClC,QAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,kBAAA,EAAoB;AAAA,UACtC,MAAM,GAAA,CAAI,IAAA;AAAA,UACV,MAAA,EAAQ,KAAK,IAAA,EAAM;AAAA,SACpB,CAAA;AACD,QAAA,IAAI,GAAA,CAAI,SAAS,CAAA,EAAG;AAClB,UAAA,MAAA,CAAO,KAAK,eAAA,EAAiB;AAAA,YAC3B,SAAA;AAAA,YACA,OAAA,EAAS,GAAA,CAAI,OAAA,IAAW,CAAA,0CAAA,EAAe,IAAI,IAAI,CAAA;AAAA,WAChD,CAAA;AACD,UAAA;AAAA,QACF;AAEA,QAAA,MAAM,OAAA,GAAU,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,OAAO,EAAE,CAAA;AAC3C,QAAA,IAAI,CAAC,OAAA,IAAW,OAAA,CAAQ,EAAA,KAAO,EAAA,EAAI;AAEnC,QAAA,MAAM,MAAA,GAAS,IAAA,CAAK,aAAA,CAAc,GAAA,CAAI,MAAM,MAAM,CAAA;AAClD,QAAA,MAAM,UAAA,GAAa,IAAA,CAAK,WAAA,CAAY,OAAA,EAAS,MAAM,CAAA;AACnD,QAAA,MAAM,OAAA,GAAU,GAAA,CAAI,IAAA,EAAM,MAAA,KAAW,CAAA;AACrC,QAAA,IAAI,cAAc,OAAA,EAAS;AACzB,UAAA,MAAA,CAAO,KAAK,gBAAA,EAAkB;AAAA,YAC5B,SAAA;AAAA,YACA,IAAA,EAAM,UAAA;AAAA,YACN;AAAA,WACD,CAAA;AAAA,QACH;AAEA,QAAA,IAAI,OAAA,EAAS;AACX,UAAA,MAAMA,QAAAA,GAAU,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,OAAO,EAAE,CAAA;AAC3C,UAAA,IAAIA,QAAAA,EAAS,OAAO,EAAA,EAAI;AACtB,YAAA,IAAA,CAAK,cAAcA,QAAO,CAAA;AAAA,UAC5B;AAAA,QACF;AAAA,MACF,SAAS,CAAA,EAAQ;AACf,QAAA,MAAA,CAAO,KAAK,eAAA,EAAiB,EAAE,WAAW,OAAA,EAAS,CAAA,CAAE,SAAS,CAAA;AAAA,MAChE;AAAA,IACF,CAAC,CAAA;AAED,IAAA,EAAA,CAAG,EAAA,CAAG,OAAA,EAAS,CAAC,CAAA,KAAW;AACzB,MAAA,IAAI,CAAA,EAAG,OAAA,EAAS,QAAA,CAAS,uCAAuC,CAAA,EAAG;AACjE,QAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,0BAA0B,CAAA;AAC9C,QAAA;AAAA,MACF;AACA,MAAA,MAAA,CAAO,KAAK,eAAA,EAAiB;AAAA,QAC3B,SAAA;AAAA,QACA,OAAA,EAAS,GAAG,OAAA,IAAW;AAAA,OACxB,CAAA;AAAA,IACH,CAAC,CAAA;AAED,IAAA,EAAA,CAAG,EAAA,CAAG,SAAS,MAAM;AACnB,MAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,gBAAgB,CAAA;AACpC,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,OAAO,EAAE,CAAA;AAC3C,MAAA,IAAI,OAAA,EAAS,OAAO,EAAA,EAAI;AACtB,QAAA,IAAA,CAAK,QAAA,CAAS,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAAA,MAChC;AAAA,IACF,CAAC,CAAA;AAAA,EACH;AAAA,EAEQ,WAAA,CAAY,QAAoB,KAAA,EAA0B;AAChE,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,OAAO,EAAE,CAAA;AACzC,IAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,EAAA,CAAG,UAAA,KAAe,UAAU,IAAA,EAAM;AAEtD,IAAA,IAAI,KAAA,CAAM,SAAA,IAAa,KAAA,CAAM,SAAA,KAAc,MAAM,SAAA,EAAW;AAC1D,MAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,0BAA0B,CAAA;AAC9C,MAAA;AAAA,IACF;AACA,IAAA,IAAI,KAAA,CAAM,KAAA,IAAS,KAAA,CAAM,MAAA,KAAW,CAAA,EAAG;AACrC,MAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,8BAA8B,CAAA;AAClD,MAAA;AAAA,IACF;AACA,IAAA,IAAI,CAAC,KAAA,CAAM,cAAA,IAAkB,KAAA,CAAM,WAAW,CAAA,EAAG;AAC/C,MAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,2BAA2B,CAAA;AAC/C,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,OAAA,GAAU,CAAC,KAAA,CAAM,cAAA,IAAkB,MAAM,MAAA,KAAW,CAAA;AAC1D,IAAA,MAAM,MAAA,GAAoB,OAAA,GAAU,CAAA,GAAI,KAAA,CAAM,MAAA;AAE9C,IAAA,KAAA,CAAM,UAAA,IAAc,CAAA;AACpB,IAAA,IAAI,MAAA,KAAW,CAAA,EAAG,KAAA,CAAM,cAAA,GAAiB,IAAA;AACzC,IAAA,IAAI,MAAA,KAAW,CAAA,EAAG,KAAA,CAAM,KAAA,GAAQ,IAAA;AAEhC,IAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,aAAA,EAAe;AAAA,MACjC,MAAA;AAAA,MACA,QAAA,EAAU,OAAA,CAAQ,KAAA,CAAM,KAAK,CAAA;AAAA,MAC7B,GAAA,EAAK,KAAA,CAAM,KAAA,EAAO,MAAA,IAAU,CAAA;AAAA,MAC5B,OAAO,KAAA,CAAM;AAAA,KACd,CAAA;AAED,IAAA,MAAM,OAAA,GAAmC;AAAA,MACvC,IAAA,EAAM,EAAE,MAAA;AAAO,KACjB;AAEA,IAAA,IAAI,WAAW,CAAA,EAAG;AAChB,MAAA,OAAA,CAAQ,MAAA,GAAS,EAAE,MAAA,EAAQ,IAAA,CAAK,KAAA,EAAM;AACtC,MAAA,OAAA,CAAQ,QAAA,GAAW;AAAA,QACjB,QAAA,EAAU,MAAM,QAAA,IAAY,OAAA;AAAA,QAC5B,MAAA,EAAQ,MAAM,MAAA,IAAU,KAAA;AAAA,QACxB,MAAA,EAAQ,MAAM,MAAA,IAAU,UAAA;AAAA,QACxB,OAAA,EAAS;AAAA,OACX;AACA,MAAA,OAAA,CAAQ,IAAA,GAAO;AAAA,QACb,MAAA,EAAQ,CAAA;AAAA,QACR,MAAA,EAAQ,sBAAA;AAAA,QACR,QAAA,EAAU,KAAA;AAAA,QACV,KAAA,EAAO,MAAM,KAAA,IAAS;AAAA,OACxB;AAAA,IACF,CAAA,MAAA,IAAW,WAAW,CAAA,EAAG;AACvB,MAAA,OAAA,CAAQ,IAAA,GAAO;AAAA,QACb,MAAA,EAAQ,CAAA;AAAA,QACR,MAAA,EAAQ,sBAAA;AAAA,QACR,QAAA,EAAU,KAAA;AAAA,QACV,KAAA,EAAO,MAAM,KAAA,IAAS;AAAA,OACxB;AAAA,IACF,CAAA,MAAO;AACL,MAAA,OAAA,CAAQ,IAAA,GAAO,EAAE,MAAA,EAAQ,CAAA,EAAE;AAAA,IAC7B;AAEA,IAAA,KAAA,CAAM,EAAA,CAAG,IAAA,CAAK,IAAA,CAAK,SAAA,CAAU,OAAO,CAAC,CAAA;AAAA,EACvC;AAAA,EAEQ,UAAA,CAAW,QAAoB,OAAA,EAA8B;AACnE,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,OAAO,EAAE,CAAA;AACzC,IAAA,IACE,SAAS,SAAA,IACT,KAAA,EAAO,aACP,OAAA,CAAQ,SAAA,KAAc,MAAM,SAAA,EAC5B;AACA,MAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,0BAA0B,CAAA;AAC9C,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,aAAa,CAAA;AACjC,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,IAAA,CAAK,cAAc,KAAK,CAAA;AACxB,MAAA,IAAA,CAAK,QAAA,CAAS,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAAA,IAChC;AAAA,EACF;AAAA,EAEQ,iBAAiB,MAAA,EAAoB;AAC3C,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,OAAO,EAAE,CAAA;AACzC,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,IAAA,CAAK,cAAc,KAAK,CAAA;AACxB,MAAA,IAAA,CAAK,QAAA,CAAS,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAAA,IAChC;AAAA,EACF;AAAA;AAAA,EAIQ,UAAA,GAAqB;AAC3B,IAAA,MAAM,IAAA,GAAA,iBAAO,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AACpC,IAAA,MAAM,WAAA,GAAc,CAAA,IAAA,EAAO,IAAA,CAAK,IAAI,CAAA,SAAA,CAAA;AACpC,IAAA,MAAM,eAAA,GAAkB,CAAA,MAAA,EAAS,IAAA,CAAK,IAAI;AAAA,MAAA,EAAW,IAAI;AAAA,EAAK,WAAW,CAAA,CAAA;AACzE,IAAA,MAAM,YAAA,GAAe,MAAA,CAClB,UAAA,CAAW,QAAA,EAAU,IAAA,CAAK,SAAS,CAAA,CACnC,MAAA,CAAO,eAAe,CAAA,CACtB,MAAA,CAAO,QAAQ,CAAA;AAClB,IAAA,MAAM,UAAA,GAAa,CAAA,SAAA,EAAY,IAAA,CAAK,MAAM,4EAA4E,YAAY,CAAA,CAAA,CAAA;AAClI,IAAA,MAAM,gBAAgB,MAAA,CAAO,IAAA,CAAK,UAAU,CAAA,CAAE,SAAS,QAAQ,CAAA;AAC/D,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,CAAgB,EAAE,eAAe,IAAA,EAAM,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,CAAA;AAC3E,IAAA,OAAO,CAAA,MAAA,EAAS,KAAK,IAAI,CAAA,EAAG,KAAK,IAAI,CAAA,CAAA,EAAI,MAAA,CAAO,QAAA,EAAU,CAAA,CAAA;AAAA,EAC5D;AAAA,EAEQ,YAAY,MAAA,EAAqB;AACvC,IAAA,MAAM,KAAK,MAAA,EAAQ,EAAA;AACnB,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,EAAE,GAAG,OAAO,EAAA;AAC/B,IAAA,OAAO,EAAA,CACJ,GAAA,CAAI,CAAC,IAAA,KAAc,MAAM,EAAA,GAAK,CAAC,CAAA,EAAG,CAAA,IAAK,EAAE,CAAA,CACzC,IAAA,CAAK,EAAE,EACP,IAAA,EAAK;AAAA,EACV;AAAA,EAEQ,cAAc,MAAA,EAKpB;AACA,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,WAAA,CAAY,MAAM,CAAA;AACpC,IAAA,MAAM,MACJ,OAAO,MAAA,EAAQ,GAAA,KAAQ,QAAA,GAAW,OAAO,GAAA,GAAM,MAAA;AACjD,IAAA,MAAM,QAAQ,KAAA,CAAM,OAAA,CAAQ,QAAQ,EAAE,CAAA,GAAI,OAAO,EAAA,GAAK,MAAA;AACtD,IAAA,MAAM,KACJ,KAAA,IAAS,KAAA,CAAM,MAAA,KAAW,CAAA,GACrB,CAAC,MAAA,CAAO,KAAA,CAAM,CAAC,CAAC,GAAG,MAAA,CAAO,KAAA,CAAM,CAAC,CAAC,CAAC,CAAA,GACpC,MAAA;AACN,IAAA,MAAM,KACJ,OAAO,MAAA,EAAQ,EAAA,KAAO,QAAA,GAClB,OAAO,EAAA,GACP,MAAA,CAAO,QAAA,CAAS,MAAA,CAAO,QAAQ,EAAE,CAAC,IAChC,MAAA,CAAO,MAAA,EAAQ,EAAE,CAAA,GACjB,MAAA;AACR,IAAA,OAAO,EAAE,IAAA,EAAM,GAAA,EAAK,EAAA,EAAI,EAAA,EAAG;AAAA,EAC7B;AAAA,EAEQ,WAAA,CACN,OACA,MAAA,EACQ;AACR,IAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,EAAM,IAAA,EAAK,IAAK,EAAA;AACpC,IAAA,MAAM,WAAW,KAAA,CAAM,cAAA;AAEvB,IAAA,IAAI,OAAO,MAAA,CAAO,EAAA,KAAO,QAAA,EAAU;AACjC,MAAA,IAAI,MAAA,CAAO,GAAA,KAAQ,KAAA,IAAS,MAAA,CAAO,EAAA,EAAI;AACrC,QAAA,MAAM,CAAC,KAAA,EAAO,GAAG,CAAA,GAAI,MAAA,CAAO,EAAA;AAC5B,QAAA,MAAM,MAAA,GAAS,QAAA,CAAS,KAAA,CAAM,CAAA,EAAG,KAAK,CAAA;AACtC,QAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,KAAA,CAAM,GAAA,GAAM,CAAC,CAAA;AACpC,QAAA,KAAA,CAAM,iBAAiB,CAAC,GAAG,MAAA,EAAQ,IAAA,EAAM,GAAG,KAAK,CAAA;AAAA,MACnD,CAAA,MAAO;AACL,QAAA,QAAA,CAAS,MAAA,CAAO,EAAE,CAAA,GAAI,IAAA;AACtB,QAAA,KAAA,CAAM,cAAA,GAAiB,QAAA;AAAA,MACzB;AAAA,IACF,CAAA,MAAA,IAAW,MAAA,CAAO,GAAA,KAAQ,KAAA,IAAS,OAAO,EAAA,EAAI;AAC5C,MAAA,MAAM,CAAC,KAAA,EAAO,GAAG,CAAA,GAAI,MAAA,CAAO,EAAA;AAC5B,MAAA,MAAM,MAAA,GAAS,QAAA,CAAS,KAAA,CAAM,CAAA,EAAG,KAAK,CAAA;AACtC,MAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,KAAA,CAAM,GAAA,GAAM,CAAC,CAAA;AACpC,MAAA,KAAA,CAAM,iBAAiB,CAAC,GAAG,MAAA,EAAQ,IAAA,EAAM,GAAG,KAAK,CAAA;AAAA,IACnD,WAAW,IAAA,EAAM;AACf,MAAA,QAAA,CAAS,KAAK,IAAI,CAAA;AAClB,MAAA,KAAA,CAAM,cAAA,GAAiB,QAAA;AAAA,IACzB;AAEA,IAAA,KAAA,CAAM,aAAa,KAAA,CAAM,cAAA,CAAe,OAAO,OAAO,CAAA,CAAE,KAAK,EAAE,CAAA;AAC/D,IAAA,OAAO,KAAA,CAAM,UAAA;AAAA,EACf;AAAA,EAEQ,cAAc,KAAA,EAAqB;AACzC,IAAA,IAAI;AACF,MAAA,KAAA,CAAM,GAAG,KAAA,EAAM;AAAA,IACjB,CAAA,CAAA,MAAQ;AAAA,IAAC;AAAA,EACX;AAAA,EAEQ,GAAA,CAAI,QAAA,EAAkB,GAAA,EAAa,KAAA,EAAiC;AAC1E,IAAA,IAAI,CAAC,KAAK,KAAA,EAAO;AACjB,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,OAAA,CAAQ,IAAI,CAAA,iBAAA,EAAoB,QAAQ,CAAA,EAAA,EAAK,GAAG,IAAI,KAAK,CAAA;AAAA,IAC3D,CAAA,MAAO;AACL,MAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,iBAAA,EAAoB,QAAQ,CAAA,EAAA,EAAK,GAAG,CAAA,CAAE,CAAA;AAAA,IACpD;AAAA,EACF;AACF","file":"server.mjs","sourcesContent":["/**\n * 讯飞语音转文字 — 服务端适配层\n *\n * 运行在 Node.js 上，为每个 Socket.IO 客户端管理一条到讯飞 WebSocket 的上游连接。\n * 纯逻辑，不依赖任何 HTTP 框架。\n *\n * 使用方式：\n * ```ts\n * import { Server } from \"socket.io\";\n * import { IflytekServerAdapter } from \"sa2kit/iflytek/server\";\n *\n * const io = new Server(httpServer, { cors: { origin: \"*\" } });\n * const adapter = new IflytekServerAdapter({\n *   appId: process.env.IFLYTEK_APP_ID!,\n *   apiKey: process.env.IFLYTEK_API_KEY!,\n *   apiSecret: process.env.IFLYTEK_API_SECRET!,\n * });\n *\n * io.on(\"connection\", (socket) => {\n *   adapter.attach(socket);\n * });\n * ```\n */\n\nimport crypto from \"crypto\";\nimport WebSocket from \"ws\";\nimport type {\n  IflytekServerConfig,\n  IflytekAudioFrame,\n  IflytekStartPayload,\n  IflytekStopPayload,\n} from \"./types\";\n\ninterface SessionState {\n  ws: WebSocket;\n  sessionId: string;\n  frameCount: number;\n  firstFrameSent: boolean;\n  ended: boolean;\n  resultText: string;\n  resultSegments: string[];\n}\n\ninterface SocketLike {\n  id: string;\n  emit(event: string, data: unknown): void;\n  on(event: string, handler: (...args: any[]) => void): void;\n}\n\nexport class IflytekServerAdapter {\n  private appId: string;\n  private apiKey: string;\n  private apiSecret: string;\n  private host: string;\n  private path: string;\n  private debug: boolean;\n\n  private sessions = new Map<string, SessionState>();\n\n  constructor(config: IflytekServerConfig) {\n    this.appId = config.appId;\n    this.apiKey = config.apiKey;\n    this.apiSecret = config.apiSecret;\n    this.host = config.host ?? \"iat-api.xfyun.cn\";\n    this.path = config.path ?? \"/v2/iat\";\n    this.debug = config.debug ?? false;\n  }\n\n  /**\n   * 将适配器绑定到一个 Socket.IO socket 连接上。\n   * 自动监听 iflytek:start / iflytek:audio / iflytek:stop / disconnect 事件。\n   */\n  attach(socket: SocketLike): void {\n    socket.on(\"iflytek:start\", (payload?: IflytekStartPayload) => {\n      this.handleStart(socket, payload);\n    });\n\n    socket.on(\"iflytek:audio\", (frame: IflytekAudioFrame) => {\n      this.handleAudio(socket, frame);\n    });\n\n    socket.on(\"iflytek:stop\", (payload?: IflytekStopPayload) => {\n      this.handleStop(socket, payload);\n    });\n\n    socket.on(\"disconnect\", () => {\n      this.handleDisconnect(socket);\n    });\n  }\n\n  // ─── 事件处理 ───\n\n  private handleStart(socket: SocketLike, payload?: IflytekStartPayload) {\n    const sessionId =\n      payload?.sessionId ??\n      `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n\n    if (!this.appId || !this.apiKey || !this.apiSecret) {\n      socket.emit(\"iflytek:error\", {\n        sessionId,\n        message:\n          \"服务端未配置 IFLYTEK_APP_ID / IFLYTEK_API_KEY / IFLYTEK_API_SECRET\",\n      });\n      return;\n    }\n\n    const existing = this.sessions.get(socket.id);\n    if (existing) {\n      if (existing.ended) {\n        this.log(socket.id, \"replace ended session\");\n        this.closeUpstream(existing);\n        this.sessions.delete(socket.id);\n      } else if (existing.ws.readyState === WebSocket.OPEN) {\n        this.log(socket.id, \"duplicate start ignored (session open)\");\n        socket.emit(\"iflytek:ready\", { sessionId: existing.sessionId });\n        return;\n      } else if (existing.ws.readyState === WebSocket.CONNECTING) {\n        this.log(socket.id, \"duplicate start ignored (session connecting)\");\n        return;\n      } else {\n        this.sessions.delete(socket.id);\n      }\n    }\n\n    const wsUrl = this.buildWsUrl();\n    const ws = new WebSocket(wsUrl);\n    const state: SessionState = {\n      ws,\n      sessionId,\n      frameCount: 0,\n      firstFrameSent: false,\n      ended: false,\n      resultText: \"\",\n      resultSegments: [],\n    };\n    this.sessions.set(socket.id, state);\n    this.log(socket.id, \"start session\", { sessionId });\n\n    ws.on(\"open\", () => {\n      this.log(socket.id, \"upstream open\");\n      socket.emit(\"iflytek:ready\", { sessionId });\n    });\n\n    ws.on(\"message\", (raw) => {\n      try {\n        const msg = JSON.parse(String(raw));\n        this.log(socket.id, \"upstream message\", {\n          code: msg.code,\n          status: msg?.data?.status,\n        });\n        if (msg.code !== 0) {\n          socket.emit(\"iflytek:error\", {\n            sessionId,\n            message: msg.message || `讯飞返回错误 code=${msg.code}`,\n          });\n          return;\n        }\n\n        const current = this.sessions.get(socket.id);\n        if (!current || current.ws !== ws) return;\n\n        const result = this.extractResult(msg.data?.result);\n        const mergedText = this.mergeResult(current, result);\n        const isFinal = msg.data?.status === 2;\n        if (mergedText || isFinal) {\n          socket.emit(\"iflytek:result\", {\n            sessionId,\n            text: mergedText,\n            isFinal,\n          });\n        }\n\n        if (isFinal) {\n          const current = this.sessions.get(socket.id);\n          if (current?.ws === ws) {\n            this.closeUpstream(current);\n          }\n        }\n      } catch (e: any) {\n        socket.emit(\"iflytek:error\", { sessionId, message: e.message });\n      }\n    });\n\n    ws.on(\"error\", (e: any) => {\n      if (e?.message?.includes(\"before the connection was established\")) {\n        this.log(socket.id, \"ignore early-close error\");\n        return;\n      }\n      socket.emit(\"iflytek:error\", {\n        sessionId,\n        message: e?.message || \"讯飞 WebSocket 连接失败\",\n      });\n    });\n\n    ws.on(\"close\", () => {\n      this.log(socket.id, \"upstream close\");\n      const current = this.sessions.get(socket.id);\n      if (current?.ws === ws) {\n        this.sessions.delete(socket.id);\n      }\n    });\n  }\n\n  private handleAudio(socket: SocketLike, frame: IflytekAudioFrame) {\n    const state = this.sessions.get(socket.id);\n    if (!state || state.ws.readyState !== WebSocket.OPEN) return;\n\n    if (frame.sessionId && frame.sessionId !== state.sessionId) {\n      this.log(socket.id, \"ignore stale audio frame\");\n      return;\n    }\n    if (state.ended && frame.status === 2) {\n      this.log(socket.id, \"ignore duplicate final frame\");\n      return;\n    }\n    if (!state.firstFrameSent && frame.status === 2) {\n      this.log(socket.id, \"ignore lonely final frame\");\n      return;\n    }\n\n    const isFirst = !state.firstFrameSent && frame.status !== 2;\n    const status: 0 | 1 | 2 = isFirst ? 0 : frame.status;\n\n    state.frameCount += 1;\n    if (status === 0) state.firstFrameSent = true;\n    if (status === 2) state.ended = true;\n\n    this.log(socket.id, \"audio frame\", {\n      status,\n      hasAudio: Boolean(frame.audio),\n      len: frame.audio?.length ?? 0,\n      count: state.frameCount,\n    });\n\n    const payload: Record<string, unknown> = {\n      data: { status },\n    };\n\n    if (status === 0) {\n      payload.common = { app_id: this.appId };\n      payload.business = {\n        language: frame.language || \"zh_cn\",\n        domain: frame.domain || \"iat\",\n        accent: frame.accent || \"mandarin\",\n        vad_eos: 2000,\n      };\n      payload.data = {\n        status: 0,\n        format: \"audio/L16;rate=16000\",\n        encoding: \"raw\",\n        audio: frame.audio || \"\",\n      };\n    } else if (status === 1) {\n      payload.data = {\n        status: 1,\n        format: \"audio/L16;rate=16000\",\n        encoding: \"raw\",\n        audio: frame.audio || \"\",\n      };\n    } else {\n      payload.data = { status: 2 };\n    }\n\n    state.ws.send(JSON.stringify(payload));\n  }\n\n  private handleStop(socket: SocketLike, payload?: IflytekStopPayload) {\n    const state = this.sessions.get(socket.id);\n    if (\n      payload?.sessionId &&\n      state?.sessionId &&\n      payload.sessionId !== state.sessionId\n    ) {\n      this.log(socket.id, \"ignore stale stop signal\");\n      return;\n    }\n    this.log(socket.id, \"stop signal\");\n    if (state) {\n      this.closeUpstream(state);\n      this.sessions.delete(socket.id);\n    }\n  }\n\n  private handleDisconnect(socket: SocketLike) {\n    const state = this.sessions.get(socket.id);\n    if (state) {\n      this.closeUpstream(state);\n      this.sessions.delete(socket.id);\n    }\n  }\n\n  // ─── 工具方法 ───\n\n  private buildWsUrl(): string {\n    const date = new Date().toUTCString();\n    const requestLine = `GET ${this.path} HTTP/1.1`;\n    const signatureOrigin = `host: ${this.host}\\ndate: ${date}\\n${requestLine}`;\n    const signatureSha = crypto\n      .createHmac(\"sha256\", this.apiSecret)\n      .update(signatureOrigin)\n      .digest(\"base64\");\n    const authOrigin = `api_key=\"${this.apiKey}\", algorithm=\"hmac-sha256\", headers=\"host date request-line\", signature=\"${signatureSha}\"`;\n    const authorization = Buffer.from(authOrigin).toString(\"base64\");\n    const params = new URLSearchParams({ authorization, date, host: this.host });\n    return `wss://${this.host}${this.path}?${params.toString()}`;\n  }\n\n  private extractText(result: any): string {\n    const ws = result?.ws;\n    if (!Array.isArray(ws)) return \"\";\n    return ws\n      .map((item: any) => item?.cw?.[0]?.w ?? \"\")\n      .join(\"\")\n      .trim();\n  }\n\n  private extractResult(result: any): {\n    text: string;\n    pgs?: string;\n    rg?: [number, number];\n    sn?: number;\n  } {\n    const text = this.extractText(result);\n    const pgs =\n      typeof result?.pgs === \"string\" ? result.pgs : undefined;\n    const rgRaw = Array.isArray(result?.rg) ? result.rg : undefined;\n    const rg =\n      rgRaw && rgRaw.length === 2\n        ? ([Number(rgRaw[0]), Number(rgRaw[1])] as [number, number])\n        : undefined;\n    const sn =\n      typeof result?.sn === \"number\"\n        ? result.sn\n        : Number.isFinite(Number(result?.sn))\n          ? Number(result?.sn)\n          : undefined;\n    return { text, pgs, rg, sn };\n  }\n\n  private mergeResult(\n    state: SessionState,\n    result: { text: string; pgs?: string; rg?: [number, number]; sn?: number },\n  ): string {\n    const text = result.text?.trim() ?? \"\";\n    const segments = state.resultSegments;\n\n    if (typeof result.sn === \"number\") {\n      if (result.pgs === \"rpl\" && result.rg) {\n        const [start, end] = result.rg;\n        const before = segments.slice(0, start);\n        const after = segments.slice(end + 1);\n        state.resultSegments = [...before, text, ...after];\n      } else {\n        segments[result.sn] = text;\n        state.resultSegments = segments;\n      }\n    } else if (result.pgs === \"rpl\" && result.rg) {\n      const [start, end] = result.rg;\n      const before = segments.slice(0, start);\n      const after = segments.slice(end + 1);\n      state.resultSegments = [...before, text, ...after];\n    } else if (text) {\n      segments.push(text);\n      state.resultSegments = segments;\n    }\n\n    state.resultText = state.resultSegments.filter(Boolean).join(\"\");\n    return state.resultText;\n  }\n\n  private closeUpstream(state: SessionState) {\n    try {\n      state.ws.close();\n    } catch {}\n  }\n\n  private log(socketId: string, msg: string, extra?: Record<string, unknown>) {\n    if (!this.debug) return;\n    if (extra) {\n      console.log(`[sa2kit/iflytek][${socketId}] ${msg}`, extra);\n    } else {\n      console.log(`[sa2kit/iflytek][${socketId}] ${msg}`);\n    }\n  }\n}\n"]}