@axiom_ai/api 1.0.0

package/README.md

@@ -0,0 +1,32 @@
+# 🤖 Axiom AI API Library
+
+---
+
+This repository contains the **Axiom AI API library**.
+
+## Usage
+
+To use the library, you'll first need to import the `AxiomApi` class and then wrap your automation steps within `browserOpen()` and `browserClose()`.
+
+### Example
+
+Here is a basic example of how to structure your code:
+
+```javascript
+import { AxiomApi } from 'axiom-api';
+
+async function run() {
+    // 1. Initialize the AxiomApi class
+    const axiom = new AxiomApi('[API_KEY]');
+    
+    // 2. Open the browser connection
+    await axiom.browserOpen();
+
+    // 3. Add your automation steps here (e.g., axiom.click(), axiom.type(), etc.)
+    // ... add steps ...
+
+    // 4. Close the browser connection when done
+    await axiom.browserClose();
+}
+
+run();

package/dist/cjs/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k="https://lar.axiom.ai";class c extends Error{constructor(t,e,n){super(t),this.name="AxiomHttpError",this.status=e,this.body=n}}class m{async post(t,e,n,i={}){const s=new AbortController;let o=null;i.timeoutMs&&i.timeoutMs>0&&(o=setTimeout(()=>s.abort(),i.timeoutMs));let r;try{r=await fetch(k+t,{method:"POST",headers:{Accept:"application/json","Content-Type":"application/json","X-API-KEY":e},body:JSON.stringify(n),signal:s.signal})}finally{o&&clearTimeout(o)}if(!r.ok){const h=await r.text();let a=null;try{a=JSON.parse(h)}catch{}if(r.status===401)throw new c("Failed to authenticate - please check your token.",401,a);const w=a&&a.message?a.message:`HTTP ${r.status} error: ${h}`;throw new c(w,r.status,a)}return r.json()}}const y=12e4,u=36e5,f=3e3,l=3e4,d=1.5;class g{constructor(t){this.cdpLink="",this.token=t,this.http=new m}async browserOpen(){const t=await this.http.post("/api/v5/browser/open",this.token);return this.cdpLink=t.endpoint,t.endpoint}async browserClose(t=""){t||(t=this.cdpLink);const e=await this.http.post("/api/v5/browser/close",this.token,{cdpLink:t});return this.cdpLink="",e.message}async step(t,e,n,i=""){try{const s=await this.http.post("/api/v5/step",this.token,{mode:t,method:e,params:n,cdpLink:i},{timeoutMs:y});return s&&s.message!==void 0?s.message:s}catch(s){if(!i||!this._shouldFallBackToPolling(s))throw s;return this._pollStepResult(i,s)}}_shouldFallBackToPolling(t){return!!(t&&t.name==="AbortError"||t&&t.name==="TypeError"||t instanceof c&&(t.status===502||t.status===503||t.status===504||t.status===409&&typeof t.message=="string"&&t.message.indexOf("Step already in progress")!==-1))}async _pollStepResult(t,e){const n=Date.now()+u;let i=f;for(;Date.now()<n;){await this._sleep(i);try{const s=await this.http.post("/api/v5/step/result",this.token,{cdpLink:t});if(s&&s.status==="complete")return s.result;if(s&&s.status==="running"){i=Math.min(i*d,l);continue}throw s&&s.status==="none"?new Error("Step did not start on the pod. Original error: "+(e&&e.message?e.message:"unknown")):new Error("Unexpected /step/result response: "+JSON.stringify(s))}catch(s){if(s instanceof c&&s.status===409)throw new Error("Step failed on the pod — check the task report. "+(s.message||""));if(s instanceof c&&s.status>=400&&s.status<500&&s.status!==502&&s.status!==503&&s.status!==504)throw s;i=Math.min(i*d,l)}}throw new Error("Step polling exceeded "+u/1e3+"s. Original error: "+(e&&e.message?e.message:"unknown"))}async scrape(t,e,n,i,s){return this.step("browser","AxiomApiSmartScrapeV440",[t,e,n,i,s],this.cdpLink)}async integrateAI(t){return this.step("browser","AxiomApiAiGeneric",[t],this.cdpLink)}async datePicker(t,e,n,i){return this.step("driver","datePicker",[t,e,n,i],this.cdpLink)}async click(t,e,n){return this.step("driver","clickV3130",[t,e,n],this.cdpLink)}async clickEngagementButton(t,e){return this.step("driver","clickEngagementButton",[t,e],this.cdpLink)}async clickMultiple(t,e,n){return this.step("driver","multiClickV3170",[t,e,n],this.cdpLink)}async getClipboardContents(){return this.step("driver","readClipboardContents",[],this.cdpLink)}async enterText(t,e,n=0,i=!1,s=null,o=!1){return this.step("driver","enterTextV4500",[t,e,n,i,s,o],this.cdpLink)}async goto(t,e=!1,n=!1){return this.step("driver","gotoV4070",[t,null,e,n],this.cdpLink)}async pressKeys(t,e,n){return this.step("driver","keydownV3120",[t,null,e,n],this.cdpLink)}async clickAndDrag(t,e){return this.step("driver","mouseClickDragV0300",[t,e],this.cdpLink)}async scrapeMetadata(t){return this.step("driver","scrapeMetadata",[t],this.cdpLink)}async selectList(t,e){return this.step("driver","selectList",[t,e],this.cdpLink)}async solveCaptcha(t){return this.step("driver","solveCaptchaV450",[null,null,t],this.cdpLink)}async switchBrowserTab(t){return this.step("driver","switchBrowserTab",[t],this.cdpLink)}async wait(t){return this.cdpLink?this.step("driver","wait",[t],this.cdpLink):this._sleep(t)}_sleep(t){return new Promise(e=>setTimeout(e,t))}async hover(t){return this.step("driver","hover",[t],this.cdpLink)}async restartBrowser(){return this.step("browser","AxiomApiRestartBrowser",[],this.cdpLink)}}exports.AxiomApi=g;

package/dist/es/axiom-api.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @class
+ * @public
+ * A class for interacting with the Axiom API.
+ */
+export class AxiomApi {
+    /**
+     * @param {string} token API access token.
+     */
+    constructor(token: string);
+    cdpLink: string;
+    token: string;
+    http: AxiomHttp;
+    browserOpen(): Promise<any>;
+    browserClose(cdpLink?: string): Promise<any>;
+    step(mode: any, method: any, params: any, cdpLink?: string): Promise<any>;
+    _shouldFallBackToPolling(error: any): boolean;
+    _pollStepResult(cdpLink: any, originalError: any): Promise<any>;
+    scrape(url: any, selector: any, pager: any, max_results: any, settings: any): Promise<any>;
+    integrateAI(aiOptions: any): Promise<any>;
+    datePicker(selectMonth: any, selectMonthChangeButton: any, changeMonthTo: any, changeDayOfMonthTo: any): Promise<any>;
+    click(select: any, leftClickRightClick: any, optionalClick: any): Promise<any>;
+    clickEngagementButton(select: any, setValueToCheck: any): Promise<any>;
+    clickMultiple(select: any, leftClickRightClick: any, maxClicks: any): Promise<any>;
+    getClipboardContents(): Promise<any>;
+    enterText(selectTextField: any, text: any, delay?: number, appendExisting?: boolean, customLineBreak?: any, optionalText?: boolean): Promise<any>;
+    goto(url: any, doNotShareLocalstorage?: boolean, openInNewTab?: boolean): Promise<any>;
+    pressKeys(key: any, delimiter: any, delay: any): Promise<any>;
+    clickAndDrag(startCoordinates: any, endCoordinates: any): Promise<any>;
+    scrapeMetadata(metadata: any): Promise<any>;
+    selectList(select: any, text: any): Promise<any>;
+    solveCaptcha(apiKey: any): Promise<any>;
+    switchBrowserTab(selectTab: any): Promise<any>;
+    wait(time: any): Promise<any>;
+    _sleep(ms: any): Promise<any>;
+    hover(select: any): Promise<any>;
+    restartBrowser(): Promise<any>;
+}
+import { AxiomHttp } from './axiom-http.js';

package/dist/es/axiom-api.js

@@ -0,0 +1,348 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { AxiomHttp, AxiomHttpError } from './axiom-http.js';
+// Tuning for the transparent long-running-step polling fallback. The library POSTs
+// /step with STEP_HTTP_TIMEOUT_MS as the abort deadline; if the POST times out, hits
+// a gateway error, or the backend says a previous step is still in flight, the
+// library polls /step/result with exponential backoff until the result lands or
+// STEP_MAX_POLL_DURATION_MS elapses.
+var STEP_HTTP_TIMEOUT_MS = 120000;
+var STEP_MAX_POLL_DURATION_MS = 3600000;
+var STEP_POLL_INITIAL_INTERVAL_MS = 3000;
+var STEP_POLL_MAX_INTERVAL_MS = 30000;
+var STEP_POLL_BACKOFF_FACTOR = 1.5;
+/**
+ * @class
+ * @public
+ * A class for interacting with the Axiom API.
+ */
+var AxiomApi = /** @class */ (function () {
+    /**
+     * @param {string} token API access token.
+     */
+    function AxiomApi(token) {
+        this.cdpLink = '';
+        this.token = token;
+        this.http = new AxiomHttp();
+    }
+    AxiomApi.prototype.browserOpen = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var content;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.http.post('/api/v5/browser/open', this.token)];
+                    case 1:
+                        content = _a.sent();
+                        this.cdpLink = content.endpoint;
+                        return [2 /*return*/, content.endpoint];
+                }
+            });
+        });
+    };
+    AxiomApi.prototype.browserClose = function () {
+        return __awaiter(this, arguments, void 0, function (cdpLink) {
+            var content;
+            if (cdpLink === void 0) { cdpLink = ''; }
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!cdpLink) {
+                            cdpLink = this.cdpLink;
+                        }
+                        return [4 /*yield*/, this.http.post('/api/v5/browser/close', this.token, { cdpLink: cdpLink })
+                            // Reset CDPLink to avoid staleness
+                        ];
+                    case 1:
+                        content = _a.sent();
+                        // Reset CDPLink to avoid staleness
+                        this.cdpLink = '';
+                        return [2 /*return*/, content.message];
+                }
+            });
+        });
+    };
+    // TODO: Probably should be mvoed to a non-user facing component
+    AxiomApi.prototype.step = function (mode_1, method_1, params_1) {
+        return __awaiter(this, arguments, void 0, function (mode, method, params, cdpLink) {
+            var content, e_1;
+            if (cdpLink === void 0) { cdpLink = ''; }
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, this.http.post('/api/v5/step', this.token, {
+                                mode: mode,
+                                method: method,
+                                params: params,
+                                cdpLink: cdpLink
+                            }, { timeoutMs: STEP_HTTP_TIMEOUT_MS })];
+                    case 1:
+                        content = _a.sent();
+                        if (content && content.message !== undefined) {
+                            return [2 /*return*/, content.message];
+                        }
+                        return [2 /*return*/, content];
+                    case 2:
+                        e_1 = _a.sent();
+                        // Can only fall back to polling when there is a session to address.
+                        // One-shot /step calls have no cdpLink and surface the original error.
+                        if (!cdpLink || !this._shouldFallBackToPolling(e_1))
+                            throw e_1;
+                        return [2 /*return*/, this._pollStepResult(cdpLink, e_1)];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    AxiomApi.prototype._shouldFallBackToPolling = function (error) {
+        // Direct POST never reached or never returned — step may still be running on the pod.
+        if (error && error.name === 'AbortError')
+            return true;
+        // Native fetch network failure (DNS, connection reset, etc.) surfaces as TypeError.
+        if (error && error.name === 'TypeError')
+            return true;
+        if (error instanceof AxiomHttpError) {
+            if (error.status === 502 || error.status === 503 || error.status === 504)
+                return true;
+            if (error.status === 409 && typeof error.message === 'string'
+                && error.message.indexOf('Step already in progress') !== -1)
+                return true;
+        }
+        return false;
+    };
+    AxiomApi.prototype._pollStepResult = function (cdpLink, originalError) {
+        return __awaiter(this, void 0, void 0, function () {
+            var deadline, intervalMs, content, e_2;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        deadline = Date.now() + STEP_MAX_POLL_DURATION_MS;
+                        intervalMs = STEP_POLL_INITIAL_INTERVAL_MS;
+                        _a.label = 1;
+                    case 1:
+                        if (!(Date.now() < deadline)) return [3 /*break*/, 7];
+                        return [4 /*yield*/, this._sleep(intervalMs)];
+                    case 2:
+                        _a.sent();
+                        _a.label = 3;
+                    case 3:
+                        _a.trys.push([3, 5, , 6]);
+                        return [4 /*yield*/, this.http.post('/api/v5/step/result', this.token, { cdpLink: cdpLink })];
+                    case 4:
+                        content = _a.sent();
+                        if (content && content.status === 'complete')
+                            return [2 /*return*/, content.result];
+                        if (content && content.status === 'running') {
+                            intervalMs = Math.min(intervalMs * STEP_POLL_BACKOFF_FACTOR, STEP_POLL_MAX_INTERVAL_MS);
+                            return [3 /*break*/, 1];
+                        }
+                        if (content && content.status === 'none') {
+                            throw new Error('Step did not start on the pod. Original error: '
+                                + (originalError && originalError.message ? originalError.message : 'unknown'));
+                        }
+                        throw new Error('Unexpected /step/result response: ' + JSON.stringify(content));
+                    case 5:
+                        e_2 = _a.sent();
+                        // Executor is gone (step error → finish('Failure') removed it).
+                        // Surface as a hard failure — the task report has the detail.
+                        if (e_2 instanceof AxiomHttpError && e_2.status === 409) {
+                            throw new Error('Step failed on the pod — check the task report. ' + (e_2.message || ''));
+                        }
+                        // Auth or other definite 4xx — don't keep polling.
+                        if (e_2 instanceof AxiomHttpError && e_2.status >= 400 && e_2.status < 500
+                            && e_2.status !== 502 && e_2.status !== 503 && e_2.status !== 504) {
+                            throw e_2;
+                        }
+                        // Transient network issue mid-poll — back off and retry.
+                        intervalMs = Math.min(intervalMs * STEP_POLL_BACKOFF_FACTOR, STEP_POLL_MAX_INTERVAL_MS);
+                        return [3 /*break*/, 6];
+                    case 6: return [3 /*break*/, 1];
+                    case 7: throw new Error('Step polling exceeded ' + (STEP_MAX_POLL_DURATION_MS / 1000)
+                        + 's. Original error: '
+                        + (originalError && originalError.message ? originalError.message : 'unknown'));
+                }
+            });
+        });
+    };
+    AxiomApi.prototype.scrape = function (url, selector, pager, max_results, settings) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('browser', 'AxiomApiSmartScrapeV440', [url, selector, pager, max_results, settings], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.integrateAI = function (aiOptions) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('browser', 'AxiomApiAiGeneric', [aiOptions], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.datePicker = function (selectMonth, selectMonthChangeButton, changeMonthTo, changeDayOfMonthTo) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'datePicker', [selectMonth, selectMonthChangeButton, changeMonthTo, changeDayOfMonthTo], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.click = function (select, leftClickRightClick, optionalClick) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'clickV3130', [select, leftClickRightClick, optionalClick], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.clickEngagementButton = function (select, setValueToCheck) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'clickEngagementButton', [select, setValueToCheck], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.clickMultiple = function (select, leftClickRightClick, maxClicks) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'multiClickV3170', [select, leftClickRightClick, maxClicks], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.getClipboardContents = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'readClipboardContents', [], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.enterText = function (selectTextField_1, text_1) {
+        return __awaiter(this, arguments, void 0, function (selectTextField, text, delay, appendExisting, customLineBreak, optionalText) {
+            if (delay === void 0) { delay = 0; }
+            if (appendExisting === void 0) { appendExisting = false; }
+            if (customLineBreak === void 0) { customLineBreak = null; }
+            if (optionalText === void 0) { optionalText = false; }
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'enterTextV4500', [selectTextField, text, delay, appendExisting, customLineBreak, optionalText], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.goto = function (url_1) {
+        return __awaiter(this, arguments, void 0, function (url, doNotShareLocalstorage, openInNewTab) {
+            if (doNotShareLocalstorage === void 0) { doNotShareLocalstorage = false; }
+            if (openInNewTab === void 0) { openInNewTab = false; }
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'gotoV4070', [url, null, doNotShareLocalstorage, openInNewTab], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.pressKeys = function (key, delimiter, delay) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'keydownV3120', [key, null, delimiter, delay], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.clickAndDrag = function (startCoordinates, endCoordinates) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'mouseClickDragV0300', [startCoordinates, endCoordinates], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.scrapeMetadata = function (metadata) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'scrapeMetadata', [metadata], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.selectList = function (select, text) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'selectList', [select, text], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.solveCaptcha = function (apiKey) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'solveCaptchaV450', [null, null, apiKey], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.switchBrowserTab = function (selectTab) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'switchBrowserTab', [selectTab], this.cdpLink)];
+            });
+        });
+    };
+    // Pause on the pod, not in the client process, so the pod's session inactivity
+    // timer is reset by the step. A purely local sleep would let the session idle
+    // out and auto-close while the client was still happily waiting. Falls back to
+    // a local sleep when there is no session — nothing to keep alive.
+    AxiomApi.prototype.wait = function (time) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                if (this.cdpLink) {
+                    return [2 /*return*/, this.step('driver', 'wait', [time], this.cdpLink)];
+                }
+                return [2 /*return*/, this._sleep(time)];
+            });
+        });
+    };
+    // Local-only sleep, used by the polling loop's backoff. Never routes to the
+    // pod — that would be circular (the polling loop's whole purpose is to wait
+    // out a pod-side step that has lost its HTTP connection).
+    AxiomApi.prototype._sleep = function (ms) {
+        return new Promise(function (resolve) { return setTimeout(resolve, ms); });
+    };
+    AxiomApi.prototype.hover = function (select) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('driver', 'hover', [select], this.cdpLink)];
+            });
+        });
+    };
+    AxiomApi.prototype.restartBrowser = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.step('browser', 'AxiomApiRestartBrowser', [], this.cdpLink)];
+            });
+        });
+    };
+    return AxiomApi;
+}());
+export { AxiomApi };

package/dist/es/axiom-http.d.ts

@@ -0,0 +1,8 @@
+export class AxiomHttpError extends Error {
+    constructor(message: any, status: any, body: any);
+    status: any;
+    body: any;
+}
+export class AxiomHttp {
+    post(uri: any, token: any, body: any, options?: {}): Promise<any>;
+}

package/dist/es/axiom-http.js

@@ -0,0 +1,122 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { ENDPOINT } from "./config";
+var AxiomHttpError = /** @class */ (function (_super) {
+    __extends(AxiomHttpError, _super);
+    function AxiomHttpError(message, status, body) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'AxiomHttpError';
+        _this.status = status;
+        _this.body = body;
+        return _this;
+    }
+    return AxiomHttpError;
+}(Error));
+export { AxiomHttpError };
+var AxiomHttp = /** @class */ (function () {
+    function AxiomHttp() {
+    }
+    AxiomHttp.prototype.post = function (uri_1, token_1, body_1) {
+        return __awaiter(this, arguments, void 0, function (uri, token, body, options) {
+            var controller, timeoutId, rawResponse, errorText, parsed, msg;
+            if (options === void 0) { options = {}; }
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        controller = new AbortController();
+                        timeoutId = null;
+                        if (options.timeoutMs && options.timeoutMs > 0) {
+                            timeoutId = setTimeout(function () { return controller.abort(); }, options.timeoutMs);
+                        }
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, , 3, 4]);
+                        return [4 /*yield*/, fetch(ENDPOINT + uri, {
+                                method: 'POST',
+                                headers: {
+                                    'Accept': 'application/json',
+                                    'Content-Type': 'application/json',
+                                    'X-API-KEY': token
+                                },
+                                body: JSON.stringify(body),
+                                signal: controller.signal
+                            })];
+                    case 2:
+                        rawResponse = _a.sent();
+                        return [3 /*break*/, 4];
+                    case 3:
+                        if (timeoutId)
+                            clearTimeout(timeoutId);
+                        return [7 /*endfinally*/];
+                    case 4:
+                        if (!!rawResponse.ok) return [3 /*break*/, 6];
+                        return [4 /*yield*/, rawResponse.text()];
+                    case 5:
+                        errorText = _a.sent();
+                        parsed = null;
+                        try {
+                            parsed = JSON.parse(errorText);
+                        }
+                        catch (_) { /* non-JSON body */ }
+                        if (rawResponse.status === 401) {
+                            throw new AxiomHttpError("Failed to authenticate - please check your token.", 401, parsed);
+                        }
+                        msg = (parsed && parsed.message) ? parsed.message : "HTTP ".concat(rawResponse.status, " error: ").concat(errorText);
+                        throw new AxiomHttpError(msg, rawResponse.status, parsed);
+                    case 6: return [2 /*return*/, rawResponse.json()];
+                }
+            });
+        });
+    };
+    return AxiomHttp;
+}());
+export { AxiomHttp };

package/dist/es/config.d.ts

@@ -0,0 +1 @@
+export const ENDPOINT: "https://lar.axiom.ai";

package/dist/es/config.js

@@ -0,0 +1 @@
+export var ENDPOINT = "https://lar.axiom.ai";

package/dist/es/index.d.ts

@@ -0,0 +1 @@
+export { AxiomApi } from "./axiom-api";

package/dist/es/index.js

@@ -0,0 +1 @@
+export { AxiomApi } from "./axiom-api";

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@axiom_ai/api",
+  "author": "Axiom.ai",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Library for interacting with Axiom.ai browser infrastructure",
+  "main": "dist/cjs/index.js",
+  "module": "dist/es/index.js",
+  "types": "dist/es/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build:js": "vite build --mode production",
+    "build:js-dev": "vite build --mode development",
+    "build:types": "tsc --project tsconfig.json",
+    "build": "npm run build:js && npm run build:types",
+    "build-dev": "npm run build:js-dev && npm run build:types",
+    "test": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/es/index.js",
+      "require": "./dist/cjs/index.js",
+      "default": "./dist/es/index.js",
+      "types": "./dist/es/index.d.ts"
+    }
+  },
+  "jest": {
+    "testEnvironment": "node",
+    "testMatch": [
+      "**/test/**/*.js"
+    ],
+    "moduleDirectories": [
+      "node_modules",
+      "src"
+    ]
+  },
+  "devDependencies": {
+    "jest": "^29.7.0",
+    "nock": "^14.0.10",
+    "typescript": "^5.8.0",
+    "vite": "^7.1.10"
+  },
+  "directories": {
+    "test": "test"
+  },
+  "dependencies": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/axiom-browser-automation/axiom-api.git"
+  },
+  "keywords": [
+    "ai",
+    "api",
+    "axiom.ai",
+    "sdk",
+    "browser",
+    "automation"
+  ],
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/axiom-browser-automation/axiom-api/issues"
+  },
+  "homepage": "https://github.com/axiom-browser-automation/axiom-api#readme"
+}