@miosa/sdk 1.2.4 → 1.2.6

package/src/resources/cron-jobs.ts

@@ -1,191 +0,0 @@
-/**
- * CronJobs resource — scheduled work.
- */
-
-import { randomUUID } from "node:crypto";
-
-import type { HttpClient } from "../http.js";
-
-// ── Branded IDs ──────────────────────────────────────────────────────────────
-
-export type CronJobId = string & { readonly __brand: "CronJobId" };
-export type CronJobExecutionId = string & {
-  readonly __brand: "CronJobExecutionId";
-};
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface CronJobData {
-  id: CronJobId;
-  tenant_id: string;
-  name: string;
-  schedule: string;
-  state?: string;
-  paused?: boolean;
-  last_run_at?: string | null;
-  next_run_at?: string | null;
-  created_at?: string;
-  updated_at?: string;
-  [key: string]: unknown;
-}
-
-export interface CronJobExecutionData {
-  id: CronJobExecutionId;
-  cron_job_id: CronJobId;
-  state?: string;
-  started_at?: string | null;
-  finished_at?: string | null;
-  duration_ms?: number | null;
-  exit_code?: number | null;
-  error?: string | null;
-  created_at?: string;
-  [key: string]: unknown;
-}
-
-// ── Request payloads ─────────────────────────────────────────────────────────
-
-export interface CronJobListParams {
-  limit?: number;
-  cursor?: string;
-  state?: string;
-  [key: string]: string | number | boolean | undefined;
-}
-
-export interface CronJobCreateParams {
-  name: string;
-  schedule: string;
-  idempotencyKey?: string;
-  [key: string]: unknown;
-}
-
-export interface CronJobUpdateParams {
-  name?: string;
-  schedule?: 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", "cron_jobs", "executions", "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 [];
-}
-
-function stripUndefined(
-  input: Record<string, unknown>,
-): Record<string, unknown> {
-  return Object.fromEntries(
-    Object.entries(input).filter(([, v]) => v !== undefined),
-  );
-}
-
-function idempotencyKey(key?: string): string {
-  return key ?? randomUUID();
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class CronJobs {
-  constructor(private readonly http: HttpClient) {}
-
-  async list(params: CronJobListParams = {}): Promise<CronJobData[]> {
-    const query = stripUndefined({ ...params }) as Record<
-      string,
-      string | number | boolean | undefined
-    >;
-    const data = await this.http.get<unknown>("/cron-jobs", query);
-    return listItems<CronJobData>(data);
-  }
-
-  async get(jobId: string): Promise<CronJobData> {
-    const data = await this.http.get<unknown>(`/cron-jobs/${jobId}`);
-    return unwrap<CronJobData>(data);
-  }
-
-  async create(params: CronJobCreateParams): Promise<CronJobData> {
-    const { idempotencyKey: ikey, ...rest } = params;
-    const body = stripUndefined(rest as Record<string, unknown>);
-    const data = await this.http.request<unknown>("/cron-jobs", {
-      method: "POST",
-      body,
-      headers: { "Idempotency-Key": idempotencyKey(ikey) },
-    });
-    return unwrap<CronJobData>(data);
-  }
-
-  async update(
-    jobId: string,
-    params: CronJobUpdateParams,
-  ): Promise<CronJobData> {
-    const body = stripUndefined(params as Record<string, unknown>);
-    const data = await this.http.patch<unknown>(`/cron-jobs/${jobId}`, body);
-    return unwrap<CronJobData>(data);
-  }
-
-  async delete(jobId: string): Promise<void> {
-    await this.http.delete<unknown>(`/cron-jobs/${jobId}`);
-  }
-
-  // ── Control ────────────────────────────────────────────────────────────────
-
-  async pause(jobId: string): Promise<CronJobData> {
-    const data = await this.http.post<unknown>(`/cron-jobs/${jobId}/pause`);
-    return unwrap<CronJobData>(data);
-  }
-
-  async resume(jobId: string): Promise<CronJobData> {
-    const data = await this.http.post<unknown>(`/cron-jobs/${jobId}/resume`);
-    return unwrap<CronJobData>(data);
-  }
-
-  async runNow(
-    jobId: string,
-    opts: { idempotencyKey?: string } = {},
-  ): Promise<CronJobData> {
-    const data = await this.http.request<unknown>(
-      `/cron-jobs/${jobId}/run-now`,
-      {
-        method: "POST",
-        headers: { "Idempotency-Key": idempotencyKey(opts.idempotencyKey) },
-      },
-    );
-    return unwrap<CronJobData>(data);
-  }
-
-  // ── Execution history ──────────────────────────────────────────────────────
-
-  async listExecutions(jobId: string): Promise<CronJobExecutionData[]> {
-    const data = await this.http.get<unknown>(`/cron-jobs/${jobId}/executions`);
-    return listItems<CronJobExecutionData>(data, [
-      "data",
-      "executions",
-      "items",
-    ]);
-  }
-
-  async getExecution(
-    jobId: string,
-    executionId: string,
-  ): Promise<CronJobExecutionData> {
-    const data = await this.http.get<unknown>(
-      `/cron-jobs/${jobId}/executions/${executionId}`,
-    );
-    return unwrap<CronJobExecutionData>(data);
-  }
-}

package/src/resources/custom_domains.ts

@@ -1,123 +0,0 @@
-import type { HttpClient } from "../http.js";
-
-// ─── Custom Domains ───────────────────────────────────────────────────────────
-
-export type CustomDomainStatus =
-  | "pending"
-  | "verified"
-  | "active"
-  | "failed"
-  | "removed";
-
-export interface CustomDomainData {
-  id: string;
-  computer_id: string;
-  tenant_id: string;
-  fqdn: string;
-  status: CustomDomainStatus;
-  /** The CNAME target the user must point their DNS record at. */
-  verification_target: string;
-  /** Human-readable DNS setup instructions. */
-  instructions: string;
-  verified_at: string | null;
-  tls_issued_at: string | null;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface CustomDomainRegisterParams {
-  fqdn: string;
-}
-
-// ─── CustomDomains resource ──────────────────────────────────────────────────
-
-/**
- * Custom domain management for a Computer.
- *
- * Accessed via `computer.domains`.
- *
- * ## Workflow
- * ```ts
- * // 1. Register the domain
- * const domain = await computer.domains.register("app.example.com");
- * console.log(domain.instructions);
- * // => "Add a CNAME record: app.example.com → <slug>.sandbox.miosa.ai"
- *
- * // 2. Add the CNAME in your DNS registrar, then...
- *
- * // 3. Verify ownership
- * const verified = await computer.domains.verify(domain.id);
- * // Caddy auto-issues a TLS certificate after this point.
- * ```
- */
-export class CustomDomains {
-  private readonly http: HttpClient;
-  private readonly computerId: string;
-
-  constructor(http: HttpClient, computerId: string) {
-    this.http = http;
-    this.computerId = computerId;
-  }
-
-  private base(): string {
-    return `/computers/${this.computerId}/domains`;
-  }
-
-  /**
-   * Register a custom FQDN for this computer.
-   *
-   * Returns the domain record with `verification_target` and `instructions`
-   * showing which CNAME record to add. The domain starts in `pending` status.
-   *
-   * @param fqdn - The fully-qualified domain name to register
-   *   (e.g. `"app.example.com"`). Must be lowercase RFC 1123, ≤ 253 chars,
-   *   and must NOT end with `miosa.ai`.
-   */
-  async register(fqdn: string): Promise<CustomDomainData> {
-    const resp = await this.http.post<{ data: CustomDomainData }>(this.base(), {
-      fqdn,
-    });
-    return resp.data;
-  }
-
-  /**
-   * List all custom domains registered for this computer.
-   */
-  async list(): Promise<CustomDomainData[]> {
-    const resp = await this.http.get<{ data: CustomDomainData[] }>(this.base());
-    return resp.data;
-  }
-
-  /**
-   * Verify DNS ownership of a registered domain.
-   *
-   * The control plane resolves the domain's CNAME and confirms it points to
-   * the expected `verification_target`. On success the domain transitions to
-   * `verified` status and Caddy will auto-issue a TLS certificate on the next
-   * inbound request.
-   *
-   * @param id - The custom domain record id (from `register()` or `list()`).
-   * @throws `ApiError` with code `CNAME_MISMATCH` if the CNAME doesn't match.
-   * @throws `ApiError` with code `DNS_LOOKUP_FAILED` if DNS is unreachable.
-   */
-  async verify(id: string): Promise<CustomDomainData> {
-    const resp = await this.http.post<{ data: CustomDomainData }>(
-      `${this.base()}/${id}/verify`,
-    );
-    return resp.data;
-  }
-
-  /**
-   * Delete a custom domain mapping.
-   *
-   * The domain is immediately removed from the routing cache and Caddy will
-   * stop serving it on the next cert renewal cycle.
-   *
-   * @param id - The custom domain record id.
-   */
-  async delete(id: string): Promise<void> {
-    await this.http.delete<{ id: string; deleted: boolean }>(
-      `${this.base()}/${id}`,
-    );
-  }
-}

package/src/resources/dashboard.ts

@@ -1,49 +0,0 @@
-/**
- * Dashboard — aggregated platform overview.
- */
-
-import type { HttpClient } from "../http.js";
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface DashboardSummary {
-  computers?: unknown;
-  sandboxes?: unknown;
-  credits?: unknown;
-  [key: string]: unknown;
-}
-
-export interface OverviewData {
-  status?: string;
-  [key: string]: unknown;
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function unwrap<T>(payload: unknown): T {
-  if (payload && typeof payload === "object") {
-    const p = payload as Record<string, unknown>;
-    for (const k of ["data", "dashboard", "overview", "items"]) {
-      if (k in p) return p[k] as T;
-    }
-  }
-  return payload as T;
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class Dashboard {
-  constructor(private readonly http: HttpClient) {}
-
-  /** Aggregated user dashboard payload. */
-  async summary(): Promise<DashboardSummary> {
-    const data = await this.http.get<unknown>("/dashboard");
-    return unwrap<DashboardSummary>(data);
-  }
-
-  /** Status / health overview (public endpoint). */
-  async overview(): Promise<OverviewData> {
-    const data = await this.http.get<unknown>("/overview");
-    return unwrap<OverviewData>(data);
-  }
-}

package/src/resources/databases.ts

@@ -1,218 +0,0 @@
-/**
- * Databases resource — managed Postgres / databases.
- */
-
-import { randomUUID } from "node:crypto";
-
-import type { HttpClient } from "../http.js";
-
-// ── Branded IDs ──────────────────────────────────────────────────────────────
-
-export type DatabaseId = string & { readonly __brand: "DatabaseId" };
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface DatabaseData {
-  id: DatabaseId;
-  tenant_id: string;
-  name: string;
-  state?: string;
-  engine?: string;
-  engine_version?: string;
-  version?: string;
-  cpu_count?: number;
-  memory_mb?: number;
-  storage_mb?: number;
-  host?: string | null;
-  port?: number | null;
-  created_at?: string;
-  updated_at?: string;
-  [key: string]: unknown;
-}
-
-export interface DatabaseCredentials {
-  url?: string;
-  host?: string;
-  port?: number;
-  user?: string;
-  username?: string;
-  password?: string;
-  database?: string;
-  [key: string]: unknown;
-}
-
-export interface DatabaseLogsResult {
-  lines?: string[];
-  logs?: string[];
-  [key: string]: unknown;
-}
-
-// ── Request payloads ─────────────────────────────────────────────────────────
-
-export interface DatabaseListParams {
-  limit?: number;
-  cursor?: string;
-  state?: string;
-  [key: string]: string | number | boolean | undefined;
-}
-
-export interface DatabaseCreateParams {
-  name: string;
-  engine?: string;
-  engine_version?: string;
-  cpu_count?: number;
-  memory_mb?: number;
-  storage_mb?: number;
-  external_workspace_id?: string;
-  external_user_id?: string;
-  external_project_id?: string;
-  metadata?: Record<string, unknown>;
-  /** @deprecated use engine_version. */
-  version?: string;
-  /** @deprecated use cpu_count/memory_mb/storage_mb. */
-  size?: string;
-  region?: string;
-  idempotencyKey?: string;
-  idempotency_key?: string;
-  [key: string]: unknown;
-}
-
-export interface DatabaseLogsParams {
-  lines?: number;
-  since?: 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,
-  candidateKeys: string[] = ["data", "databases", "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 [];
-}
-
-function stripUndefined(
-  input: Record<string, unknown>,
-): Record<string, unknown> {
-  return Object.fromEntries(
-    Object.entries(input).filter(([, v]) => v !== undefined),
-  );
-}
-
-function idempotencyKey(key?: string): string {
-  return key ?? randomUUID();
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class Databases {
-  constructor(private readonly http: HttpClient) {}
-
-  async list(params: DatabaseListParams = {}): Promise<DatabaseData[]> {
-    const query = stripUndefined({ ...params }) as Record<
-      string,
-      string | number | boolean | undefined
-    >;
-    const data = await this.http.get<unknown>("/databases", query);
-    return listItems<DatabaseData>(data);
-  }
-
-  async get(databaseId: string): Promise<DatabaseData> {
-    const data = await this.http.get<unknown>(`/databases/${databaseId}`);
-    return unwrap<DatabaseData>(data);
-  }
-
-  async create(params: DatabaseCreateParams): Promise<DatabaseData> {
-    const {
-      idempotencyKey: camelIdempotencyKey,
-      idempotency_key: snakeIdempotencyKey,
-      version,
-      engine_version,
-      size: _deprecatedSize,
-      ...rest
-    } = params;
-
-    const body = stripUndefined({
-      ...rest,
-      engine_version: engine_version ?? version,
-    } as Record<string, unknown>);
-
-    const data = await this.http.request<unknown>("/databases", {
-      method: "POST",
-      body,
-      headers: {
-        "Idempotency-Key": idempotencyKey(
-          camelIdempotencyKey ?? snakeIdempotencyKey,
-        ),
-      },
-    });
-    return unwrap<DatabaseData>(data);
-  }
-
-  async delete(databaseId: string): Promise<void> {
-    await this.http.delete<unknown>(`/databases/${databaseId}`);
-  }
-
-  // ── Lifecycle ──────────────────────────────────────────────────────────────
-
-  async start(databaseId: string): Promise<DatabaseData> {
-    const data = await this.http.post<unknown>(
-      `/databases/${databaseId}/start`,
-    );
-    return unwrap<DatabaseData>(data);
-  }
-
-  async stop(databaseId: string): Promise<DatabaseData> {
-    const data = await this.http.post<unknown>(`/databases/${databaseId}/stop`);
-    return unwrap<DatabaseData>(data);
-  }
-
-  async restart(databaseId: string): Promise<DatabaseData> {
-    const data = await this.http.post<unknown>(
-      `/databases/${databaseId}/restart`,
-    );
-    return unwrap<DatabaseData>(data);
-  }
-
-  // ── Credentials + logs ────────────────────────────────────────────────────
-
-  async credentials(databaseId: string): Promise<DatabaseCredentials> {
-    const data = await this.http.get<unknown>(
-      `/databases/${databaseId}/credentials`,
-    );
-    return unwrap<DatabaseCredentials>(data);
-  }
-
-  async logs(
-    databaseId: string,
-    params: DatabaseLogsParams = {},
-  ): Promise<DatabaseLogsResult> {
-    const query = stripUndefined({
-      lines: params.lines,
-      since: params.since,
-    }) as Record<string, string | number | boolean | undefined>;
-    const data = await this.http.get<unknown>(
-      `/databases/${databaseId}/logs`,
-      query,
-    );
-    return data as DatabaseLogsResult;
-  }
-
-  streamLogs(databaseId: string): AsyncIterableIterator<unknown> {
-    return this.http.stream<unknown>(`/databases/${databaseId}/logs/stream`);
-  }
-}