thumbnailgpt 1.0.8 → 1.0.9

package/dist/client.d.ts

@@ -1,15 +1,15 @@
-import type { CreditBalanceResponse, StudioGenerateOptions, StudioDispatchResult, StudioConversationResponse, GenerationSettledResult, PersonaItem, ThumbnailItem } from "./types.js";
+import type { CreditBalanceResponse, StudioGenerateOptions, StudioDispatchResult, StudioConversationResponse, GenerationSettledResult, PersonaItem, ThumbnailItem, ListChatsResponse, ListPersonasResponse } from "./types.js";
 export declare class ThumbnailGPTClient {
     private apiKey;
     private apiUrl;
     constructor(apiKey?: string, apiUrl?: string);
     private request;
     /**
-     * Check current user credit balance and plan status
+     * Fetch current credit balance and subscription status
      */
     getCredits(): Promise<CreditBalanceResponse>;
     /**
-     * Dispatch a studio generation job
+     * Dispatch studio thumbnail generation task
      */
     dispatchStudio(options: StudioGenerateOptions): Promise<StudioDispatchResult>;
     /**
@@ -17,13 +17,21 @@ export declare class ThumbnailGPTClient {
      */
     getChat(chatId: string): Promise<StudioConversationResponse>;
     /**
-     * List recent studio conversations
+     * List recent studio conversations with pagination
      */
-    listChats(): Promise<any>;
+    listChats(options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ListChatsResponse>;
     /**
-     * Retrieve active, ready-to-use personas for the user.
-     * Only 'ready' personas are returned. Raw image URLs, character sheets,
-     * error traces, and database internals are strictly redacted.
+     * Retrieve active, ready-to-use personas for the user with pagination
+     */
+    listPersonas(options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ListPersonasResponse>;
+    /**
+     * Retrieve active, ready-to-use personas (returns array for backward compatibility)
      */
     getPersonas(): Promise<PersonaItem[]>;
     /**

package/dist/client.js

@@ -14,74 +14,51 @@ export class ThumbnailGPTClient {
     async request(endpoint, options = {}) {
         const url = `${this.apiUrl}${endpoint.startsWith("/") ? "" : "/"}${endpoint}`;
         const headers = {
-            "Content-Type": "application/json",
             Authorization: `Bearer ${this.apiKey}`,
-            Origin: this.apiUrl,
-            "User-Agent": "thumbnailgpt-cli/1.0.8",
+            "Content-Type": "application/json",
             ...options.headers,
         };
-        const res = await fetch(url, { ...options, headers });
-        const data = (await res.json().catch(() => ({})));
+        let res;
+        try {
+            res = await fetch(url, { ...options, headers });
+        }
+        catch (netErr) {
+            throw new Error(`Failed to reach ThumbnailGPT backend at ${this.apiUrl}: ${netErr.message}`);
+        }
         if (!res.ok) {
-            const errorMsg = data.error ||
-                data.message ||
-                `Request failed with status ${res.status}: ${res.statusText}`;
-            const err = new Error(errorMsg);
-            err.status = res.status;
-            err.data = data;
-            throw err;
+            let errMsg = `Request failed (${res.status} ${res.statusText})`;
+            try {
+                const errorJson = await res.json();
+                errMsg = errorJson.error || errorJson.message || errMsg;
+            }
+            catch {
+                // Fallback to text status
+            }
+            throw new Error(errMsg);
         }
-        return data;
+        return res.json();
     }
     /**
-     * Check current user credit balance and plan status
+     * Fetch current credit balance and subscription status
      */
     async getCredits() {
         return this.request("/api/credits/balance");
     }
     /**
-     * Dispatch a studio generation job
+     * Dispatch studio thumbnail generation task
      */
     async dispatchStudio(options) {
-        if (options.referenceImages && options.referenceImages.length > 5) {
-            throw new Error("A maximum of 5 reference images is allowed.");
-        }
-        const rawRefImages = (options.referenceImages || []).slice(0, 5);
-        const processedRefImages = [];
-        for (const img of rawRefImages) {
-            if (typeof img === "string") {
-                if (img.startsWith("http://") || img.startsWith("https://") || img.startsWith("data:")) {
-                    processedRefImages.push(img);
-                }
-                else if (fs.existsSync(img)) {
-                    const ext = path.extname(img).toLowerCase().replace(".", "");
-                    const mimeType = ext === "jpg" || ext === "jpeg"
-                        ? "image/jpeg"
-                        : ext === "png"
-                            ? "image/png"
-                            : ext === "webp"
-                                ? "image/webp"
-                                : "image/jpeg";
-                    const buffer = fs.readFileSync(img);
-                    const base64 = buffer.toString("base64");
-                    processedRefImages.push(`data:${mimeType};base64,${base64}`);
-                }
-                else {
-                    processedRefImages.push(img);
-                }
-            }
-        }
         return this.request("/api/studio", {
             method: "POST",
             body: JSON.stringify({
-                chatId: options.chatId,
                 feature: "recreate_thumbnail",
                 prompt: options.prompt,
+                chatId: options.chatId,
                 aspectRatio: options.aspectRatio || "16:9",
                 resolution: options.resolution || "1K",
-                referenceImages: processedRefImages,
-                youtubeUrl: options.youtubeUrl || undefined,
-                personaId: options.personaId || undefined,
+                referenceImages: options.referenceImages || [],
+                youtubeUrl: options.youtubeUrl,
+                personaId: options.personaId,
                 baseImage: options.baseImage,
             }),
         });
@@ -93,23 +70,36 @@ export class ThumbnailGPTClient {
         return this.request(`/api/studio/${chatId}`);
     }
     /**
-     * List recent studio conversations
+     * List recent studio conversations with pagination
      */
-    async listChats() {
-        return this.request("/api/studio");
+    async listChats(options) {
+        const page = Math.max(1, options?.page ?? 1);
+        const limit = Math.min(100, Math.max(1, options?.limit ?? 20));
+        return this.request(`/api/studio?page=${page}&limit=${limit}`);
+    }
+    /**
+     * Retrieve active, ready-to-use personas for the user with pagination
+     */
+    async listPersonas(options) {
+        const page = Math.max(1, options?.page ?? 1);
+        const limit = Math.min(50, Math.max(1, options?.limit ?? 20));
+        const res = await this.request(`/api/personas?page=${page}&limit=${limit}`);
+        return {
+            success: res.success ?? true,
+            personas: (res.personas || []).map((p) => ({
+                id: p.id,
+                name: p.name,
+                created_at: p.created_at,
+            })),
+            pagination: res.pagination,
+        };
     }
     /**
-     * Retrieve active, ready-to-use personas for the user.
-     * Only 'ready' personas are returned. Raw image URLs, character sheets,
-     * error traces, and database internals are strictly redacted.
+     * Retrieve active, ready-to-use personas (returns array for backward compatibility)
      */
     async getPersonas() {
-        const res = await this.request("/api/personas");
-        return (res.personas || []).map((p) => ({
-            id: p.id,
-            name: p.name,
-            created_at: p.created_at,
-        }));
+        const res = await this.listPersonas({ page: 1, limit: 50 });
+        return res.personas;
     }
     /**
      * Asynchronously dispatch and poll until completion
@@ -117,8 +107,8 @@ export class ThumbnailGPTClient {
     async generateAndWait(options, onProgress, timeoutSec = 120) {
         // 1. Credit Pre-check
         const credits = await this.getCredits();
-        const resolutionCosts = { "1K": 10, "2K": 20, "4K": 30 };
-        const required = resolutionCosts[options.resolution || "1K"] || 10;
+        const resolutionCosts = { "1K": 20, "2K": 30, "4K": 40 };
+        const required = resolutionCosts[options.resolution || "1K"] || 20;
         if (credits.credits < required) {
             throw new Error(`Insufficient credits. Required: ${required}, Available: ${credits.credits}. Top up at https://thumbnailgpt.com/pricing`);
         }

package/dist/index.js

@@ -55,7 +55,7 @@ const program = new Command();
 program
     .name("thumbnailgpt")
     .description("Official CLI for ThumbnailGPT — Generate, iterate, and manage thumbnails from your terminal")
-    .version("1.0.8");
+    .version("1.0.9");
 // 1. Auth Login
 program
     .command("login")
@@ -286,14 +286,25 @@ program
 const chats = program.command("chats").description("Manage chat conversations");
 chats
     .command("list")
-    .description("List recent chat conversations")
-    .action(async () => {
+    .description("List recent chat conversations with pagination")
+    .option("-p, --page <number>", "Page number", "1")
+    .option("-l, --limit <number>", "Items per page (max 100)", "20")
+    .option("--json", "Output response as raw JSON", false)
+    .action(async (opts) => {
     let spinner = null;
     try {
+        const page = Math.max(1, parseInt(opts.page, 10) || 1);
+        const limit = Math.min(100, Math.max(1, parseInt(opts.limit, 10) || 20));
+        if (!opts.json) {
+            spinner = ora("Fetching conversations...").start();
+        }
         const client = new ThumbnailGPTClient();
-        spinner = ora("Fetching conversations...").start();
-        const res = await client.listChats();
-        spinner.stop();
+        const res = await client.listChats({ page, limit });
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        spinner?.stop();
         const chatList = res.chats || [];
         if (chatList.length === 0) {
             console.log(pc.gray("No conversations found."));
@@ -304,6 +315,10 @@ chats
             console.log(`• ${pc.bold(c.title || "Untitled")} ${pc.gray(`(${c.id})`)}`);
             console.log(`  ${pc.gray("Updated:")} ${new Date(c.updated_at).toLocaleString()}`);
         });
+        if (res.pagination) {
+            const { page: currPage, totalPages, total, hasMore } = res.pagination;
+            console.log(pc.dim(`\nPage ${currPage} of ${totalPages} (${total} total conversations)${hasMore ? ` • Run with --page ${currPage + 1} to view more` : ""}`));
+        }
         console.log();
     }
     catch (err) {
@@ -412,14 +427,26 @@ const personasCmd = program
     .description("Inspect active creator personas for thumbnail generation");
 personasCmd
     .command("list")
-    .description("List your active creator personas (only ready personas are shown)")
-    .action(async () => {
+    .description("List your active creator personas with pagination (only ready personas are shown)")
+    .option("-p, --page <number>", "Page number", "1")
+    .option("-l, --limit <number>", "Items per page (max 50)", "20")
+    .option("--json", "Output response as raw JSON", false)
+    .action(async (opts) => {
     let spinner = null;
     try {
+        const page = Math.max(1, parseInt(opts.page, 10) || 1);
+        const limit = Math.min(50, Math.max(1, parseInt(opts.limit, 10) || 20));
+        if (!opts.json) {
+            spinner = ora("Fetching active personas...").start();
+        }
         const client = new ThumbnailGPTClient();
-        spinner = ora("Fetching active personas...").start();
-        const personas = await client.getPersonas();
-        spinner.stop();
+        const res = await client.listPersonas({ page, limit });
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        spinner?.stop();
+        const personas = res.personas || [];
         if (personas.length === 0) {
             console.log(pc.yellow("\nNo active personas found."));
             console.log(`Create your first persona in ThumbnailGPT at: ${pc.cyan("https://thumbnailgpt.com/studio")}\n`);
@@ -432,6 +459,10 @@ personasCmd
             console.log(`${pc.cyan(p.id)}  ${pc.bold(p.name)}  ${dateStr}`);
         });
         console.log(pc.dim("--------------------------------------------------------------------------------"));
+        if (res.pagination) {
+            const { page: currPage, totalPages, total, hasMore } = res.pagination;
+            console.log(pc.dim(`Page ${currPage} of ${totalPages} (${total} total personas)${hasMore ? ` • Run with --page ${currPage + 1} to view more` : ""}\n`));
+        }
         console.log(`Use in generation: ${pc.green('npx thumbnailgpt generate "..." --persona <id>')}\n`);
     }
     catch (err) {

package/dist/types.d.ts

@@ -73,3 +73,28 @@ export interface PersonaItem {
     name: string;
     created_at?: string;
 }
+export interface PaginationMetadata {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasMore: boolean;
+}
+export interface ListChatsResponse {
+    success: boolean;
+    chats: Array<{
+        id: string;
+        title: string;
+        created_at: string;
+        updated_at: string;
+        thumbnails?: ThumbnailItem[];
+    }>;
+    pagination?: PaginationMetadata;
+    error?: string;
+}
+export interface ListPersonasResponse {
+    success: boolean;
+    personas: PersonaItem[];
+    pagination?: PaginationMetadata;
+    error?: string;
+}

package/package.json

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