@upcrawl/sdk 1.2.1 → 1.3.0

package/dist/index.d.mts

@@ -195,6 +195,30 @@ interface PdfResponse {
     /** Total time taken in milliseconds */
     durationMs: number;
 }
+interface ExecuteCodeOptions {
+    /** Code to execute (required) */
+    code: string;
+    /** Language runtime. Defaults to "python" */
+    language?: 'python';
+}
+interface ExecuteCodeResponse {
+    /** Standard output from the executed code */
+    stdout: string;
+    /** Standard error from the executed code */
+    stderr: string;
+    /** Process exit code (0 = success, 124 = timeout) */
+    exitCode: number;
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+    /** Whether execution was killed due to timeout */
+    timedOut: boolean;
+    /** Peak memory usage in megabytes */
+    memoryUsageMb?: number;
+    /** Error message if execution infrastructure failed */
+    error?: string;
+    /** Cost in USD for this execution */
+    cost?: number;
+}
 interface UpcrawlErrorResponse {
     error: {
         code: string;
@@ -357,6 +381,28 @@ declare function generatePdf(options: GeneratePdfOptions): Promise<PdfResponse>;
  * ```
  */
 declare function generatePdfFromUrl(options: GeneratePdfFromUrlOptions): Promise<PdfResponse>;
+/**
+ * Execute code in an isolated sandbox
+ * @param options - Code execution options including the code to run
+ * @returns Promise with execution response (stdout, stderr, exit code, memory usage)
+ *
+ * @example
+ * ```typescript
+ * import Upcrawl from '@upcrawl/sdk';
+ *
+ * Upcrawl.setApiKey('uc-your-api-key');
+ *
+ * const result = await Upcrawl.executeCode({
+ *   code: 'print("Hello, World!")',
+ *   language: 'python'
+ * });
+ *
+ * console.log(result.stdout);          // "Hello, World!\n"
+ * console.log(result.executionTimeMs); // 95.23
+ * console.log(result.memoryUsageMb);   // 8.45
+ * ```
+ */
+declare function executeCode(options: ExecuteCodeOptions): Promise<ExecuteCodeResponse>;
 
 /**
  * Upcrawl SDK
@@ -473,10 +519,16 @@ declare const Upcrawl: {
      * @returns Promise with PDF response containing the download URL
      */
     readonly generatePdfFromUrl: typeof generatePdfFromUrl;
+    /**
+     * Execute code in an isolated sandbox
+     * @param options - Code execution options including the code to run
+     * @returns Promise with execution response (stdout, stderr, exit code, memory usage)
+     */
+    readonly executeCode: typeof executeCode;
     /**
      * Error class for Upcrawl API errors
      */
     readonly UpcrawlError: typeof UpcrawlError;
 };
 
-export { type BatchScrapeOptions, type BatchScrapeResponse, type GeneratePdfFromUrlOptions, type GeneratePdfOptions, type PdfMargin, type PdfResponse, type ScrapeMetadata, type ScrapeOptions, type ScrapeResponse, type SearchOptions, type SearchResponse, type SearchResultItem, type SearchResultWeb, type SummaryQuery, type UpcrawlConfig, UpcrawlError, type UpcrawlErrorResponse, batchScrape, configure, Upcrawl as default, generatePdf, generatePdfFromUrl, getConfig, resetConfig, scrape, search, setApiKey, setBaseUrl, setTimeout };
+export { type BatchScrapeOptions, type BatchScrapeResponse, type ExecuteCodeOptions, type ExecuteCodeResponse, type GeneratePdfFromUrlOptions, type GeneratePdfOptions, type PdfMargin, type PdfResponse, type ScrapeMetadata, type ScrapeOptions, type ScrapeResponse, type SearchOptions, type SearchResponse, type SearchResultItem, type SearchResultWeb, type SummaryQuery, type UpcrawlConfig, UpcrawlError, type UpcrawlErrorResponse, batchScrape, configure, Upcrawl as default, executeCode, generatePdf, generatePdfFromUrl, getConfig, resetConfig, scrape, search, setApiKey, setBaseUrl, setTimeout };

package/dist/index.d.ts

@@ -195,6 +195,30 @@ interface PdfResponse {
     /** Total time taken in milliseconds */
     durationMs: number;
 }
+interface ExecuteCodeOptions {
+    /** Code to execute (required) */
+    code: string;
+    /** Language runtime. Defaults to "python" */
+    language?: 'python';
+}
+interface ExecuteCodeResponse {
+    /** Standard output from the executed code */
+    stdout: string;
+    /** Standard error from the executed code */
+    stderr: string;
+    /** Process exit code (0 = success, 124 = timeout) */
+    exitCode: number;
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+    /** Whether execution was killed due to timeout */
+    timedOut: boolean;
+    /** Peak memory usage in megabytes */
+    memoryUsageMb?: number;
+    /** Error message if execution infrastructure failed */
+    error?: string;
+    /** Cost in USD for this execution */
+    cost?: number;
+}
 interface UpcrawlErrorResponse {
     error: {
         code: string;
@@ -357,6 +381,28 @@ declare function generatePdf(options: GeneratePdfOptions): Promise<PdfResponse>;
  * ```
  */
 declare function generatePdfFromUrl(options: GeneratePdfFromUrlOptions): Promise<PdfResponse>;
+/**
+ * Execute code in an isolated sandbox
+ * @param options - Code execution options including the code to run
+ * @returns Promise with execution response (stdout, stderr, exit code, memory usage)
+ *
+ * @example
+ * ```typescript
+ * import Upcrawl from '@upcrawl/sdk';
+ *
+ * Upcrawl.setApiKey('uc-your-api-key');
+ *
+ * const result = await Upcrawl.executeCode({
+ *   code: 'print("Hello, World!")',
+ *   language: 'python'
+ * });
+ *
+ * console.log(result.stdout);          // "Hello, World!\n"
+ * console.log(result.executionTimeMs); // 95.23
+ * console.log(result.memoryUsageMb);   // 8.45
+ * ```
+ */
+declare function executeCode(options: ExecuteCodeOptions): Promise<ExecuteCodeResponse>;
 
 /**
  * Upcrawl SDK
@@ -473,10 +519,16 @@ declare const Upcrawl: {
      * @returns Promise with PDF response containing the download URL
      */
     readonly generatePdfFromUrl: typeof generatePdfFromUrl;
+    /**
+     * Execute code in an isolated sandbox
+     * @param options - Code execution options including the code to run
+     * @returns Promise with execution response (stdout, stderr, exit code, memory usage)
+     */
+    readonly executeCode: typeof executeCode;
     /**
      * Error class for Upcrawl API errors
      */
     readonly UpcrawlError: typeof UpcrawlError;
 };
 
-export { type BatchScrapeOptions, type BatchScrapeResponse, type GeneratePdfFromUrlOptions, type GeneratePdfOptions, type PdfMargin, type PdfResponse, type ScrapeMetadata, type ScrapeOptions, type ScrapeResponse, type SearchOptions, type SearchResponse, type SearchResultItem, type SearchResultWeb, type SummaryQuery, type UpcrawlConfig, UpcrawlError, type UpcrawlErrorResponse, batchScrape, configure, Upcrawl as default, generatePdf, generatePdfFromUrl, getConfig, resetConfig, scrape, search, setApiKey, setBaseUrl, setTimeout };
+export { type BatchScrapeOptions, type BatchScrapeResponse, type ExecuteCodeOptions, type ExecuteCodeResponse, type GeneratePdfFromUrlOptions, type GeneratePdfOptions, type PdfMargin, type PdfResponse, type ScrapeMetadata, type ScrapeOptions, type ScrapeResponse, type SearchOptions, type SearchResponse, type SearchResultItem, type SearchResultWeb, type SummaryQuery, type UpcrawlConfig, UpcrawlError, type UpcrawlErrorResponse, batchScrape, configure, Upcrawl as default, executeCode, generatePdf, generatePdfFromUrl, getConfig, resetConfig, scrape, search, setApiKey, setBaseUrl, setTimeout };

package/dist/index.js

@@ -34,6 +34,7 @@ __export(index_exports, {
   batchScrape: () => batchScrape,
   configure: () => configure,
   default: () => index_default,
+  executeCode: () => executeCode,
   generatePdf: () => generatePdf,
   generatePdfFromUrl: () => generatePdfFromUrl,
   getConfig: () => getConfig,
@@ -202,6 +203,15 @@ async function generatePdfFromUrl(options) {
     handleError(error);
   }
 }
+async function executeCode(options) {
+  try {
+    const client = createClient();
+    const response = await client.post("/sandbox/execute", options);
+    return response.data;
+  } catch (error) {
+    handleError(error);
+  }
+}
 
 // src/index.ts
 var Upcrawl = {
@@ -263,6 +273,12 @@ var Upcrawl = {
    * @returns Promise with PDF response containing the download URL
    */
   generatePdfFromUrl,
+  /**
+   * Execute code in an isolated sandbox
+   * @param options - Code execution options including the code to run
+   * @returns Promise with execution response (stdout, stderr, exit code, memory usage)
+   */
+  executeCode,
   /**
    * Error class for Upcrawl API errors
    */
@@ -274,6 +290,7 @@ var index_default = Upcrawl;
   UpcrawlError,
   batchScrape,
   configure,
+  executeCode,
   generatePdf,
   generatePdfFromUrl,
   getConfig,

package/dist/index.mjs

@@ -154,6 +154,15 @@ async function generatePdfFromUrl(options) {
     handleError(error);
   }
 }
+async function executeCode(options) {
+  try {
+    const client = createClient();
+    const response = await client.post("/sandbox/execute", options);
+    return response.data;
+  } catch (error) {
+    handleError(error);
+  }
+}
 
 // src/index.ts
 var Upcrawl = {
@@ -215,6 +224,12 @@ var Upcrawl = {
    * @returns Promise with PDF response containing the download URL
    */
   generatePdfFromUrl,
+  /**
+   * Execute code in an isolated sandbox
+   * @param options - Code execution options including the code to run
+   * @returns Promise with execution response (stdout, stderr, exit code, memory usage)
+   */
+  executeCode,
   /**
    * Error class for Upcrawl API errors
    */
@@ -226,6 +241,7 @@ export {
   batchScrape,
   configure,
   index_default as default,
+  executeCode,
   generatePdf,
   generatePdfFromUrl,
   getConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upcrawl/sdk",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "publishConfig": {
     "access": "public"
   },
@@ -18,13 +18,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "lint": "eslint src/",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
-  },
   "keywords": [
     "upcrawl",
     "web-scraping",
@@ -42,7 +35,8 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/upcrawl/upcrawl-js"
+    "url": "https://github.com/upcrawl/upcrawl-js",
+    "directory": "packages/sdk"
   },
   "homepage": "https://upcrawl.dev",
   "bugs": {
@@ -58,5 +52,12 @@
   },
   "engines": {
     "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
   }
-}
+}