@skillcap/gdh 3.2.1 → 3.2.3

package/node_modules/eventsource-parser/package.json

@@ -1,12 +1,34 @@
 {
   "name": "eventsource-parser",
-  "version": "3.0.6",
+  "version": "3.0.8",
   "description": "Streaming, source-agnostic EventSource/Server-Sent Events parser",
-  "sideEffects": false,
+  "keywords": [
+    "eventsource",
+    "server-sent-events",
+    "sse"
+  ],
+  "homepage": "https://github.com/rexxars/eventsource-parser#readme",
+  "bugs": {
+    "url": "https://github.com/rexxars/eventsource-parser/issues"
+  },
+  "license": "MIT",
+  "author": "Espen Hovlandsdal <espen@hovlandsdal.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/rexxars/eventsource-parser.git"
+  },
+  "files": [
+    "dist",
+    "!dist/stats.html",
+    "!dist/index.min.js",
+    "src",
+    "stream.js"
+  ],
   "type": "module",
-  "types": "./dist/index.d.ts",
-  "module": "./dist/index.js",
+  "sideEffects": false,
   "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "source": "./src/index.ts",
@@ -22,33 +44,16 @@
     },
     "./package.json": "./package.json"
   },
-  "typesVersions": {
-    "*": {
-      "stream": [
-        "./dist/stream.d.ts"
-      ]
-    }
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "browserslist": [
-    "node >= 20",
-    "chrome >= 71",
-    "safari >= 14.1",
-    "firefox >= 105",
-    "edge >= 79"
-  ],
-  "files": [
-    "dist",
-    "!dist/stats.html",
-    "src",
-    "stream.js"
-  ],
   "scripts": {
     "build": "pkg-utils build && pkg-utils --strict",
     "clean": "rimraf dist coverage",
-    "lint": "eslint . && tsc --noEmit",
+    "check": "npm run clean && npm run format && npm run lint && npm run build && vitest run",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "bench": "node --expose-gc --experimental-strip-types --no-warnings=ExperimentalWarning bench/parse.bench.ts",
+    "bundle-size": "node --experimental-strip-types --no-warnings=ExperimentalWarning scripts/bundle-size.ts",
+    "knip": "knip",
+    "lint": "oxlint && tsc --noEmit",
     "posttest": "npm run lint",
     "prebuild": "npm run clean",
     "prepublishOnly": "npm run build",
@@ -57,59 +62,31 @@
     "test:deno": "deno run --allow-write --allow-net --allow-run --allow-sys --allow-ffi --allow-env --allow-read npm:vitest",
     "test:node": "vitest --reporter=verbose"
   },
-  "author": "Espen Hovlandsdal <espen@hovlandsdal.com>",
-  "keywords": [
-    "sse",
-    "eventsource",
-    "server-sent-events"
-  ],
   "devDependencies": {
-    "@sanity/pkg-utils": "^8.0.0",
-    "@sanity/semantic-release-preset": "^5.0.0",
+    "@sanity/pkg-utils": "^10.4.15",
+    "@sanity/semantic-release-preset": "^6.0.0",
+    "@sanity/tsconfig": "^2.1.0",
     "@types/node": "^20.19.0",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "eslint": "^8.51.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-config-sanity": "^7.1.2",
     "eventsource-encoder": "^1.0.1",
-    "prettier": "^3.5.3",
-    "rimraf": "^6.0.1",
+    "knip": "^6.4.1",
+    "mitata": "^1.0.34",
+    "oxfmt": "^0.45.0",
+    "oxlint": "^1.60.0",
+    "rimraf": "^6.1.3",
     "rollup-plugin-visualizer": "^6.0.3",
-    "semantic-release": "^24.2.3",
-    "typescript": "^5.8.3",
-    "vitest": "^3.1.3"
-  },
-  "homepage": "https://github.com/rexxars/eventsource-parser#readme",
-  "bugs": {
-    "url": "https://github.com/rexxars/eventsource-parser/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+ssh://git@github.com/rexxars/eventsource-parser.git"
-  },
-  "license": "MIT",
-  "prettier": {
-    "bracketSpacing": false,
-    "printWidth": 100,
-    "semi": false,
-    "singleQuote": true
+    "semantic-release": "^25.0.3",
+    "terser": "^5.46.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.4"
   },
-  "eslintConfig": {
-    "parserOptions": {
-      "ecmaFeatures": {
-        "modules": true
-      },
-      "ecmaVersion": 9,
-      "sourceType": "module"
-    },
-    "extends": [
-      "sanity",
-      "sanity/typescript",
-      "prettier"
-    ],
-    "ignorePatterns": [
-      "lib/**/"
-    ]
+  "browserslist": [
+    "node >= 18",
+    "chrome >= 71",
+    "safari >= 14.1",
+    "firefox >= 105",
+    "edge >= 79"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
   }
 }

package/node_modules/eventsource-parser/src/parse.ts

@@ -5,7 +5,12 @@
 import {ParseError} from './errors.ts'
 import type {EventSourceParser, ParserCallbacks} from './types.ts'
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
+// ASCII codes used in the hot parsing paths.
+const LF = 10
+const CR = 13
+const SPACE = 32
+
+// oxlint-disable-next-line no-unused-vars
 function noop(_arg: unknown) {
   // intentional noop
 }
@@ -31,66 +36,247 @@ export function createParser(callbacks: ParserCallbacks): EventSourceParser {
 
   const {onEvent = noop, onError = noop, onRetry = noop, onComment} = callbacks
 
-  let incompleteLine = ''
+  // Trailing bytes from prior `feed()` calls that did not yet form a complete line.
+  // Stored as an array of fragments and only joined when a line terminator arrives.
+  // Concatenating per-feed (`prefix + chunk`) is O(N²) when a single SSE line spans
+  // many chunks (e.g. a large `data:` payload streamed in tiny slices, or an MCP-style
+  // server that emits one giant content block). Buffering as fragments + joining once
+  // makes the same workload linear.
+  const pendingFragments: string[] = []
 
   let isFirstChunk = true
   let id: string | undefined
   let data = ''
-  let eventType = ''
+  let dataLines = 0
+  let eventType: string | undefined
 
-  function feed(newChunk: string) {
-    // Strip any UTF8 byte order mark (BOM) at the start of the stream
-    const chunk = isFirstChunk ? newChunk.replace(/^\xEF\xBB\xBF/, '') : newChunk
+  /**
+   * Feeds a chunk of the SSE stream to the parser. Any trailing bytes that do
+   * not yet form a complete line are held back and prepended to the next chunk,
+   * so callers can pass arbitrary slices of the stream without worrying about
+   * line boundaries.
+   *
+   * Per the SSE spec, a UTF-8 BOM (0xEF 0xBB 0xBF) at the start of the very
+   * first chunk is stripped before parsing.
+   *
+   * @see https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream
+   */
+  function feed(chunk: string) {
+    if (isFirstChunk) {
+      isFirstChunk = false
+      // Match and strip UTF-8 BOM from the start of the stream, if present.
+      // (Per the spec, this is only valid at the very start of the stream)
+      if (
+        chunk.charCodeAt(0) === 0xef &&
+        chunk.charCodeAt(1) === 0xbb &&
+        chunk.charCodeAt(2) === 0xbf
+      ) {
+        chunk = chunk.slice(3)
+      }
+    }
 
-    // If there was a previous incomplete line, append it to the new chunk,
-    // so we may process it together as a new (hopefully complete) chunk.
-    const [complete, incomplete] = splitLines(`${incompleteLine}${chunk}`)
+    // Hot path: no buffered prefix from a prior partial line. Hand the chunk
+    // straight to `processLines`, exactly like the original implementation.
+    // Zero new work in the common case (every chunk ends with `\n\n`).
+    if (pendingFragments.length === 0) {
+      const trailing = processLines(chunk)
+      if (trailing !== '') pendingFragments.push(trailing)
+      return
+    }
 
-    for (const line of complete) {
-      parseLine(line)
+    // We have a buffered prefix. If this chunk also has no terminator, append
+    // to the buffer without concatenating — that's the O(N²) trap we're
+    // avoiding (large single `data:` payload split across many tiny chunks).
+    if (chunk.indexOf('\n') === -1 && chunk.indexOf('\r') === -1) {
+      pendingFragments.push(chunk)
+      return
     }
 
-    incompleteLine = incomplete
-    isFirstChunk = false
+    // Terminator arrived. Join the accumulated fragments + this chunk once,
+    // process, and buffer any new trailing partial line.
+    pendingFragments.push(chunk)
+    const input = pendingFragments.join('')
+    pendingFragments.length = 0
+    const trailing = processLines(input)
+    if (trailing !== '') pendingFragments.push(trailing)
   }
 
-  function parseLine(line: string) {
-    // If the line is empty (a blank line), dispatch the event
-    if (line === '') {
+  /**
+   * Splits `chunk` into SSE lines and dispatches each to the appropriate handler.
+   * Returns any trailing bytes that did not terminate with a line break, so the
+   * caller can prepend them to the next chunk.
+   *
+   * The SSE spec permits three line terminators: `\n`, `\r`, and `\r\n`. Real-world
+   * streams almost always use plain `\n`, so we take a fast path when no `\r` is
+   * present in the chunk. The slow path is spec-correct but does more work per line.
+   */
+  function processLines(chunk: string): string {
+    let searchIndex = 0
+
+    // Fast path: LF-only chunk (the common case for typical SSE servers).
+    // We can scan forward with a single `indexOf('\n')` per line and inline
+    // the hot-path branches for `data:` and `event:` without the CR bookkeeping
+    // the slow path needs.
+    if (chunk.indexOf('\r') === -1) {
+      let lfIndex = chunk.indexOf('\n', searchIndex)
+      while (lfIndex !== -1) {
+        // Blank line: end-of-event marker. Dispatch the accumulated event (if any)
+        // and reset the buffered fields. This is hoisted out of `parseLine` because
+        // it's the single most common line shape after `data:` lines.
+        if (searchIndex === lfIndex) {
+          if (dataLines > 0) {
+            onEvent({id, event: eventType, data})
+          }
+          id = undefined
+          data = ''
+          dataLines = 0
+          eventType = undefined
+          searchIndex = lfIndex + 1
+          lfIndex = chunk.indexOf('\n', searchIndex)
+          continue
+        }
+        const firstCharCode = chunk.charCodeAt(searchIndex)
+        if (isDataPrefix(chunk, searchIndex, firstCharCode)) {
+          // `data:` line — append the value to the event's data buffer.
+          // 'data:'.length === 5, 'data: '.length === 6
+          const valueStart =
+            chunk.charCodeAt(searchIndex + 5) === SPACE ? searchIndex + 6 : searchIndex + 5
+          const value = chunk.slice(valueStart, lfIndex)
+          // Fast path within a fast path: if this is the first data line AND the
+          // next char is another LF (i.e. `data:foo\n\n`), dispatch immediately
+          // without ever writing to the `data` buffer. This is the shape of a
+          // typical single-line SSE event (ChatGPT-style streams, etc.) and is
+          // hot enough to be worth the duplication.
+          if (dataLines === 0 && chunk.charCodeAt(lfIndex + 1) === LF) {
+            onEvent({id, event: eventType, data: value})
+            id = undefined
+            data = ''
+            eventType = undefined
+            searchIndex = lfIndex + 2
+            lfIndex = chunk.indexOf('\n', searchIndex)
+            continue
+          }
+          // Multi-line data: concatenate with newline separator per spec.
+          data = dataLines === 0 ? value : `${data}\n${value}`
+          dataLines++
+        } else if (isEventPrefix(chunk, searchIndex, firstCharCode)) {
+          // `event:` line — set the event type for the next dispatch. Per spec,
+          // an empty value resets `event type` to its default (undefined here).
+          // 'event:'.length === 6, 'event: '.length === 7
+          eventType =
+            chunk.slice(
+              chunk.charCodeAt(searchIndex + 6) === SPACE ? searchIndex + 7 : searchIndex + 6,
+              lfIndex,
+            ) || undefined
+        } else {
+          // Everything else: `id:`, `retry:`, comment lines (`:` prefix), unknown
+          // fields, or malformed lines. These are rarer and go through the full
+          // per-line parser, which handles the SSE field grammar in detail.
+          parseLine(chunk, searchIndex, lfIndex)
+        }
+        searchIndex = lfIndex + 1
+        lfIndex = chunk.indexOf('\n', searchIndex)
+      }
+      return chunk.slice(searchIndex)
+    }
+
+    // Slow path: the chunk contains at least one `\r`, so lines may be terminated
+    // by `\r`, `\n`, or `\r\n`. We locate the next terminator by looking at both
+    // the nearest `\r` and `\n` and picking whichever comes first.
+    while (searchIndex < chunk.length) {
+      const crIndex = chunk.indexOf('\r', searchIndex)
+      const lfIndex = chunk.indexOf('\n', searchIndex)
+
+      let lineEnd = -1
+      if (crIndex !== -1 && lfIndex !== -1) {
+        lineEnd = crIndex < lfIndex ? crIndex : lfIndex
+      } else if (crIndex !== -1) {
+        // A trailing `\r` at the very end of the chunk is ambiguous: it could be
+        // a bare-CR terminator, or the first half of a `\r\n` whose `\n` arrives
+        // in the next chunk. Defer until we see more input.
+        if (crIndex === chunk.length - 1) {
+          lineEnd = -1
+        } else {
+          lineEnd = crIndex
+        }
+      } else if (lfIndex !== -1) {
+        lineEnd = lfIndex
+      }
+
+      if (lineEnd === -1) {
+        break
+      }
+
+      parseLine(chunk, searchIndex, lineEnd)
+      searchIndex = lineEnd + 1
+      // If we just consumed a `\r` and the next char is `\n`, skip it so the
+      // pair is treated as a single terminator rather than an empty line.
+      if (chunk.charCodeAt(searchIndex - 1) === CR && chunk.charCodeAt(searchIndex) === LF) {
+        searchIndex++
+      }
+    }
+
+    return chunk.slice(searchIndex)
+  }
+
+  function parseLine(chunk: string, start: number, end: number) {
+    if (start === end) {
       dispatchEvent()
       return
     }
 
-    // If the line starts with a U+003A COLON character (:), ignore the line.
-    if (line.startsWith(':')) {
+    const firstCharCode = chunk.charCodeAt(start)
+
+    if (isDataPrefix(chunk, start, firstCharCode)) {
+      // 'data:'.length === 5, 'data: '.length === 6
+      const valueStart = chunk.charCodeAt(start + 5) === SPACE ? start + 6 : start + 5
+      const value = chunk.slice(valueStart, end)
+      data = dataLines === 0 ? value : `${data}\n${value}`
+      dataLines++
+      return
+    }
+
+    if (isEventPrefix(chunk, start, firstCharCode)) {
+      // 'event:'.length === 6, 'event: '.length === 7
+      eventType =
+        chunk.slice(chunk.charCodeAt(start + 6) === SPACE ? start + 7 : start + 6, end) || undefined
+      return
+    }
+
+    // Fast path for "id:" — 'i' = 105, 'd' = 100, ':' = 58
+    if (
+      firstCharCode === 105 &&
+      chunk.charCodeAt(start + 1) === 100 &&
+      chunk.charCodeAt(start + 2) === 58
+    ) {
+      // 'id:'.length === 3, 'id: '.length === 4
+      const value = chunk.slice(chunk.charCodeAt(start + 3) === SPACE ? start + 4 : start + 3, end)
+      id = value.includes('\0') ? undefined : value
+      return
+    }
+
+    // Comment line — ':' = 58
+    if (firstCharCode === 58) {
       if (onComment) {
-        onComment(line.slice(line.startsWith(': ') ? 2 : 1))
+        const line = chunk.slice(start, end)
+        // skip ':' (+1), or ': ' (+2) when a space follows
+        onComment(line.slice(chunk.charCodeAt(start + 1) === SPACE ? 2 : 1))
       }
       return
     }
 
-    // If the line contains a U+003A COLON character (:)
+    const line = chunk.slice(start, end)
     const fieldSeparatorIndex = line.indexOf(':')
-    if (fieldSeparatorIndex !== -1) {
-      // Collect the characters on the line before the first U+003A COLON character (:),
-      // and let `field` be that string.
-      const field = line.slice(0, fieldSeparatorIndex)
-
-      // Collect the characters on the line after the first U+003A COLON character (:),
-      // and let `value` be that string. If value starts with a U+0020 SPACE character,
-      // remove it from value.
-      const offset = line[fieldSeparatorIndex + 1] === ' ' ? 2 : 1
-      const value = line.slice(fieldSeparatorIndex + offset)
-
-      processField(field, value, line)
+    if (fieldSeparatorIndex === -1) {
+      processField(line, '', line)
       return
     }
 
-    // Otherwise, the string is not empty but does not contain a U+003A COLON character (:)
-    // Process the field using the whole line as the field name, and an empty string as the field value.
-    // 👆 This is according to spec. That means that a line that has the value `data` will result in
-    // a newline being added to the current `data` buffer, for instance.
-    processField(line, '', line)
+    const field = line.slice(0, fieldSeparatorIndex)
+    // skip ':' (+1), or ': ' (+2) when a space follows
+    const offset = line.charCodeAt(fieldSeparatorIndex + 1) === SPACE ? 2 : 1
+    const value = line.slice(fieldSeparatorIndex + offset)
+    processField(field, value, line)
   }
 
   function processField(field: string, value: string, line: string) {
@@ -98,12 +284,11 @@ export function createParser(callbacks: ParserCallbacks): EventSourceParser {
     switch (field) {
       case 'event':
         // Set the `event type` buffer to field value
-        eventType = value
+        eventType = value || undefined
         break
       case 'data':
-        // Append the field value to the `data` buffer, then append a single U+000A LINE FEED(LF)
-        // character to the `data` buffer.
-        data = `${data}${value}\n`
+        data = dataLines === 0 ? value : `${data}\n${value}`
+        dataLines++
         break
       case 'id':
         // If the field value does not contain U+0000 NULL, then set the `ID` buffer to
@@ -139,94 +324,72 @@ export function createParser(callbacks: ParserCallbacks): EventSourceParser {
   }
 
   function dispatchEvent() {
-    const shouldDispatch = data.length > 0
-    if (shouldDispatch) {
+    if (dataLines > 0) {
       onEvent({
         id,
-        event: eventType || undefined,
-        // If the data buffer's last character is a U+000A LINE FEED (LF) character,
-        // then remove the last character from the data buffer.
-        data: data.endsWith('\n') ? data.slice(0, -1) : data,
+        event: eventType,
+        data,
       })
     }
 
-    // Reset for the next event
     id = undefined
     data = ''
-    eventType = ''
+    dataLines = 0
+    eventType = undefined
   }
 
   function reset(options: {consume?: boolean} = {}) {
-    if (incompleteLine && options.consume) {
-      parseLine(incompleteLine)
+    if (options.consume && pendingFragments.length > 0) {
+      const incompleteLine = pendingFragments.join('')
+      parseLine(incompleteLine, 0, incompleteLine.length)
     }
 
     isFirstChunk = true
     id = undefined
     data = ''
-    eventType = ''
-    incompleteLine = ''
+    dataLines = 0
+    eventType = undefined
+    pendingFragments.length = 0
   }
 
   return {feed, reset}
 }
 
 /**
- * For the given `chunk`, split it into lines according to spec, and return any remaining incomplete line.
+ * Checks if `chunk` starts with the literal `data:` at index `i`.
  *
- * @param chunk - The chunk to split into lines
- * @returns A tuple containing an array of complete lines, and any remaining incomplete line
- * @internal
+ * Equivalent to `chunk.startsWith('data:', i)`, but benchmarks show this
+ * hand-unrolled char-code comparison is ~20% faster on common event types.
+ * The caller passes `firstCharCode` (the code at `i`) so it can be reused
+ * across prefix checks.
+ *
+ * ASCII: 'd' = 100, 'a' = 97, 't' = 116, 'a' = 97, ':' = 58
  */
-function splitLines(chunk: string): [complete: Array<string>, incomplete: string] {
-  /**
-   * According to the spec, a line is terminated by either:
-   * - U+000D CARRIAGE RETURN U+000A LINE FEED (CRLF) character pair
-   * - a single U+000A LINE FEED(LF) character not preceded by a U+000D CARRIAGE RETURN(CR) character
-   * - a single U+000D CARRIAGE RETURN(CR) character not followed by a U+000A LINE FEED(LF) character
-   */
-  const lines: Array<string> = []
-  let incompleteLine = ''
-  let searchIndex = 0
-
-  while (searchIndex < chunk.length) {
-    // Find next line terminator
-    const crIndex = chunk.indexOf('\r', searchIndex)
-    const lfIndex = chunk.indexOf('\n', searchIndex)
-
-    // Determine line end
-    let lineEnd = -1
-    if (crIndex !== -1 && lfIndex !== -1) {
-      // CRLF case
-      lineEnd = Math.min(crIndex, lfIndex)
-    } else if (crIndex !== -1) {
-      // CR at the end of a chunk might be part of a CRLF sequence that spans chunks,
-      // so we shouldn't treat it as a line terminator (yet)
-      if (crIndex === chunk.length - 1) {
-        lineEnd = -1
-      } else {
-        lineEnd = crIndex
-      }
-    } else if (lfIndex !== -1) {
-      lineEnd = lfIndex
-    }
-
-    // Extract line if terminator found
-    if (lineEnd === -1) {
-      // No terminator found, rest is incomplete
-      incompleteLine = chunk.slice(searchIndex)
-      break
-    } else {
-      const line = chunk.slice(searchIndex, lineEnd)
-      lines.push(line)
-
-      // Move past line terminator
-      searchIndex = lineEnd + 1
-      if (chunk[searchIndex - 1] === '\r' && chunk[searchIndex] === '\n') {
-        searchIndex++
-      }
-    }
-  }
+function isDataPrefix(chunk: string, i: number, firstCharCode: number): boolean {
+  return (
+    firstCharCode === 100 &&
+    chunk.charCodeAt(i + 1) === 97 &&
+    chunk.charCodeAt(i + 2) === 116 &&
+    chunk.charCodeAt(i + 3) === 97 &&
+    chunk.charCodeAt(i + 4) === 58
+  )
+}
 
-  return [lines, incompleteLine]
+/**
+ * Checks if `chunk` starts with the literal `event:` at index `i`.
+ *
+ * See {@link isDataPrefix} for why this is hand-unrolled rather than using
+ * `String.prototype.startsWith`.
+ *
+ * ASCII: 'e' = 101, 'v' = 118, 'e' = 101, 'n' = 110, 't' = 116, ':' = 58
+ */
+function isEventPrefix(chunk: string, i: number, firstCharCode: number): boolean {
+  return (
+    firstCharCode === 101 &&
+    chunk.charCodeAt(i + 1) === 118 &&
+    chunk.charCodeAt(i + 2) === 101 &&
+    chunk.charCodeAt(i + 3) === 110 &&
+    chunk.charCodeAt(i + 4) === 116 &&
+    chunk.charCodeAt(i + 5) === 58
+  )
 }