maxun-sdk 0.0.1

package/README.md

@@ -0,0 +1,58 @@
+# Maxun SDK
+
+The official Node.js SDK for [Maxun](https://maxun.dev) - turn any website into an API.
+
+Works with both Maxun Cloud and Maxun Open Source - automatically handles the differences for you.
+
+https://github.com/user-attachments/assets/71a6f10b-5b2a-45dd-9ef7-53d0bcf2b76d
+
+
+## What can you do with Maxun SDK?
+
+- **Extract structured data** from any website 
+- **Scrape entire pages** as Markdown or HTML
+- **Use AI to extract data** with natural language prompts
+- **Capture screenshots** (visible area or full page)
+- **Automate workflows** with clicks, form fills, and navigation
+- **Schedule recurring jobs** to keep your data fresh
+- **Get webhooks** when extractions complete
+- **Handle pagination** automatically (scroll, click, load more)
+
+## Quick Start
+Follow the quick-start guide here: https://docs.maxun.dev/sdk/sdk-overview
+
+## Table of Contents
+
+1. [Extract Robots](https://docs.maxun.dev/sdk/sdk-extract)
+   - [LLM Extraction (Beta)](https://docs.maxun.dev/sdk/sdk-extract#llm-extraction-beta)
+   - [Non-LLM Extraction](https://docs.maxun.dev/sdk/sdk-extract#non-llm-extraction)
+   - [Auto Pagination](https://docs.maxun.dev/sdk/sdk-extract#2-auto-pagination-optional)
+   - [Auto List Capture](https://docs.maxun.dev/sdk/sdk-extract#1-auto-list-capture)
+
+2. [Scrape Robots](https://docs.maxun.dev/sdk/sdk-scrape)
+
+3. [Robot Management](https://docs.maxun.dev/sdk/sdk-robot)
+   - [Scheduling](https://docs.maxun.dev/sdk/sdk-robot#scheduling)
+   - [Webhooks](https://docs.maxun.dev/sdk/sdk-robot#webhooks)
+   - [Runs](https://docs.maxun.dev/sdk/sdk-robot#running-robots)
+   - [Error Handling](https://docs.maxun.dev/sdk/sdk-robot#error-handling)
+   - [Execution History](https://docs.maxun.dev/sdk/sdk-robot#execution-history)
+
+
+## Examples
+
+Check out the [examples](./examples) directory for complete working examples:
+
+| Example | What it does |
+|---------|-------------|
+| [basic-extraction.ts](./examples/basic-extraction.ts) | Extract fields from a single page |
+| [list-pagination.ts](./examples/list-pagination.ts) | Scrape lists with different pagination strategies |
+| [form-fill-screenshot.ts](./examples/form-fill-screenshot.ts) | Fill forms and capture screenshots |
+| [chained-extract.ts](./examples/chained-extract.ts) | Execute multiple capture actions with one robot |
+| [simple-scrape.ts](./examples/simple-scrape.ts) | Convert pages to Markdown/HTML/Screenshots |
+| [llm-extraction.ts](./examples/llm-extraction.ts) | AI-powered extraction with natural language |
+| [scheduling.ts](./examples/scheduling.ts) | Set up robot schedules to execute runs |
+| [webhooks.ts](./examples/webhooks.ts) | Configure webhook notifications |
+| [robot-management.ts](./examples/robot-management.ts) | CRUD operations for robots |
+| [complete-workflow.ts](./examples/complete-workflow.ts) | Create a robot combining multiple features |
+

package/dist/builders/extract-builder.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Extract-specific workflow builder
+ */
+import { WorkflowBuilder } from './workflow-builder';
+import { ExtractListConfig, ExtractFields } from '../types';
+import type { Robot } from '../robot/robot';
+export declare class ExtractBuilder extends WorkflowBuilder implements PromiseLike<Robot> {
+    private extractor;
+    constructor(name: string);
+    /**
+     * Set the parent extractor (called internally)
+     */
+    setExtractor(extractor: any): this;
+    /**
+     * Capture specific text fields from the page
+     */
+    captureText(fields: ExtractFields, name?: string): this;
+    /**
+     * Capture a list of items with pagination support
+     * All fields are automatically detected and extracted
+     *
+     * @param config - List extraction configuration
+     * @param config.selector - CSS selector for list items
+     * @param config.pagination - Optional pagination configuration
+     * @param config.maxItems - Maximum number of items to extract (default: 100)
+     * @param name - Optional action name
+     */
+    captureList(config: ExtractListConfig, name?: string): this;
+    /**
+     * Make the builder awaitable - converts builder to Robot instance
+     */
+    then<TResult1 = Robot, TResult2 = never>(onfulfilled?: ((value: Robot) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
+}
+//# sourceMappingURL=extract-builder.d.ts.map

package/dist/builders/extract-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-builder.d.ts","sourceRoot":"","sources":["../../src/builders/extract-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAoB,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,qBAAa,cAAe,SAAQ,eAAgB,YAAW,WAAW,CAAC,KAAK,CAAC;IAC/E,OAAO,CAAC,SAAS,CAAW;gBAEhB,IAAI,EAAE,MAAM;IAIxB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI;IAKlC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAWvD;;;;;;;;;OASG;IACH,WAAW,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAsB3D;;OAEG;IACH,IAAI,CAAC,QAAQ,GAAG,KAAK,EAAE,QAAQ,GAAG,KAAK,EACrC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EACzE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GACtE,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAUpC"}

package/dist/builders/extract-builder.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Extract-specific workflow builder
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtractBuilder = void 0;
+const workflow_builder_1 = require("./workflow-builder");
+class ExtractBuilder extends workflow_builder_1.WorkflowBuilder {
+    constructor(name) {
+        super(name, 'extract');
+    }
+    /**
+     * Set the parent extractor (called internally)
+     */
+    setExtractor(extractor) {
+        this.extractor = extractor;
+        return this;
+    }
+    /**
+     * Capture specific text fields from the page
+     */
+    captureText(fields, name) {
+        // Pass fields directly as plain selectors
+        this.addAction({
+            action: 'scrapeSchema',
+            args: [fields],
+            name: name,
+        });
+        return this;
+    }
+    /**
+     * Capture a list of items with pagination support
+     * All fields are automatically detected and extracted
+     *
+     * @param config - List extraction configuration
+     * @param config.selector - CSS selector for list items
+     * @param config.pagination - Optional pagination configuration
+     * @param config.maxItems - Maximum number of items to extract (default: 100)
+     * @param name - Optional action name
+     */
+    captureList(config, name) {
+        const scrapeListConfig = {
+            itemSelector: config.selector,
+            maxItems: config.maxItems || 100
+        };
+        if (config.pagination) {
+            scrapeListConfig.pagination = {
+                type: config.pagination.type,
+                selector: config.pagination.selector || null
+            };
+        }
+        this.addAction({
+            action: 'scrapeList',
+            args: [scrapeListConfig],
+            name: name,
+        });
+        return this;
+    }
+    /**
+     * Make the builder awaitable - converts builder to Robot instance
+     */
+    then(onfulfilled, onrejected) {
+        if (!this.extractor) {
+            return Promise.reject(new Error('Builder not properly initialized. Use extractor.create() to create a builder.')).then(onfulfilled, onrejected);
+        }
+        // Build and convert to Robot
+        return this.extractor.build(this).then(onfulfilled, onrejected);
+    }
+}
+exports.ExtractBuilder = ExtractBuilder;
+//# sourceMappingURL=extract-builder.js.map

package/dist/builders/extract-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-builder.js","sourceRoot":"","sources":["../../src/builders/extract-builder.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yDAAqD;AAKrD,MAAa,cAAe,SAAQ,kCAAe;IAGjD,YAAY,IAAY;QACtB,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAc;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAqB,EAAE,IAAa;QAC9C,0CAA0C;QAC1C,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,CAAC,MAAM,CAAC;YACd,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;OASG;IACH,WAAW,CAAC,MAAyB,EAAE,IAAa;QAClD,MAAM,gBAAgB,GAAQ;YAC5B,YAAY,EAAE,MAAM,CAAC,QAAQ;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,GAAG;SACjC,CAAC;QAEF,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,gBAAgB,CAAC,UAAU,GAAG;gBAC5B,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI;gBAC5B,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ,IAAI,IAAI;aAC7C,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,CAAC,gBAAgB,CAAC;YACxB,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,CACF,WAAyE,EACzE,UAAuE;QAEvE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAC3F,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAClC,CAAC;QAED,6BAA6B;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;CACF;AA7ED,wCA6EC"}

package/dist/builders/workflow-builder.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Base Workflow Builder
+ * Provides common functionality for building Maxun workflows
+ */
+import { Workflow, WhereWhatPair, What, RobotMeta, RobotType, RobotMode, Format } from '../types';
+export declare abstract class WorkflowBuilder {
+    protected name: string;
+    protected robotType: RobotType;
+    protected workflow: Workflow;
+    protected meta: Partial<RobotMeta>;
+    protected currentStep: WhereWhatPair | null;
+    private isFirstNavigation;
+    constructor(name: string, robotType: RobotType);
+    /**
+     * Navigate to a URL
+     */
+    navigate(url: string): this;
+    /**
+     * Click on an element
+     */
+    click(selector: string): this;
+    /**
+     * Type text into an input
+     * The input type will be automatically detected during validation if not provided
+     */
+    type(selector: string, text: string, inputType?: string): this;
+    /**
+     * Wait for a selector to appear
+     */
+    waitFor(selector: string, timeout?: number): this;
+    /**
+     * Wait for a specific duration
+     */
+    wait(milliseconds: number): this;
+    /**
+     * Capture a screenshot
+     */
+    captureScreenshot(name?: string, options?: {
+        fullPage?: boolean;
+        type?: 'png' | 'jpeg';
+        quality?: number;
+        timeout?: number;
+        caret?: 'hide' | 'initial';
+        scale?: 'css' | 'device';
+        animations?: 'disabled' | 'allow';
+    }): this;
+    /**
+     * Scroll the page
+     */
+    scroll(direction: 'up' | 'down' | 'top' | 'bottom', distance?: number): this;
+    /**
+     * Set cookies
+     */
+    setCookies(cookies: Array<{
+        name: string;
+        value: string;
+        domain?: string;
+    }>): this;
+    /**
+     * Set robot mode (normal or bulk)
+     */
+    mode(mode: RobotMode): this;
+    /**
+     * Set output formats
+     */
+    format(formats: Format[]): this;
+    /**
+     * Add a new step to the workflow
+     */
+    protected addStep(step: WhereWhatPair): void;
+    /**
+     * Add an action to the current step
+     * Actions are added to the end since what[] executes top-to-bottom
+     */
+    protected addAction(action: What): void;
+    /**
+     * Get the built workflow (array only)
+     */
+    getWorkflowArray(): Workflow;
+    /**
+     * Get the complete workflow structure with metadata
+     */
+    getWorkflow(): {
+        meta: Partial<RobotMeta>;
+        workflow: Workflow;
+    };
+    /**
+     * Get the robot metadata
+     */
+    getMeta(): Partial<RobotMeta>;
+}
+//# sourceMappingURL=workflow-builder.d.ts.map

package/dist/builders/workflow-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-builder.d.ts","sourceRoot":"","sources":["../../src/builders/workflow-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,QAAQ,EACR,aAAa,EAEb,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,EACT,MAAM,EACP,MAAM,UAAU,CAAC;AAElB,8BAAsB,eAAe;IAMvB,SAAS,CAAC,IAAI,EAAE,MAAM;IAAE,SAAS,CAAC,SAAS,EAAE,SAAS;IALlE,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAM;IAClC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAM;IACxC,SAAS,CAAC,WAAW,EAAE,aAAa,GAAG,IAAI,CAAQ;IACnD,OAAO,CAAC,iBAAiB,CAAiB;gBAEpB,IAAI,EAAE,MAAM,EAAY,SAAS,EAAE,SAAS;IAKlE;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAqC3B;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ7B;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAY9D;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAQjD;;OAEG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAQhC;;OAEG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;QACzB,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;KACnC,GAAG,IAAI;IA0BR;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ5E;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAOlF;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAM3B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAK/B;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAK5C;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI;IAavC;;OAEG;IACH,gBAAgB,IAAI,QAAQ;IAI5B;;OAEG;IACH,WAAW,IAAI;QAAE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE;IAO/D;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;CAG9B"}

package/dist/builders/workflow-builder.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * Base Workflow Builder
+ * Provides common functionality for building Maxun workflows
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowBuilder = void 0;
+class WorkflowBuilder {
+    constructor(name, robotType) {
+        this.name = name;
+        this.robotType = robotType;
+        this.workflow = [];
+        this.meta = {};
+        this.currentStep = null;
+        this.isFirstNavigation = true;
+        this.meta.name = name;
+        this.meta.robotType = robotType;
+    }
+    /**
+     * Navigate to a URL
+     */
+    navigate(url) {
+        // Create the main step (no goto action here)
+        const mainStep = {
+            where: { url },
+            what: [],
+        };
+        // Only add about:blank on FIRST navigation
+        if (this.isFirstNavigation) {
+            // Create the about:blank step
+            const aboutBlankStep = {
+                where: { url: 'about:blank' },
+                what: [
+                    {
+                        action: 'goto',
+                        args: [url],
+                    },
+                    {
+                        action: 'waitForLoadState',
+                        args: ['networkidle'],
+                    },
+                ],
+            };
+            // Add main step to front, about:blank to end (bottom)
+            this.workflow.unshift(mainStep);
+            this.workflow.push(aboutBlankStep);
+            this.isFirstNavigation = false;
+        }
+        else {
+            // Subsequent navigations: add to front
+            this.workflow.unshift(mainStep);
+        }
+        this.currentStep = mainStep;
+        return this;
+    }
+    /**
+     * Click on an element
+     */
+    click(selector) {
+        this.addAction({
+            action: 'click',
+            args: [selector],
+        });
+        return this;
+    }
+    /**
+     * Type text into an input
+     * The input type will be automatically detected during validation if not provided
+     */
+    type(selector, text, inputType) {
+        const args = inputType
+            ? [selector, text, inputType] // User specified type
+            : [selector, text]; // Will be auto-detected by enricher
+        this.addAction({
+            action: 'type',
+            args: args,
+        });
+        return this;
+    }
+    /**
+     * Wait for a selector to appear
+     */
+    waitFor(selector, timeout) {
+        this.addAction({
+            action: 'waitForSelector',
+            args: [selector, { timeout: timeout || 30000 }],
+        });
+        return this;
+    }
+    /**
+     * Wait for a specific duration
+     */
+    wait(milliseconds) {
+        this.addAction({
+            action: 'waitForTimeout',
+            args: [milliseconds],
+        });
+        return this;
+    }
+    /**
+     * Capture a screenshot
+     */
+    captureScreenshot(name, options) {
+        const screenshotArgs = options ? {
+            type: options.type || 'png',
+            caret: options.caret || 'hide',
+            scale: options.scale || 'device',
+            timeout: options.timeout || 30000,
+            fullPage: options.fullPage !== undefined ? options.fullPage : true,
+            animations: options.animations || 'allow',
+            ...(options.quality && { quality: options.quality })
+        } : {
+            type: 'png',
+            caret: 'hide',
+            scale: 'device',
+            timeout: 30000,
+            fullPage: true,
+            animations: 'allow'
+        };
+        this.addAction({
+            action: 'screenshot',
+            name: name,
+            args: [screenshotArgs]
+        });
+        return this;
+    }
+    /**
+     * Scroll the page
+     */
+    scroll(direction, distance) {
+        this.addAction({
+            action: 'scroll',
+            args: [{ direction, distance }],
+        });
+        return this;
+    }
+    /**
+     * Set cookies
+     */
+    setCookies(cookies) {
+        if (this.currentStep) {
+            this.currentStep.where.cookies = cookies;
+        }
+        return this;
+    }
+    /**
+     * Set robot mode (normal or bulk)
+     */
+    mode(mode) {
+        this.meta.mode = mode;
+        return this;
+    }
+    /**
+     * Set output formats
+     */
+    format(formats) {
+        this.meta.formats = formats;
+        return this;
+    }
+    /**
+     * Add a new step to the workflow
+     */
+    addStep(step) {
+        this.currentStep = step;
+        this.workflow.unshift(step);
+    }
+    /**
+     * Add an action to the current step
+     * Actions are added to the end since what[] executes top-to-bottom
+     */
+    addAction(action) {
+        if (!this.currentStep) {
+            // Create a new step if none exists
+            this.addStep({
+                where: {},
+                what: [action],
+            });
+        }
+        else {
+            // Use push to add to end - top-to-bottom execution
+            this.currentStep.what.push(action);
+        }
+    }
+    /**
+     * Get the built workflow (array only)
+     */
+    getWorkflowArray() {
+        return this.workflow;
+    }
+    /**
+     * Get the complete workflow structure with metadata
+     */
+    getWorkflow() {
+        return {
+            meta: this.meta,
+            workflow: this.workflow
+        };
+    }
+    /**
+     * Get the robot metadata
+     */
+    getMeta() {
+        return this.meta;
+    }
+}
+exports.WorkflowBuilder = WorkflowBuilder;
+//# sourceMappingURL=workflow-builder.js.map

package/dist/builders/workflow-builder.js.map

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

package/dist/client/maxun-client.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Maxun API Client
+ * Handles all HTTP communication with the Maxun backend API
+ */
+import { Config, RobotData, Run, RunResult, ScheduleConfig, WebhookConfig, WorkflowFile, ExecutionOptions } from '../types';
+export declare class Client {
+    private axios;
+    private apiKey;
+    constructor(config: Config);
+    /**
+     * Handle API errors and convert to MaxunError
+     */
+    private handleError;
+    /**
+     * Get all robots for the authenticated user
+     */
+    getRobots(): Promise<RobotData[]>;
+    /**
+     * Get a specific robot by ID
+     */
+    getRobot(robotId: string): Promise<RobotData>;
+    /**
+     * Create a new robot
+     */
+    createRobot(workflowFile: WorkflowFile): Promise<RobotData>;
+    /**
+     * Update an existing robot
+     */
+    updateRobot(robotId: string, updates: Partial<WorkflowFile>): Promise<RobotData>;
+    /**
+     * Delete a robot
+     */
+    deleteRobot(robotId: string): Promise<void>;
+    /**
+     * Execute a robot and get results
+     */
+    executeRobot(robotId: string, options?: ExecutionOptions): Promise<RunResult>;
+    /**
+     * Get all runs for a robot
+     */
+    getRuns(robotId: string): Promise<Run[]>;
+    /**
+     * Get a specific run by ID
+     */
+    getRun(robotId: string, runId: string): Promise<Run>;
+    /**
+     * Abort a running or queued run
+     */
+    abortRun(robotId: string, runId: string): Promise<void>;
+    /**
+     * Schedule a robot for periodic execution
+     */
+    scheduleRobot(robotId: string, schedule: ScheduleConfig): Promise<RobotData>;
+    /**
+     * Remove schedule from a robot
+     */
+    unscheduleRobot(robotId: string): Promise<RobotData>;
+    /**
+     * Add a webhook to a robot
+     */
+    addWebhook(robotId: string, webhook: WebhookConfig): Promise<RobotData>;
+    /**
+     * LLM-based extraction - extract data using natural language prompt
+     */
+    extractWithLLM(url: string, options: {
+        prompt: string;
+        llmProvider?: 'anthropic' | 'openai' | 'ollama';
+        llmModel?: string;
+        llmApiKey?: string;
+        llmBaseUrl?: string;
+        robotName?: string;
+    }): Promise<any>;
+}
+//# sourceMappingURL=maxun-client.d.ts.map

package/dist/client/maxun-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maxun-client.d.ts","sourceRoot":"","sources":["../../src/client/maxun-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EACL,MAAM,EACN,SAAS,EACT,GAAG,EAEH,SAAS,EACT,cAAc,EACd,aAAa,EAEb,YAAY,EACZ,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAqB1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAKvC;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAQnD;;OAEG;IACG,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IA0BjE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAQtF;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IAoBnF;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAK9C;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ1D;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAWlF;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAW1D;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IA0B7E;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;QACzC,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;CAuBjB"}