@jnode/request 1.1.3 → 2.0.0-beta.1

package/README.md

@@ -1,173 +1,152 @@
-# JustRequest
+# `@jnode/request`
 
-Simple HTTP(s) package for Node.js.
+Simple HTTP(S) requesting package for Node.js.
 
 ## Installation
 
-```shell
-npm install @jnode/request
+```
+npm i @jnode/request@beta
 ```
 
-## Usage
+## Quick start
 
-### Import JustRequest
+### Import
 
-```javascript
-const { request, multipartRequest, generateMultipartBody, RequestResponse } = require('@jnode/request');
+```js
+const { request, FormPart } = require('@jnode/request');
 ```
 
-### Making a request
-
-```javascript
-async function fetchData() {
-  try {
-    const response = await request('GET', 'https://example.com/api/data');
-    console.log('Status Code:', response.statusCode);
-    console.log('Body:', response.text()); // Use response.json() if expecting a JSON response
-  } catch (error) {
-    console.error('Request failed:', error);
-  }
-}
+### Make a request
 
-fetchData();
+```js
+request('GET', 'https://example.com/').then((res) => {
+  console.log(res.text());
+});
 ```
 
-### Sending data with the request
-
-```javascript
-async function postData() {
-  try {
-      const headers = {
-        'Content-Type': 'application/json'
-      };
-      const body = JSON.stringify({ key: 'value' });
-      const response = await request('POST', 'https://example.com/api/post', headers, body);
-      console.log('Status Code:', response.statusCode);
-      console.log('Response:', response.text());
-  } catch (error) {
-      console.error('Request failed:', error);
-  }
-}
-
-postData();
-```
+### Make a `multipart/form-body` request
 
-### Generating a `multipart/form-data` body
-
-```javascript
-const fs = require('fs');
-
-async function uploadFile() {
-  const fileData = await fs.promises.readFile('./example.txt');
-  const parts = [{
-    disposition: 'form-data; name="file"; filename="example.txt"',
-    contentType: 'text/plain',
-    data: fileData
-  }, {
-      disposition: 'form-data; name="key"',
-      data: 'value'
-  }];
-  const body = generateMultipartBody(parts);
-  
-  const headers = {
-    'Content-Type': 'multipart/form-data; boundary=----JustNodeFormBoundary'
-  };
-
-  try {
-      const response = await request('POST', 'https://example.com/api/upload', headers, body);
-      console.log('Status Code:', response.statusCode);
-      console.log('Response:', response.text());
-  } catch (error) {
-      console.error('Request failed:', error);
-  }
-}
-
-uploadFile();
+```js
+request('POST', 'https://example.com/', [
+  new FormPart('foo', 'bar'),
+  new FormPart('awa', 'uwu')
+]).then((res) => {
+  console.log(res.text());
+});
 ```
 
-### Making a multipart request
-```javascript
-const fs = require('fs');
-
-async function uploadFile() {
-  const fileStream = fs.createReadStream('./example.txt');
-  const parts = [{
-    disposition: 'form-data; name="file"; filename="example.txt"',
-    stream: fileStream
-  }, {
-      disposition: 'form-data; name="key"',
-      data: 'value'
-  }];
-  
-  const headers = {
-    'X-Custom-Header': 'custom value'
-  };
-  try {
-      const response = await multipartRequest('POST', 'https://example.com/api/upload', headers, parts);
-      console.log('Status Code:', response.statusCode);
-      console.log('Response:', response.text());
-  } catch (error) {
-      console.error('Request failed:', error);
-  }
-}
-
-uploadFile();
-```
+--------
+
+# Reference
+
+## `request.request(method, url[, body, headers, options])`
+
+- `method` [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type) A string specifying the HTTP request method. **Default:** `'GET'`.
+- `url` [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type) | [\<URL\>](https://nodejs.org/docs/latest/api/url.html#the-whatwg-url-api) The target URL to request, support both `http` and `https`.
+- `body` [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type) | [\<Buffer\>](https://nodejs.org/docs/latest/api/buffer.html#class-buffer) | [\<Uint8Array\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) | [\<stream.Readable\>](https://nodejs.org/docs/latest/api/stream.html#class-streamreadable) | [\<URLSearchParams\>](https://nodejs.org/docs/latest/api/url.html#class-urlsearchparams) | [\<request.FormPart[]\>](#class-requestformpart) | [\<Object[]\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object) The request body. Using [\<URLSearchParams\>](https://nodejs.org/docs/latest/api/url.html#class-urlsearchparams) will send a `application/x-www-form-urlencoded` request; using [\<request.FormPart[]\>](#class-requestformpart) or  [\<Object[]\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object) will send a `multipart/form-body` request.
+- `headers` [\<Object\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object) An object containing request headers. `Content-Length` is automatically calculated for [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type), [\<Buffer\>](https://nodejs.org/docs/latest/api/buffer.html#class-buffer), [\<Uint8Array\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array), or [\<URLSearchParams\>](https://nodejs.org/docs/latest/api/url.html#class-urlsearchparams) body. And `Content-Type` will be force replaced while sending a `multipart/form-body` request with  [\<FormPart[]\>](#class-requestformpart) or [\<Object[]\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object) body.
+- `options` [\<Object\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object) `options` in [`http.request()`](https://nodejs.org/docs/latest/api/http.html#httprequestoptions-callback).
+- Returns: [\<request.RequestResponse\>](#class-requestrequestresponse)
+
+Make a HTTP(S) request.
+
+## Class: `request.FormPart`
+
+### `new request.FormPart(name, body[, headers])`
+
+- `name` [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type) Name of the part.
+- `body` [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type) | [\<Buffer\>](https://nodejs.org/docs/latest/api/buffer.html#class-buffer) | [\<Uint8Array\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) | [\<stream.Readable\>](https://nodejs.org/docs/latest/api/stream.html#class-streamreadable) | [\<URLSearchParams\>](https://nodejs.org/docs/latest/api/url.html#class-urlsearchparams) The body of the part. Using [\<URLSearchParams\>](https://nodejs.org/docs/latest/api/url.html#class-urlsearchparams) will create a `application/x-www-form-urlencoded` part.
+- `headers` [\<Object\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object) An object containing part headers. There is a special `filename` field, will be added to `Content-Disposition`.
+
+## Class: `request.RequestResponse`
+
+### `new request.RequestResponse(res)`
+
+- `res` [\<http.IncomingMessage\>](https://nodejs.org/docs/latest/api/http.html#class-httpincomingmessage) The original `node:http` response object.
+
+### `requestResponse.res`
+
+- Type: [\<http.IncomingMessage\>](https://nodejs.org/docs/latest/api/http.html#class-httpincomingmessage)
+
+### `requestResponse.statusCode`
+
+- Type: [\<number\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#number_type)
+
+The response HTTP status code.
+
+### `requestResponse.headers`
+
+- Type: [\<Object\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)
+
+The response HTTP headers.
+
+### `requestResponse._body`
+
+- Type: [\<Buffer\>](https://nodejs.org/docs/latest/api/buffer.html#class-buffer)
+
+> **Notice**: You should avoid reading this property directly, use [`requestRespond.buffer()`](#requestrespondbuffer) instead.
+
+### `requestResponse.buffer()`
+
+- Returns: [\<Promise\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) Fulfills with a [\<Buffer\>](https://nodejs.org/docs/latest/api/buffer.html#class-buffer) object.
+
+Receives the body of the response stream and return as a buffer.
+
+### `requestResponse.text([encoding])`
+
+- `encoding` [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type) The character encoding to use. **Default:** `'utf8'`.
+- Returns: [\<Promise\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) Fulfills with a string.
+
+Receives the body of the response stream and return as a string.
+
+### `requestResponse.json([encoding])`
+
+- `encoding` [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type) The character encoding to use. **Default:** `'utf8'`.
+- Returns: [\<Promise\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) Fulfills with any of [\<Object\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object), [\<Array\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array), [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type), [\<number\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#number_type), [\<boolean\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#boolean_type), or [\<null\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#null_type).
+
+Receives the body of the response stream and parse string as JSON.
+
+### `requestResponse.rl()`
+
+- Returns: [\<readline.Interface\>](https://nodejs.org/docs/latest/api/readline.html#class-readlineinterface)
 
-## Functions
+Provides an interface for reading data from response one line at a time.
 
-### `request(method, url, headers = {}, body)`
+### `requestResponse.sse()`
 
-Makes an HTTP(S) request.
+- Returns: [\<request.EventReceiver\>](#class-requesteventreceiver)
 
--   `method`: HTTP method (`GET`, `POST`, `PUT`, `DELETE`, etc.).
--   `url`: The request URL.
--   `headers`: An object containing request headers. Defaults to an empty object.
--   `body`: The request body (string or Buffer).
+Provides an interface for reading data from response as Server-Sent Events (SSE, `text/event-stream`).
 
-**Returns:** A Promise that resolves to a `RequestResponse` object.
+## Class: `request.EventReceiver`
 
-### `multipartRequest(method, url, headers, parts, options)`
+- Extends: [\<EventEmitter\>](https://nodejs.org/docs/latest/api/events.html#class-eventemitter)
 
-Makes an HTTP(S) multipart/form-data request.
+An interface for reading data from [\<stream.Readable\>](https://nodejs.org/docs/latest/api/stream.html#class-streamreadable) as Server-Sent Events (SSE, `text/event-stream`).
 
--  `method`: HTTP method (`POST`, `PUT`, etc.).
--  `url`: The request URL.
--  `headers`: An object containing request headers.
--  `parts`: An array of objects, where each object represents a part of the form data.
-    - `disposition` (Optional): Content disposition.
-    - `type` (Optional): Content type of the data. Defaults to `application/octet-stream`.
-    - `data`: Data (string or Buffer) of this part.
-    - `file` (Optional): Path to a local file for streaming.
-    - `base64` (Optional): base64 encoded data string.
-    - `stream` (Optional): Any readable stream.
-- `options`: Other options.
+### `new request.EventReceiver(res)`
 
-**Returns:** A Promise that resolves to a `RequestResponse` object.
+- `res` [\<stream.Readable\>](https://nodejs.org/docs/latest/api/stream.html#class-streamreadable) The response stream or any readable stream.
 
-### `generateMultipartBody(parts = [])`
+### Event: `'close'`
 
-Generates the body for a `multipart/form-data` request.
+Emitted when the request has been completed.
 
--   `parts`: An array of objects, where each object represents a part of the form data.
-    -   `disposition` (Optional): Content disposition.
-    -   `contentType` (Optional): Content type of the data. Defaults to `application/octet-stream`.
-    -   `data`: Data (string or Buffer) of this part.
-    -    `encoded` (Optional): If provided, the data is already base64 encoded, you may skip the default base64 encoding.
+### Event: `'event'`
 
-**Returns:** A string representing the multipart body.
+- `event` [\<Object\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)
+  - `data` [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type) The full data string of this event.
+  - `event` [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type) The event name.
+  - `id` [\<string\>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#string_type) The event id.
 
-## Class `RequestResponse`
+### `eventReceiver.res`
 
-A class representing the response from an HTTP(S) request.
+- Type: [\<stream.Readable\>](https://nodejs.org/docs/latest/api/stream.html#class-streamreadable)
 
-### Properties
+The response stream or any readable stream.
 
--   `statusCode`: The HTTP status code of the response.
--   `headers`: An object containing the response headers.
--   `body`: The raw response body (Buffer).
+### `eventReceiver.rl`
 
-### Methods
+- Type: [\<readline.Interface\>](https://nodejs.org/docs/latest/api/readline.html#class-readlineinterface)
 
--   `text(encoding = 'utf8')`: Returns the response body as a string with optional encoding.
--   `json()`: Attempts to parse the response body as JSON. Returns a JSON object or `undefined` if parsing fails.
+An interface for reading data from response one line at a time.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jnode/request",
-  "version": "1.1.3",
-  "description": "Simple HTTP(s) package for Node.js.",
+  "version": "2.0.0-beta.1",
+  "description": "Simple HTTP(s) requesting package for Node.js.",
   "main": "src/index.js",
   "scripts": {
     "test": "echo \"Hello, HTTP.\""
@@ -23,4 +23,4 @@
     "url": "https://github.com/japple-jnode/request/issues"
   },
   "homepage": "https://github.com/japple-jnode/request#readme"
-}
+}

package/src/index.js

@@ -1,162 +1,256 @@
 /*
 JustRequest
-v.1.1.0
+v2
 
-Simple HTTP(s) package for Node.js.
+Simple HTTP(s) requesting package for Node.js.
 
-by JustNode Dev Team / JustApple
+by JustApple
 */
 
-//load node packages
+// dependencies
 const http = require('http');
 const https = require('https');
 const fs = require('fs');
-const { URL } = require('url');
-const { pipeline } = require('stream/promises');
+const { URL, URLSearchParams } = require('url');
+const stream = require('stream');
 const crypto = require('crypto');
+const readline = require('readline');
+const EventEmitter = require('events');
 
-//https request in async/await
-function request(method, url, headers = {}, body) {
-	return new Promise((resolve, reject) => {
-		//auto provide `Content-Length` header
-		headers['Content-Length'] = headers['Content-Length'] ?? (body ? Buffer.byteLength(body) : 0);
-		
-		//support http and https
-		const protocol = url.startsWith('https://') ? https : http;
-		
-		//make request
-		protocol.request(url, {
-			method: method,
-			headers: headers
-		}, (res) => {
-			let chunks = [];
-			res.on('data', (chunk) => chunks.push(chunk));
-			res.on('end', () => {
-				resolve(new RequestResponse(res, Buffer.concat(chunks)));
-			});
-			res.on('error', reject);
-		}).end(body).on('error', reject);
-	});
-}
-
-//generate `multipart/form-data` type request body
-function generateMultipartBody(parts = []) {
-	//we use `----JustNodeFormBoundary` as boundary, and will encode data with base64
-	//every part of `parts` is an object with item `disposition`, `contentType` and `data` (Buffer)
-	
-	let result = '';
-	for (let i of parts) { //add every part
-		result += '------JustNodeFormBoundary\r\n' +
-		'Content-Disposition: form-data' + (i.disposition ? '; ' + i.disposition : '') + '\r\n' +
-		'Content-Type: ' + (i.contentType ?? 'application/octet-stream') + '\r\n' +
-		'Content-Transfer-Encoding: base64\r\n\r\n' +
-		(i.encoded ?? ((typeof i.data === 'string') ? Buffer.from(i.data) : i.data).toString('base64')) + '\r\n';
-	}
-	result += '------JustNodeFormBoundary--'; //end
-	
-	return result;
-}
-
-//http multipart/form-data request
-async function multipartRequest(method, url, headers, parts, options) {
+// make a HTTP(S) request
+function request(method = 'GET', url = '', body, headers = {}, options = {}) {
 	return new Promise(async (resolve, reject) => {
-		const parsedUrl = new URL(url); //parse url
-		const isHttps = parsedUrl.protocol === 'https:'; //check protocol
-		const reqModule = isHttps ? https : http; //select module from http and https
-		
-		const boundary = `----WebKitFormBoundary${Date.now().toString(16)}${crypto.randomUUID()}`; //create a random boundary
-		headers['Content-Type'] = `multipart/form-data; boundary=${boundary}`; //set header
-		
-		//set options
-		options = {
-			method,
-			headers,
-			...options
-		};
-		
-		//make a request
-		const req = reqModule.request(url, options, (res) => {
-			//save buffers
-			let chunks = [];
-			res.on('data', (chunk) => chunks.push(chunk));
-			
-			res.on('end', () => {
-				resolve(new RequestResponse(res, Buffer.concat(chunks)));
-			});
-			
-			res.on('error', (err) => {
-				reject(err);
-			});
-		});
-		
-		req.on('error', (err) => {
-			reject(err);
+		// protocol select
+		if (typeof url === 'string') url = new URL(url);
+		const protocol = url.protocol === 'https:' ? https : http;
+
+		// make request
+		const req = protocol.request(url, { method, headers }, (res) => {
+			resolve(new RequestResponse(res));
 		});
-		
-		//send every parts
-		for (const part of parts) {
-			req.write(`--${boundary}\r\n`); //write boundary
-			
-			//write disposition
-			if (part.disposition) {
-				req.write(`Content-Disposition: ${part.disposition}\r\n`);
-			}
-			
-			//write content type
-			let contentType = part.type ?? 'application/octet-stream';
-			req.write(`Content-Type: ${contentType}\r\n`);
-			
-			//send data
-			if (part.file) { //local file, using streams
-				req.write('\r\n');
-				const fileStream = fs.createReadStream(part.file);
-				await pipeline(fileStream, req, { end: false }); //pipe stream but not end
-				req.write('\r\n');
-			} else if (part.data) { //string or buffer data
-				req.write('\r\n');
-				req.write(part.data);
-				req.write('\r\n');
-			} else if (part.base64) { //base64 data
-				req.write('Content-Transfer-Encoding: base64\r\n\r\n'); //using base64 encoding
-				req.write(part.base64);
-				req.write('\r\n');
-			} else if (part.stream) { //any readable stream
-				req.write('\r\n');
-				await pipeline(part.stream, req, { end: false });
-				req.write('\r\n');
+
+		// write headers and body
+		if (typeof body === 'string' || Buffer.isBuffer(body) || body instanceof Uint8Array) { // static body
+			req.setHeader('Content-Length', Buffer.byteLength(body));
+			req.end(body);
+		} else if (body instanceof stream.Readable) { // stream
+			body.pipe(req);
+		} else if (Array.isArray(body)) { // multipart/form-body
+			// generate boundary
+			const boundary = `----WebKitFormBoundary${Date.now().toString(16)}${crypto.randomUUID()}`;
+			req.setHeader('Content-Type', `multipart/form-data; boundary=${boundary}`);
+
+			// write every parts
+			for (const part of body) {
+				req.write(`--${boundary}\r\n`); // boundary
+
+				// part headers
+				const partHeaders = part.headers || {};
+
+				// set Content-Disposition header
+				if (!partHeaders['Content-Disposition']) {
+					partHeaders['Content-Disposition'] = `form-data; name="${part.name}"${part.filename ? `; filename="${part.filename}"` : ''}`;
+				}
+
+				// write headers and body
+				if (typeof part.body === 'string' || Buffer.isBuffer(part.body) || part.body instanceof Uint8Array) { // static body
+					for (const [key, value] of Object.entries(partHeaders)) {
+						req.write(`${key}: ${value}\r\n`);
+					}
+					req.write('\r\n');
+
+					req.write(part.body);
+					req.write('\r\n');
+				} else if (part.body instanceof stream.Readable) { // stream body
+					for (const [key, value] of Object.entries(partHeaders)) {
+						req.write(`${key}: ${value}\r\n`);
+					}
+					req.write('\r\n');
+
+					await new Promise((res, rej) => {
+						part.body.on('error', rej);
+						part.body.on('end', res);
+						part.body.pipe(req, { end: false });
+					});
+					req.write('\r\n');
+				} else if (part.body instanceof URLSearchParams) {
+					const encoded = part.body.toString();
+					partHeaders['Content-Type'] = 'application/x-www-form-urlencoded';
+					for (const [key, value] of Object.entries(partHeaders)) {
+						req.write(`${key}: ${value}\r\n`);
+					}
+					req.write('\r\n');
+
+					req.write(encoded);
+					req.write('\r\n');
+				} else { // no body
+					for (const [key, value] of Object.entries(partHeaders)) {
+						req.write(`${key}: ${value}\r\n`);
+					}
+					req.write('\r\n\r\n');
+				}
 			}
+
+			// end multipart body
+			req.write(`--${boundary}--`);
+			req.end();
+		} else if (body instanceof URLSearchParams) { // application/x-www-form-urlencoded
+			const encoded = body.toString();
+			req.setHeader('Content-Type', 'application/x-www-form-urlencoded');
+			req.setHeader('Content-Length', Buffer.byteLength(encoded));
+			req.end(encoded);
+		} else { // no body
+			req.end();
 		}
-		
-		//end request
-		req.write(`--${boundary}--`);
-		req.end();
 	});
 }
 
+// form part
+class FormPart {
+	constructor(name = '', body, headers = {}) {
+		this.name = name;
+		this.body = body;
+		this.headers = headers;
+	}
+}
+
 //request response
 class RequestResponse {
-	constructor(res, body) {
+	constructor(res) {
 		this.res = res;
-		this.body = body;
-		
+
 		this.statusCode = res.statusCode;
 		this.headers = res.headers;
 	}
-	
-	//to string
-	text(encoding) {
-		return this._text ?? (this._text = this.body.toString(encoding));
+
+	buffer() {
+		return new Promise((resolve, reject) => {
+			if (!this._body) {
+				const chunks = [];
+				this.res.on('data', (d) => { chunks.push(d); });
+				this.res.on('end', () => {
+					this._body = Buffer.concat(chunks);
+					resolve(Buffer.concat(chunks));
+				});
+				this.res.on('error', reject);
+			} else {
+				resolve(this._body);
+			}
+		});
+	}
+
+	async text(encoding = 'utf8') {
+		return (await this.buffer()).toString(encoding);
+	}
+
+	async json(encoding = 'utf8') {
+		return JSON.parse((await this.text(encoding)));
+	}
+
+	rl() {
+		return readline.createInterface({
+			input: this.res,
+			crlfDelay: Infinity
+		});
+	}
+
+	sse() {
+		return new EventReceiver(this.res);
 	}
-	
-	//to json
-	json(encoding) {
-		try {
-			return this._json ?? (this._json = JSON.parse(this.body));
-		} catch (err) {
-			return undefined;
+}
+
+// SSE (text/event-stream) event receiver
+class EventReceiver extends EventEmitter {
+	constructor(res) {
+		super();
+		this.res = res;
+		this.rl = readline.createInterface({
+			input: res,
+			crlfDelay: Infinity
+		});
+
+		let name = 'message';
+		let data = '';
+		let id = null;
+
+		this.rl.on('line', (line) => {
+			// comment
+			if (line.startsWith(':')) return;
+
+			// fields
+			if (line.startsWith('event: ')) name = line.slice(7);
+			else if (line.startsWith('event:')) name = line.slice(6);
+			else if (line.startsWith('data: ')) data += line.slice(6) + '\n';
+			else if (line.startsWith('data:')) data += line.slice(5) + '\n';
+			else if (line.startsWith('id: ')) id = line.slice(4).trim();
+			else if (line.startsWith('id:')) id = line.slice(3).trim();
+			else if (line === '') { // event finished
+				if (data.endsWith('\n')) data = data.slice(0, -1); // remove last \n
+				this.emit('event', { name, data, id });
+
+				// reset
+				name = 'message';
+				data = '';
+				id = null;
+			}
+		});
+
+		this.rl.on('close', () => { this.emit('close'); });
+		this.rl.on('error', (err) => {
+			this.emit('error', err);
+			this.emit('close');
+		});
+	}
+
+	// async generator support
+	[Symbol.asyncIterator]() {
+		let queue = [];
+		let done = false;
+		let resolvers = [];
+
+		// event
+		const onEvent = (event) => {
+			if (resolvers.length > 0) {
+				resolvers.shift()({ value: event, done: false });
+			} else {
+				queue.push(event);
+			}
+		};
+		this.on('event', onEvent);
+
+		// close (including error)
+		const onClose = () => {
+			done = true;
+			while (resolvers.length > 0) {
+				resolvers.shift()({ done: true });
+			}
+		};
+		this.on('close', onClose);
+
+		return {
+			next: () => {
+				return new Promise((resolve, reject) => {
+					if (queue.length > 0) {
+						resolve({ value: queue.shift(), done: false });
+					} else if (done) {
+						resolve({ done: true });
+					} else {
+						resolvers.push(resolve);
+					}
+				});
+			},
+			return: () => {
+				done = true;
+				while (resolvers.length > 0) {
+					resolvers.shift()({ done: true });
+				}
+				this.off('event', onEvent);
+				this.off('close', onClose);
+			},
+			[Symbol.asyncIterator]() { return this; }
 		}
 	}
 }
 
-//export
-module.exports = { request, multipartRequest, generateMultipartBody, RequestResponse };
+// export
+module.exports = { request, FormPart, RequestResponse };