clipugc 0.2.0

package/dist/services/images.service.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Character images (looks) service — request building, client-side validation
+ * and API calls for the `clipugc images` command group.
+ *
+ * All validation lives here (unit-testable); command handlers stay thin.
+ * Throws typed errors from utils/errors.js — never exits the process.
+ */
+/** A character look (reference image) record. Unknown fields are preserved. */
+export interface CharacterImage {
+    id: number | string;
+    shot_type?: string;
+    status?: string;
+    image_url?: string;
+    url?: string;
+    created_at?: string;
+    [key: string]: unknown;
+}
+/** Payload of GET /character-images/{id}/check-status. */
+export interface ImageStatusCheck {
+    status: string;
+    failure_reason?: string | null;
+    error_message?: string | null;
+    [key: string]: unknown;
+}
+export declare const SHOT_TYPES: readonly ["frontal", "three_quarter", "profile", "back"];
+export declare const TEMPLATES: readonly ["model_digitals", "scene_recreation", "specific_angle"];
+export declare const RESOLUTIONS: readonly ["0.5K", "1K", "2K", "4K"];
+export declare const DEFAULT_SHOTS: string[];
+export declare const DEFAULT_TEMPLATE = "model_digitals";
+export declare const DEFAULT_RESOLUTION = "2K";
+export declare const SCENE_MAX = 600;
+export declare const VARIATION_SCENE_MIN = 3;
+export declare const VARIATION_COUNT_MIN = 1;
+export declare const VARIATION_COUNT_MAX = 4;
+/** Keys the API might wrap an image list in (tolerant unwrapping). */
+export declare const IMAGE_LIST_KEYS: string[];
+/**
+ * Parse a comma-separated --shots value into a validated shot_types array.
+ * Defaults to ['frontal'] when omitted/empty.
+ */
+export declare function parseShotTypes(input?: string): string[];
+export interface GenerateImagesInput {
+    /** Comma-separated shot types, e.g. "frontal,three_quarter". */
+    shots?: string;
+    template?: string;
+    scene?: string;
+    resolution?: string;
+}
+/** Build + validate the POST /ai-characters/{id}/reference-images payload. */
+export declare function buildGeneratePayload(input?: GenerateImagesInput): Record<string, unknown>;
+/**
+ * Normalize the create/variation response into an array of image records:
+ * handles a single object with id, a bare array, or a wrapped array.
+ */
+export declare function extractCreatedImages(data: unknown): CharacterImage[];
+export interface GenerateImagesResult {
+    /** Raw response data (for --json passthrough). */
+    raw: unknown;
+    /** Normalized created image record(s). */
+    images: CharacterImage[];
+}
+/** POST /ai-characters/{id}/reference-images */
+export declare function generateImages(characterId: string, input?: GenerateImagesInput): Promise<GenerateImagesResult>;
+/** GET /ai-characters/{id}/reference-images */
+export declare function listImages(characterId: string): Promise<{
+    items: CharacterImage[];
+    raw: unknown;
+}>;
+/** GET /character-images/{id} */
+export declare function getImage(id: string): Promise<CharacterImage>;
+/** GET /character-images/{id}/check-status — returned as-is (poll payload). */
+export declare function checkImageStatus(id: string): Promise<ImageStatusCheck>;
+/**
+ * Download a look's image to disk. The API serves signed temporary URLs on the
+ * image record (media.image_url), so we fetch the record first, then the bytes.
+ */
+export declare function downloadImage(id: string, opts?: {
+    output?: string;
+    quiet?: boolean;
+}): Promise<string>;
+export interface VariationInput {
+    scene: string;
+    count?: number;
+    beforeAfter?: boolean;
+}
+/** Build + validate the POST /character-images/{id}/variation payload. */
+export declare function buildVariationPayload(input: VariationInput): Record<string, unknown>;
+/** POST /character-images/{id}/variation */
+export declare function createVariation(id: string, input: VariationInput): Promise<GenerateImagesResult>;
+/** POST /character-images/{id}/retry */
+export declare function retryImage(id: string): Promise<unknown>;
+/** DELETE /character-images/{id} */
+export declare function deleteImage(id: string): Promise<unknown>;
+/** Best-effort URL lookup on an image/status record (field name varies). */
+export declare function findImageUrl(record: Record<string, unknown>): string | undefined;

package/dist/services/images.service.js

@@ -0,0 +1,191 @@
+/**
+ * Character images (looks) service — request building, client-side validation
+ * and API calls for the `clipugc images` command group.
+ *
+ * All validation lives here (unit-testable); command handlers stay thin.
+ * Throws typed errors from utils/errors.js — never exits the process.
+ */
+import { createApiClient } from './api.js';
+import { ValidationError } from '../utils/errors.js';
+import { extractList } from './characters.service.js';
+export const SHOT_TYPES = ['frontal', 'three_quarter', 'profile', 'back'];
+export const TEMPLATES = ['model_digitals', 'scene_recreation', 'specific_angle'];
+export const RESOLUTIONS = ['0.5K', '1K', '2K', '4K'];
+export const DEFAULT_SHOTS = ['frontal'];
+export const DEFAULT_TEMPLATE = 'model_digitals';
+export const DEFAULT_RESOLUTION = '2K';
+export const SCENE_MAX = 600;
+export const VARIATION_SCENE_MIN = 3;
+export const VARIATION_COUNT_MIN = 1;
+export const VARIATION_COUNT_MAX = 4;
+/** Keys the API might wrap an image list in (tolerant unwrapping). */
+export const IMAGE_LIST_KEYS = ['items', 'images', 'reference_images', 'character_images', 'data'];
+/**
+ * Parse a comma-separated --shots value into a validated shot_types array.
+ * Defaults to ['frontal'] when omitted/empty.
+ */
+export function parseShotTypes(input) {
+    if (input === undefined || input.trim() === '')
+        return [...DEFAULT_SHOTS];
+    const shots = input
+        .split(',')
+        .map((s) => s.trim())
+        .filter((s) => s !== '');
+    if (shots.length === 0)
+        return [...DEFAULT_SHOTS];
+    for (const shot of shots) {
+        if (!SHOT_TYPES.includes(shot)) {
+            throw new ValidationError(`Invalid shot type "${shot}". Allowed: ${SHOT_TYPES.join(', ')}.`);
+        }
+    }
+    return shots;
+}
+/** Build + validate the POST /ai-characters/{id}/reference-images payload. */
+export function buildGeneratePayload(input = {}) {
+    const payload = {
+        shot_types: parseShotTypes(input.shots),
+    };
+    // Template is optional server-side (auto: scene → scene_recreation, else model_digitals).
+    if (input.template !== undefined && input.template !== '') {
+        if (!TEMPLATES.includes(input.template)) {
+            throw new ValidationError(`Invalid template "${input.template}". Allowed: ${TEMPLATES.join(', ')}.`);
+        }
+        payload.template = input.template;
+    }
+    if (input.scene !== undefined && input.scene !== '') {
+        if (input.scene.length > SCENE_MAX) {
+            throw new ValidationError(`Scene prompt must be at most ${SCENE_MAX} characters (got ${input.scene.length}).`);
+        }
+        payload.scene_prompt = input.scene;
+    }
+    const resolution = input.resolution === undefined || input.resolution === '' ? DEFAULT_RESOLUTION : input.resolution;
+    if (!RESOLUTIONS.includes(resolution)) {
+        throw new ValidationError(`Invalid resolution "${resolution}". Allowed: ${RESOLUTIONS.join(', ')}.`);
+    }
+    payload.resolution = resolution;
+    return payload;
+}
+/**
+ * Normalize the create/variation response into an array of image records:
+ * handles a single object with id, a bare array, or a wrapped array.
+ */
+export function extractCreatedImages(data) {
+    if (Array.isArray(data))
+        return data.filter((x) => Boolean(x) && typeof x === 'object');
+    if (data && typeof data === 'object') {
+        const obj = data;
+        if (obj.id !== undefined)
+            return [obj];
+        const wrapped = extractList(data, IMAGE_LIST_KEYS);
+        if (wrapped.length > 0)
+            return wrapped;
+    }
+    return [];
+}
+/** POST /ai-characters/{id}/reference-images */
+export async function generateImages(characterId, input = {}) {
+    const payload = buildGeneratePayload(input);
+    const api = await createApiClient();
+    const raw = await api.post(`/ai-characters/${characterId}/reference-images`, { body: payload });
+    return { raw, images: extractCreatedImages(raw) };
+}
+/** GET /ai-characters/{id}/reference-images */
+export async function listImages(characterId) {
+    const api = await createApiClient();
+    const raw = await api.get(`/ai-characters/${characterId}/reference-images`);
+    return { items: extractList(raw, IMAGE_LIST_KEYS), raw };
+}
+/** GET /character-images/{id} */
+export async function getImage(id) {
+    const api = await createApiClient();
+    const data = await api.get(`/character-images/${id}`);
+    const images = extractCreatedImages(data);
+    return images[0] ?? data;
+}
+/** GET /character-images/{id}/check-status — returned as-is (poll payload). */
+export async function checkImageStatus(id) {
+    const api = await createApiClient();
+    return api.get(`/character-images/${id}/check-status`);
+}
+/**
+ * Download a look's image to disk. The API serves signed temporary URLs on the
+ * image record (media.image_url), so we fetch the record first, then the bytes.
+ */
+export async function downloadImage(id, opts = {}) {
+    const image = await getImage(id);
+    const url = findImageUrl(image);
+    if (!url) {
+        throw new ValidationError(`Look ${id} has no image yet — check \`clipugc images status ${id}\`.`);
+    }
+    const extension = /\.(png|jpe?g|webp)(\?|$)/i.exec(url)?.[1]?.toLowerCase() ?? 'png';
+    const dest = opts.output || `clipugc-look-${id}.${extension}`;
+    const { NetworkError } = await import('../utils/errors.js');
+    let response;
+    try {
+        response = await fetch(url);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new NetworkError(`Download failed: ${reason}`);
+    }
+    if (!response.ok) {
+        throw new NetworkError(`Download failed (HTTP ${response.status}). The link may have expired — try again.`);
+    }
+    const fs = (await import('fs-extra')).default;
+    // outputFile creates missing parent directories, so -o can target
+    // workspace paths like clipugc/influencers/<id>/pictures/… directly.
+    await fs.outputFile(dest, Buffer.from(await response.arrayBuffer()));
+    return dest;
+}
+/** Build + validate the POST /character-images/{id}/variation payload. */
+export function buildVariationPayload(input) {
+    const scene = (input.scene ?? '').trim();
+    if (scene.length < VARIATION_SCENE_MIN || scene.length > SCENE_MAX) {
+        throw new ValidationError(`Variation scene prompt must be ${VARIATION_SCENE_MIN}-${SCENE_MAX} characters (got ${scene.length}).`);
+    }
+    const payload = { scene_prompt: scene };
+    if (input.count !== undefined) {
+        if (!Number.isInteger(input.count) || input.count < VARIATION_COUNT_MIN || input.count > VARIATION_COUNT_MAX) {
+            throw new ValidationError(`--count must be an integer between ${VARIATION_COUNT_MIN} and ${VARIATION_COUNT_MAX} (got ${input.count}).`);
+        }
+        payload.count = input.count;
+    }
+    if (input.beforeAfter !== undefined)
+        payload.before_after = input.beforeAfter;
+    return payload;
+}
+/** POST /character-images/{id}/variation */
+export async function createVariation(id, input) {
+    const payload = buildVariationPayload(input);
+    const api = await createApiClient();
+    const raw = await api.post(`/character-images/${id}/variation`, { body: payload });
+    return { raw, images: extractCreatedImages(raw) };
+}
+/** POST /character-images/{id}/retry */
+export async function retryImage(id) {
+    const api = await createApiClient();
+    return api.post(`/character-images/${id}/retry`);
+}
+/** DELETE /character-images/{id} */
+export async function deleteImage(id) {
+    const api = await createApiClient();
+    return api.delete(`/character-images/${id}`);
+}
+/** Best-effort URL lookup on an image/status record (field name varies). */
+export function findImageUrl(record) {
+    const candidates = [record.image_url, record.url, record.file_url, record.public_url];
+    for (const c of candidates) {
+        if (typeof c === 'string' && c !== '')
+            return c;
+    }
+    for (const key of ['media', 'image']) {
+        const nested = record[key];
+        if (nested && typeof nested === 'object') {
+            const url = nested.image_url ?? nested.url;
+            if (typeof url === 'string' && url !== '')
+                return url;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=images.service.js.map

package/dist/services/images.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.service.js","sourceRoot":"","sources":["../../src/services/images.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAqBtD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AACnF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,CAAU,CAAC;AAC3F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAE/D,MAAM,CAAC,MAAM,aAAa,GAAa,CAAC,SAAS,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEvC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAC7B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAEnG;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,KAAK;SAChB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAE,UAAgC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,eAAe,CAAC,sBAAsB,IAAI,eAAe,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAUD,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,QAA6B,EAAE;IAClE,MAAM,OAAO,GAA4B;QACvC,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC;KACxC,CAAC;IAEF,0FAA0F;IAC1F,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;QAC1D,IAAI,CAAE,SAA+B,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,eAAe,CAAC,qBAAqB,KAAK,CAAC,QAAQ,eAAe,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvG,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;QACpD,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,eAAe,CAAC,gCAAgC,SAAS,oBAAoB,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QACjH,CAAC;QACD,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC;IACrC,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IACrH,IAAI,CAAE,WAAiC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,eAAe,CAAC,uBAAuB,UAAU,eAAe,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvG,CAAC;IACD,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;IAEhC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAuB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC7G,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAA+B,CAAC;QAC5C,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS;YAAE,OAAO,CAAC,GAAqB,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,WAAW,CAAiB,IAAI,EAAE,eAAe,CAAC,CAAC;QACnE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC;IACzC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AASD,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB,EAAE,QAA6B,EAAE;IACvF,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAU,kBAAkB,WAAW,mBAAmB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACzG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAmB;IAClD,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAU,kBAAkB,WAAW,mBAAmB,CAAC,CAAC;IACrF,OAAO,EAAE,KAAK,EAAE,WAAW,CAAiB,GAAG,EAAE,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC;AAC3E,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAU;IACvC,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAU,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,CAAC,CAAC,IAAK,IAAuB,CAAC;AAC/C,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAU;IAC/C,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;IACpC,OAAO,GAAG,CAAC,GAAG,CAAmB,qBAAqB,EAAE,eAAe,CAAC,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAU,EAAE,OAA6C,EAAE;IAC7F,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,eAAe,CAAC,QAAQ,EAAE,qDAAqD,EAAE,KAAK,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,SAAS,GAAG,2BAA2B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;IACrF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,IAAI,gBAAgB,EAAE,IAAI,SAAS,EAAE,CAAC;IAE9D,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAC5D,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,MAAM,IAAI,YAAY,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,YAAY,CAAC,yBAAyB,QAAQ,CAAC,MAAM,2CAA2C,CAAC,CAAC;IAC9G,CAAC;IAED,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9C,kEAAkE;IAClE,qEAAqE;IACrE,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC;AACd,CAAC;AAQD,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,KAAqB;IACzD,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,KAAK,CAAC,MAAM,GAAG,mBAAmB,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QACnE,MAAM,IAAI,eAAe,CACvB,kCAAkC,mBAAmB,IAAI,SAAS,oBAAoB,KAAK,CAAC,MAAM,IAAI,CACvG,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAA4B,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IAEjE,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,GAAG,mBAAmB,IAAI,KAAK,CAAC,KAAK,GAAG,mBAAmB,EAAE,CAAC;YAC7G,MAAM,IAAI,eAAe,CACvB,sCAAsC,mBAAmB,QAAQ,mBAAmB,SAAS,KAAK,CAAC,KAAK,IAAI,CAC7G,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC;IAE9E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAU,EAAE,KAAqB;IACrE,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAU,qBAAqB,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5F,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAAU;IACzC,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;IACpC,OAAO,GAAG,CAAC,IAAI,CAAU,qBAAqB,EAAE,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAU;IAC1C,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;IACpC,OAAO,GAAG,CAAC,MAAM,CAAU,qBAAqB,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,MAA+B;IAC1D,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACtF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE;YAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,GAAG,GAAI,MAAkC,CAAC,SAAS,IAAK,MAAkC,CAAC,GAAG,CAAC;YACrG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,EAAE;gBAAE,OAAO,GAAG,CAAC;QACxD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/services/upload.service.d.ts

@@ -0,0 +1,46 @@
+import type { ApiClient } from './api.js';
+/** What the uploaded file will be used for — determines allowed extensions. */
+export type UploadPurpose = 'driver_video' | 'app_video' | 'music' | 'photo';
+/** Allowed file extensions (lowercase, no dot) per upload purpose. */
+export declare const ALLOWED_EXTENSIONS: Record<UploadPurpose, readonly string[]>;
+/** Driver videos must stay small enough for motion-control processing. */
+export declare const MAX_DRIVER_VIDEO_BYTES: number;
+export declare const MAX_DRIVER_VIDEO_SECONDS = 30;
+/** Response of POST /uploads/presign. */
+export interface PresignedUpload {
+    key: string;
+    upload_url: string;
+    method: string;
+    headers?: Record<string, string>;
+    expires_at?: string;
+    [key: string]: unknown;
+}
+/**
+ * Pure validation: the file's extension must be allowed for the purpose
+ * (case-insensitive). Returns the lowercase extension without the dot.
+ */
+export declare function validateExtension(purpose: UploadPurpose, filePath: string): string;
+/** Pure validation: driver video file size must be at most 50 MB. */
+export declare function validateDriverVideoSize(sizeBytes: number): void;
+/** Pure validation: driver video duration must be at most 30 seconds. */
+export declare function validateDriverVideoDuration(durationSeconds: number): void;
+/**
+ * Probe a media file's duration in seconds via ffprobe.
+ * Returns null when ffprobe is not installed or fails — callers skip the
+ * duration check in that case (the server enforces it anyway).
+ */
+export declare function probeDurationSeconds(filePath: string): Promise<number | null>;
+export interface UploadOptions {
+    /** Suppress the spinner (used in --json mode); the upload still runs. */
+    quiet?: boolean;
+    /** Duration probe override (tests inject this to avoid invoking ffprobe). */
+    probe?: (filePath: string) => Promise<number | null>;
+}
+/**
+ * Upload a local file for the given purpose:
+ * 1. validate existence + extension (+ size/duration for driver videos),
+ * 2. POST /uploads/presign to get a direct-to-storage URL,
+ * 3. PUT the raw bytes to that URL (not the API envelope),
+ * and return the storage `key` to reference in follow-up API calls.
+ */
+export declare function uploadFile(api: ApiClient, purpose: UploadPurpose, filePath: string, opts?: UploadOptions): Promise<string>;

package/dist/services/upload.service.js

@@ -0,0 +1,134 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import ora from 'ora';
+import { NetworkError, ValidationError } from '../utils/errors.js';
+const execFileAsync = promisify(execFile);
+/** Allowed file extensions (lowercase, no dot) per upload purpose. */
+export const ALLOWED_EXTENSIONS = {
+    driver_video: ['mp4', 'mov'],
+    app_video: ['mp4', 'mov'],
+    music: ['mp3', 'wav', 'm4a'],
+    photo: ['png', 'jpg', 'jpeg', 'webp'],
+};
+/** Driver videos must stay small enough for motion-control processing. */
+export const MAX_DRIVER_VIDEO_BYTES = 50 * 1024 * 1024; // 50 MB
+export const MAX_DRIVER_VIDEO_SECONDS = 30;
+/**
+ * Pure validation: the file's extension must be allowed for the purpose
+ * (case-insensitive). Returns the lowercase extension without the dot.
+ */
+export function validateExtension(purpose, filePath) {
+    const ext = path.extname(filePath).replace(/^\./, '').toLowerCase();
+    const allowed = ALLOWED_EXTENSIONS[purpose];
+    if (!ext || !allowed.includes(ext)) {
+        throw new ValidationError(`Unsupported file type ".${ext || '?'}" for ${purpose.replace('_', ' ')} uploads. ` +
+            `Allowed: ${allowed.map((e) => `.${e}`).join(', ')}.`);
+    }
+    return ext;
+}
+/** Pure validation: driver video file size must be at most 50 MB. */
+export function validateDriverVideoSize(sizeBytes) {
+    if (sizeBytes > MAX_DRIVER_VIDEO_BYTES) {
+        const mb = (sizeBytes / (1024 * 1024)).toFixed(1);
+        throw new ValidationError(`Driver video is ${mb} MB, but the maximum is 50 MB. Compress or trim the video and try again.`);
+    }
+}
+/** Pure validation: driver video duration must be at most 30 seconds. */
+export function validateDriverVideoDuration(durationSeconds) {
+    if (durationSeconds > MAX_DRIVER_VIDEO_SECONDS) {
+        throw new ValidationError(`Driver video is ${Math.round(durationSeconds)}s long, but the maximum is ${MAX_DRIVER_VIDEO_SECONDS}s. ` +
+            'Trim the video (e.g. with ffmpeg or any editor) and try again.');
+    }
+}
+/**
+ * Probe a media file's duration in seconds via ffprobe.
+ * Returns null when ffprobe is not installed or fails — callers skip the
+ * duration check in that case (the server enforces it anyway).
+ */
+export async function probeDurationSeconds(filePath) {
+    try {
+        const { stdout } = await execFileAsync('ffprobe', [
+            '-v',
+            'error',
+            '-show_entries',
+            'format=duration',
+            '-of',
+            'csv=p=0',
+            filePath,
+        ]);
+        const duration = Number.parseFloat(stdout.trim());
+        return Number.isFinite(duration) ? duration : null;
+    }
+    catch {
+        return null; // ffprobe missing or unreadable file — skip silently
+    }
+}
+/**
+ * Upload a local file for the given purpose:
+ * 1. validate existence + extension (+ size/duration for driver videos),
+ * 2. POST /uploads/presign to get a direct-to-storage URL,
+ * 3. PUT the raw bytes to that URL (not the API envelope),
+ * and return the storage `key` to reference in follow-up API calls.
+ */
+export async function uploadFile(api, purpose, filePath, opts = {}) {
+    const extension = validateExtension(purpose, filePath);
+    let stat;
+    try {
+        stat = await fs.stat(filePath);
+    }
+    catch {
+        throw new ValidationError(`File not found: ${filePath}`);
+    }
+    if (!stat.isFile()) {
+        throw new ValidationError(`Not a file: ${filePath}`);
+    }
+    if (purpose === 'driver_video') {
+        validateDriverVideoSize(stat.size);
+        const probe = opts.probe ?? probeDurationSeconds;
+        const duration = await probe(filePath);
+        if (duration !== null) {
+            validateDriverVideoDuration(duration);
+        }
+    }
+    const basename = path.basename(filePath);
+    const sizeMb = (stat.size / (1024 * 1024)).toFixed(1);
+    const spinner = opts.quiet ? null : ora(`Uploading ${basename} (${sizeMb} MB)`).start();
+    try {
+        const presign = await api.post('/uploads/presign', {
+            body: { purpose, extension },
+        });
+        const body = await fs.readFile(filePath);
+        let response;
+        try {
+            response = await fetch(presign.upload_url, {
+                method: presign.method || 'PUT',
+                headers: presign.headers ?? {},
+                body,
+            });
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            throw new NetworkError(`Upload of ${basename} failed: ${reason}`);
+        }
+        if (!response.ok) {
+            let snippet = '';
+            try {
+                snippet = (await response.text()).slice(0, 200);
+            }
+            catch {
+                // ignore unreadable body
+            }
+            throw new NetworkError(`Upload of ${basename} failed (HTTP ${response.status})${snippet ? `: ${snippet}` : ''}`);
+        }
+        spinner?.succeed(`Uploaded ${basename}`);
+        return presign.key;
+    }
+    catch (err) {
+        if (spinner?.isSpinning)
+            spinner.fail(`Upload of ${basename} failed`);
+        throw err;
+    }
+}
+//# sourceMappingURL=upload.service.js.map

package/dist/services/upload.service.js.map

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

package/dist/services/user.service.d.ts

@@ -0,0 +1,80 @@
+import type { ApiClient } from './api.js';
+import type { Pagination } from '../types/index.js';
+/**
+ * User / account / credits service (G1 group).
+ * All functions throw typed errors from src/utils/errors.ts via ApiClient;
+ * they never exit the process.
+ */
+/**
+ * Authenticated user profile returned by GET /user.
+ * The API may add fields over time, so unknown fields are kept via the
+ * index signature and printed generically by `whoami`.
+ */
+export interface UserProfile {
+    id?: number | string;
+    name?: string | null;
+    email?: string | null;
+    [key: string]: unknown;
+}
+/**
+ * Per-action credit costs returned by GET /credits.
+ * The server charges duration-aware, so several video costs coexist:
+ *   image             a reference-image generation
+ *   clip              a 5s image-to-video clip
+ *   clip_10s          a 10s image-to-video clip
+ *   motion_per_second motion-control charge per second of driver video
+ *                     (× ceil(driver seconds), capped at 30s)
+ *   scene_staged      a scene-staged clip (created with a --scene prompt)
+ *   merge             merging a clip with an app recording into the final ad
+ * Unknown keys are tolerated via the index signature so new server-side
+ * actions render generically.
+ */
+export interface CreditCosts {
+    image?: number;
+    clip?: number;
+    clip_10s?: number;
+    motion_per_second?: number;
+    scene_staged?: number;
+    merge?: number;
+    [action: string]: number | undefined;
+}
+/** Response of GET /credits. */
+export interface CreditsInfo {
+    /** Current credit balance. */
+    balance: number;
+    /** Per-action credit costs, e.g. { image: 2, clip: 7, clip_10s: 13, merge: 1 }. */
+    costs: CreditCosts;
+}
+/** A single credit ledger entry returned by GET /credits/transactions. */
+export interface CreditTransaction {
+    id?: number | string;
+    uuid?: string;
+    type?: string;
+    action?: string;
+    /** Signed amount — negative means a spend, positive means a top-up/refund. */
+    amount?: number;
+    balance_after?: number;
+    description?: string | null;
+    created_at?: string;
+    [key: string]: unknown;
+}
+/** Payload of GET /credits/transactions. */
+export interface CreditTransactionsResult {
+    transactions: CreditTransaction[];
+    pagination?: Pagination;
+}
+/** Fetch the authenticated user's profile (GET /user). */
+export declare function getUser(api: ApiClient): Promise<UserProfile>;
+/** Fetch the credit balance and per-action costs (GET /credits). */
+export declare function getCredits(api: ApiClient): Promise<CreditsInfo>;
+/**
+ * Fetch the credit transaction history (GET /credits/transactions).
+ * `perPage` maps to the `per_page` query param; `page` to `page`.
+ * Tolerant to the API returning the array raw or wrapped under `transactions`.
+ */
+export declare function getCreditTransactions(api: ApiClient, opts?: {
+    perPage?: number;
+    page?: number;
+}): Promise<CreditTransactionsResult>;
+/** Permanently delete the authenticated user's account (DELETE /user). */
+export declare function deleteAccount(api: ApiClient): Promise<void>;

package/dist/services/user.service.js

@@ -0,0 +1,35 @@
+/** Fetch the authenticated user's profile (GET /user). */
+export async function getUser(api) {
+    return api.get('/user');
+}
+/** Fetch the credit balance and per-action costs (GET /credits). */
+export async function getCredits(api) {
+    return api.get('/credits');
+}
+/**
+ * Fetch the credit transaction history (GET /credits/transactions).
+ * `perPage` maps to the `per_page` query param; `page` to `page`.
+ * Tolerant to the API returning the array raw or wrapped under `transactions`.
+ */
+export async function getCreditTransactions(api, opts = {}) {
+    const raw = await api.get('/credits/transactions', {
+        query: { per_page: opts.perPage, page: opts.page },
+    });
+    if (Array.isArray(raw)) {
+        return { transactions: raw };
+    }
+    if (raw && typeof raw === 'object') {
+        const record = raw;
+        const transactions = Array.isArray(record.transactions)
+            ? record.transactions
+            : [];
+        const pagination = record.pagination ?? undefined;
+        return { transactions, pagination };
+    }
+    return { transactions: [] };
+}
+/** Permanently delete the authenticated user's account (DELETE /user). */
+export async function deleteAccount(api) {
+    await api.delete('/user');
+}
+//# sourceMappingURL=user.service.js.map

package/dist/services/user.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.service.js","sourceRoot":"","sources":["../../src/services/user.service.ts"],"names":[],"mappings":"AAwEA,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAc;IAC1C,OAAO,GAAG,CAAC,GAAG,CAAc,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAc;IAC7C,OAAO,GAAG,CAAC,GAAG,CAAc,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAc,EACd,OAA4C,EAAE;IAE9C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAU,uBAAuB,EAAE;QAC1D,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;KACnD,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,YAAY,EAAE,GAA0B,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,GAA8B,CAAC;QAC9C,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;YACrD,CAAC,CAAE,MAAM,CAAC,YAAoC;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,UAAU,GAAI,MAAM,CAAC,UAAqC,IAAI,SAAS,CAAC;QAC9E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;AAC9B,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAc;IAChD,MAAM,GAAG,CAAC,MAAM,CAAU,OAAO,CAAC,CAAC;AACrC,CAAC"}