@autenai/sdk 0.4.0 → 0.6.0

package/dist/src/client.js

@@ -0,0 +1,131 @@
+import { Transport, DEFAULT_BASE_URL } from "./transport.js";
+import { Phone } from "./phone.js";
+/**
+ * Auten — top-level SDK client. Wraps the relay's REST API with typed
+ * methods grouped by resource:
+ *
+ *   const auten = new Auten({ apiKey: process.env.AUTEN_API_KEY });
+ *   const me = await auten.me();
+ *   const devices = await auten.devices.list();
+ *   const { task_id } = await auten.tasks.create({ device: devices[0].serial, prompt: "open chrome" });
+ *   const result = await auten.tasks.wait(task_id);
+ *   const phone = auten.phone(devices[0].serial);
+ *   await phone.tap(500, 800);
+ */
+export class Auten {
+    t;
+    constructor(config) {
+        this.t = new Transport(config.apiKey, config.baseUrl ?? DEFAULT_BASE_URL, config.timeoutMs);
+    }
+    get baseUrl() { return this.t.baseUrl; }
+    /** Identity + counters for the calling key. */
+    me() {
+        return this.t.get("/v1/me");
+    }
+    // ── Devices ──────────────────────────────────────────────────────
+    devices = {
+        list: async () => {
+            const r = await this.t.get("/v1/devices");
+            return r.devices;
+        },
+        get: async (serial) => {
+            const all = await this.devices.list();
+            return all.find((d) => d.serial === serial) ?? null;
+        },
+        /** First device that's currently online, or null. */
+        firstOnline: async () => {
+            const all = await this.devices.list();
+            return all.find((d) => d.online) ?? null;
+        },
+        stats: (serial) => this.t.get(`/v1/devices/${encodeURIComponent(serial)}/stats`),
+    };
+    // ── Tasks ────────────────────────────────────────────────────────
+    tasks = {
+        create: (input) => {
+            return this.t.post("/v1/tasks", {
+                device_serial: input.device,
+                prompt: input.prompt,
+                mode: input.mode,
+                speed: input.speed,
+                webhook_url: input.webhook_url,
+                webhook_secret: input.webhook_secret,
+                timeout_seconds: input.timeout_seconds,
+            });
+        },
+        get: (id) => this.t.get(`/v1/tasks/${encodeURIComponent(id)}`),
+        list: async (opts = {}) => {
+            const q = new URLSearchParams();
+            if (opts.device)
+                q.set("device", opts.device);
+            if (opts.status)
+                q.set("status", opts.status);
+            if (opts.limit !== undefined)
+                q.set("limit", String(opts.limit));
+            const qs = q.toString();
+            const r = await this.t.get(`/v1/tasks${qs ? `?${qs}` : ""}`);
+            return r.tasks;
+        },
+        cancel: (id) => this.t.post(`/v1/tasks/${encodeURIComponent(id)}/cancel`),
+        /**
+         * Poll until the task reaches a terminal state. Backs off from `intervalMs`
+         * (default 1s) and aborts at `timeoutMs` (default 5 min).
+         * Returns the final Task object.
+         */
+        wait: async (id, opts = {}) => {
+            const interval = opts.intervalMs ?? 1000;
+            const deadline = Date.now() + (opts.timeoutMs ?? 300_000);
+            // First fetch is immediate so the caller doesn't pay an interval delay
+            // for a task that's already done by the time wait() is called.
+            let t = await this.tasks.get(id);
+            while (t.status === "queued" || t.status === "running") {
+                if (Date.now() > deadline) {
+                    throw new Error(`task ${id} did not complete within ${opts.timeoutMs ?? 300_000}ms`);
+                }
+                await new Promise((r) => setTimeout(r, interval));
+                t = await this.tasks.get(id);
+            }
+            return t;
+        },
+        /**
+         * One-shot helper: create + wait. Returns the final Task.
+         *
+         *   const result = await auten.tasks.run({ device, prompt: "999÷3", speed: "lightning" });
+         *   console.log(result.verified, result.result?.summary);
+         */
+        run: async (input, waitOpts) => {
+            const created = await this.tasks.create(input);
+            return this.tasks.wait(created.task_id, waitOpts);
+        },
+    };
+    // ── API keys ─────────────────────────────────────────────────────
+    keys = {
+        list: async () => {
+            const r = await this.t.get("/v1/keys");
+            return r.keys;
+        },
+        /** Returns the new key with the FULL secret in `key`. Store it — the
+         *  listing endpoint never reveals it again. */
+        create: (input = {}) => this.t.post("/v1/keys", input),
+        revoke: (id) => this.t.del(`/v1/keys/${encodeURIComponent(id)}`),
+    };
+    // ── Credentials (cross-device) ───────────────────────────────────
+    // Per-device save / reveal lives on `auten.phone(serial).credentials`;
+    // these are the helpers for "I want to see / delete one credential
+    // and I have its UUID, not its (serial, service) pair".
+    credentials = {
+        /** Every credential the calling key can see, across all of the owner's
+         *  devices. Each row carries `id` and `deviceSerial`. */
+        list: async () => {
+            const r = await this.t.get("/v1/credentials");
+            return r.credentials;
+        },
+        /** Delete a credential by its UUID. The relay verifies the calling key
+         *  owns the device the credential belongs to. */
+        deleteById: (id) => this.t.del(`/v1/credentials/${encodeURIComponent(id)}`),
+    };
+    /** Phone handle for direct control / per-device credentials. */
+    phone(serial) {
+        return new Phone(this.t, serial);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

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

package/dist/src/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class AutenError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class AuthError extends AutenError {
+    constructor(message?: string);
+}
+export declare class ApiError extends AutenError {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+export declare class DeviceOfflineError extends AutenError {
+    readonly serial: string;
+    constructor(serial: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;aACU,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAED,qBAAa,SAAU,SAAQ,UAAU;gBAC3B,OAAO,SAAiB;CAIrC;AAED,qBAAa,QAAS,SAAQ,UAAU;aACO,MAAM,EAAE,MAAM;gBAA/C,OAAO,EAAE,MAAM,EAAkB,MAAM,EAAE,MAAM;CAI5D;AAED,qBAAa,kBAAmB,SAAQ,UAAU;aACpB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAI3C"}

package/dist/src/errors.js

@@ -0,0 +1,31 @@
+export class AutenError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = "AutenError";
+    }
+}
+export class AuthError extends AutenError {
+    constructor(message = "unauthorized") {
+        super(message);
+        this.name = "AuthError";
+    }
+}
+export class ApiError extends AutenError {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "ApiError";
+    }
+}
+export class DeviceOfflineError extends AutenError {
+    serial;
+    constructor(serial) {
+        super(`device ${serial} is not connected`);
+        this.serial = serial;
+        this.name = "DeviceOfflineError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IACU;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,UAAU;IACvC,YAAY,OAAO,GAAG,cAAc;QAClC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,UAAU;IACO;IAA7C,YAAY,OAAe,EAAkB,MAAc;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,WAAM,GAAN,MAAM,CAAQ;QAEzD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IACpB;IAA5B,YAA4B,MAAc;QACxC,KAAK,CAAC,UAAU,MAAM,mBAAmB,CAAC,CAAC;QADjB,WAAM,GAAN,MAAM,CAAQ;QAExC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/src/index.d.ts

@@ -0,0 +1,7 @@
+export { Auten } from "./client.js";
+export { Phone } from "./phone.js";
+export { Transport, DEFAULT_BASE_URL } from "./transport.js";
+export { AutenError, AuthError, ApiError, DeviceOfflineError, } from "./errors.js";
+export type { AutenConfig, } from "./client.js";
+export type { Speed, TaskMode, TaskStatus, Device, Task, TaskTurn, TaskArtifact, CreateTaskInput, CreateTaskResponse, ListTasksOptions, Whoami, ApiKey, ApiKeyWithSecret, CreateKeyInput, Credential, SaveCredentialInput, SomElement, LookResult, KeyName, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,KAAK,EACL,QAAQ,EACR,UAAU,EACV,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,MAAM,EACN,MAAM,EACN,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,OAAO,GACR,MAAM,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,5 @@
+export { Auten } from "./client.js";
+export { Phone } from "./phone.js";
+export { Transport, DEFAULT_BASE_URL } from "./transport.js";
+export { AutenError, AuthError, ApiError, DeviceOfflineError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/src/phone.d.ts

@@ -0,0 +1,124 @@
+import type { Transport } from "./transport.js";
+import type { LookResult, KeyName, Credential, SaveCredentialInput, CreateTaskResponse, Speed, TaskMode } from "./types.js";
+/**
+ * Phone — wraps a single device. All control calls go through the relay's
+ * owner-scoped phone-proxy endpoint, which forwards them via the WS reverse
+ * tunnel to the APK on the device.
+ *
+ *   const phone = auten.phone("a4e0eff201d020fd");
+ *   const screen = await phone.look();
+ *   await phone.tap(500, 800);
+ *   await phone.task("open Instagram and like 5 posts");
+ */
+export declare class Phone {
+    private readonly t;
+    readonly serial: string;
+    constructor(t: Transport, serial: string);
+    private get base();
+    /**
+     * Forward an HTTP envelope to the phone APK through the relay tunnel.
+     * Most callers should use the named methods below; this is the escape
+     * hatch for endpoints we haven't wrapped (and for forward-compat with
+     * APK changes that ship before SDK updates).
+     */
+    proxy<T = unknown>(method: "GET" | "POST", path: string, body?: unknown, timeoutMs?: number): Promise<T>;
+    look(): Promise<LookResult>;
+    screenshot(): Promise<{
+        jpeg: string;
+        width: number;
+        height: number;
+        durationMs: number;
+    }>;
+    tap(x: number, y: number): Promise<{
+        ok: boolean;
+    }>;
+    longPress(x: number, y: number, durationMs?: number): Promise<{
+        ok: boolean;
+    }>;
+    swipe(x1: number, y1: number, x2: number, y2: number, durationMs?: number): Promise<{
+        ok: boolean;
+    }>;
+    /**
+     * Type text into the focused field. Pass `target: { x, y }` of an
+     * editable element to bypass the soft keyboard (uses accessibility
+     * ACTION_SET_TEXT — instant, no layout shift).
+     */
+    type(text: string, target?: {
+        x: number;
+        y: number;
+    }): Promise<{
+        ok: boolean;
+    }>;
+    key(name: KeyName): Promise<{
+        ok: boolean;
+    }>;
+    /** Force-stops the package first (clean slate), then launches it. */
+    launch(packageName: string): Promise<{
+        ok: boolean;
+    }>;
+    stop(packageName: string): Promise<{
+        ok: boolean;
+    }>;
+    /** ACTION_VIEW intent — one-shot navigation. Pass `pkg` to pin a browser. */
+    openUrl(url: string, pkg?: string): Promise<{
+        ok: boolean;
+        url: string;
+        package?: string;
+    }>;
+    status(): Promise<unknown>;
+    info(): Promise<unknown>;
+    /** Kill all third-party apps + press home. Useful before benchmarks. */
+    reset(): Promise<{
+        ok: boolean;
+        killedCount: number;
+    }>;
+    notifications(): Promise<unknown[]>;
+    clearNotifications(): Promise<{
+        ok: boolean;
+    }>;
+    clipboardSet(text: string): Promise<{
+        ok: boolean;
+    }>;
+    clipboardGet(): Promise<{
+        ok: boolean;
+        text: string;
+    }>;
+    pasteClipboard(target?: {
+        x: number;
+        y: number;
+    }): Promise<{
+        ok: boolean;
+    }>;
+    /**
+     * Shortcut for `auten.tasks.create({ device: this.serial, prompt, ... })`.
+     * Returns the task handle; await `auten.tasks.wait(id)` for the result.
+     */
+    task(prompt: string, opts?: {
+        speed?: Speed;
+        mode?: TaskMode;
+        timeout_seconds?: number;
+        webhook_url?: string;
+        webhook_secret?: string;
+    }): Promise<CreateTaskResponse>;
+    readonly credentials: {
+        save: (input: SaveCredentialInput) => Promise<{
+            ok: boolean;
+            service: string;
+        }>;
+        /** List this device's credentials. Each row carries `id` (UUID),
+         *  pass to `deleteById()` if you don't have the service name handy. */
+        list: () => Promise<Credential[]>;
+        reveal: <T = Record<string, unknown>>(service: string) => Promise<T>;
+        /** Delete by service name (unique per device). */
+        delete: (service: string) => Promise<{
+            ok: boolean;
+        }>;
+        /** Delete by UUID. Routed through the cross-device endpoint; the
+         *  relay verifies the credential belongs to a device this key owns. */
+        deleteById: (id: string) => Promise<{
+            ok: boolean;
+            id: string;
+        }>;
+    };
+}
+//# sourceMappingURL=phone.d.ts.map

package/dist/src/phone.d.ts.map

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

package/dist/src/phone.js

@@ -0,0 +1,129 @@
+/**
+ * Phone — wraps a single device. All control calls go through the relay's
+ * owner-scoped phone-proxy endpoint, which forwards them via the WS reverse
+ * tunnel to the APK on the device.
+ *
+ *   const phone = auten.phone("a4e0eff201d020fd");
+ *   const screen = await phone.look();
+ *   await phone.tap(500, 800);
+ *   await phone.task("open Instagram and like 5 posts");
+ */
+export class Phone {
+    t;
+    serial;
+    constructor(t, serial) {
+        this.t = t;
+        this.serial = serial;
+    }
+    get base() {
+        return `/v1/devices/${encodeURIComponent(this.serial)}`;
+    }
+    /**
+     * Forward an HTTP envelope to the phone APK through the relay tunnel.
+     * Most callers should use the named methods below; this is the escape
+     * hatch for endpoints we haven't wrapped (and for forward-compat with
+     * APK changes that ship before SDK updates).
+     */
+    proxy(method, path, body, timeoutMs) {
+        return this.t.post(`${this.base}/proxy`, { method, path, body, timeout_ms: timeoutMs });
+    }
+    // ── Vision ────────────────────────────────────────────────────────
+    look() {
+        return this.proxy("POST", "/look");
+    }
+    screenshot() {
+        return this.proxy("POST", "/screenshot");
+    }
+    // ── Input ─────────────────────────────────────────────────────────
+    tap(x, y) {
+        return this.proxy("POST", "/tap", { x: Math.round(x), y: Math.round(y) });
+    }
+    longPress(x, y, durationMs = 1000) {
+        return this.proxy("POST", "/long_press", { x: Math.round(x), y: Math.round(y), duration: durationMs });
+    }
+    swipe(x1, y1, x2, y2, durationMs = 300) {
+        return this.proxy("POST", "/swipe", {
+            x1: Math.round(x1), y1: Math.round(y1),
+            x2: Math.round(x2), y2: Math.round(y2),
+            duration: durationMs,
+        });
+    }
+    /**
+     * Type text into the focused field. Pass `target: { x, y }` of an
+     * editable element to bypass the soft keyboard (uses accessibility
+     * ACTION_SET_TEXT — instant, no layout shift).
+     */
+    type(text, target) {
+        return this.proxy("POST", "/type", target
+            ? { text, x: Math.round(target.x), y: Math.round(target.y) }
+            : { text });
+    }
+    key(name) {
+        return this.proxy("POST", "/key", { key: name });
+    }
+    // ── Apps ──────────────────────────────────────────────────────────
+    /** Force-stops the package first (clean slate), then launches it. */
+    async launch(packageName) {
+        await this.proxy("POST", "/stop", { package: packageName }).catch(() => { });
+        return this.proxy("POST", "/launch", { package: packageName });
+    }
+    stop(packageName) {
+        return this.proxy("POST", "/stop", { package: packageName });
+    }
+    /** ACTION_VIEW intent — one-shot navigation. Pass `pkg` to pin a browser. */
+    openUrl(url, pkg) {
+        return this.proxy("POST", "/open_url", pkg ? { url, package: pkg } : { url });
+    }
+    // ── Status / events ──────────────────────────────────────────────
+    status() { return this.proxy("GET", "/status"); }
+    info() { return this.proxy("GET", "/info"); }
+    /** Kill all third-party apps + press home. Useful before benchmarks. */
+    reset() { return this.proxy("POST", "/reset"); }
+    notifications() { return this.proxy("GET", "/notifications"); }
+    clearNotifications() { return this.proxy("POST", "/notifications/clear"); }
+    // ── Clipboard ────────────────────────────────────────────────────
+    clipboardSet(text) {
+        return this.proxy("POST", "/clipboard/set", { text });
+    }
+    clipboardGet() {
+        return this.proxy("GET", "/clipboard/get");
+    }
+    pasteClipboard(target) {
+        return this.proxy("POST", "/paste-clipboard", target
+            ? { x: Math.round(target.x), y: Math.round(target.y) }
+            : {});
+    }
+    // ── Task dispatch (sugar) ─────────────────────────────────────────
+    /**
+     * Shortcut for `auten.tasks.create({ device: this.serial, prompt, ... })`.
+     * Returns the task handle; await `auten.tasks.wait(id)` for the result.
+     */
+    task(prompt, opts) {
+        return this.t.post("/v1/tasks", {
+            device_serial: this.serial,
+            prompt,
+            mode: opts?.mode,
+            speed: opts?.speed,
+            timeout_seconds: opts?.timeout_seconds,
+            webhook_url: opts?.webhook_url,
+            webhook_secret: opts?.webhook_secret,
+        });
+    }
+    // ── Credentials (encrypted server-side, scoped to this device) ───
+    credentials = {
+        save: (input) => this.t.post(`${this.base}/credentials`, input),
+        /** List this device's credentials. Each row carries `id` (UUID),
+         *  pass to `deleteById()` if you don't have the service name handy. */
+        list: async () => {
+            const r = await this.t.get(`${this.base}/credentials`);
+            return r.credentials;
+        },
+        reveal: (service) => this.t.get(`${this.base}/credentials/${encodeURIComponent(service)}/reveal`),
+        /** Delete by service name (unique per device). */
+        delete: (service) => this.t.del(`${this.base}/credentials/${encodeURIComponent(service)}`),
+        /** Delete by UUID. Routed through the cross-device endpoint; the
+         *  relay verifies the credential belongs to a device this key owns. */
+        deleteById: (id) => this.t.del(`/v1/credentials/${encodeURIComponent(id)}`),
+    };
+}
+//# sourceMappingURL=phone.js.map

package/dist/src/phone.js.map

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

package/dist/src/transport.d.ts

@@ -0,0 +1,14 @@
+export declare const DEFAULT_BASE_URL = "https://relay.auten.ai";
+export declare class Transport {
+    readonly baseUrl: string;
+    readonly apiKey: string;
+    readonly timeoutMs: number;
+    constructor(apiKey: string, baseUrl?: string, timeoutMs?: number);
+    private headers;
+    get<T>(path: string, timeoutMs?: number): Promise<T>;
+    post<T>(path: string, body?: unknown, timeoutMs?: number): Promise<T>;
+    put<T>(path: string, body?: unknown, timeoutMs?: number): Promise<T>;
+    del<T>(path: string, timeoutMs?: number): Promise<T>;
+    private request;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/src/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/transport.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AAGzD,qBAAa,SAAS;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAyB,EAAE,SAAS,GAAE,MAA2B;IAOtG,OAAO,CAAC,OAAO;IAOT,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAI5C,OAAO;CAiCtB"}

package/dist/src/transport.js

@@ -0,0 +1,71 @@
+import { AuthError, ApiError, DeviceOfflineError } from "./errors.js";
+export const DEFAULT_BASE_URL = "https://relay.auten.ai";
+const DEFAULT_TIMEOUT_MS = 60_000;
+export class Transport {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    constructor(apiKey, baseUrl = DEFAULT_BASE_URL, timeoutMs = DEFAULT_TIMEOUT_MS) {
+        if (!apiKey)
+            throw new AuthError("apiKey required");
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.timeoutMs = timeoutMs;
+    }
+    headers() {
+        return {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+        };
+    }
+    async get(path, timeoutMs) {
+        return this.request("GET", path, undefined, timeoutMs);
+    }
+    async post(path, body, timeoutMs) {
+        return this.request("POST", path, body, timeoutMs);
+    }
+    async put(path, body, timeoutMs) {
+        return this.request("PUT", path, body, timeoutMs);
+    }
+    async del(path, timeoutMs) {
+        return this.request("DELETE", path, undefined, timeoutMs);
+    }
+    async request(method, path, body, timeoutMs) {
+        const url = `${this.baseUrl}${path}`;
+        let res;
+        try {
+            res = await fetch(url, {
+                method,
+                headers: this.headers(),
+                body: body == null ? undefined : JSON.stringify(body),
+                signal: AbortSignal.timeout(timeoutMs ?? this.timeoutMs),
+            });
+        }
+        catch (err) {
+            throw new ApiError(`network error calling ${method} ${path}: ${err instanceof Error ? err.message : String(err)}`, 0);
+        }
+        const text = await res.text();
+        if (res.status === 401)
+            throw new AuthError(text || "unauthorized");
+        if (res.status === 403)
+            throw new AuthError(text || "forbidden");
+        if (res.status === 503 && /not connected/i.test(text)) {
+            const m = text.match(/serial\W*([\w-]+)/);
+            throw new DeviceOfflineError(m?.[1] ?? "<unknown>");
+        }
+        if (!res.ok) {
+            throw new ApiError(`${method} ${path}: ${res.status} ${text.slice(0, 200)}`, res.status);
+        }
+        if (!text)
+            return undefined;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            // Some endpoints (e.g. /apk/latest) stream non-JSON. The SDK doesn't
+            // call those; if we land here it's a contract violation worth surfacing.
+            throw new ApiError(`${method} ${path}: response was not JSON`, res.status);
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/src/transport.js.map

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