tthr 0.3.20 → 0.3.21

package/dist/index.js

@@ -35,6 +35,42 @@ import ora from "ora";
 import fs from "fs-extra";
 import path from "path";
 import * as esbuild from "esbuild";
+async function describeHttpError(response, action) {
+  const status = response.status;
+  const contentType = response.headers.get("content-type") ?? "";
+  const text = await response.text().catch(() => "");
+  if (contentType.includes("application/json")) {
+    try {
+      const json = JSON.parse(text);
+      if (typeof json?.error === "string") return json.error;
+    } catch {
+    }
+  }
+  const looksLikeHtml = contentType.includes("text/html") || /^\s*<(!doctype|html)/i.test(text);
+  if (looksLikeHtml) {
+    const hint = (() => {
+      switch (status) {
+        case 401:
+        case 403:
+          return "Authentication failed or insufficient permissions. Try `tthr login` first.";
+        case 404:
+          return `Route or resource not found. Common causes: wrong project ID, environment doesn't exist on this server, or TETHER_API_URL points at the wrong host.`;
+        case 429:
+          return "Rate-limited by the server or upstream proxy. Wait a moment and retry.";
+        case 502:
+        case 503:
+        case 504:
+          return "Server is unreachable, restarting, or under load. Check status and retry.";
+        default:
+          return `Upstream proxy returned a generic ${status} page (likely a Cloudflare / nginx fallback).`;
+      }
+    })();
+    return `Failed to ${action}: ${hint} (HTTP ${status})`;
+  }
+  const trimmed = text.trim();
+  if (trimmed) return `${trimmed.slice(0, 300)}${trimmed.length > 300 ? "\u2026" : ""} (HTTP ${status})`;
+  return `HTTP ${status}: ${response.statusText || "request failed"}`;
+}
 async function deployCommand(options) {
   const credentials = await requireAuth();
   const configPath = path.resolve(process.cwd(), "tether.config.ts");
@@ -146,16 +182,7 @@ async function deploySchemaToServer(projectId, token, schemaPath, environment, d
     console.log(chalk.dim(`  Response: ${response.status} ${response.statusText}`));
     console.log(chalk.dim(`  Content-Type: ${response.headers.get("content-type")}`));
     if (!response.ok) {
-      const text = await response.text();
-      console.log(chalk.dim(`  Body: ${text.slice(0, 500)}`));
-      let errorMessage;
-      try {
-        const error = JSON.parse(text);
-        errorMessage = error.error || `HTTP ${response.status}`;
-      } catch {
-        errorMessage = text || `HTTP ${response.status}: ${response.statusText}`;
-      }
-      throw new Error(errorMessage);
+      throw new Error(await describeHttpError(response, "deploy schema"));
     }
     spinner.succeed(`Schema deployed (${tables.length} table(s))`);
   } catch (error) {
@@ -269,16 +296,7 @@ ${helperSource}`;
     console.log(chalk.dim(`  Response: ${response.status} ${response.statusText}`));
     console.log(chalk.dim(`  Content-Type: ${response.headers.get("content-type")}`));
     if (!response.ok) {
-      const text = await response.text();
-      console.log(chalk.dim(`  Body: ${text.slice(0, 500)}`));
-      let errorMessage;
-      try {
-        const error = JSON.parse(text);
-        errorMessage = error.error || `HTTP ${response.status}`;
-      } catch {
-        errorMessage = text || `HTTP ${response.status}: ${response.statusText}`;
-      }
-      throw new Error(errorMessage);
+      throw new Error(await describeHttpError(response, "deploy functions"));
     }
     spinner.succeed(`Functions deployed (${functions.length} function(s))`);
     const queries = functions.filter((f) => f.type === "query");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tthr",
-  "version": "0.3.20",
+  "version": "0.3.21",
   "description": "Tether CLI - project scaffolding and deployment",
   "type": "module",
   "bin": {