@wiajs/request 3.0.7 → 3.0.8

package/README.md

@@ -1,11 +1,23 @@
-# Deprecated!
+# Rebirth!
 
-As of Feb 11th 2020, request is fully deprecated. No new changes are expected to land. In fact, none have landed for some time.
+The `request` library is undoubtedly one of the most influential libraries in Node.js. It was first released in 2011 as one of the earliest libraries in Node.js and npm, and it reached 25.7k stars on GitHub by 2019. Unfortunately, the author announced its deprecation in 2019. The reason was not due to any functional issues; in fact, its stream functionality is still among the best. Neither of its successors, Axios nor Got, comes close to request in this regard. The author believed the code was outdated and didn’t have the energy to rewrite the entire library using ES6.
+
+`@wiajs/request` has forked `request` and rewritten the entire library using `ES6` and the latest Node.js `http`, `https`, and `stream.Duplex`. The focus was to retain its powerful stream capabilities.
+
+How does it compare to the currently most popular library, `Axios`?
+
+`Axios` lacks stream functionality, and the goal of rewriting request was precisely to fork `Axios` and replace Axios's transport layer to make up for this shortcoming.
+
+- `@wiajs/request` (forked from `request`) provides powerful stream capabilities.
+- `@wiajs/req` (forked from `axios`) provides powerful data handling capabilities.
+- `@wiajs/request`, as the default transport for `@wiajs/req`, provides both powerful data handling and stream capabilities, as well as perfect proxy support.
+- `@wiajs/request` is the rebirth version of request.
+- `@wiajs/req` is a better version of axios.
 
 For more information about why request is deprecated and possible alternatives refer to
 [this issue](https://github.com/request/request/issues/3142).
 
-# Request - Simplified HTTP client
+# @wiajs/Request - Simplified HTTP client
 
 [![npm package](https://nodei.co/npm/request.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/request/)
 

package/dist/request.cjs

@@ -1,5 +1,5 @@
 /*!
-  * wia request v3.0.7
+  * wia request v3.0.8
   * (c) 2022-2024 Sibyl Yu and contributors
   * Released under the MIT License.
   */
@@ -628,7 +628,7 @@ class Request extends stream.Duplex {
       // Proxy all other public ClientRequest methods
       for (const method of ['flushHeaders', 'setNoDelay', 'setSocketKeepAlive']) {
         m[method] = (a, b) => {
-          log$1.debug(method, {a, b});
+          log$1(method, {a, b});
           m._currentRequest[method](a, b);
         };
       }
@@ -638,13 +638,14 @@ class Request extends stream.Duplex {
         Object.defineProperty(m, property, {
           get() {
             const val = m._currentRequest[property];
-            log$1.debug('get property', {property});
+            log$1('get property', {property});
             return val
           },
         });
       }
 
-      m._currentRequest.once('socket', m.startTimer);
+      // 启动 startTimer
+      if (m.startTimer) m._currentRequest.once('socket', m.startTimer);
 
       // 接收req事件，转发 到 redirectReq 发射
       for (const ev of writeEvents) req.on(ev, writeEventEmit[ev]);
@@ -866,6 +867,8 @@ class Request extends stream.Duplex {
      * @param {*} socket
      */
     function startTimer(socket) {
+      if (m.startTimer) m.startTimer = null;
+
       if (m._timeout) clearTimeout(m._timeout);
 
       m._timeout = setTimeout(() => {
@@ -903,7 +906,7 @@ class Request extends stream.Duplex {
 
     // Start the timer if or when the socket is opened
     if (m.socket) startTimer(m.socket);
-    else m.startTimer = startTimer; // 未连接，先登记
+    else m.startTimer = startTimer; // 未连接，先登记，连接后启动
 
     // Clean up on events
     m.on('socket', destroyOnTimeout);

package/dist/request.mjs

@@ -1,5 +1,5 @@
 /*!
-  * wia request v3.0.7
+  * wia request v3.0.8
   * (c) 2022-2024 Sibyl Yu and contributors
   * Released under the MIT License.
   */
@@ -625,7 +625,7 @@ class Request extends Duplex {
       // Proxy all other public ClientRequest methods
       for (const method of ['flushHeaders', 'setNoDelay', 'setSocketKeepAlive']) {
         m[method] = (a, b) => {
-          log$1.debug(method, {a, b});
+          log$1(method, {a, b});
           m._currentRequest[method](a, b);
         };
       }
@@ -635,13 +635,14 @@ class Request extends Duplex {
         Object.defineProperty(m, property, {
           get() {
             const val = m._currentRequest[property];
-            log$1.debug('get property', {property});
+            log$1('get property', {property});
             return val
           },
         });
       }
 
-      m._currentRequest.once('socket', m.startTimer);
+      // 启动 startTimer
+      if (m.startTimer) m._currentRequest.once('socket', m.startTimer);
 
       // 接收req事件，转发 到 redirectReq 发射
       for (const ev of writeEvents) req.on(ev, writeEventEmit[ev]);
@@ -863,6 +864,8 @@ class Request extends Duplex {
      * @param {*} socket
      */
     function startTimer(socket) {
+      if (m.startTimer) m.startTimer = null;
+
       if (m._timeout) clearTimeout(m._timeout);
 
       m._timeout = setTimeout(() => {
@@ -900,7 +903,7 @@ class Request extends Duplex {
 
     // Start the timer if or when the socket is opened
     if (m.socket) startTimer(m.socket);
-    else m.startTimer = startTimer; // 未连接，先登记
+    else m.startTimer = startTimer; // 未连接，先登记，连接后启动
 
     // Clean up on events
     m.on('socket', destroyOnTimeout);

package/lib/request.js

@@ -199,7 +199,7 @@ const WriteAfterEndError = utils.createErrorType('ERR_STREAM_WRITE_AFTER_END', '
                 'setSocketKeepAlive'
             ]){
                 m[method] = (a, b)=>{
-                    log.debug(method, {
+                    log(method, {
                         a,
                         b
                     });
@@ -215,14 +215,15 @@ const WriteAfterEndError = utils.createErrorType('ERR_STREAM_WRITE_AFTER_END', '
                 Object.defineProperty(m, property, {
                     get () {
                         const val = m._currentRequest[property];
-                        log.debug('get property', {
+                        log('get property', {
                             property
                         });
                         return val;
                     }
                 });
             }
-            m._currentRequest.once('socket', m.startTimer);
+            // 启动 startTimer
+            if (m.startTimer) m._currentRequest.once('socket', m.startTimer);
             // 接收req事件，转发 到 redirectReq 发射
             for (const ev of writeEvents)req.on(ev, writeEventEmit[ev]);
             // RFC7230§5.3.1: When making a request directly to an origin server, […]
@@ -402,6 +403,7 @@ const WriteAfterEndError = utils.createErrorType('ERR_STREAM_WRITE_AFTER_END', '
      * Sets up a timer to trigger a timeout event
      * @param {*} socket
      */ function startTimer(socket) {
+            if (m.startTimer) m.startTimer = null;
             if (m._timeout) clearTimeout(m._timeout);
             m._timeout = setTimeout(()=>{
                 m.emit('timeout');
@@ -432,7 +434,7 @@ const WriteAfterEndError = utils.createErrorType('ERR_STREAM_WRITE_AFTER_END', '
         if (callback) m.on('timeout', callback);
         // Start the timer if or when the socket is opened
         if (m.socket) startTimer(m.socket);
-        else m.startTimer = startTimer // 未连接，先登记
+        else m.startTimer = startTimer // 未连接，先登记，连接后启动
         ;
         // Clean up on events
         m.on('socket', destroyOnTimeout);

package/package.json

@@ -2,7 +2,7 @@
   "name": "@wiajs/request",
   "description": "Stream HTTP request client.",
   "keywords": ["http", "simple", "util", "utility"],
-  "version": "3.0.7",
+  "version": "3.0.8",
   "type": "module",
   "main": "index.js",
   "exports": {