@miosa/sdk 1.2.0 → 1.2.2

package/src/resources/quotas.ts

@@ -1,77 +0,0 @@
-/**
- * Quotas — per-external_user_id resource limits.
- * Corresponds to: GET/PUT/DELETE /api/v1/quotas/external/{external_user_id}
- */
-
-import type { HttpClient } from "../http.js";
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface QuotaData {
-  external_user_id: string;
-  max_sandboxes?: number | null;
-  max_concurrent?: number | null;
-  max_storage_gb?: number | null;
-  max_credit_cents?: number | null;
-  usage?: {
-    sandbox_count?: number;
-    concurrent_count?: number;
-    storage_gb?: number;
-    credit_cents?: number;
-    [key: string]: unknown;
-  };
-  [key: string]: unknown;
-}
-
-export interface QuotaSetParams {
-  max_sandboxes?: number;
-  max_concurrent?: number;
-  max_storage_gb?: number;
-  max_credit_cents?: number;
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function unwrap<T>(payload: unknown): T {
-  if (payload && typeof payload === "object" && "data" in (payload as object)) {
-    return (payload as { data: T }).data;
-  }
-  return payload as T;
-}
-
-function stripUndefined(
-  input: Record<string, unknown>,
-): Record<string, unknown> {
-  return Object.fromEntries(
-    Object.entries(input).filter(([, v]) => v !== undefined),
-  );
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class Quotas {
-  constructor(private readonly http: HttpClient) {}
-
-  /** GET /api/v1/quotas/external/{external_user_id} — current limits + usage. */
-  async get(externalUserId: string): Promise<QuotaData> {
-    return unwrap(
-      await this.http.get<unknown>(`/quotas/external/${externalUserId}`),
-    );
-  }
-
-  /** PUT /api/v1/quotas/external/{external_user_id} — set per-user limits. */
-  async set(
-    externalUserId: string,
-    params: QuotaSetParams,
-  ): Promise<QuotaData> {
-    const body = stripUndefined(params as Record<string, unknown>);
-    return unwrap(
-      await this.http.put<unknown>(`/quotas/external/${externalUserId}`, body),
-    );
-  }
-
-  /** DELETE /api/v1/quotas/external/{external_user_id} — revert to tenant default. */
-  async delete(externalUserId: string): Promise<void> {
-    await this.http.delete<unknown>(`/quotas/external/${externalUserId}`);
-  }
-}

package/src/resources/sandbox-processes.ts

@@ -1,112 +0,0 @@
-/**
- * SandboxProcesses — long-running process management inside a sandbox.
- * Corresponds to: POST/GET/DELETE /api/v1/sandboxes/{id}/processes
- */
-
-import type { HttpClient } from "../http.js";
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface SandboxProcessData {
-  pid: number;
-  name?: string;
-  command: string;
-  status: "running" | "stopped" | "failed" | string;
-  started_at?: string;
-  exit_code?: number | null;
-  [key: string]: unknown;
-}
-
-export interface SandboxProcessStartParams {
-  command: string;
-  env?: Record<string, string>;
-  name?: string;
-}
-
-export interface SandboxProcessStreamEvent {
-  stream: "stdout" | "stderr";
-  line: string;
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function unwrap<T>(payload: unknown): T {
-  if (payload && typeof payload === "object" && "data" in (payload as object)) {
-    return (payload as { data: T }).data;
-  }
-  return payload as T;
-}
-
-function listItems<T>(payload: unknown): T[] {
-  if (Array.isArray(payload)) return payload;
-  if (!payload || typeof payload !== "object") return [];
-  const p = payload as Record<string, unknown>;
-  for (const k of ["data", "processes", "items"]) {
-    if (Array.isArray(p[k])) return p[k] as T[];
-  }
-  return [];
-}
-
-function stripUndefined(
-  input: Record<string, unknown>,
-): Record<string, unknown> {
-  return Object.fromEntries(
-    Object.entries(input).filter(([, v]) => v !== undefined),
-  );
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class SandboxProcesses {
-  constructor(
-    private readonly http: HttpClient,
-    private readonly sandboxId: string,
-  ) {}
-
-  private base(): string {
-    return `/sandboxes/${this.sandboxId}/processes`;
-  }
-
-  /** POST /api/v1/sandboxes/{id}/processes — start a long-running process. */
-  async start(params: SandboxProcessStartParams): Promise<SandboxProcessData> {
-    const body = stripUndefined({
-      command: params.command,
-      env: params.env,
-      name: params.name,
-    });
-    return unwrap(await this.http.post<unknown>(this.base(), body));
-  }
-
-  /** GET /api/v1/sandboxes/{id}/processes — list all processes. */
-  async list(): Promise<SandboxProcessData[]> {
-    const data = await this.http.get<unknown>(this.base());
-    return listItems<SandboxProcessData>(data);
-  }
-
-  /** GET /api/v1/sandboxes/{id}/processes/{pid} — get a single process. */
-  async get(pid: number): Promise<SandboxProcessData> {
-    return unwrap(await this.http.get<unknown>(`${this.base()}/${pid}`));
-  }
-
-  /** DELETE /api/v1/sandboxes/{id}/processes/{pid} — SIGTERM then SIGKILL after 5s. */
-  async stop(pid: number): Promise<void> {
-    await this.http.delete<unknown>(`${this.base()}/${pid}`);
-  }
-
-  /** GET /api/v1/sandboxes/{id}/processes/{pid}/logs?tail=N — tail log text. */
-  async logs(pid: number, tail = 200): Promise<string> {
-    const data = await this.http.get<unknown>(`${this.base()}/${pid}/logs`, {
-      tail,
-    });
-    if (typeof data === "string") return data;
-    const d = data as Record<string, unknown>;
-    return String(d.logs ?? d.output ?? d.data ?? "");
-  }
-
-  /** GET /api/v1/sandboxes/{id}/processes/{pid}/stream (SSE) — live output. */
-  stream(pid: number): AsyncIterableIterator<SandboxProcessStreamEvent> {
-    return this.http.stream<SandboxProcessStreamEvent>(
-      `${this.base()}/${pid}/stream`,
-    );
-  }
-}

package/src/resources/sandbox-shares.ts

@@ -1,83 +0,0 @@
-/**
- * SandboxShares — public read-only share URLs for a sandbox.
- * Corresponds to: POST/GET/DELETE /api/v1/sandboxes/{id}/shares
- */
-
-import type { HttpClient } from "../http.js";
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface SandboxShareData {
-  share_id: string;
-  share_url: string;
-  expires_at?: string | null;
-  scope: string;
-  [key: string]: unknown;
-}
-
-export interface SandboxShareCreateParams {
-  expires_in?: number;
-  scope?: "read";
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function unwrap<T>(payload: unknown): T {
-  if (payload && typeof payload === "object" && "data" in (payload as object)) {
-    return (payload as { data: T }).data;
-  }
-  return payload as T;
-}
-
-function listItems<T>(payload: unknown): T[] {
-  if (Array.isArray(payload)) return payload;
-  if (!payload || typeof payload !== "object") return [];
-  const p = payload as Record<string, unknown>;
-  for (const k of ["data", "shares", "items"]) {
-    if (Array.isArray(p[k])) return p[k] as T[];
-  }
-  return [];
-}
-
-function stripUndefined(
-  input: Record<string, unknown>,
-): Record<string, unknown> {
-  return Object.fromEntries(
-    Object.entries(input).filter(([, v]) => v !== undefined),
-  );
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class SandboxShares {
-  constructor(
-    private readonly http: HttpClient,
-    private readonly sandboxId: string,
-  ) {}
-
-  private base(): string {
-    return `/sandboxes/${this.sandboxId}/shares`;
-  }
-
-  /** POST /api/v1/sandboxes/{id}/shares — create a public share URL. */
-  async create(
-    params: SandboxShareCreateParams = {},
-  ): Promise<SandboxShareData> {
-    const body = stripUndefined({
-      expires_in: params.expires_in,
-      scope: params.scope ?? "read",
-    });
-    return unwrap(await this.http.post<unknown>(this.base(), body));
-  }
-
-  /** GET /api/v1/sandboxes/{id}/shares — list all active shares. */
-  async list(): Promise<SandboxShareData[]> {
-    const data = await this.http.get<unknown>(this.base());
-    return listItems<SandboxShareData>(data);
-  }
-
-  /** DELETE /api/v1/sandboxes/{id}/shares/{share_id} — revoke a share. */
-  async revoke(shareId: string): Promise<void> {
-    await this.http.delete<unknown>(`${this.base()}/${shareId}`);
-  }
-}

package/src/resources/tenant-events.ts

@@ -1,32 +0,0 @@
-/**
- * TenantEvents — tenant-scoped SSE event stream.
- * Corresponds to: GET /api/v1/events/stream?types=sandbox.*,webhook.delivered
- */
-
-import type { HttpClient } from "../http.js";
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface TenantStreamEvent {
-  type: string;
-  [key: string]: unknown;
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class TenantEvents {
-  constructor(private readonly http: HttpClient) {}
-
-  /**
-   * GET /api/v1/events/stream — tenant-scoped SSE event stream.
-   *
-   * @param types - Event type globs to filter. Accepts a comma-separated string
-   *   or an array, e.g. `["sandbox.*", "webhook.delivered"]`.
-   *   Omit to receive all event types.
-   */
-  stream(types?: string | string[]): AsyncIterableIterator<TenantStreamEvent> {
-    const typesParam = Array.isArray(types) ? types.join(",") : types;
-    const query = typesParam ? `?types=${encodeURIComponent(typesParam)}` : "";
-    return this.http.stream<TenantStreamEvent>(`/events/stream${query}`);
-  }
-}

package/src/resources/workspaces.ts

@@ -1,285 +0,0 @@
-/**
- * Workspaces resource — top-level tenant workspaces grouping computers.
- *
- * A workspace is a logical bucket of computers (handy for teams / projects).
- * Accessed via `miosa.workspaces` on the top-level client.
- *
- * @example
- * ```ts
- * const ws = await miosa.workspaces.create({ name: "prod" });
- * const computers = await miosa.workspaces.listComputers(ws.id);
- * ```
- */
-
-import type { HttpClient } from "../http.js";
-import type { ComputerData } from "../types.js";
-import { Computer } from "./computer.js";
-
-// ── Branded IDs ──────────────────────────────────────────────────────────────
-
-export type WorkspaceId = string & { readonly __brand: "WorkspaceId" };
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface WorkspaceData {
-  id: WorkspaceId;
-  tenant_id: string;
-  name: string;
-  slug?: string | null;
-  description?: string | null;
-  metadata?: Record<string, unknown> | null;
-  settings?: Record<string, unknown> | null;
-  created_at?: string;
-  updated_at?: string;
-  [key: string]: unknown;
-}
-
-// ── Request payloads ─────────────────────────────────────────────────────────
-
-export interface WorkspaceCreateParams {
-  name: string;
-  slug?: string;
-  description?: string;
-  metadata?: Record<string, unknown>;
-}
-
-export interface WorkspaceUpdateParams {
-  name?: string;
-  description?: string;
-  metadata?: Record<string, unknown>;
-}
-
-export interface WorkspaceComputerTemplateCreateParams {
-  name: string;
-  templateType?: string;
-  template_type?: string;
-  description?: string;
-  [key: string]: unknown;
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function unwrap<T>(payload: unknown): T {
-  if (payload && typeof payload === "object" && "data" in (payload as object)) {
-    return (payload as { data: T }).data;
-  }
-  return payload as T;
-}
-
-function listItems<T>(
-  payload: unknown,
-  candidateKeys: string[] = ["data", "items"],
-): T[] {
-  if (Array.isArray(payload)) return payload;
-  if (!payload || typeof payload !== "object") return [];
-  const p = payload as Record<string, unknown>;
-  if (Array.isArray(p.data)) return p.data as T[];
-  for (const key of candidateKeys) {
-    if (Array.isArray(p[key])) return p[key] as T[];
-  }
-  return [];
-}
-
-// ── Workspaces resource ───────────────────────────────────────────────────────
-
-export class Workspaces {
-  private readonly http: HttpClient;
-
-  constructor(http: HttpClient) {
-    this.http = http;
-  }
-
-  /**
-   * Create a new workspace.
-   */
-  async create(params: WorkspaceCreateParams): Promise<WorkspaceData> {
-    const payload = await this.http.post<unknown>("/workspaces", params);
-    return unwrap<WorkspaceData>(payload);
-  }
-
-  /**
-   * List all workspaces visible to the current credential.
-   */
-  async list(): Promise<WorkspaceData[]> {
-    const payload = await this.http.get<unknown>("/workspaces");
-    if (
-      payload &&
-      typeof payload === "object" &&
-      "workspaces" in (payload as object)
-    ) {
-      const p = payload as Record<string, unknown>;
-      return (p["workspaces"] as WorkspaceData[]) ?? [];
-    }
-    return listItems<WorkspaceData>(payload, ["data", "workspaces", "items"]);
-  }
-
-  /**
-   * Get a single workspace by ID.
-   */
-  async get(id: WorkspaceId | string): Promise<WorkspaceData> {
-    const payload = await this.http.get<unknown>(`/workspaces/${id}`);
-    return unwrap<WorkspaceData>(payload);
-  }
-
-  /**
-   * Update a workspace's metadata.
-   */
-  async update(
-    id: WorkspaceId | string,
-    params: WorkspaceUpdateParams,
-  ): Promise<WorkspaceData> {
-    const payload = await this.http.patch<unknown>(`/workspaces/${id}`, params);
-    return unwrap<WorkspaceData>(payload);
-  }
-
-  /**
-   * Delete a workspace. Does not delete member computers.
-   */
-  async delete(id: WorkspaceId | string): Promise<void> {
-    await this.http.delete<void>(`/workspaces/${id}`);
-  }
-
-  /**
-   * Update workspace-level settings.
-   */
-  async updateSettings(
-    id: WorkspaceId | string,
-    settings: Record<string, unknown>,
-  ): Promise<WorkspaceData> {
-    const payload = await this.http.put<unknown>(
-      `/workspaces/${id}/settings`,
-      settings,
-    );
-    return unwrap<WorkspaceData>(payload);
-  }
-
-  /**
-   * List all computers that belong to the given workspace.
-   */
-  async listComputers(id: WorkspaceId | string): Promise<Computer[]> {
-    const payload = await this.http.get<unknown>(`/workspaces/${id}/computers`);
-    const items = listItems<ComputerData>(payload, [
-      "data",
-      "computers",
-      "items",
-    ]);
-    return items.map((d) => new Computer(this.http, d));
-  }
-
-  /**
-   * List all sandboxes that belong to this workspace.
-   */
-  async listSandboxes(
-    id: WorkspaceId | string,
-  ): Promise<Record<string, unknown>[]> {
-    const payload = await this.http.get<unknown>(`/workspaces/${id}/sandboxes`);
-    return listItems<Record<string, unknown>>(payload, [
-      "data",
-      "sandboxes",
-      "items",
-    ]);
-  }
-
-  /**
-   * List all deployments that belong to this workspace.
-   */
-  async listDeployments(
-    id: WorkspaceId | string,
-  ): Promise<Record<string, unknown>[]> {
-    const payload = await this.http.get<unknown>(
-      `/workspaces/${id}/deployments`,
-    );
-    return listItems<Record<string, unknown>>(payload, [
-      "data",
-      "deployments",
-      "items",
-    ]);
-  }
-
-  /**
-   * List all managed databases that belong to this workspace.
-   */
-  async listDatabases(
-    id: WorkspaceId | string,
-  ): Promise<Record<string, unknown>[]> {
-    const payload = await this.http.get<unknown>(`/workspaces/${id}/databases`);
-    return listItems<Record<string, unknown>>(payload, [
-      "data",
-      "databases",
-      "items",
-    ]);
-  }
-
-  /**
-   * List all projects that belong to this workspace.
-   */
-  async listProjects(
-    id: WorkspaceId | string,
-  ): Promise<Record<string, unknown>[]> {
-    const payload = await this.http.get<unknown>(`/workspaces/${id}/projects`);
-    return listItems<Record<string, unknown>>(payload, [
-      "data",
-      "projects",
-      "items",
-    ]);
-  }
-
-  /**
-   * Return aggregate resource stats for this workspace.
-   */
-  async stats(id: WorkspaceId | string): Promise<Record<string, unknown>> {
-    const payload = await this.http.get<unknown>(`/workspaces/${id}/stats`);
-    return unwrap<Record<string, unknown>>(payload);
-  }
-
-  /**
-   * Return metered usage data for this workspace.
-   */
-  async usage(id: WorkspaceId | string): Promise<Record<string, unknown>> {
-    const payload = await this.http.get<unknown>(`/workspaces/${id}/usage`);
-    return unwrap<Record<string, unknown>>(payload);
-  }
-
-  /**
-   * Return activity feed for this workspace.
-   */
-  async activity(id: WorkspaceId | string): Promise<Record<string, unknown>[]> {
-    const payload = await this.http.get<unknown>(`/workspaces/${id}/activity`);
-    return listItems<Record<string, unknown>>(payload, [
-      "data",
-      "activity",
-      "events",
-      "items",
-    ]);
-  }
-
-  /**
-   * List computer templates available in this workspace.
-   */
-  async listComputerTemplates(
-    id: WorkspaceId | string,
-  ): Promise<Record<string, unknown>[]> {
-    const payload = await this.http.get<unknown>(
-      `/workspaces/${id}/computer-templates`,
-    );
-    return listItems<Record<string, unknown>>(payload, [
-      "data",
-      "templates",
-      "items",
-    ]);
-  }
-
-  /**
-   * Create a computer template scoped to this workspace.
-   */
-  async createComputerTemplate(
-    id: WorkspaceId | string,
-    params: WorkspaceComputerTemplateCreateParams,
-  ): Promise<Record<string, unknown>> {
-    const payload = await this.http.post<unknown>(
-      `/workspaces/${id}/computer-templates`,
-      params,
-    );
-    return unwrap<Record<string, unknown>>(payload);
-  }
-}