Use eventsource-parser to clean up the implemenation

Author: aron

index.js

@@ -45,17 +45,13 @@ class Replicate {
    * @param {string} options.userAgent - Identifier of your app
    * @param {string} [options.baseUrl] - Defaults to https://api.replicate.com/v1
    * @param {Function} [options.fetch] - Fetch function to use. Defaults to `globalThis.fetch`
-   * @param {Function} [options.EventSource] - Custom EventSource implementation function to use.
-   * @param {Function} [options.ReadableStream] - Custom ReadableStream implementation function to use.
    */
   constructor(options = {}) {
     this.auth = options.auth || process.env.REPLICATE_API_TOKEN;
     this.userAgent =
       options.userAgent || `replicate-javascript/${packageJSON.version}`;
     this.baseUrl = options.baseUrl || "https://api.replicate.com/v1";
     this.fetch = options.fetch || globalThis.fetch;
-    this.EventSource = options.EventSource;
-    this.ReadableStream = options.ReadableStream;
 
     this.accounts = {
       current: accounts.current.bind(this),
@@ -293,10 +289,9 @@ class Replicate {
 
     if (prediction.urls && prediction.urls.stream) {
       const { signal } = options;
-      const stream = await createReadableStream({
+      const stream = createReadableStream({
         url: prediction.urls.stream,
-        EventSource: this.EventSource,
-        ReadableStream: this.ReadableStream,
+        fetch: this.fetch,
         options: { signal },
       });
       yield* stream;

index.test.ts

@@ -7,7 +7,6 @@ import Replicate, {
   parseProgressFromLogs,
 } from "replicate";
 import nock from "nock";
-import fetch from "cross-fetch";
 import { createReadableStream } from "./lib/stream";
 import { PassThrough } from "node:stream";
 
@@ -23,7 +22,6 @@ describe("Replicate client", () => {
 
   beforeEach(() => {
     client = new Replicate({ auth: "test-token" });
-    client.fetch = fetch;
 
     unmatched = [];
     nock.emitter.on("no match", handleNoMatch);
@@ -1189,23 +1187,21 @@ describe("Replicate client", () => {
   // Continue with tests for other methods
 
   describe("createReadableStream", () => {
-    async function createStream(
-      body: string | NodeJS.ReadableStream,
-      status = 200
-    ) {
+    function createStream(body: string | NodeJS.ReadableStream, status = 200) {
       const streamEndpoint = "https://stream.replicate.com";
       nock(streamEndpoint)
         .get("/fake_stream")
         .matchHeader("Accept", "text/event-stream")
         .reply(status, body);
 
-      return await createReadableStream({
+      return createReadableStream({
         url: `${streamEndpoint}/fake_stream`,
+        fetch: fetch,
       });
     }
 
     test("consumes a server sent event stream", async () => {
-      const stream = await createStream(
+      const stream = createStream(
         `
         event: output
         id: EVENT_1
@@ -1232,7 +1228,7 @@ describe("Replicate client", () => {
     });
 
     test("consumes multiple events", async () => {
-      const stream = await createStream(
+      const stream = createStream(
         `
         event: output
         id: EVENT_1
@@ -1268,7 +1264,7 @@ describe("Replicate client", () => {
     });
 
     test("ignores unexpected characters", async () => {
-      const stream = await createStream(
+      const stream = createStream(
         `
         : hi
 
@@ -1298,7 +1294,7 @@ describe("Replicate client", () => {
     });
 
     test("supports multiple lines of output in a single event", async () => {
-      const stream = await createStream(
+      const stream = createStream(
         `
         : hi
 
@@ -1335,7 +1331,7 @@ describe("Replicate client", () => {
 
     test("supports the server writing data lines in multiple chunks", async () => {
       const body = new PassThrough();
-      const stream = await createStream(body);
+      const stream = createStream(body);
 
       // Create a stream of data chunks split on the pipe character for readability.
       const data = `
@@ -1391,7 +1387,7 @@ describe("Replicate client", () => {
 
     test("supports the server writing data in a complete mess", async () => {
       const body = new PassThrough();
-      const stream = await createStream(body);
+      const stream = createStream(body);
 
       // Create a stream of data chunks split on the pipe character for readability.
       const data = `
@@ -1448,7 +1444,7 @@ describe("Replicate client", () => {
     });
 
     test("supports ending without a done", async () => {
-      const stream = await createStream(
+      const stream = createStream(
         `
         event: output
         id: EVENT_1
@@ -1466,7 +1462,7 @@ describe("Replicate client", () => {
     });
 
     test("an error event in the stream raises an exception", async () => {
-      const stream = await createStream(
+      const stream = createStream(
         `
         event: output
         id: EVENT_1
@@ -1484,12 +1480,14 @@ describe("Replicate client", () => {
         done: false,
         value: { event: "output", id: "EVENT_1", data: "hello world" },
       });
-      await expect(iterator.next()).rejects.toThrowError("Unexpected Error");
+      await expect(iterator.next()).rejects.toThrowError(
+        "An unexpected error occurred"
+      );
       expect(await iterator.next()).toEqual({ done: true });
     });
 
     test("an error when fetching the stream raises an exception", async () => {
-      const stream = await createStream("{}", 500);
+      const stream = createStream("{}", 500);
       const iterator = stream[Symbol.asyncIterator]();
       await expect(iterator.next()).rejects.toThrowError(
         "Request to https://stream.replicate.com/fake_stream failed with status 500"

lib/stream.js

@@ -1,6 +1,7 @@
 // Attempt to use readable-stream if available, attempt to use the built-in stream module.
 
 const ApiError = require("./error");
+const { EventSourceParserStream } = require("eventsource-parser/stream");
 
 /**
  * A server-sent event.
@@ -38,87 +39,49 @@ class ServerSentEvent {
  *
  * @param {object} config
  * @param {string} config.url The URL to connect to.
- * @param {any} [config.EventSource] A standards compliant EventSource implementation.
- * @param {any} [config.ReadableStream] A standards compliant ReadableStream implementation.
+ * @param {typeof fetch} [config.fetch] The URL to connect to.
  * @param {object} [config.options] The EventSource options.
- * @returns {Promise<ReadableStream & AsyncIterable<ServerSentEvent>>}
+ * @returns {ReadableStream<ServerSentEvent> & AsyncIterable<ServerSentEvent>}
  */
-async function createReadableStream({
-  url,
-  EventSource = globalThis.EventSource,
-  ReadableStream = globalThis.ReadableStream,
-  options = {},
-}) {
-  const EventSourceClass = EventSource
-    ? EventSource
-    : (await import("eventsource")).default;
-  const source = new EventSourceClass(url, options);
-
-  const stream = new ReadableStream({
-    cancel() {
-      source.close();
-    },
-
+function createReadableStream({ url, fetch, options = {} }) {
+  return new ReadableStream({
     async start(controller) {
-      return new Promise((resolve) => {
-        source.addEventListener("output", (evt) => {
-          const entry = new ServerSentEvent(
-            evt.type,
-            evt.data,
-            evt.lastEventId
-          );
-          controller.enqueue(entry);
-        });
-
-        source.addEventListener("done", (evt) => {
-          const entry = new ServerSentEvent(
-            evt.type,
-            evt.data,
-            evt.lastEventId
-          );
-          controller.enqueue(entry);
-          source.close();
-          controller.close();
-        });
+      const init = {
+        ...options,
+        headers: {
+          ...options.headers,
+          Accept: "text/event-stream",
+        },
+      };
+      const response = await fetch(url, init);
 
-        source.addEventListener("open", (_evt) => {
-          resolve();
-        });
+      if (!response.ok) {
+        const text = await response.text();
+        const request = new Request(url, init);
+        controller.error(
+          new ApiError(
+            `Request to ${url} failed with status ${response.status}`,
+            request,
+            response
+          )
+        );
+      }
 
-        source.addEventListener("error", (evt) => {
-          // HTTP Error
-          if (typeof evt.status === "number") {
-            source.close();
-            controller.error(
-              new ApiError(
-                `Request to ${url} failed with status ${evt.status} ${
-                  evt.message ?? ""
-                }`.trim()
-              )
-            );
-            return;
-          }
-
-          // Connection closed
-          if (!evt.message && source.readyState === 0) {
-            controller.close();
-            source.close();
-            return;
-          }
-
-          // Other
-          source.close();
-          controller.error(new Error(evt.message ?? "Unexpected Error"));
-        });
-
-        options.signal?.addEventListener("abort", () => {
-          source.close();
-        });
-      });
+      const stream = response.body
+        .pipeThrough(new TextDecoderStream())
+        .pipeThrough(new EventSourceParserStream());
+      for await (const event of stream) {
+        if (event.event === "error") {
+          controller.error(new Error(event.data));
+        } else {
+          controller.enqueue(
+            new ServerSentEvent(event.event, event.data, event.id)
+          );
+        }
+      }
+      controller.close();
     },
   });
-
-  return stream;
 }
 
 module.exports = {

package.json

@@ -30,7 +30,7 @@
     "lint-biome": "biome lint .",
     "lint-publint": "publint",
     "lint": "npm run lint-biome && npm run lint-publint",
-    "test": "NODE_OPTIONS=\"$NODE_OPTIONS --experimental-vm-modules\" jest"
+    "test": "jest"
   },
   "optionalDependencies": {
     "readable-stream": ">=4.0.0"