@clipwright/core 0.30.0 → 0.31.0

package/dist/generations.js

@@ -0,0 +1,215 @@
+import { z } from "zod";
+import { GENERATION_KINDS } from "./generations-output.js";
+import { runId } from "./runs.js";
+import { uploadId } from "./uploads.js";
+export const GENERATION_MODELS_PATH = "/v1/generations/models";
+export const GENERATE_IMAGE_QUOTE_PATH = "/v1/skills/generate_image/quote";
+export const GENERATE_IMAGE_RUN_PATH = "/v1/skills/generate_image/run";
+export const GENERATE_VIDEO_QUOTE_PATH = "/v1/skills/generate_video/quote";
+export const GENERATE_VIDEO_RUN_PATH = "/v1/skills/generate_video/run";
+export const GENERATION_IMAGE_MODELS = ["seedream-5.0-flash", "flare"];
+export const GENERATION_VIDEO_MODELS = ["seedance-2.0", "seedance-2.0-mini", "seedance-2.0-fast", "seedance-2.5"];
+export const GENERATION_IMAGE_ASPECTS = ["9:16", "16:9", "1:1"];
+export const GENERATION_VIDEO_ASPECTS = ["9:16", "16:9"];
+export const GENERATION_RESOLUTIONS = ["480p", "720p", "1080p"];
+export const GENERATION_VIDEO_MODES = ["text", "first_frame", "reference"];
+export const GENERATION_MAX_REFERENCES = 4;
+export const GENERATION_VIDEO_FPS = 24;
+export const GENERATION_PROMPT_MAX_CHARS = 2000;
+const image = (aspect_ratio, width, height, unit_credits, measured = false) => ({ aspect_ratio, width, height, unit_credits, measured });
+const H264 = { codec: "h264", pix_fmt: "yuv420p" };
+const UNPROBED = { codec: null, pix_fmt: null };
+/** Rows in both aspects of one resolution; `measured` holds the aspects probed live (19.10 paid tests, ffprobe of the clips). */
+function video(resolution, short, long, unit_credits, probed, measured = {}, warning) {
+    const extra = warning === undefined ? {} : { warning };
+    return [
+        { aspect_ratio: "9:16", resolution, width: short, height: long, ...probed, unit_credits, measured: measured.vertical ?? false, ...extra },
+        { aspect_ratio: "16:9", resolution, width: long, height: short, ...probed, unit_credits, measured: measured.horizontal ?? false, ...extra },
+    ];
+}
+const HEVC10 = { codec: "hevc", pix_fmt: "yuv420p10le" };
+const SEEDANCE_2_0_MODES = { text: true, first_frame: true, reference: false };
+const DRAFT_480P = "480p draft is 496x864 (2.1% off 9:16), as the vendor renders it; we do not crop it";
+/** The one table of models, shapes and prices (D0, D7): schema, quote, admission and the models list read it. */
+export const GENERATION_CAPABILITIES = deepFreeze({
+    "seedream-5.0-flash": {
+        kind: "image",
+        vendor: "byteplus",
+        vendor_model: { text: "dola-seedream-5-0-flash-260915", reference: "dola-seedream-5-0-flash-260915" },
+        rows: [image("9:16", 1440, 2560, 12, true), image("16:9", 2560, 1440, 12, true), image("1:1", 2048, 2048, 12, true)],
+    },
+    flare: {
+        kind: "image",
+        vendor: "fal",
+        vendor_model: { text: "openai/gpt-image-2.5/flare/text-to-image", reference: "openai/gpt-image-2.5/flare/edit" },
+        rows: [image("9:16", 1008, 1792, 18, true), image("16:9", 1792, 1008, 18), image("1:1", 1024, 1024, 18)],
+    },
+    "seedance-2.0": {
+        kind: "video",
+        vendor: "byteplus",
+        vendor_model: "dreamina-seedance-2-0-260128",
+        fps: GENERATION_VIDEO_FPS,
+        modes: SEEDANCE_2_0_MODES,
+        duration_s: { min: 4, max: 15 },
+        rows: [...video("480p", 480, 854, 45, UNPROBED), ...video("720p", 720, 1280, 100, H264, { vertical: true }),
+            ...video("1080p", 1080, 1920, 250, H264, { vertical: true, horizontal: true })],
+    },
+    "seedance-2.0-mini": {
+        kind: "video",
+        vendor: "byteplus",
+        vendor_model: "dreamina-seedance-2-0-mini-260615",
+        fps: GENERATION_VIDEO_FPS,
+        modes: { text: true, first_frame: true, reference: true },
+        duration_s: { min: 4, max: 15 },
+        rows: [...video("480p", 496, 864, 25, H264, { vertical: true }, DRAFT_480P),
+            ...video("720p", 720, 1280, 50, H264, { vertical: true, horizontal: true })],
+    },
+    "seedance-2.0-fast": {
+        kind: "video",
+        vendor: "byteplus",
+        vendor_model: "dreamina-seedance-2-0-fast-260128",
+        fps: GENERATION_VIDEO_FPS,
+        modes: SEEDANCE_2_0_MODES,
+        duration_s: { min: 4, max: 15 },
+        rows: [...video("480p", 480, 854, 35, UNPROBED), ...video("720p", 720, 1280, 80, H264, { vertical: true })],
+    },
+    "seedance-2.5": {
+        kind: "video",
+        vendor: "byteplus",
+        vendor_model: "dreamina-seedance-2-5-260628",
+        fps: GENERATION_VIDEO_FPS,
+        modes: { text: false, first_frame: true, reference: false },
+        duration_s: { min: 4, max: 30 },
+        rows: [...video("480p", 480, 854, 70, UNPROBED), ...video("720p", 720, 1280, 150, H264, { vertical: true }),
+            ...video("1080p", 1080, 1920, 380, HEVC10, { vertical: true }, "seedance-2.5 at 1080p is HEVC 10-bit (yuv420p10le); some browsers and editors do not play it")],
+    },
+});
+function deepFreeze(value) {
+    if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
+        Object.freeze(value);
+        for (const inner of Object.values(value))
+            deepFreeze(inner);
+    }
+    return value;
+}
+/** A reference: an own upload with its rights confirmed, or a prior image generation of the same account. */
+export const generationReference = z.union([
+    z.strictObject({ upload_id: uploadId, rights_confirmed: z.literal(true) }),
+    z.strictObject({ run_id: runId }),
+]);
+const prompt = z.string().trim().min(1).max(GENERATION_PROMPT_MAX_CHARS);
+/** No `visible_ai_label`: an unknown key is refused, never passed to the provenance policy (D12). */
+export const generateImageRequest = z.strictObject({
+    prompt,
+    model: z.enum(GENERATION_IMAGE_MODELS),
+    aspect_ratio: z.enum(GENERATION_IMAGE_ASPECTS),
+    references: z.array(generationReference).max(GENERATION_MAX_REFERENCES).optional(),
+});
+/** No audio field: the vendor is always asked for a silent clip. */
+export const generateVideoRequest = z.strictObject({
+    prompt,
+    model: z.enum(GENERATION_VIDEO_MODELS),
+    mode: z.enum(GENERATION_VIDEO_MODES),
+    aspect_ratio: z.enum(GENERATION_VIDEO_ASPECTS),
+    resolution: z.enum(GENERATION_RESOLUTIONS),
+    duration_s: z.number().int().positive().safe(),
+    first_frame: generationReference.optional(),
+    last_frame: generationReference.optional(),
+    references: z.array(generationReference).min(1).max(GENERATION_MAX_REFERENCES).optional(),
+}).superRefine((request, context) => {
+    const issue = (path, message) => context.addIssue({ code: z.ZodIssueCode.custom, path: [path], message });
+    const { min, max } = GENERATION_CAPABILITIES[request.model].duration_s;
+    if (request.duration_s < min || request.duration_s > max) {
+        issue("duration_s", `${request.model} takes ${min} to ${max} seconds`);
+    }
+    if (request.mode === "first_frame" && request.first_frame === undefined)
+        issue("first_frame", "first_frame mode requires first_frame");
+    if (request.mode !== "first_frame") {
+        if (request.first_frame !== undefined)
+            issue("first_frame", "first_frame is only accepted in first_frame mode");
+        if (request.last_frame !== undefined)
+            issue("last_frame", "last_frame is only accepted in first_frame mode");
+    }
+    if (request.mode === "reference" && request.references === undefined)
+        issue("references", "reference mode requires 1 to 4 references");
+    if (request.mode !== "reference" && request.references !== undefined)
+        issue("references", "references are only accepted in reference mode");
+});
+function isVideoRequest(request) {
+    return GENERATION_VIDEO_MODELS.includes(request.model);
+}
+/** The measured row a request falls on, or `null` for a combination we do not offer or have not measured. */
+export function findCapabilityRow(request) {
+    if (isVideoRequest(request)) {
+        const capability = GENERATION_CAPABILITIES[request.model];
+        const { min, max } = capability.duration_s;
+        if (!capability.modes[request.mode] || request.duration_s < min || request.duration_s > max)
+            return null;
+        const row = capability.rows.find((one) => one.aspect_ratio === request.aspect_ratio && one.resolution === request.resolution);
+        return row?.measured ? { kind: "video", model: request.model, capability, row } : null;
+    }
+    const capability = GENERATION_CAPABILITIES[request.model];
+    const row = capability.rows.find((one) => one.aspect_ratio === request.aspect_ratio);
+    return row?.measured ? { kind: "image", model: request.model, capability, row } : null;
+}
+/** The price from the same table: an image is one unit, a clip one unit per requested second. `null` where no row is offered. */
+export function priceGeneration(request) {
+    const match = findCapabilityRow(request);
+    if (match === null)
+        return null;
+    const units = match.kind === "video" && isVideoRequest(request) ? request.duration_s : 1;
+    return { unit_credits: match.row.unit_credits, units, credits: match.row.unit_credits * units };
+}
+export const generationQuote = z.strictObject({
+    skill: z.enum(["generate_image", "generate_video"]),
+    kind: z.enum(GENERATION_KINDS),
+    model: z.string().min(1),
+    unit: z.enum(["image", "second"]),
+    unit_credits: z.number().int().positive(),
+    units: z.number().int().positive(),
+    credits: z.number().int().positive(),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    duration_s: z.number().int().positive().nullable(),
+    warnings: z.array(z.string()),
+    contract_version: z.string().min(1),
+});
+const listedRow = z.strictObject({
+    aspect_ratio: z.string().min(1),
+    resolution: z.enum(GENERATION_RESOLUTIONS).nullable(),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    unit_credits: z.number().int().positive(),
+});
+/** One offered model: vendors are not named, and only measured modes and rows are shown. */
+const listedModel = z.strictObject({
+    model: z.string().min(1),
+    kind: z.enum(GENERATION_KINDS),
+    unit: z.enum(["image", "second"]),
+    modes: z.array(z.enum(GENERATION_VIDEO_MODES)).nullable(),
+    duration_s: z.strictObject({ min: z.number().int().positive(), max: z.number().int().positive() }).nullable(),
+    max_references: z.number().int().nonnegative(),
+    rows: z.array(listedRow).min(1),
+});
+export const generationModels = z.strictObject({
+    models: z.array(listedModel),
+    contract_version: z.string().min(1),
+});
+/** The models list from the table: a model with no measured row, or a video model with no measured mode, is left out. */
+export function listGenerationModels() {
+    return Object.keys(GENERATION_CAPABILITIES).flatMap((model) => {
+        const capability = GENERATION_CAPABILITIES[model];
+        if (capability.kind === "image") {
+            const rows = capability.rows.filter((row) => row.measured)
+                .map(({ aspect_ratio, width, height, unit_credits }) => ({ aspect_ratio, resolution: null, width, height, unit_credits }));
+            return rows.length === 0 ? [] : [{ model, kind: "image", unit: "image", modes: null, duration_s: null,
+                    max_references: GENERATION_MAX_REFERENCES, rows }];
+        }
+        const modes = GENERATION_VIDEO_MODES.filter((mode) => capability.modes[mode]);
+        const rows = capability.rows.filter((row) => row.measured)
+            .map(({ aspect_ratio, resolution, width, height, unit_credits }) => ({ aspect_ratio, resolution, width, height, unit_credits }));
+        return rows.length === 0 || modes.length === 0 ? [] : [{ model, kind: "video", unit: "second", modes,
+                duration_s: { ...capability.duration_s }, max_references: modes.includes("reference") ? GENERATION_MAX_REFERENCES : 0, rows }];
+    });
+}
+//# sourceMappingURL=generations.js.map

package/dist/generations.js.map

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

package/dist/idempotency.d.ts

@@ -14,5 +14,7 @@ export declare function actorIdempotencyKeyFor(input: unknown, clientId: string)
 export declare function revisionIdempotencyKeyFor(sourceRunId: string, request: unknown, clientId: string): string;
 /** The key of a shot candidate: the source run and the request with its take, parsed, under the client's prefix. */
 export declare function candidateIdempotencyKeyFor(sourceRunId: string, request: unknown, clientId: string): string;
+/** The key of a single generation: the skill and its request, parsed, under the client's prefix. */
+export declare function generationIdempotencyKeyFor(skill: "generate_image" | "generate_video", request: unknown, clientId: string): string;
 /** The same key for `make_faceless`, parsed by its own union schema. */
 export declare function facelessIdempotencyKeyFor(input: unknown, clientId: string): string;

package/dist/idempotency.js

@@ -3,6 +3,7 @@ import { createActorInput } from "./account-actors.js";
 import { candidateRequest } from "./edit-candidate.js";
 import { revisionRequest } from "./edit-revision.js";
 import { makeFacelessInput } from "./faceless-public.js";
+import { generateImageRequest, generateVideoRequest } from "./generations.js";
 import { runId } from "./runs.js";
 import { makeUgcInput } from "./skills.js";
 // Request fingerprint and per-client idempotency key. A subpath export, not the barrel:
@@ -62,6 +63,13 @@ export function candidateIdempotencyKeyFor(sourceRunId, request, clientId) {
         .update(clientId + JSON.stringify(canonicalize(parsed)))
         .digest("hex");
 }
+/** The key of a single generation: the skill and its request, parsed, under the client's prefix. */
+export function generationIdempotencyKeyFor(skill, request, clientId) {
+    const parsed = { skill, request: skill === "generate_image" ? generateImageRequest.parse(request) : generateVideoRequest.parse(request) };
+    return createHash("sha256")
+        .update(clientId + JSON.stringify(canonicalize(parsed)))
+        .digest("hex");
+}
 /** The same key for `make_faceless`, parsed by its own union schema. */
 export function facelessIdempotencyKeyFor(input, clientId) {
     const parsed = makeFacelessInput.parse(input);

package/dist/idempotency.js.map

@@ -1 +1 @@
-{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../src/idempotency.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../src/idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,wFAAwF;AACxF,+DAA+D;AAE/D,gGAAgG;AAChG,6FAA6F;AAC7F,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qFAAqF;AACrF,6FAA6F;AAC7F,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;SAC3C,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,2FAA2F;AAC3F,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAE,QAAgB;IAChE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;SACvD,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,wFAAwF;AACxF,2CAA2C;AAC3C,MAAM,UAAU,sBAAsB,CAAC,KAAc,EAAE,QAAgB;IACrE,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;SACvD,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,yBAAyB,CAAC,WAAmB,EAAE,OAAgB,EAAE,QAAgB;IAC/F,MAAM,MAAM,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IACpG,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;SACvD,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,0BAA0B,CAAC,WAAmB,EAAE,OAAgB,EAAE,QAAgB;IAChG,MAAM,MAAM,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IACvG,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;SACvD,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,2BAA2B,CAAC,KAA0C,EAAE,OAAgB,EAAE,QAAgB;IACxH,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,KAAK,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1I,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;SACvD,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,yBAAyB,CAAC,KAAc,EAAE,QAAgB;IACxE,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;SACvD,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -35,7 +35,11 @@ export * from "./media-timebase.js";
 export * from "./billing-terms.js";
 export * from "./voice-preview-approval.js";
 export * from "./face-delivery.js";
+export * from "./ugc-delivery.js";
 export * from "./faceless-public-plan.js";
 export * from "./faceless-media-record.js";
 export * from "./edit.js";
 export * from "./workflows/index.js";
+export * from "./output-provenance.js";
+export * from "./generations.js";
+export * from "./generations-output.js";

package/dist/index.js

@@ -56,8 +56,12 @@ export * from "./media-timebase.js";
 export * from "./billing-terms.js";
 export * from "./voice-preview-approval.js";
 export * from "./face-delivery.js";
+export * from "./ugc-delivery.js";
 export * from "./faceless-public-plan.js";
 export * from "./faceless-media-record.js";
 export * from "./edit.js";
 export * from "./workflows/index.js";
+export * from "./output-provenance.js";
+export * from "./generations.js";
+export * from "./generations-output.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,+EAA+E;AAC/E,cAAc,qBAAqB,CAAC;AACpC,2FAA2F;AAC3F,sFAAsF;AACtF,cAAc,4BAA4B,CAAC;AAC3C,6FAA6F;AAC7F,cAAc,aAAa,CAAC;AAC5B,gFAAgF;AAChF,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,wFAAwF;AACxF,uCAAuC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,uFAAuF;AACvF,gBAAgB;AAChB,cAAc,iBAAiB,CAAC;AAChC,uFAAuF;AACvF,sBAAsB;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,iEAAiE;AACjE,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,oFAAoF;AACpF,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,wFAAwF;AACxF,mEAAmE;AACnE,cAAc,sBAAsB,CAAC;AACrC,sFAAsF;AACtF,2CAA2C;AAC3C,cAAc,uBAAuB,CAAC;AACtC,uFAAuF;AACvF,cAAc,gBAAgB,CAAC;AAC/B,oFAAoF;AACpF,sCAAsC;AACtC,cAAc,0BAA0B,CAAC;AACzC,qEAAqE;AACrE,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,+EAA+E;AAC/E,cAAc,qBAAqB,CAAC;AACpC,2FAA2F;AAC3F,sFAAsF;AACtF,cAAc,4BAA4B,CAAC;AAC3C,6FAA6F;AAC7F,cAAc,aAAa,CAAC;AAC5B,gFAAgF;AAChF,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,wFAAwF;AACxF,uCAAuC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,uFAAuF;AACvF,gBAAgB;AAChB,cAAc,iBAAiB,CAAC;AAChC,uFAAuF;AACvF,sBAAsB;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,iEAAiE;AACjE,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,oFAAoF;AACpF,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,wFAAwF;AACxF,mEAAmE;AACnE,cAAc,sBAAsB,CAAC;AACrC,sFAAsF;AACtF,2CAA2C;AAC3C,cAAc,uBAAuB,CAAC;AACtC,uFAAuF;AACvF,cAAc,gBAAgB,CAAC;AAC/B,oFAAoF;AACpF,sCAAsC;AACtC,cAAc,0BAA0B,CAAC;AACzC,qEAAqE;AACrE,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/long-form-revision.d.ts

@@ -0,0 +1,244 @@
+import { z } from "zod";
+import { type ResolvedTimeline } from "./resolved-timeline.js";
+/** How a long-form run fills what a picture leaves of the canvas (`makeUgcInput.background`). */
+export declare const LONG_FORM_BACKGROUNDS: readonly ["white", "blur", "contain"];
+export type LongFormBackground = (typeof LONG_FORM_BACKGROUNDS)[number];
+/** A picture's zoom, as `makeUgcInput` takes it. */
+export declare const longFormImageMotion: z.ZodObject<{
+    direction: z.ZodEnum<{
+        in: "in";
+        out: "out";
+    }>;
+    amount: z.ZodNumber;
+}, z.core.$strict>;
+export type LongFormImageMotion = z.infer<typeof longFormImageMotion>;
+/** What a render needs beyond the timeline, copied from the root's input at admission; a position absent from the motions does not move. */
+export declare const longFormRevisionRender: z.ZodObject<{
+    aspect_ratio: z.ZodEnum<{
+        "16:9": "16:9";
+        "1:1": "1:1";
+        "9:16": "9:16";
+    }>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    background: z.ZodNullable<z.ZodEnum<{
+        blur: "blur";
+        contain: "contain";
+        white: "white";
+    }>>;
+    motion_by_position: z.ZodRecord<z.ZodString, z.ZodObject<{
+        direction: z.ZodEnum<{
+            in: "in";
+            out: "out";
+        }>;
+        amount: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type LongFormRevisionRender = z.infer<typeof longFormRevisionRender>;
+/** The stored input of a `revise_long_form` run: the request as resolved, and what admission froze about it. */
+export declare const longFormRevisionInput: z.ZodObject<{
+    input_mode: z.ZodLiteral<"revision">;
+    revision: z.ZodObject<{
+        source_run_id: z.ZodString;
+        document: z.ZodObject<{
+            v: z.ZodLiteral<1>;
+            source_run_id: z.ZodString;
+            timebase: z.ZodObject<{
+                fps: z.ZodNumber;
+            }, z.core.$strict>;
+            duration_frames: z.ZodNumber;
+            shots: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                track: z.ZodEnum<{
+                    presenter: "presenter";
+                    visual: "visual";
+                }>;
+                kind: z.ZodEnum<{
+                    clip: "clip";
+                    picture: "picture";
+                    presenter: "presenter";
+                }>;
+                start_frame: z.ZodNumber;
+                end_frame: z.ZodNumber;
+                media_offset_frames: z.ZodOptional<z.ZodNumber>;
+                asset: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    from: z.ZodLiteral<"source">;
+                    shot_id: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    from: z.ZodLiteral<"candidate">;
+                    run_id: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    from: z.ZodLiteral<"upload">;
+                    upload_id: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    from: z.ZodLiteral<"generate">;
+                    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        mode: z.ZodLiteral<"retake">;
+                    }, z.core.$strict>, z.ZodObject<{
+                        mode: z.ZodLiteral<"new_picture">;
+                        description: z.ZodString;
+                    }, z.core.$strict>, z.ZodObject<{
+                        mode: z.ZodLiteral<"edit_picture">;
+                        instruction: z.ZodString;
+                    }, z.core.$strict>, z.ZodObject<{
+                        mode: z.ZodLiteral<"animate">;
+                        motion: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>], "mode">;
+                }, z.core.$strict>], "from">;
+            }, z.core.$strict>>;
+            discarded: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    resolved_revision: z.ZodObject<{
+        root_run_id: z.ZodString;
+        summary: z.ZodObject<{
+            retimed: z.ZodArray<z.ZodString>;
+            deleted: z.ZodArray<z.ZodString>;
+            added: z.ZodArray<z.ZodString>;
+            replaced: z.ZodArray<z.ZodObject<{
+                shot_id: z.ZodString;
+                from: z.ZodEnum<{
+                    candidate: "candidate";
+                    source: "source";
+                    upload: "upload";
+                }>;
+            }, z.core.$strict>>;
+            generated: z.ZodArray<z.ZodObject<{
+                shot_id: z.ZodString;
+                kind: z.ZodEnum<{
+                    clip: "clip";
+                    picture: "picture";
+                    presenter: "presenter";
+                }>;
+                mode: z.ZodEnum<{
+                    animate: "animate";
+                    edit_picture: "edit_picture";
+                    new_picture: "new_picture";
+                    retake: "retake";
+                }>;
+            }, z.core.$strict>>;
+            changed: z.ZodBoolean;
+        }, z.core.$strict>;
+        billing: z.ZodObject<{
+            tariff_id: z.ZodString;
+            lines: z.ZodArray<z.ZodObject<{
+                shot_id: z.ZodString;
+                unit: z.ZodEnum<{
+                    clip: "clip";
+                    clip_with_new_picture: "clip_with_new_picture";
+                    kept_clip: "kept_clip";
+                    kept_picture: "kept_picture";
+                    picture: "picture";
+                }>;
+                credits: z.ZodNumber;
+            }, z.core.$strict>>;
+            render_credits: z.ZodNumber;
+            zero_unit: z.ZodNullable<z.ZodEnum<{
+                free: "free";
+                priced: "priced";
+            }>>;
+            total_credits: z.ZodNumber;
+        }, z.core.$strict>;
+        render: z.ZodObject<{
+            aspect_ratio: z.ZodEnum<{
+                "16:9": "16:9";
+                "1:1": "1:1";
+                "9:16": "9:16";
+            }>;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            background: z.ZodNullable<z.ZodEnum<{
+                blur: "blur";
+                contain: "contain";
+                white: "white";
+            }>>;
+            motion_by_position: z.ZodRecord<z.ZodString, z.ZodObject<{
+                direction: z.ZodEnum<{
+                    in: "in";
+                    out: "out";
+                }>;
+                amount: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type LongFormRevisionInput = z.infer<typeof longFormRevisionInput>;
+/** One changed visual shot, drawn above the source tiling over its whole span. A cover has no motion; an insert keeps its slot's. */
+export declare const longFormOverlay: z.ZodObject<{
+    shot_id: z.ZodString;
+    start_frame: z.ZodNumber;
+    end_frame: z.ZodNumber;
+    object: z.ZodObject<{
+        key: z.ZodString;
+        sha256: z.ZodString;
+        bytes: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        content_type: z.ZodEnum<{
+            "image/jpeg": "image/jpeg";
+            "image/png": "image/png";
+        }>;
+    }, z.core.$strict>;
+    origin: z.ZodEnum<{
+        source: "source";
+        upload: "upload";
+    }>;
+    motion: z.ZodNullable<z.ZodObject<{
+        direction: z.ZodEnum<{
+            in: "in";
+            out: "out";
+        }>;
+        amount: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type LongFormOverlay = z.infer<typeof longFormOverlay>;
+declare const recordShape: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    run_id: z.ZodString;
+    account_id: z.ZodString;
+    source_run_id: z.ZodString;
+    root_run_id: z.ZodString;
+    base: z.ZodUnknown;
+    visual: z.ZodArray<z.ZodObject<{
+        shot_id: z.ZodString;
+        start_frame: z.ZodNumber;
+        end_frame: z.ZodNumber;
+        object: z.ZodObject<{
+            key: z.ZodString;
+            sha256: z.ZodString;
+            bytes: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            content_type: z.ZodEnum<{
+                "image/jpeg": "image/jpeg";
+                "image/png": "image/png";
+            }>;
+        }, z.core.$strict>;
+        origin: z.ZodEnum<{
+            source: "source";
+            upload: "upload";
+        }>;
+        motion: z.ZodNullable<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** What a delivered long-form revision rendered: the source tiling rebound to its own run and keys, and its overlays. */
+export type LongFormRevisionRecord = Omit<z.infer<typeof recordShape>, "base"> & {
+    base: ResolvedTimeline;
+};
+/** Where a long-form revision's record is stored, and the most bytes it may take there. */
+export declare const longFormRevisionRecordKey: (id: string) => string;
+export declare const LONG_FORM_REVISION_RECORD_MAX_BYTES = 512000;
+/** Whether a key names an object of this run: a plain path under `runs/<runId>/`, with no segment to climb out by. */
+export declare function longFormOwnKey(key: string, id: string): boolean;
+/** The stored record of the run being read, checked against that run and against itself: every key and overlay belong to it. */
+export declare function readLongFormRevisionRecord(stored: string | Uint8Array, expected: {
+    runId: string;
+    accountId: string;
+}): LongFormRevisionRecord;
+export {};