@zerct/zerct 0.1.5 → 0.1.7

package/README.md

@@ -20,6 +20,10 @@ on `0.0.0.0:$PORT` and expose the configured health endpoint.
 From a full-stack repo root, the same deploy command discovers nested
 `zerct.toml` files and deploys the whole workspace in one command.
 
+Agents can also inspect API capabilities, account identity, usage, apps,
+deploys, builds, app/deploy/build logs, env metadata, custom domains, and
+billing portal links through the same CLI.
+
 On first deploy, the CLI opens browser login, waits for GitHub or Google, stores
 the Zerct session in the OS credential store when available, and continues the
 deploy. Later commands reuse that session.

package/bin/zerct.js

@@ -4,7 +4,7 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSy
 import { homedir } from 'node:os'
 import path from 'node:path'
 
-const VERSION = '0.1.5'
+const VERSION = '0.1.7'
 const DEFAULT_API_URL = 'https://api.zerct.com'
 const ARCHIVE_LIMIT_BYTES = 48 * 1024 * 1024
 const SESSION_DIR = '.zerct'
@@ -65,12 +65,23 @@ Usage:
   zerct doctor [path] [--json]
   zerct login [--token <token>] [--api <url>]
   zerct deploy [path] [--database] [--api <url>] [--json]
-  zerct logs --app <app_id> [--api <url>] [--json]
+  zerct capabilities [--api <url>] [--json]
+  zerct me [--api <url>] [--json]
+  zerct usage [--api <url>] [--json]
+  zerct apps [--api <url>] [--json]
+  zerct deploys [--app <app_id>] [--limit <n>] [--cursor <cursor>] [--api <url>] [--json]
+  zerct builds [--app <app_id>] [--limit <n>] [--cursor <cursor>] [--api <url>] [--json]
+  zerct logs --app <app_id> [--deploy <deploy_id>] [--build <build_id>] [--limit <n>] [--cursor <cursor>] [--api <url>] [--json]
   zerct status --app <app_id> [--api <url>] [--json]
   zerct inspect --app <app_id> [--api <url>] [--json]
   zerct db --app <app_id> [--api <url>] [--json]
+  zerct env list --app <app_id> [--api <url>] [--json]
   zerct env set --app <app_id> KEY=value [--api <url>] [--json]
-  zerct billing [--api <url>] [--json]
+  zerct env delete --app <app_id> KEY [--api <url>] [--json]
+  zerct domains list --app <app_id> [--api <url>] [--json]
+  zerct domains add --app <app_id> <domain> [--api <url>] [--json]
+  zerct domains delete --app <app_id> <domain> [--api <url>] [--json]
+  zerct billing [portal] [--api <url>] [--json]
 
 Agent contract:
   - Rust backends keep Cargo.lock committed, listen on 0.0.0.0:$PORT, and return HTTP 200 from health.
@@ -108,6 +119,24 @@ async function main() {
     case 'deploy':
       await deploy(projectPath(cli.args[0]), cli)
       break
+    case 'capabilities':
+      await capabilities(cli)
+      break
+    case 'me':
+      await me(cli)
+      break
+    case 'usage':
+      await usage(cli)
+      break
+    case 'apps':
+      await apps(cli)
+      break
+    case 'deploys':
+      await deploys(cli)
+      break
+    case 'builds':
+      await builds(cli)
+      break
     case 'logs':
       await logs(cli)
       break
@@ -124,6 +153,9 @@ async function main() {
     case 'env':
       await envCommand(cli)
       break
+    case 'domains':
+      await domainsCommand(cli)
+      break
     case 'billing':
       await billing(cli)
       break
@@ -138,6 +170,10 @@ function parseArgs(argv) {
     args: [],
     apiUrl: DEFAULT_API_URL,
     app: '',
+    build: '',
+    deploy: '',
+    limit: '',
+    cursor: '',
     token: '',
     json: false,
     database: false,
@@ -164,6 +200,18 @@ function parseArgs(argv) {
     } else if (arg === '--app') {
       cli.app = requireValue(argv, index, '--app')
       index += 1
+    } else if (arg === '--build') {
+      cli.build = requireValue(argv, index, '--build')
+      index += 1
+    } else if (arg === '--deploy') {
+      cli.deploy = requireValue(argv, index, '--deploy')
+      index += 1
+    } else if (arg === '--limit') {
+      cli.limit = requireValue(argv, index, '--limit')
+      index += 1
+    } else if (arg === '--cursor') {
+      cli.cursor = requireValue(argv, index, '--cursor')
+      index += 1
     } else if (arg === '--token') {
       cli.token = requireValue(argv, index, '--token')
       index += 1
@@ -471,7 +519,17 @@ function printWorkspaceDeployResults(projectDir, results, cli) {
 }
 
 async function logs(cli) {
-  const response = await appGet(cli, 'logs')
+  const token = await readOrLoginToken(process.cwd(), cli)
+  const page = pageQuery(cli)
+  let route = ''
+  if (cli.build) {
+    route = `/v1/builds/${encodeURIComponent(cli.build)}/logs${page}`
+  } else if (cli.deploy) {
+    route = `/v1/deploys/${encodeURIComponent(cli.deploy)}/logs${page}`
+  } else {
+    route = `/v1/apps/${encodeURIComponent(requireApp(cli))}/logs${page}`
+  }
+  const response = await apiRequest(cli, 'GET', route, token, null)
   if (cli.json) {
     console.log(JSON.stringify(response, null, 2))
     return
@@ -479,6 +537,55 @@ async function logs(cli) {
   for (const line of response.lines || []) {
     console.log(`[${line.timestamp}] ${line.stream}: ${line.message}`)
   }
+  if (response.has_more && response.next_cursor) {
+    const target = cli.build
+      ? `--build ${cli.build}`
+      : cli.deploy
+        ? `--deploy ${cli.deploy}`
+        : `--app ${requireApp(cli)}`
+    console.log(`next npx @zerct/zerct logs ${target} --cursor ${response.next_cursor}`)
+  }
+}
+
+async function apps(cli) {
+  const token = await readOrLoginToken(process.cwd(), cli)
+  const response = await apiRequest(cli, 'GET', '/v1/apps', token, null)
+  printJsonOrPretty(cli, response)
+}
+
+async function capabilities(cli) {
+  const response = await apiRequest(cli, 'GET', '/v1/capabilities', null, null)
+  printJsonOrPretty(cli, response)
+}
+
+async function me(cli) {
+  const token = await readOrLoginToken(process.cwd(), cli)
+  const response = await apiRequest(cli, 'GET', '/v1/me', token, null)
+  printJsonOrPretty(cli, response)
+}
+
+async function usage(cli) {
+  const token = await readOrLoginToken(process.cwd(), cli)
+  const response = await apiRequest(cli, 'GET', '/v1/usage', token, null)
+  printJsonOrPretty(cli, response)
+}
+
+async function deploys(cli) {
+  const token = await readOrLoginToken(process.cwd(), cli)
+  const route = cli.app
+    ? `/v1/apps/${encodeURIComponent(cli.app)}/deploys${pageQuery(cli)}`
+    : `/v1/deploys${pageQuery(cli)}`
+  const response = await apiRequest(cli, 'GET', route, token, null)
+  printJsonOrPretty(cli, response)
+}
+
+async function builds(cli) {
+  const token = await readOrLoginToken(process.cwd(), cli)
+  const route = cli.app
+    ? `/v1/apps/${encodeURIComponent(cli.app)}/builds${pageQuery(cli)}`
+    : `/v1/builds${pageQuery(cli)}`
+  const response = await apiRequest(cli, 'GET', route, token, null)
+  printJsonOrPretty(cli, response)
 }
 
 async function status(cli) {
@@ -497,8 +604,26 @@ async function database(cli) {
 }
 
 async function envCommand(cli) {
+  if (cli.args[0] === 'list') {
+    const response = await appGet(cli, 'env')
+    printJsonOrPretty(cli, response)
+    return
+  }
+
+  if (cli.args[0] === 'delete') {
+    const name = cli.args[1] || ''
+    if (!name) {
+      throw agentError('invalid_env', 'Environment variable name is required.', 'Use `npx @zerct/zerct env delete --app <app_id> KEY`.', cli.json)
+    }
+    const token = await readOrLoginToken(process.cwd(), cli)
+    const app = requireApp(cli)
+    const response = await apiRequest(cli, 'DELETE', `/v1/apps/${encodeURIComponent(app)}/env/${encodeURIComponent(name)}`, token, null)
+    printJsonOrPretty(cli, response)
+    return
+  }
+
   if (cli.args[0] !== 'set') {
-    throw agentError('unknown_command', 'Unknown env command.', 'Use `npx @zerct/zerct env set --app <app_id> KEY=value`.', cli.json)
+    throw agentError('unknown_command', 'Unknown env command.', 'Use `npx @zerct/zerct env list`, `env set`, or `env delete`.', cli.json)
   }
 
   const assignment = cli.args[1] || ''
@@ -515,8 +640,48 @@ async function envCommand(cli) {
   printJsonOrPretty(cli, response)
 }
 
+async function domainsCommand(cli) {
+  const action = cli.args[0] || 'list'
+  if (action === 'list') {
+    const response = await appGet(cli, 'domains')
+    printJsonOrPretty(cli, response)
+    return
+  }
+
+  const domain = cli.args[1] || ''
+  if (!domain) {
+    throw agentError('missing_domain', 'Domain is required.', 'Use `npx @zerct/zerct domains add --app <app_id> api.example.com`.', cli.json)
+  }
+
+  const token = await readOrLoginToken(process.cwd(), cli)
+  const app = requireApp(cli)
+  if (action === 'add') {
+    const response = await apiRequest(cli, 'POST', `/v1/apps/${encodeURIComponent(app)}/domains`, token, { domain })
+    printJsonOrPretty(cli, response)
+    return
+  }
+  if (action === 'delete') {
+    const response = await apiRequest(cli, 'DELETE', `/v1/apps/${encodeURIComponent(app)}/domains/${encodeURIComponent(domain)}`, token, null)
+    printJsonOrPretty(cli, response)
+    return
+  }
+
+  throw agentError('unknown_command', 'Unknown domains command.', 'Use `domains list`, `domains add`, or `domains delete`.', cli.json)
+}
+
 async function billing(cli) {
   const token = await readOrLoginToken(process.cwd(), cli)
+  if (cli.args[0] === 'portal') {
+    const response = await apiRequest(cli, 'POST', '/v1/billing/portal', token, null)
+    if (cli.json) {
+      console.log(JSON.stringify(response, null, 2))
+      return
+    }
+    console.log(response.checkout.url)
+    openUrl(response.checkout.url)
+    return
+  }
+
   const response = await apiRequest(cli, 'POST', '/v1/billing/checkout', token, {
     target_plan: 'pro',
     reason: 'Upgrade to Zerct Pro.'
@@ -599,6 +764,18 @@ function requireApp(cli) {
   return cli.app
 }
 
+function pageQuery(cli) {
+  const params = new URLSearchParams()
+  if (cli.limit) {
+    params.set('limit', cli.limit)
+  }
+  if (cli.cursor) {
+    params.set('cursor', cli.cursor)
+  }
+  const value = params.toString()
+  return value ? `?${value}` : ''
+}
+
 async function apiRequest(cli, method, route, token, body) {
   const headers = {
     accept: 'application/json'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerct/zerct",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Deploy Rust backends and static frontends to Zerct.",
   "type": "module",
   "bin": {