@ahoo-wang/fetcher-eventstream 0.8.2 → 0.8.3

package/dist/eventStreamInterceptor.d.ts

@@ -1,4 +1,33 @@
 import { FetchExchange, Interceptor } from '@ahoo-wang/fetcher';
+/**
+ * EventStreamInterceptor Class
+ *
+ * Interceptor responsible for enhancing Response objects with event stream capabilities
+ * when the response content type indicates a server-sent event stream.
+ *
+ * This interceptor detects responses with `text/event-stream` content type and adds
+ * an `eventStream()` method to the Response object, which returns a readable stream
+ * of Server-Sent Events that can be consumed using `for await` syntax.
+ *
+ * @remarks
+ * This interceptor runs after the HTTP response is received but before the response
+ * is returned to the caller. The order is set to Number.MAX_SAFE_INTEGER - 100 to
+ * ensure it runs after all standard response processing is complete, as it adds
+ * specialized functionality to the response object. This order allows other
+ * response interceptors to run after it if needed.
+ *
+ * @example
+ * ```typescript
+ * // Using the eventStream method
+ * const response = await fetcher.get('/events');
+ * if (response.headers.get('content-type')?.includes('text/event-stream')) {
+ *   const eventStream = response.eventStream();
+ *   for await (const event of eventStream) {
+ *     console.log('Received event:', event);
+ *   }
+ * }
+ * ```
+ */
 export declare class EventStreamInterceptor implements Interceptor {
     name: string;
     order: number;

package/dist/eventStreamInterceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eventStreamInterceptor.d.ts","sourceRoot":"","sources":["../src/eventStreamInterceptor.ts"],"names":[],"mappings":"AAcA,OAAO,EAGL,aAAa,EACb,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,sBAAuB,YAAW,WAAW;IACxD,IAAI,SAA4B;IAChC,KAAK,SAA2B;IAEhC,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa;CAgBlD"}
+{"version":3,"file":"eventStreamInterceptor.d.ts","sourceRoot":"","sources":["../src/eventStreamInterceptor.ts"],"names":[],"mappings":"AAcA,OAAO,EAAwC,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtG;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,sBAAuB,YAAW,WAAW;IACxD,IAAI,SAA4B;IAChC,KAAK,SAAiC;IAEtC,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa;CAgBlD"}

package/dist/index.es.js

@@ -120,7 +120,7 @@ function T(s) {
 }
 class v {
   constructor() {
-    this.name = "EventStreamInterceptor", this.order = Number.MAX_SAFE_INTEGER;
+    this.name = "EventStreamInterceptor", this.order = Number.MAX_SAFE_INTEGER - 100;
   }
   intercept(t) {
     const e = t.response;

package/dist/index.umd.js

@@ -1,4 +1,4 @@
 (function(s,o){typeof exports=="object"&&typeof module<"u"?o(exports,require("@ahoo-wang/fetcher")):typeof define=="function"&&define.amd?define(["exports","@ahoo-wang/fetcher"],o):(s=typeof globalThis<"u"?globalThis:s||self,o(s.FetcherEventStream={},s.Fetcher))})(this,(function(s,o){"use strict";class d{constructor(){this.buffer=""}transform(t,e){try{this.buffer+=t;const r=this.buffer.split(`
 `);this.buffer=r.pop()||"";for(const a of r)e.enqueue(a)}catch(r){e.error(r)}}flush(t){try{this.buffer&&t.enqueue(this.buffer)}catch(e){t.error(e)}}}class u extends TransformStream{constructor(){super(new d)}}var c=(n=>(n.ID="id",n.RETRY="retry",n.EVENT="event",n.DATA="data",n))(c||{});function T(n,t,e){switch(n){case"event":e.event=t;break;case"data":e.data.push(t);break;case"id":e.id=t;break;case"retry":{const r=parseInt(t,10);isNaN(r)||(e.retry=r);break}}}class m{constructor(){this.currentEvent={event:"message",id:void 0,retry:void 0,data:[]}}transform(t,e){const r=this.currentEvent;try{if(t.trim()===""){r.data.length>0&&(e.enqueue({event:r.event||"message",data:r.data.join(`
 `),id:r.id||"",retry:r.retry}),r.event="message",r.data=[]);return}if(t.startsWith(":"))return;const a=t.indexOf(":");let f,i;a===-1?(f=t.toLowerCase(),i=""):(f=t.substring(0,a).toLowerCase(),i=t.substring(a+1),i.startsWith(" ")&&(i=i.substring(1))),f=f.trim(),i=i.trim(),T(f,i,r)}catch(a){e.error(a instanceof Error?a:new Error(String(a))),r.event="message",r.id=void 0,r.retry=void 0,r.data=[]}}flush(t){const e=this.currentEvent;try{e.data.length>0&&t.enqueue({event:e.event||"message",data:e.data.join(`
-`),id:e.id||"",retry:e.retry})}catch(r){t.error(r instanceof Error?r:new Error(String(r)))}finally{e.event="message",e.id=void 0,e.retry=void 0,e.data=[]}}}class h extends TransformStream{constructor(){super(new m)}}function v(n){if(!n.body)throw new Error("Response body is null");return n.body.pipeThrough(new TextDecoderStream("utf-8")).pipeThrough(new u).pipeThrough(new h)}class S{constructor(){this.name="EventStreamInterceptor",this.order=Number.MAX_SAFE_INTEGER}intercept(t){const e=t.response;if(!e)return t;const r=e.headers.get(o.ContentTypeHeader);return r&&r.includes(o.ContentTypeValues.TEXT_EVENT_STREAM)&&(e.eventStream=()=>v(e)),t}}s.EventStreamInterceptor=S,s.ServerSentEventField=c,s.ServerSentEventTransformStream=h,s.ServerSentEventTransformer=m,s.TextLineTransformStream=u,s.TextLineTransformer=d,s.toServerSentEventStream=v,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})}));
+`),id:e.id||"",retry:e.retry})}catch(r){t.error(r instanceof Error?r:new Error(String(r)))}finally{e.event="message",e.id=void 0,e.retry=void 0,e.data=[]}}}class h extends TransformStream{constructor(){super(new m)}}function v(n){if(!n.body)throw new Error("Response body is null");return n.body.pipeThrough(new TextDecoderStream("utf-8")).pipeThrough(new u).pipeThrough(new h)}class S{constructor(){this.name="EventStreamInterceptor",this.order=Number.MAX_SAFE_INTEGER-100}intercept(t){const e=t.response;if(!e)return t;const r=e.headers.get(o.ContentTypeHeader);return r&&r.includes(o.ContentTypeValues.TEXT_EVENT_STREAM)&&(e.eventStream=()=>v(e)),t}}s.EventStreamInterceptor=S,s.ServerSentEventField=c,s.ServerSentEventTransformStream=h,s.ServerSentEventTransformer=m,s.TextLineTransformStream=u,s.TextLineTransformer=d,s.toServerSentEventStream=v,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahoo-wang/fetcher-eventstream",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "Server-Sent Events (SSE) support for Fetcher HTTP client",
   "keywords": [
     "fetch",
@@ -33,7 +33,7 @@
     "dist"
   ],
   "dependencies": {
-    "@ahoo-wang/fetcher": "0.8.2"
+    "@ahoo-wang/fetcher": "0.8.3"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^3.2.4",