@bitmagic/cli 0.1.61-dev.0 → 0.1.61-dev.2

package/dist/trailer/analyze.js.map

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

package/dist/trailer/auto-edl.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The first cut nobody had to author.
+ *
+ * `bitmagic trailer make` on a fresh recording has an analysis (scored highlight windows with
+ * contact sheets) and a target length, and must produce a watchable trailer with no shots file —
+ * so the agent has something to react to and tune, rather than a blank page. This module turns
+ * the analysis into a `ShotsFile` that follows the craft rules the make-trailer skill paid for:
+ *
+ *  - shots run 1.5–3 s and VARY in length (a fixed pattern, so no two neighbours match);
+ *  - the body is chronological — a first cut should tell the session's story, not shuffle it;
+ *  - a forced window (`score`, `lap`, `goal`, `match-end`) is always in, and a match-end is
+ *    pinned last so the end card dims over the finish;
+ *  - every shot starts a little BEFORE its peak event, so the action lands inside the shot
+ *    instead of on its first frame;
+ *  - speed is 1.0 everywhere — slow motion reads as a low framerate on gameplay footage;
+ *  - text is an end card only.
+ *
+ * When the analysis is thin (few events logged) the remaining slots are filled with evenly spaced
+ * shots across the recording, so every recording yields a trailer — a boring cut beats no cut, and
+ * the sheets let the agent replace shots in the next turn.
+ */
+import type { Analysis } from './timeline-types.js';
+import type { BeatAnalysis } from './music-beats.js';
+import type { ShotsFile } from './beat-cut.js';
+/** Seconds per body shot, cycled. All inside the craft doc's 1.5–3 s band, never two alike in a row. */
+export declare const SHOT_LENGTH_PATTERN_SEC: readonly number[];
+export declare const END_CARD_SEC = 2.5;
+/** How far before the peak event a shot begins, as a fraction of its length. */
+export declare const LEAD_IN_FRACTION = 0.6;
+/** Nothing in the first second: the game is still fading in from its menu. */
+export declare const SKIP_LEADING_SEC = 1;
+export declare const MIN_BEATS_PER_SHOT = 2;
+export declare const MAX_BEATS_PER_SHOT = 8;
+export interface AutoShotsInput {
+    analysis: Analysis;
+    recordingName: string;
+    /** Whole trailer including the end card, in seconds. */
+    targetSeconds: number;
+    /** When present, shot lengths become whole beats and the end card too. */
+    beats: BeatAnalysis | null;
+    title: string;
+    sub?: string;
+    /** Draw the HUD replay over every shot (the render's --ui). */
+    ui?: boolean;
+}
+export declare function buildAutoShots(input: AutoShotsInput): ShotsFile;

package/dist/trailer/auto-edl.js

@@ -0,0 +1,148 @@
+import { FORCED_EVENT_TYPES, eventWeight } from './analyze.js';
+/** Seconds per body shot, cycled. All inside the craft doc's 1.5–3 s band, never two alike in a row. */
+export const SHOT_LENGTH_PATTERN_SEC = [2, 1.5, 3, 2, 2.5, 1.5, 3];
+export const END_CARD_SEC = 2.5;
+/** How far before the peak event a shot begins, as a fraction of its length. */
+export const LEAD_IN_FRACTION = 0.6;
+/** Nothing in the first second: the game is still fading in from its menu. */
+export const SKIP_LEADING_SEC = 1;
+export const MIN_BEATS_PER_SHOT = 2;
+export const MAX_BEATS_PER_SHOT = 8;
+/** `"f3121 explosion i0.9"` -> the event's frame, type and weighted intensity. */
+function parseDigest(line) {
+    const match = /^f(\d+)\s+(\S+)\s+i([\d.]+)$/.exec(line.trim());
+    if (match === null)
+        return null;
+    const intensity = Number(match[3]);
+    return {
+        frame: Number(match[1]),
+        type: match[2],
+        weighted: eventWeight(match[2]) * (Number.isFinite(intensity) ? intensity : 1),
+    };
+}
+function toCandidate(window) {
+    let best = null;
+    let forced = false;
+    for (const line of window.events) {
+        const event = parseDigest(line);
+        if (event === null)
+            continue;
+        if (FORCED_EVENT_TYPES.includes(event.type))
+            forced = true;
+        if (best === null || event.weighted > best.weighted)
+            best = event;
+    }
+    const mid = Math.round((window.startFrame + window.endFrame) / 2);
+    return {
+        window,
+        peakFrame: best?.frame ?? mid,
+        peakType: best?.type ?? 'none',
+        forced,
+    };
+}
+/** A shot's length in whole beats when there is a grid — rounding the seconds, clamped to the band. */
+function beatsFor(seconds, beats) {
+    const beatSec = 60 / beats.bpm;
+    return Math.min(MAX_BEATS_PER_SHOT, Math.max(MIN_BEATS_PER_SHOT, Math.round(seconds / beatSec)));
+}
+/** Frame count a shot of `seconds` will occupy, including the slack a beat-snapped cut can add. */
+function framesFor(seconds, fps, beats) {
+    const slack = beats !== null ? 60 / beats.bpm : 0;
+    return Math.ceil((seconds + slack) * fps);
+}
+function describe(candidate, fps) {
+    const sec = candidate.peakFrame / fps;
+    const mm = Math.floor(sec / 60);
+    const ss = Math.floor(sec % 60).toString().padStart(2, '0');
+    const types = new Set();
+    for (const line of candidate.window.events) {
+        const event = parseDigest(line);
+        if (event !== null && event.weighted > 0)
+            types.add(event.type);
+    }
+    const what = types.size > 0 ? [...types].slice(0, 3).join(' + ') : 'gameplay';
+    return `${what} @${mm}:${ss}`;
+}
+export function buildAutoShots(input) {
+    const { analysis, beats } = input;
+    const fps = analysis.fps;
+    const frameCount = analysis.frameCount;
+    const skipFrames = Math.round(SKIP_LEADING_SEC * fps);
+    const bodyBudget = Math.max(SHOT_LENGTH_PATTERN_SEC[0], input.targetSeconds - END_CARD_SEC);
+    const meanLen = SHOT_LENGTH_PATTERN_SEC.reduce((a, b) => a + b, 0) / SHOT_LENGTH_PATTERN_SEC.length;
+    const slots = Math.max(1, Math.floor(bodyBudget / meanLen));
+    // Candidates: every analysed window with its peak inside the usable range; forced ones first,
+    // then by score, so the k best are taken but a forced window is never dropped for a louder one.
+    const candidates = analysis.windows
+        .map(toCandidate)
+        .filter((c) => c.peakFrame >= skipFrames && c.peakFrame < frameCount)
+        .filter((c) => c.peakType !== 'state');
+    const ranked = [...candidates].sort((a, b) => {
+        if (a.forced !== b.forced)
+            return a.forced ? -1 : 1;
+        return b.window.score - a.window.score;
+    });
+    const chosen = ranked.slice(0, Math.min(slots, ranked.length));
+    // Fill: evenly spaced across the recording, skipping spots an ANALYSED window already covers.
+    // Only the analysed picks count as cover — a filler must never shadow the next filler, or a
+    // short recording (fillers closer together than the radius) loses every second slot.
+    const missing = slots - chosen.length;
+    if (missing > 0) {
+        const analysed = [...chosen];
+        const usable = frameCount - skipFrames;
+        const spacing = usable / missing;
+        const radius = Math.min(3 * fps, spacing / 2);
+        for (let i = 0; i < missing; i++) {
+            const frame = skipFrames + Math.round((i + 0.5) * spacing);
+            const covered = analysed.some((c) => Math.abs(c.peakFrame - frame) < radius);
+            const filler = {
+                window: { startFrame: frame, endFrame: frame, score: 0, events: [], sheet: '' },
+                peakFrame: frame,
+                peakType: 'none',
+                forced: false,
+            };
+            if (!covered)
+                chosen.push(filler);
+        }
+    }
+    // Chronological, with a match-end pinned last.
+    chosen.sort((a, b) => a.peakFrame - b.peakFrame);
+    const endIndex = chosen.findIndex((c) => c.window.events.some((e) => parseDigest(e)?.type === 'match-end'));
+    if (endIndex >= 0 && endIndex !== chosen.length - 1) {
+        const [end] = chosen.splice(endIndex, 1);
+        chosen.push(end);
+    }
+    const shots = chosen.map((candidate, i) => {
+        const seconds = SHOT_LENGTH_PATTERN_SEC[i % SHOT_LENGTH_PATTERN_SEC.length];
+        const lenFrames = framesFor(seconds, fps, beats);
+        const ideal = candidate.peakFrame - Math.round(LEAD_IN_FRACTION * seconds * fps);
+        const start = Math.max(0, Math.min(ideal, frameCount - lenFrames));
+        const shot = { in: start, label: describe(candidate, fps) };
+        if (beats !== null)
+            shot.beats = beatsFor(seconds, beats);
+        else
+            shot.seconds = seconds;
+        if (input.ui === true)
+            shot.ui = true;
+        return shot;
+    });
+    // The end card sits over the last shot, so that shot must be long enough to carry it.
+    const last = shots[shots.length - 1];
+    if (beats !== null)
+        last.beats = Math.max(last.beats ?? 0, beatsFor(END_CARD_SEC, beats));
+    else
+        last.seconds = Math.max(last.seconds ?? 0, END_CARD_SEC);
+    last.in = Math.max(0, Math.min(last.in, frameCount - framesFor(last.seconds ?? END_CARD_SEC, fps, beats)));
+    const title = { at: 'last-clip', text: input.title.toUpperCase(), style: 'card' };
+    if (input.sub !== undefined)
+        title.sub = input.sub;
+    return {
+        version: 1,
+        recording: input.recordingName,
+        notes: 'First cut written by `bitmagic trailer make`. Edit freely: reorder, swap "in" frames for ' +
+            'better moments from analysis.json, change beats/seconds, add titles. Re-run make to render.',
+        shots,
+        titles: [title],
+    };
+}
+//# sourceMappingURL=auto-edl.js.map

package/dist/trailer/auto-edl.js.map

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

package/dist/trailer/beat-cut.d.ts

@@ -0,0 +1,57 @@
+import type { BeatAnalysis } from './music-beats.js';
+import type { TitleCue } from './titles.js';
+import type { Edl } from './timeline-types.js';
+export interface Shot {
+    /** Source frame the shot starts on. */
+    in: number;
+    /** Hold for this many beats (needs a beat grid). */
+    beats?: number;
+    /** Hold for this many seconds (used when there is no beat grid, or the shot has no `beats`). */
+    seconds?: number;
+    label: string;
+    /** Playback speed; the craft rule is 1.0 — slow-mo reads as a low framerate. */
+    speed?: number;
+    /** Draw (or suppress) the HUD replay over this shot; menus want `false`. */
+    ui?: boolean;
+    transition?: 'cut' | 'crossfade';
+    transitionDuration?: number;
+}
+/** A title whose `at` may be the literal `"last-clip"`; `dur` is then the last clip's length. */
+export type ShotTitle = Omit<TitleCue, 'at' | 'dur'> & {
+    at: number | 'last-clip';
+    dur?: number;
+};
+export interface ShotsFile {
+    version: 1;
+    /** Name of the recording these frame indices were chosen from. */
+    recording?: string;
+    /** Free-form notes the author keeps with the cut (never read by the tool). */
+    notes?: string;
+    shots: Shot[];
+    titles?: ShotTitle[];
+}
+export interface CutOptions {
+    /** Frames in the recording; a shot that would run past the end is shifted earlier and reported. */
+    frameCount?: number;
+}
+export interface CutResult {
+    edl: Edl;
+    /** Beats consumed from the downbeat (0 without a grid). */
+    beatsUsed: number;
+    totalSec: number;
+    /** Largest distance between a cut and its beat target, in ms (0 without a grid). */
+    worstCutErrorMs: number;
+    /** The first shot that did not fit in the track, when the grid ran out. */
+    truncatedAt?: string;
+}
+/** Parse a shots document: either a bare array of shots or `{ version, shots, titles? }`. */
+export declare function parseShots(raw: unknown, source: string): ShotsFile;
+export declare function loadShots(filePath: string): ShotsFile;
+/**
+ * Turn shots into frame-exact clips. With `beats` every cut lands on the grid counted from the
+ * downbeat; without, each shot's `seconds` decides its length. Returns the EDL plus the numbers
+ * the command prints so the author can judge the fit.
+ */
+export declare function cutShots(shots: ShotsFile, beats: BeatAnalysis | null, fps: number, options?: CutOptions): CutResult;
+/** The one-line summary `bitmagic trailer cut` prints, mirroring the Python script's. */
+export declare function describeCut(result: CutResult, beats: BeatAnalysis | null): string;

package/dist/trailer/beat-cut.js

@@ -0,0 +1,232 @@
+/**
+ * Snap a shot list onto a beat grid (or plain seconds) and emit an EDL.
+ *
+ * A shot says WHICH source frame to start on and HOW LONG to hold, in beats when there is music
+ * and in seconds when there is not; this turns that into the frame-exact `edl.json` the renderer
+ * consumes. It is the TypeScript port of the make-trailer skill's `beat-edl.py`, so creators need
+ * no Python.
+ *
+ * Each cut's target time comes straight from the beat grid, and the frame count is the difference
+ * against the frames ACTUALLY emitted so far — not against the previous target. That matters for
+ * speed-ramped clips: at 0.5x the output length is forced to an even number of frames, so a clip
+ * whose beat-target is odd lands one frame long. Measuring from actual output makes the next clip
+ * absorb that frame instead of every later cut inheriting it.
+ *
+ * A title cue with `"at": "last-clip"` is resolved to cover the final clip (the end card), so it
+ * survives regeneration without hand-editing output times.
+ */
+import * as fs from 'fs';
+import { CliError } from '../errors.js';
+import { warn } from './io.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function finiteNumber(value, ctx) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new CliError(`${ctx}: expected a number, got ${JSON.stringify(value)}`);
+    }
+    return value;
+}
+function parseShot(raw, index) {
+    const ctx = `shots[${index}]`;
+    if (!isRecord(raw))
+        throw new CliError(`${ctx}: expected an object`);
+    const shot = {
+        in: finiteNumber(raw.in, `${ctx}.in`),
+        label: typeof raw.label === 'string' && raw.label.length > 0 ? raw.label : `shot ${index + 1}`,
+    };
+    if (shot.in < 0 || !Number.isInteger(shot.in))
+        throw new CliError(`${ctx}.in: expected a frame index >= 0`);
+    if (raw.beats !== undefined) {
+        shot.beats = finiteNumber(raw.beats, `${ctx}.beats`);
+        if (shot.beats <= 0)
+            throw new CliError(`${ctx}.beats: must be > 0`);
+    }
+    if (raw.seconds !== undefined) {
+        shot.seconds = finiteNumber(raw.seconds, `${ctx}.seconds`);
+        if (shot.seconds <= 0)
+            throw new CliError(`${ctx}.seconds: must be > 0`);
+    }
+    if (shot.beats === undefined && shot.seconds === undefined) {
+        throw new CliError(`${ctx} ("${shot.label}"): needs "beats" (with music) or "seconds"`);
+    }
+    if (raw.speed !== undefined)
+        shot.speed = finiteNumber(raw.speed, `${ctx}.speed`);
+    if (raw.ui !== undefined) {
+        if (typeof raw.ui !== 'boolean')
+            throw new CliError(`${ctx}.ui: expected true or false`);
+        shot.ui = raw.ui;
+    }
+    if (raw.transition !== undefined) {
+        if (raw.transition !== 'cut' && raw.transition !== 'crossfade') {
+            throw new CliError(`${ctx}.transition: expected "cut" or "crossfade"`);
+        }
+        shot.transition = raw.transition;
+    }
+    if (raw.transitionDuration !== undefined) {
+        shot.transitionDuration = finiteNumber(raw.transitionDuration, `${ctx}.transitionDuration`);
+    }
+    return shot;
+}
+function parseTitle(raw, index) {
+    const ctx = `titles[${index}]`;
+    if (!isRecord(raw))
+        throw new CliError(`${ctx}: expected an object`);
+    if (typeof raw.text !== 'string')
+        throw new CliError(`${ctx}.text: expected a string`);
+    const title = { text: raw.text, at: 0 };
+    if (raw.at === 'last-clip')
+        title.at = 'last-clip';
+    else
+        title.at = finiteNumber(raw.at, `${ctx}.at`);
+    if (raw.dur !== undefined)
+        title.dur = finiteNumber(raw.dur, `${ctx}.dur`);
+    if (typeof raw.sub === 'string')
+        title.sub = raw.sub;
+    if (typeof raw.note === 'string')
+        title.note = raw.note;
+    if (raw.style === 'title' || raw.style === 'line' || raw.style === 'card')
+        title.style = raw.style;
+    return title;
+}
+/** Parse a shots document: either a bare array of shots or `{ version, shots, titles? }`. */
+export function parseShots(raw, source) {
+    const shotsRaw = Array.isArray(raw) ? raw : isRecord(raw) ? raw.shots : undefined;
+    if (!Array.isArray(shotsRaw))
+        throw new CliError(`${source}: expected a "shots" array`);
+    if (shotsRaw.length === 0)
+        throw new CliError(`${source}: "shots" is empty — nothing to cut`);
+    const file = { version: 1, shots: shotsRaw.map(parseShot) };
+    if (isRecord(raw)) {
+        if (raw.version !== undefined && raw.version !== 1) {
+            throw new CliError(`${source}: unsupported version ${JSON.stringify(raw.version)} (this CLI writes version 1)`);
+        }
+        if (typeof raw.recording === 'string')
+            file.recording = raw.recording;
+        if (typeof raw.notes === 'string')
+            file.notes = raw.notes;
+        if (raw.titles !== undefined) {
+            if (!Array.isArray(raw.titles))
+                throw new CliError(`${source}: "titles" must be an array`);
+            file.titles = raw.titles.map(parseTitle);
+        }
+    }
+    return file;
+}
+export function loadShots(filePath) {
+    if (!fs.existsSync(filePath))
+        throw new CliError(`Shots file not found: ${filePath}`);
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch (err) {
+        throw new CliError(`Invalid JSON in ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return parseShots(raw, filePath);
+}
+/**
+ * Turn shots into frame-exact clips. With `beats` every cut lands on the grid counted from the
+ * downbeat; without, each shot's `seconds` decides its length. Returns the EDL plus the numbers
+ * the command prints so the author can judge the fit.
+ */
+export function cutShots(shots, beats, fps, options = {}) {
+    if (!Number.isFinite(fps) || fps <= 0)
+        throw new CliError(`invalid fps: ${fps}`);
+    const grid = beats?.beatTimes ?? null;
+    const start = beats?.downbeatIndex ?? 0;
+    const t0 = grid !== null ? grid[start] : 0;
+    if (grid !== null && (t0 === undefined || grid.length < 2)) {
+        throw new CliError('The beat grid has too few beats to cut on — check the music file or pass --bpm.');
+    }
+    const clips = [];
+    let cum = start;
+    let emitted = 0;
+    let worst = 0;
+    let truncatedAt;
+    for (const shot of shots.shots) {
+        const speed = shot.speed ?? 1.0;
+        let need;
+        let suffix;
+        if (grid !== null && shot.beats !== undefined) {
+            const next = cum + shot.beats;
+            if (next >= grid.length) {
+                truncatedAt = shot.label;
+                break;
+            }
+            const target = Math.round((grid[next] - t0) * fps);
+            need = target - emitted;
+            cum = next;
+            suffix = `[${shot.beats}b]`;
+        }
+        else if (shot.seconds !== undefined) {
+            need = Math.round(shot.seconds * fps);
+            suffix = `[${shot.seconds}s]`;
+        }
+        else {
+            throw new CliError(`Shot "${shot.label}" is timed in beats but there is no beat grid — pass --music (or --beats), or give it "seconds".`);
+        }
+        const src = Math.max(1, Math.round(need * speed));
+        const actual = Math.round(src / speed);
+        emitted += actual;
+        if (grid !== null && shot.beats !== undefined) {
+            const target = Math.round((grid[cum] - t0) * fps);
+            worst = Math.max(worst, (Math.abs(emitted - target) / fps) * 1000);
+        }
+        let inFrame = shot.in;
+        if (options.frameCount !== undefined && inFrame + src > options.frameCount) {
+            const shifted = Math.max(0, options.frameCount - src);
+            warn(`shot "${shot.label}" runs past the recording's last frame — starting it at ${shifted} instead of ${inFrame}`);
+            inFrame = shifted;
+        }
+        const clip = {
+            in: inFrame,
+            out: inFrame + src,
+            speed,
+            transition: shot.transition ?? 'cut',
+            label: `${shot.label} ${suffix}`,
+        };
+        if (shot.transitionDuration !== undefined)
+            clip.transitionDuration = shot.transitionDuration;
+        if (shot.ui !== undefined)
+            clip.ui = shot.ui;
+        clips.push(clip);
+    }
+    if (clips.length === 0) {
+        throw new CliError(`Not a single shot fits the music: "${truncatedAt ?? shots.shots[0].label}" already runs past the end of the track.`);
+    }
+    const totalSec = emitted / fps;
+    const edl = { version: 1, targetDuration: Math.round(totalSec * 100) / 100, clips };
+    if (shots.titles !== undefined && shots.titles.length > 0) {
+        const last = clips[clips.length - 1];
+        const lastDur = Math.round(last.out - last.in) / ((last.speed ?? 1) * fps);
+        edl.titles = shots.titles.map((title) => {
+            const { at, dur, ...rest } = title;
+            if (at === 'last-clip') {
+                return { ...rest, at: Math.round((totalSec - lastDur) * 1000) / 1000, dur: Math.round(lastDur * 1000) / 1000 };
+            }
+            return { ...rest, at, dur: dur ?? 2.5 };
+        });
+    }
+    const result = {
+        edl,
+        beatsUsed: grid !== null ? cum - start : 0,
+        totalSec,
+        worstCutErrorMs: worst,
+    };
+    if (truncatedAt !== undefined)
+        result.truncatedAt = truncatedAt;
+    return result;
+}
+/** The one-line summary `bitmagic trailer cut` prints, mirroring the Python script's. */
+export function describeCut(result, beats) {
+    const parts = [
+        beats !== null ? `bpm=${beats.bpm.toFixed(2)}` : 'no beat grid',
+        `clips=${result.edl.clips.length}`,
+        beats !== null ? `beats=${result.beatsUsed}` : null,
+        `total=${result.totalSec.toFixed(3)}s`,
+        beats !== null ? `worst cut error=${result.worstCutErrorMs.toFixed(1)} ms` : null,
+    ].filter((p) => p !== null);
+    return parts.join('  ');
+}
+//# sourceMappingURL=beat-cut.js.map

package/dist/trailer/beat-cut.js.map

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

package/dist/trailer/client.d.ts

@@ -0,0 +1,52 @@
+import type { Environment } from '../config/environments.js';
+import { type ApiDeps } from '../http/client.js';
+export declare const TRAILER_UPLOAD_URL_PATH = "/api/cli/v1/trailer/upload-url";
+export declare const TRAILER_ATTACH_PATH = "/api/cli/v1/trailer/attach";
+/** The gallery cap api-server enforces (`MAX_MEDIA_ITEMS` in game-page-edit-rules.ts). */
+export declare const MAX_GALLERY_ITEMS = 12;
+export interface TrailerUploadRequest {
+    gameId: string;
+    /** `video/mp4` or `video/webm` — api-server refuses anything else before minting. */
+    contentType: string;
+    bytes: number;
+}
+/** `cli-trailer.ts`'s upload-url response. */
+export interface TrailerUploadTicket {
+    uploadUrl: string;
+    /** Where the video is served from once the PUT lands — what `attach` is given. */
+    publicUrl: string;
+    path: string;
+    maxBytes: number;
+    /** Echoed by the server: the exact value the PUT's Content-Type must carry. */
+    contentType: string;
+}
+export interface TrailerAttachRequest {
+    gameId: string;
+    url: string;
+    /** The previous trailer's URL, dropped from the gallery so a re-run replaces instead of adding. */
+    replaceUrl?: string;
+}
+/** `cli-trailer.ts`'s attach response. */
+export interface TrailerAttachResult {
+    media: unknown[];
+    pageUrl: string;
+    isPublic: boolean;
+    /** False until the game's first `bitmagic publish` — the page exists but is not live yet. */
+    published: boolean;
+}
+/** Context the 409 message can use: where the creator goes to make room. */
+export interface TrailerAttachHints {
+    /** The My games page, from the publish record when there has been a publish. */
+    manageUrl?: string;
+}
+/**
+ * Ask api-server for a signed PUT under `game-media/<gameId>/`. Ownership and the video-only rule
+ * are checked there before anything is minted, so a refusal here has cost nothing.
+ */
+export declare function mintTrailerUploadUrl(environment: Environment, accessToken: string, body: TrailerUploadRequest, deps: ApiDeps): Promise<TrailerUploadTicket>;
+/**
+ * Put the uploaded video at the front of the game page's gallery. api-server drops any item already
+ * pointing at `url` or at `replaceUrl`, so re-running replaces the previous trailer rather than
+ * stacking a new one beside it.
+ */
+export declare function attachTrailer(environment: Environment, accessToken: string, body: TrailerAttachRequest, deps: ApiDeps, hints?: TrailerAttachHints): Promise<TrailerAttachResult>;