@clipwright/core 0.32.0 → 0.34.0

package/dist/ugc-layers.js

@@ -0,0 +1,137 @@
+import { lexicalTokens, quoteOccurrences } from "./semantic-inserts.js";
+// Overlays and layout windows of a long-form `make_ugc` run (#778 S2b): drawn over the actor slots, never planned as inserts.
+export const OVERLAY_POSITIONS = ["top_left", "top_right", "bottom_left", "bottom_right", "top", "bottom"];
+export const LAYER_ENTERS = ["cut", "fade", "slide", "tilt_in"];
+export const LAYOUT_WINDOW_KINDS = ["split", "card"];
+export const INSERT_TRANSITIONS = ["cut", "wipe", "flash", "zoom"];
+export const MAX_OVERLAYS = 10;
+export const MAX_LAYOUT_WINDOWS = 5;
+export const MAX_OVERLAYS_AT_ONCE = 2;
+/** The frame of a `W:H` format in pixels, as the composition's `canvasForRatio` derives it: the short side 1080, both sides even. */
+export function frameCanvasOf(aspectRatio) {
+    const [w, h] = aspectRatio.split(":").map(Number);
+    const even = (value) => { const rounded = Math.round(value); return rounded % 2 === 0 ? rounded : rounded + 1; };
+    return w >= h ? { width: even((1080 * w) / h), height: 1080 } : { width: 1080, height: even((1080 * h) / w) };
+}
+/** The most an overlay at `position` takes, as `overlayBox` draws it: a corner 42% wide, a band the width less margins, 30% high. */
+export function overlayRect(position, canvas) {
+    const margin = Math.round(0.04 * Math.min(canvas.width, canvas.height));
+    const band = position === "top" || position === "bottom";
+    const width = band ? canvas.width - 2 * margin : Math.round(0.42 * canvas.width), height = Math.round(0.3 * canvas.height);
+    const left = band || position.endsWith("left") ? margin : canvas.width - margin - width;
+    const top = position.startsWith("top") ? margin : canvas.height - margin - height;
+    return { left: left / canvas.width, top: top / canvas.height, width: width / canvas.width, height: height / canvas.height };
+}
+/** Two footprints collide when they share an area; touching edges do not. */
+export function rectsOverlap(a, b) {
+    return a.left < b.left + b.width && b.left < a.left + a.width && a.top < b.top + b.height && b.top < a.top + a.height;
+}
+/** Where the presenter's face sits: 12–48% of the height and the middle 60% of a 9:16 clip, which other formats fit whole and centre (#778 S3). */
+export function faceZone(aspectRatio) {
+    const { width, height } = frameCanvasOf(aspectRatio);
+    const share = 0.6 * Math.min(1, (9 / 16) / (width / height));
+    return { left: (1 - share) / 2, top: 0.12, width: share, height: 0.36 };
+}
+/** The words an item covers, `[startWord, coverWord)`, as an insert anchor resolves; a string names why it does not resolve. */
+export function layerWordRange(tokens, item) {
+    let range;
+    if ("startWord" in item.anchor) {
+        range = { startWord: item.anchor.startWord, endWord: item.anchor.endWord };
+        if (range.endWord > tokens.length)
+            return `anchor ends at word ${range.endWord}, past the script's ${tokens.length} words`;
+    }
+    else {
+        const matches = quoteOccurrences(tokens, item.anchor.quote);
+        if (matches.length === 0)
+            return `anchor quote "${item.anchor.quote}" does not occur in script`;
+        if (item.anchor.occurrence === undefined && matches.length > 1) {
+            return `anchor quote "${item.anchor.quote}" occurs ${matches.length} times in script: pass occurrence`;
+        }
+        const picked = matches[item.anchor.occurrence ?? 0];
+        if (!picked)
+            return `anchor quote "${item.anchor.quote}" has no occurrence ${item.anchor.occurrence}`;
+        range = picked;
+    }
+    const coverWord = item.cover_words === undefined ? range.endWord : range.startWord + item.cover_words;
+    if (coverWord < range.endWord)
+        return `cover_words ${item.cover_words} is fewer than the ${range.endWord - range.startWord} words the anchor names`;
+    if (coverWord > tokens.length)
+        return `cover_words runs past the script's ${tokens.length} words`;
+    return { startWord: range.startWord, coverWord };
+}
+const overlaps = (a, b) => a.startWord < b.coverWord && b.startWord < a.coverWord;
+const coveredBy = (range, cover) => Array.from({ length: range.coverWord - range.startWord }, (_, offset) => range.startWord + offset).every(word => cover.some(other => word >= other.startWord && word < other.coverWord));
+/** Every refusal of overlays and layout windows against the script, named by path; empty when they render. */
+export function layerRefusals(input) {
+    const refusals = [];
+    const tokens = lexicalTokens(input.script);
+    const canvas = frameCanvasOf(input.aspect_ratio ?? "9:16");
+    const seen = new Map();
+    for (const field of ["inserts", "overlays", "layout_windows"]) {
+        for (const [index, item] of (input[field] ?? []).entries()) {
+            const owner = seen.get(item.id);
+            if (owner !== undefined && field !== "inserts") {
+                refusals.push({ path: [field, index, "id"], message: `id "${item.id}" is already used in ${owner}: ids are unique across inserts, overlays and layout_windows` });
+            }
+            seen.set(item.id, owner ?? field);
+        }
+    }
+    const ranged = (field, items) => (items ?? []).flatMap((item, index) => {
+        const range = layerWordRange(tokens, item);
+        if (typeof range === "string") {
+            refusals.push({ path: [field, index, "anchor"], message: `${field === "overlays" ? "overlay" : "layout window"} "${item.id}": ${range}` });
+            return [];
+        }
+        return [{ item, index, range }];
+    });
+    const overlays = ranged("overlays", input.overlays);
+    const windows = ranged("layout_windows", input.layout_windows);
+    const inserts = (input.inserts ?? []).flatMap(item => { const range = layerWordRange(tokens, item); return typeof range === "string" ? [] : [{ item, range }]; });
+    for (const [at, layout] of windows.entries()) {
+        if (layout.item.layout === "split" && input.aspect_ratio !== undefined && input.aspect_ratio !== "9:16") {
+            refusals.push({ path: ["layout_windows", layout.index, "layout"], message: `layout window "${layout.item.id}": split works in 9:16 only, and aspect_ratio is ${input.aspect_ratio}` });
+        }
+        const earlier = windows.slice(0, at).find(other => overlaps(other.range, layout.range));
+        if (earlier) {
+            refusals.push({ path: ["layout_windows", layout.index], message: `layout window "${layout.item.id}" overlaps layout window "${earlier.item.id}": windows take the frame one at a time` });
+        }
+        const insert = inserts.find(other => overlaps(other.range, layout.range));
+        if (insert) {
+            refusals.push({ path: ["layout_windows", layout.index], message: `layout window "${layout.item.id}" overlaps insert "${insert.item.id}": a window reframes the presenter, who is not on screen during a full-frame insert` });
+        }
+    }
+    for (const [at, overlay] of overlays.entries()) {
+        const under = inserts.filter(other => overlaps(other.range, overlay.range));
+        if (under.length && coveredBy(overlay.range, under.map(other => other.range))) {
+            refusals.push({ path: ["overlays", overlay.index], message: `overlay "${overlay.item.id}" lies wholly under insert "${under[0].item.id}": an overlay draws over the presenter, who is not on screen during a full-frame insert` });
+        }
+        const together = overlays.slice(0, at).filter(other => overlaps(other.range, overlay.range));
+        const clash = together.find(other => rectsOverlap(overlayRect(other.item.position, canvas), overlayRect(overlay.item.position, canvas)));
+        if (clash) {
+            refusals.push({ path: ["overlays", overlay.index, "position"], message: `overlay "${overlay.item.id}" (${overlay.item.position}) shares the screen with overlay "${clash.item.id}" (${clash.item.position}) at the same time: overlays on screen together need different positions` });
+            continue;
+        }
+        const crowd = together.flatMap((a, i) => together.slice(i + 1).filter(b => Math.max(a.range.startWord, b.range.startWord, overlay.range.startWord) <
+            Math.min(a.range.coverWord, b.range.coverWord, overlay.range.coverWord)).map(b => [a, b]))[0];
+        if (crowd) {
+            refusals.push({ path: ["overlays", overlay.index], message: `overlay "${overlay.item.id}" would be on screen together with "${crowd[0].item.id}" and "${crowd[1].item.id}": at most ${MAX_OVERLAYS_AT_ONCE} overlays show at once` });
+        }
+    }
+    return refusals;
+}
+/** Frames of each word range on the run's narration, by the rule inserts follow: a range ends where its first uncovered word starts. */
+export function resolveLayerFrames(input) {
+    const lexical = input.words.filter(word => !/^\p{P}+$/u.test(word.word));
+    if (lexical.length !== input.tokens.length || lexical.some((word, index) => lexicalTokens(word.word)[0] !== input.tokens[index])) {
+        throw new Error("layer word timings do not follow the script's words");
+    }
+    return input.layers.map(layer => {
+        const startFrame = layer.startWord === 0 ? 0 : Math.round(lexical[layer.startWord].startSec * input.fps);
+        const endFrame = layer.coverWord >= lexical.length ? input.totalFrames : Math.round(lexical[layer.coverWord].startSec * input.fps);
+        if (!Number.isSafeInteger(startFrame) || endFrame <= startFrame || endFrame > input.totalFrames) {
+            throw new Error(`layer ${layer.id} has no frames on the narration`);
+        }
+        return { id: layer.id, startFrame, endFrame };
+    });
+}
+//# sourceMappingURL=ugc-layers.js.map

package/dist/ugc-layers.js.map

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

package/dist/ugc-video-media.d.ts

@@ -0,0 +1,12 @@
+import type { MakeUgcInput, PinnedInsertAsset } from "./skills.js";
+/** Codecs Remotion's OffthreadVideo decodes with its bundled FFmpeg, locally and on Lambda; asset ingest takes the same two. */
+export declare const MEDIA_VIDEO_CODECS: readonly ["h264", "hevc"];
+export interface VideoSourceFacts {
+    codec?: string | null | undefined;
+    pixFmt?: string | null | undefined;
+    colorTransfer?: string | null | undefined;
+}
+/** Why a video source cannot be drawn, or `null`. A fact that is not known is not refused here; the worker measures it. */
+export declare function videoMediaRefusal(facts: VideoSourceFacts): string | null;
+/** The quote's warning for a pinned video asset the narration may outlast; the slow speech edge gives the longest its words can take. */
+export declare function videoHoldWarnings(input: Pick<MakeUgcInput, "script" | "inserts" | "overlays" | "layout_windows">, pinned: readonly PinnedInsertAsset[] | undefined): string[];

package/dist/ugc-video-media.js

@@ -0,0 +1,39 @@
+import { WORDS_PER_SECOND_MIN } from "./pacing.js";
+import { lexicalTokens } from "./semantic-inserts.js";
+import { layerWordRange } from "./ugc-layers.js";
+// Video media in inserts, overlays and layout windows of a long-form `make_ugc` run (#778 S2c): muted, held on its last frame when short.
+/** Codecs Remotion's OffthreadVideo decodes with its bundled FFmpeg, locally and on Lambda; asset ingest takes the same two. */
+export const MEDIA_VIDEO_CODECS = ["h264", "hevc"];
+const HDR_TRANSFERS = { smpte2084: "PQ", "arib-std-b67": "HLG" };
+/** Why a video source cannot be drawn, or `null`. A fact that is not known is not refused here; the worker measures it. */
+export function videoMediaRefusal(facts) {
+    if (facts.codec && !MEDIA_VIDEO_CODECS.includes(facts.codec)) {
+        return `is ${facts.codec} video: video media takes H.264 or HEVC; re-encode it as H.264`;
+    }
+    const depth = facts.pixFmt ? /(9|1[0-6])(le|be)$/.exec(facts.pixFmt)?.[1] : undefined;
+    if (depth)
+        return `is ${depth}-bit video (${facts.pixFmt}): video media takes 8-bit video; re-encode it as 8-bit H.264 (yuv420p)`;
+    const hdr = facts.colorTransfer ? HDR_TRANSFERS[facts.colorTransfer] : undefined;
+    if (hdr)
+        return `is HDR video (${hdr}, transfer ${facts.colorTransfer}): video media takes SDR video; re-encode it as SDR BT.709`;
+    return null;
+}
+const LISTS = [["inserts", "insert"], ["overlays", "overlay"], ["layout_windows", "layout window"]];
+/** The quote's warning for a pinned video asset the narration may outlast; the slow speech edge gives the longest its words can take. */
+export function videoHoldWarnings(input, pinned) {
+    if (!pinned?.length || typeof input.script !== "string")
+        return [];
+    const tokens = lexicalTokens(input.script);
+    return LISTS.flatMap(([list, noun]) => (input[list] ?? []).flatMap((item, index) => {
+        const asset = pinned.find(one => one.insert_id === item.id);
+        if (item.media_type !== "video" || asset?.kind !== "video" || !asset.duration_frames || !asset.fps)
+            return [];
+        const range = layerWordRange(tokens, item);
+        if (typeof range === "string")
+            return [];
+        const words = range.coverWord - range.startWord, clipSec = asset.duration_frames / asset.fps, longestSec = words / WORDS_PER_SECOND_MIN;
+        return clipSec < longestSec ? [`${list}[${index}] ${noun} ${item.id}: its video asset runs ${clipSec.toFixed(1)} s, and the ${words} words ` +
+                `it covers can take up to ${longestSec.toFixed(1)} s; if the narration outlasts the clip, its last frame holds to the end`] : [];
+    }));
+}
+//# sourceMappingURL=ugc-video-media.js.map

package/dist/ugc-video-media.js.map

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

package/dist/uploads.d.ts

@@ -11,7 +11,56 @@ export declare const UPLOAD_OBJECT_RETENTION_DAYS = 30;
 export declare const UPLOAD_MEDIA_TYPES: readonly ["image/png", "image/jpeg"];
 export type UploadMediaType = (typeof UPLOAD_MEDIA_TYPES)[number];
 export declare const UPLOADS_PATH = "/v1/uploads";
+/** Remote uploads (clipwright#758): a server-side download, a presigned PUT, and the read that confirms one. */
+export declare const UPLOAD_IMPORT_PATH = "/v1/uploads/import";
+export declare const UPLOAD_INTENTS_PATH = "/v1/uploads/intents";
+export declare const UPLOAD_ITEM_PATH = "/v1/uploads/:id";
+/** A presigned PUT url lives 15 minutes; the intent it serves can be finished for a day. */
+export declare const UPLOAD_PUT_URL_TTL_SECONDS = 900;
+export declare const UPLOAD_INTENT_FINISH_SECONDS = 86400;
+/** The finisher's lease outlives its storage calls by 35 s, and those stay under the SDK's 30 s per request plus margin. */
+export declare const UPLOAD_FINISH_LEASE_SECONDS = 60;
+export declare const UPLOAD_FINISH_IO_DEADLINE_MS = 25000;
+/** A repeated key answers the earlier result only within a day and only while that result is still usable. */
+export declare const IDEMPOTENCY_REPLAY_SECONDS = 86400;
+/** Outbound downloads: attempts per account per hour, imports at once per `api` instance, and one import's deadline. */
+export declare const URL_FETCH_PER_HOUR = 30;
+export declare const URL_FETCH_WINDOW_SECONDS = 3600;
+export declare const URL_IMPORT_CONCURRENCY = 4;
+export declare const URL_IMPORT_IMAGE_DEADLINE_MS = 20000;
+export declare const URL_IMPORT_MAX_REDIRECTS = 3;
+/** The longest side a customer picture may have. */
+export declare const UPLOAD_MAX_SIDE = 8192;
 export declare const uploadId: z.ZodString;
+export declare const uploadImportRequest: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strict>;
+export type UploadImportRequest = z.infer<typeof uploadImportRequest>;
+/** `filename` is a hint for people and is not part of the request's identity. */
+export declare const uploadIntentRequest: z.ZodObject<{
+    media_type: z.ZodEnum<{
+        "image/jpeg": "image/jpeg";
+        "image/png": "image/png";
+    }>;
+    bytes: z.ZodNumber;
+    sha256: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type UploadIntentRequest = z.infer<typeof uploadIntentRequest>;
+export declare const uploadIntentResponse: z.ZodObject<{
+    upload_id: z.ZodString;
+    put_url: z.ZodString;
+    put_headers: z.ZodObject<{
+        "content-type": z.ZodEnum<{
+            "image/jpeg": "image/jpeg";
+            "image/png": "image/png";
+        }>;
+        "content-length": z.ZodString;
+    }, z.core.$strict>;
+    expires_at: z.ZodString;
+    finish_by: z.ZodString;
+}, z.core.$strict>;
+export type UploadIntentResponse = z.infer<typeof uploadIntentResponse>;
 export declare const uploadResponse: z.ZodObject<{
     upload_id: z.ZodString;
     content_digest: z.ZodString;
@@ -26,6 +75,34 @@ export declare const uploadResponse: z.ZodObject<{
     expires_at: z.ZodString;
 }, z.core.$strip>;
 export type UploadResponse = z.infer<typeof uploadResponse>;
+/** `GET /v1/uploads/{id}`: one upload with a link signed now, and when a generation or revision stops taking it. */
+export declare const uploadItemResponse: z.ZodObject<{
+    upload_id: z.ZodString;
+    content_digest: z.ZodString;
+    url: z.ZodString;
+    media_type: z.ZodEnum<{
+        "image/jpeg": "image/jpeg";
+        "image/png": "image/png";
+    }>;
+    bytes: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    expires_at: z.ZodString;
+    usable_until: z.ZodString;
+}, z.core.$strip>;
+export type UploadItemResponse = z.infer<typeof uploadItemResponse>;
+export declare const uploadItemRead: z.ZodObject<{
+    upload_id: z.ZodString;
+    content_digest: z.ZodString;
+    url: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    expires_at: z.ZodString;
+    usable_until: z.ZodString;
+    media_type: z.ZodString;
+    bytes: z.ZodNumber;
+}, z.core.$loose>;
+export type UploadItemRead = z.infer<typeof uploadItemRead>;
 /** `GET /v1/uploads`: the account's uploads a revision still takes, newest first, one per picture, each with a link signed now. */
 export declare const uploadList: z.ZodObject<{
     uploads: z.ZodArray<z.ZodObject<{
@@ -66,3 +143,5 @@ export type UploadListRead = z.infer<typeof uploadListRead>;
 export declare function sniffUploadMediaType(bytes: Uint8Array): UploadMediaType | null;
 export declare function uploadExtension(mediaType: UploadMediaType): "png" | "jpg";
 export declare const UPLOAD_IMAGE_DESCRIPTION: string;
+export declare const CREATE_UPLOAD_DESCRIPTION: string;
+export declare const GET_UPLOAD_DESCRIPTION: string;

package/dist/uploads.js

@@ -10,7 +10,48 @@ export const UPLOAD_OBJECT_RETENTION_DAYS = 30;
 /** No WebP on purpose: the probe cannot read its dimensions, and without them the format cannot be checked. */
 export const UPLOAD_MEDIA_TYPES = ["image/png", "image/jpeg"];
 export const UPLOADS_PATH = "/v1/uploads";
+/** Remote uploads (clipwright#758): a server-side download, a presigned PUT, and the read that confirms one. */
+export const UPLOAD_IMPORT_PATH = "/v1/uploads/import";
+export const UPLOAD_INTENTS_PATH = "/v1/uploads/intents";
+export const UPLOAD_ITEM_PATH = "/v1/uploads/:id";
+/** A presigned PUT url lives 15 minutes; the intent it serves can be finished for a day. */
+export const UPLOAD_PUT_URL_TTL_SECONDS = 900;
+export const UPLOAD_INTENT_FINISH_SECONDS = 86_400;
+/** The finisher's lease outlives its storage calls by 35 s, and those stay under the SDK's 30 s per request plus margin. */
+export const UPLOAD_FINISH_LEASE_SECONDS = 60;
+export const UPLOAD_FINISH_IO_DEADLINE_MS = 25_000;
+/** A repeated key answers the earlier result only within a day and only while that result is still usable. */
+export const IDEMPOTENCY_REPLAY_SECONDS = 86_400;
+/** Outbound downloads: attempts per account per hour, imports at once per `api` instance, and one import's deadline. */
+export const URL_FETCH_PER_HOUR = 30;
+export const URL_FETCH_WINDOW_SECONDS = 3600;
+export const URL_IMPORT_CONCURRENCY = 4;
+export const URL_IMPORT_IMAGE_DEADLINE_MS = 20_000;
+export const URL_IMPORT_MAX_REDIRECTS = 3;
+/** The longest side a customer picture may have. */
+export const UPLOAD_MAX_SIDE = 8192;
 export const uploadId = z.string().regex(/^upl_[a-f0-9]{32}$/);
+const sha256Hex = z.string().regex(/^[a-f0-9]{64}$/);
+export const uploadImportRequest = z.strictObject({
+    url: z.string().url().startsWith("https://").max(2048),
+});
+/** `filename` is a hint for people and is not part of the request's identity. */
+export const uploadIntentRequest = z.strictObject({
+    media_type: z.enum(UPLOAD_MEDIA_TYPES),
+    bytes: z.number().int().positive().max(UPLOAD_MAX_BYTES),
+    sha256: sha256Hex,
+    filename: z.string().min(1).max(200).optional(),
+});
+export const uploadIntentResponse = z.strictObject({
+    upload_id: uploadId,
+    put_url: z.string().url().startsWith("https://"),
+    put_headers: z.strictObject({
+        "content-type": z.enum(UPLOAD_MEDIA_TYPES),
+        "content-length": z.string().regex(/^\d+$/),
+    }),
+    expires_at: z.string().datetime(),
+    finish_by: z.string().datetime(),
+});
 export const uploadResponse = z.object({
     upload_id: uploadId,
     content_digest: z.string().regex(/^[a-f0-9]{64}$/).describe("SHA-256 of the original uploaded bytes; use it as the workflow asset content_digest."),
@@ -21,6 +62,11 @@ export const uploadResponse = z.object({
     height: z.number().int().positive(),
     expires_at: z.string().datetime(),
 });
+/** `GET /v1/uploads/{id}`: one upload with a link signed now, and when a generation or revision stops taking it. */
+export const uploadItemResponse = uploadResponse.extend({ usable_until: z.string().datetime() });
+export const uploadItemRead = uploadItemResponse.extend({
+    media_type: z.string().min(1), bytes: z.number().int().positive(),
+}).loose();
 /** `GET /v1/uploads`: the account's uploads a revision still takes, newest first, one per picture, each with a link signed now. */
 export const uploadList = z.strictObject({
     uploads: z.array(z.strictObject({
@@ -50,11 +96,23 @@ export function sniffUploadMediaType(bytes) {
 export function uploadExtension(mediaType) {
     return mediaType === "image/png" ? "png" : "jpg";
 }
-export const UPLOAD_IMAGE_DESCRIPTION = "Upload a LOCAL image file (PNG or JPEG, up to 10 MB) and get an https url to pass as `image` " +
-    "to quote_ugc / make_ugc. The url is signed and expires in 24 hours; upload again after that. " +
-    "Use this whenever the user points at a file on disk — `image` itself accepts only public https " +
-    "urls. Then set `aspect_ratio` EXPLICITLY to match the picture (a 16:9 photo with no aspect_ratio " +
-    "renders vertical 9:16 with a warning). For workflow assets, use the returned upload_id as asset_id " +
-    "and content_digest directly: it is the SHA-256 of the original uploaded bytes. " +
-    "Free: spends no credits; 20 uploads per day per account.";
+export const UPLOAD_IMAGE_DESCRIPTION = "Get an upload_id and a signed https url for a PNG or JPEG up to 10 MB: from a LOCAL file (`path`, only when this " +
+    "server runs on your machine) or from a public https `url` that the server downloads (up to 20 seconds; redirects " +
+    "are followed up to 3 times). Pass the url as `image` to quote_ugc / make_ugc, and the upload_id as " +
+    "{upload_id, rights_confirmed: true} in references, first_frame or last_frame of quote_image, generate_image, " +
+    "quote_video and generate_video. The url is signed for 24 hours; the upload_id stays usable for 30 days. For " +
+    "workflow assets, use the upload_id as asset_id and content_digest directly: it is the SHA-256 of the original " +
+    "bytes. Set `aspect_ratio` EXPLICITLY to match the picture. For a file on your disk while this server is remote, " +
+    "use create_upload. Free: spends no credits; 20 uploads per day per account, and at most 30 url downloads per hour.";
+export const CREATE_UPLOAD_DESCRIPTION = "Upload a LOCAL PNG or JPEG (up to 10 MB) through a one-time presigned PUT; use it when this server is remote and " +
+    "you have a shell. Pass media_type, the exact size in bytes and the file's sha256 (`sha256sum <file>` or " +
+    "`shasum -a 256 <file>`). Within 15 minutes run: `curl -X PUT -H 'content-type: <media_type>' --data-binary " +
+    "@<file> '<put_url>'` (curl sends the content-length itself; both headers must match what you declared). Once the " +
+    "PUT finished, the upload_id works as {upload_id, rights_confirmed: true} in quote_image, generate_image, " +
+    "quote_video and generate_video; before that they answer upload_not_finished. Call get_upload to confirm and to " +
+    "read content_digest, width and height; other tools that take an upload_id need that call first. Use the " +
+    "upload_id within 24 hours. Free; counts toward 20 uploads per day.";
+export const GET_UPLOAD_DESCRIPTION = "Read one upload by upload_id: a freshly signed https url, content_digest, media_type, bytes, width, height and " +
+    "usable_until. After create_upload it also confirms the PUT: it answers upload_not_finished until the file is " +
+    "there and upload_expired after 24 hours. Free.";
 //# sourceMappingURL=uploads.js.map

package/dist/uploads.js.map

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