@usewind/node 0.1.0 → 0.1.2

package/DESIGN.md

@@ -270,7 +270,7 @@ const event = wind.verify(req)   // throws WindSignatureError on mismatch
 ```
 
 - HMAC-SHA256 over the raw body with `webhookSecret`, constant-time compare,
-  `X-Wind-Signature: t=<unix>,v1=<hex>` header, 5-minute timestamp tolerance
+  `Wind-Signature: t=<unix>,v1=<hex>` header, 5-minute timestamp tolerance
   (replay guard). Requires the raw (unparsed) body — documented loudly.
 
 ### Escape hatch

package/README.md

@@ -44,7 +44,7 @@ const res = await wind.connection(userId).model('gpt-4o').chat({
 const res2 = await wind.connection(userId).feature('chat').chat({ messages })
 
 // 3. webhooks
-const event = wind.verify({ payload: rawBody, signature: req.headers['x-wind-signature'] })
+const event = wind.verify({ payload: rawBody, signature: req.headers['wind-signature'] })
 ```
 
 Credentials come from `wind.configure({ … })` or the env vars `WIND_CLIENT_ID`,

package/dist/index.cjs

@@ -236,6 +236,9 @@ var RawClient = class {
       signal: req.signal
     });
     const requestId = res.headers.get("x-request-id");
+    if (req.stream && res.ok && res.body && (res.headers.get("content-type") ?? "").includes("text/event-stream")) {
+      return { status: res.status, headers: res.headers, body: res.body, requestId };
+    }
     let parsed = void 0;
     const text = await res.text();
     if (text) {
@@ -290,7 +293,8 @@ var RawClient = class {
       bearer: args.accessToken,
       headers,
       body: args.body,
-      signal: args.signal
+      signal: args.signal,
+      stream: isStreamBody(args.body)
     });
   }
   /** `POST /v1/ai/features/{slug}`. */
@@ -301,7 +305,8 @@ var RawClient = class {
       bearer: args.accessToken,
       headers: { "Idempotency-Key": args.idempotencyKey },
       body: args.body,
-      signal: args.signal
+      signal: args.signal,
+      stream: isStreamBody(args.body)
     });
   }
   // ── Management (client-credentials) ────────────────────────────────────────
@@ -364,6 +369,9 @@ var RawClient = class {
     return this.request({ method: "POST", path, ...init });
   }
 };
+function isStreamBody(body) {
+  return typeof body === "object" && body !== null && body.stream === true;
+}
 
 // src/tokens.ts
 var ACCESS_TOKEN_SKEW_MS = 6e4;
@@ -622,6 +630,9 @@ function requestBody(params) {
     messages: params.messages,
     ...params.max_tokens !== void 0 && { max_tokens: params.max_tokens },
     ...params.temperature !== void 0 && { temperature: params.temperature },
+    ...params.tools !== void 0 && { tools: params.tools },
+    ...params.tool_choice !== void 0 && { tool_choice: params.tool_choice },
+    ...params.parallel_tool_calls !== void 0 && { parallel_tool_calls: params.parallel_tool_calls },
     ...params.stream !== void 0 && { stream: params.stream }
   };
 }
@@ -668,13 +679,60 @@ async function* billedStream(ctx, userId, params, call) {
   if (res.status < 200 || res.status >= 300) {
     throw WindError.fromResponse(res.status, res.body, { requestId: res.requestId });
   }
-  const contentType = res.headers.get("content-type") ?? "";
-  if (!contentType.includes("text/event-stream")) {
+  if (!(res.body instanceof ReadableStream)) {
     const result = res.body;
-    yield { delta: result, wind: result.wind };
+    yield { delta: result, wind: result.wind ?? null, usage: result.usage, settlement: "settled", idempotencyKey };
     return;
   }
-  yield { delta: res.body, wind: null };
+  for await (const event of sseEvents(res.body)) {
+    if (event === "[DONE]") return;
+    let data;
+    try {
+      data = JSON.parse(event);
+    } catch {
+      continue;
+    }
+    if (data?.wind_final) {
+      yield finalChunk(data.wind_final, idempotencyKey);
+    } else if (data?.error) {
+      const err = data.error.error ?? data.error;
+      const status = err.code === "provider_error" ? 502 : 403;
+      throw WindError.fromResponse(status, { error: err }, { requestId: res.requestId });
+    } else if (data?.streamed) {
+      yield finalChunk(data, idempotencyKey);
+    } else {
+      yield { delta: data, wind: null };
+    }
+  }
+}
+async function* sseEvents(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        if (line.startsWith("data:")) yield line.slice(5).trim();
+      }
+    }
+    if (buffer.startsWith("data:")) yield buffer.slice(5).trim();
+  } finally {
+    reader.releaseLock();
+  }
+}
+function finalChunk(final, idempotencyKey) {
+  return {
+    delta: null,
+    wind: final.wind ?? null,
+    usage: final.usage ?? void 0,
+    settlement: final.settlement ?? "settled",
+    idempotencyKey
+  };
 }
 var TOLERANCE_S = 300;
 var WebhookVerifier = class {
@@ -997,7 +1055,7 @@ var Wind = class {
     update: (appId, slug, patch) => this.raw.updateFeature(appId, slug, patch)
   };
   // ── webhooks ─────────────────────────────────────────────────────────────
-  /** Verify a webhook's `X-Wind-Signature` and return the typed event. Needs the raw body. */
+  /** Verify a webhook's `Wind-Signature` and return the typed event. Needs the raw body. */
   verify(input) {
     return this.#verifier.verify(input);
   }