clipugc 0.2.0

package/dist/commands/images.js

@@ -0,0 +1,257 @@
+import { logger } from '../utils/logger.js';
+import { isJsonMode, printJson, printTable, formatStatus } from '../utils/output.js';
+import { confirm } from '../utils/prompt.js';
+import { AbortedError, ValidationError } from '../utils/errors.js';
+import { waitForCompletion } from '../utils/poll.js';
+import { DEFAULT_RESOLUTION, RESOLUTIONS, SHOT_TYPES, TEMPLATES, checkImageStatus, createVariation, deleteImage, downloadImage, findImageUrl, generateImages, getImage, listImages, retryImage, } from '../services/images.service.js';
+function parseIntStrict(value, label) {
+    const n = Number(value);
+    if (!Number.isInteger(n)) {
+        throw new ValidationError(`${label} must be an integer (got "${value}").`);
+    }
+    return n;
+}
+/** Poll a set of image ids until each completes; returns the final payloads. */
+async function waitForImages(images, quiet) {
+    const finals = [];
+    for (const image of images) {
+        const final = await waitForCompletion(() => checkImageStatus(String(image.id)), {
+            label: `Generating look ${image.id}`,
+            quiet,
+        });
+        finals.push(final);
+    }
+    return finals;
+}
+function printFinalStatuses(images, finals) {
+    finals.forEach((final, i) => {
+        const id = images[i]?.id;
+        const url = findImageUrl(final);
+        logger.kv(`Look ${id}`, formatStatus(String(final.status)) + (url ? `  ${url}` : ''));
+    });
+}
+/** Register the `clipugc images` command group (character looks). */
+export function registerImagesCommands(program) {
+    const images = program
+        .command('images')
+        .description('Manage character looks (reference images)');
+    images
+        .command('generate')
+        .description('Generate look(s) for a character')
+        .requiredOption('--character <id>', 'Character id')
+        .option('--shots <list>', `Comma-separated shot types: ${SHOT_TYPES.join(', ')}`, 'frontal')
+        .option('--template <template>', `Template: ${TEMPLATES.join(', ')}`)
+        .option('--scene <prompt>', 'Scene prompt (max 600 characters)')
+        .option('--resolution <res>', `Resolution: ${RESOLUTIONS.join(', ')}`, DEFAULT_RESOLUTION)
+        .option('--wait', 'Poll until generation completes')
+        .action(async (options, cmd) => {
+        const json = isJsonMode(cmd);
+        const { raw, images: created } = await generateImages(options.character, {
+            shots: options.shots,
+            template: options.template,
+            scene: options.scene,
+            resolution: options.resolution,
+        });
+        if (!options.wait) {
+            if (json) {
+                printJson(raw);
+                return;
+            }
+            if (created.length === 0) {
+                logger.success('Look generation started.');
+                return;
+            }
+            logger.success(`Look generation started (id${created.length > 1 ? 's' : ''}: ${created.map((i) => i.id).join(', ')})`);
+            logger.hint(`Check progress with: clipugc images status ${created[0].id}`);
+            return;
+        }
+        if (created.length === 0) {
+            if (json) {
+                printJson(raw);
+            }
+            else {
+                logger.warn('Generation started but no image ids were returned — cannot wait. Check `clipugc images list`.');
+            }
+            return;
+        }
+        const finals = await waitForImages(created, json);
+        if (json) {
+            printJson(finals);
+            return;
+        }
+        printFinalStatuses(created, finals);
+    });
+    images
+        .command('list')
+        .description('List looks for a character')
+        .requiredOption('--character <id>', 'Character id')
+        .action(async (options, cmd) => {
+        const json = isJsonMode(cmd);
+        const { items, raw } = await listImages(options.character);
+        if (json) {
+            printJson(raw);
+            return;
+        }
+        const columns = [
+            { header: 'ID', value: (i) => i.id },
+            {
+                header: 'Scene',
+                value: (i) => {
+                    const scene = typeof i.scene_prompt === 'string' ? i.scene_prompt : '';
+                    if (scene === '')
+                        return 'base look';
+                    return scene.length > 42 ? `${scene.slice(0, 39)}…` : scene;
+                },
+            },
+            { header: 'Status', value: (i) => (i.status ? formatStatus(String(i.status)) : undefined) },
+            { header: 'Created', value: (i) => i.created_at },
+        ];
+        printTable(items, columns);
+        logger.hint('Reference a look by its ID, e.g. clipugc videos create --image <ID>');
+    });
+    images
+        .command('show <id>')
+        .description('Show a look in detail')
+        .action(async (id, _options, cmd) => {
+        const json = isJsonMode(cmd);
+        const image = await getImage(id);
+        if (json) {
+            printJson(image);
+            return;
+        }
+        for (const [key, value] of Object.entries(image)) {
+            if (value === null || value === undefined || value === '')
+                continue;
+            if (typeof value === 'object') {
+                logger.kv(key, JSON.stringify(value));
+            }
+            else if (key === 'status') {
+                logger.kv(key, formatStatus(String(value)));
+            }
+            else {
+                logger.kv(key, String(value));
+            }
+        }
+    });
+    images
+        .command('status <id>')
+        .description('Check generation status of a look')
+        .action(async (id, _options, cmd) => {
+        const json = isJsonMode(cmd);
+        const check = await checkImageStatus(id);
+        if (json) {
+            printJson(check);
+            return;
+        }
+        logger.kv('Status', formatStatus(String(check.status)));
+        const url = findImageUrl(check);
+        if (check.status === 'completed' && url)
+            logger.kv('URL', url);
+        const reason = check.failure_reason || check.error_message;
+        if (check.status === 'failed' && reason)
+            logger.kv('Reason', reason);
+    });
+    images
+        .command('download <id>')
+        .description('Download a look image to disk')
+        .option('-o, --output <file>', 'Output file (default: clipugc-look-<id>.<ext>)')
+        .action(async (id, options, cmd) => {
+        const json = isJsonMode(cmd);
+        const dest = await downloadImage(id, { output: options.output, quiet: json });
+        if (json) {
+            printJson({ saved: dest });
+            return;
+        }
+        logger.success(`Saved ${dest}`);
+    });
+    images
+        .command('variation <id>')
+        .description('Generate variation(s) of a look with a new scene')
+        .requiredOption('--scene <prompt>', 'Scene prompt (3-600 characters)')
+        .option('--count <n>', 'Number of variations (1-4)')
+        .option('--before-after', 'Generate a before/after style variation')
+        .option('--wait', 'Poll until the variation completes')
+        .action(async (id, options, cmd) => {
+        const json = isJsonMode(cmd);
+        const count = options.count !== undefined ? parseIntStrict(options.count, '--count') : undefined;
+        const { raw, images: created } = await createVariation(id, {
+            scene: options.scene,
+            count,
+            beforeAfter: options.beforeAfter ? true : undefined,
+        });
+        if (!options.wait) {
+            if (json) {
+                printJson(raw);
+                return;
+            }
+            if (created.length === 0) {
+                logger.success('Variation started.');
+                return;
+            }
+            logger.success(`Variation started (id${created.length > 1 ? 's' : ''}: ${created.map((i) => i.id).join(', ')})`);
+            logger.hint(`Check progress with: clipugc images status ${created[0].id}`);
+            return;
+        }
+        if (created.length === 0) {
+            if (json) {
+                printJson(raw);
+            }
+            else {
+                logger.warn('Variation started but no image ids were returned — cannot wait. Check `clipugc images list`.');
+            }
+            return;
+        }
+        const finals = await waitForImages(created, json);
+        if (json) {
+            printJson(finals);
+            return;
+        }
+        printFinalStatuses(created, finals);
+    });
+    images
+        .command('retry <id>')
+        .description('Retry a failed look generation')
+        .option('--wait', 'Poll until the retry completes')
+        .action(async (id, options, cmd) => {
+        const json = isJsonMode(cmd);
+        const result = await retryImage(id);
+        if (!options.wait) {
+            if (json) {
+                printJson(result ?? { retried: true, id });
+                return;
+            }
+            logger.success(`Retry started for look ${id}.`);
+            logger.hint(`Check progress with: clipugc images status ${id}`);
+            return;
+        }
+        const final = await waitForCompletion(() => checkImageStatus(id), {
+            label: `Regenerating look ${id}`,
+            quiet: json,
+        });
+        if (json) {
+            printJson(final);
+            return;
+        }
+        const url = findImageUrl(final);
+        logger.kv(`Look ${id}`, formatStatus(String(final.status)) + (url ? `  ${url}` : ''));
+    });
+    images
+        .command('delete <id>')
+        .description('Delete a look')
+        .option('--yes', 'Skip the confirmation prompt')
+        .action(async (id, options, cmd) => {
+        const json = isJsonMode(cmd);
+        if (!options.yes) {
+            const ok = await confirm(`Delete look ${id}? This cannot be undone.`);
+            if (!ok)
+                throw new AbortedError('Delete cancelled.');
+        }
+        const result = await deleteImage(id);
+        if (json) {
+            printJson(result ?? { deleted: true, id });
+            return;
+        }
+        logger.success(`Look ${id} deleted.`);
+    });
+}
+//# sourceMappingURL=images.js.map

package/dist/commands/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../src/commands/images.ts"],"names":[],"mappings":"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"}

package/dist/commands/videos.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerVideosCommands(program: Command): void;

package/dist/commands/videos.js

@@ -0,0 +1,272 @@
+import { createApiClient } from '../services/api.js';
+import { checkVideoStatus, createImageToVideo, createMotionControl, deleteVideo, downloadVideo, getVideo, listVideos, mergeVideo, retryVideo, } from '../services/videos.service.js';
+import { uploadFile } from '../services/upload.service.js';
+import { formatStatus, isJsonMode, printJson, printPagination, printTable } from '../utils/output.js';
+import { waitForCompletion, waitForMerge } from '../utils/poll.js';
+import { confirm } from '../utils/prompt.js';
+import { AbortedError, ValidationError } from '../utils/errors.js';
+import { logger } from '../utils/logger.js';
+function parsePositiveInt(flag) {
+    return (value) => {
+        const n = Number.parseInt(value, 10);
+        if (!Number.isInteger(n) || String(n) !== value.trim() || n < 1) {
+            throw new ValidationError(`${flag} must be a positive integer (got "${value}").`);
+        }
+        return n;
+    };
+}
+/**
+ * Resolve the --image/--photo pair into the API image source.
+ * Exactly one must be given; --photo is uploaded first (purpose: photo).
+ */
+async function resolveImageSource(api, opts, quiet) {
+    const hasImage = Boolean(opts.image);
+    const hasPhoto = Boolean(opts.photo);
+    if (hasImage === hasPhoto) {
+        throw new ValidationError('Provide exactly one image source: --image <lookId> (a generated character look) or --photo <file> (your own photo).');
+    }
+    if (hasImage) {
+        return { characterReferenceImageId: opts.image };
+    }
+    const sourceImageKey = await uploadFile(api, 'photo', opts.photo, { quiet });
+    return { sourceImageKey };
+}
+/** Human label for a video's merge state. */
+function mergedLabel(v) {
+    const ms = typeof v.merge_status === 'string' ? v.merge_status : undefined;
+    if (ms)
+        return ms; // processing | completed | failed
+    const media = v.media;
+    if (v.is_merged === true || media?.has_merged === true)
+        return 'completed';
+    return '—';
+}
+/** Shared post-create flow: --wait polling or a status hint. */
+async function finishCreate(api, video, opts, json, label) {
+    const id = String(video.id);
+    if (opts.wait) {
+        const finalStatus = await waitForCompletion(() => checkVideoStatus(api, id), { label, quiet: json });
+        if (json) {
+            printJson(finalStatus);
+            return;
+        }
+        logger.hint(`Download it with \`clipugc videos download ${id}\``);
+        return;
+    }
+    if (json) {
+        printJson(video);
+        return;
+    }
+    logger.success(`Video queued (id: ${id}, status: ${formatStatus(video.status ?? 'pending')}).`);
+    logger.hint(`Check progress with \`clipugc videos status ${id}\` (or re-run with --wait).`);
+}
+export function registerVideosCommands(program) {
+    const videos = program
+        .command('videos')
+        .description('Create, manage, and download UGC character videos');
+    videos
+        .command('list')
+        .description('List your character videos')
+        .option('--character <id>', 'Only videos of this AI character')
+        .option('--mergeable', 'Only completed, unmerged clips (ready for `videos merge`)')
+        .option('--finals', 'Only merged final UGC videos')
+        .option('--page <n>', 'Page number', parsePositiveInt('--page'))
+        .option('--per-page <n>', 'Results per page (max 50)', parsePositiveInt('--per-page'))
+        .action(async (opts, cmd) => {
+        const json = isJsonMode(cmd);
+        const api = await createApiClient();
+        const { items, pagination, raw } = await listVideos(api, {
+            page: opts.page,
+            perPage: opts.perPage,
+            aiCharacterId: opts.character,
+            mergeable: opts.mergeable,
+            finals: opts.finals,
+        });
+        if (json) {
+            printJson(raw);
+            return;
+        }
+        printTable(items, [
+            { header: 'ID', value: (v) => v.id },
+            { header: 'Status', value: (v) => formatStatus(v.status ?? '') },
+            { header: 'Merged', value: (v) => mergedLabel(v) },
+            { header: 'Type', value: (v) => v.kind ?? v.type },
+            { header: 'Created', value: (v) => v.created_at },
+        ]);
+        printPagination(pagination);
+    });
+    videos
+        .command('create')
+        .description('Generate a character video from an image (image-to-video). Costs 7 credits (5s) or 13 (10s); a --scene staged clip adds the image cost (9 at 5s, 15 at 10s)')
+        .option('--image <lookId>', 'ID of a generated character look/reference image')
+        .option('--photo <file>', 'Path to your own photo (png/jpg/jpeg/webp) — uploaded first')
+        .option('--prompt <text>', 'What the character should say/do (max 1500 chars)')
+        .option('--scene <text>', 'Extra scene description, max 600 chars (scene-staged clip: 9 credits at 5s, 15 at 10s)')
+        .option('--duration <seconds>', 'Video duration: 5 or 10 (default 5). 5s = 7 credits, 10s = 13', parsePositiveInt('--duration'))
+        .option('--keep-sound', 'Keep the original sound')
+        .option('--wait', 'Wait until generation completes')
+        .action(async (opts, cmd) => {
+        const json = isJsonMode(cmd);
+        const api = await createApiClient();
+        const source = await resolveImageSource(api, opts, json);
+        const video = await createImageToVideo(api, {
+            ...source,
+            prompt: opts.prompt,
+            scenePrompt: opts.scene,
+            duration: opts.duration,
+            keepOriginalSound: opts.keepSound,
+        });
+        await finishCreate(api, video, opts, json, 'Generating video');
+    });
+    videos
+        .command('motion')
+        .description('Generate a character video driven by a reference video (motion control). Costs 3 credits per second of driver video (rounded up, capped at 30s)')
+        .option('--image <lookId>', 'ID of a generated character look/reference image')
+        .option('--photo <file>', 'Path to your own photo (png/jpg/jpeg/webp) — uploaded first')
+        .requiredOption('--driver <videoFile>', 'Driver video (mp4/mov, max 50 MB and 30s) whose motion is applied')
+        .option('--prompt <text>', 'What the character should say/do (max 1500 chars)')
+        .option('--keep-sound', "Keep the driver video's original sound")
+        .option('--wait', 'Wait until generation completes')
+        .action(async (opts, cmd) => {
+        const json = isJsonMode(cmd);
+        const api = await createApiClient();
+        const source = await resolveImageSource(api, opts, json);
+        const referenceVideoKey = await uploadFile(api, 'driver_video', opts.driver, { quiet: json });
+        const video = await createMotionControl(api, {
+            ...source,
+            referenceVideoKey,
+            prompt: opts.prompt,
+            keepOriginalSound: opts.keepSound,
+        });
+        await finishCreate(api, video, opts, json, 'Generating video');
+    });
+    videos
+        .command('merge <videoId>')
+        .description('Merge your app screen recording with the character clip into a final UGC video, with a hook text overlay (and optional background music)')
+        .requiredOption('--app-video <file>', 'App screen recording (mp4/mov) — uploaded first')
+        .requiredOption('--hook <text>', 'Hook text overlay (max 150 chars)')
+        .option('--music <file>', 'Background music (mp3/wav/m4a) — uploaded first')
+        .option('--wait', 'Wait until the merge completes')
+        .action(async (videoId, opts, cmd) => {
+        const json = isJsonMode(cmd);
+        const api = await createApiClient();
+        const appVideoKey = await uploadFile(api, 'app_video', opts.appVideo, { quiet: json });
+        const musicKey = opts.music ? await uploadFile(api, 'music', opts.music, { quiet: json }) : undefined;
+        const video = await mergeVideo(api, videoId, { appVideoKey, hookText: opts.hook, musicKey });
+        const id = String(video.id ?? videoId);
+        if (opts.wait) {
+            // A clip's own status stays "completed" during a merge, so wait on the
+            // video resource's merge_status (processing → completed | failed).
+            const final = await waitForMerge(() => getVideo(api, id), { label: 'Merging video', quiet: json });
+            if (json) {
+                printJson(final);
+            }
+            else {
+                logger.hint(`Download the finished ad with \`clipugc videos download ${id}\``);
+            }
+            return;
+        }
+        if (json) {
+            printJson(video);
+            return;
+        }
+        logger.success(`Merge queued (video ${id}). It renders in the background.`);
+        logger.hint(`Wait for it with \`clipugc videos status ${id}\` — or re-run with --wait.`);
+    });
+    videos
+        .command('show <id>')
+        .description('Show details of a character video')
+        .action(async (id, cmd) => {
+        const json = isJsonMode(cmd);
+        const api = await createApiClient();
+        const video = await getVideo(api, id);
+        if (json) {
+            printJson(video);
+            return;
+        }
+        logger.plain(`Video ${video.id}`);
+        logger.kv('status', formatStatus(video.status ?? ''));
+        for (const [key, value] of Object.entries(video)) {
+            if (key === 'id' || key === 'status')
+                continue;
+            if (value === null || ['string', 'number', 'boolean'].includes(typeof value)) {
+                logger.kv(key, value);
+            }
+        }
+        if (video.status === 'completed') {
+            logger.hint(`Download it with \`clipugc videos download ${video.id}\``);
+        }
+    });
+    videos
+        .command('status <id>')
+        .description('Check the processing status of a character video')
+        .action(async (id, cmd) => {
+        const json = isJsonMode(cmd);
+        const api = await createApiClient();
+        const check = await checkVideoStatus(api, id);
+        if (json) {
+            printJson(check);
+            return;
+        }
+        logger.plain(`Status: ${formatStatus(check.status ?? 'unknown')}`);
+        const mergeStatus = typeof check.merge_status === 'string' ? check.merge_status : undefined;
+        const media = check.media;
+        if (mergeStatus || media?.has_merged) {
+            logger.kv('Merge', mergeStatus ?? (media?.has_merged ? 'completed' : '—'));
+        }
+        if (check.status === 'failed') {
+            const reason = check.failure_reason || check.error_message;
+            if (reason)
+                logger.warn(String(reason));
+            logger.hint(`Retry with \`clipugc videos retry ${id}\``);
+        }
+        if (mergeStatus === 'failed') {
+            logger.warn('The merge failed and its credit was refunded. Re-run `clipugc videos merge`.');
+        }
+        if (check.status === 'completed') {
+            logger.hint(`Download it with \`clipugc videos download ${id}\``);
+        }
+    });
+    videos
+        .command('download <id>')
+        .description('Download a completed character video to disk')
+        .option('-o, --output <file>', 'Destination file (default: clipugc-video-<id>.mp4)')
+        .action(async (id, opts, cmd) => {
+        const json = isJsonMode(cmd);
+        const api = await createApiClient();
+        const dest = await downloadVideo(api, id, { output: opts.output, quiet: json });
+        if (json) {
+            printJson({ id, output: dest });
+        }
+    });
+    videos
+        .command('retry <id>')
+        .description('Retry a failed character video')
+        .option('--wait', 'Wait until generation completes')
+        .action(async (id, opts, cmd) => {
+        const json = isJsonMode(cmd);
+        const api = await createApiClient();
+        const video = await retryVideo(api, id);
+        await finishCreate(api, { ...video, id: video.id ?? id }, opts, json, 'Generating video');
+    });
+    videos
+        .command('delete <id>')
+        .description('Delete a character video')
+        .option('-y, --yes', 'Skip the confirmation prompt')
+        .action(async (id, opts, cmd) => {
+        const json = isJsonMode(cmd);
+        if (!opts.yes) {
+            const ok = await confirm(`Delete video ${id}? This cannot be undone.`);
+            if (!ok)
+                throw new AbortedError();
+        }
+        const api = await createApiClient();
+        const { data, message } = await deleteVideo(api, id);
+        if (json) {
+            printJson(data);
+            return;
+        }
+        logger.success(message ?? `Video ${id} deleted.`);
+    });
+}
+//# sourceMappingURL=videos.js.map

package/dist/commands/videos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videos.js","sourceRoot":"","sources":["../../src/commands/videos.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { createCli } from './cli.js';
+import { CliError, EXIT_CODES } from './utils/errors.js';
+import { logger } from './utils/logger.js';
+process.on('SIGINT', () => {
+    console.log('\n');
+    process.exit(130);
+});
+const program = createCli();
+program.parseAsync(process.argv).catch((error) => {
+    if (error instanceof CliError) {
+        if (error.exitCode === EXIT_CODES.OK) {
+            // e.g. user aborted a confirmation — informational, not a failure
+            logger.info(error.message);
+            process.exit(0);
+        }
+        logger.error(error.message);
+        process.exit(error.exitCode);
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(message);
+    process.exit(EXIT_CODES.GENERIC);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;AAE5B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxD,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC,EAAE,EAAE,CAAC;YACrC,kEAAkE;YAClE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC"}

package/dist/services/api.d.ts

@@ -0,0 +1,40 @@
+export interface RequestOptions {
+    /** JSON body (POST/PATCH). */
+    body?: unknown;
+    /** Multipart body (file uploads). Mutually exclusive with body. */
+    form?: FormData;
+    /** Query string params; undefined/null values are dropped. */
+    query?: Record<string, string | number | boolean | undefined | null>;
+}
+export interface ApiResult<T> {
+    data: T;
+    message: string | null;
+}
+/**
+ * Thin fetch client for the ClipUGC REST API.
+ * Unwraps the {statusCode, errorMessage, data, message} envelope and throws
+ * typed errors — it never exits the process.
+ */
+export declare class ApiClient {
+    readonly baseUrl: string;
+    private readonly apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, options?: RequestOptions): Promise<T>;
+    /** POST multipart/form-data (file uploads). fetch sets the boundary header itself. */
+    postForm<T>(path: string, form: FormData): Promise<T>;
+    patch<T>(path: string, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    /** Full request returning both data and the envelope message. */
+    request<T>(method: string, path: string, options?: RequestOptions): Promise<ApiResult<T>>;
+    private unwrap;
+    private buildUrl;
+}
+/**
+ * Build a client from persisted config/env. Throws AuthError when no API key
+ * is available (unless allowAnonymous — used by `auth login` itself).
+ */
+export declare function createApiClient(opts?: {
+    allowAnonymous?: boolean;
+    apiKey?: string;
+}): Promise<ApiClient>;