koonjs 0.5.6 → 0.6.1

package/index.d.ts

@@ -28,7 +28,7 @@ export interface KoonOptions {
   proxy?: string;
   /** Array of proxy URLs for round-robin rotation. Takes priority over `proxy`. */
   proxies?: string[];
-  /** Request timeout in milliseconds. Default: 30000. */
+  /** Request timeout in seconds. Default: 30. */
   timeout?: number;
   /** Skip TLS certificate verification. */
   ignoreTlsErrors?: boolean;
@@ -44,7 +44,7 @@ export interface KoonOptions {
   randomize?: boolean;
   /** Enable TLS session resumption. Default: true. */
   sessionResumption?: boolean;
-  /** DNS-over-HTTPS provider ("cloudflare", "google", or URL). */
+  /** DNS-over-HTTPS provider. Supported values: "cloudflare", "google". */
   doh?: string;
   /** Bind outgoing connections to a specific local IP address. */
   localAddress?: string;
@@ -87,8 +87,10 @@ export class KoonResponse {
   readonly connectionReused: boolean;
   /** Remote IP address of the peer (e.g. "1.2.3.4" or "::1"), or null for H3/QUIC. */
   readonly remoteAddress: string | null;
+  /** Content-Type header value (e.g. "text/html; charset=utf-8"), or null if absent. */
+  readonly contentType: string | null;
 
-  /** Decode response body as UTF-8 string. */
+  /** Decode response body as text, respecting the charset from the Content-Type header. Falls back to UTF-8. */
   text(): string;
   /** Parse response body as JSON (via JSON.parse()). */
   json(): any;
@@ -106,7 +108,7 @@ export interface KoonWsMessage {
 export interface KoonRequestOptions {
   /** Additional headers for this request. Override constructor-level headers. */
   headers?: Record<string, string>;
-  /** Per-request timeout in milliseconds. Overrides constructor-level timeout. */
+  /** Per-request timeout in seconds. Overrides constructor-level timeout. */
   timeout?: number;
 }
 
@@ -190,11 +192,11 @@ export interface KoonProxyOptions {
   profileJson?: string;
   /** Listen address. Default: "127.0.0.1:0". */
   listenAddr?: string;
-  /** Header mode: "forward", "replace", or "merge". */
+  /** Header mode: "impersonate" (default) or "passthrough". */
   headerMode?: string;
   /** CA certificate directory. */
   caDir?: string;
-  /** Request timeout in milliseconds. Default: 30000. */
+  /** Request timeout in seconds. Default: 30. */
   timeout?: number;
   /** Apply fingerprint randomization. */
   randomize?: boolean;

package/index.js

@@ -1,34 +1,43 @@
 const { platform, arch } = process;
-
 const platformArch = `${platform}-${arch}`;
 
-const triples = {
-  'win32-x64': 'koon.win32-x64-msvc.node',
-  'linux-x64': 'koon.linux-x64-gnu.node',
-  'darwin-x64': 'koon.darwin-x64.node',
-  'darwin-arm64': 'koon.darwin-arm64.node',
-  'linux-arm64': 'koon.linux-arm64-gnu.node',
+const packages = {
+  'win32-x64': '@koonjs/win32-x64-msvc',
+  'linux-x64': '@koonjs/linux-x64-gnu',
+  'darwin-x64': '@koonjs/darwin-x64',
+  'darwin-arm64': '@koonjs/darwin-arm64',
+  'linux-arm64': '@koonjs/linux-arm64-gnu',
+};
+
+const localFiles = {
+  'win32-x64': './koon.win32-x64-msvc.node',
+  'linux-x64': './koon.linux-x64-gnu.node',
+  'darwin-x64': './koon.darwin-x64.node',
+  'darwin-arm64': './koon.darwin-arm64.node',
+  'linux-arm64': './koon.linux-arm64-gnu.node',
 };
 
-const binding = triples[platformArch];
-if (!binding) {
+const pkg = packages[platformArch];
+if (!pkg) {
   throw new Error(
     `koon: unsupported platform ${platformArch}. ` +
-    `Supported: ${Object.keys(triples).join(', ')}`
+    `Supported: ${Object.keys(packages).join(', ')}`
   );
 }
 
 let nativeModule;
 try {
-  nativeModule = require(`./${binding}`);
-} catch (e) {
-  const hint = platform === 'darwin'
-    ? ` macOS binary may not be included in this version — try: npm install koonjs@0.5.0`
-    : ` Make sure you've built it with: cargo build --release -p koon-node`;
-  throw new Error(
-    `koon: failed to load native module ${binding}.${hint}\n` +
-    `Original error: ${e.message}`
-  );
+  nativeModule = require(pkg);
+} catch (_) {
+  try {
+    nativeModule = require(localFiles[platformArch]);
+  } catch (e) {
+    throw new Error(
+      `koon: failed to load native module for ${platformArch}.\n` +
+      `Install the platform package: npm install ${pkg}\n` +
+      `Original error: ${e.message}`
+    );
+  }
 }
 
 module.exports = nativeModule;

package/package.json

@@ -1,18 +1,31 @@
 {
   "name": "koonjs",
-  "version": "0.5.6",
+  "version": "0.6.1",
   "description": "Browser-impersonating HTTP client with TLS/HTTP2 fingerprint spoofing",
   "main": "index.js",
   "types": "index.d.ts",
   "license": "MIT",
+  "author": "Wedge",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/scrape-hub/koon.git",
+    "directory": "crates/node"
+  },
+  "homepage": "https://github.com/scrape-hub/koon",
+  "bugs": "https://github.com/scrape-hub/koon/issues",
   "engines": {
     "node": ">= 16"
   },
   "files": [
     "index.js",
-    "index.d.ts",
-    "koon.*.node"
+    "index.d.ts"
   ],
+  "optionalDependencies": {
+    "@koonjs/win32-x64-msvc": "0.6.1",
+    "@koonjs/linux-x64-gnu": "0.6.1",
+    "@koonjs/darwin-arm64": "0.6.1",
+    "@koonjs/darwin-x64": "0.6.1"
+  },
   "scripts": {
     "build": "cargo build --release -p koon-node && node -e \"require('fs').copyFileSync(require('path').resolve(__dirname,'../../target/release/koon_node.dll'), require('path').resolve(__dirname,'koon.win32-x64-msvc.node'))\"",
     "build:linux": "cargo build --release -p koon-node && cp ../../target/release/libkoon_node.so koon.linux-x64-gnu.node",