@sota-io/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sota.io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,320 @@
+# @sota-io/sdk
+
+TypeScript SDK for the [sota.io](https://sota.io) deployment platform.
+Deploy web apps, manage projects, and control deployments programmatically.
+
+[![npm](https://img.shields.io/npm/v/@sota-io/sdk)](https://www.npmjs.com/package/@sota-io/sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## Installation
+
+```bash
+npm install @sota-io/sdk
+```
+
+## Quick Start
+
+Deploy an app in 5 lines:
+
+```typescript
+import { SotaClient } from '@sota-io/sdk';
+import { readFileSync } from 'fs';
+
+const sota = new SotaClient({ apiKey: 'sota_your_api_key' });
+const project = await sota.createProject({ name: 'my-app' });
+const deployment = await sota.deploy(project.id, readFileSync('app.tar.gz'));
+console.log(`Live at: ${deployment.url}`);
+```
+
+## Authentication
+
+Get your API key from the [sota.io dashboard](https://sota.io/dashboard) or via the CLI:
+
+```bash
+sota auth set-key <your-api-key>
+```
+
+Create a client with your key:
+
+```typescript
+import { SotaClient } from '@sota-io/sdk';
+
+const sota = new SotaClient({ apiKey: 'sota_your_api_key' });
+```
+
+For self-hosted or staging environments, pass a custom base URL:
+
+```typescript
+const sota = new SotaClient({
+  apiKey: 'sota_your_api_key',
+  baseUrl: 'https://api.staging.sota.io',
+});
+```
+
+## API Reference
+
+### Projects
+
+### client.listProjects(options?)
+
+List all projects for the authenticated user.
+
+**Parameters:**
+- `options.cursor` (string, optional) -- Pagination cursor from a previous response
+- `options.limit` (number, optional) -- Maximum number of projects to return
+
+**Returns:** `Promise<{ projects: Project[]; pagination?: Pagination }>`
+
+**Example:**
+```typescript
+const { projects, pagination } = await sota.listProjects({ limit: 10 });
+console.log(projects.map(p => p.name));
+
+// Paginate
+if (pagination?.has_more) {
+  const next = await sota.listProjects({ cursor: pagination.next_cursor });
+}
+```
+
+### client.createProject(options)
+
+Create a new project. The slug is auto-generated from the name if not provided.
+
+**Parameters:**
+- `options.name` (string) -- Human-readable project name
+- `options.slug` (string, optional) -- URL-safe slug (auto-generated if omitted)
+
+**Returns:** `Promise<Project>`
+
+**Example:**
+```typescript
+const project = await sota.createProject({ name: 'My Cool App' });
+console.log(project.slug); // "my-cool-app"
+console.log(project.id);   // UUID
+```
+
+### client.getProject(projectId)
+
+Get a project by ID.
+
+**Parameters:**
+- `projectId` (string) -- The project UUID
+
+**Returns:** `Promise<Project>`
+
+**Example:**
+```typescript
+const project = await sota.getProject('abc-123-def');
+console.log(project.name, project.slug);
+```
+
+### client.deleteProject(projectId)
+
+Delete a project and all its deployments.
+
+**Parameters:**
+- `projectId` (string) -- The project UUID
+
+**Returns:** `Promise<void>`
+
+**Example:**
+```typescript
+await sota.deleteProject('abc-123-def');
+```
+
+### Deployments
+
+### client.deploy(projectId, archive)
+
+Deploy an app from a tar.gz archive. The archive should contain your application source code.
+
+**Parameters:**
+- `projectId` (string) -- The project UUID
+- `archive` (Buffer | Uint8Array) -- The tar.gz archive
+
+**Returns:** `Promise<Deployment>`
+
+**Example:**
+```typescript
+import { readFileSync } from 'fs';
+
+const archive = readFileSync('app.tar.gz');
+const deployment = await sota.deploy(project.id, archive);
+console.log(`Status: ${deployment.status}`);
+console.log(`URL: ${deployment.url}`);
+```
+
+### client.listDeployments(projectId)
+
+List all deployments for a project, most recent first.
+
+**Parameters:**
+- `projectId` (string) -- The project UUID
+
+**Returns:** `Promise<Deployment[]>`
+
+**Example:**
+```typescript
+const deployments = await sota.listDeployments(project.id);
+const latest = deployments[0];
+console.log(`Latest: ${latest.status} at ${latest.url}`);
+```
+
+### client.getLogs(projectId, deploymentId)
+
+Get build and runtime logs for a specific deployment.
+
+**Parameters:**
+- `projectId` (string) -- The project UUID
+- `deploymentId` (string) -- The deployment UUID
+
+**Returns:** `Promise<string>` -- Raw log text
+
+**Example:**
+```typescript
+const logs = await sota.getLogs(project.id, deployment.id);
+console.log(logs);
+```
+
+### client.rollback(projectId)
+
+Rollback to the previous deployment. Restores the prior container without rebuilding.
+
+**Parameters:**
+- `projectId` (string) -- The project UUID
+
+**Returns:** `Promise<Deployment>`
+
+**Example:**
+```typescript
+const restored = await sota.rollback(project.id);
+console.log(`Rolled back to: ${restored.url}`);
+```
+
+### client.redeploy(projectId)
+
+Redeploy the latest deployment. Rebuilds and deploys the most recent source.
+
+**Parameters:**
+- `projectId` (string) -- The project UUID
+
+**Returns:** `Promise<Deployment>`
+
+**Example:**
+```typescript
+const deployment = await sota.redeploy(project.id);
+console.log(`Redeployed: ${deployment.status}`);
+```
+
+### Environment Variables
+
+### client.listEnvVars(projectId)
+
+List all environment variables for a project.
+
+**Parameters:**
+- `projectId` (string) -- The project UUID
+
+**Returns:** `Promise<EnvVar[]>`
+
+**Example:**
+```typescript
+const envVars = await sota.listEnvVars(project.id);
+envVars.forEach(v => console.log(`${v.key}=${v.value}`));
+```
+
+### client.setEnvVar(projectId, options)
+
+Set an environment variable. Creates it if new, updates it if it already exists.
+
+**Parameters:**
+- `projectId` (string) -- The project UUID
+- `options.key` (string) -- Variable name
+- `options.value` (string) -- Variable value
+
+**Returns:** `Promise<void>`
+
+**Example:**
+```typescript
+await sota.setEnvVar(project.id, {
+  key: 'DATABASE_URL',
+  value: 'postgres://localhost:5432/mydb',
+});
+```
+
+### client.deleteEnvVar(projectId, key)
+
+Delete an environment variable from a project.
+
+**Parameters:**
+- `projectId` (string) -- The project UUID
+- `key` (string) -- The variable name to delete
+
+**Returns:** `Promise<void>`
+
+**Example:**
+```typescript
+await sota.deleteEnvVar(project.id, 'OLD_VARIABLE');
+```
+
+## Error Handling
+
+All API errors are thrown as `SotaAPIError` instances with the HTTP status code, a machine-readable error code, and a human-readable message:
+
+```typescript
+import { SotaClient, SotaAPIError } from '@sota-io/sdk';
+
+const sota = new SotaClient({ apiKey: 'sota_your_api_key' });
+
+try {
+  await sota.getProject('non-existent-id');
+} catch (err) {
+  if (err instanceof SotaAPIError) {
+    console.error(`HTTP ${err.statusCode}: [${err.code}] ${err.message}`);
+    // e.g. "HTTP 404: [not_found] Project not found"
+  }
+}
+```
+
+## TypeScript Types
+
+All types are exported for use in your application:
+
+```typescript
+import type {
+  Project,
+  Deployment,
+  EnvVar,
+  SotaClientOptions,
+  CreateProjectOptions,
+  SetEnvVarOptions,
+  ListOptions,
+  Pagination,
+  DataResponse,
+  ListResponse,
+  APIErrorBody,
+} from '@sota-io/sdk';
+```
+
+| Type | Description |
+|------|-------------|
+| `Project` | A sota.io project with id, name, slug, timestamps |
+| `Deployment` | A deployment with status, url, build info, timestamps |
+| `EnvVar` | An environment variable with key, value, timestamps |
+| `SotaClientOptions` | Constructor options: apiKey (required), baseUrl (optional) |
+| `CreateProjectOptions` | Project creation: name (required), slug (optional) |
+| `SetEnvVarOptions` | Env var: key and value |
+| `ListOptions` | Pagination: cursor and limit |
+| `Pagination` | Pagination metadata: next_cursor, has_more |
+| `DataResponse<T>` | API envelope for single items |
+| `ListResponse<T>` | API envelope for lists with pagination |
+| `APIErrorBody` | API error response body |
+
+## Requirements
+
+- **Node.js >= 18** (uses native `fetch`)
+- **sota.io API key** -- get one at [sota.io/dashboard](https://sota.io/dashboard)
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Main client class for the sota.io API.
+ *
+ * @example
+ * ```typescript
+ * import { SotaClient } from '@sota-io/sdk';
+ *
+ * const sota = new SotaClient({ apiKey: 'sota_your_api_key' });
+ * const projects = await sota.listProjects();
+ * ```
+ */
+import type { SotaClientOptions, Project, Deployment, EnvVar, CreateProjectOptions, SetEnvVarOptions, ListOptions, Pagination } from './types.js';
+export declare class SotaClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    /**
+     * Create a new SotaClient.
+     *
+     * @param options - Client configuration. `apiKey` is required.
+     */
+    constructor(options: SotaClientOptions);
+    /**
+     * Generic JSON request helper. Handles auth headers, JSON serialization,
+     * and error mapping.
+     */
+    private request;
+    /**
+     * List all projects for the authenticated user.
+     *
+     * @param options - Optional pagination parameters.
+     * @returns An object containing the projects array and optional pagination metadata.
+     */
+    listProjects(options?: ListOptions): Promise<{
+        projects: Project[];
+        pagination?: Pagination;
+    }>;
+    /**
+     * Create a new project.
+     *
+     * @param options - Project creation options. `name` is required; `slug` is auto-generated if omitted.
+     * @returns The created project.
+     */
+    createProject(options: CreateProjectOptions): Promise<Project>;
+    /**
+     * Get a project by ID.
+     *
+     * @param projectId - The project UUID.
+     * @returns The project details.
+     */
+    getProject(projectId: string): Promise<Project>;
+    /**
+     * Delete a project.
+     *
+     * @param projectId - The project UUID.
+     */
+    deleteProject(projectId: string): Promise<void>;
+    /**
+     * Deploy a project from a tar.gz archive.
+     *
+     * @param projectId - The project UUID.
+     * @param archive - The tar.gz archive as a `Buffer` or `Uint8Array`.
+     * @returns The created deployment.
+     */
+    deploy(projectId: string, archive: Buffer | Uint8Array): Promise<Deployment>;
+    /**
+     * List all deployments for a project.
+     *
+     * @param projectId - The project UUID.
+     * @returns An array of deployments, most recent first.
+     */
+    listDeployments(projectId: string): Promise<Deployment[]>;
+    /**
+     * Get build/runtime logs for a specific deployment.
+     *
+     * @param projectId - The project UUID.
+     * @param deploymentId - The deployment UUID.
+     * @returns The raw log text.
+     */
+    getLogs(projectId: string, deploymentId: string): Promise<string>;
+    /**
+     * Rollback to the previous deployment.
+     *
+     * @param projectId - The project UUID.
+     * @returns The restored deployment.
+     */
+    rollback(projectId: string): Promise<Deployment>;
+    /**
+     * Redeploy the latest deployment.
+     *
+     * @param projectId - The project UUID.
+     * @returns The new deployment.
+     */
+    redeploy(projectId: string): Promise<Deployment>;
+    /**
+     * List all environment variables for a project.
+     *
+     * @param projectId - The project UUID.
+     * @returns An array of environment variables.
+     */
+    listEnvVars(projectId: string): Promise<EnvVar[]>;
+    /**
+     * Set an environment variable on a project.
+     *
+     * Creates the variable if it doesn't exist, or updates it if it does.
+     *
+     * @param projectId - The project UUID.
+     * @param options - The key/value pair to set.
+     */
+    setEnvVar(projectId: string, options: SetEnvVarOptions): Promise<void>;
+    /**
+     * Delete an environment variable from a project.
+     *
+     * @param projectId - The project UUID.
+     * @param key - The variable name to delete.
+     */
+    deleteEnvVar(projectId: string, key: string): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,OAAO,EACP,UAAU,EACV,MAAM,EAIN,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,UAAU,EACX,MAAM,YAAY,CAAC;AAKpB,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;;;OAIG;gBACS,OAAO,EAAE,iBAAiB;IAStC;;;OAGG;YACW,OAAO;IA6CrB;;;;;OAKG;IACG,YAAY,CAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,UAAU,CAAA;KAAE,CAAC;IAW5D;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IASpE;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrD;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BrD;;;;;;OAMG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,UAAU,GAC3B,OAAO,CAAC,UAAU,CAAC;IAsDtB;;;;;OAKG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQ/D;;;;;;OAMG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BvE;;;;;OAKG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQtD;;;;;OAKG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAYtD;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQvD;;;;;;;OAOG;IACG,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAQhB;;;;;OAKG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsBlE"}

package/dist/client.js

@@ -0,0 +1,271 @@
+/**
+ * Main client class for the sota.io API.
+ *
+ * @example
+ * ```typescript
+ * import { SotaClient } from '@sota-io/sdk';
+ *
+ * const sota = new SotaClient({ apiKey: 'sota_your_api_key' });
+ * const projects = await sota.listProjects();
+ * ```
+ */
+import { SotaAPIError } from './errors.js';
+const DEFAULT_BASE_URL = 'https://api.sota.io';
+export class SotaClient {
+    apiKey;
+    baseUrl;
+    /**
+     * Create a new SotaClient.
+     *
+     * @param options - Client configuration. `apiKey` is required.
+     */
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Generic JSON request helper. Handles auth headers, JSON serialization,
+     * and error mapping.
+     */
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+        };
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            let errorBody;
+            try {
+                errorBody = (await response.json());
+            }
+            catch {
+                // response body may not be JSON
+            }
+            throw new SotaAPIError(response.status, errorBody?.error?.code ?? 'unknown', errorBody?.error?.message ?? response.statusText);
+        }
+        // Handle 204 No Content (DELETE responses)
+        if (response.status === 204) {
+            return undefined;
+        }
+        return response.json();
+    }
+    // -------------------------------------------------------------------------
+    // Projects
+    // -------------------------------------------------------------------------
+    /**
+     * List all projects for the authenticated user.
+     *
+     * @param options - Optional pagination parameters.
+     * @returns An object containing the projects array and optional pagination metadata.
+     */
+    async listProjects(options) {
+        const params = new URLSearchParams();
+        if (options?.cursor)
+            params.set('cursor', options.cursor);
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        const qs = params.toString();
+        const path = `/v1/projects${qs ? `?${qs}` : ''}`;
+        const resp = await this.request('GET', path);
+        return { projects: resp.data, pagination: resp.pagination };
+    }
+    /**
+     * Create a new project.
+     *
+     * @param options - Project creation options. `name` is required; `slug` is auto-generated if omitted.
+     * @returns The created project.
+     */
+    async createProject(options) {
+        const resp = await this.request('POST', '/v1/projects', options);
+        return resp.data;
+    }
+    /**
+     * Get a project by ID.
+     *
+     * @param projectId - The project UUID.
+     * @returns The project details.
+     */
+    async getProject(projectId) {
+        const resp = await this.request('GET', `/v1/projects/${projectId}`);
+        return resp.data;
+    }
+    /**
+     * Delete a project.
+     *
+     * @param projectId - The project UUID.
+     */
+    async deleteProject(projectId) {
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+        };
+        const response = await fetch(`${this.baseUrl}/v1/projects/${projectId}`, { method: 'DELETE', headers });
+        if (!response.ok) {
+            let errorBody;
+            try {
+                errorBody = (await response.json());
+            }
+            catch {
+                // body may not be JSON
+            }
+            throw new SotaAPIError(response.status, errorBody?.error?.code ?? 'unknown', errorBody?.error?.message ?? response.statusText);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Deployments
+    // -------------------------------------------------------------------------
+    /**
+     * Deploy a project from a tar.gz archive.
+     *
+     * @param projectId - The project UUID.
+     * @param archive - The tar.gz archive as a `Buffer` or `Uint8Array`.
+     * @returns The created deployment.
+     */
+    async deploy(projectId, archive) {
+        const boundary = '----SotaSDKBoundary' + Date.now();
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'Content-Type': `multipart/form-data; boundary=${boundary}`,
+        };
+        // Build multipart body manually (no external dependency needed)
+        const preamble = [
+            `--${boundary}\r\n`,
+            `Content-Disposition: form-data; name="archive"; filename="archive.tar.gz"\r\n`,
+            `Content-Type: application/gzip\r\n`,
+            `\r\n`,
+        ].join('');
+        const epilogue = `\r\n--${boundary}--\r\n`;
+        const encoder = new TextEncoder();
+        const prefixBytes = encoder.encode(preamble);
+        const suffixBytes = encoder.encode(epilogue);
+        const archiveBytes = archive instanceof Uint8Array ? archive : new Uint8Array(archive);
+        // Concatenate into a single Uint8Array
+        const body = new Uint8Array(prefixBytes.length + archiveBytes.length + suffixBytes.length);
+        body.set(prefixBytes, 0);
+        body.set(archiveBytes, prefixBytes.length);
+        body.set(suffixBytes, prefixBytes.length + archiveBytes.length);
+        const response = await fetch(`${this.baseUrl}/v1/projects/${projectId}/deploy`, { method: 'POST', headers, body });
+        if (!response.ok) {
+            let errorBody;
+            try {
+                errorBody = (await response.json());
+            }
+            catch {
+                // body may not be JSON
+            }
+            throw new SotaAPIError(response.status, errorBody?.error?.code ?? 'unknown', errorBody?.error?.message ?? response.statusText);
+        }
+        const resp = (await response.json());
+        return resp.data;
+    }
+    /**
+     * List all deployments for a project.
+     *
+     * @param projectId - The project UUID.
+     * @returns An array of deployments, most recent first.
+     */
+    async listDeployments(projectId) {
+        const resp = await this.request('GET', `/v1/projects/${projectId}/deployments`);
+        return resp.data;
+    }
+    /**
+     * Get build/runtime logs for a specific deployment.
+     *
+     * @param projectId - The project UUID.
+     * @param deploymentId - The deployment UUID.
+     * @returns The raw log text.
+     */
+    async getLogs(projectId, deploymentId) {
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+        };
+        const response = await fetch(`${this.baseUrl}/v1/projects/${projectId}/deployments/${deploymentId}/logs`, { headers });
+        if (!response.ok) {
+            let errorBody;
+            try {
+                errorBody = (await response.json());
+            }
+            catch {
+                // body may not be JSON
+            }
+            throw new SotaAPIError(response.status, errorBody?.error?.code ?? 'unknown', errorBody?.error?.message ?? response.statusText);
+        }
+        return response.text();
+    }
+    /**
+     * Rollback to the previous deployment.
+     *
+     * @param projectId - The project UUID.
+     * @returns The restored deployment.
+     */
+    async rollback(projectId) {
+        const resp = await this.request('POST', `/v1/projects/${projectId}/rollback`);
+        return resp.data;
+    }
+    /**
+     * Redeploy the latest deployment.
+     *
+     * @param projectId - The project UUID.
+     * @returns The new deployment.
+     */
+    async redeploy(projectId) {
+        const resp = await this.request('POST', `/v1/projects/${projectId}/redeploy`);
+        return resp.data;
+    }
+    // -------------------------------------------------------------------------
+    // Environment Variables
+    // -------------------------------------------------------------------------
+    /**
+     * List all environment variables for a project.
+     *
+     * @param projectId - The project UUID.
+     * @returns An array of environment variables.
+     */
+    async listEnvVars(projectId) {
+        const resp = await this.request('GET', `/v1/projects/${projectId}/envs`);
+        return resp.data;
+    }
+    /**
+     * Set an environment variable on a project.
+     *
+     * Creates the variable if it doesn't exist, or updates it if it does.
+     *
+     * @param projectId - The project UUID.
+     * @param options - The key/value pair to set.
+     */
+    async setEnvVar(projectId, options) {
+        await this.request('POST', `/v1/projects/${projectId}/envs`, options);
+    }
+    /**
+     * Delete an environment variable from a project.
+     *
+     * @param projectId - The project UUID.
+     * @param key - The variable name to delete.
+     */
+    async deleteEnvVar(projectId, key) {
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+        };
+        const response = await fetch(`${this.baseUrl}/v1/projects/${projectId}/envs/${key}`, { method: 'DELETE', headers });
+        if (!response.ok) {
+            let errorBody;
+            try {
+                errorBody = (await response.json());
+            }
+            catch {
+                // body may not be JSON
+            }
+            throw new SotaAPIError(response.status, errorBody?.error?.code ?? 'unknown', errorBody?.error?.message ?? response.statusText);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAE/C,MAAM,OAAO,UAAU;IACJ,MAAM,CAAS;IACf,OAAO,CAAS;IAEjC;;;;OAIG;IACH,YAAY,OAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E;;;OAGG;IACK,KAAK,CAAC,OAAO,CACnB,MAAc,EACd,IAAY,EACZ,IAAc;QAEd,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACrC,MAAM,OAAO,GAA2B;YACtC,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;SACzC,CAAC;QACF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC/C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM;YACN,OAAO;YACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,SAAmC,CAAC;YACxC,IAAI,CAAC;gBACH,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiB,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,QAAQ,CAAC,MAAM,EACf,SAAS,EAAE,KAAK,EAAE,IAAI,IAAI,SAAS,EACnC,SAAS,EAAE,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC,UAAU,CACjD,CAAC;QACJ,CAAC;QAED,2CAA2C;QAC3C,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,SAAc,CAAC;QACxB,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAC;IACvC,CAAC;IAED,4EAA4E;IAC5E,WAAW;IACX,4EAA4E;IAE5E;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAChB,OAAqB;QAErB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAEjD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAwB,KAAK,EAAE,IAAI,CAAC,CAAC;QACpE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,OAA6B;QAC/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,MAAM,EACN,cAAc,EACd,OAAO,CACR,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,KAAK,EACL,gBAAgB,SAAS,EAAE,CAC5B,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,MAAM,OAAO,GAA2B;YACtC,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;SACzC,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,OAAO,gBAAgB,SAAS,EAAE,EAC1C,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAC9B,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,SAAmC,CAAC;YACxC,IAAI,CAAC;gBACH,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiB,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,QAAQ,CAAC,MAAM,EACf,SAAS,EAAE,KAAK,EAAE,IAAI,IAAI,SAAS,EACnC,SAAS,EAAE,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC,UAAU,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,cAAc;IACd,4EAA4E;IAE5E;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,OAA4B;QAE5B,MAAM,QAAQ,GAAG,qBAAqB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACpD,MAAM,OAAO,GAA2B;YACtC,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;YACxC,cAAc,EAAE,iCAAiC,QAAQ,EAAE;SAC5D,CAAC;QAEF,gEAAgE;QAChE,MAAM,QAAQ,GAAG;YACf,KAAK,QAAQ,MAAM;YACnB,+EAA+E;YAC/E,oCAAoC;YACpC,MAAM;SACP,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEX,MAAM,QAAQ,GAAG,SAAS,QAAQ,QAAQ,CAAC;QAE3C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,YAAY,GAChB,OAAO,YAAY,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;QAEpE,uCAAuC;QACvC,MAAM,IAAI,GAAG,IAAI,UAAU,CACzB,WAAW,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAC9D,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAEhE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,OAAO,gBAAgB,SAAS,SAAS,EACjD,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAClC,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,SAAmC,CAAC;YACxC,IAAI,CAAC;gBACH,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiB,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,QAAQ,CAAC,MAAM,EACf,SAAS,EAAE,KAAK,EAAE,IAAI,IAAI,SAAS,EACnC,SAAS,EAAE,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC,UAAU,CACjD,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA6B,CAAC;QACjE,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,SAAiB;QACrC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,KAAK,EACL,gBAAgB,SAAS,cAAc,CACxC,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,YAAoB;QACnD,MAAM,OAAO,GAA2B;YACtC,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;SACzC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,OAAO,gBAAgB,SAAS,gBAAgB,YAAY,OAAO,EAC3E,EAAE,OAAO,EAAE,CACZ,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,SAAmC,CAAC;YACxC,IAAI,CAAC;gBACH,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiB,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,QAAQ,CAAC,MAAM,EACf,SAAS,EAAE,KAAK,EAAE,IAAI,IAAI,SAAS,EACnC,SAAS,EAAE,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC,UAAU,CACjD,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,SAAiB;QAC9B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,MAAM,EACN,gBAAgB,SAAS,WAAW,CACrC,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,SAAiB;QAC9B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,MAAM,EACN,gBAAgB,SAAS,WAAW,CACrC,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,4EAA4E;IAC5E,wBAAwB;IACxB,4EAA4E;IAE5E;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB;QACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,KAAK,EACL,gBAAgB,SAAS,OAAO,CACjC,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,CACb,SAAiB,EACjB,OAAyB;QAEzB,MAAM,IAAI,CAAC,OAAO,CAChB,MAAM,EACN,gBAAgB,SAAS,OAAO,EAChC,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,GAAW;QAC/C,MAAM,OAAO,GAA2B;YACtC,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;SACzC,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,OAAO,gBAAgB,SAAS,SAAS,GAAG,EAAE,EACtD,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAC9B,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,SAAmC,CAAC;YACxC,IAAI,CAAC;gBACH,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiB,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,QAAQ,CAAC,MAAM,EACf,SAAS,EAAE,KAAK,EAAE,IAAI,IAAI,SAAS,EACnC,SAAS,EAAE,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC,UAAU,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Error classes for the sota.io SDK.
+ */
+/** Base error class for all SDK errors. */
+export declare class SotaError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when the API returns a non-2xx response.
+ *
+ * Includes the HTTP status code and the machine-readable error code from the
+ * API response body.
+ */
+export declare class SotaAPIError extends SotaError {
+    /** HTTP status code (e.g. 400, 404, 500). */
+    readonly statusCode: number;
+    /** Machine-readable error code from the API (e.g. `"not_found"`). */
+    readonly code: string;
+    constructor(statusCode: number, code: string, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2CAA2C;AAC3C,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,6CAA6C;IAC7C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,qEAAqE;IACrE,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM9D"}

package/dist/errors.js

@@ -0,0 +1,29 @@
+/**
+ * Error classes for the sota.io SDK.
+ */
+/** Base error class for all SDK errors. */
+export class SotaError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SotaError';
+    }
+}
+/**
+ * Thrown when the API returns a non-2xx response.
+ *
+ * Includes the HTTP status code and the machine-readable error code from the
+ * API response body.
+ */
+export class SotaAPIError extends SotaError {
+    /** HTTP status code (e.g. 400, 404, 500). */
+    statusCode;
+    /** Machine-readable error code from the API (e.g. `"not_found"`). */
+    code;
+    constructor(statusCode, code, message) {
+        super(message);
+        this.name = 'SotaAPIError';
+        this.statusCode = statusCode;
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2CAA2C;AAC3C,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzC,6CAA6C;IAC7B,UAAU,CAAS;IACnC,qEAAqE;IACrD,IAAI,CAAS;IAE7B,YAAY,UAAkB,EAAE,IAAY,EAAE,OAAe;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @sota-io/sdk — TypeScript SDK for the sota.io deployment platform.
+ *
+ * @packageDocumentation
+ */
+export { SotaClient } from './client.js';
+export { SotaError, SotaAPIError } from './errors.js';
+export type { SotaClientOptions, Project, Deployment, EnvVar, DataResponse, ListResponse, Pagination, APIErrorBody, CreateProjectOptions, SetEnvVarOptions, ListOptions, } from './types.js';
+//# 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":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EACV,iBAAiB,EACjB,OAAO,EACP,UAAU,EACV,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * @sota-io/sdk — TypeScript SDK for the sota.io deployment platform.
+ *
+ * @packageDocumentation
+ */
+export { SotaClient } from './client.js';
+export { SotaError, SotaAPIError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * TypeScript type definitions for the sota.io API.
+ */
+/** Options for constructing a {@link SotaClient}. */
+export interface SotaClientOptions {
+    /** sota.io API key (starts with `sota_`). */
+    apiKey: string;
+    /** API base URL. Defaults to `https://api.sota.io`. */
+    baseUrl?: string;
+}
+/** A sota.io project. */
+export interface Project {
+    id: string;
+    user_id: string;
+    name: string;
+    slug: string;
+    created_at: string;
+    updated_at: string;
+}
+/** A single deployment of a project. */
+export interface Deployment {
+    id: string;
+    project_id: string;
+    status: string;
+    url?: string;
+    image_tag?: string;
+    build_method?: string;
+    framework?: string;
+    error?: string;
+    created_at: string;
+    updated_at: string;
+}
+/** An environment variable attached to a project. */
+export interface EnvVar {
+    id: string;
+    project_id: string;
+    key: string;
+    value?: string;
+    created_at: string;
+    updated_at: string;
+}
+/** Envelope for single-item API responses. */
+export interface DataResponse<T> {
+    data: T;
+}
+/** Pagination metadata returned with list responses. */
+export interface Pagination {
+    next_cursor?: string;
+    has_more: boolean;
+}
+/** Envelope for list API responses. */
+export interface ListResponse<T> {
+    data: T[];
+    pagination?: Pagination;
+}
+/** Body returned by the API when an error occurs. */
+export interface APIErrorBody {
+    error: {
+        code: string;
+        message: string;
+    };
+}
+/** Options for creating a new project. */
+export interface CreateProjectOptions {
+    /** Human-readable project name. */
+    name: string;
+    /** URL-safe slug (auto-generated from name if omitted). */
+    slug?: string;
+}
+/** Options for setting an environment variable. */
+export interface SetEnvVarOptions {
+    /** Variable name. */
+    key: string;
+    /** Variable value. */
+    value: string;
+}
+/** Options for list endpoints that support cursor-based pagination. */
+export interface ListOptions {
+    /** Cursor returned by a previous list call. */
+    cursor?: string;
+    /** Maximum number of items to return. */
+    limit?: number;
+}
+//# 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":"AAAA;;GAEG;AAMH,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,yBAAyB;AACzB,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,8CAA8C;AAC9C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC;CACT;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAMD,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * TypeScript type definitions for the sota.io API.
+ */
+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;;GAEG"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@sota-io/sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for the sota.io deployment platform API",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sota-deploy/sdk"
+  },
+  "homepage": "https://sota.io/docs/api",
+  "keywords": [
+    "sota",
+    "sdk",
+    "deploy",
+    "paas",
+    "typescript",
+    "api-client"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}