@hintoai/cli 0.3.5 → 0.5.0

package/README.md

@@ -368,6 +368,8 @@ When an error occurs with `--json`, stdout is always empty and the error message
 
 Commands that start background jobs — `generate start`, `publish now`, `publish republish`, `project retranslate` — default to fire-and-forget: they print the job metadata and return exit 0 immediately. Pass `--wait` to poll until the job completes (or fails) and print its output.
 
+`hinto videos upload` also supports `--wait`: blocks until the uploaded video finishes server-side processing and reaches `ready` status (polls every 3s, 10 min timeout). Without `--wait`, the upload returns immediately with the `videoId` but the video may still be processing.
+
 ## Environment variables
 
 | Variable | Description |

package/dist/api/articles.d.ts

@@ -62,6 +62,7 @@ export declare const articlesApi: (client: AxiosInstance) => {
     update: (id: string, body: {
         title?: string;
         slug?: string;
+        content?: string;
         metaDescription?: string;
         metaKeywords?: string[];
     }) => Promise<ArticleDetail>;

package/dist/commands/articles.js

@@ -110,18 +110,24 @@ function registerArticles(program, client) {
         .description('Update an article')
         .option('--title <title>', 'New title')
         .option('--slug <slug>', 'New slug')
+        .option('--content <content>', 'New Markdown content (string or @filepath) — replaces the body')
         .option('--meta-description <text>', 'SEO meta description')
         .option('--meta-keywords <keywords>', 'Comma-separated SEO keywords')
         .option('--json', 'Output as JSON')
         .action(async (id, opts) => {
         try {
-            if (!opts.title && !opts.slug && !opts.metaDescription && !opts.metaKeywords) {
-                (0, errors_1.exitWithError)('Provide at least one field to update: --title, --slug, --meta-description, or --meta-keywords');
+            if (!opts.title &&
+                !opts.slug &&
+                !opts.content &&
+                !opts.metaDescription &&
+                !opts.metaKeywords) {
+                (0, errors_1.exitWithError)('Provide at least one field to update: --title, --slug, --content, --meta-description, or --meta-keywords');
                 return;
             }
             const data = await api.update(id, {
                 ...(opts.title !== undefined && { title: opts.title }),
                 ...(opts.slug !== undefined && { slug: opts.slug }),
+                ...(opts.content !== undefined && { content: resolveContent(opts.content) }),
                 ...(opts.metaDescription !== undefined && { metaDescription: opts.metaDescription }),
                 ...(opts.metaKeywords !== undefined && {
                     metaKeywords: opts.metaKeywords

package/dist/commands/videos.js

@@ -43,6 +43,7 @@ const path = __importStar(require("path"));
 const videos_1 = require("../api/videos");
 const errors_1 = require("../errors");
 const output_1 = require("../output");
+const poll_1 = require("../poll");
 function registerVideos(program, client) {
     const videos = program.command('videos').description('Manage videos');
     const api = (0, videos_1.videosApi)(client);
@@ -131,6 +132,7 @@ function registerVideos(program, client) {
         .command('upload')
         .description('Upload a video file from disk (3-step presigned flow)')
         .requiredOption('--file <path>', 'Path to the video file')
+        .option('--wait', 'Wait until the video is ready for generation')
         .option('--json', 'Output as JSON')
         .action(async (opts) => {
         try {
@@ -164,10 +166,14 @@ function registerVideos(program, client) {
             // Step 3: complete upload
             process.stderr.write('Completing upload...\n');
             const result = await api.uploadComplete(videoId, s3Key, filename);
+            if (opts.wait) {
+                await (0, poll_1.pollVideoReady)(client, result.videoId);
+            }
             if (opts.json)
                 return (0, output_1.printJson)(result);
-            process.stdout.write(`Uploaded: videoId=${result.videoId}  status=pending\n`);
-            process.stdout.write(`Track: hinto videos status ${result.videoId}\n`);
+            process.stdout.write(`Uploaded: videoId=${result.videoId}  status=${opts.wait ? 'ready' : 'pending'}\n`);
+            if (!opts.wait)
+                process.stdout.write(`Track: hinto videos status ${result.videoId}\n`);
         }
         catch (e) {
             (0, errors_1.exitWithError)(e instanceof Error ? e.message : String(e));

package/dist/poll.d.ts

@@ -1,2 +1,3 @@
 import type { AxiosInstance } from 'axios';
 export declare function pollJob(client: AxiosInstance, jobId: string, intervalMs?: number, timeoutMs?: number): Promise<unknown>;
+export declare function pollVideoReady(client: AxiosInstance, videoId: string, intervalMs?: number, timeoutMs?: number): Promise<void>;

package/dist/poll.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pollJob = pollJob;
+exports.pollVideoReady = pollVideoReady;
 async function pollJob(client, jobId, intervalMs = 2000, timeoutMs = 300000) {
     process.stderr.write(`Waiting for job ${jobId}…\n`);
     const deadline = Date.now() + timeoutMs;
@@ -18,6 +19,22 @@ async function pollJob(client, jobId, intervalMs = 2000, timeoutMs = 300000) {
     }
     throw new Error(`Job ${jobId} timed out after ${timeoutMs / 1000}s`);
 }
+async function pollVideoReady(client, videoId, intervalMs = 3000, timeoutMs = 600000) {
+    process.stderr.write(`Waiting for video ${videoId} to be ready…\n`);
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const { data } = await client.get(`/videos/${videoId}/status`);
+        if (data.status === 'ready') {
+            process.stderr.write(`Video ${videoId} ready\n`);
+            return;
+        }
+        if (data.status === 'failed') {
+            throw new Error(`Video ${videoId} processing failed`);
+        }
+        await sleep(intervalMs);
+    }
+    throw new Error(`Video ${videoId} timed out after ${timeoutMs / 1000}s`);
+}
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hintoai/cli",
-  "version": "0.3.5",
+  "version": "0.5.0",
   "description": "Hinto AI CLI — manage videos, articles, and publishing via the Hinto API",
   "main": "dist/index.js",
   "bin": {