clipugc 0.2.0

package/dist/services/api.js

@@ -0,0 +1,139 @@
+import { APP_CODES } from '../types/index.js';
+import { ApiError, AuthError, InsufficientCreditsError, NetworkError, NotFoundError, PremiumRequiredError, ValidationError, } from '../utils/errors.js';
+import { resolveApiBaseUrl, resolveApiKey } from '../utils/config.js';
+/**
+ * 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 class ApiClient {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl;
+        this.apiKey = apiKey;
+    }
+    async get(path, options = {}) {
+        return (await this.request('GET', path, options)).data;
+    }
+    async post(path, options = {}) {
+        return (await this.request('POST', path, options)).data;
+    }
+    /** POST multipart/form-data (file uploads). fetch sets the boundary header itself. */
+    async postForm(path, form) {
+        return (await this.request('POST', path, { form })).data;
+    }
+    async patch(path, options = {}) {
+        return (await this.request('PATCH', path, options)).data;
+    }
+    async delete(path, options = {}) {
+        return (await this.request('DELETE', path, options)).data;
+    }
+    /** Full request returning both data and the envelope message. */
+    async request(method, path, options = {}) {
+        const url = this.buildUrl(path, options.query);
+        const headers = {
+            Accept: 'application/json',
+        };
+        if (this.apiKey)
+            headers.Authorization = `Bearer ${this.apiKey}`;
+        // For FormData, fetch sets Content-Type (with boundary) itself.
+        if (options.body !== undefined && options.form === undefined)
+            headers['Content-Type'] = 'application/json';
+        const body = options.form ?? (options.body !== undefined ? JSON.stringify(options.body) : undefined);
+        // Retry idempotent reads on transient failures (network blips, rate limits,
+        // gateway/5xx while the server is briefly saturated).
+        const retryable = method === 'GET' || method === 'HEAD';
+        const transientStatuses = new Set([408, 425, 429, 500, 502, 503, 504]);
+        const maxAttempts = retryable ? 4 : 1;
+        let response;
+        let lastNetworkErr;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            try {
+                response = await fetch(url, { method, headers, body });
+            }
+            catch (err) {
+                lastNetworkErr = err;
+                response = undefined;
+            }
+            if (response && !(retryable && transientStatuses.has(response.status)))
+                break;
+            if (attempt < maxAttempts) {
+                await new Promise((r) => setTimeout(r, 800 * attempt)); // 0.8s, 1.6s, 2.4s
+            }
+        }
+        if (!response) {
+            const reason = lastNetworkErr instanceof Error ? lastNetworkErr.message : String(lastNetworkErr);
+            throw new NetworkError(`Could not reach ClipUGC API at ${this.baseUrl} (${reason}). Is the server up? Check \`clipugc config get apiBaseUrl\`.`);
+        }
+        let envelope;
+        try {
+            envelope = (await response.json());
+        }
+        catch {
+            throw new ApiError(`Unexpected non-JSON response from API (HTTP ${response.status}).`, response.status);
+        }
+        if (envelope.statusCode === undefined) {
+            // Not the standard envelope (e.g. framework-level 401/422/500 JSON)
+            if (response.status === 401)
+                throw new AuthError();
+            if (response.status === 422) {
+                // Laravel validation error: { message, errors: { field: [msgs] } }
+                const raw = envelope;
+                const details = raw.errors ? Object.values(raw.errors).flat().join(' ') : '';
+                throw new ValidationError(details || raw.message || 'The request was invalid (HTTP 422).');
+            }
+            throw new ApiError(`Unexpected API response (HTTP ${response.status}).`, response.status);
+        }
+        return this.unwrap(envelope);
+    }
+    unwrap(envelope) {
+        const { statusCode, errorMessage, data, message } = envelope;
+        if (statusCode === APP_CODES.OK || statusCode === APP_CODES.CREATED) {
+            return { data, message: message ?? null };
+        }
+        const msg = errorMessage || message || `API error (code ${statusCode})`;
+        switch (statusCode) {
+            case APP_CODES.VALIDATION:
+                throw new ValidationError(msg);
+            case APP_CODES.UNAUTHORIZED:
+                throw new AuthError(errorMessage || undefined);
+            case APP_CODES.NOT_FOUND:
+                throw new NotFoundError(errorMessage || undefined);
+            case APP_CODES.PREMIUM_REQUIRED:
+                throw new PremiumRequiredError(errorMessage || undefined);
+            case APP_CODES.INSUFFICIENT_CREDITS: {
+                const detail = errorMessage ? ` ${errorMessage}` : '';
+                throw new InsufficientCreditsError(`Insufficient credits.${detail} Check your balance with \`clipugc credits\`.`);
+            }
+            default:
+                throw new ApiError(msg, statusCode);
+        }
+    }
+    buildUrl(path, query) {
+        const base = this.baseUrl.replace(/\/+$/, '');
+        const p = path.startsWith('/') ? path : `/${path}`;
+        const url = new URL(base + p);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined && value !== null && value !== '') {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+}
+/**
+ * Build a client from persisted config/env. Throws AuthError when no API key
+ * is available (unless allowAnonymous — used by `auth login` itself).
+ */
+export async function createApiClient(opts = {}) {
+    const baseUrl = await resolveApiBaseUrl();
+    const apiKey = opts.apiKey ?? (await resolveApiKey());
+    if (!apiKey && !opts.allowAnonymous) {
+        throw new AuthError('Not logged in. Create an API key in your ClipUGC dashboard, then run `clipugc auth login`.');
+    }
+    return new ApiClient(baseUrl, apiKey);
+}
+//# sourceMappingURL=api.js.map

package/dist/services/api.js.map

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

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

@@ -0,0 +1,135 @@
+/**
+ * AI characters service — request building, client-side validation and API
+ * calls for the `clipugc characters` command group.
+ *
+ * All validation lives here (unit-testable); command handlers stay thin.
+ * Throws typed errors from utils/errors.js — never exits the process.
+ */
+import type { Pagination } from '../types/index.js';
+/** An AI character record. Unknown/extra API fields are preserved. */
+export interface AiCharacter {
+    id: number | string;
+    full_name?: string;
+    /** Server-resolved presentation name (preferred over full_name when present). */
+    display_name?: string;
+    age?: number;
+    gender?: string;
+    is_public?: boolean;
+    /** feed scope only: true when this public character is not yet unlocked. */
+    is_locked?: boolean;
+    status?: string;
+    video_count?: number;
+    picture_count?: number;
+    /** Nullable media object with clip url/thumbnail fields. */
+    preview_clip?: {
+        clip_url?: string;
+        url?: string;
+        clip_thumbnail_url?: string;
+        thumbnail_url?: string;
+        [key: string]: unknown;
+    } | null;
+    /** Staged first clip returned by create with make_video=true (nullable). */
+    character_video?: {
+        id: number | string;
+        status?: string;
+        [key: string]: unknown;
+    } | null;
+    created_at?: string;
+    [key: string]: unknown;
+}
+export declare const MAX_PER_PAGE = 50;
+export declare const NAME_MIN = 2;
+export declare const NAME_MAX = 120;
+export declare const AGE_MIN = 18;
+export declare const AGE_MAX = 99;
+/** Keys the API might wrap a character list in (tolerant unwrapping). */
+export declare const CHARACTER_LIST_KEYS: string[];
+/**
+ * Tolerant list extraction: the API sometimes returns the array directly,
+ * sometimes wrapped (data.items, data.ai_characters, ...). Tries known keys
+ * then falls back to an empty list.
+ */
+export declare function extractList<T>(data: unknown, keys: string[]): T[];
+/** Pull the pagination block out of a list response, when present. */
+export declare function extractPagination(data: unknown): Pagination | undefined;
+/**
+ * Tolerant single-record extraction: response data may be the record itself
+ * or wrapped under a known key (e.g. data.ai_character).
+ */
+export declare function extractRecord<T extends {
+    id?: unknown;
+}>(data: unknown, keys: string[]): T;
+/** Clamp per_page into [1, MAX_PER_PAGE]. Returns undefined when not given. */
+export declare function clampPerPage(perPage: number | undefined): number | undefined;
+/**
+ * Presentation name for a character: prefer the server's display_name, fall
+ * back to full_name (ignoring the "Unnamed" placeholder), then to a client
+ * default of "AI Influencer #<id>".
+ */
+export declare function getDisplayName(character: AiCharacter): string;
+/** Try known field names for a character's selected look id. */
+export declare function getSelectedLookId(character: AiCharacter): string | number | undefined;
+export interface ListCharactersOptions {
+    scope?: 'mine' | 'discover' | 'feed';
+    search?: string;
+    page?: number;
+    perPage?: number;
+}
+export interface CharacterListResult {
+    items: AiCharacter[];
+    pagination?: Pagination;
+    /** Raw response data (for --json passthrough). */
+    raw: unknown;
+}
+/** GET /ai-characters */
+export declare function listCharacters(options?: ListCharactersOptions): Promise<CharacterListResult>;
+export interface CreateCharacterInput {
+    /** Full name (required, 2-120 chars). */
+    /** Free-text description (primary path, like the web builder). 10-1000 chars. */
+    description?: string;
+    /** Optional scene/pose for the auto-generated first look. ≤600 chars. */
+    scene?: string;
+    /** Optional inspiration image file paths (≤6), uploaded multipart. */
+    inspirationFiles?: string[];
+    /** Full name (advanced/structured path; ignored when description is set). */
+    name?: string;
+    age?: number;
+    gender?: string;
+    isPublic?: boolean;
+    /** DNA fields from --dna-json (lowest precedence). */
+    dna?: Record<string, unknown>;
+    /** Appearance fields from explicit flags, already snake_cased (override dna). */
+    appearance?: Record<string, string | undefined>;
+    /** Also stage the character's first video clip (make_video, default false). */
+    makeVideo?: boolean;
+    /** Optional motion prompt for the staged first clip (requires makeVideo). */
+    motionPrompt?: string;
+}
+export declare const DESCRIPTION_MIN = 10;
+export declare const DESCRIPTION_MAX = 1000;
+export declare const CREATE_SCENE_MAX = 600;
+export declare const INSPIRATION_MAX = 6;
+/** Validate the character name (2-120 chars). Returns the trimmed name. */
+export declare function validateCharacterName(name: string | undefined): string;
+/** Validate the character age (integer 18-99). */
+export declare function validateCharacterAge(age: number): number;
+/**
+ * Build the POST /ai-characters payload.
+ * Merge order: dna-json fields first, explicit flags override.
+ */
+export declare function buildCreateCharacterPayload(input: CreateCharacterInput): Record<string, unknown>;
+/**
+ * Parse the --dna-json value: inline JSON when it starts with '{',
+ * otherwise a path to a JSON file. Must be a JSON object.
+ */
+export declare function parseDnaJson(value: string): Promise<Record<string, unknown>>;
+/** POST /ai-characters */
+export declare function createCharacter(input: CreateCharacterInput): Promise<AiCharacter>;
+/** GET /ai-characters/{id} */
+export declare function getCharacter(id: string): Promise<AiCharacter>;
+/** PATCH /ai-characters/{id} — rename (validates 2-120 chars). */
+export declare function renameCharacter(id: string, name: string): Promise<AiCharacter>;
+/** PATCH /ai-characters/{id} — publish/unpublish. */
+export declare function setCharacterVisibility(id: string, isPublic: boolean): Promise<AiCharacter>;
+/** DELETE /ai-characters/{id} */
+export declare function deleteCharacter(id: string): Promise<unknown>;

package/dist/services/characters.service.js

@@ -0,0 +1,276 @@
+/**
+ * AI characters service — request building, client-side validation and API
+ * calls for the `clipugc characters` command group.
+ *
+ * All validation lives here (unit-testable); command handlers stay thin.
+ * Throws typed errors from utils/errors.js — never exits the process.
+ */
+import fs from 'fs-extra';
+import { createApiClient } from './api.js';
+import { ValidationError } from '../utils/errors.js';
+export const MAX_PER_PAGE = 50;
+export const NAME_MIN = 2;
+export const NAME_MAX = 120;
+export const AGE_MIN = 18;
+export const AGE_MAX = 99;
+/** Keys the API might wrap a character list in (tolerant unwrapping). */
+export const CHARACTER_LIST_KEYS = ['items', 'ai_characters', 'characters', 'data'];
+/**
+ * Tolerant list extraction: the API sometimes returns the array directly,
+ * sometimes wrapped (data.items, data.ai_characters, ...). Tries known keys
+ * then falls back to an empty list.
+ */
+export function extractList(data, keys) {
+    if (Array.isArray(data))
+        return data;
+    if (data && typeof data === 'object') {
+        const obj = data;
+        for (const key of keys) {
+            if (Array.isArray(obj[key]))
+                return obj[key];
+        }
+    }
+    return [];
+}
+/** Pull the pagination block out of a list response, when present. */
+export function extractPagination(data) {
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        const pagination = data.pagination;
+        if (pagination && typeof pagination === 'object')
+            return pagination;
+    }
+    return undefined;
+}
+/**
+ * Tolerant single-record extraction: response data may be the record itself
+ * or wrapped under a known key (e.g. data.ai_character).
+ */
+export function extractRecord(data, keys) {
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        const obj = data;
+        if (obj.id !== undefined)
+            return obj;
+        for (const key of keys) {
+            const nested = obj[key];
+            if (nested &&
+                typeof nested === 'object' &&
+                !Array.isArray(nested) &&
+                nested.id !== undefined) {
+                return nested;
+            }
+        }
+    }
+    return data;
+}
+/** Clamp per_page into [1, MAX_PER_PAGE]. Returns undefined when not given. */
+export function clampPerPage(perPage) {
+    if (perPage === undefined)
+        return undefined;
+    return Math.min(Math.max(perPage, 1), MAX_PER_PAGE);
+}
+/**
+ * Presentation name for a character: prefer the server's display_name, fall
+ * back to full_name (ignoring the "Unnamed" placeholder), then to a client
+ * default of "AI Influencer #<id>".
+ */
+export function getDisplayName(character) {
+    const display = character.display_name;
+    if (typeof display === 'string' && display.trim() !== '')
+        return display;
+    const fullName = character.full_name ?? (typeof character.name === 'string' ? character.name : undefined);
+    if (typeof fullName === 'string' && fullName.trim() !== '' && fullName.trim() !== 'Unnamed')
+        return fullName;
+    return `AI Influencer #${character.id}`;
+}
+/** Try known field names for a character's selected look id. */
+export function getSelectedLookId(character) {
+    const direct = character.selected_image_id ??
+        character.selected_character_image_id ??
+        character.selected_reference_image_id ??
+        character.selected_look_id;
+    if (typeof direct === 'number' || typeof direct === 'string')
+        return direct;
+    const nested = character.selected_image ?? character.selected_look;
+    if (nested && typeof nested === 'object') {
+        const id = nested.id;
+        if (typeof id === 'number' || typeof id === 'string')
+            return id;
+    }
+    return undefined;
+}
+/** GET /ai-characters */
+export async function listCharacters(options = {}) {
+    const api = await createApiClient();
+    const raw = await api.get('/ai-characters', {
+        query: {
+            scope: options.scope ?? 'mine',
+            search: options.search,
+            page: options.page,
+            per_page: clampPerPage(options.perPage),
+        },
+    });
+    return {
+        items: extractList(raw, CHARACTER_LIST_KEYS),
+        pagination: extractPagination(raw),
+        raw,
+    };
+}
+export const DESCRIPTION_MIN = 10;
+export const DESCRIPTION_MAX = 1000;
+export const CREATE_SCENE_MAX = 600;
+export const INSPIRATION_MAX = 6;
+/** Validate the character name (2-120 chars). Returns the trimmed name. */
+export function validateCharacterName(name) {
+    const trimmed = (name ?? '').trim();
+    if (trimmed.length < NAME_MIN || trimmed.length > NAME_MAX) {
+        throw new ValidationError(`Character name must be ${NAME_MIN}-${NAME_MAX} characters (got ${trimmed.length}). Pass it with --name "Full Name".`);
+    }
+    return trimmed;
+}
+/** Validate the character age (integer 18-99). */
+export function validateCharacterAge(age) {
+    if (!Number.isInteger(age) || age < AGE_MIN || age > AGE_MAX) {
+        throw new ValidationError(`Character age must be an integer between ${AGE_MIN} and ${AGE_MAX} (got ${age}).`);
+    }
+    return age;
+}
+/**
+ * Apply the make_video / motion_prompt create options to a payload.
+ * make_video defaults to false server-side, so it is only sent when true.
+ */
+function applyMakeVideo(payload, input) {
+    const motion = input.motionPrompt?.trim();
+    if (motion && !input.makeVideo) {
+        throw new ValidationError('--motion-prompt only applies when staging a first clip — add --make-video.');
+    }
+    if (input.makeVideo) {
+        payload.make_video = true;
+        if (motion)
+            payload.motion_prompt = motion;
+    }
+}
+/**
+ * Build the POST /ai-characters payload.
+ * Merge order: dna-json fields first, explicit flags override.
+ */
+export function buildCreateCharacterPayload(input) {
+    // Primary path (matches the web builder): one free-text description; the server
+    // extracts the DNA and generates the first look in the same action.
+    if (input.description !== undefined && input.description.trim() !== '') {
+        const description = input.description.trim();
+        if (description.length < DESCRIPTION_MIN || description.length > DESCRIPTION_MAX) {
+            throw new ValidationError(`Description must be ${DESCRIPTION_MIN}-${DESCRIPTION_MAX} characters (got ${description.length}).`);
+        }
+        const payload = { description };
+        if (input.scene !== undefined && input.scene.trim() !== '') {
+            const scene = input.scene.trim();
+            if (scene.length > CREATE_SCENE_MAX) {
+                throw new ValidationError(`Scene prompt must be at most ${CREATE_SCENE_MAX} characters (got ${scene.length}).`);
+            }
+            payload.scene_prompt = scene;
+        }
+        if (input.isPublic !== undefined)
+            payload.is_public = input.isPublic;
+        applyMakeVideo(payload, input);
+        return payload;
+    }
+    // Advanced/structured path (raw DNA fields).
+    const fullName = validateCharacterName(input.name);
+    if (input.age !== undefined)
+        validateCharacterAge(input.age);
+    const payload = { ...(input.dna ?? {}) };
+    for (const [key, value] of Object.entries(input.appearance ?? {})) {
+        if (value !== undefined && value !== '')
+            payload[key] = value;
+    }
+    payload.full_name = fullName;
+    if (input.age !== undefined)
+        payload.age = input.age;
+    if (input.gender !== undefined && input.gender !== '')
+        payload.gender = input.gender;
+    if (input.isPublic !== undefined)
+        payload.is_public = input.isPublic;
+    applyMakeVideo(payload, input);
+    return payload;
+}
+/**
+ * Parse the --dna-json value: inline JSON when it starts with '{',
+ * otherwise a path to a JSON file. Must be a JSON object.
+ */
+export async function parseDnaJson(value) {
+    let parsed;
+    if (value.trimStart().startsWith('{')) {
+        try {
+            parsed = JSON.parse(value);
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            throw new ValidationError(`--dna-json is not valid JSON: ${reason}`);
+        }
+    }
+    else {
+        try {
+            parsed = await fs.readJson(value);
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            throw new ValidationError(`Could not read --dna-json file "${value}": ${reason}`);
+        }
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new ValidationError('--dna-json must be a JSON object of DNA fields, e.g. {"hair_color": "black"}.');
+    }
+    return parsed;
+}
+/** POST /ai-characters */
+export async function createCharacter(input) {
+    const payload = buildCreateCharacterPayload(input);
+    const api = await createApiClient();
+    const files = input.inspirationFiles ?? [];
+    if (files.length > 0) {
+        if (files.length > INSPIRATION_MAX) {
+            throw new ValidationError(`At most ${INSPIRATION_MAX} inspiration images are allowed (got ${files.length}).`);
+        }
+        const form = new FormData();
+        for (const [key, value] of Object.entries(payload)) {
+            form.append(key, typeof value === 'boolean' ? (value ? '1' : '0') : String(value));
+        }
+        for (const file of files) {
+            if (!(await fs.pathExists(file))) {
+                throw new ValidationError(`Inspiration image not found: ${file}`);
+            }
+            const bytes = await fs.readFile(file);
+            const name = file.split('/').pop() ?? 'inspiration.jpg';
+            form.append('inspiration_images[]', new Blob([bytes]), name);
+        }
+        const data = await api.postForm('/ai-characters', form);
+        return extractRecord(data, ['ai_character', 'character']);
+    }
+    const data = await api.post('/ai-characters', { body: payload });
+    return extractRecord(data, ['ai_character', 'character']);
+}
+/** GET /ai-characters/{id} */
+export async function getCharacter(id) {
+    const api = await createApiClient();
+    const data = await api.get(`/ai-characters/${id}`);
+    return extractRecord(data, ['ai_character', 'character']);
+}
+/** PATCH /ai-characters/{id} — rename (validates 2-120 chars). */
+export async function renameCharacter(id, name) {
+    const fullName = validateCharacterName(name);
+    const api = await createApiClient();
+    const data = await api.patch(`/ai-characters/${id}`, { body: { full_name: fullName } });
+    return extractRecord(data, ['ai_character', 'character']);
+}
+/** PATCH /ai-characters/{id} — publish/unpublish. */
+export async function setCharacterVisibility(id, isPublic) {
+    const api = await createApiClient();
+    const data = await api.patch(`/ai-characters/${id}`, { body: { is_public: isPublic } });
+    return extractRecord(data, ['ai_character', 'character']);
+}
+/** DELETE /ai-characters/{id} */
+export async function deleteCharacter(id) {
+    const api = await createApiClient();
+    return api.delete(`/ai-characters/${id}`);
+}
+//# sourceMappingURL=characters.service.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { ApiClient } from './api.js';
+/**
+ * POST /character-videos/hook-suggestions — AI-generated hook text ideas.
+ * Returns both the parsed hooks list and the raw payload (for --json mode).
+ */
+export declare function suggestHooks(api: ApiClient, context?: string): Promise<{
+    hooks: string[];
+    raw: unknown;
+}>;

package/dist/services/hooks.service.js

@@ -0,0 +1,23 @@
+/**
+ * POST /character-videos/hook-suggestions — AI-generated hook text ideas.
+ * Returns both the parsed hooks list and the raw payload (for --json mode).
+ */
+export async function suggestHooks(api, context) {
+    const body = {};
+    if (context !== undefined && context.trim() !== '') {
+        body.context = context;
+    }
+    const raw = await api.post('/character-videos/hook-suggestions', { body });
+    let hooks = [];
+    if (Array.isArray(raw)) {
+        hooks = raw.filter((h) => typeof h === 'string');
+    }
+    else if (raw && typeof raw === 'object') {
+        const candidate = raw.hooks;
+        if (Array.isArray(candidate)) {
+            hooks = candidate.filter((h) => typeof h === 'string');
+        }
+    }
+    return { hooks, raw };
+}
+//# sourceMappingURL=hooks.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.service.js","sourceRoot":"","sources":["../../src/services/hooks.service.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAc,EACd,OAAgB;IAEhB,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAU,oCAAoC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpF,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAChE,CAAC;SAAM,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAI,GAA+B,CAAC,KAAK,CAAC;QACzD,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACxB,CAAC"}