@bitmagic/cli 0.1.75-dev.0 → 0.1.75

package/dist/ads/probe.js

@@ -0,0 +1,44 @@
+/**
+ * What a media file is, according to ffprobe: its frame size, its length, and whether it has sound.
+ * The one place `bitmagic ads` reads a file's real shape — a render is checked by what ffprobe says
+ * it wrote, not by what the render meant to write.
+ */
+import { captureFfmpegTool } from '@bitmagic/asset-core/trailer';
+import { CliError } from '../errors.js';
+/** ffprobe's JSON for one file, parsed. Pure, so the parsing is testable without ffprobe. */
+export function parseProbe(json, file) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        throw new CliError(`ffprobe answered in a shape this CLI cannot read for ${file}.`);
+    }
+    const root = (typeof parsed === 'object' && parsed !== null ? parsed : {});
+    const streams = Array.isArray(root.streams) ? root.streams : [];
+    const video = streams.find((stream) => stream.codec_type === 'video');
+    if (!video || typeof video.width !== 'number' || typeof video.height !== 'number') {
+        throw new CliError(`${file} has no picture ffprobe can read.`);
+    }
+    const formatDuration = Number(root.format?.duration);
+    const streamDuration = Number(video.duration);
+    const durationSec = Number.isFinite(formatDuration) ? formatDuration : Number.isFinite(streamDuration) ? streamDuration : 0;
+    return {
+        width: video.width,
+        height: video.height,
+        durationSec,
+        hasAudio: streams.some((stream) => stream.codec_type === 'audio'),
+        codec: typeof video.codec_name === 'string' ? video.codec_name : '',
+    };
+}
+export async function probeMedia(file) {
+    const stdout = await captureFfmpegTool('ffprobe', [
+        '-v', 'error',
+        '-print_format', 'json',
+        '-show_streams',
+        '-show_format',
+        file,
+    ]);
+    return parseProbe(stdout.toString('utf-8'), file);
+}
+//# sourceMappingURL=probe.js.map

package/dist/ads/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../src/ads/probe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAYxC,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY;IACnD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,wDAAwD,IAAI,GAAG,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAGxE,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClF,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,mCAAmC,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5H,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW;QACX,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC;QACjE,KAAK,EAAE,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;KACpE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,SAAS,EAAE;QAChD,IAAI,EAAE,OAAO;QACb,eAAe,EAAE,MAAM;QACvB,eAAe;QACf,cAAc;QACd,IAAI;KACL,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/dist/ads/publish.d.ts

@@ -0,0 +1,31 @@
+import type { Output } from '../output.js';
+import { type CheckDeps } from './check.js';
+export interface AdsPublishDeps {
+    fetch: typeof globalThis.fetch;
+    sleep: (ms: number) => Promise<void>;
+    now?: () => number;
+    /** Test-only: the credentials store; production reads ~/.bitmagic. */
+    baseDir?: string;
+    probe?: CheckDeps['probe'];
+}
+export interface AdsPublishResult {
+    gameId: string;
+    packageId: string;
+    promoteUrl: string;
+    promotable: boolean;
+    uploaded: string[];
+    reused: string[];
+}
+export declare function sha256Of(bytes: Uint8Array | string): string;
+/** The copy's fingerprint as registered: its normalized JSON, so whitespace edits do not count. */
+export declare function copySha256(copy: unknown): string;
+export declare function runAdsPublish(options: {
+    root: string;
+    output: Output;
+    deps?: AdsPublishDeps;
+}): Promise<AdsPublishResult>;
+/**
+ * What changed on disk since the last publish from this machine, by file name ("ads.json" for the
+ * copy). Empty when nothing did — or when there is no record to compare with.
+ */
+export declare function changedSincePublish(root: string): string[];

package/dist/ads/publish.js

@@ -0,0 +1,108 @@
+/**
+ * `bitmagic ads publish` — upload the ad package to Bitmagic's cloud. Nothing is advertised.
+ *
+ * Refuses locally first (`checkAdPackage`, the same rules api-server applies), then uploads each of
+ * the six files through a signed PUT under the game's own `game-media/<gameId>/`, and registers the
+ * package. A file whose bytes match the last upload (`.bitmagic/ads/published.json`) is not sent
+ * again: rewriting a headline re-registers the package in a second.
+ *
+ * What it hands back is the page where the creator can choose to pay — `bitmagic ads buy` opens it.
+ */
+import { createHash } from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+import { AD_IMAGE_SLOT_NAMES, AD_VIDEO_SLOT_NAMES, normalizeAdCopy } from '@bitmagic/asset-core/ad-package';
+import { CliError } from '../errors.js';
+import { loadProjectContext } from '../project/context.js';
+import { resolveEnvironmentForCommand, resolveAuth0ClientId } from '../config/environments.js';
+import { getAccessToken } from '../auth/session.js';
+import { putSignedUrl } from '../http/signed-upload.js';
+import { checkAdPackage, CONTENT_TYPES, isComplete, manifestFrom } from './check.js';
+import { adsDir, adCopyPath } from './paths.js';
+import { mintAdUploadUrl, registerAdPackage } from './client.js';
+import { readAdRecord, writeAdRecord } from './record.js';
+import { probeMedia } from './probe.js';
+function defaultDeps() {
+    return { fetch: globalThis.fetch, sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)) };
+}
+export function sha256Of(bytes) {
+    return createHash('sha256').update(bytes).digest('hex');
+}
+/** The copy's fingerprint as registered: its normalized JSON, so whitespace edits do not count. */
+export function copySha256(copy) {
+    return sha256Of(JSON.stringify(normalizeAdCopy(copy)));
+}
+export async function runAdsPublish(options) {
+    const { root, output } = options;
+    const deps = options.deps ?? defaultDeps();
+    const check = await checkAdPackage(root, { probe: deps.probe ?? probeMedia });
+    const { copy, videos, images } = check;
+    if (!check.ok || copy === null || !isComplete(AD_VIDEO_SLOT_NAMES, videos) || !isComplete(AD_IMAGE_SLOT_NAMES, images)) {
+        throw new CliError(`The ad package is not ready:\n${check.problems.map((p) => `  - ${p}`).join('\n')}\nFix these and run \`bitmagic ads check\`.`, 1, 'ads_invalid');
+    }
+    const { metadata } = loadProjectContext(root);
+    const gameId = metadata.gameId;
+    const environment = resolveEnvironmentForCommand({ cwd: root, baseDir: deps.baseDir });
+    const accessToken = await getAccessToken(environment, resolveAuth0ClientId(environment), { fetch: deps.fetch, sleep: deps.sleep, now: deps.now }, deps.baseDir);
+    const previous = readAdRecord(root);
+    const reusable = previous !== null && previous.gameId === gameId ? previous.files : {};
+    const files = {};
+    const uploaded = [];
+    const reused = [];
+    for (const file of [...Object.values(videos), ...Object.values(images)]) {
+        const bytes = new Uint8Array(fs.readFileSync(file.path));
+        const sha256 = sha256Of(bytes);
+        const before = reusable[file.name];
+        if (before !== undefined && before.sha256 === sha256 && before.bytes === bytes.byteLength) {
+            files[file.name] = before;
+            reused.push(file.name);
+            continue;
+        }
+        output.info(`Uploading ${file.name} (${(bytes.byteLength / (1024 * 1024)).toFixed(1)} MiB)...`);
+        const ticket = await mintAdUploadUrl(environment, accessToken, { gameId, contentType: CONTENT_TYPES[file.kind], bytes: bytes.byteLength }, deps);
+        // Exactly the header the signature bound: game-media tickets pin only the content type.
+        await putSignedUrl(ticket.uploadUrl, bytes, { 'Content-Type': ticket.contentType }, deps);
+        files[file.name] = { url: ticket.publicUrl, sha256, bytes: bytes.byteLength };
+        uploaded.push(file.name);
+    }
+    const manifest = manifestFrom(check.gameName, copy, videos, images, (file) => files[file.name].url);
+    const registered = await registerAdPackage(environment, accessToken, { gameId, manifest }, deps);
+    const now = deps.now ?? Date.now;
+    writeAdRecord(root, {
+        gameId,
+        packageId: registered.packageId,
+        at: new Date(now()).toISOString(),
+        copySha256: copySha256(copy),
+        files,
+    });
+    return { gameId, packageId: registered.packageId, promoteUrl: registered.promoteUrl, promotable: registered.promotable, uploaded, reused };
+}
+/**
+ * What changed on disk since the last publish from this machine, by file name ("ads.json" for the
+ * copy). Empty when nothing did — or when there is no record to compare with.
+ */
+export function changedSincePublish(root) {
+    const record = readAdRecord(root);
+    if (record === null)
+        return [];
+    const changed = [];
+    try {
+        if (copySha256(JSON.parse(fs.readFileSync(adCopyPath(root), 'utf-8'))) !== record.copySha256)
+            changed.push('ads.json');
+    }
+    catch {
+        changed.push('ads.json');
+    }
+    for (const [name, before] of Object.entries(record.files)) {
+        try {
+            const bytes = new Uint8Array(fs.readFileSync(path.join(adsDir(root), name)));
+            if (bytes.byteLength !== before.bytes || sha256Of(bytes) !== before.sha256)
+                changed.push(name);
+        }
+        catch {
+            changed.push(name);
+        }
+    }
+    return changed;
+}
+//# sourceMappingURL=publish.js.map

package/dist/ads/publish.js.map

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

package/dist/ads/record.d.ts

@@ -0,0 +1,19 @@
+export interface AdRecordFile {
+    /** The CDN URL api-server issued, under the game's own `game-media/<gameId>/`. */
+    url: string;
+    sha256: string;
+    bytes: number;
+}
+export interface AdRecord {
+    gameId: string;
+    packageId: string;
+    /** ISO 8601. */
+    at: string;
+    /** SHA-256 of the copy as registered, so a later edit to ads.json is noticed. */
+    copySha256: string;
+    /** Keyed by file name inside `.bitmagic/ads/` (`video-16x9.mp4`, `image-1x1.jpg`, …). */
+    files: Record<string, AdRecordFile>;
+}
+export declare function writeAdRecord(root: string, record: AdRecord): void;
+/** The last publish, or null when there is none this reader can trust. */
+export declare function readAdRecord(root: string): AdRecord | null;

package/dist/ads/record.js

@@ -0,0 +1,53 @@
+/**
+ * The on-disk record of the last `bitmagic ads publish` (`.bitmagic/ads/published.json`).
+ *
+ * Two jobs. It lets a re-publish skip every file that has not changed since — an agent that only
+ * rewrites a headline re-registers the package without re-uploading three videos — by keeping each
+ * uploaded file's SHA-256 beside the URL api-server issued for it. And it lets `bitmagic ads buy`
+ * say when the package on the server is older than what is on disk.
+ *
+ * Every field is checked on read, in the style of trailer/publish-record.ts: the file outlives CLI
+ * versions, and a half-written or older-shaped record must read as "nothing uploaded yet", never as
+ * a URL reused for the wrong file.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { adRecordPath } from './paths.js';
+export function writeAdRecord(root, record) {
+    fs.mkdirSync(path.dirname(adRecordPath(root)), { recursive: true });
+    fs.writeFileSync(adRecordPath(root), `${JSON.stringify(record, null, 2)}\n`);
+}
+function isRecordFile(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const file = value;
+    return typeof file.url === 'string' && typeof file.sha256 === 'string' && typeof file.bytes === 'number';
+}
+/** The last publish, or null when there is none this reader can trust. */
+export function readAdRecord(root) {
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(adRecordPath(root), 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const record = parsed;
+    if (typeof record.gameId !== 'string'
+        || typeof record.packageId !== 'string'
+        || typeof record.at !== 'string'
+        || typeof record.copySha256 !== 'string'
+        || typeof record.files !== 'object'
+        || record.files === null) {
+        return null;
+    }
+    const files = {};
+    for (const [name, file] of Object.entries(record.files)) {
+        if (isRecordFile(file))
+            files[name] = { url: file.url, sha256: file.sha256, bytes: file.bytes };
+    }
+    return { gameId: record.gameId, packageId: record.packageId, at: record.at, copySha256: record.copySha256, files };
+}
+//# sourceMappingURL=record.js.map

package/dist/ads/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/ads/record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoB1C,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,MAAgB;IAC1D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,OAAO,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC;AAC3G,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,IACE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;WAC9B,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;WACpC,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;WAC7B,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;WACrC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;WAChC,MAAM,CAAC,KAAK,KAAK,IAAI,EACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAiC,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAgC,CAAC,EAAE,CAAC;QACnF,IAAI,YAAY,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAClG,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;AACrH,CAAC"}

package/dist/ads/render-plan.d.ts

@@ -0,0 +1,57 @@
+export type FitMode = 'scale' | 'crop' | 'blur';
+/** Gameplay loses at most this much of a side to a crop; past it, blur-fill keeps the HUD whole. */
+export declare const VIDEO_MAX_CROP_LOSS = 0.12;
+/** A cover is art, framed around its middle: it can lose more before blur-fill looks better. */
+export declare const COVER_MAX_CROP_LOSS = 0.45;
+/** The frame rate every ad video is written at. */
+export declare const AD_FPS = 30;
+/** How long the end card fades in over. */
+export declare const END_CARD_FADE_SEC = 0.35;
+/** The sound fades out over the last second. */
+export declare const AUDIO_FADE_SEC = 1;
+export declare function fitMode(srcWidth: number, srcHeight: number, dstWidth: number, dstHeight: number, maxCropLoss: number): FitMode;
+/**
+ * The filtergraph fragment fitting `[input]` into a `width`×`height` frame as `[output]`. `id`
+ * keeps the labels of several fragments in one graph apart.
+ */
+export declare function fitFilter(mode: FitMode, width: number, height: number, input: string, output: string, id: string): string;
+export interface SegmentChoice {
+    startSec: number;
+    durationSec: number;
+}
+/**
+ * The part of a source an ad uses: from `start`, at most `seconds`, never past `usableEnd` (the
+ * source's length, or where a trailer's own end card begins). Null when what is left is shorter
+ * than an ad may be.
+ */
+export declare function chooseSegment(usableEnd: number, start: number, seconds: number): SegmentChoice | null;
+/** Seconds as ffmpeg reads them: no exponent, at most three decimals. */
+export declare function sec(n: number): string;
+export interface VideoPlan {
+    source: string;
+    sourceWidth: number;
+    sourceHeight: number;
+    sourceHasAudio: boolean;
+    segment: SegmentChoice;
+    width: number;
+    height: number;
+    /** A full-frame PNG with alpha, faded in for the last `endCardSec`; omitted for no end card. */
+    endCardPng?: string;
+    endCardSec: number;
+    out: string;
+}
+/** The complete ffmpeg argument list for one ad video. */
+export declare function videoArgs(plan: VideoPlan): string[];
+export interface StillPlan {
+    source: string;
+    sourceWidth: number;
+    sourceHeight: number;
+    /** Where in a video to take the frame; omitted for an image source. */
+    atSec?: number;
+    maxCropLoss: number;
+    width: number;
+    height: number;
+    out: string;
+}
+/** The ffmpeg argument list for one still (JPEG). */
+export declare function stillArgs(plan: StillPlan): string[];

package/dist/ads/render-plan.js

@@ -0,0 +1,127 @@
+/**
+ * The pure half of `bitmagic ads render`: how a source fits each ad frame, and the exact ffmpeg
+ * arguments that make it. No filesystem, no processes, so every decision here is testable.
+ *
+ * Three ways to fit a source into a frame of another shape:
+ *
+ *  - `scale` — the shapes match (within 2%): resize.
+ *  - `crop`  — they nearly match: fill the frame and trim the overflow. Fine for a few percent of a
+ *              cover image; wrong for gameplay, where the HUD sits at the edges.
+ *  - `blur`  — they do not: the source whole, centred, over a blurred and darkened copy of itself
+ *              filling the frame. The standard way a landscape game clip becomes a 9:16 ad.
+ *
+ * Text is never drawn by ffmpeg (the trailer tooling's ffmpeg has no libfreetype): the end card is
+ * a PNG rasterized in Chrome, faded in over the last seconds.
+ */
+import { AD_VIDEO_SECONDS } from '@bitmagic/asset-core/ad-package';
+/** Gameplay loses at most this much of a side to a crop; past it, blur-fill keeps the HUD whole. */
+export const VIDEO_MAX_CROP_LOSS = 0.12;
+/** A cover is art, framed around its middle: it can lose more before blur-fill looks better. */
+export const COVER_MAX_CROP_LOSS = 0.45;
+/** The frame rate every ad video is written at. */
+export const AD_FPS = 30;
+/** How long the end card fades in over. */
+export const END_CARD_FADE_SEC = 0.35;
+/** The sound fades out over the last second. */
+export const AUDIO_FADE_SEC = 1;
+export function fitMode(srcWidth, srcHeight, dstWidth, dstHeight, maxCropLoss) {
+    const src = srcWidth / srcHeight;
+    const dst = dstWidth / dstHeight;
+    if (Math.abs(src - dst) / dst <= 0.02)
+        return 'scale';
+    // The share of the cropped side that survives a fill-and-crop.
+    const kept = Math.min(src, dst) / Math.max(src, dst);
+    return 1 - kept <= maxCropLoss ? 'crop' : 'blur';
+}
+/** Even, so every intermediate frame is valid yuv420p. */
+function even(n) {
+    return Math.max(2, Math.round(n / 2) * 2);
+}
+/**
+ * The filtergraph fragment fitting `[input]` into a `width`×`height` frame as `[output]`. `id`
+ * keeps the labels of several fragments in one graph apart.
+ */
+export function fitFilter(mode, width, height, input, output, id) {
+    if (mode === 'scale')
+        return `[${input}]scale=${width}:${height}:flags=lanczos,setsar=1[${output}]`;
+    if (mode === 'crop') {
+        return `[${input}]scale=${width}:${height}:force_original_aspect_ratio=increase:flags=lanczos,crop=${width}:${height},setsar=1[${output}]`;
+    }
+    // Blur at a quarter of the size: the same look for a fraction of the work.
+    const smallW = even(width / 4);
+    const smallH = even(height / 4);
+    return [
+        `[${input}]split=2[${id}bgsrc][${id}fgsrc]`,
+        `[${id}bgsrc]scale=${smallW}:${smallH}:force_original_aspect_ratio=increase,crop=${smallW}:${smallH},gblur=sigma=10,`
+            + `scale=${width}:${height},drawbox=x=0:y=0:w=iw:h=ih:color=black@0.35:t=fill[${id}bg]`,
+        `[${id}fgsrc]scale=${width}:${height}:force_original_aspect_ratio=decrease:force_divisible_by=2:flags=lanczos,setsar=1[${id}fg]`,
+        `[${id}bg][${id}fg]overlay=x=(W-w)/2:y=(H-h)/2,setsar=1[${output}]`,
+    ].join(';');
+}
+/**
+ * The part of a source an ad uses: from `start`, at most `seconds`, never past `usableEnd` (the
+ * source's length, or where a trailer's own end card begins). Null when what is left is shorter
+ * than an ad may be.
+ */
+export function chooseSegment(usableEnd, start, seconds) {
+    const available = usableEnd - start;
+    const durationSec = Math.min(seconds, available, AD_VIDEO_SECONDS.max);
+    if (!(durationSec >= AD_VIDEO_SECONDS.min))
+        return null;
+    // Whole frames, so every slot is exactly as long as the others.
+    return { startSec: start, durationSec: Math.floor(durationSec * AD_FPS) / AD_FPS };
+}
+/** Seconds as ffmpeg reads them: no exponent, at most three decimals. */
+export function sec(n) {
+    return (Math.round(n * 1000) / 1000).toFixed(3).replace(/\.?0+$/, '') || '0';
+}
+/** The complete ffmpeg argument list for one ad video. */
+export function videoArgs(plan) {
+    const { segment, width, height } = plan;
+    const duration = sec(segment.durationSec);
+    const args = ['-y', '-hide_banner', '-loglevel', 'error', '-ss', sec(segment.startSec), '-t', duration, '-i', plan.source];
+    let next = 1;
+    let cardInput = null;
+    if (plan.endCardPng !== undefined) {
+        cardInput = next++;
+        args.push('-loop', '1', '-framerate', String(AD_FPS), '-t', duration, '-i', plan.endCardPng);
+    }
+    let silenceInput = null;
+    if (!plan.sourceHasAudio) {
+        // A silent track rather than none: some placements treat a video with no audio stream as broken.
+        silenceInput = next++;
+        args.push('-f', 'lavfi', '-t', duration, '-i', 'anullsrc=r=48000:cl=stereo');
+    }
+    const mode = fitMode(plan.sourceWidth, plan.sourceHeight, width, height, VIDEO_MAX_CROP_LOSS);
+    const graph = [`[0:v]fps=${AD_FPS}[src]`, fitFilter(mode, width, height, 'src', 'base', 'v')];
+    if (cardInput !== null) {
+        const cardAt = Math.max(0, segment.durationSec - plan.endCardSec);
+        graph.push(`[${cardInput}:v]format=rgba,fade=t=in:st=${sec(cardAt)}:d=${sec(END_CARD_FADE_SEC)}:alpha=1[card]`);
+        graph.push('[base][card]overlay=0:0,format=yuv420p[v]');
+    }
+    else {
+        graph.push('[base]format=yuv420p[v]');
+    }
+    if (plan.sourceHasAudio) {
+        const fadeAt = Math.max(0, segment.durationSec - AUDIO_FADE_SEC);
+        graph.push(`[0:a]aresample=48000,afade=t=out:st=${sec(fadeAt)}:d=${sec(AUDIO_FADE_SEC)}[a]`);
+    }
+    args.push('-filter_complex', graph.join(';'), '-map', '[v]', '-map', silenceInput !== null ? `${silenceInput}:a` : '[a]', '-c:v', 'libx264', '-preset', 'medium', '-crf', '20', '-pix_fmt', 'yuv420p', '-profile:v', 'high', '-r', String(AD_FPS), '-c:a', 'aac', '-b:a', '128k', '-ar', '48000', '-ac', '2', '-t', duration, '-movflags', '+faststart', plan.out);
+    return args;
+}
+/** The ffmpeg argument list for one still (JPEG). */
+export function stillArgs(plan) {
+    const mode = fitMode(plan.sourceWidth, plan.sourceHeight, plan.width, plan.height, plan.maxCropLoss);
+    const seek = plan.atSec !== undefined ? ['-ss', sec(plan.atSec)] : [];
+    return [
+        '-y', '-hide_banner', '-loglevel', 'error',
+        ...seek,
+        '-i', plan.source,
+        '-filter_complex', fitFilter(mode, plan.width, plan.height, '0:v', 'v', 'i'),
+        '-map', '[v]',
+        '-frames:v', '1',
+        '-q:v', '2',
+        plan.out,
+    ];
+}
+//# sourceMappingURL=render-plan.js.map

package/dist/ads/render-plan.js.map

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

package/dist/ads/render.d.ts

@@ -0,0 +1,51 @@
+import { type AdCopy, type AdImageSlot, type AdVideoSlot } from '@bitmagic/asset-core/ad-package';
+import type { Output } from '../output.js';
+import { type SegmentChoice } from './render-plan.js';
+/** The end card's second line unless `--cta` says otherwise. True of every game on bitmagic.ai. */
+export declare const DEFAULT_CTA = "Play now in your browser";
+export interface AdsRenderOptions {
+    root: string;
+    output: Output;
+    /** The source video. Default: the newest `bitmagic trailer` render. */
+    video?: string;
+    /** A portrait (9:16) source for the 9:16 video, instead of blur-filling the main one. */
+    portrait?: string;
+    /** The source of the stills. Default: `.bitmagic/cover.webp`, else a frame of the video. */
+    image?: string;
+    /** How long the ads run. Default AD_VIDEO_SECONDS.recommended. */
+    seconds?: number;
+    /** Where in the source to start. Default 0. */
+    start?: number;
+    /** The end card's second line. Default DEFAULT_CTA. */
+    cta?: string;
+    /** False skips the end card. */
+    endCard: boolean;
+}
+export interface RenderedFile {
+    file: string;
+    width: number;
+    height: number;
+    durationSec: number;
+    bytes: number;
+}
+export interface AdsRenderResult {
+    source: string;
+    portraitSource?: string;
+    stillSource: string;
+    segment: SegmentChoice;
+    videos: Record<AdVideoSlot, RenderedFile>;
+    images: Record<AdImageSlot, RenderedFile>;
+    endCard: boolean;
+    /** True when this run wrote the empty copy file the agent now has to fill in. */
+    copyTemplateWritten: boolean;
+}
+/** The newest `bitmagic trailer` render under `.bitmagic/trailer/`, or null. */
+export declare function newestTrailerRender(root: string): string | null;
+/**
+ * Where the usable footage ends: where a trailer render's own end card begins (read from its EDL
+ * sidecar), else the end of the file. The ad draws its own end card at every size.
+ */
+export declare function usableEnd(file: string, durationSec: number): number;
+/** The copy file an agent fills in: every field present, every line empty, so `check` lists them. */
+export declare function emptyCopy(): AdCopy;
+export declare function runAdsRender(options: AdsRenderOptions): Promise<AdsRenderResult>;