specters 2.0.0 → 2.1.3

package/README.md

@@ -40,7 +40,12 @@ main();
 ```javascript
 const { Client, FingerprintProfile } = require('@specter/client');
 
-// Impersonate Chrome 142
+// Impersonate Chrome 146 (current stable)
+const client = Client.builder()
+  .fingerprint(FingerprintProfile.Chrome146)
+  .build();
+
+// Or pick a specific version (142, 143, 144, 145, 146)
 const client = Client.builder()
   .fingerprint(FingerprintProfile.Chrome142)
   .build();

package/index.js

@@ -3,120 +3,129 @@
  *
  * A high-performance async HTTP client with full TLS, HTTP/2, and HTTP/3
  * fingerprint control for browser impersonation.
- *
- * @example
- * const { clientBuilder, FingerprintProfile } = require('@specter/client');
- *
- * async function main() {
- *   // Create a client with default settings
- *   const client = clientBuilder().build();
- *
- *   // Simple GET request
- *   const response = await client.get('https://httpbin.org/get').send();
- *   console.log(`Status: ${response.status}`);
- *   console.log(response.text());
- *
- *   // POST with JSON body
- *   const response2 = await client.post('https://api.example.com/data')
- *     .header('Authorization', 'Bearer token')
- *     .json(JSON.stringify({ name: 'test' }))
- *     .send();
- *   console.log(JSON.parse(response2.json()));
- * }
- *
- * main();
  */
 
-const { loadBinding } = require('@napi-rs/wasm-runtime');
-const path = require('path');
-
-// Try to load the native binding
-let nativeBinding;
-
-// Platform to binary name mapping based on napi-rs naming convention
-// Format: specter.{os}-{arch}[-{libc}].node
-const platformBinaries = {
-  'darwin-arm64': 'specter.darwin-arm64.node',
-  'darwin-x64': 'specter.darwin-x64.node',
-  'linux-arm64-gnu': 'specter.linux-arm64-gnu.node',
-  'linux-x64-gnu': 'specter.linux-x64-gnu.node',
-  'linux-x64-musl': 'specter.linux-x64-musl.node',
-  'win32-x64-msvc': 'specter.win32-x64-msvc.node',
+const { execSync } = require('node:child_process');
+const { readFileSync } = require('node:fs');
+
+const PACKAGE_VERSION = '2.1.3';
+
+const targets = {
+  'darwin-x64': {
+    local: './specter.darwin-x64.node',
+    package: 'specters-darwin-x64',
+  },
+  'darwin-arm64': {
+    local: './specter.darwin-arm64.node',
+    package: 'specters-darwin-arm64',
+  },
+  'linux-x64-gnu': {
+    local: './specter.linux-x64-gnu.node',
+    package: 'specters-linux-x64-gnu',
+  },
+  'linux-arm64-gnu': {
+    local: './specter.linux-arm64-gnu.node',
+    package: 'specters-linux-arm64-gnu',
+  },
 };
 
-function getPlatformKey() {
-  const platform = process.platform;
-  const arch = process.arch;
+function isMusl() {
+  if (process.platform !== 'linux') {
+    return false;
+  }
 
-  if (platform === 'darwin') {
-    return `darwin-${arch}`;
+  const report = typeof process.report?.getReport === 'function'
+    ? process.report.getReport()
+    : null;
+
+  if (report?.header?.glibcVersionRuntime) {
+    return false;
   }
-  if (platform === 'win32') {
-    return `win32-${arch}-msvc`;
+
+  if (Array.isArray(report?.sharedObjects)) {
+    return report.sharedObjects.some((file) => file.includes('libc.musl-') || file.includes('ld-musl-'));
   }
-  if (platform === 'linux') {
-    // Check if we're on musl by looking at the libc
-    const isMusl = (() => {
-      try {
-        const { execSync } = require('child_process');
-        return execSync('ldd --version 2>&1').toString().includes('musl');
-      } catch {
-        return false;
-      }
-    })();
-    return `linux-${arch}-${isMusl ? 'musl' : 'gnu'}`;
+
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf8').includes('musl');
+  } catch {
+    try {
+      return execSync('ldd --version', { encoding: 'utf8' }).includes('musl');
+    } catch {
+      return false;
+    }
+  }
+}
+
+function targetKey() {
+  if (process.platform === 'darwin') {
+    return `darwin-${process.arch}`;
+  }
+
+  if (process.platform === 'linux') {
+    return `linux-${process.arch}-${isMusl() ? 'musl' : 'gnu'}`;
+  }
+
+  return `${process.platform}-${process.arch}`;
+}
+
+function versionCheck(packageName) {
+  if (!process.env.NAPI_RS_ENFORCE_VERSION_CHECK || process.env.NAPI_RS_ENFORCE_VERSION_CHECK === '0') {
+    return;
+  }
+
+  const packageVersion = require(`${packageName}/package.json`).version;
+  if (packageVersion !== PACKAGE_VERSION) {
+    throw new Error(
+      `Native binding package version mismatch for ${packageName}: expected ${PACKAGE_VERSION}, got ${packageVersion}. ` +
+      'Reinstall dependencies to refresh optional native packages.'
+    );
   }
-  return null;
 }
 
 function loadNativeBinding() {
-  // Try platform-specific binary first
-  const platformKey = getPlatformKey();
-  if (platformKey && platformBinaries[platformKey]) {
+  const loadErrors = [];
+
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
     try {
-      nativeBinding = require(`./${platformBinaries[platformKey]}`);
-      return nativeBinding;
-    } catch (e) {
-      // Continue to fallback
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (error) {
+      loadErrors.push(error);
     }
   }
 
-  // Try all known binaries
-  for (const binaryName of Object.values(platformBinaries)) {
-    try {
-      nativeBinding = require(`./${binaryName}`);
-      return nativeBinding;
-    } catch (e) {
-      // Continue to next platform
-    }
+  const key = targetKey();
+  const target = targets[key];
+
+  if (!target) {
+    throw new Error(
+      `Unsupported Specter native target: ${key}. ` +
+      `Supported targets: ${Object.keys(targets).join(', ')}.`
+    );
   }
 
-  // Try loading from build directory
   try {
-    nativeBinding = require('./specter.node');
-    return nativeBinding;
-  } catch (e) {
-    // Fall through
+    return require(target.local);
+  } catch (error) {
+    loadErrors.push(error);
   }
 
-  // Try loading from target
   try {
-    nativeBinding = require('./build/Release/specter.node');
-    return nativeBinding;
-  } catch (e) {
-    // Fall through
+    versionCheck(target.package);
+    return require(target.package);
+  } catch (error) {
+    loadErrors.push(error);
   }
 
   throw new Error(
-    `Failed to load native binding for Specter. ` +
-    `Please ensure you've built the native module with "npm run build".`
+    `Failed to load Specter native binding for ${key}. ` +
+    `Expected optional package "${target.package}" or local binary "${target.local}".\n` +
+    loadErrors.map((error) => `- ${error.message}`).join('\n')
   );
 }
 
-// Load the binding
 const binding = loadNativeBinding();
 
-// Export the native types
 module.exports.Client = binding.Client;
 module.exports.ClientBuilder = binding.ClientBuilder;
 module.exports.RequestBuilder = binding.RequestBuilder;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specters",
-  "version": "2.0.0",
+  "version": "2.1.3",
   "description": "Node.js bindings for Specter HTTP client with TLS/HTTP2/HTTP3 fingerprint control",
   "main": "index.js",
   "types": "index.d.ts",
@@ -10,24 +10,33 @@
       "x86_64-apple-darwin",
       "aarch64-apple-darwin",
       "x86_64-unknown-linux-gnu",
-      "x86_64-unknown-linux-musl",
       "aarch64-unknown-linux-gnu"
     ]
   },
   "files": [
     "index.js",
-    "index.d.ts",
-    "*.node"
+    "index.d.ts"
   ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
   "scripts": {
     "build": "napi build --platform --release --dts index.gen.d.ts",
     "build:debug": "napi build --platform",
+    "create:npm-dirs": "napi create-npm-dirs",
     "prepublishOnly": "napi prepublish -t npm --no-gh-release",
-    "artifacts": "napi artifacts",
+    "artifacts": "napi artifacts --output-dir ./artifacts",
     "test": "jest"
   },
+  "optionalDependencies": {
+    "specters-darwin-x64": "2.1.3",
+    "specters-darwin-arm64": "2.1.3",
+    "specters-linux-x64-gnu": "2.1.3",
+    "specters-linux-arm64-gnu": "2.1.3"
+  },
   "devDependencies": {
-    "@napi-rs/cli": "^3.0.0-alpha",
+    "@napi-rs/cli": "^3.6.2",
     "jest": "^29.7.0"
   },
   "keywords": [
@@ -45,12 +54,5 @@
     "type": "git",
     "url": "https://github.com/jaredboynton/specter.git",
     "directory": "bindings/node"
-  },
-  "optionalDependencies": {
-    "specters-darwin-x64": "2.0.0",
-    "specters-darwin-arm64": "2.0.0",
-    "specters-linux-x64-gnu": "2.0.0",
-    "specters-linux-x64-musl": "2.0.0",
-    "specters-linux-arm64-gnu": "2.0.0"
   }
 }