boxer-sdk 0.1.0

package/README.md

@@ -0,0 +1,228 @@
+# boxer-sdk
+
+TypeScript client SDK for [Boxer](https://github.com/theonekeyg/boxer) - a sandboxed container execution service backed by gVisor.
+
+## Installation
+
+```bash
+npm install boxer-sdk
+```
+
+Requires Node.js 18+ (or any runtime with native `fetch`) and a running Boxer server.
+
+## Quick start
+
+```typescript
+import { BoxerClient } from "boxer-sdk";
+
+const client = new BoxerClient({ baseUrl: "http://localhost:8080" });
+
+const result = await client.run(
+  "python:3.12-slim",
+  ["python3", "-c", "print('hello world')"],
+);
+console.log(result.stdout);    // hello world
+console.log(result.exitCode);  // 0
+console.log(result.wall_ms);   // e.g. 312
+```
+
+---
+
+## Hello world in Python, Node.js, and Perl
+
+### Python
+
+```typescript
+const result = await client.run(
+  "python:3.12-slim",
+  ["python3", "-c", "print('hello world')"],
+);
+console.log(result.stdout); // hello world
+```
+
+### Node.js
+
+```typescript
+const result = await client.run(
+  "node:20-slim",
+  ["node", "-e", "console.log('hello world')"],
+);
+console.log(result.stdout); // hello world
+```
+
+### Perl
+
+```typescript
+const result = await client.run(
+  "perl:5.38-slim",
+  ["perl", "-e", "print 'hello world\n'"],
+);
+console.log(result.stdout); // hello world
+```
+
+---
+
+## Working with files
+
+### Upload a script and run it
+
+Upload a file to the Boxer file store, then reference it by path in `run`.
+The file is bind-mounted read-only at `/<remotePath>` inside the container.
+
+```typescript
+import { readFile } from "node:fs/promises";
+
+// Python
+const pyScript = await readFile("script.py");
+await client.uploadFile("script.py", pyScript);
+
+const result = await client.run(
+  "python:3.12-slim",
+  ["python3", "/script.py"],
+  { files: ["script.py"] },
+);
+
+// Node.js
+const jsScript = await readFile("app.js");
+await client.uploadFile("app.js", jsScript);
+
+const result = await client.run(
+  "node:20-slim",
+  ["node", "/app.js"],
+  { files: ["app.js"] },
+);
+
+// Perl
+const plScript = await readFile("hello.pl");
+await client.uploadFile("hello.pl", plScript);
+
+const result = await client.run(
+  "perl:5.38-slim",
+  ["perl", "/hello.pl"],
+  { files: ["hello.pl"] },
+);
+```
+
+### Upload a local file or directory
+
+`uploadPath` (available from `boxer-sdk/node`) recursively uploads a local file
+or directory, preserving the directory structure.
+
+```typescript
+import { uploadPath } from "boxer-sdk/node";
+
+// Upload a single file
+const paths = await uploadPath(client, "./script.py");
+// => ["script.py"]
+
+// Upload an entire directory
+const paths = await uploadPath(client, "./myproject", "myproject");
+// => ["myproject/main.py", "myproject/utils.py", ...]
+
+const result = await client.run(
+  "python:3.12-slim",
+  ["python3", "/myproject/main.py"],
+  { files: paths },
+);
+```
+
+### Download output files from the container
+
+Any file the container writes to `/output/` is automatically captured and
+retrievable via `downloadFile` after the run completes.
+
+```typescript
+const code = `
+import os, json
+os.makedirs('/output', exist_ok=True)
+with open('/output/result.json', 'w') as f:
+    json.dump({'message': 'hello world', 'value': 42}, f)
+`;
+
+const script = new TextEncoder().encode(code);
+await client.uploadFile("compute.py", script);
+
+const result = await client.run(
+  "python:3.12-slim",
+  ["python3", "/compute.py"],
+  { files: ["compute.py"] },
+);
+
+// Download the file the container wrote
+const data = await client.downloadFile(`output/${result.exec_id}/result.json`);
+console.log(new TextDecoder().decode(data)); // {"message": "hello world", "value": 42}
+```
+
+The output path pattern is always `output/<exec_id>/<filename>`.
+
+---
+
+## Resource limits
+
+```typescript
+import type { ResourceLimits } from "boxer-sdk";
+
+const limits: ResourceLimits = {
+  cpu_cores: 0.5,
+  memory_mb: 128,
+  wall_clock_secs: 10,
+};
+
+const result = await client.run(
+  "python:3.12-slim",
+  ["python3", "-c", "print('done')"],
+  { limits },
+);
+```
+
+---
+
+## Error handling
+
+```typescript
+import { BoxerAPIError, BoxerTimeoutError, BoxerOutputLimitError } from "boxer-sdk";
+
+try {
+  const result = await client.run(
+    "python:3.12-slim",
+    ["python3", "-c", "while True: pass"],
+    { limits: { wall_clock_secs: 5 } },
+  );
+} catch (err) {
+  if (err instanceof BoxerTimeoutError) {
+    console.error("execution timed out");
+  } else if (err instanceof BoxerOutputLimitError) {
+    console.error("output exceeded size limit");
+  } else if (err instanceof BoxerAPIError) {
+    console.error(`API error ${err.statusCode}: ${err.message}`);
+  }
+}
+```
+
+---
+
+## Runtime compatibility
+
+The core `boxer-sdk` package uses only web-standard APIs (`fetch`, `FormData`,
+`Blob`) and has zero dependencies, making it compatible with:
+
+- Node.js 18+
+- Bun
+- Deno
+- Browsers
+
+The `boxer-sdk/node` subpath export (`uploadPath`) requires a Node.js-compatible
+`fs` module and is available in Node, Bun, and Deno.
+
+---
+
+## Running tests
+
+Tests require a live Boxer server:
+
+```bash
+pnpm install
+BOXER_URL=http://localhost:8080 pnpm test
+```
+
+Without `BOXER_URL` all tests are skipped automatically.

package/dist/client-DpDp9i-R.d.cts

@@ -0,0 +1,39 @@
+interface ResourceLimits {
+    cpu_cores?: number;
+    memory_mb?: number;
+    pids_limit?: number;
+    wall_clock_secs?: number;
+    nofile?: number;
+}
+interface RunResult {
+    exec_id: string;
+    exit_code: number;
+    stdout: string;
+    stderr: string;
+    wall_ms: number;
+}
+interface RunOptions {
+    env?: string[];
+    cwd?: string;
+    limits?: ResourceLimits;
+    files?: string[];
+    persist?: boolean;
+    network?: string;
+}
+
+interface BoxerClientOptions {
+    baseUrl?: string;
+    timeout?: number;
+}
+declare class BoxerClient {
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(options?: BoxerClientOptions);
+    private fetch;
+    health(): Promise<boolean>;
+    run(image: string, cmd: string[], options?: RunOptions): Promise<RunResult>;
+    uploadFile(remotePath: string, content: Blob | Uint8Array | ArrayBuffer): Promise<void>;
+    downloadFile(path: string): Promise<Uint8Array>;
+}
+
+export { BoxerClient as B, type ResourceLimits as R, type BoxerClientOptions as a, type RunOptions as b, type RunResult as c };

package/dist/client-DpDp9i-R.d.ts

@@ -0,0 +1,39 @@
+interface ResourceLimits {
+    cpu_cores?: number;
+    memory_mb?: number;
+    pids_limit?: number;
+    wall_clock_secs?: number;
+    nofile?: number;
+}
+interface RunResult {
+    exec_id: string;
+    exit_code: number;
+    stdout: string;
+    stderr: string;
+    wall_ms: number;
+}
+interface RunOptions {
+    env?: string[];
+    cwd?: string;
+    limits?: ResourceLimits;
+    files?: string[];
+    persist?: boolean;
+    network?: string;
+}
+
+interface BoxerClientOptions {
+    baseUrl?: string;
+    timeout?: number;
+}
+declare class BoxerClient {
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(options?: BoxerClientOptions);
+    private fetch;
+    health(): Promise<boolean>;
+    run(image: string, cmd: string[], options?: RunOptions): Promise<RunResult>;
+    uploadFile(remotePath: string, content: Blob | Uint8Array | ArrayBuffer): Promise<void>;
+    downloadFile(path: string): Promise<Uint8Array>;
+}
+
+export { BoxerClient as B, type ResourceLimits as R, type BoxerClientOptions as a, type RunOptions as b, type RunResult as c };

package/dist/index.cjs

@@ -0,0 +1,169 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  BoxerAPIError: () => BoxerAPIError,
+  BoxerClient: () => BoxerClient,
+  BoxerError: () => BoxerError,
+  BoxerOutputLimitError: () => BoxerOutputLimitError,
+  BoxerTimeoutError: () => BoxerTimeoutError
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/errors.ts
+var BoxerError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "BoxerError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var BoxerAPIError = class extends BoxerError {
+  constructor(message, statusCode) {
+    super(message);
+    this.statusCode = statusCode;
+    this.name = "BoxerAPIError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var BoxerTimeoutError = class extends BoxerAPIError {
+  constructor(message, statusCode) {
+    super(message, statusCode);
+    this.name = "BoxerTimeoutError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var BoxerOutputLimitError = class extends BoxerAPIError {
+  constructor(message, statusCode) {
+    super(message, statusCode);
+    this.name = "BoxerOutputLimitError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/client.ts
+async function raiseForStatus(res) {
+  if (res.ok) return;
+  let detail;
+  try {
+    const body = await res.json();
+    detail = typeof body.error === "string" ? body.error : res.statusText;
+  } catch {
+    detail = res.statusText;
+  }
+  const code = res.status;
+  if (code === 408) throw new BoxerTimeoutError(detail, code);
+  if (code === 507) throw new BoxerOutputLimitError(detail, code);
+  throw new BoxerAPIError(detail, code);
+}
+function buildRunBody(image, cmd, options) {
+  const body = { image, cmd };
+  if (options.env?.length) body.env = options.env;
+  if (options.cwd && options.cwd !== "/") body.cwd = options.cwd;
+  if (options.limits) body.limits = limitsToObject(options.limits);
+  if (options.files?.length) body.files = options.files;
+  if (options.persist) body.persist = options.persist;
+  if (options.network != null) body.network = options.network;
+  return body;
+}
+function limitsToObject(limits) {
+  const out = {};
+  if (limits.cpu_cores != null) out.cpu_cores = limits.cpu_cores;
+  if (limits.memory_mb != null) out.memory_mb = limits.memory_mb;
+  if (limits.pids_limit != null) out.pids_limit = limits.pids_limit;
+  if (limits.wall_clock_secs != null) out.wall_clock_secs = limits.wall_clock_secs;
+  if (limits.nofile != null) out.nofile = limits.nofile;
+  return out;
+}
+function parseRunResult(data) {
+  if (data == null || typeof data !== "object" || !("exec_id" in data) || !("exit_code" in data) || !("stdout" in data) || !("stderr" in data) || !("wall_ms" in data)) {
+    throw new Error("Unexpected response from Boxer API: missing required fields");
+  }
+  const d = data;
+  return {
+    exec_id: String(d.exec_id),
+    exit_code: Number(d.exit_code),
+    stdout: String(d.stdout),
+    stderr: String(d.stderr),
+    wall_ms: Number(d.wall_ms)
+  };
+}
+var BoxerClient = class {
+  constructor(options = {}) {
+    this.baseUrl = (options.baseUrl ?? "http://localhost:8080").replace(/\/$/, "");
+    this.timeout = options.timeout ?? 12e4;
+  }
+  async fetch(path, init = {}) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      return await fetch(`${this.baseUrl}${path}`, {
+        ...init,
+        signal: controller.signal
+      });
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async health() {
+    const res = await this.fetch("/healthz");
+    return res.ok;
+  }
+  async run(image, cmd, options = {}) {
+    const body = buildRunBody(image, cmd, options);
+    const res = await this.fetch("/run", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    await raiseForStatus(res);
+    return parseRunResult(await res.json());
+  }
+  async uploadFile(remotePath, content) {
+    const form = new FormData();
+    form.append("path", remotePath);
+    let blob;
+    if (content instanceof Blob) {
+      blob = content;
+    } else if (content instanceof Uint8Array) {
+      blob = new Blob([new Uint8Array(content)], { type: "application/octet-stream" });
+    } else {
+      blob = new Blob([content], { type: "application/octet-stream" });
+    }
+    form.append("file", blob, remotePath.split("/").pop() ?? "file");
+    const res = await this.fetch("/files", { method: "POST", body: form });
+    await raiseForStatus(res);
+  }
+  async downloadFile(path) {
+    const res = await this.fetch(`/files?${new URLSearchParams({ path }).toString()}`);
+    await raiseForStatus(res);
+    return new Uint8Array(await res.arrayBuffer());
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BoxerAPIError,
+  BoxerClient,
+  BoxerError,
+  BoxerOutputLimitError,
+  BoxerTimeoutError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["export { BoxerClient } from \"./client.js\";\nexport type { BoxerClientOptions } from \"./client.js\";\nexport { BoxerAPIError, BoxerError, BoxerOutputLimitError, BoxerTimeoutError } from \"./errors.js\";\nexport type { ResourceLimits, RunOptions, RunResult } from \"./types.js\";\n","export class BoxerError extends Error {\n  override name = \"BoxerError\";\n\n  constructor(message: string) {\n    super(message);\n    // Restore prototype chain for instanceof checks across transpile boundaries\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class BoxerAPIError extends BoxerError {\n  override name = \"BoxerAPIError\";\n\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class BoxerTimeoutError extends BoxerAPIError {\n  override name = \"BoxerTimeoutError\";\n\n  constructor(message: string, statusCode: number) {\n    super(message, statusCode);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class BoxerOutputLimitError extends BoxerAPIError {\n  override name = \"BoxerOutputLimitError\";\n\n  constructor(message: string, statusCode: number) {\n    super(message, statusCode);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { BoxerAPIError, BoxerOutputLimitError, BoxerTimeoutError } from \"./errors.js\";\nimport type { ResourceLimits, RunOptions, RunResult } from \"./types.js\";\n\nexport interface BoxerClientOptions {\n  baseUrl?: string;\n  timeout?: number;\n}\n\nasync function raiseForStatus(res: Response): Promise<void> {\n  if (res.ok) return;\n\n  let detail: string;\n  try {\n    const body = (await res.json()) as Record<string, unknown>;\n    detail = typeof body.error === \"string\" ? body.error : res.statusText;\n  } catch {\n    detail = res.statusText;\n  }\n\n  const code = res.status;\n  if (code === 408) throw new BoxerTimeoutError(detail, code);\n  if (code === 507) throw new BoxerOutputLimitError(detail, code);\n  throw new BoxerAPIError(detail, code);\n}\n\nfunction buildRunBody(image: string, cmd: string[], options: RunOptions): Record<string, unknown> {\n  const body: Record<string, unknown> = { image, cmd };\n  if (options.env?.length) body.env = options.env;\n  if (options.cwd && options.cwd !== \"/\") body.cwd = options.cwd;\n  if (options.limits) body.limits = limitsToObject(options.limits);\n  if (options.files?.length) body.files = options.files;\n  if (options.persist) body.persist = options.persist;\n  if (options.network != null) body.network = options.network;\n  return body;\n}\n\nfunction limitsToObject(limits: ResourceLimits): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  if (limits.cpu_cores != null) out.cpu_cores = limits.cpu_cores;\n  if (limits.memory_mb != null) out.memory_mb = limits.memory_mb;\n  if (limits.pids_limit != null) out.pids_limit = limits.pids_limit;\n  if (limits.wall_clock_secs != null) out.wall_clock_secs = limits.wall_clock_secs;\n  if (limits.nofile != null) out.nofile = limits.nofile;\n  return out;\n}\n\nfunction parseRunResult(data: unknown): RunResult {\n  if (\n    data == null ||\n    typeof data !== \"object\" ||\n    !(\"exec_id\" in data) ||\n    !(\"exit_code\" in data) ||\n    !(\"stdout\" in data) ||\n    !(\"stderr\" in data) ||\n    !(\"wall_ms\" in data)\n  ) {\n    throw new Error(\"Unexpected response from Boxer API: missing required fields\");\n  }\n\n  const d = data as Record<string, unknown>;\n  return {\n    exec_id: String(d.exec_id),\n    exit_code: Number(d.exit_code),\n    stdout: String(d.stdout),\n    stderr: String(d.stderr),\n    wall_ms: Number(d.wall_ms),\n  };\n}\n\nexport class BoxerClient {\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(options: BoxerClientOptions = {}) {\n    this.baseUrl = (options.baseUrl ?? \"http://localhost:8080\").replace(/\\/$/, \"\");\n    this.timeout = options.timeout ?? 120_000;\n  }\n\n  private async fetch(path: string, init: RequestInit = {}): Promise<Response> {\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      return await fetch(`${this.baseUrl}${path}`, {\n        ...init,\n        signal: controller.signal,\n      });\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  async health(): Promise<boolean> {\n    const res = await this.fetch(\"/healthz\");\n    return res.ok;\n  }\n\n  async run(image: string, cmd: string[], options: RunOptions = {}): Promise<RunResult> {\n    const body = buildRunBody(image, cmd, options);\n    const res = await this.fetch(\"/run\", {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n    await raiseForStatus(res);\n    return parseRunResult(await res.json());\n  }\n\n  async uploadFile(remotePath: string, content: Blob | Uint8Array | ArrayBuffer): Promise<void> {\n    const form = new FormData();\n    form.append(\"path\", remotePath);\n    let blob: Blob;\n    if (content instanceof Blob) {\n      blob = content;\n    } else if (content instanceof Uint8Array) {\n      // Copy via ArrayLike<number> to ensure ArrayBuffer (not SharedArrayBuffer)\n      blob = new Blob([new Uint8Array(content)], { type: \"application/octet-stream\" });\n    } else {\n      blob = new Blob([content], { type: \"application/octet-stream\" });\n    }\n    form.append(\"file\", blob, remotePath.split(\"/\").pop() ?? \"file\");\n\n    const res = await this.fetch(\"/files\", { method: \"POST\", body: form });\n    await raiseForStatus(res);\n  }\n\n  async downloadFile(path: string): Promise<Uint8Array> {\n    const res = await this.fetch(`/files?${new URLSearchParams({ path }).toString()}`);\n    await raiseForStatus(res);\n    return new Uint8Array(await res.arrayBuffer());\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,21 @@
+export { B as BoxerClient, a as BoxerClientOptions, R as ResourceLimits, b as RunOptions, c as RunResult } from './client-DpDp9i-R.cjs';
+
+declare class BoxerError extends Error {
+    name: string;
+    constructor(message: string);
+}
+declare class BoxerAPIError extends BoxerError {
+    readonly statusCode: number;
+    name: string;
+    constructor(message: string, statusCode: number);
+}
+declare class BoxerTimeoutError extends BoxerAPIError {
+    name: string;
+    constructor(message: string, statusCode: number);
+}
+declare class BoxerOutputLimitError extends BoxerAPIError {
+    name: string;
+    constructor(message: string, statusCode: number);
+}
+
+export { BoxerAPIError, BoxerError, BoxerOutputLimitError, BoxerTimeoutError };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { B as BoxerClient, a as BoxerClientOptions, R as ResourceLimits, b as RunOptions, c as RunResult } from './client-DpDp9i-R.js';
+
+declare class BoxerError extends Error {
+    name: string;
+    constructor(message: string);
+}
+declare class BoxerAPIError extends BoxerError {
+    readonly statusCode: number;
+    name: string;
+    constructor(message: string, statusCode: number);
+}
+declare class BoxerTimeoutError extends BoxerAPIError {
+    name: string;
+    constructor(message: string, statusCode: number);
+}
+declare class BoxerOutputLimitError extends BoxerAPIError {
+    name: string;
+    constructor(message: string, statusCode: number);
+}
+
+export { BoxerAPIError, BoxerError, BoxerOutputLimitError, BoxerTimeoutError };

package/dist/index.js

@@ -0,0 +1,138 @@
+// src/errors.ts
+var BoxerError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "BoxerError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var BoxerAPIError = class extends BoxerError {
+  constructor(message, statusCode) {
+    super(message);
+    this.statusCode = statusCode;
+    this.name = "BoxerAPIError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var BoxerTimeoutError = class extends BoxerAPIError {
+  constructor(message, statusCode) {
+    super(message, statusCode);
+    this.name = "BoxerTimeoutError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var BoxerOutputLimitError = class extends BoxerAPIError {
+  constructor(message, statusCode) {
+    super(message, statusCode);
+    this.name = "BoxerOutputLimitError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/client.ts
+async function raiseForStatus(res) {
+  if (res.ok) return;
+  let detail;
+  try {
+    const body = await res.json();
+    detail = typeof body.error === "string" ? body.error : res.statusText;
+  } catch {
+    detail = res.statusText;
+  }
+  const code = res.status;
+  if (code === 408) throw new BoxerTimeoutError(detail, code);
+  if (code === 507) throw new BoxerOutputLimitError(detail, code);
+  throw new BoxerAPIError(detail, code);
+}
+function buildRunBody(image, cmd, options) {
+  const body = { image, cmd };
+  if (options.env?.length) body.env = options.env;
+  if (options.cwd && options.cwd !== "/") body.cwd = options.cwd;
+  if (options.limits) body.limits = limitsToObject(options.limits);
+  if (options.files?.length) body.files = options.files;
+  if (options.persist) body.persist = options.persist;
+  if (options.network != null) body.network = options.network;
+  return body;
+}
+function limitsToObject(limits) {
+  const out = {};
+  if (limits.cpu_cores != null) out.cpu_cores = limits.cpu_cores;
+  if (limits.memory_mb != null) out.memory_mb = limits.memory_mb;
+  if (limits.pids_limit != null) out.pids_limit = limits.pids_limit;
+  if (limits.wall_clock_secs != null) out.wall_clock_secs = limits.wall_clock_secs;
+  if (limits.nofile != null) out.nofile = limits.nofile;
+  return out;
+}
+function parseRunResult(data) {
+  if (data == null || typeof data !== "object" || !("exec_id" in data) || !("exit_code" in data) || !("stdout" in data) || !("stderr" in data) || !("wall_ms" in data)) {
+    throw new Error("Unexpected response from Boxer API: missing required fields");
+  }
+  const d = data;
+  return {
+    exec_id: String(d.exec_id),
+    exit_code: Number(d.exit_code),
+    stdout: String(d.stdout),
+    stderr: String(d.stderr),
+    wall_ms: Number(d.wall_ms)
+  };
+}
+var BoxerClient = class {
+  constructor(options = {}) {
+    this.baseUrl = (options.baseUrl ?? "http://localhost:8080").replace(/\/$/, "");
+    this.timeout = options.timeout ?? 12e4;
+  }
+  async fetch(path, init = {}) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      return await fetch(`${this.baseUrl}${path}`, {
+        ...init,
+        signal: controller.signal
+      });
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async health() {
+    const res = await this.fetch("/healthz");
+    return res.ok;
+  }
+  async run(image, cmd, options = {}) {
+    const body = buildRunBody(image, cmd, options);
+    const res = await this.fetch("/run", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    await raiseForStatus(res);
+    return parseRunResult(await res.json());
+  }
+  async uploadFile(remotePath, content) {
+    const form = new FormData();
+    form.append("path", remotePath);
+    let blob;
+    if (content instanceof Blob) {
+      blob = content;
+    } else if (content instanceof Uint8Array) {
+      blob = new Blob([new Uint8Array(content)], { type: "application/octet-stream" });
+    } else {
+      blob = new Blob([content], { type: "application/octet-stream" });
+    }
+    form.append("file", blob, remotePath.split("/").pop() ?? "file");
+    const res = await this.fetch("/files", { method: "POST", body: form });
+    await raiseForStatus(res);
+  }
+  async downloadFile(path) {
+    const res = await this.fetch(`/files?${new URLSearchParams({ path }).toString()}`);
+    await raiseForStatus(res);
+    return new Uint8Array(await res.arrayBuffer());
+  }
+};
+export {
+  BoxerAPIError,
+  BoxerClient,
+  BoxerError,
+  BoxerOutputLimitError,
+  BoxerTimeoutError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["export class BoxerError extends Error {\n  override name = \"BoxerError\";\n\n  constructor(message: string) {\n    super(message);\n    // Restore prototype chain for instanceof checks across transpile boundaries\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class BoxerAPIError extends BoxerError {\n  override name = \"BoxerAPIError\";\n\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class BoxerTimeoutError extends BoxerAPIError {\n  override name = \"BoxerTimeoutError\";\n\n  constructor(message: string, statusCode: number) {\n    super(message, statusCode);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class BoxerOutputLimitError extends BoxerAPIError {\n  override name = \"BoxerOutputLimitError\";\n\n  constructor(message: string, statusCode: number) {\n    super(message, statusCode);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { BoxerAPIError, BoxerOutputLimitError, BoxerTimeoutError } from \"./errors.js\";\nimport type { ResourceLimits, RunOptions, RunResult } from \"./types.js\";\n\nexport interface BoxerClientOptions {\n  baseUrl?: string;\n  timeout?: number;\n}\n\nasync function raiseForStatus(res: Response): Promise<void> {\n  if (res.ok) return;\n\n  let detail: string;\n  try {\n    const body = (await res.json()) as Record<string, unknown>;\n    detail = typeof body.error === \"string\" ? body.error : res.statusText;\n  } catch {\n    detail = res.statusText;\n  }\n\n  const code = res.status;\n  if (code === 408) throw new BoxerTimeoutError(detail, code);\n  if (code === 507) throw new BoxerOutputLimitError(detail, code);\n  throw new BoxerAPIError(detail, code);\n}\n\nfunction buildRunBody(image: string, cmd: string[], options: RunOptions): Record<string, unknown> {\n  const body: Record<string, unknown> = { image, cmd };\n  if (options.env?.length) body.env = options.env;\n  if (options.cwd && options.cwd !== \"/\") body.cwd = options.cwd;\n  if (options.limits) body.limits = limitsToObject(options.limits);\n  if (options.files?.length) body.files = options.files;\n  if (options.persist) body.persist = options.persist;\n  if (options.network != null) body.network = options.network;\n  return body;\n}\n\nfunction limitsToObject(limits: ResourceLimits): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  if (limits.cpu_cores != null) out.cpu_cores = limits.cpu_cores;\n  if (limits.memory_mb != null) out.memory_mb = limits.memory_mb;\n  if (limits.pids_limit != null) out.pids_limit = limits.pids_limit;\n  if (limits.wall_clock_secs != null) out.wall_clock_secs = limits.wall_clock_secs;\n  if (limits.nofile != null) out.nofile = limits.nofile;\n  return out;\n}\n\nfunction parseRunResult(data: unknown): RunResult {\n  if (\n    data == null ||\n    typeof data !== \"object\" ||\n    !(\"exec_id\" in data) ||\n    !(\"exit_code\" in data) ||\n    !(\"stdout\" in data) ||\n    !(\"stderr\" in data) ||\n    !(\"wall_ms\" in data)\n  ) {\n    throw new Error(\"Unexpected response from Boxer API: missing required fields\");\n  }\n\n  const d = data as Record<string, unknown>;\n  return {\n    exec_id: String(d.exec_id),\n    exit_code: Number(d.exit_code),\n    stdout: String(d.stdout),\n    stderr: String(d.stderr),\n    wall_ms: Number(d.wall_ms),\n  };\n}\n\nexport class BoxerClient {\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(options: BoxerClientOptions = {}) {\n    this.baseUrl = (options.baseUrl ?? \"http://localhost:8080\").replace(/\\/$/, \"\");\n    this.timeout = options.timeout ?? 120_000;\n  }\n\n  private async fetch(path: string, init: RequestInit = {}): Promise<Response> {\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      return await fetch(`${this.baseUrl}${path}`, {\n        ...init,\n        signal: controller.signal,\n      });\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  async health(): Promise<boolean> {\n    const res = await this.fetch(\"/healthz\");\n    return res.ok;\n  }\n\n  async run(image: string, cmd: string[], options: RunOptions = {}): Promise<RunResult> {\n    const body = buildRunBody(image, cmd, options);\n    const res = await this.fetch(\"/run\", {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n    await raiseForStatus(res);\n    return parseRunResult(await res.json());\n  }\n\n  async uploadFile(remotePath: string, content: Blob | Uint8Array | ArrayBuffer): Promise<void> {\n    const form = new FormData();\n    form.append(\"path\", remotePath);\n    let blob: Blob;\n    if (content instanceof Blob) {\n      blob = content;\n    } else if (content instanceof Uint8Array) {\n      // Copy via ArrayLike<number> to ensure ArrayBuffer (not SharedArrayBuffer)\n      blob = new Blob([new Uint8Array(content)], { type: \"application/octet-stream\" });\n    } else {\n      blob = new Blob([content], { type: \"application/octet-stream\" });\n    }\n    form.append(\"file\", blob, remotePath.split(\"/\").pop() ?? \"file\");\n\n    const res = await this.fetch(\"/files\", { method: \"POST\", body: form });\n    await raiseForStatus(res);\n  }\n\n  async downloadFile(path: string): Promise<Uint8Array> {\n    const res = await this.fetch(`/files?${new URLSearchParams({ path }).toString()}`);\n    await raiseForStatus(res);\n    return new Uint8Array(await res.arrayBuffer());\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/node.cjs

@@ -0,0 +1,62 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/node.ts
+var node_exports = {};
+__export(node_exports, {
+  uploadPath: () => uploadPath
+});
+module.exports = __toCommonJS(node_exports);
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+async function uploadPath(client, localPath, remotePath) {
+  const info = await (0, import_promises.stat)(localPath);
+  if (info.isDirectory()) {
+    const prefix = remotePath ?? (0, import_node_path.basename)(localPath);
+    const uploaded = [];
+    await uploadDir(client, localPath, localPath, prefix, uploaded);
+    return uploaded.sort();
+  }
+  const dest = remotePath ?? (0, import_node_path.basename)(localPath);
+  const content = await (0, import_promises.readFile)(localPath);
+  await client.uploadFile(dest, content);
+  return [dest];
+}
+async function uploadDir(client, rootDir, currentDir, prefix, uploaded) {
+  const entries = await (0, import_promises.readdir)(currentDir, { withFileTypes: true });
+  await Promise.all(
+    entries.map(async (entry) => {
+      const fullPath = (0, import_node_path.join)(currentDir, entry.name);
+      if (entry.isDirectory()) {
+        await uploadDir(client, rootDir, fullPath, prefix, uploaded);
+      } else if (entry.isFile()) {
+        const rel = (0, import_node_path.relative)(rootDir, fullPath);
+        const dest = `${prefix}/${rel.split("\\").join("/")}`;
+        const content = await (0, import_promises.readFile)(fullPath);
+        await client.uploadFile(dest, content);
+        uploaded.push(dest);
+      }
+    })
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  uploadPath
+});
+//# sourceMappingURL=node.cjs.map

package/dist/node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node.ts"],"sourcesContent":["import { readFile, readdir, stat } from \"node:fs/promises\";\nimport { basename, join, relative } from \"node:path\";\nimport type { BoxerClient } from \"./client.js\";\n\n/**\n * Upload a local file or directory to the Boxer file store.\n *\n * If `localPath` is a directory, all files inside it are uploaded recursively,\n * preserving the directory structure under `remotePath` (defaults to the\n * directory name).\n *\n * Returns the list of remote paths that were uploaded.\n *\n * Note: Requires a runtime with Node.js-compatible `fs` APIs (Node, Bun, Deno).\n */\nexport async function uploadPath(\n  client: BoxerClient,\n  localPath: string,\n  remotePath?: string,\n): Promise<string[]> {\n  const info = await stat(localPath);\n\n  if (info.isDirectory()) {\n    const prefix = remotePath ?? basename(localPath);\n    const uploaded: string[] = [];\n    await uploadDir(client, localPath, localPath, prefix, uploaded);\n    return uploaded.sort();\n  }\n\n  const dest = remotePath ?? basename(localPath);\n  const content = await readFile(localPath);\n  await client.uploadFile(dest, content);\n  return [dest];\n}\n\nasync function uploadDir(\n  client: BoxerClient,\n  rootDir: string,\n  currentDir: string,\n  prefix: string,\n  uploaded: string[],\n): Promise<void> {\n  const entries = await readdir(currentDir, { withFileTypes: true });\n\n  await Promise.all(\n    entries.map(async (entry) => {\n      const fullPath = join(currentDir, entry.name);\n      if (entry.isDirectory()) {\n        await uploadDir(client, rootDir, fullPath, prefix, uploaded);\n      } else if (entry.isFile()) {\n        const rel = relative(rootDir, fullPath);\n        const dest = `${prefix}/${rel.split(\"\\\\\").join(\"/\")}`;\n        const content = await readFile(fullPath);\n        await client.uploadFile(dest, content);\n        uploaded.push(dest);\n      }\n    }),\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAwC;AACxC,uBAAyC;AAczC,eAAsB,WACpB,QACA,WACA,YACmB;AACnB,QAAM,OAAO,UAAM,sBAAK,SAAS;AAEjC,MAAI,KAAK,YAAY,GAAG;AACtB,UAAM,SAAS,kBAAc,2BAAS,SAAS;AAC/C,UAAM,WAAqB,CAAC;AAC5B,UAAM,UAAU,QAAQ,WAAW,WAAW,QAAQ,QAAQ;AAC9D,WAAO,SAAS,KAAK;AAAA,EACvB;AAEA,QAAM,OAAO,kBAAc,2BAAS,SAAS;AAC7C,QAAM,UAAU,UAAM,0BAAS,SAAS;AACxC,QAAM,OAAO,WAAW,MAAM,OAAO;AACrC,SAAO,CAAC,IAAI;AACd;AAEA,eAAe,UACb,QACA,SACA,YACA,QACA,UACe;AACf,QAAM,UAAU,UAAM,yBAAQ,YAAY,EAAE,eAAe,KAAK,CAAC;AAEjE,QAAM,QAAQ;AAAA,IACZ,QAAQ,IAAI,OAAO,UAAU;AAC3B,YAAM,eAAW,uBAAK,YAAY,MAAM,IAAI;AAC5C,UAAI,MAAM,YAAY,GAAG;AACvB,cAAM,UAAU,QAAQ,SAAS,UAAU,QAAQ,QAAQ;AAAA,MAC7D,WAAW,MAAM,OAAO,GAAG;AACzB,cAAM,UAAM,2BAAS,SAAS,QAAQ;AACtC,cAAM,OAAO,GAAG,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,KAAK,GAAG,CAAC;AACnD,cAAM,UAAU,UAAM,0BAAS,QAAQ;AACvC,cAAM,OAAO,WAAW,MAAM,OAAO;AACrC,iBAAS,KAAK,IAAI;AAAA,MACpB;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/node.d.cts

@@ -0,0 +1,16 @@
+import { B as BoxerClient } from './client-DpDp9i-R.cjs';
+
+/**
+ * Upload a local file or directory to the Boxer file store.
+ *
+ * If `localPath` is a directory, all files inside it are uploaded recursively,
+ * preserving the directory structure under `remotePath` (defaults to the
+ * directory name).
+ *
+ * Returns the list of remote paths that were uploaded.
+ *
+ * Note: Requires a runtime with Node.js-compatible `fs` APIs (Node, Bun, Deno).
+ */
+declare function uploadPath(client: BoxerClient, localPath: string, remotePath?: string): Promise<string[]>;
+
+export { uploadPath };

package/dist/node.d.ts

@@ -0,0 +1,16 @@
+import { B as BoxerClient } from './client-DpDp9i-R.js';
+
+/**
+ * Upload a local file or directory to the Boxer file store.
+ *
+ * If `localPath` is a directory, all files inside it are uploaded recursively,
+ * preserving the directory structure under `remotePath` (defaults to the
+ * directory name).
+ *
+ * Returns the list of remote paths that were uploaded.
+ *
+ * Note: Requires a runtime with Node.js-compatible `fs` APIs (Node, Bun, Deno).
+ */
+declare function uploadPath(client: BoxerClient, localPath: string, remotePath?: string): Promise<string[]>;
+
+export { uploadPath };

package/dist/node.js

@@ -0,0 +1,37 @@
+// src/node.ts
+import { readFile, readdir, stat } from "fs/promises";
+import { basename, join, relative } from "path";
+async function uploadPath(client, localPath, remotePath) {
+  const info = await stat(localPath);
+  if (info.isDirectory()) {
+    const prefix = remotePath ?? basename(localPath);
+    const uploaded = [];
+    await uploadDir(client, localPath, localPath, prefix, uploaded);
+    return uploaded.sort();
+  }
+  const dest = remotePath ?? basename(localPath);
+  const content = await readFile(localPath);
+  await client.uploadFile(dest, content);
+  return [dest];
+}
+async function uploadDir(client, rootDir, currentDir, prefix, uploaded) {
+  const entries = await readdir(currentDir, { withFileTypes: true });
+  await Promise.all(
+    entries.map(async (entry) => {
+      const fullPath = join(currentDir, entry.name);
+      if (entry.isDirectory()) {
+        await uploadDir(client, rootDir, fullPath, prefix, uploaded);
+      } else if (entry.isFile()) {
+        const rel = relative(rootDir, fullPath);
+        const dest = `${prefix}/${rel.split("\\").join("/")}`;
+        const content = await readFile(fullPath);
+        await client.uploadFile(dest, content);
+        uploaded.push(dest);
+      }
+    })
+  );
+}
+export {
+  uploadPath
+};
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node.ts"],"sourcesContent":["import { readFile, readdir, stat } from \"node:fs/promises\";\nimport { basename, join, relative } from \"node:path\";\nimport type { BoxerClient } from \"./client.js\";\n\n/**\n * Upload a local file or directory to the Boxer file store.\n *\n * If `localPath` is a directory, all files inside it are uploaded recursively,\n * preserving the directory structure under `remotePath` (defaults to the\n * directory name).\n *\n * Returns the list of remote paths that were uploaded.\n *\n * Note: Requires a runtime with Node.js-compatible `fs` APIs (Node, Bun, Deno).\n */\nexport async function uploadPath(\n  client: BoxerClient,\n  localPath: string,\n  remotePath?: string,\n): Promise<string[]> {\n  const info = await stat(localPath);\n\n  if (info.isDirectory()) {\n    const prefix = remotePath ?? basename(localPath);\n    const uploaded: string[] = [];\n    await uploadDir(client, localPath, localPath, prefix, uploaded);\n    return uploaded.sort();\n  }\n\n  const dest = remotePath ?? basename(localPath);\n  const content = await readFile(localPath);\n  await client.uploadFile(dest, content);\n  return [dest];\n}\n\nasync function uploadDir(\n  client: BoxerClient,\n  rootDir: string,\n  currentDir: string,\n  prefix: string,\n  uploaded: string[],\n): Promise<void> {\n  const entries = await readdir(currentDir, { withFileTypes: true });\n\n  await Promise.all(\n    entries.map(async (entry) => {\n      const fullPath = join(currentDir, entry.name);\n      if (entry.isDirectory()) {\n        await uploadDir(client, rootDir, fullPath, prefix, uploaded);\n      } else if (entry.isFile()) {\n        const rel = relative(rootDir, fullPath);\n        const dest = `${prefix}/${rel.split(\"\\\\\").join(\"/\")}`;\n        const content = await readFile(fullPath);\n        await client.uploadFile(dest, content);\n        uploaded.push(dest);\n      }\n    }),\n  );\n}\n"],"mappings":";AAAA,SAAS,UAAU,SAAS,YAAY;AACxC,SAAS,UAAU,MAAM,gBAAgB;AAczC,eAAsB,WACpB,QACA,WACA,YACmB;AACnB,QAAM,OAAO,MAAM,KAAK,SAAS;AAEjC,MAAI,KAAK,YAAY,GAAG;AACtB,UAAM,SAAS,cAAc,SAAS,SAAS;AAC/C,UAAM,WAAqB,CAAC;AAC5B,UAAM,UAAU,QAAQ,WAAW,WAAW,QAAQ,QAAQ;AAC9D,WAAO,SAAS,KAAK;AAAA,EACvB;AAEA,QAAM,OAAO,cAAc,SAAS,SAAS;AAC7C,QAAM,UAAU,MAAM,SAAS,SAAS;AACxC,QAAM,OAAO,WAAW,MAAM,OAAO;AACrC,SAAO,CAAC,IAAI;AACd;AAEA,eAAe,UACb,QACA,SACA,YACA,QACA,UACe;AACf,QAAM,UAAU,MAAM,QAAQ,YAAY,EAAE,eAAe,KAAK,CAAC;AAEjE,QAAM,QAAQ;AAAA,IACZ,QAAQ,IAAI,OAAO,UAAU;AAC3B,YAAM,WAAW,KAAK,YAAY,MAAM,IAAI;AAC5C,UAAI,MAAM,YAAY,GAAG;AACvB,cAAM,UAAU,QAAQ,SAAS,UAAU,QAAQ,QAAQ;AAAA,MAC7D,WAAW,MAAM,OAAO,GAAG;AACzB,cAAM,MAAM,SAAS,SAAS,QAAQ;AACtC,cAAM,OAAO,GAAG,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,KAAK,GAAG,CAAC;AACnD,cAAM,UAAU,MAAM,SAAS,QAAQ;AACvC,cAAM,OAAO,WAAW,MAAM,OAAO;AACrC,iBAAS,KAAK,IAAI;AAAA,MACpB;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "boxer-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Boxer sandboxed container execution service",
+  "license": "Apache-2.0",
+  "author": "Alexander Kolupaev <theonekeyg@gmail.com>",
+  "homepage": "https://github.com/theonekeyg/boxer",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.mjs",
+      "require": "./dist/node.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": ["@biomejs/biome", "esbuild"]
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  }
+}