@omnicross/core 0.1.0

package/dist/sse-parser.d.cts

@@ -0,0 +1,143 @@
+import { MessageBlock } from '@omnicross/contracts/message-blocks';
+import { SimpleChatAudio, SimpleChatVideo } from '@omnicross/contracts/completion-types';
+
+/**
+ * SSE Parser Utility
+ *
+ * Reusable Server-Sent Events parser for streaming API responses.
+ * Supports OpenAI and Anthropic SSE formats with proper buffer handling.
+ *
+ * @module sse-parser
+ */
+
+/**
+ * SSE event data after parsing
+ */
+interface SSEEvent {
+    /** Raw event type (e.g., 'message', 'content_block_delta') */
+    type?: string;
+    /** Parsed JSON data */
+    data: unknown;
+    /** Raw data string */
+    raw: string;
+}
+/**
+ * Callbacks for SSE stream processing
+ */
+interface SSEParserCallbacks {
+    /** Called when text content delta is received */
+    onDelta?: (content: string) => void;
+    /** Called when reasoning/thinking content is received */
+    onReasoning?: (reasoning: string) => void;
+    /** Called when usage statistics are received */
+    onUsage?: (usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    }) => void;
+    /** Called when stream ends normally */
+    onDone?: () => void;
+    /** Called when an error occurs */
+    onError?: (error: string) => void;
+    /** Called for each raw SSE event (for debugging) */
+    onRawEvent?: (event: SSEEvent) => void;
+    /** Called when a structured content block is detected (e.g., Anthropic server_tool_use) */
+    onBlock?: (block: MessageBlock) => void;
+    /** Called when audio content is received (e.g., OpenAI TTS) */
+    onAudio?: (audio: SimpleChatAudio) => void;
+    /** Called when video content is received */
+    onVideo?: (video: SimpleChatVideo) => void;
+}
+/**
+ * SSE parser format
+ */
+type SSEFormat = 'openai' | 'anthropic' | 'gemini' | 'openai-response';
+/**
+ * Create a reusable SSE parser for streaming API responses.
+ *
+ * Usage:
+ * ```typescript
+ * const parser = createSSEParser('openai', {
+ *   onDelta: (content) => console.log('Content:', content),
+ *   onDone: () => console.log('Stream complete')
+ * });
+ *
+ * // Feed chunks as they arrive
+ * for await (const chunk of reader) {
+ *   parser.push(chunk);
+ * }
+ *
+ * // Get accumulated results
+ * const { content, reasoning, usage } = parser.getResult();
+ * ```
+ *
+ * @param format - SSE format ('openai' or 'anthropic')
+ * @param callbacks - Event callbacks
+ * @returns Parser instance with push(), flush(), and getResult() methods
+ */
+declare function createSSEParser(format: SSEFormat, callbacks: SSEParserCallbacks): {
+    /**
+     * Push a chunk of data to the parser
+     * @param chunk - Raw SSE chunk from response stream
+     */
+    push(chunk: string): void;
+    /**
+     * Flush any remaining data in the buffer
+     */
+    flush(): void;
+    /**
+     * Get accumulated results
+     */
+    getResult(): {
+        content: string;
+        reasoning: string;
+        usage?: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+        } | undefined;
+        metrics?: {
+            completionTokens: number;
+            timeCompletionMs: number;
+            timeFirstTokenMs?: number;
+        };
+        blocks: MessageBlock[];
+        audios: SimpleChatAudio[];
+        videos: SimpleChatVideo[];
+    };
+    /**
+     * Check if stream is complete
+     */
+    isDone(): boolean;
+    /**
+     * Reset parser state for reuse
+     */
+    reset(): void;
+};
+/**
+ * Helper function to stream and parse SSE response
+ *
+ * @param response - Fetch response with SSE body
+ * @param format - SSE format
+ * @param callbacks - Event callbacks
+ * @returns Promise that resolves when stream is complete
+ */
+declare function streamSSEResponse(response: Response, format: SSEFormat, callbacks: SSEParserCallbacks): Promise<{
+    content: string;
+    reasoning: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    metrics?: {
+        completionTokens: number;
+        timeCompletionMs: number;
+        timeFirstTokenMs?: number;
+    };
+    blocks: MessageBlock[];
+    audios: SimpleChatAudio[];
+    videos: SimpleChatVideo[];
+}>;
+
+export { type SSEEvent, type SSEFormat, type SSEParserCallbacks, createSSEParser, streamSSEResponse };

package/dist/sse-parser.d.ts

@@ -0,0 +1,143 @@
+import { MessageBlock } from '@omnicross/contracts/message-blocks';
+import { SimpleChatAudio, SimpleChatVideo } from '@omnicross/contracts/completion-types';
+
+/**
+ * SSE Parser Utility
+ *
+ * Reusable Server-Sent Events parser for streaming API responses.
+ * Supports OpenAI and Anthropic SSE formats with proper buffer handling.
+ *
+ * @module sse-parser
+ */
+
+/**
+ * SSE event data after parsing
+ */
+interface SSEEvent {
+    /** Raw event type (e.g., 'message', 'content_block_delta') */
+    type?: string;
+    /** Parsed JSON data */
+    data: unknown;
+    /** Raw data string */
+    raw: string;
+}
+/**
+ * Callbacks for SSE stream processing
+ */
+interface SSEParserCallbacks {
+    /** Called when text content delta is received */
+    onDelta?: (content: string) => void;
+    /** Called when reasoning/thinking content is received */
+    onReasoning?: (reasoning: string) => void;
+    /** Called when usage statistics are received */
+    onUsage?: (usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    }) => void;
+    /** Called when stream ends normally */
+    onDone?: () => void;
+    /** Called when an error occurs */
+    onError?: (error: string) => void;
+    /** Called for each raw SSE event (for debugging) */
+    onRawEvent?: (event: SSEEvent) => void;
+    /** Called when a structured content block is detected (e.g., Anthropic server_tool_use) */
+    onBlock?: (block: MessageBlock) => void;
+    /** Called when audio content is received (e.g., OpenAI TTS) */
+    onAudio?: (audio: SimpleChatAudio) => void;
+    /** Called when video content is received */
+    onVideo?: (video: SimpleChatVideo) => void;
+}
+/**
+ * SSE parser format
+ */
+type SSEFormat = 'openai' | 'anthropic' | 'gemini' | 'openai-response';
+/**
+ * Create a reusable SSE parser for streaming API responses.
+ *
+ * Usage:
+ * ```typescript
+ * const parser = createSSEParser('openai', {
+ *   onDelta: (content) => console.log('Content:', content),
+ *   onDone: () => console.log('Stream complete')
+ * });
+ *
+ * // Feed chunks as they arrive
+ * for await (const chunk of reader) {
+ *   parser.push(chunk);
+ * }
+ *
+ * // Get accumulated results
+ * const { content, reasoning, usage } = parser.getResult();
+ * ```
+ *
+ * @param format - SSE format ('openai' or 'anthropic')
+ * @param callbacks - Event callbacks
+ * @returns Parser instance with push(), flush(), and getResult() methods
+ */
+declare function createSSEParser(format: SSEFormat, callbacks: SSEParserCallbacks): {
+    /**
+     * Push a chunk of data to the parser
+     * @param chunk - Raw SSE chunk from response stream
+     */
+    push(chunk: string): void;
+    /**
+     * Flush any remaining data in the buffer
+     */
+    flush(): void;
+    /**
+     * Get accumulated results
+     */
+    getResult(): {
+        content: string;
+        reasoning: string;
+        usage?: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+        } | undefined;
+        metrics?: {
+            completionTokens: number;
+            timeCompletionMs: number;
+            timeFirstTokenMs?: number;
+        };
+        blocks: MessageBlock[];
+        audios: SimpleChatAudio[];
+        videos: SimpleChatVideo[];
+    };
+    /**
+     * Check if stream is complete
+     */
+    isDone(): boolean;
+    /**
+     * Reset parser state for reuse
+     */
+    reset(): void;
+};
+/**
+ * Helper function to stream and parse SSE response
+ *
+ * @param response - Fetch response with SSE body
+ * @param format - SSE format
+ * @param callbacks - Event callbacks
+ * @returns Promise that resolves when stream is complete
+ */
+declare function streamSSEResponse(response: Response, format: SSEFormat, callbacks: SSEParserCallbacks): Promise<{
+    content: string;
+    reasoning: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    metrics?: {
+        completionTokens: number;
+        timeCompletionMs: number;
+        timeFirstTokenMs?: number;
+    };
+    blocks: MessageBlock[];
+    audios: SimpleChatAudio[];
+    videos: SimpleChatVideo[];
+}>;
+
+export { type SSEEvent, type SSEFormat, type SSEParserCallbacks, createSSEParser, streamSSEResponse };