@warppay402/sdk 1.0.2 → 1.0.6

package/README.md

@@ -17,22 +17,46 @@ const client = new WarpPayClient({
 });
 
 async function main() {
-  // Scrapes any URL into clean Markdown ($0.01 USDC)
+  // 1. Scrape any URL into clean Markdown ($0.01 USDC)
   const page = await client.scrapeWeb("https://news.ycombinator.com");
   console.log("Title:", page.title);
   console.log("Markdown:", page.markdown);
 
-  // Fetch Base wallet analytics ($0.02 USDC)
+  // 2. JS Browser Scraper ($0.05 USDC)
+  const rendered = await client.browserScrape("https://example.com");
+  console.log("Rendered Content:", rendered);
+
+  // 3. Capture Full-Page Screenshot ($0.10 USDC)
+  const screenshot = await client.renderScreenshot("https://example.com");
+  console.log("Screenshot Data:", screenshot);
+
+  // 4. Extract Structured JSON Data ($0.15 USDC)
+  const extracted = await client.extractJson("https://news.ycombinator.com", {
+    title: "string",
+    topStories: "array",
+  });
+  console.log("Extracted Data:", extracted);
+
+  // 5. Fetch Base Wallet Analytics ($0.02 USDC)
   const analytics = await client.getBaseAnalytics("0x556c77792642E8ff95eC930FFb8D46a76579126E");
   console.log("ETH Balance:", analytics.ethBalance);
 
-  // Extract PDF text preview ($0.05 USDC)
-  const pdf = await client.extractPdf("https://example.com/document.pdf");
+  // 6. Extract PDF Text Preview ($0.05 USDC)
+  const pdf = await client.extractPdf("https://example.com/document.pdf");  
   console.log("Preview:", pdf.textPreview);
 }
 
 main();
 ```
+## 🛠️ Available Methods & Pricing
+
+* **`scrapeWeb(url)`** — `$0.01 USDC` — Extracts clean Markdown from web pages.
+* **`getBaseAnalytics(address)`** — `$0.02 USDC` — Fetches ETH balance and nonce stats.
+* **`browserScrape(url)`** — `$0.05 USDC` — Unblockable JS browser scraping via proxy workers.
+* **`extractPdf(pdfUrl)`** — `$0.05 USDC` — Parses text preview from public PDF URLs.
+* **`renderScreenshot(url)`** — `$0.10 USDC` — Renders target URL and returns full-page screenshot data.
+* **`extractJson(url, schema?)`** — `$0.15 USDC` — Parses web pages into structured JSON data.
+
 ## 🛠️ LangChain Integration
 ```typescript
 import { WarpPayClient, createWarpPayLangChainTools } from "@warppay402/sdk";

package/dist/index.d.ts

@@ -24,6 +24,23 @@ export interface PdfExtractorResponse {
     info: Record<string, any>;
     textPreview: string;
 }
+export interface BrowserScrapeResponse {
+    success: boolean;
+    url: string;
+    content: string;
+}
+export interface ScreenshotResponse {
+    success: boolean;
+    url: string;
+    screenshotUrl?: string;
+    base64?: string;
+}
+export interface ExtractJsonResponse {
+    success: boolean;
+    url: string;
+    schema: any;
+    extractedData: Record<string, any>;
+}
 export declare class WarpPayClient {
     private baseUrl;
     private account;
@@ -45,4 +62,16 @@ export declare class WarpPayClient {
      * Downloads and extracts text preview from a public PDF URL ($0.05 USDC on Base)
      */
     extractPdf(pdfUrl: string): Promise<PdfExtractorResponse>;
+    /**
+     * Executes JS-rendering browser scraper via proxy workers ($0.05 USDC on Base)
+     */
+    browserScrape(url: string): Promise<BrowserScrapeResponse>;
+    /**
+     * Renders target URL and returns full-page screenshot data ($0.10 USDC on Base)
+     */
+    renderScreenshot(url: string): Promise<ScreenshotResponse>;
+    /**
+     * Extracts structured JSON schema data from web pages ($0.15 USDC on Base)
+     */
+    extractJson(url: string, schema?: object): Promise<ExtractJsonResponse>;
 }

package/dist/index.js

@@ -121,5 +121,23 @@ class WarpPayClient {
     async extractPdf(pdfUrl) {
         return this.executePaidRequest("/api/v1/tools/pdf-extractor", { pdfUrl });
     }
+    /**
+     * Executes JS-rendering browser scraper via proxy workers ($0.05 USDC on Base)
+     */
+    async browserScrape(url) {
+        return this.executePaidRequest("/api/v1/tools/browser-scraper", { url });
+    }
+    /**
+     * Renders target URL and returns full-page screenshot data ($0.10 USDC on Base)
+     */
+    async renderScreenshot(url) {
+        return this.executePaidRequest("/api/v1/tools/render-screenshot", { url });
+    }
+    /**
+     * Extracts structured JSON schema data from web pages ($0.15 USDC on Base)
+     */
+    async extractJson(url, schema) {
+        return this.executePaidRequest("/api/v1/tools/extract-json", { url, schema });
+    }
 }
 exports.WarpPayClient = WarpPayClient;

package/openclaw.plugin.json

@@ -0,0 +1,6 @@
+{
+  "id": "warppay402-sdk",
+  "name": "warppay402-sdk",
+  "version": "1.0.4",
+  "description": "Official TypeScript SDK for WarpPay402 pay-per-use AI tools on Base Mainnet"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warppay402/sdk",
-  "version": "1.0.2",
+  "version": "1.0.6",
   "description": "Official TypeScript SDK for WarpPay402 pay-per-use AI tools on Base Mainnet",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -30,5 +30,26 @@
   "devDependencies": {
     "@types/node": "^26.2.0",
     "typescript": "^5.0.0"
+  },
+  "openclaw": {
+    "compat": {
+      "pluginApi": "1.0.0"
+    },
+    "build": {
+      "openclawVersion": "1.0.0"
+    },
+    "extensions": [
+      "dist/index.js"
+    ],
+    "configSchema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "privateKey": {
+          "type": "string",
+          "description": "Base wallet private key for paying x402 micropayments"
+        }
+      }
+    }
   }
 }

package/src/index.ts

@@ -32,6 +32,26 @@ export interface PdfExtractorResponse {
   textPreview: string;
 }
 
+export interface BrowserScrapeResponse {
+  success: boolean;
+  url: string;
+  content: string;
+}
+
+export interface ScreenshotResponse {
+  success: boolean;
+  url: string;
+  screenshotUrl?: string;
+  base64?: string;
+}
+
+export interface ExtractJsonResponse {
+  success: boolean;
+  url: string;
+  schema: any;
+  extractedData: Record<string, any>;
+}
+
 export class WarpPayClient {
   private baseUrl: string;
   private account;
@@ -165,4 +185,25 @@ export class WarpPayClient {
   public async extractPdf(pdfUrl: string): Promise<PdfExtractorResponse> {
     return this.executePaidRequest<PdfExtractorResponse>("/api/v1/tools/pdf-extractor", { pdfUrl });
   }
+
+  /**
+   * Executes JS-rendering browser scraper via proxy workers ($0.05 USDC on Base)
+   */
+  public async browserScrape(url: string): Promise<BrowserScrapeResponse> {
+    return this.executePaidRequest<BrowserScrapeResponse>("/api/v1/tools/browser-scraper", { url });
+  }
+
+  /**
+   * Renders target URL and returns full-page screenshot data ($0.10 USDC on Base)
+   */
+  public async renderScreenshot(url: string): Promise<ScreenshotResponse> {
+    return this.executePaidRequest<ScreenshotResponse>("/api/v1/tools/render-screenshot", { url });
+  }
+
+  /**
+   * Extracts structured JSON schema data from web pages ($0.15 USDC on Base)
+   */
+  public async extractJson(url: string, schema?: object): Promise<ExtractJsonResponse> {
+    return this.executePaidRequest<ExtractJsonResponse>("/api/v1/tools/extract-json", { url, schema });
+  }
 }