@supacloud/cli 0.24.0 → 0.25.0

package/README.md

@@ -113,6 +113,22 @@ logical-backup and PostgREST lifecycle capabilities. It requires the Management
 API context above; it does not promote an application `service_role` key to
 Management authority.
 
+Project pause and restore are explicit lifecycle commands. A logical backup
+restore requires an operator to pause the selected project first and then use
+`project get` to confirm that its status is `paused`. `project restore` resumes
+the paused project lifecycle when its database exists; if the database is
+missing, the platform begins project re-provisioning instead. It does not
+restore a database backup and is never invoked automatically by the CLI.
+
+```bash
+supacloud-cli project pause --ref abc123
+supacloud-cli release logical_backup_restore --ref abc123 \
+  --backup_id logical-full_abc123_<backup-id-suffix> \
+  --expected_sha256 <64-lowercase-hex> \
+  --restore_confirmation RESTORE_PROJECT:abc123:logical-full_abc123_<backup-id-suffix>:<64-lowercase-hex>
+supacloud-cli project restore --ref abc123
+```
+
 ```bash
 supacloud-cli release logical_backup_list --ref abc123
 supacloud-cli release logical_backup_create --ref abc123

package/dist/index.js

@@ -6459,7 +6459,7 @@ function resolveSupaCloudContext(env = process.env, cwd = process.cwd(), selecti
 var ACTION_POLICY = {
   project: {
     read: ["get", "health", "logs", "api_keys", "settings", "tasks", "task_detail", "task_stats", "dlq", "background_settings"],
-    write: ["task_cancel", "task_retry", "update_background_settings"]
+    write: ["pause", "restore", "task_cancel", "task_retry", "update_background_settings"]
   },
   database: {
     read: ["list_tables", "describe_columns", "list_indexes", "list_constraints", "list_extensions", "rls_status", "rls_policies", "list_auth_users", "get_auth_user", "connections", "stats", "slow_queries", "list_migrations", "migration_inventory", "project_url", "generate_types"],
@@ -10098,6 +10098,7 @@ var formatTaskStats = (data) => {
 `);
 };
 var ok = (res) => res.ok ? JSON.stringify(res.data, null, 2) : `❌ Failed (${res.status}): ${JSON.stringify(res.data)}`;
+var simple = (res, msg) => res.ok ? `✅ ${msg}` : `❌ Failed (${res.status})`;
 function buildProjectLogsPath(ref, logType) {
   const params = new URLSearchParams({ limit: "200" });
   if (logType && logType !== "all") {
@@ -10114,9 +10115,11 @@ function resolveRef(refFromArgs, defaultRef) {
 function registerUserProjectCliTools(server, http, options = {}) {
   const { projectRef } = options;
   server.tool("project", `Project-scoped inspection and developer operations.
-Actions: get, health, logs, api_keys, settings, tasks, task_detail, task_cancel, task_retry, task_stats, dlq, background_settings, update_background_settings`, {
+Actions: get, pause, restore, health, logs, api_keys, settings, tasks, task_detail, task_cancel, task_retry, task_stats, dlq, background_settings, update_background_settings`, {
     action: withDescription(stringEnum([
       "get",
+      "pause",
+      "restore",
       "health",
       "logs",
       "api_keys",
@@ -10144,6 +10147,12 @@ Actions: get, health, logs, api_keys, settings, tasks, task_detail, task_cancel,
         return projectReadResponse(projectGetRead(await http.get(`/v1/projects/${resolvedRef}`, {
           maxResponseBytes: PROJECT_READ_RESPONSE_MAX_BYTES
         }), resolvedRef));
+      case "pause":
+        text = simple(await http.post(`/v1/projects/${resolvedRef}/pause`), `Project ${resolvedRef} paused`);
+        break;
+      case "restore":
+        text = simple(await http.post(`/v1/projects/${resolvedRef}/restore`), `Project ${resolvedRef} restored`);
+        break;
       case "health":
         text = ok(await http.get(`/v1/projects/${resolvedRef}/health`));
         break;
@@ -10540,7 +10549,7 @@ var redirectStatus = Type.Optional(Type.Union([
   Type.Literal(308)
 ]));
 var ok2 = (res) => res.ok ? JSON.stringify(res.data, null, 2) : `❌ Failed (${res.status}): ${JSON.stringify(res.data)}`;
-var simple = (res, msg) => res.ok ? `✅ ${msg}` : `❌ Failed (${res.status}): ${JSON.stringify(res.data)}`;
+var simple2 = (res, msg) => res.ok ? `✅ ${msg}` : `❌ Failed (${res.status}): ${JSON.stringify(res.data)}`;
 function registerGatewayTools(server, http, options = {}) {
   const { projectRef } = options;
   server.tool("gateway", `Gateway / Caddy 配置（通过 JSON Admin API 注入）。要求 admin 权限。
@@ -10802,11 +10811,11 @@ Actions: routes, upsert_route, update_route, delete_route, config, get_certifica
         break;
       case "set_custom_hostname": {
         need("custom_hostname", custom_hostname);
-        text = simple(await http.post(`/v1/projects/${projectRefValue}/custom-hostname`, { custom_hostname }), `Custom hostname ${custom_hostname} requested`);
+        text = simple2(await http.post(`/v1/projects/${projectRefValue}/custom-hostname`, { custom_hostname }), `Custom hostname ${custom_hostname} requested`);
         break;
       }
       case "delete_custom_hostname":
-        text = simple(await http.delete(`/v1/projects/${projectRefValue}/custom-hostname`), "Custom hostname removed");
+        text = simple2(await http.delete(`/v1/projects/${projectRefValue}/custom-hostname`), "Custom hostname removed");
         break;
       case "verify_custom_hostname":
         text = ok2(await http.post(`/v1/projects/${projectRefValue}/custom-hostname/verify`));
@@ -12450,7 +12459,7 @@ function registerReleaseTools(server, http, options = {}) {
 // package.json
 var package_default = {
   name: "@supacloud/cli",
-  version: "0.24.0",
+  version: "0.25.0",
   description: "Project-scoped CLI for SupaCloud users",
   type: "module",
   main: "./dist/index.js",
@@ -12494,6 +12503,8 @@ var commandName = "supacloud-cli";
 var preferredCommand = commandName;
 var projectActionSchema = stringEnum([
   "get",
+  "pause",
+  "restore",
   "health",
   "logs",
   "api_keys",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/cli",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Project-scoped CLI for SupaCloud users",
   "type": "module",
   "main": "./dist/index.js",