versioncam 0.2.0 → 0.3.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgBxE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AASjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAenD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EACL,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgBxE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AASnE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAenD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EACL,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,EACL,qBAAqB,EACrB,QAAQ,EACR,OAAO,EACP,SAAS,GACV,MAAM,uBAAuB,CAAC;AAE/B,cAAc,uBAAuB,CAAC"}

package/dist/publish/client.d.ts

@@ -0,0 +1,38 @@
+import { type PublishBegin, type PublishBeginResponse, type PublishCommitResponse } from "./protocol.js";
+/**
+ * The client half of the publish protocol: begin, upload what the service
+ * does not have yet, commit.
+ *
+ * It knows nothing about recordings on disk. `files` hands it bytes on
+ * request, which keeps it testable against a fake `fetch` and keeps a state
+ * the service already has from ever being read off the disk.
+ */
+/** Bytes for what the service asks for, looked up lazily. */
+export type PublishFiles = {
+    state(hash: string): Promise<Uint8Array>;
+    timeline(clip: string): Promise<Uint8Array>;
+    targets(clip: string): Promise<Uint8Array>;
+    failure(clip: string): Promise<Uint8Array>;
+};
+export type PublishOptions = {
+    /** The API's origin, e.g. https://api.version.cam. */
+    api: string;
+    /** A GitHub OpenID Connect token, or a `vc_` project token. */
+    credential: string;
+    fetch?: typeof fetch;
+    /** How many uploads run at once. */
+    concurrency?: number;
+    /** Waits between retries, in milliseconds; the last one is the last try. */
+    backoffMs?: readonly number[];
+    log?: (line: string) => void;
+};
+/** An answer from the service that no retry will change. */
+export declare class PublishRefused extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(message: string, status: number, code: string);
+}
+export declare function publishRecordings(begin: PublishBegin, files: PublishFiles, options: PublishOptions): Promise<{
+    begun: PublishBeginResponse;
+    committed: PublishCommitResponse;
+}>;

package/dist/publish/client.js

@@ -0,0 +1,118 @@
+import { PUBLISH_PATHS, } from "./protocol.js";
+/** An answer from the service that no retry will change. */
+export class PublishRefused extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+    }
+}
+export async function publishRecordings(begin, files, options) {
+    const call = caller(options);
+    const begun = (await call("POST", PUBLISH_PATHS.begin, {
+        body: JSON.stringify(begin),
+        type: "application/json",
+    }));
+    const uploads = [
+        ...begun.needStates.map((hash) => async () => call("PUT", PUBLISH_PATHS.state(begun.publishId, hash), {
+            body: await files.state(hash),
+            type: "image/png",
+        })),
+        ...begun.needTimelines.map((clip) => async () => call("PUT", PUBLISH_PATHS.timeline(begun.publishId, clip), {
+            body: await files.timeline(clip),
+            type: "application/json",
+        })),
+        ...begun.needTargets.map((clip) => async () => call("PUT", PUBLISH_PATHS.targets(begun.publishId, clip), {
+            body: await files.targets(clip),
+            type: "application/json",
+        })),
+        ...begun.needFailures.map((clip) => async () => call("PUT", PUBLISH_PATHS.failure(begun.publishId, clip), {
+            body: await files.failure(clip),
+            type: "image/png",
+        })),
+    ];
+    options.log?.(`  uploading ${begun.needStates.length} new state(s) of ` +
+        `${begin.clips.reduce((n, c) => n + (c.recording?.states.length ?? 0), 0)}`);
+    await pool(uploads, options.concurrency ?? 6);
+    const committed = (await call("POST", PUBLISH_PATHS.commit(begun.publishId), {
+        body: "{}",
+        type: "application/json",
+    }));
+    return { begun, committed };
+}
+/**
+ * One request, retried on what a retry can fix: a network error, a 429 or a
+ * 5xx. Anything else is the service's considered answer, and its sentence is
+ * passed on unchanged, because it names the limit or the problem better than
+ * anything the client could add.
+ */
+function caller(options) {
+    const doFetch = options.fetch ?? fetch;
+    const backoff = options.backoffMs ?? [1000, 2000, 4000];
+    const origin = options.api.replace(/\/+$/, "");
+    return async (method, path, payload) => {
+        let lastError;
+        for (let attempt = 0; attempt <= backoff.length; attempt += 1) {
+            let response;
+            try {
+                response = await doFetch(`${origin}${path}`, {
+                    method,
+                    headers: {
+                        authorization: `Bearer ${options.credential}`,
+                        "content-type": payload.type,
+                    },
+                    // A copy for a byte body: fetch wants an ArrayBuffer-backed view,
+                    // and a Buffer read from disk may sit in a shared pool.
+                    body: typeof payload.body === "string"
+                        ? payload.body
+                        : new Uint8Array(payload.body),
+                });
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < backoff.length)
+                    await sleep(backoff[attempt]);
+                continue;
+            }
+            if (response.ok) {
+                const text = await response.text();
+                return text ? JSON.parse(text) : null;
+            }
+            if (response.status === 429 || response.status >= 500) {
+                lastError = new Error(`${method} ${path}: ${response.status} ${await response.text()}`);
+                if (attempt < backoff.length)
+                    await sleep(backoff[attempt]);
+                continue;
+            }
+            const body = await response.text();
+            let parsed = null;
+            try {
+                parsed = JSON.parse(body);
+            }
+            catch {
+                // Not the service's JSON: a proxy or a misconfigured API address.
+            }
+            throw new PublishRefused(parsed?.error ??
+                `${method} ${path} answered ${response.status}: ${body.slice(0, 300)}`, response.status, parsed?.code ?? "http");
+        }
+        throw new Error(`version.cam did not answer after ${backoff.length + 1} tries: ${lastError?.message ?? lastError}`);
+    };
+}
+/** Run tasks with at most `size` in flight; the first failure fails the lot. */
+async function pool(tasks, size) {
+    let next = 0;
+    const workers = Array.from({ length: Math.min(size, tasks.length) }, async () => {
+        while (next < tasks.length) {
+            const task = tasks[next];
+            next += 1;
+            await task();
+        }
+    });
+    await Promise.all(workers);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=client.js.map

package/dist/publish/client.js.map

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

package/dist/publish/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `versioncam/publish`: what the version.cam service imports.
+ *
+ * Nothing reachable from here may import Node, Playwright or ffmpeg: the
+ * service runs on Cloudflare Workers, and one stray import of the driver
+ * would pull a browser into its bundle. The recorder's own publish code
+ * (manifests, the client) lives beside this file and is not re-exported.
+ */
+export * from "./protocol.js";
+export { validateTimeline } from "../core/timeline.js";
+export type { Timeline, Step, Rect, Mark, Caption } from "../core/timeline.js";
+export type { Motion, Presentation } from "../config.js";

package/dist/publish/index.js

@@ -0,0 +1,11 @@
+/**
+ * `versioncam/publish`: what the version.cam service imports.
+ *
+ * Nothing reachable from here may import Node, Playwright or ffmpeg: the
+ * service runs on Cloudflare Workers, and one stray import of the driver
+ * would pull a browser into its bundle. The recorder's own publish code
+ * (manifests, the client) lives beside this file and is not re-exported.
+ */
+export * from "./protocol.js";
+export { validateTimeline } from "../core/timeline.js";
+//# sourceMappingURL=index.js.map

package/dist/publish/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/publish/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/publish/manifest.d.ts

@@ -0,0 +1,46 @@
+import type { ResolvedConfig } from "../config.js";
+import { type ClipManifest, type PublishedRenderConfig } from "./protocol.js";
+/**
+ * A recording directory, read into what a publish says about it.
+ *
+ * Everything the service is told is computed here from the files, never from
+ * the run that made them, so `publish` can run in a later CI step (or a later
+ * job) than the recording did and say exactly the same thing.
+ */
+export declare function sha256Hex(bytes: Uint8Array): string;
+/**
+ * A PNG's size from its header. The signature is eight bytes and the first
+ * chunk is always IHDR, whose data starts with the width and height as
+ * big-endian 32-bit integers, so no decoder is needed to tell the service
+ * what it is about to receive.
+ */
+export declare function pngSize(bytes: Uint8Array): {
+    width: number;
+    height: number;
+};
+/** What the service renders with: the render page's config, and its clock. */
+export declare function publishedRenderConfig(config: ResolvedConfig): PublishedRenderConfig;
+/** The files a recording's manifest was computed from, to upload on request. */
+export type RecordingFiles = {
+    timeline: Uint8Array;
+    targets: Uint8Array | null;
+    /** By hash, for the states the service asks for. */
+    states: Map<string, string>;
+    failure: Uint8Array | null;
+};
+/**
+ * One clip's manifest, from its recording directory.
+ *
+ * A directory holding `failure.json` failed its last run: the recorder
+ * clears a clip's directory before recording it, so a failure there is the
+ * latest word on the clip, and what it recorded before failing is not a
+ * recording anyone should see. Otherwise `timeline.json` is a complete
+ * recording that passed. With neither, the clip was never recorded here.
+ */
+export declare function readClip(dir: string, clip: {
+    id: string;
+    title: string;
+}, renderConfig: PublishedRenderConfig): {
+    manifest: ClipManifest;
+    files: RecordingFiles;
+} | null;

package/dist/publish/manifest.js

@@ -0,0 +1,133 @@
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { renderConfigOf } from "../config.js";
+import { FAILURE_JSON, FAILURE_PNG, TARGETS_FILE, } from "../driver/reports.js";
+import { contentOfTimeline, } from "./protocol.js";
+/**
+ * A recording directory, read into what a publish says about it.
+ *
+ * Everything the service is told is computed here from the files, never from
+ * the run that made them, so `publish` can run in a later CI step (or a later
+ * job) than the recording did and say exactly the same thing.
+ */
+export function sha256Hex(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+/**
+ * A PNG's size from its header. The signature is eight bytes and the first
+ * chunk is always IHDR, whose data starts with the width and height as
+ * big-endian 32-bit integers, so no decoder is needed to tell the service
+ * what it is about to receive.
+ */
+export function pngSize(bytes) {
+    const view = Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const signature = "89504e470d0a1a0a";
+    if (view.length < 24 || view.subarray(0, 8).toString("hex") !== signature) {
+        throw new Error("not a PNG");
+    }
+    if (view.subarray(12, 16).toString("latin1") !== "IHDR") {
+        throw new Error("a PNG whose first chunk is not IHDR");
+    }
+    return { width: view.readUInt32BE(16), height: view.readUInt32BE(20) };
+}
+/** What the service renders with: the render page's config, and its clock. */
+export function publishedRenderConfig(config) {
+    const { scenes: _scenes, ...render } = renderConfigOf(config);
+    return {
+        ...render,
+        clock: {
+            timezoneId: config.clock.timezoneId,
+            locale: config.clock.locale,
+        },
+    };
+}
+/**
+ * One clip's manifest, from its recording directory.
+ *
+ * A directory holding `failure.json` failed its last run: the recorder
+ * clears a clip's directory before recording it, so a failure there is the
+ * latest word on the clip, and what it recorded before failing is not a
+ * recording anyone should see. Otherwise `timeline.json` is a complete
+ * recording that passed. With neither, the clip was never recorded here.
+ */
+export function readClip(dir, clip, renderConfig) {
+    const failureJson = join(dir, FAILURE_JSON);
+    const timelineFile = join(dir, "timeline.json");
+    if (existsSync(failureJson)) {
+        const failure = JSON.parse(readFileSync(failureJson, "utf8"));
+        const png = join(dir, FAILURE_PNG);
+        const picture = existsSync(png) ? readFileSync(png) : null;
+        const check = {
+            status: "fail",
+            message: failure.message,
+            step: failure.step ?? null,
+            frame: failure.frame,
+            t: failure.t,
+        };
+        return {
+            manifest: {
+                id: clip.id,
+                title: clip.title,
+                check,
+                recording: null,
+                failureHash: picture ? sha256Hex(picture) : null,
+            },
+            files: {
+                timeline: new Uint8Array(),
+                targets: null,
+                states: new Map(),
+                failure: picture,
+            },
+        };
+    }
+    if (!existsSync(timelineFile))
+        return null;
+    const timelineBytes = readFileSync(timelineFile);
+    const timeline = JSON.parse(timelineBytes.toString("utf8"));
+    const targetsFile = join(dir, TARGETS_FILE);
+    const targets = existsSync(targetsFile) ? readFileSync(targetsFile) : null;
+    const statePaths = new Map();
+    const states = timeline.states.map((name) => {
+        const path = join(dir, "states", name);
+        const bytes = readFileSync(path);
+        const hash = sha256Hex(bytes);
+        statePaths.set(hash, path);
+        return { hash, bytes: bytes.length, ...pngSize(bytes) };
+    });
+    const targetsHash = targets ? sha256Hex(targets) : null;
+    const contentHash = sha256Hex(Buffer.from(JSON.stringify({
+        timeline: contentOfTimeline(timeline),
+        states: states.map((s) => s.hash),
+        targets: targetsHash,
+        renderConfig,
+    })));
+    const recording = {
+        contentHash,
+        timelineHash: sha256Hex(timelineBytes),
+        timelineBytes: timelineBytes.length,
+        targetsHash,
+        draft: timeline.meta.draft === true,
+        fps: timeline.fps,
+        durationFrames: timeline.durationFrames,
+        viewport: timeline.viewport,
+        states,
+        renderConfig,
+    };
+    return {
+        manifest: {
+            id: clip.id,
+            title: clip.title || timeline.meta.title,
+            check: { status: "pass" },
+            recording,
+            failureHash: null,
+        },
+        files: {
+            timeline: timelineBytes,
+            targets,
+            states: statePaths,
+            failure: null,
+        },
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/publish/manifest.js.map

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

package/dist/publish/protocol.d.ts

@@ -0,0 +1,203 @@
+/**
+ * The publish protocol: what `versioncam publish` sends to version.cam, and
+ * what comes back.
+ *
+ * Both ends import this file. The recorder builds a publish from it and the
+ * service validates one against it, through `versioncam/publish`, an entry
+ * that pulls in nothing that needs Node. A field added on one side is a type
+ * error on the other until both agree, which is the only kind of protocol
+ * drift that cannot reach production.
+ *
+ * The shape follows what a recording is on disk. A recording is a timeline
+ * plus a directory of distinct states, so a publish is a timeline plus the
+ * states' content hashes: the service asks for the states it has never seen,
+ * and a version that changed one screen uploads one screen.
+ */
+/** Bumped when either side could misread the other. */
+export declare const PUBLISH_PROTOCOL = 1;
+/** Where the service is, unless `VERSIONCAM_API` says otherwise. */
+export declare const DEFAULT_API = "https://api.version.cam";
+/**
+ * The audience a GitHub OpenID Connect token must be minted for. The Action
+ * asks for exactly this, and the service refuses any other, so a token
+ * minted for some other service cannot be replayed here.
+ */
+export declare const OIDC_AUDIENCE = "version.cam";
+/**
+ * Limits that hold on every plan. The service enforces them; they are here so
+ * the client can say which one a recording breaks before uploading anything.
+ */
+export declare const HARD_CAPS: {
+    readonly statesPerVersion: 400;
+    readonly stateBytes: number;
+    readonly timelineBytes: number;
+    readonly targetsBytes: number;
+    readonly failureBytes: number;
+    readonly publishesPerHour: 20;
+};
+/** The step that was running when a clip failed: its index and its call. */
+export type FailedStep = {
+    index: number;
+    call: string;
+};
+/** What the last run of a clip said about it. */
+export type CheckResult = {
+    status: "pass";
+} | {
+    status: "fail";
+    message: string;
+    step: FailedStep | null;
+    frame: number;
+    t: number;
+};
+/** One distinct state: a PNG, by the SHA-256 of its bytes. */
+export type StateRef = {
+    hash: string;
+    bytes: number;
+    width: number;
+    height: number;
+};
+/**
+ * What the service needs to render a recording exactly as `versioncam render`
+ * would have: the render page's config without its scenes (a scenes module is
+ * the app's own code, and nothing runs an app's code but the app's own CI),
+ * and the clock the render page is opened with.
+ */
+export type PublishedRenderConfig = {
+    output: {
+        width: number;
+        height: number;
+    };
+    theme: {
+        accent: string;
+        cursorScale: number;
+        /** The config's `theme.presentation`, or null when it is off. */
+        presentation: Record<string, unknown> | null;
+    };
+    /** The config's motion, every default filled in. */
+    motion: Record<string, unknown>;
+    clock: {
+        timezoneId: string;
+        locale: string;
+    };
+};
+/** A complete recording, described without its bytes. */
+export type RecordingManifest = {
+    /**
+     * The SHA-256 of what makes this recording look the way it does: the
+     * timeline without the fields that change on every run (when it was
+     * recorded, the app's commit), the states' hashes in order, the targets
+     * and the render config. Two runs that would render the same bytes have
+     * the same content hash, which is how the service knows a version is
+     * unchanged since the last one without being sent it.
+     */
+    contentHash: string;
+    /** The SHA-256 of `timeline.json` exactly as it will be uploaded. */
+    timelineHash: string;
+    timelineBytes: number;
+    /** The SHA-256 of `targets.json`, or null for a recording without one. */
+    targetsHash: string | null;
+    /** Recorded with `--draft`: 15 frames a second, at CSS scale. */
+    draft: boolean;
+    fps: number;
+    durationFrames: number;
+    viewport: {
+        width: number;
+        height: number;
+        dpr: number;
+    };
+    /** Every state the timeline names, in the timeline's order. */
+    states: StateRef[];
+    renderConfig: PublishedRenderConfig;
+};
+/** One clip in a publish: its last check, and its recording if it passed. */
+export type ClipManifest = {
+    id: string;
+    title: string;
+    check: CheckResult;
+    /** Present when the check passed and the recording is complete. */
+    recording: RecordingManifest | null;
+    /** The SHA-256 of `failure.png`, when the check failed and left one. */
+    failureHash: string | null;
+};
+/**
+ * The first request of a publish.
+ *
+ * With a GitHub OpenID Connect token, the repository, commit, ref and run
+ * come from the token and these fields are checked against it: what the
+ * player says a clip was recorded against is GitHub's word, not the CLI's.
+ * With a project token they are the only word there is.
+ */
+export type PublishBegin = {
+    protocol: typeof PUBLISH_PROTOCOL;
+    /** The versioncam version that made the recordings. */
+    recorder: string;
+    /** `owner/repo`. Optional with a project token, which names its project. */
+    project: string | null;
+    commit: string;
+    branch: string;
+    ref: string;
+    runId: string | null;
+    clips: ClipManifest[];
+};
+/** A clip the service will not take a recording of, and why, in a sentence. */
+export type Refusal = {
+    clip: string;
+    reason: string;
+};
+export type PublishBeginResponse = {
+    publishId: string;
+    /** `owner/repo`, as the service knows the project. */
+    project: string;
+    needStates: string[];
+    needTimelines: string[];
+    needTargets: string[];
+    needFailures: string[];
+    /**
+     * Recordings refused, by a cap or a plan. Their check results are recorded
+     * all the same: a limit gates storage and renders, never the truth.
+     */
+    refused: Refusal[];
+};
+/** What a publish made, per clip. */
+export type PublishedVersion = {
+    clip: string;
+    version: string;
+    /** The living URL of the clip on this branch. */
+    url: string;
+    /** This version's own page. */
+    versionUrl: string;
+    check: "pass" | "fail";
+    /** Nothing about how it looks changed since the version before it. */
+    unchanged: boolean;
+    /** The clip is stale on the default branch after this publish. */
+    stale: boolean;
+    /** Why its recording was not stored, when it was not. */
+    refused: string | null;
+};
+export type PublishCommitResponse = {
+    project: string;
+    versions: PublishedVersion[];
+};
+/** Every error the service answers with has a sentence meant for a person. */
+export type PublishErrorBody = {
+    error: string;
+    code: string;
+};
+/** Paths, relative to the API's origin. */
+export declare const PUBLISH_PATHS: {
+    readonly begin: "/v1/publish/begin";
+    readonly state: (id: string, hash: string) => string;
+    readonly timeline: (id: string, clip: string) => string;
+    readonly targets: (id: string, clip: string) => string;
+    readonly failure: (id: string, clip: string) => string;
+    readonly commit: (id: string) => string;
+};
+/**
+ * The timeline as its content hash sees it: without when it was recorded or
+ * which commit of the app it ran against, which differ on every run and say
+ * nothing about what the recording shows.
+ */
+export declare function contentOfTimeline(timeline: {
+    meta: Record<string, unknown>;
+}): unknown;

package/dist/publish/protocol.js

@@ -0,0 +1,56 @@
+/**
+ * The publish protocol: what `versioncam publish` sends to version.cam, and
+ * what comes back.
+ *
+ * Both ends import this file. The recorder builds a publish from it and the
+ * service validates one against it, through `versioncam/publish`, an entry
+ * that pulls in nothing that needs Node. A field added on one side is a type
+ * error on the other until both agree, which is the only kind of protocol
+ * drift that cannot reach production.
+ *
+ * The shape follows what a recording is on disk. A recording is a timeline
+ * plus a directory of distinct states, so a publish is a timeline plus the
+ * states' content hashes: the service asks for the states it has never seen,
+ * and a version that changed one screen uploads one screen.
+ */
+/** Bumped when either side could misread the other. */
+export const PUBLISH_PROTOCOL = 1;
+/** Where the service is, unless `VERSIONCAM_API` says otherwise. */
+export const DEFAULT_API = "https://api.version.cam";
+/**
+ * The audience a GitHub OpenID Connect token must be minted for. The Action
+ * asks for exactly this, and the service refuses any other, so a token
+ * minted for some other service cannot be replayed here.
+ */
+export const OIDC_AUDIENCE = "version.cam";
+/**
+ * Limits that hold on every plan. The service enforces them; they are here so
+ * the client can say which one a recording breaks before uploading anything.
+ */
+export const HARD_CAPS = {
+    statesPerVersion: 400,
+    stateBytes: 4 * 1024 * 1024,
+    timelineBytes: 2 * 1024 * 1024,
+    targetsBytes: 256 * 1024,
+    failureBytes: 4 * 1024 * 1024,
+    publishesPerHour: 20,
+};
+/** Paths, relative to the API's origin. */
+export const PUBLISH_PATHS = {
+    begin: "/v1/publish/begin",
+    state: (id, hash) => `/v1/publish/${id}/state/${hash}`,
+    timeline: (id, clip) => `/v1/publish/${id}/timeline/${encodeURIComponent(clip)}`,
+    targets: (id, clip) => `/v1/publish/${id}/targets/${encodeURIComponent(clip)}`,
+    failure: (id, clip) => `/v1/publish/${id}/failure/${encodeURIComponent(clip)}`,
+    commit: (id) => `/v1/publish/${id}/commit`,
+};
+/**
+ * The timeline as its content hash sees it: without when it was recorded or
+ * which commit of the app it ran against, which differ on every run and say
+ * nothing about what the recording shows.
+ */
+export function contentOfTimeline(timeline) {
+    const { recordedAt: _recordedAt, appCommit: _appCommit, ...meta } = timeline.meta;
+    return { ...timeline, meta };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/publish/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/publish/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,yBAAyB,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,gBAAgB,EAAE,GAAG;IACrB,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAC3B,aAAa,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAC9B,YAAY,EAAE,GAAG,GAAG,IAAI;IACxB,YAAY,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAC7B,gBAAgB,EAAE,EAAE;CACZ,CAAC;AAoJX,2CAA2C;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,mBAAmB;IAC1B,KAAK,EAAE,CAAC,EAAU,EAAE,IAAY,EAAE,EAAE,CAAC,eAAe,EAAE,UAAU,IAAI,EAAE;IACtE,QAAQ,EAAE,CAAC,EAAU,EAAE,IAAY,EAAE,EAAE,CACrC,eAAe,EAAE,aAAa,kBAAkB,CAAC,IAAI,CAAC,EAAE;IAC1D,OAAO,EAAE,CAAC,EAAU,EAAE,IAAY,EAAE,EAAE,CACpC,eAAe,EAAE,YAAY,kBAAkB,CAAC,IAAI,CAAC,EAAE;IACzD,OAAO,EAAE,CAAC,EAAU,EAAE,IAAY,EAAE,EAAE,CACpC,eAAe,EAAE,YAAY,kBAAkB,CAAC,IAAI,CAAC,EAAE;IACzD,MAAM,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,eAAe,EAAE,SAAS;CAC1C,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAEjC;IACC,MAAM,EACJ,UAAU,EAAE,WAAW,EACvB,SAAS,EAAE,UAAU,EACrB,GAAG,IAAI,EACR,GAAG,QAAQ,CAAC,IAAI,CAAC;IAClB,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC"}