@miosa/sdk 0.3.0

package/src/resources/settings.ts

@@ -0,0 +1,143 @@
+/**
+ * Settings — tenant config, branding, BYOK provider keys.
+ */
+
+import type { HttpClient } from "../http.js";
+
+// ── Request payloads ─────────────────────────────────────────────────────────
+
+export interface SettingsUpdateParams {
+  [key: string]: unknown;
+}
+
+export interface BrandingUpdateParams {
+  logo_url?: string;
+  primary_color?: string;
+  wordmark?: string;
+  [key: string]: unknown;
+}
+
+export interface ProviderKeyUpsertParams {
+  key: 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",
+      "settings",
+      "branding",
+      "provider_keys",
+      "items",
+    ]) {
+      if (k in p) return p[k] as T;
+    }
+  }
+  return payload as T;
+}
+
+function listItems<T>(payload: unknown): T[] {
+  const result = unwrap<T[] | unknown>(payload);
+  if (Array.isArray(result)) return result;
+  return [];
+}
+
+function stripUndefined(
+  input: Record<string, unknown>,
+): Record<string, unknown> {
+  return Object.fromEntries(
+    Object.entries(input).filter(([, v]) => v !== undefined),
+  );
+}
+
+// ── Main resource ─────────────────────────────────────────────────────────────
+
+export class Settings {
+  constructor(private readonly http: HttpClient) {}
+
+  /** Get the current tenant settings. */
+  async get(): Promise<Record<string, unknown>> {
+    const data = await this.http.get<unknown>("/settings");
+    return unwrap<Record<string, unknown>>(data);
+  }
+
+  /** Update tenant settings. */
+  async update(params: SettingsUpdateParams): Promise<Record<string, unknown>> {
+    const body = stripUndefined(params as Record<string, unknown>);
+    const data = await this.http.put<unknown>("/settings", body);
+    return unwrap<Record<string, unknown>>(data);
+  }
+
+  // ── Branding ──────────────────────────────────────────────────────────────
+
+  /** Get tenant branding (logo, colors, custom wordmark). */
+  async getBranding(): Promise<Record<string, unknown>> {
+    const data = await this.http.get<unknown>("/settings/branding");
+    return unwrap<Record<string, unknown>>(data);
+  }
+
+  /** Update tenant branding. */
+  async updateBranding(
+    params: BrandingUpdateParams,
+  ): Promise<Record<string, unknown>> {
+    const body = stripUndefined(params as Record<string, unknown>);
+    const data = await this.http.put<unknown>("/settings/branding", body);
+    return unwrap<Record<string, unknown>>(data);
+  }
+
+  // ── Read-only reference data ───────────────────────────────────────────────
+
+  /** Get tenant-scoped compute pricing. */
+  async computePricing(): Promise<unknown> {
+    const data = await this.http.get<unknown>("/settings/compute-pricing");
+    return unwrap(data);
+  }
+
+  /** Get tenant-scoped GPU pricing. */
+  async gpuPricing(): Promise<unknown> {
+    const data = await this.http.get<unknown>("/settings/gpu-pricing");
+    return unwrap(data);
+  }
+
+  /** List models available to this tenant. */
+  async availableModels(): Promise<unknown> {
+    const data = await this.http.get<unknown>("/settings/available-models");
+    return unwrap(data);
+  }
+
+  /** List regions enabled for this tenant. */
+  async regions(): Promise<unknown> {
+    const data = await this.http.get<unknown>("/settings/regions");
+    return unwrap(data);
+  }
+
+  // ── BYOK provider keys ────────────────────────────────────────────────────
+
+  /** List tenant-level BYOK provider keys (Anthropic, OpenAI, etc.). */
+  async listProviderKeys(): Promise<Record<string, unknown>[]> {
+    const data = await this.http.get<unknown>("/settings/provider-keys");
+    return listItems<Record<string, unknown>>(data);
+  }
+
+  /** Create or update a BYOK provider key. */
+  async upsertProviderKey(
+    provider: string,
+    params: ProviderKeyUpsertParams,
+  ): Promise<Record<string, unknown>> {
+    const body = stripUndefined(params as Record<string, unknown>);
+    const data = await this.http.put<unknown>(
+      `/settings/provider-keys/${provider}`,
+      body,
+    );
+    return unwrap<Record<string, unknown>>(data);
+  }
+
+  /** Delete a BYOK provider key. */
+  async deleteProviderKey(provider: string): Promise<void> {
+    await this.http.delete<unknown>(`/settings/provider-keys/${provider}`);
+  }
+}

package/src/resources/snapshots-standalone.ts

@@ -0,0 +1,51 @@
+/**
+ * SnapshotsStandalone — fleet-wide snapshot index for admin callers.
+ *
+ * Routes: /admin/snapshots/*
+ * Requires admin credential.
+ *
+ * Per-computer snapshots remain nested under client.computers.get(id).checkpoints.
+ * This resource exposes the fleet-wide read-only index used by the admin dashboard.
+ */
+
+import type { HttpClient } from "../http.js";
+
+function unwrap(data: unknown): Record<string, unknown> {
+  if (data && typeof data === "object") {
+    const d = data as Record<string, unknown>;
+    for (const k of ["data", "snapshots", "items"]) {
+      if (k in d) return d[k] as Record<string, unknown>;
+    }
+  }
+  return data as Record<string, unknown>;
+}
+
+function unwrapList(data: unknown): Record<string, unknown>[] {
+  if (Array.isArray(data)) return data as Record<string, unknown>[];
+  if (data && typeof data === "object") {
+    const d = data as Record<string, unknown>;
+    for (const k of ["data", "snapshots", "items"]) {
+      if (Array.isArray(d[k])) return d[k] as Record<string, unknown>[];
+    }
+  }
+  return [];
+}
+
+export class SnapshotsStandalone {
+  constructor(private readonly http: HttpClient) {}
+
+  async list(
+    filters: Record<string, string | number | boolean | undefined> = {},
+  ): Promise<Record<string, unknown>[]> {
+    const query = Object.fromEntries(
+      Object.entries(filters).filter(([, v]) => v !== undefined),
+    ) as Record<string, string | number | boolean | undefined>;
+    return unwrapList(await this.http.get<unknown>("/admin/snapshots", query));
+  }
+
+  async get(snapshotId: string): Promise<Record<string, unknown>> {
+    return unwrap(
+      await this.http.get<unknown>(`/admin/snapshots/${snapshotId}`),
+    );
+  }
+}

package/src/resources/storage.ts

@@ -0,0 +1,221 @@
+/**
+ * Storage resource — managed S3-compatible buckets, objects, and presigned URLs.
+ */
+
+import type { HttpClient } from "../http.js";
+
+// ── Branded IDs ──────────────────────────────────────────────────────────────
+
+export type BucketId = string & { readonly __brand: "BucketId" };
+
+// ── Resource shapes ──────────────────────────────────────────────────────────
+
+export interface BucketData {
+  id: BucketId;
+  tenant_id: string;
+  name: string;
+  region?: string | null;
+  visibility?: "private" | "public" | string;
+  quota_bytes?: number | null;
+  used_bytes?: number | null;
+  public?: boolean;
+  object_count?: number | null;
+  size_bytes?: number | null;
+  created_at?: string;
+  updated_at?: string;
+  [key: string]: unknown;
+}
+
+export interface StorageObjectData {
+  key: string;
+  size_bytes?: number;
+  content_type?: string;
+  etag?: string | null;
+  last_modified?: string | null;
+  [key: string]: unknown;
+}
+
+export interface PresignResult {
+  url: string;
+  expires_at?: string;
+  [key: string]: unknown;
+}
+
+// ── Request payloads ─────────────────────────────────────────────────────────
+
+export interface BucketCreateParams {
+  name: string;
+  region?: string;
+  visibility?: "private" | "public";
+  quota_bytes?: number;
+  public?: boolean;
+  [key: string]: unknown;
+}
+
+export interface ObjectListParams {
+  prefix?: string;
+  maxKeys?: number;
+  max_keys?: number;
+  marker?: string;
+  /** @deprecated use maxKeys/max_keys; kept as a convenience alias. */
+  limit?: number;
+  /** @deprecated use marker; kept as a convenience alias. */
+  cursor?: string;
+}
+
+export interface PresignParams {
+  key: string;
+  method?: "GET" | "PUT";
+  expiresIn?: number;
+  expires_in?: number;
+  /** @deprecated use method; kept as a convenience alias. */
+  operation?: "get" | "put";
+  /** @deprecated use expiresIn/expires_in; kept as a convenience alias. */
+  expiresInSec?: number;
+  /** @deprecated use expiresIn/expires_in; kept as a convenience alias. */
+  expires_in_sec?: number;
+  contentType?: string;
+  content_type?: 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", "buckets", "objects", "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),
+  );
+}
+
+// ── Main resource ─────────────────────────────────────────────────────────────
+
+export class Storage {
+  constructor(private readonly http: HttpClient) {}
+
+  // ── Buckets ────────────────────────────────────────────────────────────────
+
+  async listBuckets(): Promise<BucketData[]> {
+    const data = await this.http.get<unknown>("/storage/buckets");
+    return listItems<BucketData>(data);
+  }
+
+  async createBucket(params: BucketCreateParams): Promise<BucketData> {
+    const { name, public: isPublic, visibility, ...rest } = params;
+    const body = stripUndefined({
+      name,
+      visibility:
+        visibility ??
+        (isPublic === undefined ? undefined : isPublic ? "public" : "private"),
+      ...rest,
+    });
+    const data = await this.http.post<unknown>("/storage/buckets", body);
+    return unwrap<BucketData>(data);
+  }
+
+  async getBucket(bucketId: string): Promise<BucketData> {
+    const data = await this.http.get<unknown>(`/storage/buckets/${bucketId}`);
+    return unwrap<BucketData>(data);
+  }
+
+  async deleteBucket(bucketId: string): Promise<void> {
+    await this.http.delete<unknown>(`/storage/buckets/${bucketId}`);
+  }
+
+  // ── Objects ────────────────────────────────────────────────────────────────
+
+  async listObjects(
+    bucketId: string,
+    params: ObjectListParams = {},
+  ): Promise<StorageObjectData[]> {
+    const query = stripUndefined({
+      prefix: params.prefix,
+      max_keys: params.max_keys ?? params.maxKeys ?? params.limit,
+      marker: params.marker ?? params.cursor,
+    }) as Record<string, string | number | boolean | undefined>;
+    const data = await this.http.get<unknown>(
+      `/storage/buckets/${bucketId}/objects`,
+      query,
+    );
+    return listItems<StorageObjectData>(data, ["data", "objects", "items"]);
+  }
+
+  async putObject(
+    bucketId: string,
+    key: string,
+    content: Uint8Array | ArrayBuffer,
+    opts: { contentType?: string } = {},
+  ): Promise<Record<string, unknown>> {
+    const contentType = opts.contentType ?? "application/octet-stream";
+    const data = await this.http.request<unknown>(
+      `/storage/buckets/${bucketId}/objects/${key}`,
+      {
+        method: "PUT",
+        body: content,
+        headers: { "Content-Type": contentType },
+      },
+    );
+    return (data ?? {}) as Record<string, unknown>;
+  }
+
+  async getObject(bucketId: string, key: string): Promise<Uint8Array> {
+    return this.http.getBinary(`/storage/buckets/${bucketId}/objects/${key}`);
+  }
+
+  async deleteObject(bucketId: string, key: string): Promise<void> {
+    await this.http.delete<unknown>(
+      `/storage/buckets/${bucketId}/objects/${key}`,
+    );
+  }
+
+  // ── Presigned URLs ─────────────────────────────────────────────────────────
+
+  async presign(
+    bucketId: string,
+    params: PresignParams,
+  ): Promise<PresignResult> {
+    const operationMethod =
+      params.operation === "put"
+        ? "PUT"
+        : params.operation === "get"
+          ? "GET"
+          : undefined;
+
+    const body = stripUndefined({
+      key: params.key,
+      method: params.method ?? operationMethod ?? "GET",
+      expires_in:
+        params.expiresIn ??
+        params.expires_in ??
+        params.expiresInSec ??
+        params.expires_in_sec ??
+        3600,
+    });
+    const data = await this.http.post<unknown>(
+      `/storage/buckets/${bucketId}/presign`,
+      body,
+    );
+    return unwrap<PresignResult>(data);
+  }
+}

package/src/resources/tenant.ts

@@ -0,0 +1,39 @@
+/**
+ * Tenant — current tenant info and plan/usage.
+ */
+
+import type { HttpClient } from "../http.js";
+
+// ── Resource shapes ──────────────────────────────────────────────────────────
+
+export interface TenantPlan {
+  id?: string;
+  name?: string;
+  limits?: Record<string, unknown>;
+  usage?: Record<string, unknown>;
+  [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", "tenant", "items"]) {
+      if (k in p) return p[k] as T;
+    }
+  }
+  return payload as T;
+}
+
+// ── Main resource ─────────────────────────────────────────────────────────────
+
+export class Tenant {
+  constructor(private readonly http: HttpClient) {}
+
+  /** Get the current tenant's plan, limits, and live usage counters. */
+  async current(): Promise<TenantPlan> {
+    const data = await this.http.get<unknown>("/tenant/plan");
+    return unwrap<TenantPlan>(data);
+  }
+}

package/src/resources/usage.ts

@@ -0,0 +1,85 @@
+/**
+ * Usage — per-session metering, summary, and reports.
+ */
+
+import type { HttpClient } from "../http.js";
+
+// ── Resource shapes ──────────────────────────────────────────────────────────
+
+export interface UsageSummary {
+  period_start?: string;
+  period_end?: string;
+  total_credits?: number;
+  [key: string]: unknown;
+}
+
+export interface UsageSession {
+  id?: string;
+  computer_id?: string;
+  started_at?: string;
+  ended_at?: string;
+  credits_used?: number;
+  [key: string]: unknown;
+}
+
+// ── Request payloads ─────────────────────────────────────────────────────────
+
+export interface UsageSessionsParams {
+  computer_id?: string;
+  limit?: number;
+  cursor?: string;
+  [key: string]: string | number | boolean | undefined;
+}
+
+export interface UsageReportParams extends UsageSessionsParams {
+  period_start?: string;
+  period_end?: string;
+}
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function unwrap<T>(payload: unknown): T {
+  if (payload && typeof payload === "object") {
+    const p = payload as Record<string, unknown>;
+    for (const k of ["data", "usage", "sessions", "summary", "items"]) {
+      if (k in p) return p[k] as T;
+    }
+  }
+  return payload as T;
+}
+
+function stripUndefined(
+  input: Record<string, unknown>,
+): Record<string, string | number | boolean | undefined> {
+  return Object.fromEntries(
+    Object.entries(input).filter(([, v]) => v !== undefined),
+  ) as Record<string, string | number | boolean | undefined>;
+}
+
+// ── Main resource ─────────────────────────────────────────────────────────────
+
+export class Usage {
+  constructor(private readonly http: HttpClient) {}
+
+  /** Get the current period usage summary. */
+  async current(): Promise<UsageSummary> {
+    const data = await this.http.get<unknown>("/usage/summary");
+    return unwrap<UsageSummary>(data);
+  }
+
+  /** List per-session metering events. */
+  async sessions(params: UsageSessionsParams = {}): Promise<UsageSession[]> {
+    const query = stripUndefined(params as Record<string, unknown>);
+    const data = await this.http.get<unknown>("/usage/sessions", query);
+    const result = unwrap<UsageSession[] | unknown>(data);
+    if (Array.isArray(result)) return result;
+    return [];
+  }
+
+  /** Get a usage report for a period. */
+  async report(params: UsageReportParams = {}): Promise<UsageSummary> {
+    const query = stripUndefined(params as Record<string, unknown>);
+    const data = await this.http.get<unknown>("/usage/summary", query);
+    return unwrap<UsageSummary>(data);
+  }
+}

package/src/resources/volumes.ts

@@ -0,0 +1,117 @@
+/**
+ * Volumes resource — persistent block storage.
+ */
+
+import { randomUUID } from "node:crypto";
+
+import type { HttpClient } from "../http.js";
+
+// ── Branded IDs ──────────────────────────────────────────────────────────────
+
+export type VolumeId = string & { readonly __brand: "VolumeId" };
+
+// ── Resource shapes ──────────────────────────────────────────────────────────
+
+export interface VolumeData {
+  id: VolumeId;
+  tenant_id: string;
+  name: string;
+  size_gb: number;
+  state?: string;
+  region?: string | null;
+  attached_to?: string | null;
+  created_at?: string;
+  updated_at?: string;
+  [key: string]: unknown;
+}
+
+// ── Request payloads ─────────────────────────────────────────────────────────
+
+export interface VolumeListParams {
+  limit?: number;
+  cursor?: string;
+  state?: string;
+  [key: string]: string | number | boolean | undefined;
+}
+
+export interface VolumeCreateParams {
+  name: string;
+  size_gb: number;
+  sizeGb?: number;
+  region?: string;
+  idempotencyKey?: 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", "volumes", "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 Volumes {
+  constructor(private readonly http: HttpClient) {}
+
+  async list(params: VolumeListParams = {}): Promise<VolumeData[]> {
+    const query = stripUndefined({ ...params }) as Record<
+      string,
+      string | number | boolean | undefined
+    >;
+    const data = await this.http.get<unknown>("/volumes", query);
+    return listItems<VolumeData>(data);
+  }
+
+  async get(volumeId: string): Promise<VolumeData> {
+    const data = await this.http.get<unknown>(`/volumes/${volumeId}`);
+    return unwrap<VolumeData>(data);
+  }
+
+  async create(params: VolumeCreateParams): Promise<VolumeData> {
+    const { idempotencyKey: ikey, sizeGb, ...rest } = params;
+    const body = stripUndefined({
+      ...rest,
+      size_gb: sizeGb ?? rest.size_gb,
+    });
+    const data = await this.http.request<unknown>("/volumes", {
+      method: "POST",
+      body,
+      headers: { "Idempotency-Key": idempotencyKey(ikey) },
+    });
+    return unwrap<VolumeData>(data);
+  }
+
+  async delete(volumeId: string): Promise<void> {
+    await this.http.delete<unknown>(`/volumes/${volumeId}`);
+  }
+}