@cairnvibe/indexer 0.2.6 → 0.2.7

package/dist/init.js

@@ -35,6 +35,20 @@ function writeIfAbsent(filePath, content, result) {
     node_fs_1.default.writeFileSync(filePath, content);
     result.filesWritten.push(filePath);
 }
+// Found live: if your Next.js config transpiles @cairnvibe/sdk (needed when
+// importing the client widget straight from source rather than a compiled
+// dist), webpack bundling the `ws` package used by the speak/transcribe/
+// realtime routes silently breaks its Deepgram WebSocket connections — every
+// request hung for ~10s then failed with ECONNRESET, even though the exact
+// same code worked outside Next's dev bundler. Marking `ws` as a server
+// external package (next.config.js) fixes it.
+const WS_TRANSPILE_WARNING = [
+    "   If your next.config.js sets transpilePackages for @cairnvibe/sdk, also",
+    '   add "ws" to serverExternalPackages (Next 15) or',
+    '   experimental.serverComponentsExternalPackages (Next 14) — webpack-',
+    "   bundling ws otherwise silently breaks the Deepgram speak/transcribe",
+    "   connections it uses.",
+];
 function runInit(dir, options = {}) {
     const absDir = node_path_1.default.resolve(dir);
     const pkgPath = node_path_1.default.join(absDir, "package.json");
@@ -66,6 +80,8 @@ function runInit(dir, options = {}) {
             widgetProps.push('speakEndpoint="/api/copilot/speak"', 'transcribeEndpoint="/api/copilot/transcribe"');
         }
         result.nextSteps.push("1. cp .env.example .env and fill in your key(s).", "2. Add the widget to app/layout.tsx:", '   import { Copilot } from "@cairnvibe/sdk";', `   <Copilot ${widgetProps.join(" ")} />`, "3. npx cairn build .   (scans this Next.js app's source)", "4. npm run dev, then ask it a question.");
+        if (options.voice)
+            result.nextSteps.push(...WS_TRANSPILE_WARNING);
     }
     else if (result.framework === "next-pages-router") {
         writeIfAbsent(node_path_1.default.join(absDir, "pages", "api", "copilot.ts"), NEXT_PAGES_API_ROUTE, result);
@@ -76,6 +92,8 @@ function runInit(dir, options = {}) {
             widgetProps.push('speakEndpoint="/api/copilot/speak"', 'transcribeEndpoint="/api/copilot/transcribe"');
         }
         result.nextSteps.push("1. cp .env.example .env and fill in your key(s).", "2. Add the widget to pages/_app.tsx:", '   import { Copilot } from "@cairnvibe/sdk";', `   <Copilot ${widgetProps.join(" ")} />`, "3. npx cairn build .   (scans this Next.js app's source)", "4. npm run dev, then ask it a question.");
+        if (options.voice)
+            result.nextSteps.push(...WS_TRANSPILE_WARNING);
     }
     else {
         writeIfAbsent(node_path_1.default.join(absDir, "cairn-server.cjs"), STANDALONE_SERVER, result);
@@ -151,7 +169,7 @@ export async function POST(request: Request) {
   if ("error" in result.body) {
     return Response.json(result.body, { status: result.status });
   }
-  return new Response(result.body.audio, {
+  return new Response(result.body.stream, {
     status: result.status,
     headers: { "content-type": result.body.contentType },
   });
@@ -170,6 +188,7 @@ export async function POST(request: Request) {
 }
 `;
 const NEXT_PAGES_SPEAK_ROUTE = `import type { NextApiRequest, NextApiResponse } from "next";
+import { Readable } from "node:stream";
 import { createSpeakHandler } from "@cairnvibe/sdk/speak-server";
 
 const handler = createSpeakHandler({ apiKey: process.env.DEEPGRAM_API_KEY ?? "" });
@@ -180,7 +199,8 @@ export default async function speak(req: NextApiRequest, res: NextApiResponse) {
   if ("error" in result.body) {
     return res.status(result.status).json(result.body);
   }
-  res.status(result.status).setHeader("content-type", result.body.contentType).send(Buffer.from(result.body.audio));
+  res.status(result.status).setHeader("content-type", result.body.contentType);
+  Readable.fromWeb(result.body.stream).pipe(res);
 }
 `;
 const NEXT_PAGES_TRANSCRIBE_ROUTE = `import type { NextApiRequest, NextApiResponse } from "next";
@@ -241,11 +261,13 @@ app.post("/api/copilot", async (req, res) => {
 
 if (process.env.DEEPGRAM_API_KEY) {
   const { createSpeakHandler } = require("@cairnvibe/sdk/speak-server");
+  const { Readable } = require("node:stream");
   const speak = createSpeakHandler({ apiKey: process.env.DEEPGRAM_API_KEY });
   app.post("/api/copilot/speak", async (req, res) => {
     const result = await speak(req.body?.text ?? "");
     if ("error" in result.body) return res.status(result.status).json(result.body);
-    res.status(result.status).type(result.body.contentType).send(Buffer.from(result.body.audio));
+    res.status(result.status).type(result.body.contentType);
+    Readable.fromWeb(result.body.stream).pipe(res);
   });
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cairnvibe/indexer",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Cairn's analyzer and installer (the `cairn` CLI) — scans Next.js source or crawls any running app, and scaffolds the backend either way.",
   "license": "MIT",
   "publishConfig": { "access": "public" },