llm-stream-assemble 1.0.0

package/dist/types-CskRfrmD.d.ts

@@ -0,0 +1,176 @@
+type FinishReason = "stop" | "tool_calls" | "length" | "content_filter" | "error" | "incomplete" | "aborted";
+type ReasoningVariant = "summary" | "detail";
+type StreamEvent = {
+    type: "message.start";
+    id?: string;
+    choiceIndex?: number;
+} | {
+    type: "metadata";
+    model?: string;
+    responseId?: string;
+    created?: number;
+    raw?: unknown;
+} | {
+    type: "text.delta";
+    text: string;
+    choiceIndex?: number;
+} | {
+    type: "text.done";
+    text: string;
+    choiceIndex?: number;
+} | {
+    type: "reasoning.delta";
+    text: string;
+    variant?: ReasoningVariant;
+} | {
+    type: "reasoning.done";
+    text: string;
+    variant?: ReasoningVariant;
+} | {
+    type: "refusal.delta";
+    text: string;
+} | {
+    type: "refusal.done";
+    text: string;
+} | {
+    type: "json.delta";
+    delta: string;
+    partial?: unknown;
+} | {
+    type: "json.done";
+    value: unknown;
+} | {
+    type: "tool_call.start";
+    id: string;
+    name: string;
+    index?: number;
+    choiceIndex?: number;
+} | {
+    type: "tool_call.args.delta";
+    id: string;
+    delta: string;
+    partial?: unknown;
+} | {
+    type: "tool_call.done";
+    id: string;
+    name: string;
+    args: unknown;
+} | {
+    type: "usage";
+    inputTokens?: number;
+    outputTokens?: number;
+    reasoningTokens?: number;
+    raw?: unknown;
+} | {
+    type: "finish";
+    reason: FinishReason;
+    choiceIndex?: number;
+} | {
+    type: "error";
+    error: Error;
+    recoverable?: boolean;
+    sanitized?: string;
+};
+interface StreamAdapter {
+    parseChunk(raw: string): RawChunk[];
+    parseResponse?(body: unknown): RawChunk[];
+}
+/** Internal representation between adapter output and assembler. */
+type RawChunk = {
+    kind: "message-start";
+    id?: string;
+    choiceIndex?: number;
+} | {
+    kind: "text-delta";
+    text: string;
+    choiceIndex?: number;
+} | {
+    kind: "reasoning-delta";
+    text: string;
+    variant?: ReasoningVariant;
+} | {
+    kind: "refusal-delta";
+    text: string;
+} | {
+    kind: "json-delta";
+    delta: string;
+} | {
+    kind: "tool-start";
+    id?: string;
+    name: string;
+    index?: number;
+    choiceIndex?: number;
+} | {
+    kind: "tool-args-delta";
+    id?: string;
+    delta: string;
+    index?: number;
+    choiceIndex?: number;
+} | {
+    kind: "tool-done";
+    id?: string;
+    index?: number;
+    choiceIndex?: number;
+} | {
+    kind: "metadata";
+    model?: string;
+    responseId?: string;
+    created?: number;
+    raw?: unknown;
+} | {
+    kind: "usage";
+    inputTokens?: number;
+    outputTokens?: number;
+    reasoningTokens?: number;
+    raw?: unknown;
+} | {
+    kind: "finish";
+    reason: FinishReason;
+    choiceIndex?: number;
+} | {
+    kind: "provider-error";
+    error: unknown;
+    recoverable?: boolean;
+};
+interface AssembleOptions {
+    recoverMalformed?: boolean;
+    signal?: AbortSignal;
+    sanitizeErrors?: boolean;
+    strictToolArgs?: boolean;
+    maxBufferBytes?: number;
+}
+interface PartialJSONResult {
+    value?: unknown;
+    complete: boolean;
+}
+interface CollectedStream {
+    text: string;
+    reasoning: string;
+    refusals: string;
+    json: unknown;
+    toolCalls: Array<{
+        id: string;
+        name: string;
+        args: unknown;
+    }>;
+    usage?: Extract<StreamEvent, {
+        type: "usage";
+    }>;
+    finishReason?: Extract<StreamEvent, {
+        type: "finish";
+    }>;
+}
+interface ToSSEOptions {
+    sanitizeErrors?: boolean;
+}
+interface AssembleFromFileOptions extends AssembleOptions {
+    format?: "sse" | "json";
+}
+type StreamEventType = StreamEvent["type"];
+type StreamEventHandlers<R> = Partial<{
+    [K in StreamEventType]: (event: Extract<StreamEvent, {
+        type: K;
+    }>) => R;
+}>;
+
+export type { AssembleFromFileOptions as A, CollectedStream as C, FinishReason as F, PartialJSONResult as P, RawChunk as R, StreamAdapter as S, ToSSEOptions as T, AssembleOptions as a, ReasoningVariant as b, StreamEvent as c, StreamEventHandlers as d, StreamEventType as e };

package/package.json

@@ -0,0 +1,95 @@
+{
+	"name": "llm-stream-assemble",
+	"version": "1.0.0",
+	"description": "A zero-dependency TypeScript layer for assembling OpenAI, Anthropic, and compatible LLM streams into unified events for text, tool calls, reasoning, JSON, usage, errors, and non-streaming responses.",
+	"license": "MIT",
+	"author": "Ladislav Kostolny <01laky@gmail.com>",
+	"type": "module",
+	"sideEffects": false,
+	"engines": {
+		"node": ">=18"
+	},
+	"files": [
+		"dist",
+		"LICENSE",
+		"README.md"
+	],
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		},
+		"./core": {
+			"types": "./dist/core/index.d.ts",
+			"import": "./dist/core/index.js",
+			"require": "./dist/core/index.cjs"
+		},
+		"./adapters/openai-chat": {
+			"types": "./dist/adapters/openai-chat.d.ts",
+			"import": "./dist/adapters/openai-chat.js",
+			"require": "./dist/adapters/openai-chat.cjs"
+		},
+		"./adapters/openai-compatible": {
+			"types": "./dist/adapters/openai-compatible.d.ts",
+			"import": "./dist/adapters/openai-compatible.js",
+			"require": "./dist/adapters/openai-compatible.cjs"
+		},
+		"./adapters/anthropic": {
+			"types": "./dist/adapters/anthropic.d.ts",
+			"import": "./dist/adapters/anthropic.js",
+			"require": "./dist/adapters/anthropic.cjs"
+		},
+		"./adapters/openai-responses": {
+			"types": "./dist/adapters/openai-responses.d.ts",
+			"import": "./dist/adapters/openai-responses.js",
+			"require": "./dist/adapters/openai-responses.cjs"
+		}
+	},
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch",
+		"typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.test.json",
+		"lint": "eslint .",
+		"lint:fix": "eslint . --fix",
+		"format": "prettier --check .",
+		"format:fix": "prettier --write .",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"verify": "pnpm verify:deps && pnpm lint && pnpm typecheck && pnpm build && pnpm test && pnpm smoke:package",
+		"verify:deps": "node scripts/verify-zero-deps.mjs",
+		"smoke:package": "node scripts/smoke-package.mjs"
+	},
+	"keywords": [
+		"llm",
+		"streaming",
+		"sse",
+		"openai",
+		"anthropic",
+		"tool-calling",
+		"server-sent-events"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/01laky/llm-stream-assemble.git"
+	},
+	"bugs": {
+		"url": "https://github.com/01laky/llm-stream-assemble/issues"
+	},
+	"homepage": "https://github.com/01laky/llm-stream-assemble#readme",
+	"packageManager": "pnpm@9.15.9",
+	"devDependencies": {
+		"@eslint/js": "^9.28.0",
+		"@types/node": "^22.15.29",
+		"@vitest/coverage-v8": "^3.2.1",
+		"eslint": "^9.28.0",
+		"prettier": "^3.5.3",
+		"tsup": "^8.5.0",
+		"typescript": "^5.8.3",
+		"typescript-eslint": "^8.33.0",
+		"vitest": "^3.2.1"
+	}
+}