@bitmagic/cli 0.1.80 → 0.1.81

package/dist/scaffold/blender-level-skill-files.js

@@ -153,15 +153,16 @@ walk it in \`bitmagic dev\`. \`assets add\` uploads to the CDN, \`verify\` type-
 drives a real Chrome through a settle loop, \`judge\` spends sparks and must not be run twice on
 one milestone. Run it at the END of a pass — never after an edit.
 
-**The gate: do not hand the level to the engine until the contact sheet has nothing wrong on it
-and both audit modes exit 0.** Every build writes \`build/level/<name>.glb\` already; that is free.
+**The gate: do not hand the level to the engine until the build prints no \`WARNING\`, the contact
+sheet has nothing wrong on it and both audit modes exit 0.** Every build writes \`build/level/<name>.glb\` already; that is free.
 Publishing it is what costs. A round trip through the engine to discover a hole in a floor is a
 round trip the audit would have made for nothing, and the station lost a day to exactly that.
 
 | The level is wrong like this | Found in |
 |---|---|
 | a hole in a floor, a doorway you cannot walk through, a route blocked by a prop, a room that is not sealed | the Blender loop — \`audit.py\`, both modes |
-| z-fighting, a blank wall, a sign that reads backwards, a missing ceiling, stairs ending in air, a wedge of sky beside a junction, the wrong footprint | the Blender loop — the contact sheet |
+| two surfaces flickering into each other (z-fighting) | the Blender loop — the build's \`[bmlevel] WARNING\`; a still render cannot show it |
+| a blank wall, a sign that reads backwards, a missing ceiling, stairs ending in air, a wedge of sky beside a junction, the wrong footprint | the Blender loop — the contact sheet |
 | the level washed out or black, an empty published game, doors animating inside walls, no NPCs, the framerate | the engine handoff — nothing in Blender can see these |
 
 ## The Blender loop
@@ -173,7 +174,10 @@ round trip the audit would have made for nothing, and the station lost a day to
 \`\`\`
 
 It prints \`LEVEL … colliders … doors … volumes …\`, \`BOUNDS\`, and a \`REGISTER bitmagic assets add …\`
-line to keep for step 7. Outputs: \`build/level/<name>.glb\` (one draw call per material),
+line to keep for step 7. A \`[bmlevel] WARNING … will FLICKER in the game (z-fighting)\` line names
+faces of two materials lying on one plane — trim flush on a wall, a sign on its board, a rug on the
+floor — with game coordinates. A render does not show the flicker, so fix every one (rules below)
+and rebuild before you go on. Outputs: \`build/level/<name>.glb\` (one draw call per material),
 \`<name>.blend\` (named, editable parts), \`<name>.mesh-level.json\`, \`<name>.doors.json\`. A syntax
 or geometry error prints a Python traceback naming the helper and the object — fix and rebuild;
 builds take seconds. \`python3 tools/level/<name>.py --dry-run\` gives the counts without Blender.
@@ -186,8 +190,8 @@ builds take seconds. \`python3 tools/level/<name>.py --dry-run\` gives the count
 
 Read \`build/level/review/contact-sheet.png\` (the log says which frame is which), then any single
 frame that looks wrong. You are looking for: a door with no wall around it, a room whose ceiling
-is missing, stairs that end in the air, a sign that reads backwards, two surfaces flickering into
-one another. Fix the script, rebuild, re-render. Do not go on to the audit while the sheet is
+is missing, stairs that end in the air, a sign that reads backwards. (Flicker never shows in a
+still frame; that is the build's \`WARNING\`.) Fix the script, rebuild, re-render. Do not go on to the audit while the sheet is
 wrong; the audit finds holes, not ugliness.
 
 The fixed set is what you read first. After that the flags turn it into a camera you can aim, so
@@ -217,8 +221,8 @@ Every check prints its ray count and its failures with coordinates; exit 1 means
 not done. A failed \`floor_continuity\` is a hole a player falls through; a failed \`door_clearance\`
 or \`link_clearance\` is a doorway or route the player cannot walk (a jamb in the opening, a table
 on the line between two rooms, a step that ends short); a failed \`sealed_envelope\` is a gap in a
-roof or wall. \`coplanar_overlap\` is a warning: two faces on one plane, which flicker. Never
-answer a failure by removing the volume or the link that found it.
+roof or wall. \`coplanar_overlap\` is a warning: two faces on one plane, which flicker — fix it as
+you would the build's. Never answer a failure by removing the volume or the link that found it.
 
 A failure sends you back to step 4, not on to step 7. Both modes exiting 0 with a clean contact
 sheet is the whole gate; nothing below can be trusted until you have it.
@@ -364,9 +368,11 @@ the single most common review-sheet finding.
 1. **Overlap, never abut.** Two slabs meeting edge to edge leave a hairline a ray falls through
    and a capsule catches on. Overlap by 5 cm. The audit's \`floor_continuity\` finds the seam.
 2. **Offset coplanar faces by 5 cm.** A cladding panel flush with the wall it decorates flickers.
-   Push it out 5 cm (or in 5 cm, as an inset). \`coplanar_overlap\` warns about the ones on solids.
-3. **Give layered parts distinct depths.** Casing 0.30 m, header 0.34 m, trim 0.26 m: no two
-   layers share a face plane. The door helper does this for its own jambs and header.
+   Push it out 5 cm (or in 5 cm, as an inset). The build's \`[bmlevel] WARNING\` checks every face,
+   \`decor()\` and text included; the audit's \`coplanar_overlap\` only box colliders.
+3. **Give layered parts distinct depths.** On a 0.30 m wall: casing 0.34 m, header 0.38 m — no two
+   layers share a face plane, the wall's included. The door helper does this for its own jambs and
+   header (\`jamb_depth\` 0.34 m by default); on a thicker wall, pass a deeper \`jamb_depth\`.
 
 Bevels (\`bevel=\`) catch light on edges and read as "made", not "boxed"; 1–5 cm on furniture and
 casings, none on walls.

package/dist/scaffold/blender-level-skill-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"blender-level-skill-files.js","sourceRoot":"","sources":["../../src/scaffold/blender-level-skill-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,UAAU,wBAAwB;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8QR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyFR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyER,CAAC;AACF,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgHR,CAAC;AACF,CAAC"}
+{"version":3,"file":"blender-level-skill-files.js","sourceRoot":"","sources":["../../src/scaffold/blender-level-skill-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,UAAU,wBAAwB;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkRR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2FR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyER,CAAC;AACF,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgHR,CAAC;AACF,CAAC"}

package/dist/scaffold/project-files.js

@@ -1224,7 +1224,7 @@ the engine, already wired** — and hand-building a worse version of it is the m
 
 | The idea needs… | The engine already has | Read |
 |---|---|---|
-| A melee weapon — sword, axe, katana, spear, staff, lightsaber | 12 built-in procedural weapons | \`combat-system.md\` |
+| A melee weapon — sword, axe, katana, spear, staff, laser sword | 12 built-in procedural weapons | \`combat-system.md\` |
 | A ranged weapon — pistol, rifle, bow, crossbow, bazooka, laser | Built-in set; aiming adapts to the camera mode | \`combat-system.md\` |
 | Punching, kicking, martial arts | \`UnarmedMeleeSystem\`, animations pre-loaded | \`combat-system.md\` |
 | Enemies that patrol, chase, attack, follow, flee, trade | NPC behaviours; NPCs use the built-in weapons too | \`npc-system.md\` |

package/dist/scaffold/skill-files.js

@@ -198,9 +198,10 @@ and running one command again.
    per candidate window — and extract stills from the RENDERED file to check framing
    (\`ffmpeg -ss 12 -i <mp4> -frames:v 1 still.png\`). The timeline knows about events, not about
    beauty, occlusion or a camera pointing at a wall.
-5. **Tune** (below), then **publish**: \`bitmagic trailer make --publish\` (or
-   \`bitmagic trailer publish <mp4>\`) uploads to the CDN and puts the video first in the game
-   page gallery; re-running replaces the previous trailer. Give the creator the printed URL.
+5. **Tune** (below), check the **15-second edition** too (next section), then **publish**:
+   \`bitmagic trailer make --publish\` (or \`bitmagic trailer publish <mp4>\`) uploads the trailer
+   and its edition to the CDN and puts the trailer first in the game page gallery; re-running
+   replaces the previous trailer. Give the creator the printed URL.
 
 Renders never overwrite — each run writes the next \`-rN\` — so compare against the previous
 cut before delivering.
@@ -210,12 +211,14 @@ cut before delivering.
 | File | What it is |
 |---|---|
 | \`trailer/shots.json\` | **The cut.** Committed. Your edits live here; \`make\` re-cuts from it every run. |
+| \`trailer/preview-shots.json\` | **The 15-second edition's cut**, same format. Committed. \`"auto": true\` = written by \`make\` and rebuilt from shots.json every run; delete that line to own it. |
 | \`trailer/flythrough.json\` | A camera path you author. Committed. Records with nobody playing — the whole trailer, or just the opening shot. |
 | \`.bitmagic/trailer/recordings/<name>/\` | A recording: \`<name>_%06d.png\` at 60 fps + \`timeline.json\` (events, sounds, HUD). |
 | \`.bitmagic/trailer/<name>/analysis.json\` | Scored highlight windows: \`startFrame\`, \`endFrame\`, \`score\`, event digests (\`"f3121 explosion i0.9"\`), \`sheet\`. |
 | \`.bitmagic/trailer/<name>/sheets/\` | Contact sheets, one per window — read these. |
 | \`.bitmagic/trailer/<name>/beats.json\`, \`music.mp3\` | The bed and its beat grid. |
 | \`.bitmagic/trailer/<name>/edl.json\`, \`*-trailer[-rN].mp4\` | The frame-exact cut and the renders (each with its \`.edl.json\`). |
+| \`.bitmagic/trailer/<name>/preview-edl.json\`, \`*-trailer[-rN]-preview.mp4\` | The 15-second edition's cut and render, next to the trailer it belongs to. |
 
 ### shots.json
 
@@ -255,6 +258,35 @@ direction per leg (a drifting push or a slow arc reads as deliberate; a whip-pan
 mistake), and give each leg several seconds. Six markers over 20 s is plenty for the two or three
 shots a cut will actually use — you are recording candidate footage, not the trailer.
 
+## The 15-second edition — what the game page actually plays
+
+The game page does not open on the trailer. It loops a **15-second silent preview** behind its
+first screen — 16:9 on a desktop, full-screen 9:16 on a phone — and the trailer itself is one
+click away. Bitmagic's server makes those previews from the edition you upload next to the trailer;
+without one it takes the trailer's FIRST 15 seconds, which are its opening, not its best moments.
+So every \`make\` also renders the edition, \`*-trailer[-rN]-preview.mp4\`, and \`--publish\` uploads
+it with the trailer.
+
+- **The first cut is automatic**: the trailer's highest-scoring shots up to 15 s, in trailer order,
+  without the end card or any title. It lives in \`trailer/preview-shots.json\` with
+  \`"auto": true\` and follows shots.json on every run.
+- **Make it the best 15 seconds**, not a summary: the strongest action the game has, the hook
+  first, no menus, no text (the page draws the game's name and the Play button over it), each shot
+  readable at a glance. It loops, so a last shot that leads back into the first is a bonus.
+  To edit it, delete the \`"auto"\` line and change the shots (\`seconds\` only — it has no music),
+  then run \`make\` again.
+- **Phones see the centre of the frame**: the largest centred 9:16 window of the 16:9 edition. Check
+  it on stills from the rendered edition before publishing
+  (\`ffmpeg -ss 5 -i <preview.mp4> -vf "crop=ih*9/16:ih" -frames:v 1 phone.png\`): the player, the
+  car, the explosion must be in the middle. If the action lives at the edges, render a vertical
+  edition (a portrait recording, or your own 9:16 cut) and pass it with
+  \`bitmagic trailer publish <mp4> --preview-tall <9x16.mp4>\`.
+- **Already published?** \`bitmagic trailer previews --wide <16x9.mp4> [--tall <9x16.mp4>]\`
+  uploads new editions for the trailer on the page; the page shows them within minutes (a browser
+  that already played the old ones can keep them up to a day).
+- \`--no-preview\` on \`make\` or \`publish\` skips the edition; the page then loops the trailer's
+  first 15 seconds. Only do that when the creator asks.
+
 ## Craft — read \`references/trailer-craft.md\` before touching the cut
 
 Everything about WHICH moments and in what order lives in
@@ -289,6 +321,7 @@ The creator talks; you edit \`trailer/shots.json\`, run \`bitmagic trailer make\
 | "shorter / longer" | \`--seconds N\` only matters for a fresh auto cut (\`--reset-shots\`); otherwise add or remove shots |
 | "start over" | \`bitmagic trailer make --reset-shots\` |
 | "use the other recording" | \`--recording <dir>\`; shots.json from another recording is kept beside a fresh cut |
+| "the page video is boring", "better preview", "the loop on the game page" | edit \`trailer/preview-shots.json\` (delete \`"auto"\` first): the best 15 s, action centred; \`make\`, then \`publish\` — or \`trailer previews --wide\` for the trailer already on the page |
 
 Then: **quota check** the labels (rule of three, one standing start), render, extract two stills
 from the changed region, compare with the previous \`-rN\`, deliver the URL.

package/dist/scaffold/skill-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-files.js","sourceRoot":"","sources":["../../src/scaffold/skill-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;CAkBR,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAsB;IAC7E,2FAA2F;IAC3F,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;IAC7F,6FAA6F;IAC7F,0EAA0E;IAC1E,MAAM,WAAW,GACf,QAAQ,CAAC,MAAM,KAAK,CAAC;QACnB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,8FAA8F;YAC9F,mEAAmE;YACnE,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5C,iFAAiF,CAAC;IAExF,OAAO;;sBAEa,SAAS,SAAS,iBAAiB,CAAC,SAAS,CAAC;;;EAGlE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCZ,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6JR,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,sCAAsC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/F,OAAO,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqIR,CAAC;AACF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,+BAA+B;IAC7C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkER,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgER,CAAC;AACF,CAAC"}
+{"version":3,"file":"skill-files.js","sourceRoot":"","sources":["../../src/scaffold/skill-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;CAkBR,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAsB;IAC7E,2FAA2F;IAC3F,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;IAC7F,6FAA6F;IAC7F,0EAA0E;IAC1E,MAAM,WAAW,GACf,QAAQ,CAAC,MAAM,KAAK,CAAC;QACnB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,8FAA8F;YAC9F,mEAAmE;YACnE,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5C,iFAAiF,CAAC;IAExF,OAAO;;sBAEa,SAAS,SAAS,iBAAiB,CAAC,SAAS,CAAC;;;EAGlE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCZ,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8LR,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,sCAAsC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/F,OAAO,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqIR,CAAC;AACF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,+BAA+B;IAC7C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkER,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgER,CAAC;AACF,CAAC"}

package/dist/trailer/client.d.ts

@@ -2,6 +2,10 @@ 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";
+export declare const TRAILER_PREVIEW_UPLOAD_URL_PATH = "/api/cli/v1/trailer/preview-upload-url";
+export declare const TRAILER_PREVIEWS_PATH = "/api/cli/v1/trailer/previews";
+/** A 15-second edition of the trailer: `wide` is 16:9 (desktop), `tall` 9:16 (phones). */
+export type PreviewCut = 'wide' | 'tall';
 /** 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 {
@@ -50,3 +54,38 @@ export declare function mintTrailerUploadUrl(environment: Environment, accessTok
  * stacking a new one beside it.
  */
 export declare function attachTrailer(environment: Environment, accessToken: string, body: TrailerAttachRequest, deps: ApiDeps, hints?: TrailerAttachHints): Promise<TrailerAttachResult>;
+export interface PreviewCutUploadRequest {
+    gameId: string;
+    /** The trailer the cut belongs to: uploaded by `trailer/upload-url`, attached or not yet. */
+    url: string;
+    cut: PreviewCut;
+    /** Always `video/mp4`: the only type api-server takes for a cut. */
+    contentType: string;
+    bytes: number;
+}
+/** `cli-trailer.ts`'s preview-upload-url response. */
+export interface PreviewCutUploadTicket {
+    uploadUrl: string;
+    publicUrl: string;
+    path: string;
+    contentType: string;
+}
+/**
+ * Ask api-server for a signed PUT for one of the trailer's 15-second cuts. A 404 that is not "Game
+ * not found" is an api-server from before cuts existed: `unsupported`, which the publish treats as
+ * "the page loops the trailer's first 15 seconds", not as a failed publish.
+ */
+export declare function mintPreviewCutUploadUrl(environment: Environment, accessToken: string, body: PreviewCutUploadRequest, deps: ApiDeps): Promise<PreviewCutUploadTicket>;
+/** `cli-trailer.ts`'s previews response. */
+export interface RemakePreviewsResult {
+    /** Whether the trailer is the page's first video — the one whose previews pages play. */
+    hero: boolean;
+    pageUrl: string;
+    isPublic: boolean;
+    published: boolean;
+}
+/** New cuts of a trailer already on the page: have api-server remake its previews from them. */
+export declare function remakePreviews(environment: Environment, accessToken: string, body: {
+    gameId: string;
+    url: string;
+}, deps: ApiDeps): Promise<RemakePreviewsResult>;

package/dist/trailer/client.js

@@ -1,6 +1,8 @@
 /**
- * The two api-server calls behind `bitmagic trailer publish`: mint a signed PUT for the video,
- * and attach the uploaded URL to the game page's gallery.
+ * The api-server calls behind `bitmagic trailer publish`: mint a signed PUT for the video, attach
+ * the uploaded URL to the game page's gallery — and for the trailer's 15-second editions, mint a
+ * signed PUT for each cut next to the trailer, and (for `bitmagic trailer previews`) ask for the
+ * page's previews to be remade from new cuts.
  *
  * Status mapping is this module's own, for the reason `http/signed-upload.ts` gives: `client.ts`'s
  * `request()` reads every 403 as a Bitmagic Pro refusal, and on these routes a 403 is more often
@@ -15,6 +17,8 @@ import { isJsonObject } from '../project/world-json.js';
 import { apiServerHeaders } from '../telemetry/request-headers.js';
 export const TRAILER_UPLOAD_URL_PATH = '/api/cli/v1/trailer/upload-url';
 export const TRAILER_ATTACH_PATH = '/api/cli/v1/trailer/attach';
+export const TRAILER_PREVIEW_UPLOAD_URL_PATH = '/api/cli/v1/trailer/preview-upload-url';
+export const TRAILER_PREVIEWS_PATH = '/api/cli/v1/trailer/previews';
 /** The gallery cap api-server enforces (`MAX_MEDIA_ITEMS` in game-page-edit-rules.ts). */
 export const MAX_GALLERY_ITEMS = 12;
 async function readJsonBody(response) {
@@ -130,4 +134,52 @@ export async function attachTrailer(environment, accessToken, body, deps, hints
         published: parsed.published === true,
     };
 }
+/**
+ * Ask api-server for a signed PUT for one of the trailer's 15-second cuts. A 404 that is not "Game
+ * not found" is an api-server from before cuts existed: `unsupported`, which the publish treats as
+ * "the page loops the trailer's first 15 seconds", not as a failed publish.
+ */
+export async function mintPreviewCutUploadUrl(environment, accessToken, body, deps) {
+    const response = await callApi(environment, TRAILER_PREVIEW_UPLOAD_URL_PATH, 'POST', accessToken, body, deps);
+    if (response.status === 404) {
+        const parsed = await readJsonBody(response.clone());
+        if (parsed.error !== 'Game not found') {
+            throw new CliError(`api-server in the "${environment.name}" environment does not take preview cuts yet.`, 1, 'unsupported');
+        }
+    }
+    if (!response.ok) {
+        throw await refusal(response, environment, TRAILER_PREVIEW_UPLOAD_URL_PATH, body.gameId, `the ${body.cut} preview upload`);
+    }
+    const parsed = await readJsonBody(response);
+    if (typeof parsed.uploadUrl !== 'string' || typeof parsed.publicUrl !== 'string') {
+        throw new CliError('api-server minted a preview upload URL this CLI cannot read — is it newer than this CLI?');
+    }
+    return {
+        uploadUrl: parsed.uploadUrl,
+        publicUrl: parsed.publicUrl,
+        path: typeof parsed.path === 'string' ? parsed.path : '',
+        contentType: typeof parsed.contentType === 'string' ? parsed.contentType : body.contentType,
+    };
+}
+/** New cuts of a trailer already on the page: have api-server remake its previews from them. */
+export async function remakePreviews(environment, accessToken, body, deps) {
+    const response = await callApi(environment, TRAILER_PREVIEWS_PATH, 'PUT', accessToken, body, deps);
+    if (response.status === 409) {
+        throw new CliError('The trailer this project last published is no longer on the game page. Publish one with '
+            + '`bitmagic trailer publish`, which uploads its 15-second edition with it.', 1, 'not_on_page');
+    }
+    if (!response.ok) {
+        throw await refusal(response, environment, TRAILER_PREVIEWS_PATH, body.gameId, 'remaking the previews');
+    }
+    const parsed = await readJsonBody(response);
+    if (typeof parsed.pageUrl !== 'string') {
+        throw new CliError('api-server queued the previews but answered in a shape this CLI cannot read — is it newer than this CLI?');
+    }
+    return {
+        hero: parsed.hero === true,
+        pageUrl: parsed.pageUrl,
+        isPublic: parsed.isPublic === true,
+        published: parsed.published === true,
+    };
+}
 //# sourceMappingURL=client.js.map

package/dist/trailer/client.js.map

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

package/dist/trailer/publish-record.d.ts

@@ -11,6 +11,11 @@ export interface TrailerRecord {
     attached: boolean;
     /** The game page, when it was attached. */
     pageUrl?: string;
+    /** The 15-second editions uploaded next to it (`wide` 16:9, `tall` 9:16), by CDN URL. */
+    previews?: {
+        wide?: string;
+        tall?: string;
+    };
 }
 export declare function writeTrailerRecord(root: string, record: TrailerRecord): void;
 /** The last published trailer, or null when there has not been one this reader can trust. */

package/dist/trailer/publish-record.js

@@ -54,6 +54,17 @@ export function readTrailerRecord(root) {
         at: record.at,
         attached: record.attached,
         ...(typeof record.pageUrl === 'string' ? { pageUrl: record.pageUrl } : {}),
+        ...readPreviews(record.previews),
     };
 }
+function readPreviews(value) {
+    if (typeof value !== 'object' || value === null)
+        return {};
+    const raw = value;
+    const previews = {
+        ...(typeof raw.wide === 'string' ? { wide: raw.wide } : {}),
+        ...(typeof raw.tall === 'string' ? { tall: raw.tall } : {}),
+    };
+    return Object.keys(previews).length > 0 ? { previews } : {};
+}
 //# sourceMappingURL=publish-record.js.map

package/dist/trailer/publish-record.js.map

@@ -1 +1 @@
-{"version":3,"file":"publish-record.js","sourceRoot":"","sources":["../../src/trailer/publish-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;AAEhF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;AAC9C,CAAC;AAgBD,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,MAAqB;IACpE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,EAAE,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACpF,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,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,GAAG,KAAK,QAAQ;WAC9B,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;WACtC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;WAChC,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;WAC7B,OAAO,MAAM,CAAC,QAAQ,KAAK,SAAS,EACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"publish-record.js","sourceRoot":"","sources":["../../src/trailer/publish-record.ts"],"names":[],"mappings":"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"}

package/dist/trailer/publish.d.ts

@@ -1,6 +1,11 @@
 import type { Output } from '../output.js';
+import { type PreviewCut } from './client.js';
 /** api-server's gallery video cap (`POST_MEDIA_VIDEO_MAX_BYTES`), checked here before any request. */
 export declare const MAX_TRAILER_BYTES: number;
+/** api-server's cap on a 15-second edition (`PREVIEW_CUT_MAX_BYTES`), checked here before any request. */
+export declare const MAX_PREVIEW_CUT_BYTES: number;
+/** The edition `make` renders beside a trailer: `<game>-trailer-r3.mp4` → `<game>-trailer-r3-preview.mp4`. */
+export declare function renderedPreviewFor(trailerFile: string): string;
 export interface TrailerPublishDeps {
     fetch: typeof globalThis.fetch;
     sleep: (ms: number) => Promise<void>;
@@ -16,6 +21,14 @@ export interface TrailerPublishOptions {
     file: string;
     /** Add it to the game page gallery after the upload. */
     attach: boolean;
+    /**
+     * The 15-second editions to upload with it: `wide` (16:9) and `tall` (9:16), file paths. Without
+     * `wide`, the edition `make` rendered beside the trailer goes when it is there. `false`: none.
+     */
+    previews?: {
+        wide?: string;
+        tall?: string;
+    } | false;
     output: Output;
     deps?: TrailerPublishDeps;
 }
@@ -29,6 +42,11 @@ export interface TrailerPublishResult {
     isPublic?: boolean;
     /** The previous trailer this one replaced in the gallery, when there was one. */
     replacedUrl?: string;
+    /** The 15-second editions uploaded with it, by CDN URL. */
+    previews?: {
+        wide?: string;
+        tall?: string;
+    };
 }
 /**
  * Does the file start the way its extension promises? An MP4 (and every ISO-BMFF sibling: .m4v,
@@ -42,4 +60,34 @@ export declare function readTrailerFile(file: string): {
     contentType: string;
     resolved: string;
 };
+/** A 15-second edition's bytes, or the refusal: an MP4 under the cut cap. Nothing here touches the network. */
+export declare function readPreviewCutFile(file: string, cut: PreviewCut): {
+    bytes: Uint8Array;
+    resolved: string;
+};
 export declare function runTrailerPublish(options: TrailerPublishOptions): Promise<TrailerPublishResult>;
+export interface TrailerPreviewsOptions {
+    root: string;
+    /** A 16:9 15-second edition (.mp4). */
+    wide?: string;
+    /** A 9:16 15-second edition (.mp4). */
+    tall?: string;
+    output: Output;
+    deps?: TrailerPublishDeps;
+}
+export interface TrailerPreviewsResult {
+    /** The trailer the editions belong to: the one this project last put on the page. */
+    trailerUrl: string;
+    previews: {
+        wide?: string;
+        tall?: string;
+    };
+    /** Whether that trailer is the page's first video, the one whose previews pages play. */
+    hero: boolean;
+    pageUrl: string;
+}
+/**
+ * `bitmagic trailer previews`: new 15-second editions for the trailer already on the page. Uploads
+ * them next to it and has api-server remake the page's previews from them.
+ */
+export declare function runTrailerPreviews(options: TrailerPreviewsOptions): Promise<TrailerPreviewsResult>;

package/dist/trailer/publish.js

@@ -11,8 +11,16 @@
  * upload is accepted and the item is stored; the page simply is not live yet, and the command says
  * so rather than printing a URL that 404s without explanation.
  *
+ * The trailer's 15-second editions go with it (docs/game-media-previews.md in the Bitmagic repo):
+ * a game page loops a 15-second silent preview, 16:9 on a desktop and 9:16 on a phone, and the
+ * server cuts it from the edition uploaded next to the trailer, else from the trailer's first 15
+ * seconds. `make` renders the 16:9 edition beside the trailer as `<trailer>-preview.mp4`, and that
+ * file goes up with the trailer unless another (or none) is named. A cut that cannot be uploaded
+ * is a warning, not a failed publish: the page then loops the trailer's first 15 seconds.
+ *
  * Exposed as a function (not only a command) so `bitmagic trailer make --publish` can hand the
- * fresh render straight to it.
+ * fresh render straight to it. `runTrailerPreviews` is `bitmagic trailer previews`: new editions
+ * for the trailer already on the page.
  */
 import * as fs from 'fs';
 import * as path from 'path';
@@ -22,10 +30,16 @@ import { resolveEnvironmentForCommand, resolveAuth0ClientId } from '../config/en
 import { getAccessToken } from '../auth/session.js';
 import { putSignedUrl } from '../http/signed-upload.js';
 import { readPublishRecord } from '../publish/record.js';
-import { attachTrailer, mintTrailerUploadUrl } from './client.js';
+import { attachTrailer, mintPreviewCutUploadUrl, mintTrailerUploadUrl, remakePreviews, } from './client.js';
 import { readTrailerRecord, writeTrailerRecord } from './publish-record.js';
 /** api-server's gallery video cap (`POST_MEDIA_VIDEO_MAX_BYTES`), checked here before any request. */
 export const MAX_TRAILER_BYTES = 200 * 1024 * 1024;
+/** api-server's cap on a 15-second edition (`PREVIEW_CUT_MAX_BYTES`), checked here before any request. */
+export const MAX_PREVIEW_CUT_BYTES = 100 * 1024 * 1024;
+/** The edition `make` renders beside a trailer: `<game>-trailer-r3.mp4` → `<game>-trailer-r3-preview.mp4`. */
+export function renderedPreviewFor(trailerFile) {
+    return trailerFile.replace(/(\.[^./\\]+)?$/, '-preview.mp4');
+}
 const CONTENT_TYPES = {
     '.mp4': 'video/mp4',
     '.webm': 'video/webm',
@@ -87,11 +101,44 @@ export function readTrailerFile(file) {
     }
     return { bytes, contentType, resolved };
 }
+/** A 15-second edition's bytes, or the refusal: an MP4 under the cut cap. Nothing here touches the network. */
+export function readPreviewCutFile(file, cut) {
+    const what = cut === 'wide' ? 'The 16:9 preview' : 'The 9:16 preview';
+    if (path.extname(file).toLowerCase() !== '.mp4') {
+        throw new CliError(`${what} must be an .mp4 (got ${file}). \`bitmagic trailer make\` renders one beside the trailer.`);
+    }
+    const { bytes, resolved } = readTrailerFile(file);
+    if (bytes.byteLength > MAX_PREVIEW_CUT_BYTES) {
+        const mib = (bytes.byteLength / (1024 * 1024)).toFixed(1);
+        throw new CliError(`${what} ${resolved} is ${mib} MiB; a 15-second edition may be at most ${MAX_PREVIEW_CUT_BYTES / (1024 * 1024)} MiB.`);
+    }
+    return { bytes, resolved };
+}
+/** The editions to upload: what was named, else the render's own `<trailer>-preview.mp4`. */
+function resolvePreviewFiles(trailerFile, previews) {
+    if (previews === false)
+        return {};
+    const files = {};
+    const wide = previews?.wide ?? renderedPreviewFor(path.resolve(trailerFile));
+    if (previews?.wide !== undefined || fs.existsSync(wide))
+        files.wide = readPreviewCutFile(wide, 'wide');
+    if (previews?.tall !== undefined)
+        files.tall = readPreviewCutFile(previews.tall, 'tall');
+    return files;
+}
+/** Mint and PUT one edition next to the trailer; its CDN URL. */
+async function uploadPreviewCut(context, cut, file) {
+    const ticket = await mintPreviewCutUploadUrl(context.environment, context.accessToken, { gameId: context.gameId, url: context.trailerUrl, cut, contentType: 'video/mp4', bytes: file.bytes.byteLength }, context.deps);
+    await putSignedUrl(ticket.uploadUrl, file.bytes, { 'Content-Type': ticket.contentType }, context.deps);
+    context.output.info(`${cut === 'wide' ? '16:9' : '9:16'} preview uploaded: ${ticket.publicUrl}`);
+    return ticket.publicUrl;
+}
 export async function runTrailerPublish(options) {
     const { root, output } = options;
     const deps = options.deps ?? defaultDeps();
     // Every local refusal first, before a token is read or a request made.
     const { bytes, contentType, resolved } = readTrailerFile(options.file);
+    const previewFiles = resolvePreviewFiles(options.file, options.previews);
     const context = loadProjectContext(root);
     const gameId = context.metadata.gameId;
     const environment = resolveEnvironmentForCommand({ cwd: root, baseDir: deps.baseDir });
@@ -102,6 +149,28 @@ export async function runTrailerPublish(options) {
     // only the content type (storage/game-media.ts), and an extra signed-looking header is a GCS 403.
     await putSignedUrl(ticket.uploadUrl, bytes, { 'Content-Type': ticket.contentType }, deps);
     output.info(`Trailer uploaded: ${ticket.publicUrl}`);
+    // The editions go up before the attach, so the preview job the attach queues finds them. A cut
+    // that fails is a warning: the trailer still goes on the page, and the page loops its first
+    // 15 seconds until `bitmagic trailer previews` uploads the cut.
+    const previews = {};
+    const cutContext = { environment, accessToken, gameId, trailerUrl: ticket.publicUrl, deps, output };
+    for (const cut of ['wide', 'tall']) {
+        const file = previewFiles[cut];
+        if (file === undefined)
+            continue;
+        try {
+            previews[cut] = await uploadPreviewCut(cutContext, cut, file);
+        }
+        catch (error) {
+            if (!(error instanceof CliError))
+                throw error;
+            output.info(`Warning: the ${cut === 'wide' ? '16:9' : '9:16'} preview was not uploaded (${error.message}) — the page loops the `
+                + "trailer's first 15 seconds until `bitmagic trailer previews` uploads it.");
+            if (error.code === 'unsupported')
+                break;
+        }
+    }
+    const previewsPart = Object.keys(previews).length > 0 ? { previews } : {};
     const now = deps.now ?? Date.now;
     const previous = readTrailerRecord(root);
     if (!options.attach) {
@@ -112,9 +181,10 @@ export async function runTrailerPublish(options) {
             bytes: bytes.byteLength,
             at: new Date(now()).toISOString(),
             attached: false,
+            ...previewsPart,
         });
         output.info('Not attached (--no-attach).');
-        return { publicUrl: ticket.publicUrl, bytes: bytes.byteLength, contentType, attached: false };
+        return { publicUrl: ticket.publicUrl, bytes: bytes.byteLength, contentType, attached: false, ...previewsPart };
     }
     // The previous trailer — for THIS game, and only one that was actually put on the page — is what
     // the new one replaces. An upload-only record is not in the gallery, so there is nothing to swap.
@@ -130,6 +200,7 @@ export async function runTrailerPublish(options) {
         at: new Date(now()).toISOString(),
         attached: true,
         pageUrl: attached.pageUrl,
+        ...previewsPart,
     });
     output.info(`Attached to the game page: ${attached.pageUrl}`);
     if (!attached.published || !attached.isPublic) {
@@ -144,6 +215,48 @@ export async function runTrailerPublish(options) {
         published: attached.published,
         isPublic: attached.isPublic,
         ...(replaceUrl !== undefined ? { replacedUrl: replaceUrl } : {}),
+        ...previewsPart,
     };
 }
+/**
+ * `bitmagic trailer previews`: new 15-second editions for the trailer already on the page. Uploads
+ * them next to it and has api-server remake the page's previews from them.
+ */
+export async function runTrailerPreviews(options) {
+    const { root, output } = options;
+    const deps = options.deps ?? defaultDeps();
+    const files = {};
+    if (options.wide !== undefined)
+        files.wide = readPreviewCutFile(options.wide, 'wide');
+    if (options.tall !== undefined)
+        files.tall = readPreviewCutFile(options.tall, 'tall');
+    if (files.wide === undefined && files.tall === undefined) {
+        throw new CliError('Name an edition to upload: --wide <16:9 .mp4> and/or --tall <9:16 .mp4>.');
+    }
+    const context = loadProjectContext(root);
+    const gameId = context.metadata.gameId;
+    const record = readTrailerRecord(root);
+    if (record === null || record.gameId !== gameId || !record.attached) {
+        throw new CliError('This project has not put a trailer on its game page yet. Publish one with `bitmagic trailer publish` '
+            + '(it uploads the 15-second edition `make` rendered beside it).');
+    }
+    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 cutContext = { environment, accessToken, gameId, trailerUrl: record.url, deps, output };
+    const previews = { ...record.previews };
+    for (const cut of ['wide', 'tall']) {
+        const file = files[cut];
+        if (file !== undefined)
+            previews[cut] = await uploadPreviewCut(cutContext, cut, file);
+    }
+    const remade = await remakePreviews(environment, accessToken, { gameId, url: record.url }, deps);
+    writeTrailerRecord(root, { ...record, previews });
+    output.info('The page\'s previews are being remade from your editions; they show within a few minutes.');
+    output.info('A browser that already played the old ones can keep them for up to a day.');
+    if (!remade.hero) {
+        output.info('Note: that trailer is not the first video in the game page gallery, so the page loops the first video\'s '
+            + 'preview instead. Move the trailer to the front on the My games page.');
+    }
+    return { trailerUrl: record.url, previews, hero: remade.hero, pageUrl: remade.pageUrl };
+}
 //# sourceMappingURL=publish.js.map