@glamboyosa/ore 0.0.4 → 1.0.0

package/dist/index.d.mts

@@ -1,16 +1,32 @@
 interface OreOptions {
-    url: string;
     headers?: HeadersInit;
+    retries?: number;
+    signal?: AbortSignal;
 }
-declare class Ore {
-    private url;
-    private headers?;
-    private streamEnded;
-    private retryCount;
-    private maxRetries;
-    constructor(options: OreOptions);
-    fetchSSE(onBufferReceived: (buffer: string, parts: Array<string>) => void, onStreamEnded?: (streamEnded: boolean) => void, customHeaders?: HeadersInit, retries?: number): void;
-    fetchSSEForRSC(customHeaders?: HeadersInit, retries?: number): Promise<ReadableStream<Uint8Array> | null | undefined>;
+interface SSEEvent {
+    id: string | null;
+    event: string | null;
+    data: string;
+    retry?: number;
 }
+interface StreamOptions extends OreOptions {
+    decode?: boolean;
+}
+/**
+ * Fetches a stream from a URL and yields raw chunks.
+ * Handles connection retries.
+ *
+ * @param url - The URL to stream from
+ * @param options - Configuration options
+ */
+declare function stream(url: string, options?: StreamOptions): AsyncGenerator<string | Uint8Array, void, unknown>;
+/**
+ * Fetches a stream and parses it as Server-Sent Events (SSE).
+ * Handles 'data', 'event', 'id', 'retry' fields and automatic reconnection.
+ *
+ * @param url - The URL to stream from
+ * @param options - Configuration options
+ */
+declare function streamSSE(url: string, options?: OreOptions): AsyncGenerator<SSEEvent, void, unknown>;
 
-export { Ore, type OreOptions };
+export { type OreOptions, type SSEEvent, type StreamOptions, stream, streamSSE };

package/dist/index.d.ts

@@ -1,16 +1,32 @@
 interface OreOptions {
-    url: string;
     headers?: HeadersInit;
+    retries?: number;
+    signal?: AbortSignal;
 }
-declare class Ore {
-    private url;
-    private headers?;
-    private streamEnded;
-    private retryCount;
-    private maxRetries;
-    constructor(options: OreOptions);
-    fetchSSE(onBufferReceived: (buffer: string, parts: Array<string>) => void, onStreamEnded?: (streamEnded: boolean) => void, customHeaders?: HeadersInit, retries?: number): void;
-    fetchSSEForRSC(customHeaders?: HeadersInit, retries?: number): Promise<ReadableStream<Uint8Array> | null | undefined>;
+interface SSEEvent {
+    id: string | null;
+    event: string | null;
+    data: string;
+    retry?: number;
 }
+interface StreamOptions extends OreOptions {
+    decode?: boolean;
+}
+/**
+ * Fetches a stream from a URL and yields raw chunks.
+ * Handles connection retries.
+ *
+ * @param url - The URL to stream from
+ * @param options - Configuration options
+ */
+declare function stream(url: string, options?: StreamOptions): AsyncGenerator<string | Uint8Array, void, unknown>;
+/**
+ * Fetches a stream and parses it as Server-Sent Events (SSE).
+ * Handles 'data', 'event', 'id', 'retry' fields and automatic reconnection.
+ *
+ * @param url - The URL to stream from
+ * @param options - Configuration options
+ */
+declare function streamSSE(url: string, options?: OreOptions): AsyncGenerator<SSEEvent, void, unknown>;
 
-export { Ore, type OreOptions };
+export { type OreOptions, type SSEEvent, type StreamOptions, stream, streamSSE };

package/dist/index.js

@@ -18,120 +18,191 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  Ore: () => Ore
+var index_exports = {};
+__export(index_exports, {
+  stream: () => stream,
+  streamSSE: () => streamSSE
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/client.ts
-var Ore = class {
-  url;
-  headers;
-  streamEnded = false;
-  retryCount = 0;
-  maxRetries = 3;
-  constructor(options) {
-    this.url = options.url;
-    this.headers = options.headers ? {
-      "Content-Type": "text/event-stream",
-      "Cache-Control": "no-cache",
-      Connection: "keep-alive",
-      ...options.headers
-    } : {
-      "Content-Type": "text/event-stream",
-      "Cache-Control": "no-cache",
-      Connection: "keep-alive"
-    };
-  }
-  fetchSSE(onBufferReceived, onStreamEnded, customHeaders, retries = this.maxRetries) {
-    const headers = { ...this.headers, ...customHeaders };
-    const fetchWithRetry = async () => {
-      try {
-        const response = await fetch(this.url, {
-          method: "GET",
-          headers
-        });
-        if (!response.ok) {
-          throw new Error("Failed to connect to SSE endpoint");
+async function* stream(url, options) {
+  const {
+    headers,
+    retries = 3,
+    signal,
+    decode = true
+  } = options || {};
+  const fetchHeaders = {
+    "Cache-Control": "no-cache",
+    "Connection": "keep-alive",
+    ...headers
+  };
+  let retryCount = 0;
+  while (retryCount <= retries) {
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: fetchHeaders,
+        signal
+      });
+      if (!response.ok) {
+        if (response.status >= 400 && response.status < 500) {
+          throw new Error(`Client Error: ${response.status} ${response.statusText}`);
         }
-        this.retryCount = 0;
-        const reader = response.body?.getReader();
-        const decoder = new TextDecoder("utf-8");
-        let buffer = "";
-        const processText = ({ done, value }) => {
-          if (done) {
-            this.streamEnded = true;
-            if (onStreamEnded) {
-              onStreamEnded(this.streamEnded);
-            }
-            return;
-          }
-          buffer += decoder.decode(value, { stream: true });
-          const parts = buffer.split("\n\n");
-          onBufferReceived(buffer, parts);
-          return reader.read().then(processText);
-        };
-        reader?.read().then(processText).catch((error) => {
-          if (this.retryCount < retries) {
-            console.error("Error:", error);
-            console.log("Retrying...");
-            this.retryCount++;
-            setTimeout(fetchWithRetry, 1e3);
+        throw new Error(`Server Error: ${response.status} ${response.statusText}`);
+      }
+      if (!response.body) {
+        throw new Error("Response body is null");
+      }
+      const reader = response.body.getReader();
+      const decoder = new TextDecoder();
+      try {
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          if (decode) {
+            yield decoder.decode(value, { stream: true });
           } else {
-            console.error("Max retries exceeded. Cannot establish SSE connection.");
-            this.streamEnded = true;
-            if (onStreamEnded) {
-              onStreamEnded(this.streamEnded);
-            }
-          }
-        });
-      } catch (error) {
-        if (this.retryCount < retries) {
-          console.error("Error:", error);
-          console.log("Retrying...");
-          this.retryCount++;
-          setTimeout(fetchWithRetry, 1e3);
-        } else {
-          console.error("Max retries exceeded. Cannot establish SSE connection.");
-          this.streamEnded = true;
-          if (onStreamEnded) {
-            onStreamEnded(this.streamEnded);
+            yield value;
           }
         }
+      } finally {
+        reader.releaseLock();
       }
-    };
-    fetchWithRetry();
+      return;
+    } catch (error) {
+      if (signal?.aborted) {
+        throw error;
+      }
+      console.error("Stream error:", error);
+      retryCount++;
+      if (retryCount > retries) {
+        throw new Error(`Max retries (${retries}) exceeded. Last error: ${error.message || error}`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, 1e3 * retryCount));
+    }
   }
-  async fetchSSEForRSC(customHeaders, retries = this.maxRetries) {
-    const headers = { ...this.headers, ...customHeaders };
+}
+async function* streamSSE(url, options) {
+  const {
+    headers: customHeaders,
+    retries = 3,
+    signal
+  } = options || {};
+  let lastEventId = null;
+  let retryCount = 0;
+  let retryInterval = 1e3;
+  while (retryCount <= retries) {
     try {
-      const { signal } = new AbortController();
-      const response = await fetch(this.url, {
+      const headers = {
+        "Cache-Control": "no-cache",
+        "Connection": "keep-alive",
+        ...customHeaders
+      };
+      if (lastEventId) {
+        headers["Last-Event-ID"] = lastEventId;
+      }
+      const response = await fetch(url, {
         method: "GET",
         headers,
-        cache: "no-store",
         signal
       });
       if (!response.ok) {
-        throw new Error("Failed to connect to SSE endpoint");
+        if (response.status === 204) return;
+        if (response.status >= 400 && response.status < 500) {
+          throw new Error(`Client Error: ${response.status} ${response.statusText}`);
+        }
+        throw new Error(`Failed to connect: ${response.status} ${response.statusText}`);
       }
-      this.retryCount = 0;
-      return response.body;
+      if (!response.body) throw new Error("Response body is null");
+      const reader = response.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+      let currentEvent = { data: "", event: null, id: null };
+      let hasData = false;
+      try {
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          buffer += decoder.decode(value, { stream: true });
+          const lines = buffer.split(/\r\n|\r|\n/);
+          buffer = lines.pop() || "";
+          for (const line of lines) {
+            if (line === "") {
+              if (hasData) {
+                let data = currentEvent.data;
+                if (data.endsWith("\n")) {
+                  data = data.slice(0, -1);
+                }
+                const event = {
+                  id: currentEvent.id ?? lastEventId,
+                  event: currentEvent.event ?? null,
+                  data,
+                  retry: currentEvent.retry
+                };
+                if (event.id) lastEventId = event.id;
+                yield event;
+                currentEvent = { data: "", event: null, id: null };
+                hasData = false;
+              }
+              continue;
+            }
+            if (line.startsWith(":")) continue;
+            const colonIndex = line.indexOf(":");
+            let field = "";
+            let valueStr = "";
+            if (colonIndex === -1) {
+              field = line;
+              valueStr = "";
+            } else {
+              field = line.slice(0, colonIndex);
+              valueStr = line.slice(colonIndex + 1);
+              if (valueStr.startsWith(" ")) valueStr = valueStr.slice(1);
+            }
+            switch (field) {
+              case "data":
+                currentEvent.data += valueStr + "\n";
+                hasData = true;
+                break;
+              case "event":
+                currentEvent.event = valueStr;
+                break;
+              case "id":
+                if (valueStr.indexOf("\0") === -1) {
+                  currentEvent.id = valueStr;
+                }
+                break;
+              case "retry":
+                const retry = parseInt(valueStr, 10);
+                if (!isNaN(retry)) {
+                  retryInterval = retry;
+                  currentEvent.retry = retry;
+                }
+                break;
+            }
+          }
+        }
+      } finally {
+        reader.releaseLock();
+      }
+      console.log("Stream closed by server, reconnecting...");
+      retryCount++;
+      await new Promise((r) => setTimeout(r, retryInterval));
     } catch (error) {
-      if (this.retryCount < retries) {
-        console.error("Error:", error);
-        console.log("Retrying...");
-        this.retryCount++;
-        setTimeout(() => this.fetchSSEForRSC(customHeaders, retries), 1e3);
-      } else {
-        console.error("Max retries exceeded. Cannot establish SSE connection.");
+      if (signal?.aborted) throw error;
+      console.error("SSE error:", error);
+      retryCount++;
+      if (retryCount > retries) {
+        throw new Error(`Max retries exceeded. Last error: ${error.message}`);
       }
+      await new Promise((r) => setTimeout(r, retryInterval));
     }
   }
-};
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  Ore
+  stream,
+  streamSSE
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["export * from \"./client\";\n","interface OreOptions {\n  url: string;\n  headers?: HeadersInit;\n}\n\nclass Ore {\n  private url: string;\n  private headers?: HeadersInit;\n  private streamEnded = false;\n  private retryCount = 0;\n  private maxRetries = 3;\n\n  constructor(options: OreOptions) {\n    this.url = options.url;\n    this.headers = options.headers\n      ? {\n          \"Content-Type\": \"text/event-stream\",\n          \"Cache-Control\": \"no-cache\",\n          Connection: \"keep-alive\",\n          ...options.headers,\n        }\n      : {\n          \"Content-Type\": \"text/event-stream\",\n          \"Cache-Control\": \"no-cache\",\n          Connection: \"keep-alive\",\n        };\n  }\n\n  public fetchSSE(\n    onBufferReceived: (buffer: string, parts: Array<string>) => void,\n    onStreamEnded?: (streamEnded: boolean) => void,\n    customHeaders?: HeadersInit,\n    retries: number = this.maxRetries,\n  ): void {\n    const headers = { ...this.headers, ...customHeaders };\n\n    const fetchWithRetry = async (): Promise<void> => {\n      try {\n        const response = await fetch(this.url, {\n          method: \"GET\",\n          headers: headers,\n        });\n\n        if (!response.ok) {\n          throw new Error(\"Failed to connect to SSE endpoint\");\n        }\n\n        this.retryCount = 0;\n\n        const reader = response.body?.getReader();\n        const decoder = new TextDecoder(\"utf-8\");\n        let buffer = \"\";\n        const processText = ({ done, value }: ReadableStreamReadResult<Uint8Array>): any => {\n          if (done) {\n            this.streamEnded = true;\n            if (onStreamEnded) {\n              onStreamEnded(this.streamEnded);\n            }\n            return;\n          }\n\n          buffer += decoder.decode(value, { stream: true });\n\n          const parts = buffer.split(\"\\n\\n\");\n\n          onBufferReceived(buffer, parts);\n\n          return reader!.read().then(processText);\n        };\n        reader\n          ?.read()\n          .then(processText)\n          .catch((error) => {\n            if (this.retryCount < retries) {\n              console.error(\"Error:\", error);\n              console.log(\"Retrying...\");\n              this.retryCount++;\n              setTimeout(fetchWithRetry, 1000);\n            } else {\n              console.error(\"Max retries exceeded. Cannot establish SSE connection.\");\n              this.streamEnded = true;\n              if (onStreamEnded) {\n                onStreamEnded(this.streamEnded);\n              }\n            }\n          });\n      } catch (error) {\n        if (this.retryCount < retries) {\n          console.error(\"Error:\", error);\n          console.log(\"Retrying...\");\n          this.retryCount++;\n          setTimeout(fetchWithRetry, 1000);\n        } else {\n          console.error(\"Max retries exceeded. Cannot establish SSE connection.\");\n          this.streamEnded = true;\n          if (onStreamEnded) {\n            onStreamEnded(this.streamEnded);\n          }\n        }\n      }\n    };\n\n    fetchWithRetry();\n  }\n  public async fetchSSEForRSC(customHeaders?: HeadersInit, retries: number = this.maxRetries) {\n    const headers = { ...this.headers, ...customHeaders };\n\n    try {\n      const { signal } = new AbortController();\n      const response = await fetch(this.url, {\n        method: \"GET\",\n        headers: headers,\n        cache: \"no-store\",\n        signal,\n      });\n\n      if (!response.ok) {\n        throw new Error(\"Failed to connect to SSE endpoint\");\n      }\n\n      this.retryCount = 0;\n\n      return response.body;\n    } catch (error) {\n      if (this.retryCount < retries) {\n        console.error(\"Error:\", error);\n        console.log(\"Retrying...\");\n        this.retryCount++;\n        setTimeout(() => this.fetchSSEForRSC(customHeaders, retries), 1000);\n      } else {\n        console.error(\"Max retries exceeded. Cannot establish SSE connection.\");\n      }\n    }\n  }\n}\n\nexport { Ore, type OreOptions };\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["export * from \"./client\";\n","\nexport interface OreOptions {\n  headers?: HeadersInit;\n  retries?: number;\n  signal?: AbortSignal;\n}\n\nexport interface SSEEvent {\n  id: string | null;\n  event: string | null;\n  data: string;\n  retry?: number;\n}\n\nexport interface StreamOptions extends OreOptions {\n  decode?: boolean;\n}\n\n/**\n * Fetches a stream from a URL and yields raw chunks.\n * Handles connection retries.\n * \n * @param url - The URL to stream from\n * @param options - Configuration options\n */\nexport async function* stream(\n  url: string, \n  options?: StreamOptions\n): AsyncGenerator<string | Uint8Array, void, unknown> {\n  const { \n    headers, \n    retries = 3, \n    signal, \n    decode = true \n  } = options || {};\n\n  const fetchHeaders = {\n    \"Cache-Control\": \"no-cache\",\n    \"Connection\": \"keep-alive\",\n    ...headers,\n  };\n\n  let retryCount = 0;\n\n  while (retryCount <= retries) {\n    try {\n      const response = await fetch(url, {\n        method: \"GET\",\n        headers: fetchHeaders,\n        signal,\n      });\n\n      if (!response.ok) {\n        if (response.status >= 400 && response.status < 500) {\n          throw new Error(`Client Error: ${response.status} ${response.statusText}`);\n        }\n        throw new Error(`Server Error: ${response.status} ${response.statusText}`);\n      }\n\n      if (!response.body) {\n        throw new Error(\"Response body is null\");\n      }\n\n      const reader = response.body.getReader();\n      const decoder = new TextDecoder();\n\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) break;\n          \n          if (decode) {\n            yield decoder.decode(value, { stream: true });\n          } else {\n            yield value;\n          }\n        }\n      } finally {\n        reader.releaseLock();\n      }\n\n      return; // Stream completed successfully\n    } catch (error: any) {\n      if (signal?.aborted) {\n        throw error;\n      }\n      \n      console.error(\"Stream error:\", error);\n      retryCount++;\n      \n      if (retryCount > retries) {\n        throw new Error(`Max retries (${retries}) exceeded. Last error: ${error.message || error}`);\n      }\n      \n      await new Promise((resolve) => setTimeout(resolve, 1000 * retryCount));\n    }\n  }\n}\n\n/**\n * Fetches a stream and parses it as Server-Sent Events (SSE).\n * Handles 'data', 'event', 'id', 'retry' fields and automatic reconnection.\n * \n * @param url - The URL to stream from\n * @param options - Configuration options\n */\nexport async function* streamSSE(\n  url: string, \n  options?: OreOptions\n): AsyncGenerator<SSEEvent, void, unknown> {\n  const { \n    headers: customHeaders, \n    retries = 3, \n    signal \n  } = options || {};\n\n  let lastEventId: string | null = null;\n  let retryCount = 0;\n  let retryInterval = 1000;\n\n  while (retryCount <= retries) {\n    try {\n      const headers = { \n        \"Cache-Control\": \"no-cache\",\n        \"Connection\": \"keep-alive\",\n        ...customHeaders \n      };\n      \n      if (lastEventId) {\n        (headers as any)[\"Last-Event-ID\"] = lastEventId;\n      }\n\n      const response = await fetch(url, {\n        method: \"GET\",\n        headers,\n        signal,\n      });\n\n      if (!response.ok) {\n         if (response.status === 204) return; // No Content -> End of stream\n         if (response.status >= 400 && response.status < 500) {\n           throw new Error(`Client Error: ${response.status} ${response.statusText}`);\n         }\n         throw new Error(`Failed to connect: ${response.status} ${response.statusText}`);\n      }\n      \n      if (!response.body) throw new Error(\"Response body is null\");\n\n      const reader = response.body.getReader();\n      const decoder = new TextDecoder();\n      \n      let buffer = \"\";\n      \n      // State machine for event parsing\n      let currentEvent: Partial<SSEEvent> = { data: \"\", event: null, id: null };\n      let hasData = false;\n\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) break;\n          \n          buffer += decoder.decode(value, { stream: true });\n          \n          const lines = buffer.split(/\\r\\n|\\r|\\n/);\n          buffer = lines.pop() || \"\"; // Keep last incomplete line\n\n          for (const line of lines) {\n            if (line === \"\") {\n              if (hasData) {\n                 let data = currentEvent.data!;\n                 if (data.endsWith(\"\\n\")) {\n                    data = data.slice(0, -1);\n                 }\n                 \n                 const event: SSEEvent = {\n                   id: currentEvent.id ?? lastEventId,\n                   event: currentEvent.event ?? null,\n                   data: data,\n                   retry: currentEvent.retry\n                 };\n                 \n                 if (event.id) lastEventId = event.id;\n                 \n                 yield event;\n                 \n                 currentEvent = { data: \"\", event: null, id: null };\n                 hasData = false;\n              }\n              continue;\n            }\n\n            if (line.startsWith(\":\")) continue;\n\n            const colonIndex = line.indexOf(\":\");\n            let field = \"\";\n            let valueStr = \"\";\n\n            if (colonIndex === -1) {\n              field = line;\n              valueStr = \"\";\n            } else {\n              field = line.slice(0, colonIndex);\n              valueStr = line.slice(colonIndex + 1);\n              if (valueStr.startsWith(\" \")) valueStr = valueStr.slice(1);\n            }\n\n            switch (field) {\n              case \"data\":\n                currentEvent.data += valueStr + \"\\n\";\n                hasData = true;\n                break;\n              case \"event\":\n                currentEvent.event = valueStr;\n                break;\n              case \"id\":\n                if (valueStr.indexOf(\"\\0\") === -1) {\n                  currentEvent.id = valueStr;\n                }\n                break;\n              case \"retry\":\n                const retry = parseInt(valueStr, 10);\n                if (!isNaN(retry)) {\n                  retryInterval = retry;\n                  currentEvent.retry = retry;\n                }\n                break;\n            }\n          }\n        }\n      } finally {\n         reader.releaseLock();\n      }\n\n      console.log(\"Stream closed by server, reconnecting...\");\n      retryCount++;\n      await new Promise(r => setTimeout(r, retryInterval));\n\n    } catch (error: any) {\n      if (signal?.aborted) throw error;\n      \n      console.error(\"SSE error:\", error);\n      retryCount++;\n      if (retryCount > retries) {\n         throw new Error(`Max retries exceeded. Last error: ${error.message}`);\n      }\n      await new Promise(r => setTimeout(r, retryInterval));\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -1,110 +1,180 @@
 // src/client.ts
-var Ore = class {
-  url;
-  headers;
-  streamEnded = false;
-  retryCount = 0;
-  maxRetries = 3;
-  constructor(options) {
-    this.url = options.url;
-    this.headers = options.headers ? {
-      "Content-Type": "text/event-stream",
-      "Cache-Control": "no-cache",
-      Connection: "keep-alive",
-      ...options.headers
-    } : {
-      "Content-Type": "text/event-stream",
-      "Cache-Control": "no-cache",
-      Connection: "keep-alive"
-    };
-  }
-  fetchSSE(onBufferReceived, onStreamEnded, customHeaders, retries = this.maxRetries) {
-    const headers = { ...this.headers, ...customHeaders };
-    const fetchWithRetry = async () => {
-      try {
-        const response = await fetch(this.url, {
-          method: "GET",
-          headers
-        });
-        if (!response.ok) {
-          throw new Error("Failed to connect to SSE endpoint");
+async function* stream(url, options) {
+  const {
+    headers,
+    retries = 3,
+    signal,
+    decode = true
+  } = options || {};
+  const fetchHeaders = {
+    "Cache-Control": "no-cache",
+    "Connection": "keep-alive",
+    ...headers
+  };
+  let retryCount = 0;
+  while (retryCount <= retries) {
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: fetchHeaders,
+        signal
+      });
+      if (!response.ok) {
+        if (response.status >= 400 && response.status < 500) {
+          throw new Error(`Client Error: ${response.status} ${response.statusText}`);
         }
-        this.retryCount = 0;
-        const reader = response.body?.getReader();
-        const decoder = new TextDecoder("utf-8");
-        let buffer = "";
-        const processText = ({ done, value }) => {
-          if (done) {
-            this.streamEnded = true;
-            if (onStreamEnded) {
-              onStreamEnded(this.streamEnded);
-            }
-            return;
-          }
-          buffer += decoder.decode(value, { stream: true });
-          const parts = buffer.split("\n\n");
-          onBufferReceived(buffer, parts);
-          return reader.read().then(processText);
-        };
-        reader?.read().then(processText).catch((error) => {
-          if (this.retryCount < retries) {
-            console.error("Error:", error);
-            console.log("Retrying...");
-            this.retryCount++;
-            setTimeout(fetchWithRetry, 1e3);
+        throw new Error(`Server Error: ${response.status} ${response.statusText}`);
+      }
+      if (!response.body) {
+        throw new Error("Response body is null");
+      }
+      const reader = response.body.getReader();
+      const decoder = new TextDecoder();
+      try {
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          if (decode) {
+            yield decoder.decode(value, { stream: true });
           } else {
-            console.error("Max retries exceeded. Cannot establish SSE connection.");
-            this.streamEnded = true;
-            if (onStreamEnded) {
-              onStreamEnded(this.streamEnded);
-            }
-          }
-        });
-      } catch (error) {
-        if (this.retryCount < retries) {
-          console.error("Error:", error);
-          console.log("Retrying...");
-          this.retryCount++;
-          setTimeout(fetchWithRetry, 1e3);
-        } else {
-          console.error("Max retries exceeded. Cannot establish SSE connection.");
-          this.streamEnded = true;
-          if (onStreamEnded) {
-            onStreamEnded(this.streamEnded);
+            yield value;
           }
         }
+      } finally {
+        reader.releaseLock();
       }
-    };
-    fetchWithRetry();
+      return;
+    } catch (error) {
+      if (signal?.aborted) {
+        throw error;
+      }
+      console.error("Stream error:", error);
+      retryCount++;
+      if (retryCount > retries) {
+        throw new Error(`Max retries (${retries}) exceeded. Last error: ${error.message || error}`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, 1e3 * retryCount));
+    }
   }
-  async fetchSSEForRSC(customHeaders, retries = this.maxRetries) {
-    const headers = { ...this.headers, ...customHeaders };
+}
+async function* streamSSE(url, options) {
+  const {
+    headers: customHeaders,
+    retries = 3,
+    signal
+  } = options || {};
+  let lastEventId = null;
+  let retryCount = 0;
+  let retryInterval = 1e3;
+  while (retryCount <= retries) {
     try {
-      const { signal } = new AbortController();
-      const response = await fetch(this.url, {
+      const headers = {
+        "Cache-Control": "no-cache",
+        "Connection": "keep-alive",
+        ...customHeaders
+      };
+      if (lastEventId) {
+        headers["Last-Event-ID"] = lastEventId;
+      }
+      const response = await fetch(url, {
         method: "GET",
         headers,
-        cache: "no-store",
         signal
       });
       if (!response.ok) {
-        throw new Error("Failed to connect to SSE endpoint");
+        if (response.status === 204) return;
+        if (response.status >= 400 && response.status < 500) {
+          throw new Error(`Client Error: ${response.status} ${response.statusText}`);
+        }
+        throw new Error(`Failed to connect: ${response.status} ${response.statusText}`);
       }
-      this.retryCount = 0;
-      return response.body;
+      if (!response.body) throw new Error("Response body is null");
+      const reader = response.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+      let currentEvent = { data: "", event: null, id: null };
+      let hasData = false;
+      try {
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          buffer += decoder.decode(value, { stream: true });
+          const lines = buffer.split(/\r\n|\r|\n/);
+          buffer = lines.pop() || "";
+          for (const line of lines) {
+            if (line === "") {
+              if (hasData) {
+                let data = currentEvent.data;
+                if (data.endsWith("\n")) {
+                  data = data.slice(0, -1);
+                }
+                const event = {
+                  id: currentEvent.id ?? lastEventId,
+                  event: currentEvent.event ?? null,
+                  data,
+                  retry: currentEvent.retry
+                };
+                if (event.id) lastEventId = event.id;
+                yield event;
+                currentEvent = { data: "", event: null, id: null };
+                hasData = false;
+              }
+              continue;
+            }
+            if (line.startsWith(":")) continue;
+            const colonIndex = line.indexOf(":");
+            let field = "";
+            let valueStr = "";
+            if (colonIndex === -1) {
+              field = line;
+              valueStr = "";
+            } else {
+              field = line.slice(0, colonIndex);
+              valueStr = line.slice(colonIndex + 1);
+              if (valueStr.startsWith(" ")) valueStr = valueStr.slice(1);
+            }
+            switch (field) {
+              case "data":
+                currentEvent.data += valueStr + "\n";
+                hasData = true;
+                break;
+              case "event":
+                currentEvent.event = valueStr;
+                break;
+              case "id":
+                if (valueStr.indexOf("\0") === -1) {
+                  currentEvent.id = valueStr;
+                }
+                break;
+              case "retry":
+                const retry = parseInt(valueStr, 10);
+                if (!isNaN(retry)) {
+                  retryInterval = retry;
+                  currentEvent.retry = retry;
+                }
+                break;
+            }
+          }
+        }
+      } finally {
+        reader.releaseLock();
+      }
+      console.log("Stream closed by server, reconnecting...");
+      retryCount++;
+      await new Promise((r) => setTimeout(r, retryInterval));
     } catch (error) {
-      if (this.retryCount < retries) {
-        console.error("Error:", error);
-        console.log("Retrying...");
-        this.retryCount++;
-        setTimeout(() => this.fetchSSEForRSC(customHeaders, retries), 1e3);
-      } else {
-        console.error("Max retries exceeded. Cannot establish SSE connection.");
+      if (signal?.aborted) throw error;
+      console.error("SSE error:", error);
+      retryCount++;
+      if (retryCount > retries) {
+        throw new Error(`Max retries exceeded. Last error: ${error.message}`);
       }
+      await new Promise((r) => setTimeout(r, retryInterval));
     }
   }
-};
+}
 export {
-  Ore
+  stream,
+  streamSSE
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["interface OreOptions {\n  url: string;\n  headers?: HeadersInit;\n}\n\nclass Ore {\n  private url: string;\n  private headers?: HeadersInit;\n  private streamEnded = false;\n  private retryCount = 0;\n  private maxRetries = 3;\n\n  constructor(options: OreOptions) {\n    this.url = options.url;\n    this.headers = options.headers\n      ? {\n          \"Content-Type\": \"text/event-stream\",\n          \"Cache-Control\": \"no-cache\",\n          Connection: \"keep-alive\",\n          ...options.headers,\n        }\n      : {\n          \"Content-Type\": \"text/event-stream\",\n          \"Cache-Control\": \"no-cache\",\n          Connection: \"keep-alive\",\n        };\n  }\n\n  public fetchSSE(\n    onBufferReceived: (buffer: string, parts: Array<string>) => void,\n    onStreamEnded?: (streamEnded: boolean) => void,\n    customHeaders?: HeadersInit,\n    retries: number = this.maxRetries,\n  ): void {\n    const headers = { ...this.headers, ...customHeaders };\n\n    const fetchWithRetry = async (): Promise<void> => {\n      try {\n        const response = await fetch(this.url, {\n          method: \"GET\",\n          headers: headers,\n        });\n\n        if (!response.ok) {\n          throw new Error(\"Failed to connect to SSE endpoint\");\n        }\n\n        this.retryCount = 0;\n\n        const reader = response.body?.getReader();\n        const decoder = new TextDecoder(\"utf-8\");\n        let buffer = \"\";\n        const processText = ({ done, value }: ReadableStreamReadResult<Uint8Array>): any => {\n          if (done) {\n            this.streamEnded = true;\n            if (onStreamEnded) {\n              onStreamEnded(this.streamEnded);\n            }\n            return;\n          }\n\n          buffer += decoder.decode(value, { stream: true });\n\n          const parts = buffer.split(\"\\n\\n\");\n\n          onBufferReceived(buffer, parts);\n\n          return reader!.read().then(processText);\n        };\n        reader\n          ?.read()\n          .then(processText)\n          .catch((error) => {\n            if (this.retryCount < retries) {\n              console.error(\"Error:\", error);\n              console.log(\"Retrying...\");\n              this.retryCount++;\n              setTimeout(fetchWithRetry, 1000);\n            } else {\n              console.error(\"Max retries exceeded. Cannot establish SSE connection.\");\n              this.streamEnded = true;\n              if (onStreamEnded) {\n                onStreamEnded(this.streamEnded);\n              }\n            }\n          });\n      } catch (error) {\n        if (this.retryCount < retries) {\n          console.error(\"Error:\", error);\n          console.log(\"Retrying...\");\n          this.retryCount++;\n          setTimeout(fetchWithRetry, 1000);\n        } else {\n          console.error(\"Max retries exceeded. Cannot establish SSE connection.\");\n          this.streamEnded = true;\n          if (onStreamEnded) {\n            onStreamEnded(this.streamEnded);\n          }\n        }\n      }\n    };\n\n    fetchWithRetry();\n  }\n  public async fetchSSEForRSC(customHeaders?: HeadersInit, retries: number = this.maxRetries) {\n    const headers = { ...this.headers, ...customHeaders };\n\n    try {\n      const { signal } = new AbortController();\n      const response = await fetch(this.url, {\n        method: \"GET\",\n        headers: headers,\n        cache: \"no-store\",\n        signal,\n      });\n\n      if (!response.ok) {\n        throw new Error(\"Failed to connect to SSE endpoint\");\n      }\n\n      this.retryCount = 0;\n\n      return response.body;\n    } catch (error) {\n      if (this.retryCount < retries) {\n        console.error(\"Error:\", error);\n        console.log(\"Retrying...\");\n        this.retryCount++;\n        setTimeout(() => this.fetchSSEForRSC(customHeaders, retries), 1000);\n      } else {\n        console.error(\"Max retries exceeded. Cannot establish SSE connection.\");\n      }\n    }\n  }\n}\n\nexport { Ore, type OreOptions };\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["\nexport interface OreOptions {\n  headers?: HeadersInit;\n  retries?: number;\n  signal?: AbortSignal;\n}\n\nexport interface SSEEvent {\n  id: string | null;\n  event: string | null;\n  data: string;\n  retry?: number;\n}\n\nexport interface StreamOptions extends OreOptions {\n  decode?: boolean;\n}\n\n/**\n * Fetches a stream from a URL and yields raw chunks.\n * Handles connection retries.\n * \n * @param url - The URL to stream from\n * @param options - Configuration options\n */\nexport async function* stream(\n  url: string, \n  options?: StreamOptions\n): AsyncGenerator<string | Uint8Array, void, unknown> {\n  const { \n    headers, \n    retries = 3, \n    signal, \n    decode = true \n  } = options || {};\n\n  const fetchHeaders = {\n    \"Cache-Control\": \"no-cache\",\n    \"Connection\": \"keep-alive\",\n    ...headers,\n  };\n\n  let retryCount = 0;\n\n  while (retryCount <= retries) {\n    try {\n      const response = await fetch(url, {\n        method: \"GET\",\n        headers: fetchHeaders,\n        signal,\n      });\n\n      if (!response.ok) {\n        if (response.status >= 400 && response.status < 500) {\n          throw new Error(`Client Error: ${response.status} ${response.statusText}`);\n        }\n        throw new Error(`Server Error: ${response.status} ${response.statusText}`);\n      }\n\n      if (!response.body) {\n        throw new Error(\"Response body is null\");\n      }\n\n      const reader = response.body.getReader();\n      const decoder = new TextDecoder();\n\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) break;\n          \n          if (decode) {\n            yield decoder.decode(value, { stream: true });\n          } else {\n            yield value;\n          }\n        }\n      } finally {\n        reader.releaseLock();\n      }\n\n      return; // Stream completed successfully\n    } catch (error: any) {\n      if (signal?.aborted) {\n        throw error;\n      }\n      \n      console.error(\"Stream error:\", error);\n      retryCount++;\n      \n      if (retryCount > retries) {\n        throw new Error(`Max retries (${retries}) exceeded. Last error: ${error.message || error}`);\n      }\n      \n      await new Promise((resolve) => setTimeout(resolve, 1000 * retryCount));\n    }\n  }\n}\n\n/**\n * Fetches a stream and parses it as Server-Sent Events (SSE).\n * Handles 'data', 'event', 'id', 'retry' fields and automatic reconnection.\n * \n * @param url - The URL to stream from\n * @param options - Configuration options\n */\nexport async function* streamSSE(\n  url: string, \n  options?: OreOptions\n): AsyncGenerator<SSEEvent, void, unknown> {\n  const { \n    headers: customHeaders, \n    retries = 3, \n    signal \n  } = options || {};\n\n  let lastEventId: string | null = null;\n  let retryCount = 0;\n  let retryInterval = 1000;\n\n  while (retryCount <= retries) {\n    try {\n      const headers = { \n        \"Cache-Control\": \"no-cache\",\n        \"Connection\": \"keep-alive\",\n        ...customHeaders \n      };\n      \n      if (lastEventId) {\n        (headers as any)[\"Last-Event-ID\"] = lastEventId;\n      }\n\n      const response = await fetch(url, {\n        method: \"GET\",\n        headers,\n        signal,\n      });\n\n      if (!response.ok) {\n         if (response.status === 204) return; // No Content -> End of stream\n         if (response.status >= 400 && response.status < 500) {\n           throw new Error(`Client Error: ${response.status} ${response.statusText}`);\n         }\n         throw new Error(`Failed to connect: ${response.status} ${response.statusText}`);\n      }\n      \n      if (!response.body) throw new Error(\"Response body is null\");\n\n      const reader = response.body.getReader();\n      const decoder = new TextDecoder();\n      \n      let buffer = \"\";\n      \n      // State machine for event parsing\n      let currentEvent: Partial<SSEEvent> = { data: \"\", event: null, id: null };\n      let hasData = false;\n\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) break;\n          \n          buffer += decoder.decode(value, { stream: true });\n          \n          const lines = buffer.split(/\\r\\n|\\r|\\n/);\n          buffer = lines.pop() || \"\"; // Keep last incomplete line\n\n          for (const line of lines) {\n            if (line === \"\") {\n              if (hasData) {\n                 let data = currentEvent.data!;\n                 if (data.endsWith(\"\\n\")) {\n                    data = data.slice(0, -1);\n                 }\n                 \n                 const event: SSEEvent = {\n                   id: currentEvent.id ?? lastEventId,\n                   event: currentEvent.event ?? null,\n                   data: data,\n                   retry: currentEvent.retry\n                 };\n                 \n                 if (event.id) lastEventId = event.id;\n                 \n                 yield event;\n                 \n                 currentEvent = { data: \"\", event: null, id: null };\n                 hasData = false;\n              }\n              continue;\n            }\n\n            if (line.startsWith(\":\")) continue;\n\n            const colonIndex = line.indexOf(\":\");\n            let field = \"\";\n            let valueStr = \"\";\n\n            if (colonIndex === -1) {\n              field = line;\n              valueStr = \"\";\n            } else {\n              field = line.slice(0, colonIndex);\n              valueStr = line.slice(colonIndex + 1);\n              if (valueStr.startsWith(\" \")) valueStr = valueStr.slice(1);\n            }\n\n            switch (field) {\n              case \"data\":\n                currentEvent.data += valueStr + \"\\n\";\n                hasData = true;\n                break;\n              case \"event\":\n                currentEvent.event = valueStr;\n                break;\n              case \"id\":\n                if (valueStr.indexOf(\"\\0\") === -1) {\n                  currentEvent.id = valueStr;\n                }\n                break;\n              case \"retry\":\n                const retry = parseInt(valueStr, 10);\n                if (!isNaN(retry)) {\n                  retryInterval = retry;\n                  currentEvent.retry = retry;\n                }\n                break;\n            }\n          }\n        }\n      } finally {\n         reader.releaseLock();\n      }\n\n      console.log(\"Stream closed by server, reconnecting...\");\n      retryCount++;\n      await new Promise(r => setTimeout(r, retryInterval));\n\n    } catch (error: any) {\n      if (signal?.aborted) throw error;\n      \n      console.error(\"SSE error:\", error);\n      retryCount++;\n      if (retryCount > retries) {\n         throw new Error(`Max retries exceeded. Last error: ${error.message}`);\n      }\n      await new Promise(r => setTimeout(r, retryInterval));\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glamboyosa/ore",
-  "version": "0.0.4",
+  "version": "1.0.0",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",

package/readme.md

@@ -1,18 +1,16 @@
 # Ore
 
-Ore is a JavaScript / TypeScript package that simplifies the consumption of Server-Sent Events (SSE) in web applications. It provides an easy-to-use interface for establishing SSE connections, handling incoming events, and implementing retry strategies in case of connection failures.
-
-## Motivation
-
-Consuming Server-Sent Events (SSE) or streaming data in web applications isn't always well-documented and can be complex or just plain unreliable to implement. Ore aims to simplify this process by providing a straightforward and reliable way to consume SSE streams.
+Ore is a modern, lightweight JavaScript/TypeScript library for robust streaming and Server-Sent Events (SSE) consumption. It provides a simple, bulletproof API for handling streams with automatic retries and easy integration into modern frameworks like React, Next.js, and more.
 
 ## Features
 
-- Establish SSE connections with ease.
-- Handle incoming SSE events and process them accordingly.
-- Implement retry strategies for reconnecting to the SSE endpoint in case of connection failures.
-- Customizable headers for SSE requests.
-- Set maximum retries for connection attempts.
+- **Bulletproof Streaming:** Robust handling of connection drops with automatic retries.
+- **Dual Mode:** 
+  - `stream()`: For raw text/byte streaming (e.g. AI responses, logs).
+  - `streamSSE()`: For spec-compliant Server-Sent Events parsing.
+- **Modern API:** Uses Async Generators for clean, modern usage (`for await...of`).
+- **Universal:** Works in Browser, Node.js, and Edge runtimes.
+- **Zero Dependencies:** Tiny footprint.
 
 ## Install
 
@@ -22,58 +20,141 @@ npm install @glamboyosa/ore
 
 ## Usage
 
+### Raw Streaming (Text/Bytes)
+
+Perfect for AI chat streams, logs, or custom protocols.
+
 ```typescript
-import Ore from "@glamboyosa/ore";
-
-// Initialize Ore with URL and optional headers
-const ore = new Ore({
-  url: "http://example.com/sse-endpoint",
-  headers: {
-    "Cache-Control": "no-cache",
-  },
+import { stream } from "@glamboyosa/ore";
+
+// Basic usage
+for await (const chunk of stream("http://api.example.com/chat")) {
+  console.log(chunk); // "Hello", " world", "!"
+}
+
+// With options
+const ac = new AbortController();
+const dataStream = stream("http://api.example.com/chat", {
+  headers: { "Authorization": "Bearer token" },
+  retries: 3,
+  signal: ac.signal,
+  decode: true, // Set to false to get Uint8Array
 });
 
-// Start SSE connection
-ore.fetchSSE(
-  (buffer, parts) => {
-    console.log("Received buffer:", buffer);
-    // Process the received buffer
-
-    const b = parts[parts.length - 1];
-    console.log("Received parts i.e. events", parts);
-    console.log("Buffer per event", b);
-    // process the buffer per event
-  },
-  () => {
-    console.log("Stream ended");
-    // Handle stream end
-  }
-);
+for await (const chunk of dataStream) {
+  // ...
+}
+```
+
+### Server-Sent Events (SSE)
+
+Parses standard SSE format (`data: ...`, `event: ...`, `id: ...`).
+
+```typescript
+import { streamSSE } from "@glamboyosa/ore";
+
+for await (const event of streamSSE("http://api.example.com/events")) {
+  console.log(event.id);
+  console.log(event.event); // e.g., 'update'
+  console.log(event.data);  // The message payload
+}
 ```
 
-## Class Parameters
+### Usage with React
 
-- `url`: `string` - The URL of the SSE endpoint.
-- `headers`: `HeadersInit` (optional) - Optional headers to include in the SSE request. Must be an object where keys are header names and values are header values.
+```tsx
+import { useEffect, useState } from "react";
+import { stream } from "@glamboyosa/ore";
 
-## `fetchSSE` Function Parameters
+function ChatComponent() {
+  const [messages, setMessages] = useState("");
 
-- `onBufferReceived`: `function` - Callback function to handle received SSE buffers. Receives the buffer and the optionally the parts i.e. new events as a parameter.
-- `onStreamEnded`: `function` - Callback function to handle stream end events. Receives the internal state of if the buffer stream is ended.
-- `retries`: `number` (optional) - Optional parameter to specify the maximum number of retry attempts. Default is 3.
+  useEffect(() => {
+    const controller = new AbortController();
 
-## Working with React Server Components
+    (async () => {
+      try {
+        for await (const chunk of stream("/api/chat", { signal: controller.signal })) {
+          setMessages(prev => prev + chunk);
+        }
+      } catch (err) {
+        if (err.name !== 'AbortError') console.error(err);
+      }
+    })();
 
-While Ore is intended to work with client components, it is possible to use it in server components using the `fetchSSEForRSC` function. The function takes optional `retries`: `number` (optional) - Optional parameter to specify the maximum number of retry attempts. Default is 3. and `customHeaders`: `HeadersInit` (optional) - Optional headers to include in the SSE request. Must be an object where keys are header names and values are header values.
+    return () => controller.abort();
+  }, []);
 
-### Usage with RSCs
+  return <div>{messages}</div>;
+}
+```
+
+### Usage with Next.js Server Components
+
+Ore works great with React Server Components (RSC) and Suspense for streaming HTML.
+
+```tsx
+import { stream } from "@glamboyosa/ore";
+import { Suspense } from "react";
+
+// Recursive component to stream data
+async function StreamViewer({ iterator }) {
+  const { value, done } = await iterator.next();
+  if (done) return null;
+  
+  return (
+    <span>
+      {value}
+      <Suspense>
+        <StreamViewer iterator={iterator} />
+      </Suspense>
+    </span>
+  );
+}
+
+export default function Page() {
+  const dataStream = stream("http://api.example.com/stream");
+  const iterator = dataStream[Symbol.asyncIterator]();
+
+  return (
+    <Suspense fallback="Loading...">
+      <StreamViewer iterator={iterator} />
+    </Suspense>
+  );
+}
+```
+
+## API Reference
+
+### `stream(url: string, options?: StreamOptions)`
 
-Checkout the `next-js-example` directory for a full example on how to use it with Server Components [here](https://github.com/glamboyosa/ore/blob/main/examples/next-js-example/src/app/page.tsx)
+Returns an `AsyncGenerator<string | Uint8Array>`.
 
-## Contributing
+**Options:**
+- `headers`: `HeadersInit` - Custom headers.
+- `retries`: `number` (default: 3) - Max retry attempts on failure.
+- `signal`: `AbortSignal` - To cancel the request.
+- `decode`: `boolean` (default: true) - If true, yields strings. If false, yields `Uint8Array`.
 
-Contributions to @glamboyosa/ore are welcome! If you have suggestions for improvements or encounter any issues, feel free to open an issue or submit a pull request on GitHub.
+### `streamSSE(url: string, options?: OreOptions)`
+
+Returns an `AsyncGenerator<SSEEvent>`.
+
+**Options:**
+- `headers`: `HeadersInit`
+- `retries`: `number` (default: 3)
+- `signal`: `AbortSignal`
+
+**SSEEvent Interface:**
+```typescript
+interface SSEEvent {
+  id: string | null;
+  event: string | null;
+  data: string;
+  retry?: number;
+}
+```
 
 ## License
 
-This project is licensed under the MIT License.
+MIT