@drawcall/run 0.0.0

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+export type { JobStatus, RunResult, RunRequest, JobCreatedResponse, JobResponse, RunOptions, RunFinalResult, } from './types.js';
+import type { RunOptions, RunFinalResult } from './types.js';
+/**
+ * Error thrown when run fails
+ */
+export declare class RunError extends Error {
+    readonly jobId?: string | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, jobId?: string | undefined, cause?: unknown | undefined);
+}
+/**
+ * Error thrown when run times out
+ */
+export declare class TimeoutError extends RunError {
+    constructor(jobId: string, timeoutMs: number);
+}
+/**
+ * Run a web app through RunPod
+ *
+ * @example
+ * ```typescript
+ * import { run } from '@drawcall/run'
+ *
+ * const result = await run({
+ *   url: 'https://example.com/app',
+ *   maxDuration: 30,
+ *   timeoutMs: 60000,
+ *   pollIntervalMs: 2000,
+ * })
+ *
+ * console.log(result.logs)      // Browser console logs with screenshot URLs
+ * console.log(result.stopCause) // "signal_complete", "max_duration_reached", or "error: ..."
+ * console.log(result.jobId)     // Job ID for reference
+ * ```
+ */
+export declare function run(options: RunOptions): Promise<RunFinalResult>;
+//# 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":"AAIA,YAAY,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EAA+C,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEzG;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aACY,KAAK,CAAC,EAAE,MAAM;aAAkB,KAAK,CAAC,EAAE,OAAO;gBAAhF,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,MAAM,YAAA,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7F;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAI7C;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAqEtE"}

package/dist/index.js

@@ -0,0 +1,100 @@
+// ============================================================================
+// @drawcall/run - Client Package
+// ============================================================================
+/**
+ * Error thrown when run fails
+ */
+export class RunError extends Error {
+    jobId;
+    cause;
+    constructor(message, jobId, cause) {
+        super(message);
+        this.jobId = jobId;
+        this.cause = cause;
+        this.name = 'RunError';
+    }
+}
+/**
+ * Error thrown when run times out
+ */
+export class TimeoutError extends RunError {
+    constructor(jobId, timeoutMs) {
+        super(`Run timed out after ${timeoutMs}ms`, jobId);
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * Sleep for a given number of milliseconds
+ */
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Run a web app through RunPod
+ *
+ * @example
+ * ```typescript
+ * import { run } from '@drawcall/run'
+ *
+ * const result = await run({
+ *   url: 'https://example.com/app',
+ *   maxDuration: 30,
+ *   timeoutMs: 60000,
+ *   pollIntervalMs: 2000,
+ * })
+ *
+ * console.log(result.logs)      // Browser console logs with screenshot URLs
+ * console.log(result.stopCause) // "signal_complete", "max_duration_reached", or "error: ..."
+ * console.log(result.jobId)     // Job ID for reference
+ * ```
+ */
+export async function run(options) {
+    const { url: targetUrl, maxDuration, assetMap, baseUrl = 'https://v1.run.api.drawcall.ai', timeoutMs = 600_000, // 10 minutes default
+    pollIntervalMs = 2000, } = options;
+    const url = new URL('/run', baseUrl);
+    // Create the job
+    const payload = {
+        url: targetUrl,
+        ...(maxDuration !== undefined && { maxDuration }),
+        ...(assetMap !== undefined && { assetMap }),
+    };
+    const createResponse = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+    });
+    if (!createResponse.ok) {
+        const errorBody = await createResponse.text();
+        throw new RunError(`Failed to create job: ${createResponse.status} ${errorBody}`);
+    }
+    const { jobId } = (await createResponse.json());
+    // Poll for completion
+    const startTime = Date.now();
+    const jobUrl = new URL(`/job/${jobId}`, baseUrl);
+    while (true) {
+        if (Date.now() - startTime > timeoutMs) {
+            throw new TimeoutError(jobId, timeoutMs);
+        }
+        const statusResponse = await fetch(jobUrl);
+        if (!statusResponse.ok) {
+            throw new RunError(`Failed to get job status: ${statusResponse.status}`, jobId);
+        }
+        const job = (await statusResponse.json());
+        switch (job.status) {
+            case 'completed':
+                if (!job.result) {
+                    throw new RunError('Job completed but no result', jobId);
+                }
+                return {
+                    jobId,
+                    logs: job.result.logs,
+                    stopCause: job.result.stopCause,
+                };
+            case 'failed':
+                throw new RunError(job.error ?? 'Job failed', jobId);
+            case 'pending':
+            case 'running':
+                await sleep(pollIntervalMs);
+                break;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Status of a run job
+ */
+export type JobStatus = 'pending' | 'running' | 'completed' | 'failed';
+/**
+ * Request payload for running a web app
+ */
+export interface RunRequest {
+    readonly url: string;
+    readonly maxDuration?: number;
+    readonly assetMap?: Record<string, string>;
+}
+/**
+ * Result of a successful run
+ */
+export interface RunResult {
+    readonly logs: readonly string[];
+    readonly stopCause: 'signal_complete' | 'max_duration_reached' | `error: ${string}`;
+}
+/**
+ * Response when a job is created (202 Accepted)
+ */
+export interface JobCreatedResponse {
+    readonly jobId: string;
+}
+/**
+ * Full job status response
+ */
+export interface JobResponse {
+    readonly jobId: string;
+    readonly status: JobStatus;
+    readonly result?: RunResult;
+    readonly error?: string;
+}
+/**
+ * Options for the run function
+ */
+export interface RunOptions {
+    readonly url: string;
+    readonly maxDuration?: number;
+    readonly assetMap?: Record<string, string>;
+    readonly baseUrl?: string;
+    readonly timeoutMs?: number;
+    readonly pollIntervalMs?: number;
+}
+/**
+ * Final result returned by the run function
+ */
+export interface RunFinalResult {
+    readonly jobId: string;
+    readonly logs: readonly string[];
+    readonly stopCause: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEtE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,sBAAsB,GAAG,UAAU,MAAM,EAAE,CAAA;CACpF;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B"}

package/dist/types.js

@@ -0,0 +1,8 @@
+// ============================================================================
+// @drawcall/run - Client Types (Source of Truth)
+// ============================================================================
+// These plain TypeScript types define the API contract.
+// The server imports these and wraps them with Effect Schema for runtime validation.
+// All properties are readonly to match Effect Schema's immutable output.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAC/E,wDAAwD;AACxD,qFAAqF;AACrF,yEAAyE"}

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@drawcall/run",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}