vyoma 0.1.0

package/README.md

@@ -0,0 +1,117 @@
+# Vyoma SDK
+
+Official JavaScript / TypeScript SDK for **Vyoma** — a developer platform for creating, managing, and controlling isolated development sandboxes programmatically.
+
+The SDK is fully typed, lightweight, and designed to work cleanly with modern Node.js and TypeScript environments.
+
+---
+
+## Installation
+
+```bash
+npm install vyoma
+```
+
+---
+
+## Quick Start
+
+This is the minimum working example to verify the SDK is installed and usable.
+
+```ts
+import { VyomaClient } from "vyoma";
+
+const vyoma = new VyomaClient({
+  apiKey: process.env.VYOMA_API_KEY!,
+});
+
+// Create a sandbox
+const { sandbox } = await vyoma.sandbox.create({
+  templateId: "nextjs-preview",
+  timeout: 600,
+});
+
+console.log(sandbox.id, sandbox.status);
+```
+
+If this runs and you get autocomplete, the SDK is working correctly.
+
+---
+
+## Configuration
+
+### VyomaClient
+
+```ts
+new VyomaClient({
+  apiKey: string;        // required
+  baseUrl?: string;     // optional, defaults to Vyoma API
+});
+```
+
+Example:
+
+```ts
+const vyoma = new VyomaClient({
+  apiKey: "vk_live_xxx",
+});
+```
+
+---
+
+## Sandbox API
+
+### Create Sandbox
+
+```ts
+const response = await vyoma.sandbox.create({
+  templateId: "nextjs-preview",
+  timeout: 600,
+});
+```
+
+### Stop Sandbox
+
+```ts
+await vyoma.sandbox.stop("sandbox_id");
+```
+
+### Get Sandbox Status
+
+```ts
+const status = await vyoma.sandbox.status("sandbox_id");
+```
+
+---
+
+## Type Safety
+
+The Vyoma SDK is fully typed.
+
+All request payloads and responses are strict TypeScript contracts that mirror the Vyoma API.
+This enables autocomplete, compile-time validation, and safe refactoring.
+
+---
+
+## Runtime Support
+
+- Node.js 18+
+- Bun
+- Deno (npm compatibility)
+- Vite
+- Next.js (App Router & Pages Router)
+
+---
+
+## Versioning
+
+The SDK follows semantic versioning.
+
+- 0.x → early development
+- Breaking changes may occur before 1.0.0
+
+---
+
+## License
+
+MIT © Vyoma

package/dist/index.d.mts

@@ -0,0 +1,52 @@
+type ID = string;
+type ISODate = string;
+interface ApiError {
+    error: string;
+    code?: string;
+}
+
+interface SandboxCreateRequest {
+    templateId: ID;
+    timeout?: number;
+}
+interface SandboxStopRequest {
+    sandboxId: ID;
+}
+type SandboxStatus = "starting" | "running" | "stopped" | "error";
+interface Sandbox {
+    id: ID;
+    templateId: ID;
+    status: SandboxStatus;
+    createdAt: ISODate;
+    expiresAt?: ISODate;
+    url?: string;
+}
+interface SandboxCreateResponse {
+    sandbox: Sandbox;
+}
+interface SandboxStatusResponse {
+    sandboxId: ID;
+    status: SandboxStatus;
+}
+
+declare class SandboxResource {
+    private client;
+    constructor(client: VyomaClient);
+    create(data: SandboxCreateRequest): Promise<SandboxCreateResponse>;
+    stop(sandboxId: string): Promise<unknown>;
+    status(sandboxId: string): Promise<SandboxStatusResponse>;
+}
+
+interface VyomaClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+declare class VyomaClient {
+    private apiKey;
+    private baseUrl;
+    constructor(options: VyomaClientOptions);
+    request<T>(path: string, options?: RequestInit): Promise<T>;
+    sandbox: SandboxResource;
+}
+
+export { type ApiError, type ID, type ISODate, type Sandbox, type SandboxCreateRequest, type SandboxCreateResponse, type SandboxStatus, type SandboxStatusResponse, type SandboxStopRequest, VyomaClient };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+type ID = string;
+type ISODate = string;
+interface ApiError {
+    error: string;
+    code?: string;
+}
+
+interface SandboxCreateRequest {
+    templateId: ID;
+    timeout?: number;
+}
+interface SandboxStopRequest {
+    sandboxId: ID;
+}
+type SandboxStatus = "starting" | "running" | "stopped" | "error";
+interface Sandbox {
+    id: ID;
+    templateId: ID;
+    status: SandboxStatus;
+    createdAt: ISODate;
+    expiresAt?: ISODate;
+    url?: string;
+}
+interface SandboxCreateResponse {
+    sandbox: Sandbox;
+}
+interface SandboxStatusResponse {
+    sandboxId: ID;
+    status: SandboxStatus;
+}
+
+declare class SandboxResource {
+    private client;
+    constructor(client: VyomaClient);
+    create(data: SandboxCreateRequest): Promise<SandboxCreateResponse>;
+    stop(sandboxId: string): Promise<unknown>;
+    status(sandboxId: string): Promise<SandboxStatusResponse>;
+}
+
+interface VyomaClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+declare class VyomaClient {
+    private apiKey;
+    private baseUrl;
+    constructor(options: VyomaClientOptions);
+    request<T>(path: string, options?: RequestInit): Promise<T>;
+    sandbox: SandboxResource;
+}
+
+export { type ApiError, type ID, type ISODate, type Sandbox, type SandboxCreateRequest, type SandboxCreateResponse, type SandboxStatus, type SandboxStatusResponse, type SandboxStopRequest, VyomaClient };

package/dist/index.js

@@ -0,0 +1,87 @@
+"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 index_exports = {};
+__export(index_exports, {
+  VyomaClient: () => VyomaClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/resources/sandbox.ts
+var SandboxResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  create(data) {
+    return this.client.request(
+      "/sandbox/create",
+      {
+        method: "POST",
+        body: JSON.stringify(data)
+      }
+    );
+  }
+  stop(sandboxId) {
+    return this.client.request(
+      "/sandbox/stop",
+      {
+        method: "POST",
+        body: JSON.stringify({ sandboxId })
+      }
+    );
+  }
+  status(sandboxId) {
+    return this.client.request(
+      `/sandbox/status?sandboxId=${sandboxId}`
+    );
+  }
+};
+
+// src/core/client.ts
+var VyomaClient = class {
+  constructor(options) {
+    this.sandbox = new SandboxResource(this);
+    if (!options.apiKey) {
+      throw new Error("Vyoma API key is required");
+    }
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl ?? "https://api.vyoma.dev";
+  }
+  async request(path, options = {}) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`,
+        ...options.headers || {}
+      }
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`Vyoma API error (${res.status}): ${text}`);
+    }
+    return res.json();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VyomaClient
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/resources/sandbox.ts","../src/core/client.ts"],"sourcesContent":["export { VyomaClient } from \"./core/client\";\r\nexport * from \"./types\";\r\n","import { VyomaClient } from \"../core/client\";\r\nimport {\r\n  SandboxCreateRequest,\r\n  SandboxCreateResponse,\r\n  SandboxStatusResponse,\r\n} from \"../types/sandbox\";\r\n\r\nexport class SandboxResource {\r\n  constructor(private client: VyomaClient) {}\r\n\r\n  create(data: SandboxCreateRequest) {\r\n    return this.client.request<SandboxCreateResponse>(\r\n      \"/sandbox/create\",\r\n      {\r\n        method: \"POST\",\r\n        body: JSON.stringify(data),\r\n      }\r\n    );\r\n  }\r\n\r\n  stop(sandboxId: string) {\r\n    return this.client.request(\r\n      \"/sandbox/stop\",\r\n      {\r\n        method: \"POST\",\r\n        body: JSON.stringify({ sandboxId }),\r\n      }\r\n    );\r\n  }\r\n\r\n  status(sandboxId: string) {\r\n    return this.client.request<SandboxStatusResponse>(\r\n      `/sandbox/status?sandboxId=${sandboxId}`\r\n    );\r\n  }\r\n}\r\n","import { SandboxResource } from \"../resources/sandbox\";\r\n\r\nexport interface VyomaClientOptions {\r\n  apiKey: string;\r\n  baseUrl?: string;\r\n}\r\n\r\nexport class VyomaClient {\r\n  private apiKey: string;\r\n  private baseUrl: string;\r\n\r\n  constructor(options: VyomaClientOptions) {\r\n    if (!options.apiKey) {\r\n      throw new Error(\"Vyoma API key is required\");\r\n    }\r\n\r\n    this.apiKey = options.apiKey;\r\n    this.baseUrl = options.baseUrl ?? \"https://api.vyoma.dev\";\r\n  }\r\n\r\n  async request<T>(path: string, options: RequestInit = {}): Promise<T> {\r\n    const res = await fetch(`${this.baseUrl}${path}`, {\r\n      ...options,\r\n      headers: {\r\n        \"Content-Type\": \"application/json\",\r\n        Authorization: `Bearer ${this.apiKey}`,\r\n        ...(options.headers || {}),\r\n      },\r\n    });\r\n\r\n    if (!res.ok) {\r\n      const text = await res.text();\r\n      throw new Error(`Vyoma API error (${res.status}): ${text}`);\r\n    }\r\n\r\n    return res.json() as Promise<T>;\r\n  }\r\n  sandbox = new SandboxResource(this);\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOO,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAAoB,QAAqB;AAArB;AAAA,EAAsB;AAAA,EAE1C,OAAO,MAA4B;AACjC,WAAO,KAAK,OAAO;AAAA,MACjB;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,MAAM,KAAK,UAAU,IAAI;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AAAA,EAEA,KAAK,WAAmB;AACtB,WAAO,KAAK,OAAO;AAAA,MACjB;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,MAAM,KAAK,UAAU,EAAE,UAAU,CAAC;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAO,WAAmB;AACxB,WAAO,KAAK,OAAO;AAAA,MACjB,6BAA6B,SAAS;AAAA,IACxC;AAAA,EACF;AACF;;;AC5BO,IAAM,cAAN,MAAkB;AAAA,EAIvB,YAAY,SAA6B;AA0BzC,mBAAU,IAAI,gBAAgB,IAAI;AAzBhC,QAAI,CAAC,QAAQ,QAAQ;AACnB,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AAEA,SAAK,SAAS,QAAQ;AACtB,SAAK,UAAU,QAAQ,WAAW;AAAA,EACpC;AAAA,EAEA,MAAM,QAAW,MAAc,UAAuB,CAAC,GAAe;AACpE,UAAM,MAAM,MAAM,MAAM,GAAG,KAAK,OAAO,GAAG,IAAI,IAAI;AAAA,MAChD,GAAG;AAAA,MACH,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,eAAe,UAAU,KAAK,MAAM;AAAA,QACpC,GAAI,QAAQ,WAAW,CAAC;AAAA,MAC1B;AAAA,IACF,CAAC;AAED,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,YAAM,IAAI,MAAM,oBAAoB,IAAI,MAAM,MAAM,IAAI,EAAE;AAAA,IAC5D;AAEA,WAAO,IAAI,KAAK;AAAA,EAClB;AAEF;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,60 @@
+// src/resources/sandbox.ts
+var SandboxResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  create(data) {
+    return this.client.request(
+      "/sandbox/create",
+      {
+        method: "POST",
+        body: JSON.stringify(data)
+      }
+    );
+  }
+  stop(sandboxId) {
+    return this.client.request(
+      "/sandbox/stop",
+      {
+        method: "POST",
+        body: JSON.stringify({ sandboxId })
+      }
+    );
+  }
+  status(sandboxId) {
+    return this.client.request(
+      `/sandbox/status?sandboxId=${sandboxId}`
+    );
+  }
+};
+
+// src/core/client.ts
+var VyomaClient = class {
+  constructor(options) {
+    this.sandbox = new SandboxResource(this);
+    if (!options.apiKey) {
+      throw new Error("Vyoma API key is required");
+    }
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl ?? "https://api.vyoma.dev";
+  }
+  async request(path, options = {}) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`,
+        ...options.headers || {}
+      }
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`Vyoma API error (${res.status}): ${text}`);
+    }
+    return res.json();
+  }
+};
+export {
+  VyomaClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/sandbox.ts","../src/core/client.ts"],"sourcesContent":["import { VyomaClient } from \"../core/client\";\r\nimport {\r\n  SandboxCreateRequest,\r\n  SandboxCreateResponse,\r\n  SandboxStatusResponse,\r\n} from \"../types/sandbox\";\r\n\r\nexport class SandboxResource {\r\n  constructor(private client: VyomaClient) {}\r\n\r\n  create(data: SandboxCreateRequest) {\r\n    return this.client.request<SandboxCreateResponse>(\r\n      \"/sandbox/create\",\r\n      {\r\n        method: \"POST\",\r\n        body: JSON.stringify(data),\r\n      }\r\n    );\r\n  }\r\n\r\n  stop(sandboxId: string) {\r\n    return this.client.request(\r\n      \"/sandbox/stop\",\r\n      {\r\n        method: \"POST\",\r\n        body: JSON.stringify({ sandboxId }),\r\n      }\r\n    );\r\n  }\r\n\r\n  status(sandboxId: string) {\r\n    return this.client.request<SandboxStatusResponse>(\r\n      `/sandbox/status?sandboxId=${sandboxId}`\r\n    );\r\n  }\r\n}\r\n","import { SandboxResource } from \"../resources/sandbox\";\r\n\r\nexport interface VyomaClientOptions {\r\n  apiKey: string;\r\n  baseUrl?: string;\r\n}\r\n\r\nexport class VyomaClient {\r\n  private apiKey: string;\r\n  private baseUrl: string;\r\n\r\n  constructor(options: VyomaClientOptions) {\r\n    if (!options.apiKey) {\r\n      throw new Error(\"Vyoma API key is required\");\r\n    }\r\n\r\n    this.apiKey = options.apiKey;\r\n    this.baseUrl = options.baseUrl ?? \"https://api.vyoma.dev\";\r\n  }\r\n\r\n  async request<T>(path: string, options: RequestInit = {}): Promise<T> {\r\n    const res = await fetch(`${this.baseUrl}${path}`, {\r\n      ...options,\r\n      headers: {\r\n        \"Content-Type\": \"application/json\",\r\n        Authorization: `Bearer ${this.apiKey}`,\r\n        ...(options.headers || {}),\r\n      },\r\n    });\r\n\r\n    if (!res.ok) {\r\n      const text = await res.text();\r\n      throw new Error(`Vyoma API error (${res.status}): ${text}`);\r\n    }\r\n\r\n    return res.json() as Promise<T>;\r\n  }\r\n  sandbox = new SandboxResource(this);\r\n}\r\n"],"mappings":";AAOO,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAAoB,QAAqB;AAArB;AAAA,EAAsB;AAAA,EAE1C,OAAO,MAA4B;AACjC,WAAO,KAAK,OAAO;AAAA,MACjB;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,MAAM,KAAK,UAAU,IAAI;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AAAA,EAEA,KAAK,WAAmB;AACtB,WAAO,KAAK,OAAO;AAAA,MACjB;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,MAAM,KAAK,UAAU,EAAE,UAAU,CAAC;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAO,WAAmB;AACxB,WAAO,KAAK,OAAO;AAAA,MACjB,6BAA6B,SAAS;AAAA,IACxC;AAAA,EACF;AACF;;;AC5BO,IAAM,cAAN,MAAkB;AAAA,EAIvB,YAAY,SAA6B;AA0BzC,mBAAU,IAAI,gBAAgB,IAAI;AAzBhC,QAAI,CAAC,QAAQ,QAAQ;AACnB,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AAEA,SAAK,SAAS,QAAQ;AACtB,SAAK,UAAU,QAAQ,WAAW;AAAA,EACpC;AAAA,EAEA,MAAM,QAAW,MAAc,UAAuB,CAAC,GAAe;AACpE,UAAM,MAAM,MAAM,MAAM,GAAG,KAAK,OAAO,GAAG,IAAI,IAAI;AAAA,MAChD,GAAG;AAAA,MACH,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,eAAe,UAAU,KAAK,MAAM;AAAA,QACpC,GAAI,QAAQ,WAAW,CAAC;AAAA,MAC1B;AAAA,IACF,CAAC;AAED,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,YAAM,IAAI,MAAM,oBAAoB,IAAI,MAAM,MAAM,IAAI,EAAE;AAAA,IAC5D;AAEA,WAAO,IAAI,KAAK;AAAA,EAClB;AAEF;","names":[]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "vyoma",
+  "version": "0.1.0",
+  "description": "Vyoma JavaScript SDK",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint .",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "vyoma",
+    "sdk",
+    "sandbox"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "eslint": "^9.39.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}