@bitmagic/cli 0.1.0

package/dist/generate/stream.js

@@ -0,0 +1,185 @@
+import { CliError } from '../errors.js';
+/**
+ * The unit of `event:`/`data:` lines terminated by a blank line, per the SSE wire format
+ * `api-server/src/cli/cli-assets.ts` writes. Splits on `\n`, joining multiple `data:` lines (the
+ * spec allows more than one) with `\n` before parsing as JSON. A leading `:` line (the server's
+ * `: keepalive` comment) carries no `data:`, so it naturally produces no event.
+ */
+function parseFrame(frame) {
+    let eventName = 'message';
+    const dataLines = [];
+    for (const line of frame.split('\n')) {
+        if (line.startsWith('event:')) {
+            eventName = line.slice('event:'.length).trim();
+        }
+        else if (line.startsWith('data:')) {
+            dataLines.push(line.slice('data:'.length).trim());
+        }
+        // Any other line (including a `:`-prefixed comment, or blank) carries no event data.
+    }
+    if (dataLines.length === 0)
+        return null;
+    return { event: eventName, data: JSON.parse(dataLines.join('\n')) };
+}
+/**
+ * Incremental frame buffer: SSE frames arrive in arbitrary chunks over the wire — one frame can
+ * span two reads, and two frames can arrive in one — so this accumulates bytes and only emits
+ * events once a full `\n\n`-delimited frame is available. The trailing, not-yet-delimited
+ * remainder stays in `buffer` for the next push. Shared by both `parseSseChunks` (fed the whole
+ * chunk array at once) and `requestGeneration` (fed one chunk per network read), so the two
+ * cannot drift apart.
+ */
+function createSseFrameBuffer() {
+    let buffer = '';
+    return {
+        push(chunk) {
+            buffer += chunk;
+            const frames = buffer.split('\n\n');
+            // The last element is either '' (buffer ended exactly on a delimiter) or an incomplete
+            // trailing frame — either way it is not yet a complete frame, so keep it buffered.
+            buffer = frames.pop() ?? '';
+            const events = [];
+            for (const frame of frames) {
+                const event = parseFrame(frame);
+                if (event)
+                    events.push(event);
+            }
+            return events;
+        },
+    };
+}
+/**
+ * Pure, synchronous parse of a full set of chunks — cheap and exhaustive to test. Production
+ * streaming uses the same underlying buffer (`createSseFrameBuffer`) one network read at a time,
+ * via `requestGeneration`, so this function is not itself on that path.
+ */
+export function parseSseChunks(chunks) {
+    const frameBuffer = createSseFrameBuffer();
+    const events = [];
+    for (const chunk of chunks) {
+        events.push(...frameBuffer.push(chunk));
+    }
+    return events;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function asProgressMessage(data) {
+    return isRecord(data) && typeof data.message === 'string' ? data.message : null;
+}
+/**
+ * `patches` is trusted structurally here (an array), not deeply validated — the server's own
+ * `WorldPatch[]` contract is re-validated field-by-field later by
+ * `apply-patches.ts`'s `validateWorldPatch` before anything is written to disk.
+ */
+function asGenerationOutcome(data) {
+    if (!isRecord(data))
+        return null;
+    const { success, message, patches } = data;
+    if (typeof success !== 'boolean' || typeof message !== 'string' || !Array.isArray(patches)) {
+        return null;
+    }
+    return { success, message, patches: patches };
+}
+async function readJsonBody(response) {
+    try {
+        const parsed = await response.json();
+        return isRecord(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function gameIdFrom(body) {
+    return typeof body.gameId === 'string' && body.gameId.length > 0 ? body.gameId : '(unknown game)';
+}
+/**
+ * Maps the pre-stream failure shapes documented on `api-server/src/cli/cli-assets.ts`'s handler
+ * into a message an agent can act on: whether to stop (403, insufficient sparks) or fix its
+ * request (400). Never includes the access token — only the game id and the server's own text.
+ */
+async function toCliError(response, type, body) {
+    const errorBody = await readJsonBody(response);
+    const serverMessage = typeof errorBody.error === 'string' ? errorBody.error : undefined;
+    if (response.status === 403) {
+        return new CliError(`You do not own game "${gameIdFrom(body)}", so it cannot generate a ${type} asset for it.`);
+    }
+    if (response.status === 402) {
+        const balance = errorBody.balance;
+        const required = errorBody.required;
+        const detail = typeof balance === 'number' && typeof required === 'number'
+            ? ` You have ${balance} sparks; generating this ${type} asset requires ${required}.`
+            : '';
+        return new CliError(`Not enough sparks to generate this ${type} asset.${detail}`);
+    }
+    if (response.status === 400) {
+        return new CliError(serverMessage ?? `The server rejected this ${type} generation request.`);
+    }
+    return new CliError(`api-server returned HTTP ${response.status} generating a ${type} asset` +
+        (serverMessage ? `: ${serverMessage}` : '.'));
+}
+/**
+ * POSTs to `/api/cli/v1/assets/<type>/stream` and consumes the SSE response.
+ *
+ * - A non-2xx response fails before any stream opens; see `toCliError` for the status mapping.
+ * - On 200, each `progress` event invokes `deps.onProgress`; the terminal `result` or `error`
+ *   event resolves this call with the outcome it carried (an `error` event's `success: false`
+ *   is a legitimate generation failure, not a thrown CliError — the caller decides how to
+ *   present it).
+ * - A stream that closes with **no terminal event** is a truncated connection, not a success
+ *   with zero patches, and fails with a CliError.
+ */
+export async function requestGeneration(environment, accessToken, type, body, deps) {
+    const url = `${environment.apiUrl}/api/cli/v1/assets/${type}/stream`;
+    let response;
+    try {
+        response = await deps.fetch(url, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+                Accept: 'text/event-stream',
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    catch {
+        // A transport failure and an error status send people to very different places.
+        throw new CliError(`Cannot reach api-server at ${environment.apiUrl}.`);
+    }
+    if (!response.ok) {
+        throw await toCliError(response, type, body);
+    }
+    if (!response.body) {
+        throw new CliError('The server accepted the request but returned no stream body.');
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    const frameBuffer = createSseFrameBuffer();
+    for (;;) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        // `{ stream: true }` retains any trailing partial multi-byte UTF-8 sequence inside the
+        // decoder itself, so a character split across two network chunks decodes correctly once its
+        // remaining bytes arrive in the next read, instead of emitting U+FFFD.
+        const text = decoder.decode(value, { stream: true });
+        for (const event of frameBuffer.push(text)) {
+            if (event.event === 'progress') {
+                const message = asProgressMessage(event.data);
+                if (message !== null)
+                    deps.onProgress(message);
+                continue;
+            }
+            if (event.event === 'result' || event.event === 'error') {
+                const outcome = asGenerationOutcome(event.data);
+                if (outcome)
+                    return outcome;
+            }
+        }
+    }
+    throw new CliError(`The connection to api-server ended before the ${type} generation finished. ` +
+        'This is not a confirmed failure: check the game before retrying, since the server ' +
+        'may have already produced (and billed for) an asset before the stream broke.');
+}
+//# sourceMappingURL=stream.js.map

package/dist/generate/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/generate/stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAcxC;;;;;GAKG;AACH,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,SAAS,GAAG,SAAS,CAAC;IAC1B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,qFAAqF;IACvF,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAY,EAAE,CAAC;AACjF,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,oBAAoB;IAC3B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,OAAO;QACL,IAAI,CAAC,KAAa;YAChB,MAAM,IAAI,KAAK,CAAC;YAChB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACpC,uFAAuF;YACvF,mFAAmF;YACnF,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAe,EAAE,CAAC;YAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;gBAChC,IAAI,KAAK;oBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAgB;IAC7C,MAAM,WAAW,GAAG,oBAAoB,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAaD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa;IACtC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,IAAa;IACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC3C,IAAI,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3F,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAuB,EAAE,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAuB;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC9C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAA6B;IAC/C,OAAO,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC;AACpG,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,UAAU,CAAC,QAAuB,EAAE,IAAY,EAAE,IAA6B;IAC5F,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAExF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,QAAQ,CACjB,wBAAwB,UAAU,CAAC,IAAI,CAAC,8BAA8B,IAAI,gBAAgB,CAC3F,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;QAClC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QACpC,MAAM,MAAM,GACV,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;YACzD,CAAC,CAAC,aAAa,OAAO,4BAA4B,IAAI,mBAAmB,QAAQ,GAAG;YACpF,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,IAAI,QAAQ,CAAC,sCAAsC,IAAI,UAAU,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,QAAQ,CAAC,aAAa,IAAI,4BAA4B,IAAI,sBAAsB,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO,IAAI,QAAQ,CACjB,4BAA4B,QAAQ,CAAC,MAAM,iBAAiB,IAAI,QAAQ;QACtE,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAwB,EACxB,WAAmB,EACnB,IAAY,EACZ,IAA6B,EAC7B,IAAgB;IAEhB,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,MAAM,sBAAsB,IAAI,SAAS,CAAC;IAErE,IAAI,QAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YAC/B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,WAAW,EAAE;gBACtC,MAAM,EAAE,mBAAmB;gBAC3B,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,gFAAgF;QAChF,MAAM,IAAI,QAAQ,CAAC,8BAA8B,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,QAAQ,CAAC,8DAA8D,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,oBAAoB,EAAE,CAAC;IAE3C,SAAS,CAAC;QACR,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAEhB,uFAAuF;QACvF,4FAA4F;QAC5F,uEAAuE;QACvE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,OAAO,KAAK,IAAI;oBAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAC/C,SAAS;YACX,CAAC;YACD,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBACxD,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChD,IAAI,OAAO;oBAAE,OAAO,OAAO,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,iDAAiD,IAAI,wBAAwB;QAC3E,oFAAoF;QACpF,8EAA8E,CACjF,CAAC;AACJ,CAAC"}

package/dist/http/client.d.ts

@@ -0,0 +1,6 @@
+import type { Environment } from '../config/environments.js';
+export interface ApiDeps {
+    fetch: typeof globalThis.fetch;
+}
+export declare function apiGet<T>(environment: Environment, path: string, accessToken: string, deps: ApiDeps): Promise<T>;
+export declare function apiPost<T>(environment: Environment, path: string, accessToken: string, body: unknown, deps: ApiDeps): Promise<T>;

package/dist/http/client.js

@@ -0,0 +1,49 @@
+import { CliError } from '../errors.js';
+/**
+ * Shared status handling for every api-server call: the transport-failure/error-status split,
+ * and the 401/403/503/other mapping. `apiGet` and `apiPost` differ only in the fetch `init` they
+ * pass in — keeping the mapping here means the two cannot drift apart.
+ */
+async function request(environment, path, accessToken, deps, init) {
+    const url = `${environment.apiUrl}${path}`;
+    let response;
+    try {
+        response = await deps.fetch(url, init);
+    }
+    catch {
+        // A transport failure and an error status send people to very different places.
+        throw new CliError(`Cannot reach api-server at ${environment.apiUrl}.`);
+    }
+    if (response.ok) {
+        return (await response.json());
+    }
+    if (response.status === 401) {
+        throw new CliError('Your session has expired. Run `bitmagic login`.');
+    }
+    if (response.status === 403) {
+        throw new CliError('Your account is authenticated but does not have the Admin role, which the ' +
+            'Bitmagic CLI requires. Ask a Bitmagic admin to grant it.');
+    }
+    if (response.status === 503) {
+        throw new CliError(`api-server reported this feature is unavailable in the "${environment.name}" environment.`);
+    }
+    throw new CliError(`api-server returned HTTP ${response.status} for ${path}.`);
+}
+export async function apiGet(environment, path, accessToken, deps) {
+    return request(environment, path, accessToken, deps, {
+        method: 'GET',
+        headers: { Authorization: `Bearer ${accessToken}`, Accept: 'application/json' },
+    });
+}
+export async function apiPost(environment, path, accessToken, body, deps) {
+    return request(environment, path, accessToken, deps, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            Accept: 'application/json',
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/http/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAaxC;;;;GAIG;AACH,KAAK,UAAU,OAAO,CACpB,WAAwB,EACxB,IAAY,EACZ,WAAmB,EACnB,IAAa,EACb,IAA4C;IAE5C,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;IAE3C,IAAI,QAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,gFAAgF;QAChF,MAAM,IAAI,QAAQ,CAAC,8BAA8B,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IACtC,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAAC,iDAAiD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAChB,4EAA4E;YAC1E,0DAA0D,CAC7D,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAChB,2DAA2D,WAAW,CAAC,IAAI,gBAAgB,CAC5F,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC,4BAA4B,QAAQ,CAAC,MAAM,QAAQ,IAAI,GAAG,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,WAAwB,EACxB,IAAY,EACZ,WAAmB,EACnB,IAAa;IAEb,OAAO,OAAO,CAAI,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;QACtD,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,WAAW,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;KAChF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,WAAwB,EACxB,IAAY,EACZ,WAAmB,EACnB,IAAa,EACb,IAAa;IAEb,OAAO,OAAO,CAAI,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;QACtD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,WAAW,EAAE;YACtC,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;AACL,CAAC"}

package/dist/project/context.d.ts

@@ -0,0 +1,18 @@
+export interface ProjectMetadata {
+    gameId: string;
+    engineVersion: string;
+    genre: string;
+    template: string;
+}
+export interface ProjectContext {
+    root: string;
+    metadata: ProjectMetadata;
+}
+/** Walks up from `startDir` looking for bitmagic.json, so commands work from any subdirectory. */
+export declare function findProjectRoot(startDir?: string): string;
+export declare function loadProjectContext(startDir?: string): ProjectContext;
+/**
+ * Resolves a tool from the PROJECT's node_modules, never the CLI's. The scaffold pins its own
+ * typescript and vite; running a different copy would type-check against the wrong compiler.
+ */
+export declare function projectBin(root: string, name: string): string;

package/dist/project/context.js

@@ -0,0 +1,67 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { CliError } from '../errors.js';
+const MARKER = 'bitmagic.json';
+const REQUIRED_STRING_FIELDS = [
+    'gameId',
+    'engineVersion',
+    'genre',
+    'template',
+];
+/**
+ * Runtime guard: does `value` have every required ProjectMetadata field as a non-empty string?
+ * Returns the name of the first missing/invalid field so the caller can report a message that
+ * names the culprit, or undefined once `value` is well-formed. Follows the same guard-over-cast
+ * pattern as `isStoredCredentials` in ../config/credentials.ts, added there after a similar
+ * review found a bare cast let malformed data through unnoticed.
+ */
+function findMissingField(value) {
+    return REQUIRED_STRING_FIELDS.find((field) => typeof value[field] !== 'string' || value[field].length === 0);
+}
+/** Walks up from `startDir` looking for bitmagic.json, so commands work from any subdirectory. */
+export function findProjectRoot(startDir = process.cwd()) {
+    let dir = path.resolve(startDir);
+    for (;;) {
+        if (fs.existsSync(path.join(dir, MARKER)))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            throw new CliError(`No ${MARKER} found in ${path.resolve(startDir)} or any parent directory. ` +
+                'Run this from inside a Bitmagic project, or create one with `bitmagic init`.');
+        }
+        dir = parent;
+    }
+}
+export function loadProjectContext(startDir = process.cwd()) {
+    const root = findProjectRoot(startDir);
+    const file = path.join(root, MARKER);
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        // Distinct from "no project": the marker exists but cannot be read, and telling the user to
+        // run `bitmagic init` here would be wrong advice.
+        throw new CliError(`${file} is not valid JSON. The project metadata is unreadable.`);
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new CliError(`${file} does not contain a project object.`);
+    }
+    const missingField = findMissingField(parsed);
+    if (missingField) {
+        throw new CliError(`${file} is missing ${missingField}.`);
+    }
+    return { root, metadata: parsed };
+}
+/**
+ * Resolves a tool from the PROJECT's node_modules, never the CLI's. The scaffold pins its own
+ * typescript and vite; running a different copy would type-check against the wrong compiler.
+ */
+export function projectBin(root, name) {
+    const binary = path.join(root, 'node_modules', '.bin', name);
+    if (!fs.existsSync(binary)) {
+        throw new CliError(`Cannot find \`${name}\` in this project's dependencies. Run \`npm install\` in ${root} first.`);
+    }
+    return binary;
+}
+//# sourceMappingURL=context.js.map

package/dist/project/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/project/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAcxC,MAAM,MAAM,GAAG,eAAe,CAAC;AAE/B,MAAM,sBAAsB,GAA8B;IACxD,QAAQ;IACR,eAAe;IACf,OAAO;IACP,UAAU;CACX,CAAC;AAEF;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,KAA8B;IACtD,OAAO,sBAAsB,CAAC,IAAI,CAChC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAK,KAAK,CAAC,KAAK,CAAY,CAAC,MAAM,KAAK,CAAC,CACrF,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,eAAe,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC9D,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,SAAS,CAAC;QACR,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,QAAQ,CAChB,MAAM,MAAM,aAAa,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,4BAA4B;gBACzE,8EAA8E,CACjF,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IACjE,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,4FAA4F;QAC5F,kDAAkD;QAClD,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,yDAAyD,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,qCAAqC,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAiC,CAAC,CAAC;IACzE,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,eAAe,YAAY,GAAG,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAyB,EAAE,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,QAAQ,CAChB,iBAAiB,IAAI,6DAA6D,IAAI,SAAS,CAChG,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/scaffold/aliases.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The engine resolves every import through a path alias. The same set has to appear in three
+ * places — tsconfig paths, the browser import map, and vite's resolve.alias — so it is defined
+ * once here and rendered into each form. Hand-maintaining three copies is the most likely way a
+ * scaffolded project silently stops compiling.
+ */
+export interface AliasRoot {
+    /** Alias prefix as written in imports, without a trailing slash. */
+    name: string;
+    /** Directory the alias resolves to in the project, relative to the project root. */
+    sourceDir: string;
+}
+export declare const ALIASES: AliasRoot[];
+/**
+ * Where one named alias resolves to in the project. Callers that need a specific alias's
+ * directory (the scaffolder and its tests) go through this rather than repeating the lookup and
+ * its not-found guard, so the "no such alias" message stays in one place.
+ */
+export declare function aliasSourceDir(name: string): string;
+/** tsconfig `paths`, resolved against a baseUrl of ".". */
+export declare function tsconfigPaths(): Record<string, string[]>;
+/**
+ * Import-map and vite targets. tsc runs with rootDir "." so it mirrors the source tree into
+ * dist/, meaning engine/engine/X.ts emits to dist/engine/engine/X.js.
+ */
+export declare function importMapEntries(): Record<string, string>;
+export declare function viteAliasEntries(): Record<string, string>;

package/dist/scaffold/aliases.js

@@ -0,0 +1,51 @@
+import { CliError } from '../errors.js';
+export const ALIASES = [
+    { name: 'engine', sourceDir: 'engine/engine' },
+    { name: 'types', sourceDir: 'engine/types' },
+    { name: 'bundle', sourceDir: 'engine/bundle' },
+    { name: 'debug', sourceDir: 'engine/debug' },
+    { name: 'editor', sourceDir: 'engine/editor' },
+    // The entry module (GameTemplate.ts) does `import 'core/utils/AutoCacheBuster.js'` as a
+    // side-effect-only import. tsc does not flag an unresolvable bare side-effect import (TS2307
+    // is only raised for named imports), so a missing core/ alias typechecks clean and fails only
+    // at runtime with "Failed to resolve module specifier" on the entry module itself.
+    { name: 'core', sourceDir: 'engine/core' },
+    // The genre baseline, vendored for the engine's own debug tooling (e.g.
+    // debug/AnimationPreview.ts imports genres/voxel/BitmagicPlayerCharacter.js). Distinct from
+    // src/, which is the creator's game derived from this same baseline — see project.ts.
+    { name: 'genres', sourceDir: 'engine/genres' },
+    // The creator's own game. engine/types/work-game.d.ts declares module 'work/Game.js', which
+    // is how the engine loads it. sourceDir MUST be 'src/work', not 'src': worldDataLoader.ts
+    // fetches the literal relative paths 'src/work/game.json' and 'src/work/world.json' as plain
+    // fetch URLs, not module specifiers — no import map or vite alias can redirect a fetch URL.
+    // Moving this directory typechecks clean (tsc never sees a fetch string) but breaks the game
+    // at runtime with "world.json not found", so don't "simplify" it back to 'src'.
+    { name: 'work', sourceDir: 'src/work' },
+];
+/**
+ * Where one named alias resolves to in the project. Callers that need a specific alias's
+ * directory (the scaffolder and its tests) go through this rather than repeating the lookup and
+ * its not-found guard, so the "no such alias" message stays in one place.
+ */
+export function aliasSourceDir(name) {
+    const alias = ALIASES.find((a) => a.name === name);
+    if (!alias) {
+        throw new CliError(`The alias model has no "${name}" entry.`);
+    }
+    return alias.sourceDir;
+}
+/** tsconfig `paths`, resolved against a baseUrl of ".". */
+export function tsconfigPaths() {
+    return Object.fromEntries(ALIASES.map((a) => [`${a.name}/*`, [`${a.sourceDir}/*`]]));
+}
+/**
+ * Import-map and vite targets. tsc runs with rootDir "." so it mirrors the source tree into
+ * dist/, meaning engine/engine/X.ts emits to dist/engine/engine/X.js.
+ */
+export function importMapEntries() {
+    return Object.fromEntries(ALIASES.map((a) => [`${a.name}/`, `/dist/${a.sourceDir}/`]));
+}
+export function viteAliasEntries() {
+    return importMapEntries();
+}
+//# sourceMappingURL=aliases.js.map

package/dist/scaffold/aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.js","sourceRoot":"","sources":["../../src/scaffold/aliases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAexC,MAAM,CAAC,MAAM,OAAO,GAAgB;IAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE;IAC9C,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE;IAC5C,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE;IAC9C,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE;IAC5C,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE;IAC9C,wFAAwF;IACxF,6FAA6F;IAC7F,8FAA8F;IAC9F,mFAAmF;IACnF,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE;IAC1C,wEAAwE;IACxE,4FAA4F;IAC5F,sFAAsF;IACtF,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE;IAC9C,4FAA4F;IAC5F,0FAA0F;IAC1F,6FAA6F;IAC7F,4FAA4F;IAC5F,6FAA6F;IAC7F,gFAAgF;IAChF,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE;CACxC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAAC,2BAA2B,IAAI,UAAU,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC,SAAS,CAAC;AACzB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC"}

package/dist/scaffold/engine-download.d.ts

@@ -0,0 +1,27 @@
+import type { Environment } from '../config/environments.js';
+import { type ApiDeps } from '../http/client.js';
+export interface EngineManifest {
+    version: string;
+    tarballUrl: string;
+    sha256: string;
+}
+export declare function fetchEngineManifest(environment: Environment, accessToken: string, deps: ApiDeps): Promise<EngineManifest>;
+export interface DownloadDeps {
+    fetch: typeof globalThis.fetch;
+}
+/**
+ * Downloads the tarball and verifies its digest before it is written. A signed URL is a
+ * credential, so it never appears in an error message.
+ */
+export declare function downloadAndVerify(tarballUrl: string, expectedSha256: string, targetPath: string, deps: DownloadDeps): Promise<void>;
+/**
+ * The tarball stores three prefixes at different depths — game/src/<root>, game/docs (plus the
+ * sibling game/sw-cache-buster.js, which shares game/docs's strip depth) and templates — so it
+ * takes three passes. A single pass cannot express them: `strip` is a fixed depth, and stripping
+ * 2 would turn game/docs/x.md into a bare x.md.
+ *
+ * Result: <engineDir>/{engine,types,bundle,debug,editor,genres}, <engineDir>/docs,
+ * <engineDir>/sw-cache-buster.js, and templates unpacked separately so the scaffolder can read
+ * templates/index.json.
+ */
+export declare function extractEngine(tarballPath: string, engineDir: string, templatesDir: string): Promise<void>;

package/dist/scaffold/engine-download.js

@@ -0,0 +1,78 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { Buffer } from 'buffer';
+import * as tar from 'tar';
+import { CliError } from '../errors.js';
+import { apiGet } from '../http/client.js';
+export async function fetchEngineManifest(environment, accessToken, deps) {
+    return apiGet(environment, '/api/cli/v1/engine/manifest', accessToken, deps);
+}
+/**
+ * Downloads the tarball and verifies its digest before it is written. A signed URL is a
+ * credential, so it never appears in an error message.
+ */
+export async function downloadAndVerify(tarballUrl, expectedSha256, targetPath, deps) {
+    let response;
+    try {
+        response = await deps.fetch(tarballUrl, { method: 'GET' });
+    }
+    catch {
+        throw new CliError('Cannot download the engine. Check your network connection.');
+    }
+    if (!response.ok) {
+        throw new CliError(`Downloading the engine failed with HTTP ${response.status}.`);
+    }
+    let body;
+    try {
+        body = Buffer.from(await response.arrayBuffer());
+    }
+    catch {
+        throw new CliError('The engine download was interrupted while reading its data. Check your network connection and try again.');
+    }
+    const actual = crypto.createHash('sha256').update(body).digest('hex');
+    if (actual !== expectedSha256) {
+        throw new CliError('The downloaded engine does not match the checksum the server published. ' +
+            'Nothing has been written. Try again; if it persists, report it.');
+    }
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+    fs.writeFileSync(targetPath, body);
+}
+/**
+ * The tarball stores three prefixes at different depths — game/src/<root>, game/docs (plus the
+ * sibling game/sw-cache-buster.js, which shares game/docs's strip depth) and templates — so it
+ * takes three passes. A single pass cannot express them: `strip` is a fixed depth, and stripping
+ * 2 would turn game/docs/x.md into a bare x.md.
+ *
+ * Result: <engineDir>/{engine,types,bundle,debug,editor,genres}, <engineDir>/docs,
+ * <engineDir>/sw-cache-buster.js, and templates unpacked separately so the scaffolder can read
+ * templates/index.json.
+ */
+export async function extractEngine(tarballPath, engineDir, templatesDir) {
+    fs.mkdirSync(engineDir, { recursive: true });
+    fs.mkdirSync(templatesDir, { recursive: true });
+    // game/src/engine/A.ts -> <engineDir>/engine/A.ts
+    await tar.extract({
+        file: tarballPath,
+        cwd: engineDir,
+        strip: 2,
+        filter: (entryPath) => entryPath.startsWith('game/src/'),
+    });
+    // game/docs/coordinate-system.md -> <engineDir>/docs/coordinate-system.md
+    // game/sw-cache-buster.js -> <engineDir>/sw-cache-buster.js (rides this pass because it needs
+    // the same strip depth as game/docs/, even though it isn't under game/docs/ itself)
+    await tar.extract({
+        file: tarballPath,
+        cwd: engineDir,
+        strip: 1,
+        filter: (entryPath) => entryPath.startsWith('game/docs/') || entryPath === 'game/sw-cache-buster.js',
+    });
+    // templates/index.json -> <templatesDir>/index.json
+    await tar.extract({
+        file: tarballPath,
+        cwd: templatesDir,
+        strip: 1,
+        filter: (entryPath) => entryPath.startsWith('templates/'),
+    });
+}
+//# sourceMappingURL=engine-download.js.map

package/dist/scaffold/engine-download.js.map

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

package/dist/scaffold/project-files.d.ts

@@ -0,0 +1,15 @@
+export declare function renderPackageJson(name: string): string;
+export declare function renderTsconfig(): string;
+export declare function renderIndexHtml(): string;
+export declare function renderViteConfig(): string;
+export declare function renderGitignore(): string;
+export interface ProjectMetadata {
+    gameId: string;
+    engineVersion: string;
+    genre: string;
+    template: string;
+}
+export declare function renderBitmagicJson(metadata: ProjectMetadata): string;
+export declare function renderAgentsMd(): string;
+export declare function renderClaudeMd(): string;
+export declare function renderSkillsReadme(): string;