simplex-ts 1.1.12 → 2.0.0

package/README.md

@@ -1,81 +1,188 @@
-# Simplex TypeScript Package Template
+# Simplex TypeScript SDK
 
-A TypeScript package for browser automation and web interaction using Simplex API.
+Official TypeScript SDK for the Simplex API.
 
-## Features
+## Installation
 
-- Browser automation with high-level commands
-- Session-based interaction
-- Element interaction (click, type, scroll)
-- Content extraction (text, images, bounding boxes)
-- File upload and download capabilities
-- TypeScript support with type definitions
-- Built with modern tooling (ESM + CommonJS output)
+```bash
+npm install simplex-typescript-sdk
+```
 
-## Getting Started
+## Quick Start
 
-1. Install dependencies:
-```bash
-npm install
+```typescript
+import { SimplexClient } from 'simplex-typescript-sdk';
+
+const client = new SimplexClient({
+  apiKey: 'YOUR_API_KEY_HERE'
+});
+
+// Run a workflow
+const result = await client.workflows.run('workflow-id', {
+  variables: {
+    username: 'john_doe',
+    product_id: '12345'
+  }
+});
+
+console.log('Session ID:', result.session_id);
 ```
 
-2. Build the package:
-```bash
-npm run build
+## Configuration
+
+```typescript
+const client = new SimplexClient({
+  apiKey: 'YOUR_API_KEY_HERE',
+  baseURL: 'https://api.simplex.sh', // Optional
+  timeout: 30000,                     // Optional: Request timeout in ms
+  maxRetries: 3,                      // Optional: Number of retries
+  retryDelay: 1000                    // Optional: Delay between retries in ms
+});
 ```
 
-3. Run tests:
-```bash
-npm test
+## API Methods
+
+### Workflows
+
+#### Run a workflow
+
+```typescript
+const result = await client.workflows.run('workflow-id', {
+  variables: { key: 'value' },
+  metadata: 'optional-metadata',
+  webhookUrl: 'https://your-webhook.com'
+});
+```
+
+#### Run with variables only
+
+```typescript
+const result = await client.workflows.runWithVariables('workflow-id', {
+  key: 'value'
+});
+```
+
+#### Create a workflow session
+
+```typescript
+const session = await client.workflows.createWorkflowSession(
+  'my-workflow-name',
+  'https://example.com',
+  {
+    sessionData: { key: 'value' },
+    proxies: false
+  }
+);
+
+console.log('Session ID:', session.session_id);
+console.log('Livestream URL:', session.livestream_url);
 ```
 
-## Usage
+### Agents
+
+#### Run an agent task
+
+Execute a specific task using the agentic endpoint:
+
+```typescript
+const result = await client.agents.agentic(
+  'Find and click the login button',
+  'session-id',
+  {
+    maxSteps: 10,
+    actionsToExclude: ['scroll', 'wait'],
+    variables: { username: 'user@example.com' }
+  }
+);
+
+console.log('Task succeeded:', result.succeeded);
+console.log('Result:', result.result);
+```
+
+#### Run a named agent
+
+Run a pre-configured agent by name:
+
+```typescript
+const result = await client.agents.run(
+  'my-agent-name',
+  'session-id',
+  {
+    key1: 'value1',
+    key2: 'value2'
+  }
+);
+
+console.log('Agent succeeded:', result.succeeded);
+console.log('Session ID:', result.session_id);
+console.log('Result:', result.result);
+```
+
+## Error Handling
+
+The SDK provides typed error classes for different error scenarios:
 
 ```typescript
-import { Simplex } from 'simplex-ts';
+import {
+  SimplexClient,
+  WorkflowError,
+  ValidationError,
+  AuthenticationError,
+  RateLimitError,
+  NetworkError
+} from 'simplex-typescript-sdk';
+
+try {
+  const result = await client.workflows.run('workflow-id');
+} catch (error) {
+  if (error instanceof WorkflowError) {
+    console.error('Workflow failed:', error.message);
+  } else if (error instanceof ValidationError) {
+    console.error('Invalid request:', error.message);
+  } else if (error instanceof AuthenticationError) {
+    console.error('Authentication failed:', error.message);
+  } else if (error instanceof RateLimitError) {
+    console.error('Rate limited. Retry after:', error.retryAfter);
+  } else if (error instanceof NetworkError) {
+    console.error('Network error:', error.message);
+  }
+}
+```
+
+## Examples
+
+The SDK includes several example files to demonstrate different use cases:
 
-// Initialize Simplex with your API key
-const simplex = new Simplex('your-api-key');
+- **`examples/basic-usage.ts`** - Basic workflow execution and status checking
+- **`examples/agent-usage.ts`** - Using the agentic endpoints for task execution
+- **`examples/agent-workflow.ts`** - Creating a workflow with sequential agent tasks
+- **`examples/agent-workflow-advanced.ts`** - Advanced workflow patterns with error handling
+
+Run examples with:
+```bash
+npx tsx examples/basic-usage.ts
+npx tsx examples/agent-workflow.ts
+```
 
-// Create a new session
-const [sessionId, livestreamUrl] = await simplex.createSession();
+## Development
 
-// Navigate to a website
-await simplex.goto('example.com');
+### Build the SDK
 
-// Interact with elements
-await simplex.click('Login button');
-await simplex.type('user@example.com');
-await simplex.pressEnter();
+```bash
+npm run build
+```
 
-// Extract content
-const text = await simplex.extractText('Welcome message');
-console.log(text);
+### Watch mode
 
-// Close the session when done
-await simplex.closeSession();
+```bash
+npm run dev
 ```
 
-### Available Methods
-
-- `createSession()` - Start a new browser session
-- `goto(url)` - Navigate to a URL
-- `click(elementDescription)` - Click an element
-- `type(text)` - Type text
-- `pressEnter()` - Press Enter key
-- `pressTab()` - Press Tab key
-- `deleteText()` - Delete text
-- `extractBbox(elementDescription)` - Get element bounding box
-- `extractText(elementDescription)` - Extract text from element
-- `extractImage(elementDescription)` - Extract image from element
-- `scroll(pixels)` - Scroll page
-- `wait(milliseconds)` - Wait for specified duration
-- `clickAndUpload(elementDescription, file)` - Click and upload file
-- `clickAndDownload(elementDescription)` - Click and download file
-- `exists(elementDescription)` - Check if element exists
-- `enqueueActions(action_array)` - Experimental, ask in Slack if you're using this!
-- `closeSession()` - Close the browser session
+### Clean build files
 
+```bash
+npm run clean
+```
 
 ## License
 

package/dist/SimplexClient.d.ts

@@ -0,0 +1,13 @@
+import { Workflow } from './resources/Workflow';
+import { Agent } from './resources/Agent';
+import { SimplexClientOptions } from './types';
+export declare class SimplexClient {
+    private httpClient;
+    workflows: Workflow;
+    agents: Agent;
+    constructor(options: SimplexClientOptions);
+    updateApiKey(apiKey: string): void;
+    setCustomHeader(key: string, value: string): void;
+    removeCustomHeader(key: string): void;
+}
+//# sourceMappingURL=SimplexClient.d.ts.map

package/dist/SimplexClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimplexClient.d.ts","sourceRoot":"","sources":["../src/SimplexClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAa;IACxB,SAAS,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;gBAET,OAAO,EAAE,oBAAoB;IAezC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjD,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAGtC"}

package/dist/SimplexClient.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimplexClient = void 0;
+const HttpClient_1 = require("./client/HttpClient");
+const Workflow_1 = require("./resources/Workflow");
+const Agent_1 = require("./resources/Agent");
+class SimplexClient {
+    constructor(options) {
+        const baseURL = options.baseURL || 'https://api.simplex.sh';
+        this.httpClient = new HttpClient_1.HttpClient({
+            baseURL,
+            apiKey: options.apiKey,
+            timeout: options.timeout,
+            retryAttempts: options.maxRetries,
+            retryDelay: options.retryDelay,
+        });
+        this.workflows = new Workflow_1.Workflow(this.httpClient);
+        this.agents = new Agent_1.Agent(this.httpClient);
+    }
+    updateApiKey(apiKey) {
+        this.httpClient.updateApiKey(apiKey);
+    }
+    setCustomHeader(key, value) {
+        this.httpClient.setHeader(key, value);
+    }
+    removeCustomHeader(key) {
+        this.httpClient.removeHeader(key);
+    }
+}
+exports.SimplexClient = SimplexClient;
+//# sourceMappingURL=SimplexClient.js.map

package/dist/SimplexClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimplexClient.js","sourceRoot":"","sources":["../src/SimplexClient.ts"],"names":[],"mappings":";;;AAAA,oDAAiD;AACjD,mDAAgD;AAChD,6CAA0C;AAG1C,MAAa,aAAa;IAKxB,YAAY,OAA6B;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,wBAAwB,CAAC;QAE5D,IAAI,CAAC,UAAU,GAAG,IAAI,uBAAU,CAAC;YAC/B,OAAO;YACP,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,aAAa,EAAE,OAAO,CAAC,UAAU;YACjC,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,aAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,YAAY,CAAC,MAAc;QACzB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,eAAe,CAAC,GAAW,EAAE,KAAa;QACxC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,kBAAkB,CAAC,GAAW;QAC5B,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;CACF;AA/BD,sCA+BC"}

package/dist/client/HttpClient.d.ts

@@ -0,0 +1,33 @@
+import { AxiosRequestConfig } from 'axios';
+export interface HttpClientConfig {
+    baseURL: string;
+    apiKey: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+    retryAttempts?: number;
+    retryDelay?: number;
+}
+export interface RequestOptions extends Omit<AxiosRequestConfig, 'baseURL'> {
+    retries?: number;
+}
+export declare class HttpClient {
+    private client;
+    private config;
+    constructor(config: HttpClientConfig);
+    private setupInterceptors;
+    private shouldRetry;
+    private delay;
+    private handleError;
+    private extractErrorMessage;
+    private extractRetryAfter;
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, data?: any, options?: RequestOptions): Promise<T>;
+    postJSON<T>(path: string, data?: any, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, data?: any, options?: RequestOptions): Promise<T>;
+    patch<T>(path: string, data?: any, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    setHeader(key: string, value: string): void;
+    removeHeader(key: string): void;
+    updateApiKey(apiKey: string): void;
+}
+//# sourceMappingURL=HttpClient.d.ts.map

package/dist/client/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../src/client/HttpClient.ts"],"names":[],"mappings":"AAAA,OAAc,EAAiB,kBAAkB,EAA6B,MAAM,OAAO,CAAC;AAG5F,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAA6B;gBAE/B,MAAM,EAAE,gBAAgB;IAsBpC,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,iBAAiB;IASnB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAK1D,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBvE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAW3E,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtE,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAKxE,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAKnE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3C,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI/B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAGnC"}

package/dist/client/HttpClient.js

@@ -0,0 +1,149 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const errors_1 = require("../errors");
+class HttpClient {
+    constructor(config) {
+        this.config = {
+            timeout: 30000,
+            headers: {},
+            retryAttempts: 3,
+            retryDelay: 1000,
+            ...config,
+        };
+        this.client = axios_1.default.create({
+            baseURL: this.config.baseURL,
+            timeout: this.config.timeout,
+            headers: {
+                'X-API-Key': this.config.apiKey,
+                'User-Agent': 'Simplex-TypeScript-SDK/1.0.0',
+                ...this.config.headers,
+            },
+        });
+        this.setupInterceptors();
+    }
+    setupInterceptors() {
+        this.client.interceptors.request.use((config) => {
+            return config;
+        }, (error) => {
+            return Promise.reject(this.handleError(error));
+        });
+        this.client.interceptors.response.use((response) => response, async (error) => {
+            const config = error.config;
+            const retries = config.retries ?? this.config.retryAttempts;
+            if (this.shouldRetry(error) && retries > 0) {
+                config.retries = retries - 1;
+                await this.delay(this.config.retryDelay);
+                return this.client.request(config);
+            }
+            return Promise.reject(this.handleError(error));
+        });
+    }
+    shouldRetry(error) {
+        if (!error.response) {
+            return true;
+        }
+        const status = error.response.status;
+        return status === 429 || status === 503 || status >= 500;
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    handleError(error) {
+        if (!error.response) {
+            return new errors_1.NetworkError(error.message);
+        }
+        const status = error.response.status;
+        const message = this.extractErrorMessage(error.response);
+        switch (status) {
+            case 400:
+                return new errors_1.ValidationError(message, error.response.data);
+            case 401:
+            case 403:
+                return new errors_1.AuthenticationError(message);
+            case 429:
+                return new errors_1.RateLimitError(message, this.extractRetryAfter(error.response));
+            default:
+                return new errors_1.SimplexError(message, status, error.response.data);
+        }
+    }
+    extractErrorMessage(response) {
+        const data = response.data;
+        if (typeof data === 'string') {
+            return data;
+        }
+        if (data && typeof data === 'object') {
+            return data.message || data.error || 'An error occurred';
+        }
+        return 'An error occurred';
+    }
+    extractRetryAfter(response) {
+        const retryAfter = response.headers['retry-after'];
+        if (retryAfter) {
+            const parsed = parseInt(retryAfter, 10);
+            return isNaN(parsed) ? undefined : parsed;
+        }
+        return undefined;
+    }
+    async get(path, options) {
+        const response = await this.client.get(path, options);
+        return response.data;
+    }
+    async post(path, data, options) {
+        // Convert to form data
+        const formData = new URLSearchParams();
+        if (data) {
+            Object.keys(data).forEach(key => {
+                const value = data[key];
+                if (value !== undefined && value !== null) {
+                    formData.append(key, typeof value === 'object' ? JSON.stringify(value) : value);
+                }
+            });
+        }
+        const response = await this.client.post(path, formData, {
+            ...options,
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                ...options?.headers,
+            },
+        });
+        return response.data;
+    }
+    async postJSON(path, data, options) {
+        const response = await this.client.post(path, data, {
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options?.headers,
+            },
+        });
+        return response.data;
+    }
+    async put(path, data, options) {
+        const response = await this.client.put(path, data, options);
+        return response.data;
+    }
+    async patch(path, data, options) {
+        const response = await this.client.patch(path, data, options);
+        return response.data;
+    }
+    async delete(path, options) {
+        const response = await this.client.delete(path, options);
+        return response.data;
+    }
+    setHeader(key, value) {
+        this.client.defaults.headers.common[key] = value;
+    }
+    removeHeader(key) {
+        delete this.client.defaults.headers.common[key];
+    }
+    updateApiKey(apiKey) {
+        this.setHeader('X-API-Key', apiKey);
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=HttpClient.js.map

package/dist/client/HttpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.js","sourceRoot":"","sources":["../../src/client/HttpClient.ts"],"names":[],"mappings":"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"}

package/dist/errors/index.d.ts

@@ -0,0 +1,22 @@
+export declare class SimplexError extends Error {
+    readonly statusCode?: number;
+    readonly data?: any;
+    constructor(message: string, statusCode?: number, data?: any);
+}
+export declare class NetworkError extends SimplexError {
+    constructor(message: string);
+}
+export declare class ValidationError extends SimplexError {
+    constructor(message: string, data?: any);
+}
+export declare class AuthenticationError extends SimplexError {
+    constructor(message: string);
+}
+export declare class RateLimitError extends SimplexError {
+    readonly retryAfter?: number;
+    constructor(message: string, retryAfter?: number);
+}
+export declare class WorkflowError extends SimplexError {
+    constructor(message: string, workflowId?: string, sessionId?: string);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,IAAI,CAAC,EAAE,GAAG,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAO7D;AAED,qBAAa,YAAa,SAAQ,YAAY;gBAChC,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAKxC;AAED,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,cAAe,SAAQ,YAAY;IAC9C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAMjD;AAED,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAKrE"}

package/dist/errors/index.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowError = exports.RateLimitError = exports.AuthenticationError = exports.ValidationError = exports.NetworkError = exports.SimplexError = void 0;
+class SimplexError extends Error {
+    constructor(message, statusCode, data) {
+        super(message);
+        this.name = 'SimplexError';
+        this.statusCode = statusCode;
+        this.data = data;
+        Object.setPrototypeOf(this, SimplexError.prototype);
+    }
+}
+exports.SimplexError = SimplexError;
+class NetworkError extends SimplexError {
+    constructor(message) {
+        super(`Network error: ${message}`);
+        this.name = 'NetworkError';
+        Object.setPrototypeOf(this, NetworkError.prototype);
+    }
+}
+exports.NetworkError = NetworkError;
+class ValidationError extends SimplexError {
+    constructor(message, data) {
+        super(message, 400, data);
+        this.name = 'ValidationError';
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+exports.ValidationError = ValidationError;
+class AuthenticationError extends SimplexError {
+    constructor(message) {
+        super(message, 401);
+        this.name = 'AuthenticationError';
+        Object.setPrototypeOf(this, AuthenticationError.prototype);
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+class RateLimitError extends SimplexError {
+    constructor(message, retryAfter) {
+        super(message, 429);
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+        Object.setPrototypeOf(this, RateLimitError.prototype);
+    }
+}
+exports.RateLimitError = RateLimitError;
+class WorkflowError extends SimplexError {
+    constructor(message, workflowId, sessionId) {
+        super(message, 500, { workflowId, sessionId });
+        this.name = 'WorkflowError';
+        Object.setPrototypeOf(this, WorkflowError.prototype);
+    }
+}
+exports.WorkflowError = WorkflowError;
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAa,SAAQ,KAAK;IAIrC,YAAY,OAAe,EAAE,UAAmB,EAAE,IAAU;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACF;AAXD,oCAWC;AAED,MAAa,YAAa,SAAQ,YAAY;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACF;AAND,oCAMC;AAED,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe,EAAE,IAAU;QACrC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAND,0CAMC;AAED,MAAa,mBAAoB,SAAQ,YAAY;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF;AAND,kDAMC;AAED,MAAa,cAAe,SAAQ,YAAY;IAG9C,YAAY,OAAe,EAAE,UAAmB;QAC9C,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AATD,wCASC;AAED,MAAa,aAAc,SAAQ,YAAY;IAC7C,YAAY,OAAe,EAAE,UAAmB,EAAE,SAAkB;QAClE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AAND,sCAMC"}

package/dist/index.d.ts

@@ -1,43 +1,4 @@
-/**
- * Example function to demonstrate package usage
- * @param name - The name to greet
- * @returns A greeting message
- */
-declare function greet(name: string): string;
-interface SessionData {
-    [key: string]: any;
-}
-declare class Simplex {
-    private apiKey;
-    private sessionId;
-    private connectUrl;
-    constructor(apiKey: string);
-    private makeRequest;
-    createSession(showInConsole?: boolean, proxies?: boolean, workflowName?: string, sessionData?: SessionData | string): Promise<[string, string]>;
-    goto(url: string, cdpUrl?: string): Promise<void>;
-    click(elementDescription: string, dropdownOptions?: boolean, cdpUrl?: string): Promise<string>;
-    hover(elementDescription: string, cdpUrl?: string): Promise<void>;
-    scrollToElement(elementDescription: string, cdpUrl?: string): Promise<void>;
-    getNetworkResponse(url: string, cdpUrl?: string): Promise<string>;
-    type(text: string, cdpUrl?: string): Promise<void>;
-    pressEnter(cdpUrl?: string): Promise<void>;
-    pressTab(cdpUrl?: string): Promise<void>;
-    deleteText(cdpUrl?: string): Promise<void>;
-    extractBbox(elementDescription: string, cdpUrl?: string): Promise<any>;
-    extractText(elementDescription: string, cdpUrl?: string): Promise<string>;
-    scroll(pixels: number, cdpUrl?: string): Promise<void>;
-    wait(milliseconds: number, cdpUrl?: string): Promise<void>;
-    clickAndUpload(elementDescription: string, filePathOrCallable: string | (() => Blob)): Promise<void>;
-    clickAndDownload(elementDescription: string): Promise<[string, string]>;
-    exists(elementDescription: string, cdpUrl?: string, maxSteps?: number): Promise<[boolean, string]>;
-    getPageURL(cdpUrl?: string): Promise<string>;
-    captureLoginSession(cdpUrl?: string): Promise<string>;
-    closeSession(): Promise<void>;
-    captchaExists(): Promise<boolean>;
-    waitForCaptcha(): Promise<boolean>;
-    setDialogSettings(accept: boolean): Promise<void>;
-    getDialogMessage(): Promise<string | undefined>;
-    enqueueActions(actions: any[]): Promise<void>;
-}
-
-export { Simplex, greet };
+export { SimplexClient } from './SimplexClient';
+export * from './types';
+export { SimplexError, NetworkError, ValidationError, AuthenticationError, RateLimitError, WorkflowError, } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,cAAc,SAAS,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,UAAU,CAAC"}