@bitmagic/cli 0.1.74 → 0.1.75

package/README.md

@@ -215,6 +215,11 @@ browser reloads itself on every change and the assets panel shows each generatio
 | `bitmagic trailer make [--music-prompt "..." \| --music <file> \| --no-music] [--title <t>] [--seconds 30] [--ui] [--ui-keyframe-rate 30] [--publish] [--reset-shots]` | The one-shot: analyze the newest recording, lay a music bed (generated from a prompt — sparks — or your file), write a first cut to `trailer/shots.json` or cut the one you edited, render `<game>-trailer.mp4` (new `-rN` each run), and with `--publish` put it on the CDN and the game page. |
 | `bitmagic trailer analyze \| beats \| cut \| render \| merge` | The steps of `make` as separate commands: score a recording into highlight windows with contact sheets; detect a track's beat grid; turn `trailer/shots.json` into a frame-exact `edl.json`; render an EDL (`--ui` redraws the HUD, `--ui-keyframe-rate` caps how often it may change, `--logo`, `--music …`); join recordings from separate sittings. |
 | `bitmagic trailer publish <file.mp4> [--no-attach]` | Upload a trailer (`.mp4`/`.webm`, ≤ 200 MiB, header-checked so a renamed image is refused before upload) to the CDN under `game-media/<gameId>/` and put it at the front of the game page gallery. Re-running replaces the previous trailer (remembered in `.bitmagic/trailer/published.json`); the page is capped at 12 media items. Works before the first publish — the page goes live on the first `bitmagic publish --visibility public`. `--no-attach` uploads only. |
+| `bitmagic ads render [--video <file>] [--portrait <file>] [--image <file>] [--seconds 15] [--start <s>] [--cta "..."] [--no-end-card]` | Cut the media of an ad package from the newest `bitmagic trailer` render (its own end card trimmed off) into `.bitmagic/ads/`: videos at 16:9, 9:16 and 1:1 with an end card naming the game, and stills at 1.91:1, 1:1 and 4:5 from the cover. A source of another shape is blur-filled, never cropped into the HUD; `--portrait` takes a 9:16 trailer for the 9:16 ad. Starts an empty `ads.json` for the copy. Free; needs ffmpeg and Chrome. See **Building ads** below. |
+| `bitmagic ads check` | Check the package in `.bitmagic/ads/` — copy, sizes, lengths, file types — against the rules api-server uploads it under (Google Ads' limits plus its style rules). Exits 1 naming every problem. |
+| `bitmagic ads publish` | Upload the package to Bitmagic under `game-media/<gameId>/` and register it. **Nothing is advertised.** Files unchanged since the last publish are not uploaded again (`.bitmagic/ads/published.json`). Prints the page where a promotion can be bought. |
+| `bitmagic ads buy [--no-open] [--wait]` | Open that page, where the creator chooses a budget, a run length and an audience, sees an estimate and pays with Stripe; the Bitmagic team then runs the campaign, usually within a day. Refuses when there is no uploaded package or the game is not public. `--wait` waits for the payment. |
+| `bitmagic ads status` | The uploaded package and every promotion bought for this game: its state, and how many people the ads brought to the game's page and how many started playing. |
 | `bitmagic forge --prompt "..." [--city\|--dungeon\|--platformer\|--freeform] [--name <name>] [--resume <jobId>]` | Design and bake a whole playable level into `world.json`. Costs sparks, and takes many minutes — the bake alone can take twenty. `--resume <jobId>` picks a failed run back up from the last step that finished, rather than redoing the whole thing. |
 | `bitmagic forge --edit "..." [--level <id or name>]` | Change a detail of a level this project forged — a door style, the light fixtures, a prop — without re-forging it. The stored design is patched and only what the change touches is re-made; the level is replaced in place. See [Editing a forged level](#editing-a-forged-level). |
 | `bitmagic tools <list\|path\|install> [bundle]` | The script bundles the CLI ships for skills that drive Blender, Python or Node (`blender-level`, `unity-import`, `metahuman`): what they are, where this install keeps them, and `install` to copy one into the project's `tools/`. Local, no network, no sparks. |
@@ -656,6 +661,27 @@ records a fly-through with nobody at the keyboard.
 
 Needs `ffmpeg` and Google Chrome on this machine; each command says so if one is missing.
 
+## Building ads
+
+`bitmagic ads` builds everything an ad campaign for the game needs, uploads it, and — only when the
+creator wants to pay for one — opens the page where they buy a promotion that the Bitmagic team runs
+on Google Ads, sending players to the game's page. Ask your agent to "build ads"; the shipped
+`building-ads` skill walks it through:
+
+```bash
+bitmagic ads render          # videos and stills from the newest trailer, into .bitmagic/ads/
+# write the headlines and descriptions into .bitmagic/ads/ads.json
+bitmagic ads check           # the rules the upload is checked against
+bitmagic ads publish         # upload; nothing is advertised
+bitmagic ads buy             # opens the page to choose a budget and pay
+bitmagic ads status          # visitors and plays per promotion
+```
+
+Everything lives in `.bitmagic/ads/`, outside the publish fingerprint, so building ads never
+invalidates a passing verify. The game must be public before a promotion can be bought, since an ad
+links to its page. Budgets, run lengths, audiences and the estimates are shown on the page, and
+the visitor estimate is an estimate, not a guarantee.
+
 ## The dev view
 
 `bitmagic dev` is meant to be started once and left running, beside your agent:

package/assets/skills/building-ads/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: building-ads
+description: Build an ad package for this game with bitmagic ads — videos in 16:9, 9:16 and 1:1, three stills, and the headlines and descriptions — upload it to Bitmagic, and, only if the creator wants to pay, open the page where they buy a promotion that the Bitmagic team runs on Google Ads. Use when asked to build ads, make an ad, advertise or promote the game, run a campaign, or get players.
+---
+
+# Building ads
+
+`bitmagic ads` turns the game's trailer into everything an ad campaign needs, and uploads it to
+Bitmagic. Building and uploading costs nothing and advertises nothing. Running the ads is a
+separate choice the creator makes and pays for on a web page; the Bitmagic team then runs the
+campaign on Google Ads and sends the players to the game's page.
+
+## The flow
+
+0. **Check that promotion is open:** `bitmagic ads status`. If it answers that game promotion is
+   not available yet, stop and tell the creator so; there is nothing to build for yet.
+1. **The game has to be public before anyone can pay to advertise it**: an ad sends people to its
+   page. You can build and upload the package first, but say so if `bitmagic publish
+   --visibility public` has not happened yet. Never change the game's visibility without the
+   creator's yes.
+2. **You need a trailer.** `bitmagic ads render` cuts the ads from the newest `bitmagic trailer`
+   render. With no trailer, make one first: the `making-a-trailer/` skill beside this one. A
+   trailer recorded in portrait (`bitmagic trailer record --resolution 1080x1920`, then
+   `bitmagic trailer make`) makes the best 9:16 ad, which is what phone feeds show. Pass it as
+   `--portrait <file>`.
+3. **Render the media:**
+
+   ```
+   bitmagic ads render                       # 15 s from the start of the newest trailer
+   bitmagic ads render --start 8 --seconds 20
+   bitmagic ads render --portrait .bitmagic/trailer/<dir>/<portrait-trailer>.mp4
+   ```
+
+   This writes `.bitmagic/ads/`: `video-16x9.mp4`, `video-9x16.mp4`, `video-1x1.mp4` (6 to 60 s, an
+   end card with the game's name and "Play now in your browser" fades in at the end), and
+   `image-1.91x1.jpg`, `image-1x1.jpg`, `image-4x5.jpg` (from the cover, `.bitmagic/cover.webp`,
+   when there is one). A source of another shape is fitted by blurring a copy of it behind it, so
+   nothing is cut off. The first ad seconds are the ones that matter: if the trailer opens slowly,
+   use `--start` to begin at the action.
+4. **Look at what you made.** Read the stills. For the videos, take a few frames and look at them
+   too, the end card included:
+
+   ```
+   ffmpeg -v error -ss 3 -i .bitmagic/ads/video-9x16.mp4 -frames:v 1 -vf scale=360:-2 /tmp/ad-frame.png
+   ```
+
+   Re-render rather than ship an ad that opens on a menu, a loading screen or a black frame.
+5. **Write the copy** in `.bitmagic/ads/ads.json` (`render` starts an empty one):
+
+   ```json
+   {
+     "headlines": ["Ride the storm swell", "Jet-ski racing on big waves"],
+     "longHeadlines": ["Launch off storm waves and race rivals to the lighthouse"],
+     "descriptions": ["Carve down each swell for speed, then launch off the crest."]
+   }
+   ```
+
+   Write it from `GAME-DESIGN.md` and from what the game really does. The rules are below.
+6. **Check it:** `bitmagic ads check` names every problem the server would refuse. Fix them and run
+   it again until it passes.
+7. **Upload it:** `bitmagic ads publish`. Nothing is advertised. It prints the page where a
+   promotion can be bought. Re-running it after a change uploads only what changed.
+8. **Ask the creator** whether they want to pay to advertise the game. Tell them what that means:
+   they choose a budget (from $10), how many days it runs and who sees it; the page shows an
+   estimate of how many people it may bring, which is an estimate, not a promise; the Bitmagic team
+   starts the campaign as soon as possible, usually within a day. Show them the stills first.
+9. **Only if they say yes:** `bitmagic ads buy`. It opens that page in their browser, where they
+   choose and pay. You never choose a budget for them, and you never pay. `--wait` waits for the
+   payment and reports it.
+10. **Afterwards:** `bitmagic ads status` shows every promotion, its state, and how many people
+    the ads brought to the game's page and how many of them started playing.
+
+## The copy rules
+
+`bitmagic ads check` enforces the hard limits. Google refuses ads for the rest, so follow them too.
+
+| Field | How many | Longest |
+|---|---|---|
+| `headlines` | 1 to 5 (write at least 3) | 40 characters |
+| `longHeadlines` | 1 to 5 | 90 characters |
+| `descriptions` | 1 to 5 (write at least 2) | 90 characters |
+
+- **Every line must be true of this game.** Name what the player does, not what you wish it did. No
+  "best", "#1" or "most popular" claims, which Google requires proof of.
+- **No other game or brand names.** Not "like Fortnite", not "Minecraft-style".
+- **No emoji, no "!!", no exclamation mark in a headline, no words in capitals** (RPG and 3D are
+  fine; GREAT is not). No URLs or prices: Google shows the link itself.
+- **Each line must stand on its own.** Google mixes headlines and descriptions in any order, so
+  none of them can lean on another.
+- Say "free" only when anyone can play the game without paying, which is true of a public
+  bitmagic.ai game unless the creator gated it.
+
+## What not to do
+
+- Do not run `bitmagic ads buy` because the package is ready. It is the creator's money: ask, and
+  run it only on a clear yes.
+- Do not promise a number of players. Point to the estimate on the page and say it is an estimate.
+- Do not edit `.bitmagic/ads/published.json`; it is how `publish` knows what is already uploaded.

package/dist/ads/check.d.ts

@@ -0,0 +1,31 @@
+import { type AdCopy, type AdImageSlot, type AdPackageManifest, type AdVideoSlot } from '@bitmagic/asset-core/ad-package';
+import { type MediaProbe } from './probe.js';
+export type AdFileKind = 'mp4' | 'jpeg' | 'png';
+/** What a file's first bytes say it is, or null. */
+export declare function sniffAdFile(bytes: Uint8Array): AdFileKind | null;
+export declare const CONTENT_TYPES: Record<AdFileKind, string>;
+export interface CheckedFile {
+    /** The name inside `.bitmagic/ads/`, e.g. `video-9x16.mp4`. */
+    name: string;
+    path: string;
+    kind: AdFileKind;
+    width: number;
+    height: number;
+    durationSec: number;
+    bytes: number;
+}
+export interface AdPackageCheck {
+    ok: boolean;
+    problems: string[];
+    gameName: string;
+    copy: AdCopy | null;
+    videos: Partial<Record<AdVideoSlot, CheckedFile>>;
+    images: Partial<Record<AdImageSlot, CheckedFile>>;
+}
+export interface CheckDeps {
+    probe: (file: string) => Promise<MediaProbe>;
+}
+/** The manifest api-server would receive, with `urlFor` deciding each asset's URL. */
+export declare function manifestFrom(gameName: string, copy: AdCopy, videos: Record<AdVideoSlot, CheckedFile>, images: Record<AdImageSlot, CheckedFile>, urlFor: (file: CheckedFile) => string): AdPackageManifest;
+export declare function isComplete<K extends string>(slots: readonly K[], files: Partial<Record<K, CheckedFile>>): files is Record<K, CheckedFile>;
+export declare function checkAdPackage(root: string, deps?: CheckDeps): Promise<AdPackageCheck>;

package/dist/ads/check.js

@@ -0,0 +1,142 @@
+/**
+ * `bitmagic ads check` — is the package in `.bitmagic/ads/` one api-server will accept?
+ *
+ * The answer comes from the same function api-server runs on an upload (`adManifestProblems` in
+ * `@bitmagic/asset-core/ad-package`), fed a manifest built from what is actually on disk: the copy
+ * as written, and every file's size and length as ffprobe reads them. So a package that passes here
+ * is refused upstream only for something that changed on the way, and the words of any refusal are
+ * the same in both places. Files are also sniffed by their first bytes, so a renamed PNG never
+ * reaches the bucket as a JPEG.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { AD_IMAGE_SLOT_NAMES, AD_PACKAGE_VERSION, AD_VIDEO_SLOT_NAMES, adCopyProblems, adManifestProblems, normalizeAdCopy, } from '@bitmagic/asset-core/ad-package';
+import { gameNameFor } from '../trailer/game-name.js';
+import { adCopyPath, adImagePath, adVideoPath } from './paths.js';
+import { probeMedia } from './probe.js';
+/** Stands in for the CDN while checking locally: every asset "lives" under it. */
+const LOCAL_PREFIX = 'local:';
+/** What a file's first bytes say it is, or null. */
+export function sniffAdFile(bytes) {
+    if (bytes.length >= 8 && bytes[4] === 0x66 && bytes[5] === 0x74 && bytes[6] === 0x79 && bytes[7] === 0x70)
+        return 'mp4';
+    if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff)
+        return 'jpeg';
+    if (bytes.length >= 8 && bytes[0] === 0x89 && bytes[1] === 0x50 && bytes[2] === 0x4e && bytes[3] === 0x47)
+        return 'png';
+    return null;
+}
+export const CONTENT_TYPES = {
+    mp4: 'video/mp4',
+    jpeg: 'image/jpeg',
+    png: 'image/png',
+};
+const defaultDeps = { probe: probeMedia };
+/** The parsed copy file, as written (checked later), or null when there is nothing to check. */
+function readCopy(root, problems) {
+    const file = adCopyPath(root);
+    let raw;
+    try {
+        raw = fs.readFileSync(file, 'utf-8');
+    }
+    catch {
+        problems.push(`There is no copy yet: write ${path.relative(root, file)} (\`bitmagic ads render\` starts an empty one).`);
+        return null;
+    }
+    try {
+        return { parsed: JSON.parse(raw) };
+    }
+    catch (error) {
+        problems.push(`${path.relative(root, file)} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+}
+async function checkFile(file, expected, problems, deps) {
+    const name = path.basename(file);
+    if (!fs.existsSync(file)) {
+        problems.push(`${name} is missing — run \`bitmagic ads render\`.`);
+        return null;
+    }
+    const bytes = fs.statSync(file).size;
+    const head = new Uint8Array(16);
+    const fd = fs.openSync(file, 'r');
+    try {
+        fs.readSync(fd, head, 0, head.length, 0);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    const kind = sniffAdFile(head);
+    if (kind === null || !expected.includes(kind)) {
+        problems.push(`${name} is not ${expected.length === 1 ? `an ${expected[0].toUpperCase()}` : 'a JPEG or a PNG'} file.`);
+        return null;
+    }
+    let probe;
+    try {
+        probe = await deps.probe(file);
+    }
+    catch (error) {
+        problems.push(`${name} cannot be read: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+    return { name, path: file, kind, width: probe.width, height: probe.height, durationSec: probe.durationSec, bytes };
+}
+/** The manifest api-server would receive, with `urlFor` deciding each asset's URL. */
+export function manifestFrom(gameName, copy, videos, images, urlFor) {
+    const video = (file) => ({
+        url: urlFor(file),
+        width: file.width,
+        height: file.height,
+        // ffprobe reports container length to the microsecond; the spec only needs tenths.
+        durationSec: Math.round(file.durationSec * 10) / 10,
+        bytes: file.bytes,
+    });
+    const image = (file) => ({ url: urlFor(file), width: file.width, height: file.height, bytes: file.bytes });
+    return {
+        version: AD_PACKAGE_VERSION,
+        gameName,
+        copy,
+        videos: { landscape: video(videos.landscape), portrait: video(videos.portrait), square: video(videos.square) },
+        images: { landscape: image(images.landscape), square: image(images.square), portrait: image(images.portrait) },
+    };
+}
+/** A placeholder the checking manifest's copy is swapped out of. */
+const NO_COPY = { headlines: [], longHeadlines: [], descriptions: [] };
+export function isComplete(slots, files) {
+    return slots.every((slot) => files[slot] !== undefined);
+}
+export async function checkAdPackage(root, deps = defaultDeps) {
+    const problems = [];
+    const gameName = gameNameFor(root).slice(0, 80);
+    const written = readCopy(root, problems);
+    const videos = {};
+    for (const slot of AD_VIDEO_SLOT_NAMES) {
+        const checked = await checkFile(adVideoPath(root, slot), ['mp4'], problems, deps);
+        if (checked)
+            videos[slot] = checked;
+    }
+    const images = {};
+    for (const slot of AD_IMAGE_SLOT_NAMES) {
+        const checked = await checkFile(adImagePath(root, slot), ['jpeg', 'png'], problems, deps);
+        if (checked)
+            images[slot] = checked;
+    }
+    if (written !== null) {
+        if (isComplete(AD_VIDEO_SLOT_NAMES, videos) && isComplete(AD_IMAGE_SLOT_NAMES, images)) {
+            // The whole manifest api-server would get — with the copy exactly as written, so a malformed
+            // file is described in the server's words rather than this one's.
+            const manifest = {
+                ...manifestFrom(gameName, NO_COPY, videos, images, (file) => `${LOCAL_PREFIX}${file.name}`),
+                copy: written.parsed,
+            };
+            problems.push(...adManifestProblems(manifest, LOCAL_PREFIX));
+        }
+        else {
+            // The missing files are reported already; the copy can still be checked on its own.
+            problems.push(...adCopyProblems(written.parsed));
+        }
+    }
+    const copy = written !== null ? normalizeAdCopy(written.parsed) : null;
+    return { ok: problems.length === 0, problems, gameName, copy, videos, images };
+}
+//# sourceMappingURL=check.js.map

package/dist/ads/check.js.map

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

package/dist/ads/client.d.ts

@@ -0,0 +1,78 @@
+/**
+ * The three api-server calls behind `bitmagic ads` (api-server cli/cli-ads.ts): a signed PUT for
+ * one package file, registering the uploaded package, and the game's package and orders.
+ *
+ * Status mapping is this module's own, as in trailer/client.ts: on these routes a 403 is usually
+ * "not your game", not a Bitmagic Pro refusal, and a 503 is usually the feature being switched off
+ * (`ads_unavailable`), which deserves its own sentence.
+ */
+import type { AdPackageManifest } from '@bitmagic/asset-core/ad-package';
+import type { Environment } from '../config/environments.js';
+import { type ApiDeps } from '../http/client.js';
+export declare const ADS_UPLOAD_URL_PATH = "/api/cli/v1/ads/upload-url";
+export declare const ADS_PACKAGE_PATH = "/api/cli/v1/ads/package";
+export declare const ADS_STATUS_PATH = "/api/cli/v1/ads/status";
+export interface AdUploadTicket {
+    uploadUrl: string;
+    publicUrl: string;
+    /** The exact Content-Type the PUT must carry (the signature binds it). */
+    contentType: string;
+}
+export interface RegisteredAdPackage {
+    packageId: string;
+    /** The page where the creator can choose to pay for ads. */
+    promoteUrl: string;
+    /** False until the game is published publicly: an ad sends people to its page. */
+    promotable: boolean;
+}
+export interface AdOrderMetrics {
+    visitors: number;
+    plays: number;
+    daily: Array<{
+        day: string;
+        visitors: number;
+        plays: number;
+    }>;
+}
+export interface AdOrderSummary {
+    id: string;
+    status: string;
+    tier: string;
+    days: number;
+    audience: string;
+    audienceName: string;
+    priceCents: number;
+    currency: string;
+    mediaBudgetCents: number;
+    spendCents: number | null;
+    createdAt: number;
+    paidAt: number | null;
+    startedAt: number | null;
+    endedAt: number | null;
+    metrics: AdOrderMetrics;
+}
+export interface AdStatus {
+    package: {
+        id: string;
+        createdAt: number;
+        gameName: string;
+    } | null;
+    orders: AdOrderSummary[];
+    promoteUrl: string;
+    promotable: boolean;
+}
+/** One order off the wire, every field checked: an older or newer api-server never crashes `status`. */
+export declare function parseAdOrder(raw: unknown): AdOrderSummary | null;
+/** A signed PUT under the game's `game-media/<gameId>/`, for an MP4, a JPEG or a PNG. */
+export declare function mintAdUploadUrl(environment: Environment, accessToken: string, body: {
+    gameId: string;
+    contentType: string;
+    bytes: number;
+}, deps: ApiDeps): Promise<AdUploadTicket>;
+/** Register the uploaded package. Nothing is advertised by this. */
+export declare function registerAdPackage(environment: Environment, accessToken: string, body: {
+    gameId: string;
+    manifest: AdPackageManifest;
+}, deps: ApiDeps): Promise<RegisteredAdPackage>;
+/** The game's newest package and every order past checkout, with visitors and plays. */
+export declare function fetchAdStatus(environment: Environment, accessToken: string, gameId: string, deps: ApiDeps): Promise<AdStatus>;

package/dist/ads/client.js

@@ -0,0 +1,146 @@
+import { CliError } from '../errors.js';
+import { proRefusal } from '../http/client.js';
+import { isJsonObject } from '../project/world-json.js';
+import { apiServerHeaders } from '../telemetry/request-headers.js';
+export const ADS_UPLOAD_URL_PATH = '/api/cli/v1/ads/upload-url';
+export const ADS_PACKAGE_PATH = '/api/cli/v1/ads/package';
+export const ADS_STATUS_PATH = '/api/cli/v1/ads/status';
+const str = (value, fallback = '') => (typeof value === 'string' ? value : fallback);
+const num = (value, fallback = 0) => (typeof value === 'number' && Number.isFinite(value) ? value : fallback);
+const numOrNull = (value) => (typeof value === 'number' && Number.isFinite(value) ? value : null);
+function parseMetrics(raw) {
+    if (!isJsonObject(raw))
+        return { visitors: 0, plays: 0, daily: [] };
+    const daily = Array.isArray(raw.daily)
+        ? raw.daily.filter(isJsonObject).map((d) => ({ day: str(d.day), visitors: num(d.visitors), plays: num(d.plays) }))
+        : [];
+    return { visitors: num(raw.visitors), plays: num(raw.plays), daily };
+}
+/** One order off the wire, every field checked: an older or newer api-server never crashes `status`. */
+export function parseAdOrder(raw) {
+    if (!isJsonObject(raw) || typeof raw.id !== 'string')
+        return null;
+    return {
+        id: raw.id,
+        status: str(raw.status, 'unknown'),
+        tier: str(raw.tier),
+        days: num(raw.days),
+        audience: str(raw.audience),
+        audienceName: str(raw.audienceName, str(raw.audience)),
+        priceCents: num(raw.priceCents),
+        currency: str(raw.currency, 'usd'),
+        mediaBudgetCents: num(raw.mediaBudgetCents),
+        spendCents: numOrNull(raw.spendCents),
+        createdAt: num(raw.createdAt),
+        paidAt: numOrNull(raw.paidAt),
+        startedAt: numOrNull(raw.startedAt),
+        endedAt: numOrNull(raw.endedAt),
+        metrics: parseMetrics(raw.metrics),
+    };
+}
+async function readJsonBody(response) {
+    try {
+        const parsed = await response.json();
+        return isJsonObject(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+async function callApi(environment, path, method, accessToken, body, deps) {
+    try {
+        return await deps.fetch(`${environment.apiUrl}${path}`, {
+            method,
+            headers: {
+                ...apiServerHeaders(),
+                Authorization: `Bearer ${accessToken}`,
+                Accept: 'application/json',
+                ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+            },
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+    }
+    catch {
+        throw new CliError(`Cannot reach api-server at ${environment.apiUrl}.`, 1, 'unreachable');
+    }
+}
+async function refusal(response, environment, path, gameId, what) {
+    if (response.status === 401) {
+        return new CliError('Your session has expired. Run `bitmagic login`.', 1, 'session_expired');
+    }
+    const clone = response.clone();
+    const parsed = await readJsonBody(response);
+    if (response.status === 403) {
+        if (parsed.code === 'pro_expired' || parsed.code === 'pro_required') {
+            const pro = await proRefusal(clone);
+            return new CliError(pro.message, 1, pro.code);
+        }
+        if (parsed.error === 'Game is banned') {
+            return new CliError(`Game "${gameId}" is banned, so it cannot be advertised.`, 1, 'banned');
+        }
+        return new CliError(`You do not own game "${gameId}", so ${what} is not allowed. Check the gameId in bitmagic.json.`, 1, 'not_owner');
+    }
+    if (response.status === 404) {
+        return new CliError(`Game "${gameId}" does not exist in the "${environment.name}" environment. Check the gameId in bitmagic.json.`, 1, 'not_found');
+    }
+    if (response.status === 400) {
+        const problems = Array.isArray(parsed.problems) ? parsed.problems.filter((p) => typeof p === 'string') : [];
+        const message = typeof parsed.error === 'string' ? parsed.error : `api-server rejected ${what}.`;
+        return new CliError(problems.length > 0 ? `api-server refused ${what}:\n${problems.map((p) => `  - ${p}`).join('\n')}` : `api-server refused ${what}: ${message}`, 1, 'ads_invalid');
+    }
+    if (response.status === 503) {
+        if (parsed.code === 'ads_unavailable') {
+            return new CliError(`Game promotion is not available in the "${environment.name}" environment yet.`, 1, 'ads_unavailable');
+        }
+        return new CliError(`api-server reported uploads are unavailable in the "${environment.name}" environment.`, 1, 'unavailable');
+    }
+    return new CliError(`api-server returned HTTP ${response.status} for ${path}.`, 1, 'http_error');
+}
+function newerApi() {
+    return new CliError('api-server answered in a shape this CLI cannot read — run `bitmagic self-update`.');
+}
+/** A signed PUT under the game's `game-media/<gameId>/`, for an MP4, a JPEG or a PNG. */
+export async function mintAdUploadUrl(environment, accessToken, body, deps) {
+    const response = await callApi(environment, ADS_UPLOAD_URL_PATH, 'POST', accessToken, body, deps);
+    if (!response.ok)
+        throw await refusal(response, environment, ADS_UPLOAD_URL_PATH, body.gameId, 'the ad upload');
+    const parsed = await readJsonBody(response);
+    if (typeof parsed.uploadUrl !== 'string' || typeof parsed.publicUrl !== 'string')
+        throw newerApi();
+    return {
+        uploadUrl: parsed.uploadUrl,
+        publicUrl: parsed.publicUrl,
+        contentType: typeof parsed.contentType === 'string' ? parsed.contentType : body.contentType,
+    };
+}
+/** Register the uploaded package. Nothing is advertised by this. */
+export async function registerAdPackage(environment, accessToken, body, deps) {
+    const response = await callApi(environment, ADS_PACKAGE_PATH, 'POST', accessToken, body, deps);
+    if (!response.ok)
+        throw await refusal(response, environment, ADS_PACKAGE_PATH, body.gameId, 'the ad package');
+    const parsed = await readJsonBody(response);
+    if (typeof parsed.packageId !== 'string' || typeof parsed.promoteUrl !== 'string')
+        throw newerApi();
+    return { packageId: parsed.packageId, promoteUrl: parsed.promoteUrl, promotable: parsed.promotable === true };
+}
+/** The game's newest package and every order past checkout, with visitors and plays. */
+export async function fetchAdStatus(environment, accessToken, gameId, deps) {
+    const path = `${ADS_STATUS_PATH}?gameId=${encodeURIComponent(gameId)}`;
+    const response = await callApi(environment, path, 'GET', accessToken, undefined, deps);
+    if (!response.ok)
+        throw await refusal(response, environment, ADS_STATUS_PATH, gameId, 'reading the ads');
+    const parsed = await readJsonBody(response);
+    if (typeof parsed.promoteUrl !== 'string' || !Array.isArray(parsed.orders))
+        throw newerApi();
+    const raw = parsed.package;
+    const pkg = isJsonObject(raw) && typeof raw.id === 'string'
+        ? { id: raw.id, createdAt: num(raw.createdAt), gameName: isJsonObject(raw.manifest) ? str(raw.manifest.gameName) : '' }
+        : null;
+    return {
+        package: pkg,
+        orders: parsed.orders.map(parseAdOrder).filter((order) => order !== null),
+        promoteUrl: parsed.promoteUrl,
+        promotable: parsed.promotable === true,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/ads/client.js.map

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

package/dist/ads/paths.d.ts

@@ -0,0 +1,11 @@
+import { type AdImageSlot, type AdVideoSlot } from '@bitmagic/asset-core/ad-package';
+export declare const ADS_DIR: string;
+export declare function adsDir(root: string): string;
+/** `.bitmagic/ads/ads.json` — the headlines and descriptions, written by the agent. */
+export declare function adCopyPath(root: string): string;
+export declare function adVideoPath(root: string, slot: AdVideoSlot): string;
+export declare function adImagePath(root: string, slot: AdImageSlot): string;
+/** `.bitmagic/ads/published.json` — what the last `bitmagic ads publish` uploaded. */
+export declare function adRecordPath(root: string): string;
+/** Scratch space for one render (end-card PNGs, a grabbed frame); removed when the render ends. */
+export declare function adWorkDir(root: string): string;

package/dist/ads/paths.js

@@ -0,0 +1,36 @@
+/**
+ * Where `bitmagic ads` keeps an ad package inside a project (docs/creator-ads.md).
+ *
+ * Everything lives in `<root>/.bitmagic/ads/`: the copy (`ads.json`), the three videos and three
+ * stills `bitmagic ads render` writes, and the record of the last upload. Inside `.bitmagic/` means
+ * gitignored AND outside the publish fingerprint, so building ads never invalidates a passing
+ * `bitmagic verify` — the copy is a marketing decision, not part of the game.
+ *
+ * File names come from the shared spec (`@bitmagic/asset-core/ad-package`), the same one api-server
+ * checks an uploaded package against.
+ */
+import * as path from 'path';
+import { AD_COPY_FILE, AD_IMAGE_SLOTS, AD_VIDEO_SLOTS, } from '@bitmagic/asset-core/ad-package';
+export const ADS_DIR = path.join('.bitmagic', 'ads');
+export function adsDir(root) {
+    return path.join(root, ADS_DIR);
+}
+/** `.bitmagic/ads/ads.json` — the headlines and descriptions, written by the agent. */
+export function adCopyPath(root) {
+    return path.join(adsDir(root), AD_COPY_FILE);
+}
+export function adVideoPath(root, slot) {
+    return path.join(adsDir(root), AD_VIDEO_SLOTS[slot].file);
+}
+export function adImagePath(root, slot) {
+    return path.join(adsDir(root), AD_IMAGE_SLOTS[slot].file);
+}
+/** `.bitmagic/ads/published.json` — what the last `bitmagic ads publish` uploaded. */
+export function adRecordPath(root) {
+    return path.join(adsDir(root), 'published.json');
+}
+/** Scratch space for one render (end-card PNGs, a grabbed frame); removed when the render ends. */
+export function adWorkDir(root) {
+    return path.join(adsDir(root), '.work');
+}
+//# sourceMappingURL=paths.js.map

package/dist/ads/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/ads/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,GAGf,MAAM,iCAAiC,CAAC;AAEzC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AAErD,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAiB;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAiB;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,CAAC;AACnD,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/dist/ads/probe.d.ts

@@ -0,0 +1,12 @@
+export interface MediaProbe {
+    width: number;
+    height: number;
+    /** 0 for a still image. */
+    durationSec: number;
+    hasAudio: boolean;
+    /** The first video stream's codec, e.g. `h264`, `mjpeg`, `png`, `webp`. */
+    codec: string;
+}
+/** ffprobe's JSON for one file, parsed. Pure, so the parsing is testable without ffprobe. */
+export declare function parseProbe(json: string, file: string): MediaProbe;
+export declare function probeMedia(file: string): Promise<MediaProbe>;