@supacloud/admin 0.16.0 → 0.17.0

package/dist/index.js

@@ -27733,6 +27733,16 @@ function shellArray(name, entries) {
 }
 function finishUpgradeFunction() {
   return [
+    "emit_wrapper_failure_receipt() {",
+    "  local code=$1 target_phase=${2:-${UPGRADE_PHASE:-}} phase",
+    `  if [ -n "\${LOG:-}" ] && ! grep -q '^SUPACLOUD_UPGRADE_FAILURE=' "$LOG" 2>/dev/null; then`,
+    '    case "$target_phase" in',
+    '      bootstrap|filesystem_checks|transfer_verification|verifier_setup|runner_preflight|runner_upgrade|cleanup|status_publish) phase="$target_phase" ;;',
+    '      *) phase="unknown" ;;',
+    "    esac",
+    `    printf 'SUPACLOUD_UPGRADE_FAILURE={"causes":["exit_code=%s","phase=%s"],"schema":"supacloud.upgrade-failure.v1","summary":"Remote upgrade execution failed during %s (exit code %s)"}\\n' "$code" "$phase" "$phase" "$code" >> "$LOG" || true`,
+    "  fi",
+    "}",
     "finish_upgrade() {",
     "  local code=$?",
     "  trap '' HUP INT TERM",
@@ -27740,15 +27750,27 @@ function finishUpgradeFunction() {
     "  set +e",
     '  if [ "$code" -ne 0 ]; then',
     '    write_status "FAILED:${code}:TRANSACTION" || true',
+    '    emit_wrapper_failure_receipt "$code"',
     '    if ! rm -rf -- "$STAGE"; then write_status "FAILED:${code}:TRANSACTION_AND_CLEANUP" || true; fi',
     '    exit "$code"',
     "  fi",
-    "  write_status CLEANING || { echo 'Unable to publish cleanup state' >&2; exit 1; }",
+    "  if ! write_status CLEANING; then",
+    "    echo 'Unable to publish cleanup state' >&2",
+    "    write_status 'FAILED:1:TRANSACTION' || true",
+    "    emit_wrapper_failure_receipt 1 status_publish",
+    `    if ! rm -rf -- "$STAGE"; then write_status 'FAILED:1:TRANSACTION_AND_CLEANUP' || true; fi`,
+    "    exit 1",
+    "  fi",
     '  if ! rm -rf -- "$STAGE"; then',
     "    write_status 'FAILED:1:CLEANUP_AFTER_TRANSACTION' || true",
+    "    emit_wrapper_failure_receipt 1 cleanup",
+    "    exit 1",
+    "  fi",
+    "  if ! write_status SUCCEEDED; then",
+    "    write_status 'FAILED:1:TRANSACTION' || true",
+    "    emit_wrapper_failure_receipt 1 status_publish",
     "    exit 1",
     "  fi",
-    "  write_status SUCCEEDED || exit 1",
     "  exit 0",
     "}"
   ].join(`
@@ -27768,6 +27790,7 @@ function upgradeScriptSetup(paths) {
     `BUNDLE=${quoteShell2(bundleDirectory)}`,
     `MANAGEMENT_DIR=${quoteShell2(`${bundleDirectory}/management-api`)}`,
     `EDGE_DIR=${quoteShell2(`${bundleDirectory}/edge-runtime`)}`,
+    "UPGRADE_PHASE=bootstrap",
     `write_status() { local next="\${STATUS}.next"; printf '%s\\n' "$1" > "$next"; chmod 600 "$next"; mv -f "$next" "$STATUS"; }`,
     finishUpgradeFunction(),
     "trap finish_upgrade EXIT",
@@ -27785,6 +27808,7 @@ function upgradeScriptFilesystemChecks(bundle) {
   const componentFiles = expectedComponentFiles(bundle);
   const stageEntries = ["bundle", "run.sh", ...bundle.verifierArchive ? ["verifier"] : []];
   const checks = [
+    "UPGRADE_PHASE=filesystem_checks",
     shellArray("MANAGEMENT_FILES", componentFiles.management),
     shellArray("EDGE_FILES", componentFiles.edge),
     `assert_directory() { local path=$1; test -d "$path" && test ! -L "$path"; test "$(stat -c '%u:%g' "$path")" = '0:0'; test "$(stat -c '%a' "$path")" = '700'; }`,
@@ -27812,6 +27836,7 @@ function upgradeScriptFilesystemChecks(bundle) {
 function upgradeScriptTransferVerification(bundle) {
   const files = [...bundle.files, ...bundle.verifierArchive ? [bundle.verifierArchive] : []];
   return [
+    "UPGRADE_PHASE=transfer_verification",
     `verify_transfer() { local relative=$1 expected_size=$2 expected_sha=$3; local path=$STAGE/$relative; test "$(stat -c '%s' "$path")" = "$expected_size"; test "$(sha256sum "$path" | awk '{print $1}')" = "$expected_sha"; }`,
     ...files.map((file) => `verify_transfer ${quoteShell2(file.relativePath)} ${file.size} ${quoteShell2(file.sha256)}`)
   ];
@@ -27824,6 +27849,7 @@ function upgradeScriptVerifier(paths, bundle, architecture) {
   ];
   const capabilityFlags = STRICT_GITHUB_CAPABILITY_FLAGS.join(" ");
   return [
+    "UPGRADE_PHASE=verifier_setup",
     ...setup,
     `GH_HELP=$(timeout 15s "$GH" attestation verify --help 2>&1) || { echo 'GitHub verifier capability check failed' >&2; exit 1; }`,
     `for flag in ${capabilityFlags}; do printf '%s\\n' "$GH_HELP" | grep -Eq -- "(^|[[:space:]])${"$"}{flag}([=[:space:]]|$)" || { echo "GitHub verifier lacks $flag" >&2; exit 1; }; done`,
@@ -27851,6 +27877,7 @@ function upgradeScriptExecution(paths, bundle, request) {
   const runner = `${paths.stage}/runner`;
   const preflight = 'CONTROL_PLANE_PREFLIGHT_RECEIPT=$(env PATH="$VERIFIER_PATH:$PATH" "$RUNNER" --control-plane-upgrade-preflight)';
   return [
+    "UPGRADE_PHASE=runner_preflight",
     `MANAGEMENT_VERSION=${quoteShell2(request.managementVersion)}`,
     `RUNNER_ASSET=${quoteShell2(runnerAsset)}`,
     `RUNNER=${quoteShell2(runner)}`,
@@ -27861,6 +27888,7 @@ function upgradeScriptExecution(paths, bundle, request) {
     `timeout 5s "$RUNNER" --systemd-unit-helper-sha256 | grep -Eq 'SupaCloud systemd-unit helper SHA-256: [0-9a-f]{64}'`,
     `timeout 5s "$RUNNER" --postgrest-launcher-sha256 | grep -Eq 'SupaCloud PostgREST launcher SHA-256: [0-9a-f]{64}'`,
     preflight,
+    "UPGRADE_PHASE=runner_upgrade",
     `env PATH="$VERIFIER_PATH:$PATH" "$RUNNER" upgrade --yes --target-version ${quoteShell2(request.managementVersion)} --edge-runtime-version ${quoteShell2(request.edgeRuntimeVersion)} --asset-bundle-dir "$BUNDLE"`,
     `printf '%s\\n' "$CONTROL_PLANE_PREFLIGHT_RECEIPT"`
   ];
@@ -31789,6 +31817,7 @@ Actions: routes, upsert_route, update_route, delete_route, config, get_certifica
     managed_upstream: optional(stringEnum(["edge-functions"]), "[upsert_route/update_route] 托管上游（同步 Edge Function）"),
     upstream_tls_insecure_skip_verify: optional(Type.Boolean(), "[upsert_route/update_route] 上游 TLS 跳过校验"),
     static_root: optional(Type.String(), "[upsert_route/update_route] 静态站点根目录"),
+    spa: optional(Type.Boolean(), "[upsert_route/update_route] 是否启用 SPA 单页回退"),
     protocol: optional(stringEnum(["http", "https"]), "[upsert_route/update_route] 可选请求协议匹配"),
     redirect_to: optional(Type.String(), "[upsert_route/update_route] 带固定 host 的绝对 http(s) 目标，可在末尾使用 {http.request.uri}"),
     redirect_status: withDescription(redirectStatus, "[upsert_route/update_route] 重定向状态码，默认 308"),
@@ -31835,6 +31864,7 @@ Actions: routes, upsert_route, update_route, delete_route, config, get_certifica
       managed_upstream,
       upstream_tls_insecure_skip_verify,
       static_root,
+      spa,
       protocol,
       redirect_to,
       redirect_status,
@@ -31884,6 +31914,8 @@ Actions: routes, upsert_route, update_route, delete_route, config, get_certifica
           body.upstream_tls_insecure_skip_verify = upstream_tls_insecure_skip_verify;
         if (static_root !== undefined)
           body.static_root = static_root;
+        if (spa !== undefined)
+          body.spa = spa;
         if (protocol !== undefined)
           body.protocol = protocol;
         if (redirect_to !== undefined)
@@ -31921,6 +31953,8 @@ Actions: routes, upsert_route, update_route, delete_route, config, get_certifica
           body.upstream_tls_insecure_skip_verify = upstream_tls_insecure_skip_verify;
         if (static_root !== undefined)
           body.static_root = static_root;
+        if (spa !== undefined)
+          body.spa = spa;
         if (protocol !== undefined)
           body.protocol = protocol;
         if (redirect_to !== undefined)
@@ -32514,7 +32548,7 @@ Actions: list_releases, get_release, upload_release, activate_release`, {
 // package.json
 var package_default = {
   name: "@supacloud/admin",
-  version: "0.16.0",
+  version: "0.17.0",
   description: "Platform administration CLI for SupaCloud operators",
   type: "module",
   main: "./dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/admin",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Platform administration CLI for SupaCloud operators",
   "type": "module",
   "main": "./dist/index.js",