specters 3.1.0 → 3.2.0

package/README.md

@@ -10,6 +10,8 @@ Node.js bindings for Specter, a high-performance async HTTP client with TLS, HTT
 - Cookie store and shared cookie jar support across HTTP and WebSocket handshakes
 - Granular connect, TTFB, read/write idle, total, pool, and WebSocket handshake timeouts
 
+Supported Chrome profiles are `FingerprintProfile.Chrome142` through `FingerprintProfile.Chrome148`; examples use `Chrome148`, the latest implemented profile.
+
 ## Installation
 
 ```bash
@@ -22,7 +24,7 @@ npm install specters
 const { clientBuilder, FingerprintProfile } = require('specters');
 
 const client = clientBuilder()
-  .fingerprint(FingerprintProfile.Chrome142)
+  .fingerprint(FingerprintProfile.Chrome148)
   .cookieStore(true)
   .build();
 

package/index.d.ts

@@ -4,6 +4,8 @@ export enum FingerprintProfile {
   Chrome144,
   Chrome145,
   Chrome146,
+  Chrome147,
+  Chrome148,
   Firefox133,
   None,
 }
@@ -55,7 +57,9 @@ export interface H3TunnelEvent {
 export class RequestBuilder {
   header(key: string, value: string): this;
   headers(headers: string[][]): this;
+  version(version: HttpVersion): this;
   body(body: Buffer): this;
+  bodyStream(body: AsyncIterable<Buffer | Uint8Array>): this;
   json(jsonStr: string): this;
   form(formStr: string): this;
   send(): Promise<Response>;
@@ -64,6 +68,7 @@ export class RequestBuilder {
 export class Response {
   get status(): number;
   get headers(): Record<string, string>;
+  get body(): AsyncIterable<Buffer>;
   headersList(): string[][];
   getHeader(name: string): string | null;
   text(): string;

package/index.js

@@ -130,6 +130,7 @@ module.exports.Client = binding.Client;
 module.exports.ClientBuilder = binding.ClientBuilder;
 module.exports.RequestBuilder = binding.RequestBuilder;
 module.exports.Response = binding.Response;
+module.exports.BodyStreamBridge = binding.BodyStreamBridge;
 module.exports.CookieJar = binding.CookieJar;
 module.exports.WebSocketBuilder = binding.WebSocketBuilder;
 module.exports.WebSocket = binding.WebSocket;
@@ -157,3 +158,67 @@ module.exports.isValidCloseCode = binding.isValidCloseCode;
 module.exports.clientBuilder = binding.clientBuilder;
 module.exports.timeoutsApiDefaults = binding.timeoutsApiDefaults;
 module.exports.timeoutsStreamingDefaults = binding.timeoutsStreamingDefaults;
+
+const requestBuilderSend = binding.RequestBuilder.prototype.send;
+const requestBuilderBodyStreamBridge = binding.RequestBuilder.prototype.bodyStreamBridge;
+
+binding.RequestBuilder.prototype.bodyStream = function bodyStream(asyncIterable) {
+  if (!asyncIterable || typeof asyncIterable[Symbol.asyncIterator] !== 'function') {
+    throw new TypeError('bodyStream expects an AsyncIterable<Buffer | Uint8Array>');
+  }
+
+  const bridge = new binding.BodyStreamBridge();
+  requestBuilderBodyStreamBridge.call(this, bridge);
+  Object.defineProperty(this, '__specterBodyStream', {
+    value: { asyncIterable, bridge },
+    configurable: true,
+  });
+  return this;
+};
+
+binding.RequestBuilder.prototype.send = function send() {
+  const streamState = this.__specterBodyStream;
+  if (!streamState) {
+    return requestBuilderSend.call(this);
+  }
+
+  const pump = (async () => {
+    try {
+      for await (const chunk of streamState.asyncIterable) {
+        if (chunk == null) {
+          throw new TypeError('bodyStream chunks must be Buffer or Uint8Array values');
+        }
+        await streamState.bridge.write(Buffer.from(chunk));
+      }
+      streamState.bridge.close();
+    } catch (error) {
+      await streamState.bridge.fail(error?.message || String(error));
+    }
+  })();
+
+  pump.catch(() => {});
+  return requestBuilderSend.call(this).finally(() => {
+    streamState.bridge.close();
+  });
+};
+
+Object.defineProperty(binding.Response.prototype, 'body', {
+  configurable: true,
+  enumerable: true,
+  get() {
+    const response = this;
+    return {
+      [Symbol.asyncIterator]() {
+        return {
+          async next() {
+            const chunk = await response.nextBodyChunk();
+            if (chunk === null || chunk === undefined) {
+              return { done: true, value: undefined };
+            }
+            return { done: false, value: chunk };
+          },
+        };
+      },
+    };
+  },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specters",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Node.js bindings for Specter HTTP, WebSocket, HTTP/2, and HTTP/3 tunnel client",
   "main": "index.js",
   "types": "index.d.ts",
@@ -35,10 +35,10 @@
     ]
   },
   "optionalDependencies": {
-    "specters-darwin-x64": "3.1.0",
-    "specters-darwin-arm64": "3.1.0",
-    "specters-linux-x64-gnu": "3.1.0",
-    "specters-linux-arm64-gnu": "3.1.0"
+    "specters-darwin-x64": "3.2.0",
+    "specters-darwin-arm64": "3.2.0",
+    "specters-linux-x64-gnu": "3.2.0",
+    "specters-linux-arm64-gnu": "3.2.0"
   },
   "devDependencies": {
     "@napi-rs/cli": "^3.6.2",