thumbnailgpt 1.0.6 → 1.0.8

package/README.md

@@ -15,14 +15,14 @@ Generate, iterate, download, and manage viral, high-CTR YouTube thumbnails direc
 
 ## Highlights
 
-- ⚡ **Zero-Install Execution**: Run any command immediately via `npx thumbnailgpt`.
-- 🎨 **Multi-Resolution Rendering**: Generate in standard **1K** (10 credits), HD **2K** (20 credits), or Ultra-HD **4K** (30 credits).
-- 📐 **Dual Aspect Ratios**: Native support for **16:9** (YouTube standard) and **9:16** (YouTube Shorts / TikTok / Reels).
-- 👤 **Creator Persona Consistency**: Feature your trained creator persona across any generation using `--persona <id>`.
-- 🔄 **Conversational Iteration**: Thread your edits using `--chat <chatId>` to refine text, lighting, facial expression, or background details.
-- 💬 **Interactive Terminal REPL**: Full interactive terminal chat session with live preview links (`thumbnailgpt chat`).
-- 🤖 **Scripting & Automation Ready**: Output raw image URLs with `--url-only` or machine-readable JSON with `--json` for shell pipes, webhooks, and GitHub Actions.
-- 🛡️ **Account Deletion Guardrails**: Enforces production security; destructive deletions are restricted to the web dashboard to prevent accidental loss from automated scripts or autonomous AI agents.
+- **Zero-Install Execution**: Run any command immediately via `npx thumbnailgpt`.
+- **Multi-Resolution Rendering**: Generate in standard **1K**, HD **2K**, or Ultra-HD **4K**.
+- **Dual Aspect Ratios**: Native support for **16:9** (YouTube standard) and **9:16** (YouTube Shorts / TikTok / Reels).
+- **Creator Persona Consistency**: Feature your trained creator persona across any generation using `--persona <id>`.
+- **Conversational Iteration**: Thread your edits using `--chat <chatId>` to refine text, lighting, facial expression, or background details.
+- **Interactive Terminal REPL**: Full interactive terminal chat session with live preview links (`thumbnailgpt chat`).
+- **Scripting & Automation Ready**: Output raw image URLs with `--url-only` or machine-readable JSON with `--json` for shell pipes, webhooks, and GitHub Actions.
+- **Account Deletion Guardrails**: Enforces production security; destructive deletions are restricted to the web dashboard to prevent accidental loss from automated scripts or autonomous AI agents.
 
 ---
 
@@ -62,20 +62,16 @@ npx thumbnailgpt login
 npx thumbnailgpt login --key tgpt_live_YOUR_API_KEY
 ```
 
-### 2. Verify Your Account & Credit Balance
+### 2. Verify Your Account Status
 ```bash
 npx thumbnailgpt whoami
 ```
 *Output:*
 ```text
-  Logged in as:       user@example.com
-  Subscription:       active
-  Available Credits:  583 credits
-
-  Pricing Tiers:
-    1K (Standard):    10 credits
-    2K (HD):          20 credits
-    4K (Ultra HD):    30 credits
+  ThumbnailGPT Account
+  Account:            user@example.com
+  Plan Status:        ACTIVE
+  Credits:            583 available
 ```
 
 ### 3. Generate a Thumbnail
@@ -84,7 +80,7 @@ npx thumbnailgpt generate "Extreme 100 Days Hardcore Survival in Minecraft" --re
 ```
 *Output:*
 ```text
-✔ Generation complete! (14s)
+Generation complete (14s)
 
   Thumbnail URL: https://assets.thumbnailgpt.com/generations/.../thumbnail.png
   Chat Thread:   https://thumbnailgpt.com/studio/3c9d1e5f-...
@@ -109,7 +105,7 @@ npx thumbnailgpt generate [options] <prompt>
 | Flag | Short | Default | Description |
 | :--- | :---: | :---: | :--- |
 | `--ratio <ratio>` | `-r` | `16:9` | Aspect ratio: `16:9` (YouTube standard) or `9:16` (Shorts / Reels) |
-| `--res <resolution>` | `-q` | `1K` | Resolution quality: `1K` (10 credits), `2K` (20 credits), or `4K` (30 credits) |
+| `--res <resolution>` | `-q` | `1K` | Resolution quality: `1K`, `2K`, or `4K` |
 | `--ref <urls...>` | | | Up to 5 public image URLs or base64 data URIs as visual references |
 | `--yt <url>` | | | YouTube video URL to extract title, context, and current thumbnail |
 | `--persona <personaId>` | `-p` | | Creator Persona UUID to feature in the generated thumbnail |
@@ -172,10 +168,9 @@ npx thumbnailgpt chat 3c9d1e5f-c648-4b3c-a6f0-811d073c22c2
 ```
 
 Commands available inside interactive chat mode:
-- Type your prompt prompt to iterate.
+- Type your prompt to iterate.
 - `/url` — Display the latest generated thumbnail URL.
 - `/open` — Open the current thumbnail in your default web browser.
-- `/cost` — View credit cost tiers.
 - `/help` — Display interactive mode shortcuts.
 - `/exit` or `exit` — Exit interactive session.
 
@@ -183,7 +178,7 @@ Commands available inside interactive chat mode:
 
 ### `thumbnailgpt whoami`
 
-Display your authenticated email, subscription tier, available credit balance, and generation pricing tiers.
+Display your authenticated email, subscription status, and available balance.
 
 ```bash
 npx thumbnailgpt whoami
@@ -304,17 +299,17 @@ Now you can instruct Claude or Cursor:
 
 To prevent accidental data loss or unauthorized bulk deletions by third-party scripts and autonomous AI agents:
 - Destructive deletions (`DELETE` operations) are disabled over Personal API Keys, the CLI, and the MCP server.
-- Resource creation, iteration, credit checks, persona styling, and asset retrievals are fully enabled.
+- Resource creation, iteration, account balance checks, persona styling, and asset retrievals are fully enabled.
 - Deletions can be performed safely by the account owner inside the **[ThumbnailGPT Web Studio](https://thumbnailgpt.com/studio)**.
 
 ---
 
 ## Support & Resources
 
-- 🌐 **Web Studio**: [https://thumbnailgpt.com](https://thumbnailgpt.com)
-- 📖 **API & CLI Docs**: [https://thumbnailgpt.com/docs](https://thumbnailgpt.com/docs)
-- 🔑 **API Key Management**: [https://thumbnailgpt.com/studio?settings=api-key](https://thumbnailgpt.com/studio?settings=api-key)
-- 💬 **Support Email**: [support@thumbnailgpt.com](mailto:support@thumbnailgpt.com)
+- Web Studio: [https://thumbnailgpt.com](https://thumbnailgpt.com)
+- API & CLI Docs: [https://thumbnailgpt.com/docs](https://thumbnailgpt.com/docs)
+- API Key Management: [https://thumbnailgpt.com/studio?settings=api-key](https://thumbnailgpt.com/studio?settings=api-key)
+- Support Email: [support@thumbnailgpt.com](mailto:support@thumbnailgpt.com)
 
 ---
 

package/dist/client.js

@@ -17,7 +17,7 @@ export class ThumbnailGPTClient {
             "Content-Type": "application/json",
             Authorization: `Bearer ${this.apiKey}`,
             Origin: this.apiUrl,
-            "User-Agent": "thumbnailgpt-cli/1.0.6",
+            "User-Agent": "thumbnailgpt-cli/1.0.8",
             ...options.headers,
         };
         const res = await fetch(url, { ...options, headers });

package/dist/index.js

@@ -4,11 +4,58 @@ import ora from "ora";
 import pc from "picocolors";
 import { setApiKey, clearApiKey, setApiUrl } from "./config.js";
 import { ThumbnailGPTClient } from "./client.js";
+/**
+ * Safely handle errors in CLI commands without crashing libuv timers or exposing internal server details
+ */
+function handleError(err, spinner) {
+    if (spinner) {
+        try {
+            spinner.stop();
+        }
+        catch { }
+    }
+    const rawMsg = String(err?.message || err || "").trim();
+    const status = Number(err?.status || 0);
+    let friendlyMessage = rawMsg;
+    // Mask database, internal, or raw HTML errors
+    if (status === 401 ||
+        rawMsg.toLowerCase().includes("api key") ||
+        rawMsg.toLowerCase().includes("unauthorized") ||
+        rawMsg.toLowerCase().includes("revoked")) {
+        friendlyMessage = "Authentication failed: Invalid, expired, or revoked API key. Please run 'thumbnailgpt login' to update your key.";
+    }
+    else if (status === 403 || rawMsg.toLowerCase().includes("forbidden")) {
+        friendlyMessage = "Access restricted: You do not have permission to access this resource.";
+    }
+    else if (status === 429 ||
+        rawMsg.toLowerCase().includes("rate limit") ||
+        rawMsg.toLowerCase().includes("too many requests")) {
+        friendlyMessage = "Request rate limit reached. Please wait a moment before trying again.";
+    }
+    else if (status >= 500 ||
+        rawMsg.toLowerCase().includes("internal server error") ||
+        rawMsg.toLowerCase().includes("service unavailable")) {
+        friendlyMessage = "ThumbnailGPT services are temporarily busy. Please try again in a few moments.";
+    }
+    else if (rawMsg.includes("ECONNREFUSED") ||
+        rawMsg.includes("ENOTFOUND") ||
+        rawMsg.includes("fetch failed")) {
+        friendlyMessage = "Unable to connect to ThumbnailGPT. Please check your internet connection.";
+    }
+    else if (rawMsg.includes("<!DOCTYPE") ||
+        rawMsg.includes("<html") ||
+        rawMsg.includes("SQL") ||
+        rawMsg.includes("Postgres")) {
+        friendlyMessage = "An unexpected error occurred. Please try again or visit https://thumbnailgpt.com for status updates.";
+    }
+    console.error(pc.red(`\nError: ${friendlyMessage}\n`));
+    process.exitCode = 1;
+}
 const program = new Command();
 program
     .name("thumbnailgpt")
     .description("Official CLI for ThumbnailGPT — Generate, iterate, and manage thumbnails from your terminal")
-    .version("1.0.6");
+    .version("1.0.8");
 // 1. Auth Login
 program
     .command("login")
@@ -54,19 +101,21 @@ program
     .command("whoami")
     .description("Display your account and available credit balance")
     .action(async () => {
+    let spinner = null;
     try {
         const client = new ThumbnailGPTClient();
-        const spinner = ora("Fetching account details...").start();
+        spinner = ora("Fetching account details...").start();
         const credits = await client.getCredits();
         spinner.stop();
         console.log(pc.bold("\nThumbnailGPT Account"));
+        if (credits.email) {
+            console.log(`${pc.gray("Account:")}      ${pc.white(pc.bold(credits.email))}`);
+        }
         console.log(`${pc.gray("Plan Status:")}  ${pc.cyan(credits.subscription_status.toUpperCase())}`);
-        console.log(`${pc.gray("Credits:")}      ${pc.green(pc.bold(String(credits.credits)))} available`);
-        console.log(`${pc.gray("Cost Tiers:")}  1K = 10 cr | 2K = 20 cr | 4K = 30 cr\n`);
+        console.log(`${pc.gray("Credits:")}      ${pc.green(pc.bold(String(credits.credits)))} available\n`);
     }
     catch (err) {
-        console.error(pc.red(`\nError: ${err.message}`));
-        process.exit(1);
+        handleError(err, spinner);
     }
 });
 // 4. One-shot Generate
@@ -83,6 +132,7 @@ program
     .option("--json", "Output response as raw JSON")
     .option("--async", "Dispatch job and return immediately without waiting")
     .action(async (prompt, options) => {
+    let spinner = null;
     try {
         if (options.ref && options.ref.length > 5) {
             console.error(pc.red("\nError: A maximum of 5 reference images is allowed."));
@@ -95,12 +145,12 @@ program
         }
         const res = (options.res || "1K").toUpperCase().trim();
         if (res !== "1K" && res !== "2K" && res !== "4K") {
-            console.error(pc.red(`\nError: Invalid resolution "${res}". Supported resolutions: 1K (10 credits), 2K (20 credits), 4K (30 credits)`));
+            console.error(pc.red(`\nError: Invalid resolution "${res}". Supported resolutions: 1K, 2K, 4K`));
             process.exit(1);
         }
         const client = new ThumbnailGPTClient();
         if (options.async) {
-            const spinner = !options.json && !options.urlOnly ? ora("Dispatching to ThumbnailGPT...").start() : null;
+            spinner = !options.json && !options.urlOnly ? ora("Dispatching to ThumbnailGPT...").start() : null;
             const dispatch = await client.dispatchStudio({
                 prompt,
                 chatId: options.chat,
@@ -121,7 +171,7 @@ program
             console.log(`Check status with: ${pc.cyan(`thumbnailgpt chats show ${dispatch.chatId}`)}\n`);
             return;
         }
-        const spinner = !options.json && !options.urlOnly ? ora("Validating credits & dispatching...").start() : null;
+        spinner = !options.json && !options.urlOnly ? ora("Validating credits & dispatching...").start() : null;
         const result = await client.generateAndWait({
             prompt,
             chatId: options.chat,
@@ -167,8 +217,7 @@ program
         console.log(`${pc.bold("Web App:")}          https://thumbnailgpt.com/studio/${result.chatId}\n`);
     }
     catch (err) {
-        console.error(pc.red(`\nError: ${err.message}`));
-        process.exit(1);
+        handleError(err, spinner);
     }
 });
 // 5. Interactive Chat REPL
@@ -230,8 +279,7 @@ program
         askPrompt();
     }
     catch (err) {
-        console.error(pc.red(`\nError: ${err.message}`));
-        process.exit(1);
+        handleError(err);
     }
 });
 // 6. Chats Subcommand
@@ -240,9 +288,10 @@ chats
     .command("list")
     .description("List recent chat conversations")
     .action(async () => {
+    let spinner = null;
     try {
         const client = new ThumbnailGPTClient();
-        const spinner = ora("Fetching conversations...").start();
+        spinner = ora("Fetching conversations...").start();
         const res = await client.listChats();
         spinner.stop();
         const chatList = res.chats || [];
@@ -258,17 +307,17 @@ chats
         console.log();
     }
     catch (err) {
-        console.error(pc.red(`\nError: ${err.message}`));
-        process.exit(1);
+        handleError(err, spinner);
     }
 });
 chats
     .command("show <chatId>")
     .description("View conversation history and thumbnails")
     .action(async (chatId) => {
+    let spinner = null;
     try {
         const client = new ThumbnailGPTClient();
-        const spinner = ora("Fetching thread...").start();
+        spinner = ora("Fetching thread...").start();
         const res = await client.getChat(chatId);
         spinner.stop();
         console.log(pc.bold(`\nThread: ${res.chat?.title || chatId}\n`));
@@ -285,8 +334,7 @@ chats
         console.log();
     }
     catch (err) {
-        console.error(pc.red(`\nError: ${err.message}`));
-        process.exit(1);
+        handleError(err, spinner);
     }
 });
 chats
@@ -304,9 +352,10 @@ thumbnailsCmd
     .command("get <thumbnailId>")
     .description("Get detailed information about a thumbnail by ID")
     .action(async (thumbnailId) => {
+    let spinner = null;
     try {
         const client = new ThumbnailGPTClient();
-        const spinner = ora("Fetching thumbnail details...").start();
+        spinner = ora("Fetching thumbnail details...").start();
         const thumb = await client.getThumbnail(thumbnailId);
         spinner.stop();
         console.log(pc.bold("\nThumbnail Details:"));
@@ -329,8 +378,7 @@ thumbnailsCmd
         console.log(pc.dim("--------------------------------------------------------------------------------\n"));
     }
     catch (err) {
-        console.error(pc.red(`\nError: ${err.message}`));
-        process.exit(1);
+        handleError(err, spinner);
     }
 });
 thumbnailsCmd
@@ -342,13 +390,13 @@ thumbnailsCmd
         const thumb = await client.getThumbnail(thumbnailId);
         if (!thumb.thumbnail_url) {
             console.error(pc.yellow(`Thumbnail is not ready yet (status: ${thumb.status || "processing"})`));
-            process.exit(1);
+            process.exitCode = 1;
+            return;
         }
         console.log(thumb.thumbnail_url);
     }
     catch (err) {
-        console.error(pc.red(`\nError: ${err.message}`));
-        process.exit(1);
+        handleError(err);
     }
 });
 thumbnailsCmd
@@ -366,9 +414,10 @@ personasCmd
     .command("list")
     .description("List your active creator personas (only ready personas are shown)")
     .action(async () => {
+    let spinner = null;
     try {
         const client = new ThumbnailGPTClient();
-        const spinner = ora("Fetching active personas...").start();
+        spinner = ora("Fetching active personas...").start();
         const personas = await client.getPersonas();
         spinner.stop();
         if (personas.length === 0) {
@@ -386,8 +435,7 @@ personasCmd
         console.log(`Use in generation: ${pc.green('npx thumbnailgpt generate "..." --persona <id>')}\n`);
     }
     catch (err) {
-        console.error(pc.red(`\nError: ${err.message}`));
-        process.exit(1);
+        handleError(err, spinner);
     }
 });
 personasCmd

package/dist/types.d.ts

@@ -22,6 +22,7 @@ export interface StudioDispatchResult {
     availableCredits?: number;
 }
 export interface CreditBalanceResponse {
+    email?: string;
     credits: number;
     subscription_status: string;
     error?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thumbnailgpt",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Official CLI for ThumbnailGPT — Generate, iterate, and manage viral YouTube thumbnails directly from your terminal",
   "type": "module",
   "main": "dist/index.js",