@spider-cloud/spider-client 0.1.87 → 0.2.0

package/dist/client.d.ts

@@ -1,4 +1,5 @@
 import { ChunkCallbackFunction, Collection, SpiderCoreResponse, SpiderParams, SearchRequestParams, RequestParamsTransform, AIRequestParams, AIStudioTier } from "./config";
+import { SpiderBrowser, type SpiderBrowserOptions } from "spider-browser";
 /**
  * Rate limit state from API response headers.
  */
@@ -205,6 +206,18 @@ export declare class Spider {
      * @throws {AIStudioSubscriptionRequired} When subscription is not active.
      */
     aiLinks(url: string, prompt: string, params?: Omit<AIRequestParams, "prompt">): Promise<any>;
+    /**
+     * Creates a SpiderBrowser instance for WebSocket-based browser automation (CDP/BiDi).
+     * @param {Omit<SpiderBrowserOptions, 'apiKey'>} [options] - Browser options (excluding apiKey, which is inherited from the client).
+     * @returns {SpiderBrowser} A new SpiderBrowser instance.
+     */
+    browser(options?: Omit<SpiderBrowserOptions, "apiKey">): SpiderBrowser;
+    /**
+     * Generates the API URL for a recording session's video/metadata.
+     * @param {string} sessionId - The recording session ID.
+     * @returns {string} The full URL to the recording endpoint.
+     */
+    static getRecordingVideoUrl(sessionId: string): string;
     /**
      * Handles errors from API requests.
      * @param {Response} response - The fetch response object.

package/dist/client.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Spider = void 0;
 const config_1 = require("./config");
+const spider_browser_1 = require("spider-browser");
 const package_json_1 = require("../package.json");
 const stream_reader_1 = require("./utils/stream-reader");
 const exponential_backoff_1 = require("exponential-backoff");
@@ -372,6 +373,22 @@ class Spider {
     async aiLinks(url, prompt, params = {}) {
         return this._aiApiPost(config_1.APIRoutes.AILinks, { url, prompt, ...params });
     }
+    /**
+     * Creates a SpiderBrowser instance for WebSocket-based browser automation (CDP/BiDi).
+     * @param {Omit<SpiderBrowserOptions, 'apiKey'>} [options] - Browser options (excluding apiKey, which is inherited from the client).
+     * @returns {SpiderBrowser} A new SpiderBrowser instance.
+     */
+    browser(options) {
+        return new spider_browser_1.SpiderBrowser({ apiKey: this.apiKey, ...options });
+    }
+    /**
+     * Generates the API URL for a recording session's video/metadata.
+     * @param {string} sessionId - The recording session ID.
+     * @returns {string} The full URL to the recording endpoint.
+     */
+    static getRecordingVideoUrl(sessionId) {
+        return `${config_1.APISchema.url}/v1/data/recordings/${sessionId}`;
+    }
     /**
      * Handles errors from API requests.
      * @param {Response} response - The fetch response object.

package/dist/index.d.ts

@@ -1,3 +1,9 @@
 export { Spider } from "./client";
 export { Collection, setBaseUrl, APISchema, AI_STUDIO_RATE_LIMITS, AIStudioInfo, AIStudioSubscriptionRequired, AIStudioRateLimitExceeded, } from "./config";
 export type { SpiderParams, Budget, Viewport, QueryRequest, AIRequestParams, AIStudioTier, } from "./config";
+export { SpiderBrowser, SpiderPage } from "spider-browser";
+export type { SpiderBrowserOptions, SpiderEvents } from "spider-browser";
+export { Agent, act, observe, extract } from "spider-browser";
+export type { AgentOptions, AgentResult, ObserveResult } from "spider-browser";
+export { RetryEngine } from "spider-browser";
+export type { RetryOptions } from "spider-browser";

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AIStudioRateLimitExceeded = exports.AIStudioSubscriptionRequired = exports.AIStudioInfo = exports.AI_STUDIO_RATE_LIMITS = exports.APISchema = exports.setBaseUrl = exports.Collection = exports.Spider = void 0;
+exports.RetryEngine = exports.extract = exports.observe = exports.act = exports.Agent = exports.SpiderPage = exports.SpiderBrowser = exports.AIStudioRateLimitExceeded = exports.AIStudioSubscriptionRequired = exports.AIStudioInfo = exports.AI_STUDIO_RATE_LIMITS = exports.APISchema = exports.setBaseUrl = exports.Collection = exports.Spider = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "Spider", { enumerable: true, get: function () { return client_1.Spider; } });
 var config_1 = require("./config");
@@ -11,3 +11,16 @@ Object.defineProperty(exports, "AI_STUDIO_RATE_LIMITS", { enumerable: true, get:
 Object.defineProperty(exports, "AIStudioInfo", { enumerable: true, get: function () { return config_1.AIStudioInfo; } });
 Object.defineProperty(exports, "AIStudioSubscriptionRequired", { enumerable: true, get: function () { return config_1.AIStudioSubscriptionRequired; } });
 Object.defineProperty(exports, "AIStudioRateLimitExceeded", { enumerable: true, get: function () { return config_1.AIStudioRateLimitExceeded; } });
+// Browser automation
+var spider_browser_1 = require("spider-browser");
+Object.defineProperty(exports, "SpiderBrowser", { enumerable: true, get: function () { return spider_browser_1.SpiderBrowser; } });
+Object.defineProperty(exports, "SpiderPage", { enumerable: true, get: function () { return spider_browser_1.SpiderPage; } });
+// Browser AI
+var spider_browser_2 = require("spider-browser");
+Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return spider_browser_2.Agent; } });
+Object.defineProperty(exports, "act", { enumerable: true, get: function () { return spider_browser_2.act; } });
+Object.defineProperty(exports, "observe", { enumerable: true, get: function () { return spider_browser_2.observe; } });
+Object.defineProperty(exports, "extract", { enumerable: true, get: function () { return spider_browser_2.extract; } });
+// Browser retry & stealth
+var spider_browser_3 = require("spider-browser");
+Object.defineProperty(exports, "RetryEngine", { enumerable: true, get: function () { return spider_browser_3.RetryEngine; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spider-cloud/spider-client",
-  "version": "0.1.87",
+  "version": "0.2.0",
   "description": "Isomorphic Javascript SDK for Spider Cloud services",
   "scripts": {
     "test": "node --import tsx  --test __tests__/*test.ts",
@@ -8,7 +8,7 @@
     "prepublishOnly": "npm test && npm run build"
   },
   "main": "dist/index.js",
-  "types": "dist/client.d.ts",
+  "types": "dist/index.d.ts",
   "files": [
     "dist/**/*"
   ],
@@ -17,6 +17,9 @@
     "sdk",
     "web crawling",
     "web scraping",
+    "browser automation",
+    "cdp",
+    "headless",
     "api",
     "llm scraping"
   ],
@@ -29,6 +32,7 @@
     "typescript": "5.7.3"
   },
   "dependencies": {
-    "exponential-backoff": "^3.1.2"
+    "exponential-backoff": "^3.1.2",
+    "spider-browser": "^0.2.3"
   }
 }