@orangecatai/adgen-canvas 0.0.26 → 0.0.28

package/dist/types/excalidraw/utils/brandContextUtils.d.ts

@@ -21,3 +21,24 @@ export declare function buildImageGenSafePrompt(prompt: string, brandContext: Br
     width: number;
     height: number;
 }): string;
+/**
+ * Augments a video prompt with brand direction reframed for motion.
+ *
+ * Deliberately NOT a reuse of buildBrandContextMessage: that builder targets
+ * static image ads and emits px size scales, layout patterns, and "render all
+ * on-image text in this exact typeface" mandates. Video models ignore px hints
+ * and garble text when pushed to reproduce a typeface, so this builder drops
+ * `layoutPattern` and `sizeScale` entirely and demotes typography to a soft
+ * note inside the on-screen-text clause.
+ *
+ * The logo is only mentioned when `opts.hasLogoReference` is true — i.e. the
+ * logo is actually attached as an input reference (seedance in reference mode).
+ * Asking a model to draw a brand mark it has never seen yields a mangled
+ * pseudo-logo, which is worse for brand safety than no logo at all.
+ *
+ * Returns `prompt` unchanged when the brand kit carries no usable direction, so
+ * a half-filled kit never appends an empty header.
+ */
+export declare function buildVideoBrandPrompt(prompt: string, ctx: BrandContext, opts?: {
+    hasLogoReference?: boolean;
+}): string;

package/dist/types/excalidraw/utils/videoApi.d.ts

@@ -13,6 +13,13 @@ export interface VideoJobParams {
 }
 export interface VideoJobResult {
     videoPresignedUrl: string;
+    /**
+     * The S3 object key the host persisted the finished segment under (see
+     * `/api/sdk/video-gen/status`). Chains persist this per segment so a
+     * resumed chain can re-fetch a segment's bytes after its presigned URL
+     * (1hr TTL) has expired.
+     */
+    videoS3Key?: string;
 }
 /**
  * Submit a video generation job to the host proxy.
@@ -28,3 +35,77 @@ export declare function submitVideoJob(params: VideoJobParams, videoGenUrl: stri
  * Rejects with an Error on failure or abort.
  */
 export declare function pollVideoJob(jobId: string, videoGenStatusUrl: string, onProgress: (progress: number) => void, signal?: AbortSignal): Promise<VideoJobResult>;
+/**
+ * Presigned S3 URLs can't be fetched directly from the browser — S3 buckets
+ * generally don't grant CORS to the app's origin for arbitrary GET-with-body-
+ * read requests, so a bare `fetch()` fails with an opaque "Failed to fetch"
+ * (unlike a `<video src>`, which the browser loads without a CORS check).
+ * Route through the host's download proxy when available: it fetches
+ * server-side (no CORS involved) and streams the bytes back same-origin.
+ */
+export declare function resolveFetchUrl(videoPresignedUrl: string, videoDownloadProxyUrl: string | undefined): string;
+export declare function fetchSegmentBlob(videoPresignedUrl: string, videoDownloadProxyUrl: string | undefined, signal?: AbortSignal): Promise<Blob>;
+export declare function uploadMergedVideo(blob: Blob, uploadUrl: string | undefined): Promise<string>;
+/**
+ * Narrative role of a segment within the ad's arc, assigned by the
+ * shot-splitter (`/api/sdk/video-plan`). "hold" marks a segment generated
+ * after the story has already resolved — an ambient continuation rather than
+ * new plot action.
+ */
+export type ChainSegmentBeat = "setup" | "build" | "turn" | "resolution" | "hold";
+export interface VideoPlan {
+    styleAnchor: string;
+    segments: Array<{
+        beat: ChainSegmentBeat;
+        prompt: string;
+    }>;
+}
+/** Calls the host shot-splitter to divide a concept into per-segment prompts. */
+export declare function planVideoChain(videoPlanUrl: string, params: {
+    concept: string;
+    segmentCount: number;
+    segmentDurationSeconds: number;
+}, signal?: AbortSignal): Promise<VideoPlan>;
+export interface ChainSegmentPlan {
+    index: number;
+    prompt: string;
+}
+export interface ChainSegmentResult {
+    index: number;
+    jobId: string;
+    videoBlob: Blob;
+    videoS3Key?: string;
+}
+export interface ChainParams {
+    segments: ChainSegmentPlan[];
+    /** Every VideoJobParams field except prompt/firstFrameDataUrl, which vary per segment. */
+    baseParams: Omit<VideoJobParams, "prompt" | "firstFrameDataUrl">;
+    videoGenUrl: string;
+    videoGenStatusUrl: string;
+    /** First frame for segment 0, e.g. a user-uploaded starting image. Omit to let the model choose its own opening frame. */
+    initialFirstFrameDataUrl?: string;
+    /** Segment index to resume from. Requires `resumeFirstFrameDataUrl`. */
+    resumeFromIndex?: number;
+    /** The last frame extracted from segment `resumeFromIndex - 1`, re-derived by the caller from its persisted `videoS3Key`. */
+    resumeFirstFrameDataUrl?: string;
+}
+export interface ChainDeps {
+    submit: typeof submitVideoJob;
+    poll: typeof pollVideoJob;
+    fetchSegment: (videoPresignedUrl: string, signal?: AbortSignal) => Promise<Blob>;
+    extractLastFrame: (video: Blob) => Promise<string>;
+}
+export interface ChainCallbacks {
+    onSegmentStart?: (index: number) => void;
+    onSegmentProgress?: (index: number, progress: number) => void;
+    onSegmentDone?: (index: number, result: ChainSegmentResult) => void | Promise<void>;
+}
+export interface ChainResult {
+    segments: ChainSegmentResult[];
+}
+/** Thrown when a chain segment fails. `segmentIndex` identifies which one, for a "Retry from segment N" UI. */
+export declare class ChainSegmentError extends Error {
+    readonly segmentIndex: number;
+    constructor(segmentIndex: number, cause: unknown);
+}
+export declare function runVideoChain(params: ChainParams, deps: ChainDeps, callbacks?: ChainCallbacks, signal?: AbortSignal): Promise<ChainResult>;

package/dist/types/excalidraw/utils/videoDurationStops.d.ts

@@ -0,0 +1,14 @@
+export declare const MAX_CHAIN_SEGMENTS = 6;
+export interface DurationStopsConfig {
+    supportsDuration: boolean;
+    durationMode?: "choices" | "slider";
+    durationValues?: readonly number[];
+    minDuration?: number;
+    maxDuration?: number;
+}
+/** The model's largest single-generation duration, or null if it doesn't support duration at all. */
+export declare function nativeMaxFor(cfg: DurationStopsConfig): number | null;
+/** The full ascending list of valid duration values for this model's duration control. */
+export declare function stopsFor(cfg: DurationStopsConfig): number[];
+/** How many chain segments a given stop implies (1 = single-shot, no chaining). */
+export declare function segmentCountAt(stop: number, nativeMax: number): number;

package/dist/types/excalidraw/utils/videoStitch.d.ts

@@ -0,0 +1,24 @@
+export type AudioPolicy = "first-only" | "none";
+/**
+ * Decodes the final frame of a video and returns it as a lossless PNG data
+ * URL, suitable as the next chain segment's `firstFrameDataUrl`.
+ *
+ * Uses `CanvasSink.getCanvas(Infinity)` rather than seeking a `<video>`
+ * element to `duration - epsilon`: a time-based seek can land on a keyframe
+ * boundary or a black tail frame depending on the encoder, which poisons the
+ * next segment's starting state.
+ */
+export declare function extractLastFrame(video: Blob): Promise<string>;
+/**
+ * Stream-copy concatenates segments produced by the same model at the same
+ * codec/resolution/fps into one MP4. No re-encode — packets are demuxed
+ * from each input and remuxed with shifted timestamps, so this is fast and
+ * lossless.
+ *
+ * Audio policy exists because Veo and Seedance are always-on-audio models
+ * with no way to request a silent segment — muting has to happen here, at
+ * merge time, to behave the same across every model.
+ */
+export declare function concatSegments(segments: Blob[], opts: {
+    audio: AudioPolicy;
+}): Promise<Blob>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orangecatai/adgen-canvas",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "type": "module",
   "types": "./dist/types/excalidraw/index.d.ts",
   "main": "./dist/prod/index.js",
@@ -106,6 +106,7 @@
     "lodash.throttle": "4.1.1",
     "lucide-react": "0.577.0",
     "marked": "17.0.4",
+    "mediabunny": "1.51.0",
     "nanoid": "3.3.3",
     "pako": "2.0.3",
     "perfect-freehand": "1.2.0",

package/dist/prod/data/image-D6B2C7FH.js

@@ -1 +0,0 @@
-import{S as a,T as b,U as c}from"../chunk-PIJUOUUJ.js";import"../chunk-FABLWJ5B.js";import"../chunk-SRAX5OIU.js";export{c as decodePngMetadata,b as encodePngMetadata,a as getTEXtChunk};