@astrogate/sdk 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,138 @@
+import type {ParseError} from './errors.ts'
+
+/**
+ * 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, callbacks passed when creating the parser will be triggered once we see enough data
+   * for a valid/invalid parsing step (see {@link ParserCallbacks}).
+   *
+   * @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.
+   *
+   * Previously received, incomplete data will NOT be parsed unless you pass `consume: true`,
+   * which tells the parser to attempt to consume any incomplete data as if it ended with a newline
+   * character. This is useful for cases when a server sends a non-EventSource message that you
+   * want to be able to react to in an `onError` callback.
+   *
+   * @public
+   */
+  reset(options?: {consume?: boolean}): void
+}
+
+/**
+ * A parsed EventSource message event
+ *
+ * @public
+ */
+export interface EventSourceMessage {
+  /**
+   * 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 | undefined
+
+  /**
+   * 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 | undefined
+
+  /**
+   * The data received for this message
+   */
+  data: string
+}
+
+/**
+ * Callbacks that can be passed to the parser to handle different types of parsed messages
+ * and errors.
+ *
+ * @public
+ */
+export interface ParserCallbacks {
+  /**
+   * Callback for an `id` field when a blank line ends an event block.
+   *
+   * Called once with the last valid `id` value in the block, whether or not the block contains a
+   * `data` field. When the block produces an event, `onId` is called before `onEvent`. An empty
+   * `id` field is reported as an empty string. An `id` field containing U+0000 is ignored.
+   *
+   * @param id - The value of the last valid `id` field in the block
+   */
+  onId?: ((id: string) => void) | undefined
+
+  /**
+   * Callback for when a new event/message is parsed from the stream.
+   * This is the main callback that clients will use to handle incoming messages.
+   *
+   * @param event - The parsed event/message
+   */
+  onEvent?: ((event: EventSourceMessage) => void) | undefined
+
+  /**
+   * Callback for when the server sends a new reconnection interval through the `retry` field.
+   *
+   * @param retry - The number of milliseconds to wait before reconnecting.
+   */
+  onRetry?: ((retry: number) => void) | undefined
+
+  /**
+   * Callback for when a comment is encountered in the stream.
+   *
+   * @param comment - The comment encountered in the stream.
+   */
+  onComment?: ((comment: string) => void) | undefined
+
+  /**
+   * Callback for when an error occurs during parsing. This is a catch-all for any errors
+   * that occur during parsing, and can be used to handle them in a custom way. Most clients
+   * tend to silently ignore any errors and instead retry, but it can be helpful to log/debug.
+   *
+   * Incomplete lines that cannot become valid SSE fields may be discarded before completion
+   * to avoid unbounded buffering. Those discarded lines do not trigger `onError`.
+   *
+   * @param error - The error that occurred during parsing
+   */
+  onError?: ((error: ParseError) => void) | undefined
+}
+
+/**
+ * Configuration accepted by {@link createParser}. Extends {@link ParserCallbacks} with
+ * additional options that control parser behavior.
+ *
+ * @public
+ */
+export interface ParserConfig extends ParserCallbacks {
+  /**
+   * Maximum number of characters the parser is allowed to buffer across calls to `feed()`.
+   *
+   * Two buffered surfaces exist in a streaming SSE parser:
+   * - A valid partial line that has not yet been terminated by `\n`, `\r`, or `\r\n`.
+   * - A multi-line event whose terminating blank line has not yet arrived (each `data:`
+   *   field gets appended to the buffered event).
+   *
+   * Lines that cannot become valid SSE fields are discarded without buffering.
+   *
+   * When the combined size of these buffers exceeds `maxBufferSize`, the parser emits a
+   * `ParseError` with `type: 'max-buffer-size-exceeded'` to `onError` and becomes
+   * terminated — subsequent calls to `feed()` will throw until `reset()` is called.
+   * This protects against unbounded memory growth from malformed or malicious streams.
+   *
+   * @defaultValue `undefined` (unbounded)
+   */
+  maxBufferSize?: number | undefined
+}

package/node_modules/eventsource/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "eventsource",
+  "version": "5.1.3",
+  "description": "WhatWG/W3C compliant EventSource client for Node.js and browsers",
+  "keywords": [
+    "eventsource",
+    "server-sent-events",
+    "sse"
+  ],
+  "homepage": "https://github.com/EventSource/eventsource#readme",
+  "bugs": {
+    "url": "https://github.com/EventSource/eventsource/issues"
+  },
+  "license": "MIT",
+  "author": "Espen Hovlandsdal <espen@hovlandsdal.com>",
+  "contributors": [
+    "Aslak Hellesøy <aslak.hellesoy@gmail.com>",
+    "Einar Otto Stangvik <einaro.s@gmail.com>"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git://git@github.com/EventSource/eventsource.git"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!dist/stats.html"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "exports": {
+      ".": {
+        "default": "./dist/index.js"
+      },
+      "./package.json": "./package.json"
+    },
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.dist.json",
+    "build:watch": "tsc -p tsconfig.dist.json --watch",
+    "changeset": "changeset",
+    "changeset:status": "changeset status --since=origin/main",
+    "clean": "node scripts/clean.ts",
+    "format": "oxfmt --write .",
+    "lint": "oxlint . && tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+    "prebuild": "npm run clean",
+    "prepare": "npm run build",
+    "release": "changeset publish",
+    "test": "vitest run",
+    "test:browser": "vitest run --config ./vitest.browser.config.ts",
+    "test:ios": "vitest run --config ./vitest.ios.config.ts",
+    "test:ios:boot": "node scripts/bootIosSimulator.ts",
+    "test:bun": "bun run vitest run",
+    "test:deno": "deno run -A --node-modules-dir npm:vitest run",
+    "test:types": "npm run build && tsc -p tsconfig.types.json",
+    "version:packages": "changeset version && npm install --package-lock-only --no-audit --no-fund",
+    "test:all": "npm run test:types && npm run test && npm run test:browser && npm run test:bun && npm run test:deno && npm run test:happy-dom && npm run test:workerd",
+    "test:happy-dom": "vitest run --config ./vitest.happy-dom.config.ts",
+    "test:workerd": "vitest run --config ./vitest.workerd.config.ts",
+    "posttest": "npm run lint"
+  },
+  "dependencies": {
+    "eventsource-parser": "^4.1.2"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "^1.0.1",
+    "@changesets/cli": "^3.0.3",
+    "@cloudflare/vitest-plugin": "^1.4.1",
+    "@tsconfig/strictest": "^2.0.8",
+    "@types/node": "^22.19.19",
+    "@vitest/browser": "^5.0.4",
+    "@vitest/browser-playwright": "^5.0.4",
+    "eventsource-encoder": "^1.0.2",
+    "happy-dom": "^21.0.1",
+    "oxfmt": "^0.73.0",
+    "oxlint": "^1.88.0",
+    "playwright": "^1.64.0",
+    "typescript": "^7.0.0",
+    "vitest": "^5.0.4"
+  },
+  "browserslist": [
+    "node >= 22.12.0",
+    ">0.3%",
+    "chrome >= 84",
+    "safari >= 15",
+    "firefox >= 105",
+    "edge >= 84"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "packageManager": "npm@12.0.1"
+}