@arker-ai/sdk 0.3.0 → 0.5.2

package/dist/index.js

@@ -1,478 +1,14 @@
-// src/index.ts
-var CHUNK_SIZE = 4 * 1024 * 1024;
-var DEFAULT_RETRY_ATTEMPTS = 4;
-var DEFAULT_RETRY_BASE_DELAY_MS = 200;
-var DEFAULT_RETRY_MAX_DELAY_MS = 2e3;
-var DEFAULT_RETRY_JITTER_MS = 50;
-var PRESIGNED_PUT_TIMEOUT_MS = 6e5;
-var RETRYABLE_HTTP = /* @__PURE__ */ new Set([429, 502, 503, 504]);
-var RETRYABLE_CODES = /* @__PURE__ */ new Set(["routing_unavailable", "unavailable", "temporarily_unavailable"]);
-var TRANSIENT_HINTS = ["503", "Service Unavailable", "throttle", "SlowDown", "ThrottlingException"];
-var ULID_ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-var DEFAULT_REGION_ENV = "ARKER_REGION";
-var BURST_SOURCE_REFS = /* @__PURE__ */ new Set(["arkuntu"]);
-var BURST_VM_ID = /^[0-9A-HJKMNP-TV-Z]{26}_[A-Za-z0-9]+$/;
-var ArkerError = class extends Error {
-  code;
-  status;
-  constructor(code, message, status) {
-    super(`${code}: ${message}`);
-    this.name = "ArkerError";
-    this.code = code;
-    this.status = status;
-  }
-};
-var Arker = class {
-  baseUrl;
-  burstBaseUrl;
-  region;
-  apiKey;
-  fetchImpl;
-  retry;
-  constructor(opts = {}) {
-    const apiKey = opts.apiKey ?? env("ARKER_API_KEY") ?? env("AUTH_KEY");
-    const explicitBaseUrl = opts.baseUrl ?? env("ARKER_BASE_URL");
-    const region = opts.region ?? (explicitBaseUrl ? void 0 : env(DEFAULT_REGION_ENV));
-    const baseUrl = explicitBaseUrl ?? (region ? regionBaseUrl(region, false) : void 0);
-    const burstBaseUrl = opts.burstBaseUrl ?? env("ARKER_BURST_BASE_URL") ?? (region ? regionBaseUrl(region, true) : void 0);
-    if (!apiKey) throw new Error("apiKey is required; pass apiKey or set ARKER_API_KEY");
-    if (!baseUrl) throw new Error("region or baseUrl is required; pass region, baseUrl, ARKER_REGION, or ARKER_BASE_URL");
-    this.apiKey = apiKey;
-    this.baseUrl = normalizeBaseUrl(baseUrl);
-    this.burstBaseUrl = burstBaseUrl ? normalizeBaseUrl(burstBaseUrl) : void 0;
-    this.region = region ? normalizeRegion(region) : void 0;
-    this.fetchImpl = opts.fetch ?? globalThis.fetch;
-    this.retry = normalizeRetry(opts.retry);
-    if (!this.fetchImpl) throw new Error("fetch is required in this runtime");
-  }
-  vm(vmId) {
-    return new Computer(this, vmId, this._baseUrlFor(vmId));
-  }
-  async goldens() {
-    return this._request("GET", "/v1/goldens");
-  }
-  async list() {
-    return this._request("GET", "/v1/vms");
-  }
-  async get(vmId) {
-    return this._request("GET", vmPath(vmId), void 0, this._baseUrlFor(vmId));
-  }
-  /** @internal */
-  async _request(method, path, body, baseUrl = this.baseUrl, extraHeaders) {
-    const url = `${baseUrl}${path}`;
-    const headers = {
-      authorization: `Bearer ${this.apiKey}`
-    };
-    if (extraHeaders) {
-      for (const [key, value] of Object.entries(extraHeaders)) {
-        if (value !== void 0) headers[key] = value;
-      }
-    }
-    const init = { method, headers };
-    if (body !== void 0) {
-      headers["content-type"] = "application/json";
-      init.body = JSON.stringify(withoutUndefined(body));
-    }
-    let lastStatus = 0;
-    let lastText = "";
-    let lastError;
-    for (let attempt = 0; attempt < this.retry.attempts; attempt++) {
-      try {
-        const response = await this.fetchImpl(url, init);
-        const text = await response.text();
-        const payload = parseJson(text);
-        const parsedError = extractError(payload);
-        lastStatus = response.status;
-        lastText = text;
-        lastError = parsedError;
-        if (isRetryable(response.status, parsedError) && attempt < this.retry.attempts - 1) {
-          await sleep(retryDelay(this.retry, attempt));
-          continue;
-        }
-        if (parsedError) throw new ArkerError(parsedError.code, parsedError.message, response.status);
-        if (!response.ok) {
-          throw new ArkerError("internal", lastText.slice(0, 300) || `HTTP ${response.status}`, response.status);
-        }
-        return payload;
-      } catch (error) {
-        if (error instanceof ArkerError) throw error;
-        if (attempt < this.retry.attempts - 1) {
-          await sleep(retryDelay(this.retry, attempt));
-          continue;
-        }
-        const message = error instanceof Error ? error.message : String(error);
-        throw new ArkerError("network_error", message, 0);
-      }
-    }
-    if (lastError) throw new ArkerError(lastError.code, lastError.message, lastStatus);
-    throw new ArkerError("internal", lastText.slice(0, 300) || `HTTP ${lastStatus}`, lastStatus);
-  }
-  /** @internal */
-  async _fetch(input, init) {
-    return this.fetchImpl(input, init);
-  }
-  /** @internal */
-  _retryAttempts() {
-    return this.retry.attempts;
-  }
-  /** @internal */
-  _retryDelay(attempt) {
-    return retryDelay(this.retry, attempt);
-  }
-  /** @internal */
-  _baseUrlFor(ref) {
-    if (isBurstRef(ref) && this.burstBaseUrl) return this.burstBaseUrl;
-    return this.baseUrl;
-  }
-};
-var Computer = class _Computer {
-  id;
-  baseUrl;
-  sync;
-  /** @internal */
-  _client;
-  constructor(client, vmId, baseUrl = client._baseUrlFor(vmId)) {
-    this._client = client;
-    this.id = vmId;
-    this.baseUrl = baseUrl;
-    this.sync = new Sync(this);
-  }
-  async fork(request = {}) {
-    const response = await this._client._request(
-      "POST",
-      `${vmPath(this.id)}/fork`,
-      request,
-      this.baseUrl
-    );
-    return new _Computer(this._client, stringField(response.vm_id ?? response.id, "fork response.vm_id"), this.baseUrl);
-  }
-  async run(command, options = {}) {
-    const { idempotencyKey, ...body } = options;
-    const headers = idempotencyKey ? { "Idempotency-Key": idempotencyKey } : void 0;
-    const response = await this._client._request(
-      "POST",
-      `${vmPath(this.id)}/run`,
-      { ...body, command },
-      this.baseUrl,
-      headers
-    );
-    return parseRunResponse(response);
-  }
-  async runStatus(runId) {
-    return this._client._request("GET", `${vmPath(this.id)}/runs/${pathSegment(runId)}`, void 0, this.baseUrl);
-  }
-  async cancelRun(runId) {
-    return this._client._request("DELETE", `${vmPath(this.id)}/runs/${pathSegment(runId)}`, void 0, this.baseUrl);
-  }
-  async delete() {
-    return this._client._request("DELETE", vmPath(this.id), void 0, this.baseUrl);
-  }
-};
-var Sync = class {
-  /** @internal */
-  _vm;
-  constructor(vm) {
-    this._vm = vm;
-  }
-  async readFile(path) {
-    const response = await this._vm._client._request(
-      "POST",
-      this.path(),
-      { op: "read", path },
-      this._vm.baseUrl
-    );
-    if ("content" in response) return decodeBytes(response.content, response.encoding);
-    const signed = await this._vm._client._fetch(response.presigned_url);
-    if (!signed.ok) throw new ArkerError("internal", `signed GET failed: ${signed.status}`, signed.status);
-    return new Uint8Array(await signed.arrayBuffer());
-  }
-  async writeFile(path, data) {
-    const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
-    if (bytes.length <= CHUNK_SIZE) {
-      await this.writeInline(path, bytes);
-    } else {
-      await this.writePresigned(path, bytes);
-    }
-  }
-  path() {
-    return `${vmPath(this._vm.id)}/sync`;
-  }
-  async writeInline(path, data) {
-    const result = await this.sendOneWrite({
-      path,
-      size: data.length,
-      upload_id: ulid(),
-      content: bytesToBase64(data),
-      start: 0,
-      end: data.length
-    });
-    assertWriteComplete(result, "inline write");
-  }
-  async writePresigned(path, data) {
-    const request = await this.sendOneWrite({
-      path,
-      size: data.length,
-      presigned: true
-    });
-    if (!("presigned_url" in request) || !request.presigned_url || !request.upload_id) {
-      throw new ArkerError("internal", "write response missing presigned upload fields", 200);
-    }
-    await this.putPresigned(request.presigned_url, data);
-    const commit = await this.sendOneWrite({
-      path,
-      size: data.length,
-      upload_id: request.upload_id
-    });
-    assertWriteComplete(commit, "presigned write commit");
-  }
-  async putPresigned(url, data) {
-    const attempts = this._vm._client._retryAttempts();
-    for (let attempt = 0; attempt < attempts; attempt++) {
-      const controller = new AbortController();
-      const timeout = setTimeout(() => controller.abort(), PRESIGNED_PUT_TIMEOUT_MS);
-      try {
-        const response = await this._vm._client._fetch(url, {
-          method: "PUT",
-          body: data,
-          signal: controller.signal
-        });
-        clearTimeout(timeout);
-        if (response.ok) return;
-        if (!RETRYABLE_HTTP.has(response.status) || attempt === attempts - 1) {
-          throw new ArkerError("internal", `upload PUT failed: ${response.status}`, response.status);
-        }
-      } catch (error) {
-        clearTimeout(timeout);
-        if (error instanceof ArkerError) throw error;
-        if (attempt === attempts - 1) {
-          const message = error instanceof Error ? error.message : String(error);
-          throw new ArkerError("network_error", `upload PUT failed: ${message}`, 0);
-        }
-      }
-      await sleep(this._vm._client._retryDelay(attempt));
-    }
-  }
-  async sendOneWrite(entry) {
-    let lastError;
-    const attempts = this._vm._client._retryAttempts();
-    for (let attempt = 0; attempt < attempts; attempt++) {
-      const response = await this._vm._client._request("POST", this.path(), {
-        op: "write",
-        writes: [entry]
-      }, this._vm.baseUrl);
-      const result = response.results[0];
-      if (!result) throw new ArkerError("internal", "write response missing results[0]", 200);
-      const error = result.error ?? void 0;
-      if (!error) return result;
-      lastError = error;
-      if (!isRetryable(200, error) || attempt === attempts - 1) break;
-      await sleep(this._vm._client._retryDelay(attempt));
-    }
-    throw new ArkerError(lastError?.code ?? "internal", lastError?.message ?? "write failed", 200);
-  }
-};
-function normalizeBaseUrl(baseUrl) {
-  const trimmed = baseUrl.trim().replace(/\/+$/, "");
-  if (!trimmed) throw new Error("baseUrl must not be empty");
-  return trimmed;
-}
-function normalizeRegion(region) {
-  const trimmed = region.trim().toLowerCase();
-  if (!trimmed) throw new Error("region must not be empty");
-  return trimmed;
-}
-function regionBaseUrl(region, burst) {
-  const normalized = normalizeRegion(region);
-  if (!burst) return `https://${normalized}.arker.ai/api`;
-  return `https://${burstRegionHost(normalized)}.arker.ai/api`;
-}
-function burstRegionHost(region) {
-  if (region.startsWith("aws-")) return `aws-burst-${region.slice("aws-".length)}`;
-  return `${region}-burst`;
-}
-function isBurstRef(ref) {
-  const trimmed = ref.trim();
-  return BURST_SOURCE_REFS.has(trimmed.toLowerCase()) || BURST_VM_ID.test(trimmed);
-}
-function normalizeRetry(retry) {
-  if (retry === false) {
-    return { attempts: 1, baseDelayMs: 0, maxDelayMs: 0, jitterMs: 0 };
-  }
-  return {
-    attempts: Math.max(1, Math.floor(retry?.attempts ?? DEFAULT_RETRY_ATTEMPTS)),
-    baseDelayMs: Math.max(0, retry?.baseDelayMs ?? DEFAULT_RETRY_BASE_DELAY_MS),
-    maxDelayMs: Math.max(0, retry?.maxDelayMs ?? DEFAULT_RETRY_MAX_DELAY_MS),
-    jitterMs: Math.max(0, retry?.jitterMs ?? DEFAULT_RETRY_JITTER_MS)
-  };
-}
-function env(name) {
-  const value = globalThis.process?.env?.[name];
-  const trimmed = value?.trim();
-  return trimmed ? trimmed : void 0;
-}
-function vmPath(vmId) {
-  return `/v1/vms/${pathSegment(vmId)}`;
-}
-function pathSegment(value) {
-  return encodeURIComponent(value);
-}
-function withoutUndefined(value) {
-  if (Array.isArray(value)) return value.map(withoutUndefined);
-  if (!value || typeof value !== "object") return value;
-  const output = {};
-  for (const [key, entry] of Object.entries(value)) {
-    if (entry !== void 0) output[key] = withoutUndefined(entry);
-  }
-  return output;
-}
-function parseRunResponse(payload) {
-  const body = objectPayload(payload, "run response");
-  if (typeof body.stdout === "string") {
-    const stdout = stringValue(body.stdout, "run response.stdout");
-    const stdoutEncoding = stringField(body.stdout_encoding, "run response.stdout_encoding");
-    const stderr = stringValue(body.stderr, "run response.stderr");
-    const stderrEncoding = stringField(body.stderr_encoding, "run response.stderr_encoding");
-    if (body.completed !== true) {
-      throw new ArkerError("internal", "completed run response must have completed=true", 200);
-    }
-    return {
-      type: "completed",
-      completed: true,
-      stdout: decodeBytes(stdout, stdoutEncoding),
-      stdoutEncoding,
-      stderr: decodeBytes(stderr, stderrEncoding),
-      stderrEncoding,
-      exitCode: numberField(body.exit_code, "run response.exit_code")
-    };
-  }
-  if (typeof body.run_id === "string") {
-    return {
-      type: "background",
-      completed: Boolean(body.completed),
-      runId: body.run_id,
-      tunnels: Array.isArray(body.tunnels) ? body.tunnels : [],
-      network: isObject(body.network) ? body.network : null
-    };
-  }
-  if (body.pty === true) {
-    return {
-      type: "pty",
-      pty: true,
-      sessionId: stringField(body.session_id, "run response.session_id"),
-      wsUrl: stringField(body.ws_url, "run response.ws_url")
-    };
-  }
-  throw new ArkerError("internal", "unrecognized run response shape", 200);
-}
-function parseJson(text) {
-  if (!text) return {};
-  try {
-    return JSON.parse(text);
-  } catch {
-    return void 0;
-  }
-}
-function extractError(payload) {
-  if (!isObject(payload)) return void 0;
-  if (typeof payload.code === "string" && typeof payload.message === "string") {
-    return { code: payload.code, message: payload.message };
-  }
-  if (isObject(payload.error)) {
-    return {
-      code: typeof payload.error.code === "string" ? payload.error.code : "internal",
-      message: typeof payload.error.message === "string" ? payload.error.message : ""
-    };
-  }
-  return void 0;
-}
-function isRetryable(status, error) {
-  if (RETRYABLE_HTTP.has(status)) return true;
-  if (!error) return false;
-  if (RETRYABLE_CODES.has(error.code)) return true;
-  if (error.code !== "internal") return false;
-  return TRANSIENT_HINTS.some((hint) => error.message.includes(hint));
-}
-function retryDelay(retry, attempt) {
-  const base = Math.min(retry.maxDelayMs, retry.baseDelayMs * 2 ** attempt);
-  return base + jitter(retry.jitterMs);
-}
-function jitter(maxMs) {
-  return Math.floor(Math.random() * (maxMs + 1));
-}
-async function sleep(ms) {
-  await new Promise((resolve) => setTimeout(resolve, ms));
-}
-function objectPayload(value, context) {
-  if (!isObject(value)) throw new ArkerError("internal", `${context} must be an object`, 200);
-  return value;
-}
-function isObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function stringField(value, context) {
-  if (typeof value !== "string" || value.length === 0) {
-    throw new ArkerError("internal", `${context} must be a non-empty string`, 200);
-  }
-  return value;
-}
-function stringValue(value, context) {
-  if (typeof value !== "string") throw new ArkerError("internal", `${context} must be a string`, 200);
-  return value;
-}
-function numberField(value, context) {
-  if (typeof value !== "number") throw new ArkerError("internal", `${context} must be a number`, 200);
-  return value;
-}
-function assertWriteComplete(result, context) {
-  if (result.complete && result.written) return;
-  throw new ArkerError("internal", `${context} did not complete`, 200);
-}
-function ulid() {
-  const crypto = globalThis.crypto;
-  if (!crypto?.getRandomValues) throw new Error("crypto.getRandomValues is required in this runtime");
-  const time = BigInt(Date.now()) & (1n << 48n) - 1n;
-  const rand = new Uint8Array(10);
-  crypto.getRandomValues(rand);
-  let raw = time << 80n | rand.reduce((acc, byte) => acc << 8n | BigInt(byte), 0n);
-  const out = [];
-  for (let i = 0; i < 26; i++) {
-    out.push(ULID_ALPHABET[Number(raw & 31n)]);
-    raw >>= 5n;
-  }
-  return out.reverse().join("");
-}
-function decodeBytes(text, encoding) {
-  if (encoding === "base64") return base64ToBytes(text);
-  return new TextEncoder().encode(text);
-}
-function bytesToBase64(data) {
-  const buffer = bufferConstructor();
-  if (buffer) return buffer.from(data).toString("base64");
-  let binary = "";
-  for (let offset = 0; offset < data.length; offset += 32768) {
-    const chunk = data.subarray(offset, offset + 32768);
-    binary += String.fromCharCode(...chunk);
-  }
-  return btoa(binary);
-}
-function base64ToBytes(text) {
-  const buffer = bufferConstructor();
-  if (buffer) {
-    const decoded = buffer.from(text, "base64");
-    return new Uint8Array(decoded.buffer, decoded.byteOffset, decoded.byteLength);
-  }
-  const binary = atob(text);
-  const out = new Uint8Array(binary.length);
-  for (let i = 0; i < binary.length; i++) out[i] = binary.charCodeAt(i);
-  return out;
-}
-function bufferConstructor() {
-  return globalThis.Buffer;
-}
+import {
+  ARKER_ORG_ID,
+  Arker,
+  ArkerError,
+  CHUNK_SIZE,
+  VM
+} from "./chunk-YGZOUXII.js";
 export {
+  ARKER_ORG_ID,
   Arker,
   ArkerError,
   CHUNK_SIZE,
-  Computer,
-  Sync
+  VM
 };

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@arker-ai/sdk",
-  "version": "0.3.0",
+  "version": "0.5.2",
   "description": "TypeScript SDK for the Arker virtual computer platform — spawn sandboxed VMs, run code, sync files.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "arker": "./dist/cli.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -13,12 +16,16 @@
       "require": "./dist/index.cjs"
     }
   },
-  "files": ["dist", "README.md", "LICENSE"],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "engines": {
     "node": ">=18"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts --clean --target=node18",
+    "build": "tsup src/index.ts src/cli.ts --format esm,cjs --dts --clean --target=node18",
     "check:api-types": "openapi-typescript ../contract/openapi.json --default-non-nullable false -o src/generated/api-types.ts --check",
     "demo": "tsx tests/demo.ts",
     "generate:api-types": "openapi-typescript ../contract/openapi.json --default-non-nullable false -o src/generated/api-types.ts",
@@ -27,7 +34,13 @@
     "typecheck": "tsc -p tsconfig.test.json",
     "prepublishOnly": "npm run build"
   },
-  "keywords": ["arker", "vm", "sandbox", "agent", "code-execution"],
+  "keywords": [
+    "arker",
+    "vm",
+    "sandbox",
+    "agent",
+    "code-execution"
+  ],
   "license": "Apache-2.0",
   "homepage": "https://arker.ai",
   "repository": {