videoclaw 3.0.0-alpha.1

package/dist/video/providers/dreamina-useapi.js

@@ -0,0 +1,176 @@
+import { withRetry, fetchTransientRetry } from '../with-retry.js';
+import { safeErrorBody } from '../http-error-safety.js';
+const USEAPI_BASE = 'https://api.useapi.net/v1';
+/**
+ * Dreamina Omni Reference budget (Seedance 2.0 via UseAPI's Dreamina proxy):
+ * up to 9 image refs + 3 video refs + 3 audio refs per submission — the same
+ * 9/3/3 reference budget Seedance enforces on every gateway. Emitted as the
+ * individual `omni_N_imageRef` / `omni_N_videoRef` / `omni_N_audioRef` fields.
+ */
+export const DREAMINA_MAX_IMAGE_REFS = 9;
+export const DREAMINA_MAX_VIDEO_REFS = 3;
+export const DREAMINA_MAX_AUDIO_REFS = 3;
+/** POST https://api.useapi.net/v1/dreamina/videos — create video endpoint. */
+export function dreaminaVideosEndpoint() {
+    return `${USEAPI_BASE}/dreamina/videos`;
+}
+/** GET https://api.useapi.net/v1/dreamina/videos/{jobid} — poll endpoint. */
+export function dreaminaVideoJobEndpoint(jobid) {
+    // UseAPI path params are passed verbatim (no encoding). The namespaced jobid
+    // contains ':' and '@' which are valid in URL paths.
+    return `${USEAPI_BASE}/dreamina/videos/${jobid}`;
+}
+/** POST https://api.useapi.net/v1/dreamina/assets/{account} — upload an image/asset. */
+export function dreaminaAssetsEndpoint(account) {
+    return `${USEAPI_BASE}/dreamina/assets/${encodeURIComponent(account)}`;
+}
+export function buildDreaminaSubmitBody(input) {
+    const body = {
+        prompt: input.prompt,
+        model: input.model,
+    };
+    if (input.account)
+        body.account = input.account;
+    if (input.duration)
+        body.duration = input.duration;
+    if (input.resolution)
+        body.resolution = input.resolution;
+    // Unverified audio escape hatch (see SubmitDreaminaJobInput.audio). Seedance-2 only.
+    if (input.audio && (input.model === 'seedance-2.0' || input.model === 'seedance-2.0-fast')) {
+        body.audio = true;
+    }
+    // Omni Reference (multi-character) path: individual omni_N_imageRef /
+    // omni_N_videoRef / omni_N_audioRef fields (1-based, NOT an array), capped at
+    // 9/3/3. Mutually exclusive with the single-keyframe firstFrameRef frame mode:
+    // when any image/video/audio omni ref is present we drop firstFrameRef and
+    // ratio (Dreamina auto-detects the ratio in Omni mode just like first_frame).
+    const imageRefs = (input.imageRefs ?? []).filter(Boolean).slice(0, DREAMINA_MAX_IMAGE_REFS);
+    const videoRefs = (input.videoRefs ?? []).filter(Boolean).slice(0, DREAMINA_MAX_VIDEO_REFS);
+    const audioRefs = (input.audioRefs ?? []).filter(Boolean).slice(0, DREAMINA_MAX_AUDIO_REFS);
+    if (imageRefs.length > 0 || videoRefs.length > 0 || audioRefs.length > 0) {
+        imageRefs.forEach((ref, i) => {
+            body[`omni_${i + 1}_imageRef`] = ref;
+        });
+        videoRefs.forEach((ref, i) => {
+            body[`omni_${i + 1}_videoRef`] = ref;
+        });
+        audioRefs.forEach((ref, i) => {
+            body[`omni_${i + 1}_audioRef`] = ref;
+        });
+        // Omni mode auto-detects ratio by default; `omniRatio` forces it (the API
+        // accepts an explicit ratio here). Off → unchanged (no ratio in Omni mode).
+        if (input.omniRatio)
+            body.ratio = input.omniRatio;
+    }
+    else if (input.firstFrameRef) {
+        // first_frame mode: ratio is auto-detected from the image and cannot be sent.
+        body.firstFrameRef = input.firstFrameRef;
+    }
+    else if (input.ratio) {
+        body.ratio = input.ratio;
+    }
+    return body;
+}
+export async function submitDreaminaJob(input) {
+    const body = buildDreaminaSubmitBody(input);
+    const fetchImpl = input.fetchImpl ?? fetch;
+    // Submit is a paid, non-idempotent generation POST (seedance-2.0 1080p costs
+    // ~57 credits/second). It is deliberately NOT wrapped in withRetry: replaying
+    // the same POST on a transient 5xx could create duplicate charged jobs if the
+    // provider accepted the first request before returning a gateway error.
+    // A single attempt; a transient failure surfaces to the caller. Poll (GET) is
+    // idempotent and keeps its retry below.
+    const response = await fetchImpl(dreaminaVideosEndpoint(), {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${input.apiToken}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Dreamina submit failed: ${response.status} ${safeErrorBody(text)}`);
+    }
+    const json = (await response.json());
+    if (!json.jobid) {
+        throw new Error(`Dreamina submit returned unexpected shape (no jobid): ${JSON.stringify(json)}`);
+    }
+    return { jobid: json.jobid };
+}
+/**
+ * Maps Dreamina's `status` string to videoclaw's tri-state. Dreamina reports
+ * `created` while a job is still generating; only `completed`/`failed` are
+ * terminal.
+ */
+export function mapDreaminaStatus(raw) {
+    const s = raw.toLowerCase();
+    if (s === 'completed')
+        return 'completed';
+    if (s === 'failed')
+        return 'failed';
+    return 'pending'; // created, queued, started, etc.
+}
+/** Parses a GET /videos/{jobid} response body into videoclaw's poll result. */
+export function parseDreaminaPollResponse(json) {
+    const record = (json ?? {});
+    const status = mapDreaminaStatus(record.status ?? '');
+    const response = record.response ?? {};
+    const error = record.error
+        ? record.errorDetails
+            ? `${record.error} (${record.errorDetails})`
+            : record.error
+        : null;
+    return {
+        status,
+        videoUrl: typeof response.videoUrl === 'string' ? response.videoUrl : null,
+        coverUrl: typeof response.coverUrl === 'string' ? response.coverUrl : null,
+        error,
+        raw: (json ?? {}),
+    };
+}
+export async function pollDreaminaJob(input) {
+    const fetchImpl = input.fetchImpl ?? fetch;
+    // Retry transient network failures + HTTP 5xx; 4xx/non-ok flow through to the
+    // existing "Dreamina poll failed" message unchanged.
+    const response = await withRetry(() => fetchTransientRetry(fetchImpl, dreaminaVideoJobEndpoint(input.jobid), {
+        method: 'GET',
+        headers: { 'Authorization': `Bearer ${input.apiToken}` },
+    }));
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Dreamina poll failed: ${response.status} ${safeErrorBody(text)}`);
+    }
+    return parseDreaminaPollResponse(await response.json());
+}
+/**
+ * Uploads raw image bytes to Dreamina and returns the `assetRef` to use as a
+ * keyframe (first frame) in a video generation request.
+ */
+export async function uploadDreaminaAsset(input) {
+    const fetchImpl = input.fetchImpl ?? fetch;
+    const response = await fetchImpl(dreaminaAssetsEndpoint(input.account), {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${input.apiToken}`,
+            'Content-Type': input.contentType ?? 'image/jpeg',
+        },
+        body: input.bytes,
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Dreamina asset upload failed: ${response.status} ${safeErrorBody(text)}`);
+    }
+    // assetRef is the canonical field; imageRef is a legacy alias (images only).
+    const json = (await response.json());
+    const assetRef = json.assetRef ?? json.imageRef;
+    if (!assetRef) {
+        throw new Error(`Dreamina asset upload returned no assetRef: ${JSON.stringify(json)}`);
+    }
+    return {
+        assetRef,
+        width: typeof json.width === 'number' ? json.width : null,
+        height: typeof json.height === 'number' ? json.height : null,
+    };
+}
+//# sourceMappingURL=dreamina-useapi.js.map

package/dist/video/providers/dreamina-useapi.js.map

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

package/dist/video/providers/flowmusic-useapi.d.ts

@@ -0,0 +1,114 @@
+/**
+ * FlowMusic (useapi.net) transport — Google Lyria 3 Pro vocal-song generation.
+ *
+ * Pure transport: submit → poll → download. Mirrors providers/dreamina-useapi.ts
+ * (async job, namespaced jobid, signed-URL/auth download) and reuses the SAME
+ * useapi.net bearer token as the dreamina/runway routes (USEAPI_API_TOKEN).
+ *
+ * AUTHORITATIVE SPEC: https://useapi.net/assets/aibot/api-flowmusic-v1.txt
+ * (the rendered docs page returns fabricated fields — do not trust it). Key
+ * facts encoded here: status enum is exactly pending|completed|failed (NO
+ * submitted/processing); `POST /flowmusic/music` with mode:'async' returns a
+ * jobid to poll; each generation yields up to TWO clips (an A/B pair) each with
+ * a signed `audio_url` (m4a) + `wav_url`, plus an encoded `clip` id usable with
+ * the auth'd `GET /flowmusic/music/download?id=<clip>&format=mp3` (raw mp3
+ * bytes). The jobid contains ':' and '@' and MUST be percent-encoded in the
+ * poll/download paths.
+ */
+export type FlowMusicGhostwriter = 'standard' | 'pro';
+/**
+ * Minimal `fetch` shape that lets tests inject a mock. Adds `arrayBuffer()` for
+ * the binary mp3 download endpoint (submit/poll only need json()/text()).
+ */
+export type FlowMusicFetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string | Uint8Array;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text: () => Promise<string>;
+    json: () => Promise<unknown>;
+    arrayBuffer: () => Promise<ArrayBuffer>;
+}>;
+/** Prompt length ceiling per the FlowMusic spec. */
+export declare const FLOWMUSIC_MAX_PROMPT_CHARS = 10000;
+export interface SubmitFlowMusicJobInput {
+    apiToken: string;
+    /** Song description (style, mood, genre, instruments, BPM, vocal direction). Required, 1..10000 chars. */
+    prompt: string;
+    /** flowmusic.app account email to pin; omitted → useapi auto-selects an account with capacity. */
+    account?: string;
+    /** Force an instrumental render (prepends an [Instrumental] tag). Only emitted when true. */
+    instrumental?: boolean;
+    /** User-supplied lyrics ([Verse]/[Chorus]-tagged). Present ⇒ a vocal render of these words. */
+    lyrics?: string;
+    /** Lyrics-writer version used when the MODEL writes lyrics; ignored by the API when lyrics are supplied. */
+    ghostwriter?: FlowMusicGhostwriter;
+    /** Optional fetch override (defaults to global fetch). Used by tests + the native backend. */
+    fetchImpl?: FlowMusicFetchLike;
+}
+export interface SubmitFlowMusicJobResult {
+    /** Namespaced jobid, e.g. "job:<uuid>-user:<id>-<email>-bot:flowmusic". Percent-encode in poll. */
+    jobid: string;
+    status: FlowMusicPollStatus;
+}
+/** POST https://api.useapi.net/v1/flowmusic/music — create song endpoint. */
+export declare function flowmusicMusicEndpoint(): string;
+/** GET https://api.useapi.net/v1/flowmusic/jobs/{jobid} — poll endpoint (jobid percent-encoded). */
+export declare function flowmusicJobEndpoint(jobid: string): string;
+/** GET https://api.useapi.net/v1/flowmusic/music/download?id={clip}&format=mp3 — raw mp3 bytes (auth). */
+export declare function flowmusicDownloadEndpoint(clip: string): string;
+/**
+ * Builds the `POST /flowmusic/music` body. Always `mode:'async'` so submit
+ * returns a jobid to poll rather than blocking the CLI for the ~40–150 s sync
+ * render. Optional fields are omitted when unset (never sent null), matching the
+ * dreamina/suno convention.
+ */
+export declare function buildFlowMusicSubmitBody(input: SubmitFlowMusicJobInput): Record<string, unknown>;
+export declare function submitFlowMusicJob(input: SubmitFlowMusicJobInput): Promise<SubmitFlowMusicJobResult>;
+export type FlowMusicPollStatus = 'pending' | 'completed' | 'failed';
+export interface FlowMusicClip {
+    /** Encoded clip asset id; used with /music/download and /music/edit. */
+    clip: string;
+    title: string | null;
+    /** Clip length in seconds, when present on the job record. */
+    durationS: number | null;
+    /** Signed m4a URL (public, no auth) when present. */
+    audioUrl: string | null;
+    /** Signed wav URL (public, no auth) when present. */
+    wavUrl: string | null;
+    /** Auto-generated artwork URL, when present. */
+    imageUrl: string | null;
+}
+export interface PollFlowMusicJobResult {
+    status: FlowMusicPollStatus;
+    /** Up to two clips (an A/B pair) on a completed job. */
+    clips: FlowMusicClip[];
+    /** Error summary on failure, e.g. "moderation_reject: ...". */
+    error: string | null;
+    raw: Record<string, unknown>;
+}
+/** FlowMusic status is exactly pending|completed|failed (no submitted/processing/created). */
+export declare function mapFlowMusicStatus(raw: string): FlowMusicPollStatus;
+/** Parses a GET /jobs/{jobid} (or sync POST) response into videoclaw's poll result. */
+export declare function parseFlowMusicJobResponse(json: unknown): PollFlowMusicJobResult;
+export interface PollFlowMusicJobInput {
+    apiToken: string;
+    /** Namespaced jobid from SubmitFlowMusicJobResult. */
+    jobid: string;
+    fetchImpl?: FlowMusicFetchLike;
+}
+export declare function pollFlowMusicJob(input: PollFlowMusicJobInput): Promise<PollFlowMusicJobResult>;
+export interface DownloadFlowMusicClipInput {
+    apiToken: string;
+    /** Encoded clip asset id from a completed job's clips[].clip. */
+    clip: string;
+    fetchImpl?: FlowMusicFetchLike;
+}
+/**
+ * Fetches raw mp3 bytes for a completed clip via the auth'd download endpoint.
+ * Keeps the MusicBackend `.mp3` contract intact (the signed audio_url is m4a).
+ */
+export declare function downloadFlowMusicClipMp3(input: DownloadFlowMusicClipInput): Promise<Uint8Array>;
+//# sourceMappingURL=flowmusic-useapi.d.ts.map

package/dist/video/providers/flowmusic-useapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowmusic-useapi.d.ts","sourceRoot":"","sources":["../../../src/video/providers/flowmusic-useapi.ts"],"names":[],"mappings":"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"}

package/dist/video/providers/flowmusic-useapi.js

@@ -0,0 +1,159 @@
+/**
+ * FlowMusic (useapi.net) transport — Google Lyria 3 Pro vocal-song generation.
+ *
+ * Pure transport: submit → poll → download. Mirrors providers/dreamina-useapi.ts
+ * (async job, namespaced jobid, signed-URL/auth download) and reuses the SAME
+ * useapi.net bearer token as the dreamina/runway routes (USEAPI_API_TOKEN).
+ *
+ * AUTHORITATIVE SPEC: https://useapi.net/assets/aibot/api-flowmusic-v1.txt
+ * (the rendered docs page returns fabricated fields — do not trust it). Key
+ * facts encoded here: status enum is exactly pending|completed|failed (NO
+ * submitted/processing); `POST /flowmusic/music` with mode:'async' returns a
+ * jobid to poll; each generation yields up to TWO clips (an A/B pair) each with
+ * a signed `audio_url` (m4a) + `wav_url`, plus an encoded `clip` id usable with
+ * the auth'd `GET /flowmusic/music/download?id=<clip>&format=mp3` (raw mp3
+ * bytes). The jobid contains ':' and '@' and MUST be percent-encoded in the
+ * poll/download paths.
+ */
+import { withRetry, fetchTransientRetry } from '../with-retry.js';
+const USEAPI_BASE = 'https://api.useapi.net/v1';
+const FLOWMUSIC_BASE = `${USEAPI_BASE}/flowmusic`;
+/** Prompt length ceiling per the FlowMusic spec. */
+export const FLOWMUSIC_MAX_PROMPT_CHARS = 10000;
+/** POST https://api.useapi.net/v1/flowmusic/music — create song endpoint. */
+export function flowmusicMusicEndpoint() {
+    return `${FLOWMUSIC_BASE}/music`;
+}
+/** GET https://api.useapi.net/v1/flowmusic/jobs/{jobid} — poll endpoint (jobid percent-encoded). */
+export function flowmusicJobEndpoint(jobid) {
+    // The namespaced jobid contains ':' and '@'; FlowMusic requires it encoded.
+    return `${FLOWMUSIC_BASE}/jobs/${encodeURIComponent(jobid)}`;
+}
+/** GET https://api.useapi.net/v1/flowmusic/music/download?id={clip}&format=mp3 — raw mp3 bytes (auth). */
+export function flowmusicDownloadEndpoint(clip) {
+    return `${FLOWMUSIC_BASE}/music/download?id=${encodeURIComponent(clip)}&format=mp3`;
+}
+/**
+ * Builds the `POST /flowmusic/music` body. Always `mode:'async'` so submit
+ * returns a jobid to poll rather than blocking the CLI for the ~40–150 s sync
+ * render. Optional fields are omitted when unset (never sent null), matching the
+ * dreamina/suno convention.
+ */
+export function buildFlowMusicSubmitBody(input) {
+    const body = {
+        prompt: input.prompt,
+        mode: 'async',
+    };
+    if (input.account)
+        body.email = input.account;
+    if (input.instrumental === true)
+        body.instrumental = true;
+    if (input.lyrics && input.lyrics.trim() !== '')
+        body.lyrics = input.lyrics;
+    if (input.ghostwriter)
+        body.ghostwriter = input.ghostwriter;
+    return body;
+}
+export async function submitFlowMusicJob(input) {
+    const body = buildFlowMusicSubmitBody(input);
+    const fetchImpl = input.fetchImpl ?? fetch;
+    // Paid, non-idempotent generation POST (~5 credits) — deliberately NOT
+    // retried: replaying on a transient 5xx could create a duplicate charged job
+    // if the provider accepted the first request before the gateway error. Poll
+    // (GET) is idempotent and keeps its retry below.
+    const response = await fetchImpl(flowmusicMusicEndpoint(), {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${input.apiToken}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`FlowMusic submit failed: ${response.status} ${text}`);
+    }
+    const json = (await response.json());
+    if (!json.jobid) {
+        throw new Error(`FlowMusic submit returned unexpected shape (no jobid): ${JSON.stringify(json)}`);
+    }
+    return { jobid: json.jobid, status: mapFlowMusicStatus(json.status ?? 'pending') };
+}
+/** FlowMusic status is exactly pending|completed|failed (no submitted/processing/created). */
+export function mapFlowMusicStatus(raw) {
+    const s = raw.toLowerCase();
+    if (s === 'completed')
+        return 'completed';
+    if (s === 'failed')
+        return 'failed';
+    return 'pending';
+}
+/** Defensive parse of a single clip object; returns null if it lacks a clip id. */
+function parseClip(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const c = raw;
+    const clip = typeof c.clip === 'string' ? c.clip : null;
+    if (!clip)
+        return null;
+    return {
+        clip,
+        title: typeof c.title === 'string' ? c.title : null,
+        durationS: typeof c.duration_s === 'number' ? c.duration_s : null,
+        audioUrl: typeof c.audio_url === 'string' ? c.audio_url : null,
+        wavUrl: typeof c.wav_url === 'string' ? c.wav_url : null,
+        imageUrl: typeof c.image_url === 'string' ? c.image_url : null,
+    };
+}
+/** Parses a GET /jobs/{jobid} (or sync POST) response into videoclaw's poll result. */
+export function parseFlowMusicJobResponse(json) {
+    const record = (json ?? {});
+    const status = mapFlowMusicStatus(record.status ?? '');
+    const clips = Array.isArray(record.clips)
+        ? record.clips.map(parseClip).filter((c) => c !== null)
+        : [];
+    let error = null;
+    if (record.error) {
+        if (typeof record.error === 'string') {
+            error = record.error;
+        }
+        else {
+            const code = record.error.code ?? '';
+            const message = record.error.message ?? '';
+            error = [code, message].filter(Boolean).join(': ') || null;
+        }
+    }
+    return { status, clips, error, raw: (json ?? {}) };
+}
+export async function pollFlowMusicJob(input) {
+    const fetchImpl = input.fetchImpl ?? fetch;
+    // Retry transient network failures + HTTP 5xx; 4xx/non-ok flow through to the
+    // "FlowMusic poll failed" message unchanged.
+    const response = await withRetry(() => fetchTransientRetry(fetchImpl, flowmusicJobEndpoint(input.jobid), {
+        method: 'GET',
+        headers: { Authorization: `Bearer ${input.apiToken}` },
+    }));
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`FlowMusic poll failed: ${response.status} ${text}`);
+    }
+    return parseFlowMusicJobResponse(await response.json());
+}
+/**
+ * Fetches raw mp3 bytes for a completed clip via the auth'd download endpoint.
+ * Keeps the MusicBackend `.mp3` contract intact (the signed audio_url is m4a).
+ */
+export async function downloadFlowMusicClipMp3(input) {
+    const fetchImpl = input.fetchImpl ?? fetch;
+    const response = await withRetry(() => fetchTransientRetry(fetchImpl, flowmusicDownloadEndpoint(input.clip), {
+        method: 'GET',
+        headers: { Authorization: `Bearer ${input.apiToken}` },
+    }));
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`FlowMusic download failed: ${response.status} ${text}`);
+    }
+    const buf = await response.arrayBuffer();
+    return new Uint8Array(buf);
+}
+//# sourceMappingURL=flowmusic-useapi.js.map

package/dist/video/providers/flowmusic-useapi.js.map

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

package/dist/video/providers/google-flow.d.ts

@@ -0,0 +1,57 @@
+/**
+ * google-flow.ts — UseAPI Google Flow (Veo) REST client. Reachable with the same
+ * `USEAPI_API_TOKEN` as the other UseAPI routes (no cookie.json, no new key).
+ *
+ * Scope (for now): the FREE 1080p video UPSCALE. The Veo upsampler synthesizes
+ * real detail (skin/dust/edges) rather than just sharpening, so it beats a local
+ * lanczos finish — but it ONLY accepts a video Flow itself GENERATED, addressed
+ * by `mediaGenerationId` (it rejects an externally uploaded/edited clip). So this
+ * is the per-clip upscale at the GENERATION stage (right after a Flow i2v render,
+ * when the mediaGenerationId is in hand), complementary to the file-based Topaz /
+ * Real-ESRGAN `finish` of a stitched master. Re-upscaling the same id is cached
+ * (no extra credits). 1080p is free on any plan; 4K costs 50 credits (Ultra only).
+ */
+export type GoogleFlowFetchLike = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+}>;
+export declare const GOOGLE_FLOW_BASE = "https://api.useapi.net/v1/google-flow";
+export type GoogleFlowUpscaleResolution = '1080p' | '4K';
+export interface UpscaleFlowVideoInput {
+    /** Bearer token (USEAPI_API_TOKEN). */
+    apiToken: string;
+    /** A Flow-GENERATED video id (`user:..-email:..-video:..`). NOT an uploaded/edited file. */
+    mediaGenerationId: string;
+    /** Target resolution. '1080p' (default) is free; '4K' costs 50 credits + Ultra. */
+    resolution?: GoogleFlowUpscaleResolution;
+    fetchImpl?: GoogleFlowFetchLike;
+    /**
+     * Transient-retry budget for 429/5xx/network errors (default 2). Retrying is
+     * SAFE here: useapi Flow endpoints throttle routinely, and re-upscaling the
+     * same mediaGenerationId is cached server-side (no extra credits).
+     */
+    maxRetries?: number;
+    /** Base backoff between retries, ms (default 1000; grows linearly). */
+    retryBackoffMs?: number;
+}
+export interface UpscaleFlowVideoResult {
+    /** Signed MP4 URL of the upscaled video (download promptly — it expires). */
+    videoUrl: string;
+    /** The upscaled clip's own Flow media id (re-upscale/chain target). */
+    mediaGenerationId: string | null;
+    /** Credits left after the call (1080p leaves it unchanged — it's free). */
+    remainingCredits: number | null;
+    raw: unknown;
+}
+/**
+ * Upscale a Flow-generated video (synchronous; 30–60s). Throws on a non-2xx
+ * response or a body without a video URL. The `mediaGenerationId` MUST be a Flow
+ * generation — an external/edited clip is rejected by the API.
+ */
+export declare function upscaleFlowVideo(input: UpscaleFlowVideoInput): Promise<UpscaleFlowVideoResult>;
+//# sourceMappingURL=google-flow.d.ts.map

package/dist/video/providers/google-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-flow.d.ts","sourceRoot":"","sources":["../../../src/video/providers/google-flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KACrE,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAEvE,eAAO,MAAM,gBAAgB,0CAA0C,CAAC;AAExE,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,IAAI,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAoDpG"}

package/dist/video/providers/google-flow.js

@@ -0,0 +1,63 @@
+export const GOOGLE_FLOW_BASE = 'https://api.useapi.net/v1/google-flow';
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * Upscale a Flow-generated video (synchronous; 30–60s). Throws on a non-2xx
+ * response or a body without a video URL. The `mediaGenerationId` MUST be a Flow
+ * generation — an external/edited clip is rejected by the API.
+ */
+export async function upscaleFlowVideo(input) {
+    const fetchImpl = input.fetchImpl ?? globalThis.fetch;
+    const maxRetries = input.maxRetries ?? 2;
+    const backoffMs = input.retryBackoffMs ?? 1000;
+    const body = JSON.stringify({
+        mediaGenerationId: input.mediaGenerationId,
+        resolution: input.resolution ?? '1080p',
+    });
+    // 429/503 are routine operational statuses on useapi Flow endpoints; a
+    // re-upscale of the same id is cached (free), so transient retry is safe.
+    let status = 0;
+    let text = '';
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            const response = await fetchImpl(`${GOOGLE_FLOW_BASE}/videos/upscale`, {
+                method: 'POST',
+                headers: { Authorization: `Bearer ${input.apiToken}`, 'Content-Type': 'application/json' },
+                body,
+            });
+            status = response.status;
+            text = await response.text();
+            if (response.ok)
+                break;
+        }
+        catch (err) {
+            status = 0;
+            text = err.message ?? 'network error';
+        }
+        const transient = status === 0 || status === 429 || status >= 500;
+        if (!transient || attempt === maxRetries) {
+            throw new Error(`google-flow upscale failed (${status || '?'}): ${text.slice(0, 300)}`);
+        }
+        await sleep(backoffMs * (attempt + 1));
+    }
+    // Flow embeds literal newlines inside prompt fields, so parse the WHOLE body
+    // (never line-split). Fall back to a regex for the signed URL if JSON is odd.
+    let parsed = {};
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        /* fall through to regex */
+    }
+    const media = parsed.media?.[0];
+    const videoUrl = media?.videoUrl ?? (text.match(/https:\/\/[^"\\]+\.mp4[^"\\]*/) ?? [])[0];
+    if (!videoUrl) {
+        throw new Error(`google-flow upscale returned no videoUrl: ${text.slice(0, 300)}`);
+    }
+    return {
+        videoUrl,
+        mediaGenerationId: media?.mediaGenerationId ?? null,
+        remainingCredits: typeof parsed.remainingCredits === 'number' ? parsed.remainingCredits : null,
+        raw: parsed,
+    };
+}
+//# sourceMappingURL=google-flow.js.map

package/dist/video/providers/google-flow.js.map

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

package/dist/video/providers/public-host.d.ts

@@ -0,0 +1,40 @@
+export type PublicHostFetchLike = (url: string, init?: {
+    method?: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+}>;
+/** Default temporary host. Override via `VCLAW_PUBLIC_HOST_ENDPOINT` for self-hosting. */
+export declare const UGUU_ENDPOINT = "https://uguu.se/upload.php";
+/** uguu.se's documented upload cap. Override via maxBytes / VCLAW_PUBLIC_HOST_MAX_BYTES. */
+export declare const DEFAULT_PUBLIC_HOST_MAX_BYTES: number;
+export interface HostPublicUrlOptions {
+    fetchImpl?: PublicHostFetchLike;
+    env?: NodeJS.ProcessEnv;
+    /** Override the multipart field name (uguu uses `files[]`). */
+    fieldName?: string;
+    /** Override the upload endpoint. */
+    endpoint?: string;
+    /**
+     * Reject files larger than this BEFORE reading them into memory (default
+     * {@link DEFAULT_PUBLIC_HOST_MAX_BYTES} — uguu's cap; also settable via
+     * VCLAW_PUBLIC_HOST_MAX_BYTES for self-hosted endpoints with other limits).
+     */
+    maxBytes?: number;
+}
+export interface HostPublicUrlResult {
+    /** The public HTTPS URL a hosted backend can fetch. */
+    url: string;
+    /** Raw parsed upload response (for logging/diagnostics). */
+    rawResult: unknown;
+}
+/**
+ * Upload `localPath` and return a public URL. Throws on a non-2xx response or an
+ * unparseable body. Uses the global `fetch`/`FormData`/`Blob` (Node 20+) unless
+ * an injected `fetchImpl` is provided.
+ */
+export declare function hostPublicUrl(localPath: string, options?: HostPublicUrlOptions): Promise<HostPublicUrlResult>;
+//# sourceMappingURL=public-host.d.ts.map