@astrogate/sdk 0.0.0-stage → 0.1.0

package/node_modules/eventsource-parser/dist/stream.d.cts

@@ -0,0 +1,134 @@
+/**
+ * The type of error that occurred.
+ * @public
+ */
+export declare type ErrorType =
+  | "invalid-retry"
+  | "unknown-field"
+  | "max-buffer-size-exceeded";
+
+/**
+ * A parsed EventSource message event
+ *
+ * @public
+ */
+export declare 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;
+}
+
+/**
+ * A TransformStream that ingests a stream of strings and produces a stream of `EventSourceMessage`.
+ *
+ * @example Basic usage
+ * ```
+ * const eventStream =
+ *   response.body
+ *     .pipeThrough(new TextDecoderStream())
+ *     .pipeThrough(new EventSourceParserStream())
+ * ```
+ *
+ * @example Terminate stream on parsing errors
+ * ```
+ * const eventStream =
+ *  response.body
+ *   .pipeThrough(new TextDecoderStream())
+ *   .pipeThrough(new EventSourceParserStream({onError: 'terminate'}))
+ * ```
+ *
+ * @public
+ */
+export declare class EventSourceParserStream extends TransformStream<
+  string,
+  EventSourceMessage
+> {
+  constructor({ onError, onRetry, onComment, maxBufferSize }?: StreamOptions);
+}
+
+/**
+ * Error thrown when encountering an issue during parsing.
+ *
+ * @public
+ */
+export declare class ParseError extends Error {
+  /**
+   * The type of error that occurred.
+   */
+  type: ErrorType;
+  /**
+   * In the case of an unknown field encountered in the stream, this will be the field name.
+   */
+  field?: string | undefined;
+  /**
+   * In the case of an unknown field encountered in the stream, this will be the value of the field.
+   */
+  value?: string | undefined;
+  /**
+   * The line that caused the error, if available.
+   */
+  line?: string | undefined;
+  constructor(
+    message: string,
+    options: {
+      type: ErrorType;
+      field?: string;
+      value?: string;
+      line?: string;
+    },
+  );
+}
+
+/**
+ * Options for the EventSourceParserStream.
+ *
+ * @public
+ */
+export declare interface StreamOptions {
+  /**
+   * Behavior when a parsing error occurs.
+   *
+   * - A custom function can be provided to handle the error.
+   * - `'terminate'` will error the stream and stop parsing.
+   * - Any other value will ignore the error and continue parsing.
+   *
+   * @defaultValue `undefined`
+   */
+  onError?: ("terminate" | ((error: Error) => void)) | undefined;
+  /**
+   * Callback for when a reconnection interval is sent from the server.
+   *
+   * @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;
+  /**
+   * Maximum number of characters the parser is allowed to buffer across calls to `feed()`.
+   * See {@link ParserConfig.maxBufferSize} for details.
+   *
+   * When the limit is exceeded, the stream is always errored (regardless of the `onError`
+   * setting) since the underlying parser is unrecoverable without a `reset()`.
+   *
+   * @defaultValue `undefined` (unbounded)
+   */
+  maxBufferSize?: number | undefined;
+}
+
+export {};

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

@@ -0,0 +1,134 @@
+/**
+ * The type of error that occurred.
+ * @public
+ */
+export declare type ErrorType =
+  | "invalid-retry"
+  | "unknown-field"
+  | "max-buffer-size-exceeded";
+
+/**
+ * A parsed EventSource message event
+ *
+ * @public
+ */
+export declare 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;
+}
+
+/**
+ * A TransformStream that ingests a stream of strings and produces a stream of `EventSourceMessage`.
+ *
+ * @example Basic usage
+ * ```
+ * const eventStream =
+ *   response.body
+ *     .pipeThrough(new TextDecoderStream())
+ *     .pipeThrough(new EventSourceParserStream())
+ * ```
+ *
+ * @example Terminate stream on parsing errors
+ * ```
+ * const eventStream =
+ *  response.body
+ *   .pipeThrough(new TextDecoderStream())
+ *   .pipeThrough(new EventSourceParserStream({onError: 'terminate'}))
+ * ```
+ *
+ * @public
+ */
+export declare class EventSourceParserStream extends TransformStream<
+  string,
+  EventSourceMessage
+> {
+  constructor({ onError, onRetry, onComment, maxBufferSize }?: StreamOptions);
+}
+
+/**
+ * Error thrown when encountering an issue during parsing.
+ *
+ * @public
+ */
+export declare class ParseError extends Error {
+  /**
+   * The type of error that occurred.
+   */
+  type: ErrorType;
+  /**
+   * In the case of an unknown field encountered in the stream, this will be the field name.
+   */
+  field?: string | undefined;
+  /**
+   * In the case of an unknown field encountered in the stream, this will be the value of the field.
+   */
+  value?: string | undefined;
+  /**
+   * The line that caused the error, if available.
+   */
+  line?: string | undefined;
+  constructor(
+    message: string,
+    options: {
+      type: ErrorType;
+      field?: string;
+      value?: string;
+      line?: string;
+    },
+  );
+}
+
+/**
+ * Options for the EventSourceParserStream.
+ *
+ * @public
+ */
+export declare interface StreamOptions {
+  /**
+   * Behavior when a parsing error occurs.
+   *
+   * - A custom function can be provided to handle the error.
+   * - `'terminate'` will error the stream and stop parsing.
+   * - Any other value will ignore the error and continue parsing.
+   *
+   * @defaultValue `undefined`
+   */
+  onError?: ("terminate" | ((error: Error) => void)) | undefined;
+  /**
+   * Callback for when a reconnection interval is sent from the server.
+   *
+   * @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;
+  /**
+   * Maximum number of characters the parser is allowed to buffer across calls to `feed()`.
+   * See {@link ParserConfig.maxBufferSize} for details.
+   *
+   * When the limit is exceeded, the stream is always errored (regardless of the `onError`
+   * setting) since the underlying parser is unrecoverable without a `reset()`.
+   *
+   * @defaultValue `undefined` (unbounded)
+   */
+  maxBufferSize?: number | undefined;
+}
+
+export {};

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

@@ -0,0 +1,30 @@
+import { createParser } from "./index.js";
+import { ParseError } from "./index.js";
+class EventSourceParserStream extends TransformStream {
+  constructor({ onError, onRetry, onComment, maxBufferSize } = {}) {
+    let parser;
+    super({
+      start(controller) {
+        parser = createParser({
+          onEvent: (event) => {
+            controller.enqueue(event);
+          },
+          onError(error) {
+            typeof onError == "function" && onError(error), (onError === "terminate" || error.type === "max-buffer-size-exceeded") && controller.error(error);
+          },
+          onRetry,
+          onComment,
+          maxBufferSize
+        });
+      },
+      transform(chunk) {
+        parser.feed(chunk);
+      }
+    });
+  }
+}
+export {
+  EventSourceParserStream,
+  ParseError
+};
+//# sourceMappingURL=stream.js.map

package/node_modules/eventsource-parser/dist/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sources":["../src/stream.ts"],"sourcesContent":["import {createParser} from './parse.ts'\nimport type {EventSourceMessage, EventSourceParser} from './types.ts'\n\n/**\n * Options for the EventSourceParserStream.\n *\n * @public\n */\nexport interface StreamOptions {\n  /**\n   * Behavior when a parsing error occurs.\n   *\n   * - A custom function can be provided to handle the error.\n   * - `'terminate'` will error the stream and stop parsing.\n   * - Any other value will ignore the error and continue parsing.\n   *\n   * @defaultValue `undefined`\n   */\n  onError?: ('terminate' | ((error: Error) => void)) | undefined\n\n  /**\n   * Callback for when a reconnection interval is sent from the server.\n   *\n   * @param retry - The number of milliseconds to wait before reconnecting.\n   */\n  onRetry?: ((retry: number) => void) | undefined\n\n  /**\n   * Callback for when a comment is encountered in the stream.\n   *\n   * @param comment - The comment encountered in the stream.\n   */\n  onComment?: ((comment: string) => void) | undefined\n\n  /**\n   * Maximum number of characters the parser is allowed to buffer across calls to `feed()`.\n   * See {@link ParserConfig.maxBufferSize} for details.\n   *\n   * When the limit is exceeded, the stream is always errored (regardless of the `onError`\n   * setting) since the underlying parser is unrecoverable without a `reset()`.\n   *\n   * @defaultValue `undefined` (unbounded)\n   */\n  maxBufferSize?: number | undefined\n}\n\n/**\n * A TransformStream that ingests a stream of strings and produces a stream of `EventSourceMessage`.\n *\n * @example Basic usage\n * ```\n * const eventStream =\n *   response.body\n *     .pipeThrough(new TextDecoderStream())\n *     .pipeThrough(new EventSourceParserStream())\n * ```\n *\n * @example Terminate stream on parsing errors\n * ```\n * const eventStream =\n *  response.body\n *   .pipeThrough(new TextDecoderStream())\n *   .pipeThrough(new EventSourceParserStream({onError: 'terminate'}))\n * ```\n *\n * @public\n */\nexport class EventSourceParserStream extends TransformStream<string, EventSourceMessage> {\n  constructor({onError, onRetry, onComment, maxBufferSize}: StreamOptions = {}) {\n    let parser!: EventSourceParser\n\n    super({\n      start(controller) {\n        parser = createParser({\n          onEvent: (event) => {\n            controller.enqueue(event)\n          },\n          onError(error) {\n            if (typeof onError === 'function') {\n              onError(error)\n            }\n\n            // `max-buffer-size-exceeded` is fatal — the parser is unusable until\n            // `reset()`, which the stream wrapper has no way to call. Always\n            // terminate the stream in that case so consumers see the meaningful\n            // `ParseError` instead of an opaque \"cannot feed terminated parser\"\n            // throw from the next chunk.\n            if (onError === 'terminate' || error.type === 'max-buffer-size-exceeded') {\n              controller.error(error)\n            }\n\n            // Ignore by default\n          },\n          onRetry,\n          onComment,\n          maxBufferSize,\n        })\n      },\n      transform(chunk) {\n        parser.feed(chunk)\n      },\n    })\n  }\n}\n\nexport {type ErrorType, ParseError} from './errors.ts'\nexport type {EventSourceMessage} from './types.ts'\n"],"names":[],"mappings":";;AAmEO,MAAM,gCAAgC,gBAA4C;AAAA,EACvF,YAAY,EAAC,SAAS,SAAS,WAAW,cAAA,IAAgC,IAAI;AAC5E,QAAI;AAEJ,UAAM;AAAA,MACJ,MAAM,YAAY;AAChB,iBAAS,aAAa;AAAA,UACpB,SAAS,CAAC,UAAU;AAClB,uBAAW,QAAQ,KAAK;AAAA,UAC1B;AAAA,UACA,QAAQ,OAAO;AACT,mBAAO,WAAY,cACrB,QAAQ,KAAK,IAQX,YAAY,eAAe,MAAM,SAAS,+BAC5C,WAAW,MAAM,KAAK;AAAA,UAI1B;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QAAA,CACD;AAAA,MACH;AAAA,MACA,UAAU,OAAO;AACf,eAAO,KAAK,KAAK;AAAA,MACnB;AAAA,IAAA,CACD;AAAA,EACH;AACF;"}

package/node_modules/eventsource-parser/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "eventsource-parser",
+  "version": "3.1.1",
+  "description": "Streaming, source-agnostic EventSource/Server-Sent Events parser",
+  "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",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./stream": {
+      "source": "./src/stream.ts",
+      "import": "./dist/stream.js",
+      "require": "./dist/stream.cjs",
+      "default": "./dist/stream.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "pkg-utils build && pkg-utils --strict",
+    "clean": "rimraf dist coverage",
+    "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",
+    "test": "npm run test:node",
+    "test:bun": "bun test",
+    "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"
+  },
+  "devDependencies": {
+    "@sanity/pkg-utils": "^10.4.18",
+    "@sanity/semantic-release-preset": "^6.0.0",
+    "@sanity/tsconfig": "^2.1.0",
+    "@types/node": "^20.19.0",
+    "eventsource-encoder": "^1.0.2",
+    "knip": "^6.7.0",
+    "mitata": "^1.0.34",
+    "oxfmt": "^0.47.0",
+    "oxlint": "^1.62.0",
+    "rimraf": "^6.1.3",
+    "rollup-plugin-visualizer": "^6.0.3",
+    "semantic-release": "^25.0.3",
+    "terser": "^5.46.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.5"
+  },
+  "browserslist": [
+    "node >= 18",
+    "chrome >= 71",
+    "safari >= 14.1",
+    "firefox >= 105",
+    "edge >= 79"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

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

@@ -0,0 +1,44 @@
+/**
+ * The type of error that occurred.
+ * @public
+ */
+export type ErrorType = 'invalid-retry' | 'unknown-field' | 'max-buffer-size-exceeded'
+
+/**
+ * Error thrown when encountering an issue during parsing.
+ *
+ * @public
+ */
+export class ParseError extends Error {
+  /**
+   * The type of error that occurred.
+   */
+  type: ErrorType
+
+  /**
+   * In the case of an unknown field encountered in the stream, this will be the field name.
+   */
+  field?: string | undefined
+
+  /**
+   * In the case of an unknown field encountered in the stream, this will be the value of the field.
+   */
+  value?: string | undefined
+
+  /**
+   * The line that caused the error, if available.
+   */
+  line?: string | undefined
+
+  constructor(
+    message: string,
+    options: {type: ErrorType; field?: string; value?: string; line?: string},
+  ) {
+    super(message)
+    this.name = 'ParseError'
+    this.type = options.type
+    this.field = options.field
+    this.value = options.value
+    this.line = options.line
+  }
+}

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

@@ -0,0 +1,8 @@
+export {type ErrorType, ParseError} from './errors.ts'
+export {createParser} from './parse.ts'
+export type {
+  EventSourceMessage,
+  EventSourceParser,
+  ParserCallbacks,
+  ParserConfig,
+} from './types.ts'