Template

import { Template } from "@superserve/sdk"

const template = await Template.create({
  name: "my-python-env",
  vcpu: 2,
  memoryMib: 2048,
  diskMib: 4096,
  from: "python:3.11",
  steps: [
    { run: "pip install numpy pandas" },
    { env: { key: "DEBUG", value: "1" } },
    { workdir: "/app" },
    { user: { name: "appuser", sudo: true } },
  ],
  startCmd: "python server.py",
  readyCmd: "curl -f http://localhost:8080/health",
})

const template = await Template.connect("7a3f2b8c-1234-...")

const all = await Template.list()
const mine = await Template.list({ namePrefix: "my-" })

await Template.deleteById("7a3f2b8c-1234-...")

const info = await template.getInfo()
console.log(info.status)  // "pending" | "building" | "ready" | "failed"

const info = await template.waitUntilReady({
  onLog: (event) => {
    if (event.stream === "system") return
    process.stdout.write(event.text)
  },
})

await template.streamBuildLogs({
  onEvent: (ev) => {
    console.log(`[${ev.stream}] ${ev.text}`)
  },
  // buildId defaults to template.latestBuildId
})

const build = await template.rebuild()
console.log(build.id, build.status)

const builds = await template.listBuilds({ limit: 10 })

const build = await template.getBuild("build-uuid")

await template.cancelBuild(build.id)

await template.delete()

type TemplateStatus = "pending" | "building" | "ready" | "failed"

type TemplateBuildStatus =
  | "pending"
  | "building"
  | "snapshotting"
  | "ready"
  | "failed"
  | "cancelled"

interface TemplateInfo {
  id: string
  name: string
  teamId: string
  status: TemplateStatus
  vcpu: number
  memoryMib: number
  diskMib: number
  sizeBytes?: number
  errorMessage?: string
  createdAt: Date
  builtAt?: Date
  latestBuildId?: string
}

interface TemplateBuildInfo {
  id: string
  templateId: string
  status: TemplateBuildStatus
  buildSpecHash: string
  errorMessage?: string
  startedAt?: Date
  finalizedAt?: Date
  createdAt: Date
}

interface BuildLogEvent {
  timestamp: Date
  stream: "stdout" | "stderr" | "system"
  text: string
  finished?: boolean
  status?: "ready" | "failed" | "cancelled"
}

type BuildStep =
  | { run: string }
  | { env: { key: string; value: string } }
  | { workdir: string }
  | { user: { name: string; sudo?: boolean } }

class BuildError extends SandboxError {
  readonly code: string        // e.g. "image_pull_failed" | "step_failed" | ...
  readonly message: string     // human-readable detail (prefix stripped)
  readonly buildId: string
  readonly templateId: string
}