@builtwith/sdk 1.0.1 → 1.2.0

package/README.md

@@ -59,6 +59,7 @@ if (result.ok) {
 | `trust({ lookup })` | Root domain | Trust scoring |
 | `financial({ lookup })` | Root domain | Financial data |
 | `social({ lookup })` | Root domain | Social profile related domains |
+| `vector_search({ query, limit? })` | Search query | Semantic technology/category search |
 
 ### Response Format
 
@@ -124,6 +125,7 @@ All methods accept a `CancellationToken` as an optional last parameter.
 | `trust(lookup)` | `string` | Trust scoring |
 | `financial(lookup)` | `string` | Financial data |
 | `social(lookup)` | `string` | Social profile related domains |
+| `vector_search(query, limit?)` | `string`, `int?` | Semantic technology/category search |
 
 ### Response Format
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builtwith/sdk",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "BuiltWith AI-first SDK for Node.js",
   "main": "src/index.js",
   "exports": {

package/src/index.js

@@ -1,11 +1,13 @@
 'use strict';
 
 const https = require('https');
+const http = require('http');
 const { URL } = require('url');
 
 // ── Constants ──────────────────────────────────────────────────────────────────
 
 const MCP_ENDPOINT = 'https://api.builtwith.com/mcp';
+const PAYMENTS_ENDPOINT = 'https://payments.builtwith.com';
 const MAX_RETRIES = 3;
 const INITIAL_BACKOFF_MS = 1000;
 const DOMAIN_RE = /^(?!-)[a-zA-Z0-9-]{1,63}(?<!-)(\.[a-zA-Z]{2,})+$/;
@@ -100,10 +102,11 @@ function _parse_sse_body(raw_body) {
 function _http_post(url_str, body, headers, timeout_ms) {
   return new Promise((resolve, reject) => {
     const parsed = new URL(url_str);
+    const transport = parsed.protocol === 'http:' ? http : https;
     const payload = JSON.stringify(body);
     const opts = {
       hostname: parsed.hostname,
-      port: parsed.port || 443,
+      port: parsed.port || (parsed.protocol === 'http:' ? 80 : 443),
       path: parsed.pathname + parsed.search,
       method: 'POST',
       headers: {
@@ -115,7 +118,7 @@ function _http_post(url_str, body, headers, timeout_ms) {
       timeout: timeout_ms,
     };
 
-    const req = https.request(opts, (res) => {
+    const req = transport.request(opts, (res) => {
       const chunks = [];
       res.on('data', chunk => chunks.push(chunk));
       res.on('end', () => {
@@ -131,6 +134,37 @@ function _http_post(url_str, body, headers, timeout_ms) {
   });
 }
 
+function _http_get(url_str, headers, timeout_ms) {
+  return new Promise((resolve, reject) => {
+    const parsed = new URL(url_str);
+    const transport = parsed.protocol === 'http:' ? http : https;
+    const opts = {
+      hostname: parsed.hostname,
+      port: parsed.port || (parsed.protocol === 'http:' ? 80 : 443),
+      path: parsed.pathname + parsed.search,
+      method: 'GET',
+      headers: {
+        ...headers,
+        'Accept': 'application/json',
+      },
+      timeout: timeout_ms,
+    };
+
+    const req = transport.request(opts, (res) => {
+      const chunks = [];
+      res.on('data', chunk => chunks.push(chunk));
+      res.on('end', () => {
+        const raw_body = Buffer.concat(chunks).toString('utf-8');
+        resolve({ status: res.statusCode, headers: res.headers, body: raw_body });
+      });
+    });
+
+    req.on('error', reject);
+    req.on('timeout', () => { req.destroy(); reject(new Error('Request timed out')); });
+    req.end();
+  });
+}
+
 // ── Client ─────────────────────────────────────────────────────────────────────
 
 class BuiltWithClient {
@@ -140,6 +174,7 @@ class BuiltWithClient {
     }
     this._api_key = api_key;
     this._endpoint = options.endpoint || MCP_ENDPOINT;
+    this._payments_endpoint = options.payments_endpoint || PAYMENTS_ENDPOINT;
     this._max_retries = options.max_retries != null ? options.max_retries : MAX_RETRIES;
     this._timeout_ms = options.timeout_ms || 30000;
   }
@@ -236,6 +271,38 @@ class BuiltWithClient {
     return _err(last_error || new BuiltWithError('UNKNOWN_ERROR', 'Request failed', 0), mcp_tool);
   }
 
+  // ── Payment API ────────────────────────────────────────────────────────────
+
+  async _payment_request(method, path, body = null) {
+    const url = this._payments_endpoint + path;
+    const headers = { Authorization: `Bearer ${this._api_key}` };
+    try {
+      const res = method === 'GET'
+        ? await _http_get(url, headers, this._timeout_ms)
+        : await _http_post(url, body, headers, this._timeout_ms);
+
+      const status = res.status;
+
+      if (status === 400) return _err(new BuiltWithError('VALIDATION_ERROR', `HTTP 400: ${res.body.substring(0, 200)}`, status, null, 'Check request parameters.'), path);
+      if (status === 401 || status === 403) return _err(new BuiltWithError('AUTH_ERROR', 'Authentication failed. Check your API key.', status, null, 'Verify your BuiltWith API key is correct and active.'), path);
+      if (status === 402) return _err(new BuiltWithError('PAYMENT_FAILED', `HTTP 402: ${res.body.substring(0, 200)}`, status, null, 'Payment could not be processed. Check your billing details at payments.builtwith.com/agent-payment-api-config.'), path);
+      if (status === 405) return _err(new BuiltWithError('METHOD_NOT_ALLOWED', `HTTP 405: wrong HTTP method.`, status), path);
+      if (status >= 500) return _err(new BuiltWithError('SERVER_ERROR', `HTTP ${status}: ${res.body.substring(0, 200)}`, status, null, 'The server encountered an error. Try again later.'), path);
+      if (status < 200 || status >= 300) return _err(new BuiltWithError('HTTP_ERROR', `HTTP ${status}: ${res.body.substring(0, 200)}`, status), path);
+
+      let parsed;
+      try {
+        parsed = JSON.parse(res.body);
+      } catch (_) {
+        return _err(new BuiltWithError('PARSE_ERROR', 'Failed to parse response JSON.', status), path);
+      }
+
+      return _ok(parsed, parsed, path);
+    } catch (err) {
+      return _err(new BuiltWithError('NETWORK_ERROR', err.message, 0, null, 'Check network connectivity.'), path);
+    }
+  }
+
   // ── Public SDK methods ─────────────────────────────────────────────────────
 
   async domain_lookup_live(params) {
@@ -322,6 +389,34 @@ class BuiltWithClient {
     return this._request('social-api', { lookup });
   }
 
+  async vector_search(params) {
+    const { query, limit } = params || {};
+    _validate_string('query', query);
+    return this._request('vector-search', { query, ...(limit != null ? { limit } : {}) });
+  }
+
+  async payment_discovery() {
+    return this._payment_request('GET', '/v1/billing/api-discovery');
+  }
+
+  async payment_configuration() {
+    return this._payment_request('GET', '/v1/billing/api-configuration');
+  }
+
+  async payment_purchase(params) {
+    const { credits } = params || {};
+    if (credits === undefined || credits === null) {
+      throw new BuiltWithError('VALIDATION_ERROR', 'credits is required.', 0, null, 'Provide a credits value (minimum 2000).');
+    }
+    if (typeof credits !== 'number' || !Number.isInteger(credits)) {
+      throw new BuiltWithError('VALIDATION_ERROR', 'credits must be an integer.', 0, null, 'Provide a whole number of credits.');
+    }
+    if (credits < 2000) {
+      throw new BuiltWithError('VALIDATION_ERROR', 'credits must be at least 2000.', 0, null, 'Minimum purchase is 2000 credits.');
+    }
+    return this._payment_request('POST', '/v1/billing/api-purchase', { credits });
+  }
+
   // ── Prompt helpers ─────────────────────────────────────────────────────────
 
   prompt_analyze_tech_stack(params) {