@langchain/langgraph-sdk 0.0.38 → 0.0.40

package/dist/utils/eventsource-parser/parse.cjs

@@ -1,150 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createParser = void 0;
-/**
- * Creates a new EventSource parser.
- *
- * @param onParse - Callback to invoke when a new event is parsed, or a new reconnection interval
- *                  has been sent from the server
- *
- * @returns A new EventSource parser, with `parse` and `reset` methods.
- * @public
- */
-function createParser(onParse) {
-    // Processing state
-    let isFirstChunk;
-    let buffer;
-    let startingPosition;
-    let startingFieldLength;
-    // Event state
-    let eventId;
-    let eventName;
-    let data;
-    reset();
-    return { feed, reset };
-    function reset() {
-        isFirstChunk = true;
-        buffer = "";
-        startingPosition = 0;
-        startingFieldLength = -1;
-        eventId = undefined;
-        eventName = undefined;
-        data = "";
-    }
-    function feed(chunk) {
-        buffer = buffer ? buffer + chunk : chunk;
-        // Strip any UTF8 byte order mark (BOM) at the start of the stream.
-        // Note that we do not strip any non - UTF8 BOM, as eventsource streams are
-        // always decoded as UTF8 as per the specification.
-        if (isFirstChunk && hasBom(buffer)) {
-            buffer = buffer.slice(BOM.length);
-        }
-        isFirstChunk = false;
-        // Set up chunk-specific processing state
-        const length = buffer.length;
-        let position = 0;
-        let discardTrailingNewline = false;
-        // Read the current buffer byte by byte
-        while (position < length) {
-            // EventSource allows for carriage return + line feed, which means we
-            // need to ignore a linefeed character if the previous character was a
-            // carriage return
-            // @todo refactor to reduce nesting, consider checking previous byte?
-            // @todo but consider multiple chunks etc
-            if (discardTrailingNewline) {
-                if (buffer[position] === "\n") {
-                    ++position;
-                }
-                discardTrailingNewline = false;
-            }
-            let lineLength = -1;
-            let fieldLength = startingFieldLength;
-            let character;
-            for (let index = startingPosition; lineLength < 0 && index < length; ++index) {
-                character = buffer[index];
-                if (character === ":" && fieldLength < 0) {
-                    fieldLength = index - position;
-                }
-                else if (character === "\r") {
-                    discardTrailingNewline = true;
-                    lineLength = index - position;
-                }
-                else if (character === "\n") {
-                    lineLength = index - position;
-                }
-            }
-            if (lineLength < 0) {
-                startingPosition = length - position;
-                startingFieldLength = fieldLength;
-                break;
-            }
-            else {
-                startingPosition = 0;
-                startingFieldLength = -1;
-            }
-            parseEventStreamLine(buffer, position, fieldLength, lineLength);
-            position += lineLength + 1;
-        }
-        if (position === length) {
-            // If we consumed the entire buffer to read the event, reset the buffer
-            buffer = "";
-        }
-        else if (position > 0) {
-            // If there are bytes left to process, set the buffer to the unprocessed
-            // portion of the buffer only
-            buffer = buffer.slice(position);
-        }
-    }
-    function parseEventStreamLine(lineBuffer, index, fieldLength, lineLength) {
-        if (lineLength === 0) {
-            // We reached the last line of this event
-            if (data.length > 0) {
-                onParse({
-                    type: "event",
-                    id: eventId,
-                    event: eventName || undefined,
-                    data: data.slice(0, -1), // remove trailing newline
-                });
-                data = "";
-                eventId = undefined;
-            }
-            eventName = undefined;
-            return;
-        }
-        const noValue = fieldLength < 0;
-        const field = lineBuffer.slice(index, index + (noValue ? lineLength : fieldLength));
-        let step = 0;
-        if (noValue) {
-            step = lineLength;
-        }
-        else if (lineBuffer[index + fieldLength + 1] === " ") {
-            step = fieldLength + 2;
-        }
-        else {
-            step = fieldLength + 1;
-        }
-        const position = index + step;
-        const valueLength = lineLength - step;
-        const value = lineBuffer.slice(position, position + valueLength).toString();
-        if (field === "data") {
-            data += value ? `${value}\n` : "\n";
-        }
-        else if (field === "event") {
-            eventName = value;
-        }
-        else if (field === "id" && !value.includes("\u0000")) {
-            eventId = value;
-        }
-        else if (field === "retry") {
-            const retry = parseInt(value, 10);
-            if (!Number.isNaN(retry)) {
-                onParse({ type: "reconnect-interval", value: retry });
-            }
-        }
-    }
-}
-exports.createParser = createParser;
-const BOM = [239, 187, 191];
-function hasBom(buffer) {
-    return BOM.every((charCode, index) => buffer.charCodeAt(index) === charCode);
-}

package/dist/utils/eventsource-parser/parse.d.ts

@@ -1,18 +0,0 @@
-/**
- * EventSource/Server-Sent Events parser
- * @see https://html.spec.whatwg.org/multipage/server-sent-events.html
- *
- * Based on code from the {@link https://github.com/EventSource/eventsource | EventSource module},
- * which is licensed under the MIT license. And copyrighted the EventSource GitHub organisation.
- */
-import type { EventSourceParseCallback, EventSourceParser } from "./types.js";
-/**
- * Creates a new EventSource parser.
- *
- * @param onParse - Callback to invoke when a new event is parsed, or a new reconnection interval
- *                  has been sent from the server
- *
- * @returns A new EventSource parser, with `parse` and `reset` methods.
- * @public
- */
-export declare function createParser(onParse: EventSourceParseCallback): EventSourceParser;

package/dist/utils/eventsource-parser/parse.js

@@ -1,146 +0,0 @@
-/**
- * Creates a new EventSource parser.
- *
- * @param onParse - Callback to invoke when a new event is parsed, or a new reconnection interval
- *                  has been sent from the server
- *
- * @returns A new EventSource parser, with `parse` and `reset` methods.
- * @public
- */
-export function createParser(onParse) {
-    // Processing state
-    let isFirstChunk;
-    let buffer;
-    let startingPosition;
-    let startingFieldLength;
-    // Event state
-    let eventId;
-    let eventName;
-    let data;
-    reset();
-    return { feed, reset };
-    function reset() {
-        isFirstChunk = true;
-        buffer = "";
-        startingPosition = 0;
-        startingFieldLength = -1;
-        eventId = undefined;
-        eventName = undefined;
-        data = "";
-    }
-    function feed(chunk) {
-        buffer = buffer ? buffer + chunk : chunk;
-        // Strip any UTF8 byte order mark (BOM) at the start of the stream.
-        // Note that we do not strip any non - UTF8 BOM, as eventsource streams are
-        // always decoded as UTF8 as per the specification.
-        if (isFirstChunk && hasBom(buffer)) {
-            buffer = buffer.slice(BOM.length);
-        }
-        isFirstChunk = false;
-        // Set up chunk-specific processing state
-        const length = buffer.length;
-        let position = 0;
-        let discardTrailingNewline = false;
-        // Read the current buffer byte by byte
-        while (position < length) {
-            // EventSource allows for carriage return + line feed, which means we
-            // need to ignore a linefeed character if the previous character was a
-            // carriage return
-            // @todo refactor to reduce nesting, consider checking previous byte?
-            // @todo but consider multiple chunks etc
-            if (discardTrailingNewline) {
-                if (buffer[position] === "\n") {
-                    ++position;
-                }
-                discardTrailingNewline = false;
-            }
-            let lineLength = -1;
-            let fieldLength = startingFieldLength;
-            let character;
-            for (let index = startingPosition; lineLength < 0 && index < length; ++index) {
-                character = buffer[index];
-                if (character === ":" && fieldLength < 0) {
-                    fieldLength = index - position;
-                }
-                else if (character === "\r") {
-                    discardTrailingNewline = true;
-                    lineLength = index - position;
-                }
-                else if (character === "\n") {
-                    lineLength = index - position;
-                }
-            }
-            if (lineLength < 0) {
-                startingPosition = length - position;
-                startingFieldLength = fieldLength;
-                break;
-            }
-            else {
-                startingPosition = 0;
-                startingFieldLength = -1;
-            }
-            parseEventStreamLine(buffer, position, fieldLength, lineLength);
-            position += lineLength + 1;
-        }
-        if (position === length) {
-            // If we consumed the entire buffer to read the event, reset the buffer
-            buffer = "";
-        }
-        else if (position > 0) {
-            // If there are bytes left to process, set the buffer to the unprocessed
-            // portion of the buffer only
-            buffer = buffer.slice(position);
-        }
-    }
-    function parseEventStreamLine(lineBuffer, index, fieldLength, lineLength) {
-        if (lineLength === 0) {
-            // We reached the last line of this event
-            if (data.length > 0) {
-                onParse({
-                    type: "event",
-                    id: eventId,
-                    event: eventName || undefined,
-                    data: data.slice(0, -1), // remove trailing newline
-                });
-                data = "";
-                eventId = undefined;
-            }
-            eventName = undefined;
-            return;
-        }
-        const noValue = fieldLength < 0;
-        const field = lineBuffer.slice(index, index + (noValue ? lineLength : fieldLength));
-        let step = 0;
-        if (noValue) {
-            step = lineLength;
-        }
-        else if (lineBuffer[index + fieldLength + 1] === " ") {
-            step = fieldLength + 2;
-        }
-        else {
-            step = fieldLength + 1;
-        }
-        const position = index + step;
-        const valueLength = lineLength - step;
-        const value = lineBuffer.slice(position, position + valueLength).toString();
-        if (field === "data") {
-            data += value ? `${value}\n` : "\n";
-        }
-        else if (field === "event") {
-            eventName = value;
-        }
-        else if (field === "id" && !value.includes("\u0000")) {
-            eventId = value;
-        }
-        else if (field === "retry") {
-            const retry = parseInt(value, 10);
-            if (!Number.isNaN(retry)) {
-                onParse({ type: "reconnect-interval", value: retry });
-            }
-        }
-    }
-}
-const BOM = [239, 187, 191];
-function hasBom(buffer) {
-    return BOM.every((charCode, index) => buffer.charCodeAt(index) === charCode);
-}

package/dist/utils/eventsource-parser/stream.cjs

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventSourceParserStream = void 0;
-const parse_js_1 = require("./parse.cjs");
-/**
- * A TransformStream that ingests a stream of strings and produces a stream of ParsedEvents.
- *
- * @example
- * ```
- * const eventStream =
- *   response.body
- *     .pipeThrough(new TextDecoderStream())
- *     .pipeThrough(new EventSourceParserStream())
- * ```
- * @public
- */
-class EventSourceParserStream extends TransformStream {
-    constructor() {
-        let parser;
-        super({
-            start(controller) {
-                parser = (0, parse_js_1.createParser)((event) => {
-                    if (event.type === "event") {
-                        controller.enqueue(event);
-                    }
-                });
-            },
-            transform(chunk) {
-                parser.feed(chunk);
-            },
-        });
-    }
-}
-exports.EventSourceParserStream = EventSourceParserStream;

package/dist/utils/eventsource-parser/stream.d.ts

@@ -1,17 +0,0 @@
-import type { ParsedEvent } from "./types.js";
-/**
- * A TransformStream that ingests a stream of strings and produces a stream of ParsedEvents.
- *
- * @example
- * ```
- * const eventStream =
- *   response.body
- *     .pipeThrough(new TextDecoderStream())
- *     .pipeThrough(new EventSourceParserStream())
- * ```
- * @public
- */
-export declare class EventSourceParserStream extends TransformStream<string, ParsedEvent> {
-    constructor();
-}
-export type { ParsedEvent } from "./types.js";

package/dist/utils/eventsource-parser/stream.js

@@ -1,30 +0,0 @@
-import { createParser } from "./parse.js";
-/**
- * A TransformStream that ingests a stream of strings and produces a stream of ParsedEvents.
- *
- * @example
- * ```
- * const eventStream =
- *   response.body
- *     .pipeThrough(new TextDecoderStream())
- *     .pipeThrough(new EventSourceParserStream())
- * ```
- * @public
- */
-export class EventSourceParserStream extends TransformStream {
-    constructor() {
-        let parser;
-        super({
-            start(controller) {
-                parser = createParser((event) => {
-                    if (event.type === "event") {
-                        controller.enqueue(event);
-                    }
-                });
-            },
-            transform(chunk) {
-                parser.feed(chunk);
-            },
-        });
-    }
-}

package/dist/utils/eventsource-parser/types.d.ts

@@ -1,81 +0,0 @@
-/**
- * EventSource parser instance.
- *
- * Needs to be reset between reconnections/when switching data source, using the `reset()` method.
- *
- * @public
- */
-export interface EventSourceParser {
-    /**
-     * Feeds the parser another chunk. The method _does not_ return a parsed message.
-     * Instead, if the chunk was a complete message (or completed a previously incomplete message),
-     * it will invoke the `onParse` callback used to create the parsers.
-     *
-     * @param chunk - The chunk to parse. Can be a partial, eg in the case of streaming messages.
-     * @public
-     */
-    feed(chunk: string): void;
-    /**
-     * Resets the parser state. This is required when you have a new stream of messages -
-     * for instance in the case of a client being disconnected and reconnecting.
-     *
-     * @public
-     */
-    reset(): void;
-}
-/**
- * A parsed EventSource event
- *
- * @public
- */
-export interface ParsedEvent {
-    /**
-     * Differentiates the type from reconnection intervals and other types of messages
-     * Not to be confused with `event`.
-     */
-    type: "event";
-    /**
-     * The event type sent from the server. Note that this differs from the browser `EventSource`
-     * implementation in that browsers will default this to `message`, whereas this parser will
-     * leave this as `undefined` if not explicitly declared.
-     */
-    event?: string;
-    /**
-     * ID of the message, if any was provided by the server. Can be used by clients to keep the
-     * last received message ID in sync when reconnecting.
-     */
-    id?: string;
-    /**
-     * The data received for this message
-     */
-    data: string;
-}
-/**
- * An event emitted from the parser when the server sends a value in the `retry` field,
- * indicating how many seconds the client should wait before attempting to reconnect.
- *
- * @public
- */
-export interface ReconnectInterval {
-    /**
-     * Differentiates the type from `event` and other types of messages
-     */
-    type: "reconnect-interval";
-    /**
-     * Number of seconds to wait before reconnecting. Note that the parser does not care about
-     * this value at all - it only emits the value for clients to use.
-     */
-    value: number;
-}
-/**
- * The different types of messages the parsed can emit to the `onParse` callback
- *
- * @public
- */
-export type ParseEvent = ParsedEvent | ReconnectInterval;
-/**
- * Callback passed as the `onParse` callback to a parser
- *
- * @public
- */
-export type EventSourceParseCallback = (event: ParseEvent) => void;