@anvia/server 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Indra Zulfi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,19 @@
+# @anvia/server
+
+Server-side stream helpers for Anvia applications.
+
+```ts
+import { createEventStream } from "@anvia/server";
+
+return createEventStream(agent.prompt("Draft a reply.").stream(), {
+  format: "jsonl",
+});
+```
+
+## Exports
+
+- `createEventStream(events, options)` returns a streaming `Response`.
+- `createJsonlStream(events, options)` returns a JSONL `ReadableStream<Uint8Array>`.
+- `createSseStream(events, options)` returns a Server-Sent Event `ReadableStream<Uint8Array>`.
+
+JSONL is the default transport format. Use `format: "sse"` when you need `text/event-stream` compatibility.

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+type EventStreamFormat = "jsonl" | "sse";
+type EventStreamErrorEvent = {
+    type: "error";
+    error: unknown;
+};
+type CreateEventStreamOptions<TEvent> = {
+    format?: EventStreamFormat;
+    headers?: HeadersInit;
+    status?: number;
+    statusText?: string;
+    jsonl?: JsonlStreamOptions<TEvent>;
+    sse?: SseStreamOptions<TEvent>;
+};
+type JsonlStreamOptions<TEvent> = {
+    serialize?: (event: TEvent | EventStreamErrorEvent) => string;
+};
+type SseStreamOptions<TEvent> = {
+    eventName?: string | ((event: TEvent | EventStreamErrorEvent) => string | undefined);
+    serialize?: (event: TEvent | EventStreamErrorEvent) => string;
+    retry?: number;
+};
+declare function createEventStream<TEvent>(events: AsyncIterable<TEvent>, options?: CreateEventStreamOptions<TEvent>): Response;
+declare function createJsonlStream<TEvent>(events: AsyncIterable<TEvent>, options?: JsonlStreamOptions<TEvent>): ReadableStream<Uint8Array>;
+declare function createSseStream<TEvent>(events: AsyncIterable<TEvent>, options?: SseStreamOptions<TEvent>): ReadableStream<Uint8Array>;
+
+export { type CreateEventStreamOptions, type EventStreamErrorEvent, type EventStreamFormat, type JsonlStreamOptions, type SseStreamOptions, createEventStream, createJsonlStream, createSseStream };

package/dist/index.js

@@ -0,0 +1,124 @@
+// src/index.ts
+function createEventStream(events, options = {}) {
+  const format = options.format ?? "jsonl";
+  const headers = new Headers(options.headers);
+  if (!headers.has("cache-control")) {
+    headers.set("cache-control", "no-cache, no-transform");
+  }
+  if (!headers.has("connection")) {
+    headers.set("connection", "keep-alive");
+  }
+  if (!headers.has("x-accel-buffering")) {
+    headers.set("x-accel-buffering", "no");
+  }
+  const body = format === "sse" ? createSseStream(events, options.sse) : createJsonlStream(events, options.jsonl);
+  if (!headers.has("content-type")) {
+    headers.set(
+      "content-type",
+      format === "sse" ? "text/event-stream; charset=utf-8" : "application/x-ndjson; charset=utf-8"
+    );
+  }
+  const responseInit = { headers };
+  if (options.status !== void 0) {
+    responseInit.status = options.status;
+  }
+  if (options.statusText !== void 0) {
+    responseInit.statusText = options.statusText;
+  }
+  return new Response(body, responseInit);
+}
+function createJsonlStream(events, options = {}) {
+  const encoder = new TextEncoder();
+  const iterator = events[Symbol.asyncIterator]();
+  const serialize = options.serialize ?? serializeJson;
+  return new ReadableStream({
+    async pull(controller) {
+      try {
+        const next = await iterator.next();
+        if (next.done === true) {
+          controller.close();
+          return;
+        }
+        controller.enqueue(encoder.encode(`${serialize(next.value)}
+`));
+      } catch (error) {
+        controller.enqueue(encoder.encode(`${serialize(errorEvent(error))}
+`));
+        controller.close();
+      }
+    },
+    async cancel() {
+      await iterator.return?.();
+    }
+  });
+}
+function createSseStream(events, options = {}) {
+  const encoder = new TextEncoder();
+  const iterator = events[Symbol.asyncIterator]();
+  const serialize = options.serialize ?? serializeJson;
+  return new ReadableStream({
+    start(controller) {
+      if (options.retry !== void 0) {
+        controller.enqueue(encoder.encode(`retry: ${options.retry}
+
+`));
+      }
+    },
+    async pull(controller) {
+      try {
+        const next = await iterator.next();
+        if (next.done === true) {
+          controller.close();
+          return;
+        }
+        controller.enqueue(
+          encoder.encode(formatSseEvent(next.value, serialize, options.eventName))
+        );
+      } catch (error) {
+        const event = errorEvent(error);
+        controller.enqueue(encoder.encode(formatSseEvent(event, serialize, options.eventName)));
+        controller.close();
+      }
+    },
+    async cancel() {
+      await iterator.return?.();
+    }
+  });
+}
+function formatSseEvent(event, serialize, eventName) {
+  const name = typeof eventName === "function" ? eventName(event) : eventName;
+  const lines = [];
+  if (name !== void 0 && name.length > 0) {
+    lines.push(`event: ${name}`);
+  }
+  for (const line of serialize(event).split(/\r?\n/)) {
+    lines.push(`data: ${line}`);
+  }
+  lines.push("", "");
+  return lines.join("\n");
+}
+function serializeJson(value) {
+  return JSON.stringify(value);
+}
+function errorEvent(error) {
+  return {
+    type: "error",
+    error: serializeError(error)
+  };
+}
+function serializeError(error) {
+  if (error instanceof Error) {
+    return {
+      name: error.name,
+      message: error.message,
+      stack: error.stack
+    };
+  }
+  return error;
+}
+export {
+  createEventStream,
+  createJsonlStream,
+  createSseStream
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type EventStreamFormat = \"jsonl\" | \"sse\";\n\nexport type EventStreamErrorEvent = {\n  type: \"error\";\n  error: unknown;\n};\n\nexport type CreateEventStreamOptions<TEvent> = {\n  format?: EventStreamFormat;\n  headers?: HeadersInit;\n  status?: number;\n  statusText?: string;\n  jsonl?: JsonlStreamOptions<TEvent>;\n  sse?: SseStreamOptions<TEvent>;\n};\n\nexport type JsonlStreamOptions<TEvent> = {\n  serialize?: (event: TEvent | EventStreamErrorEvent) => string;\n};\n\nexport type SseStreamOptions<TEvent> = {\n  eventName?: string | ((event: TEvent | EventStreamErrorEvent) => string | undefined);\n  serialize?: (event: TEvent | EventStreamErrorEvent) => string;\n  retry?: number;\n};\n\nexport function createEventStream<TEvent>(\n  events: AsyncIterable<TEvent>,\n  options: CreateEventStreamOptions<TEvent> = {},\n): Response {\n  const format = options.format ?? \"jsonl\";\n  const headers = new Headers(options.headers);\n\n  if (!headers.has(\"cache-control\")) {\n    headers.set(\"cache-control\", \"no-cache, no-transform\");\n  }\n  if (!headers.has(\"connection\")) {\n    headers.set(\"connection\", \"keep-alive\");\n  }\n  if (!headers.has(\"x-accel-buffering\")) {\n    headers.set(\"x-accel-buffering\", \"no\");\n  }\n\n  const body =\n    format === \"sse\"\n      ? createSseStream(events, options.sse)\n      : createJsonlStream(events, options.jsonl);\n\n  if (!headers.has(\"content-type\")) {\n    headers.set(\n      \"content-type\",\n      format === \"sse\" ? \"text/event-stream; charset=utf-8\" : \"application/x-ndjson; charset=utf-8\",\n    );\n  }\n\n  const responseInit: ResponseInit = { headers };\n  if (options.status !== undefined) {\n    responseInit.status = options.status;\n  }\n  if (options.statusText !== undefined) {\n    responseInit.statusText = options.statusText;\n  }\n\n  return new Response(body, responseInit);\n}\n\nexport function createJsonlStream<TEvent>(\n  events: AsyncIterable<TEvent>,\n  options: JsonlStreamOptions<TEvent> = {},\n): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder();\n  const iterator = events[Symbol.asyncIterator]();\n  const serialize = options.serialize ?? serializeJson;\n\n  return new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const next = await iterator.next();\n        if (next.done === true) {\n          controller.close();\n          return;\n        }\n\n        controller.enqueue(encoder.encode(`${serialize(next.value)}\\n`));\n      } catch (error) {\n        controller.enqueue(encoder.encode(`${serialize(errorEvent(error))}\\n`));\n        controller.close();\n      }\n    },\n    async cancel() {\n      await iterator.return?.();\n    },\n  });\n}\n\nexport function createSseStream<TEvent>(\n  events: AsyncIterable<TEvent>,\n  options: SseStreamOptions<TEvent> = {},\n): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder();\n  const iterator = events[Symbol.asyncIterator]();\n  const serialize = options.serialize ?? serializeJson;\n\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      if (options.retry !== undefined) {\n        controller.enqueue(encoder.encode(`retry: ${options.retry}\\n\\n`));\n      }\n    },\n    async pull(controller) {\n      try {\n        const next = await iterator.next();\n        if (next.done === true) {\n          controller.close();\n          return;\n        }\n\n        controller.enqueue(\n          encoder.encode(formatSseEvent(next.value, serialize, options.eventName)),\n        );\n      } catch (error) {\n        const event = errorEvent(error);\n        controller.enqueue(encoder.encode(formatSseEvent(event, serialize, options.eventName)));\n        controller.close();\n      }\n    },\n    async cancel() {\n      await iterator.return?.();\n    },\n  });\n}\n\nfunction formatSseEvent<TEvent>(\n  event: TEvent | EventStreamErrorEvent,\n  serialize: (event: TEvent | EventStreamErrorEvent) => string,\n  eventName: SseStreamOptions<TEvent>[\"eventName\"],\n): string {\n  const name = typeof eventName === \"function\" ? eventName(event) : eventName;\n  const lines: string[] = [];\n\n  if (name !== undefined && name.length > 0) {\n    lines.push(`event: ${name}`);\n  }\n\n  for (const line of serialize(event).split(/\\r?\\n/)) {\n    lines.push(`data: ${line}`);\n  }\n\n  lines.push(\"\", \"\");\n  return lines.join(\"\\n\");\n}\n\nfunction serializeJson(value: unknown): string {\n  return JSON.stringify(value);\n}\n\nfunction errorEvent(error: unknown): EventStreamErrorEvent {\n  return {\n    type: \"error\",\n    error: serializeError(error),\n  };\n}\n\nfunction serializeError(error: unknown): unknown {\n  if (error instanceof Error) {\n    return {\n      name: error.name,\n      message: error.message,\n      stack: error.stack,\n    };\n  }\n\n  return error;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@anvia/server",
+  "version": "0.2.0",
+  "description": "Server-side event stream helpers for Anvia applications.",
+  "author": "anvia",
+  "maintainer": "Indra Zulfi",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anvia-hq/anvia",
+    "directory": "packages/server"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.9.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.8"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --sourcemap --clean",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}