snapapi-sdk 1.3.0 → 1.4.0

package/index.d.ts

@@ -171,6 +171,31 @@ declare class SnapAPI {
 
   /** Download a specific snapshot image. */
   getSnapshot(monitorId: string, snapshotId: string): Promise<Buffer>;
+
+  /**
+   * Analyze a webpage — extract structured text, links, headings, and AI-ready content.
+   */
+  analyze(url: string, options?: { screenshot?: boolean; selector?: string }): Promise<Record<string, unknown>>;
+
+  /**
+   * Convert a webpage to PDF. Returns a Buffer containing the PDF binary.
+   */
+  pdf(url: string, options?: {
+    format?: 'A4' | 'A3' | 'A5' | 'Letter' | 'Legal' | 'Tabloid';
+    landscape?: boolean;
+    printBackground?: boolean;
+    scale?: number;
+    marginTop?: number;
+    marginBottom?: number;
+    marginLeft?: number;
+    marginRight?: number;
+    delay?: number;
+  }): Promise<Buffer>;
+
+  /**
+   * Process multiple URLs in a single request (batch mode).
+   */
+  batch(urls: string[], endpoint?: 'screenshot' | 'analyze' | 'metadata', params?: Record<string, unknown>): Promise<Record<string, unknown>>;
 }
 
 export = SnapAPI;

package/index.js

@@ -294,6 +294,66 @@ class SnapAPI {
     });
     return res.json();
   }
+
+  /**
+   * Analyze a webpage — extract structured text, links, headings, and AI-ready content.
+   * @param {string} url - The webpage URL to analyze
+   * @param {object} [options]
+   * @param {boolean} [options.screenshot] - Include a screenshot in the response
+   * @param {string}  [options.selector]   - CSS selector to scope extraction to
+   * @returns {Promise<object>}
+   */
+  async analyze(url, options = {}) {
+    if (!url || typeof url !== 'string') {
+      throw new SnapAPIError('URL is required', 0, null);
+    }
+    const res = await this._request('GET', '/v1/analyze', { query: { url, ...options } });
+    return res.json();
+  }
+
+  /**
+   * Convert a webpage to PDF.
+   * @param {string} url - The webpage URL to convert
+   * @param {object} [options]
+   * @param {string}  [options.format]           - Paper format: "A4" | "Letter" | "A3" | "Legal" (default "A4")
+   * @param {boolean} [options.landscape]        - Landscape orientation (default false)
+   * @param {boolean} [options.printBackground]  - Print background graphics (default true)
+   * @param {number}  [options.scale]            - Page scale 0.1-2 (default 1)
+   * @param {number}  [options.marginTop]        - Top margin in px (default 20)
+   * @param {number}  [options.marginBottom]     - Bottom margin in px (default 20)
+   * @param {number}  [options.marginLeft]       - Left margin in px (default 20)
+   * @param {number}  [options.marginRight]      - Right margin in px (default 20)
+   * @returns {Promise<Buffer>}
+   */
+  async pdf(url, options = {}) {
+    if (!url || typeof url !== 'string') {
+      throw new SnapAPIError('URL is required', 0, null);
+    }
+    const query = { url };
+    for (const [key, value] of Object.entries(options)) {
+      if (value !== undefined && value !== null) {
+        query[toSnakeCase(key)] = value;
+      }
+    }
+    const res = await this._request('GET', '/v1/pdf', { query });
+    const arrayBuffer = await res.arrayBuffer();
+    return Buffer.from(arrayBuffer);
+  }
+
+  /**
+   * Process multiple URLs in a single request.
+   * @param {string[]} urls      - Array of URLs to process
+   * @param {string}   endpoint  - Target endpoint: "screenshot" | "analyze" | "metadata" (default "analyze")
+   * @param {object}   [params]  - Options passed to the endpoint for every URL
+   * @returns {Promise<object>}
+   */
+  async batch(urls, endpoint = 'analyze', params = {}) {
+    if (!Array.isArray(urls) || urls.length === 0) {
+      throw new SnapAPIError('urls must be a non-empty array', 0, null);
+    }
+    const res = await this._request('POST', '/v1/batch', { json: { urls, endpoint, params } });
+    return res.json();
+  }
 }
 
 module.exports = SnapAPI;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "snapapi-sdk",
-  "version": "1.3.0",
-  "description": "Official Node.js SDK for SnapAPI — screenshot, metadata extraction, and HTML rendering",
+  "version": "1.4.0",
+  "description": "Official Node.js SDK for SnapAPI — screenshot, analyze, PDF, metadata, monitors, and more",
   "main": "index.js",
   "types": "index.d.ts",
   "license": "MIT",