@bitmagic/cli 0.1.0

package/dist/commands/generate.js

@@ -0,0 +1,348 @@
+import { defineCommand } from 'citty';
+import * as path from 'path';
+import { CliError } from '../errors.js';
+import { loadProjectContext } from '../project/context.js';
+import { aliasSourceDir } from '../scaffold/aliases.js';
+import { resolveEnvironment, resolveAuth0ClientId } from '../config/environments.js';
+import { readDefaultEnvironment } from '../config/credentials.js';
+import { getAccessToken } from '../auth/session.js';
+import { requestGeneration } from '../generate/stream.js';
+import { applyPatchesToWorld } from '../generate/apply-patches.js';
+function parseNumberFlag(flagName, raw, options = {}) {
+    if (raw === undefined)
+        return undefined;
+    const value = Number(raw);
+    if (!Number.isFinite(value)) {
+        throw new CliError(`--${flagName} must be a number, got ${JSON.stringify(raw)}.`);
+    }
+    if (options.integer && !Number.isInteger(value)) {
+        throw new CliError(`--${flagName} must be a whole number, got ${JSON.stringify(raw)}.`);
+    }
+    if (options.min !== undefined && value < options.min) {
+        throw new CliError(`--${flagName} must be at least ${options.min}, got ${value}.`);
+    }
+    if (options.max !== undefined && value > options.max) {
+        throw new CliError(`--${flagName} must be at most ${options.max}, got ${value}.`);
+    }
+    return value;
+}
+export function buildSkyboxBody(args) {
+    return {
+        description: args.description,
+        ...(args.referenceImageUrl !== undefined ? { referenceImageUrl: args.referenceImageUrl } : {}),
+    };
+}
+export function buildSoundBody(args) {
+    const durationSeconds = parseNumberFlag('duration', args.duration, { min: 0.5, max: 22 });
+    const promptInfluence = parseNumberFlag('prompt-influence', args.promptInfluence, { min: 0, max: 1 });
+    return {
+        prompt: args.prompt,
+        ...(durationSeconds !== undefined ? { durationSeconds } : {}),
+        ...(promptInfluence !== undefined ? { promptInfluence } : {}),
+        ...(args.loop !== undefined ? { loop: args.loop } : {}),
+    };
+}
+export function buildImageBody(args) {
+    const width = parseNumberFlag('width', args.width, { min: 1, integer: true });
+    const height = parseNumberFlag('height', args.height, { min: 1, integer: true });
+    return {
+        name: args.name,
+        prompt: args.prompt,
+        ...(width !== undefined ? { width } : {}),
+        ...(height !== undefined ? { height } : {}),
+        ...(args.referenceImageUrl !== undefined ? { referenceImageUrl: args.referenceImageUrl } : {}),
+    };
+}
+export function buildCharacterBody(args) {
+    const headScale = parseNumberFlag('head-scale', args.headScale, { min: 50, max: 300 });
+    return {
+        name: args.name,
+        prompt: args.prompt,
+        ...(args.applyToPlayer !== undefined ? { applyToPlayer: args.applyToPlayer } : {}),
+        ...(headScale !== undefined ? { headScale } : {}),
+    };
+}
+export function buildAnimationBody(args) {
+    const length = parseNumberFlag('length', args.length);
+    const cfgScale = parseNumberFlag('cfg-scale', args.cfgScale);
+    const seed = parseNumberFlag('seed', args.seed);
+    return {
+        description: args.description,
+        ...(length !== undefined ? { length } : {}),
+        ...(cfgScale !== undefined ? { cfgScale } : {}),
+        ...(seed !== undefined ? { seed } : {}),
+        ...(args.footIk !== undefined ? { footIk: args.footIk } : {}),
+        ...(args.inPlace !== undefined ? { inPlace: args.inPlace } : {}),
+        ...(args.loop !== undefined ? { loop: args.loop } : {}),
+    };
+}
+function defaultDeps() {
+    return {
+        fetch: globalThis.fetch,
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+        log: (message) => console.log(message),
+    };
+}
+/**
+ * Everything up to and including the network round-trip: resolves the project, the world.json
+ * path, and an access token, then calls the generator. Split out from `runAssetGeneration` so
+ * that function can wrap exactly this span in one try/catch — every error surfaced from in here
+ * happened strictly before any patch could have arrived.
+ */
+async function requestAssetGeneration(type, body, deps) {
+    const context = loadProjectContext(deps.startDir);
+    // The 'work' alias is the scaffold's one source of truth for where the creator's game (and its
+    // world.json) lives — see scaffold/aliases.ts. Hardcoding 'src/work' here would be a second
+    // source of truth that silently drifts if the scaffold layout ever moves.
+    const worldPath = path.join(context.root, aliasSourceDir('work'), 'world.json');
+    const environment = resolveEnvironment({ storedDefault: readDefaultEnvironment(deps.baseDir) });
+    const clientId = resolveAuth0ClientId(environment);
+    const token = await getAccessToken(environment, clientId, { fetch: deps.fetch, sleep: deps.sleep, now: deps.now }, deps.baseDir);
+    const requestBody = { gameId: context.metadata.gameId, ...body };
+    const outcome = await requestGeneration(environment, token, type, requestBody, {
+        fetch: deps.fetch,
+        onProgress: deps.log,
+    });
+    return { outcome, worldPath };
+}
+/**
+ * Runs one `bitmagic generate <subcommand>`: requests the asset, then applies the returned
+ * patches to world.json. Every failure path says explicitly whether world.json changed, because
+ * a creator (or the agent driving this CLI) who does not know has to go look for themselves:
+ *
+ *  - Anything that fails before a `result`/`error` frame arrives (auth, ownership, spark balance,
+ *    a network error, ...) — world.json is untouched; the message says so.
+ *  - A terminal `success: false` outcome — asset-core's `fail()` always carries an empty patch
+ *    array (see shared/asset-core/src/result.ts), so this is also an unchanged world.json.
+ *  - A successful outcome whose patches could not be written (a corrupt world.json, an
+ *    unrecognised patch shape) — distinct from the above: the Forger may already have billed for
+ *    this generation, so the message says the asset was NOT lost, only not yet applied.
+ */
+export async function runAssetGeneration(type, label, body, deps = defaultDeps()) {
+    let result;
+    try {
+        result = await requestAssetGeneration(type, body, deps);
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            throw new CliError(`${error.message} world.json is unchanged.`);
+        }
+        throw error;
+    }
+    const { outcome, worldPath } = result;
+    if (!outcome.success) {
+        throw new CliError(`${outcome.message} world.json is unchanged.`);
+    }
+    let applyResult;
+    try {
+        applyResult = applyPatchesToWorld(worldPath, outcome.patches);
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            throw new CliError(`Generated ${label} successfully, but could not write it into world.json: ${error.message} ` +
+                'world.json is unchanged — the asset was generated (and may have been billed) but is not yet in your project.');
+        }
+        throw error;
+    }
+    deps.log(`Generated ${label}: ${outcome.message}`);
+    for (const line of applyResult.summary) {
+        deps.log(`  - ${line}`);
+    }
+    deps.log(`world.json updated (${applyResult.applied} patch${applyResult.applied === 1 ? '' : 'es'}).`);
+    deps.log('If `bitmagic dev` is running, reload the browser tab to see the change.');
+}
+// ============================================================================
+// Subcommands
+// ============================================================================
+// Multi-word flags are declared with their kebab-case spelling as the literal arg key (rather
+// than relying on citty's automatic camelCase<->kebab-case aliasing) so that `--help` — an
+// agent's actual discovery mechanism for what it can ask for — prints exactly the flag spelling
+// documented for this command, instead of the camelCase form citty would show by default.
+// Reading them back out of `args` below therefore uses the same kebab-case bracket key.
+const skyboxCommand = defineCommand({
+    meta: { name: 'skybox', description: 'Generate a 360° skybox and apply it to world.json.' },
+    args: {
+        description: {
+            type: 'string',
+            required: true,
+            description: 'Description of the skybox environment.',
+        },
+        'reference-image-url': {
+            type: 'string',
+            description: 'Style/composition reference image URL forwarded to the image model.',
+        },
+    },
+    async run({ args }) {
+        const body = buildSkyboxBody({
+            description: args.description,
+            referenceImageUrl: args['reference-image-url'],
+        });
+        await runAssetGeneration('skybox', 'skybox', body);
+    },
+});
+const soundCommand = defineCommand({
+    meta: { name: 'sound', description: 'Generate a sound effect and add it to world.json assets.' },
+    args: {
+        prompt: {
+            type: 'string',
+            required: true,
+            description: 'Text describing the SFX to generate.',
+        },
+        duration: {
+            type: 'string',
+            description: 'Length in seconds, 0.5-22; upstream auto-picks when omitted.',
+        },
+        'prompt-influence': {
+            type: 'string',
+            description: 'How tightly to follow the prompt, 0-1.',
+        },
+        loop: {
+            type: 'boolean',
+            description: 'Ask upstream for a seamlessly loopable SFX.',
+        },
+    },
+    async run({ args }) {
+        const body = buildSoundBody({
+            prompt: args.prompt,
+            duration: args.duration,
+            promptInfluence: args['prompt-influence'],
+            loop: args.loop,
+        });
+        // The type on the wire is 'sound-effect' (see api-server/src/cli/cli-assets.ts's generator
+        // registry); the subcommand is named 'sound' for brevity, so these deliberately differ.
+        await runAssetGeneration('sound-effect', 'sound effect', body);
+    },
+});
+const imageCommand = defineCommand({
+    meta: { name: 'image', description: 'Generate an image asset and add it to world.json assets.' },
+    args: {
+        name: {
+            type: 'string',
+            required: true,
+            description: 'Unique asset name.',
+        },
+        prompt: {
+            type: 'string',
+            required: true,
+            description: 'Text description of the image to generate.',
+        },
+        width: {
+            type: 'string',
+            description: 'Image width in pixels. Omit to use the generator default.',
+        },
+        height: {
+            type: 'string',
+            description: 'Image height in pixels. Omit to use the generator default.',
+        },
+        'reference-image-url': {
+            type: 'string',
+            description: 'Style/composition reference image URL forwarded to the image model.',
+        },
+    },
+    async run({ args }) {
+        const body = buildImageBody({
+            name: args.name,
+            prompt: args.prompt,
+            width: args.width,
+            height: args.height,
+            referenceImageUrl: args['reference-image-url'],
+        });
+        await runAssetGeneration('image', 'image asset', body);
+    },
+});
+const characterCommand = defineCommand({
+    meta: { name: 'character', description: 'Generate a rigged character and add it to world.json assets.' },
+    args: {
+        name: {
+            type: 'string',
+            required: true,
+            description: 'Unique name for the character.',
+        },
+        prompt: {
+            type: 'string',
+            required: true,
+            description: 'Description of the character.',
+        },
+        'apply-to-player': {
+            type: 'boolean',
+            description: 'Set this character as the PLAYER. Omit to use the generator default (true).',
+        },
+        'head-scale': {
+            type: 'string',
+            description: 'Head size as a percentage of normal, 50-300. Omit to use the generator default.',
+        },
+    },
+    async run({ args }) {
+        const body = buildCharacterBody({
+            name: args.name,
+            prompt: args.prompt,
+            applyToPlayer: args['apply-to-player'],
+            headScale: args['head-scale'],
+        });
+        await runAssetGeneration('character', 'character', body);
+    },
+});
+const animationCommand = defineCommand({
+    meta: { name: 'animation', description: 'Generate an animation clip and add it to world.json assets.' },
+    args: {
+        description: {
+            type: 'string',
+            required: true,
+            description: 'Simple action phrase describing the animation, e.g. "a person swimming slowly".',
+        },
+        length: {
+            type: 'string',
+            description: 'Animation length in seconds. Omit to use the generator default.',
+        },
+        'cfg-scale': {
+            type: 'string',
+            description: 'Classifier-free guidance scale; higher follows the prompt more closely. Omit to use the generator default.',
+        },
+        seed: {
+            type: 'string',
+            description: 'Random seed for reproducibility. Omit for random results.',
+        },
+        'foot-ik': {
+            type: 'boolean',
+            // The generator schema defaults footIk to true; the negative form is the only one worth
+            // documenting since the positive is already the default. citty auto-derives --no-foot-ik
+            // for any boolean flag; `negativeDescription` just makes --help show it without us having
+            // to also restate `default: true` here (which would defeat "omit when absent").
+            negativeDescription: 'Disable foot IK — use for airborne animations like jumping.',
+        },
+        'in-place': {
+            type: 'boolean',
+            description: 'Keep the character in place, e.g. for idle animations.',
+        },
+        loop: {
+            type: 'boolean',
+            description: 'Whether the animation should loop continuously.',
+        },
+    },
+    async run({ args }) {
+        const body = buildAnimationBody({
+            description: args.description,
+            length: args.length,
+            cfgScale: args['cfg-scale'],
+            seed: args.seed,
+            footIk: args['foot-ik'],
+            inPlace: args['in-place'],
+            loop: args.loop,
+        });
+        await runAssetGeneration('animation', 'animation', body);
+    },
+});
+export const generateCommand = defineCommand({
+    meta: {
+        name: 'generate',
+        description: 'Generate a game asset from your own agent tool and apply it to world.json.',
+    },
+    subCommands: {
+        skybox: skyboxCommand,
+        sound: soundCommand,
+        image: imageCommand,
+        character: characterCommand,
+        animation: animationCommand,
+    },
+});
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,23 @@
+export declare const initCommand: import("citty").CommandDef<{
+    readonly dir: {
+        readonly type: "positional";
+        readonly required: false;
+        readonly description: "Directory to create the project in.";
+    };
+    readonly template: {
+        readonly type: "string";
+        readonly description: "Template id (see templates in the engine bundle).";
+    };
+    readonly name: {
+        readonly type: "string";
+        readonly description: "Game name.";
+    };
+    readonly env: {
+        readonly type: "string";
+        readonly description: "Environment (dev, prod, local).";
+    };
+    readonly force: {
+        readonly type: "boolean";
+        readonly description: "Scaffold into a non-empty directory.";
+    };
+}>;

package/dist/commands/init.js

@@ -0,0 +1,123 @@
+import { defineCommand } from 'citty';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { spawnSync } from 'child_process';
+import { CliError } from '../errors.js';
+import { resolveEnvironment, resolveAuth0ClientId } from '../config/environments.js';
+import { readDefaultEnvironment } from '../config/credentials.js';
+import { getAccessToken } from '../auth/session.js';
+import { apiPost } from '../http/client.js';
+import { fetchEngineManifest, downloadAndVerify, extractEngine } from '../scaffold/engine-download.js';
+import { resolveTemplate, scaffoldProject } from '../scaffold/project.js';
+const deps = {
+    fetch: globalThis.fetch,
+    sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+};
+/** Throws a CliError naming the directory if it exists, is non-empty, and `force` was not given. */
+function assertScaffoldable(dir, force) {
+    if (force)
+        return;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT') {
+            // Directory doesn't exist yet: nothing to protect against.
+            return;
+        }
+        throw new CliError(`Cannot read directory ${dir}: ${code ?? String(err)}`);
+    }
+    if (entries.length > 0) {
+        throw new CliError(`${dir} already exists and is not empty. Pass --force to scaffold into it anyway.`);
+    }
+}
+/**
+ * `npm install` is the least reliable step: network flakiness or a broken local npm config are
+ * common and have nothing to do with whether the scaffold itself is correct. Its failure must
+ * not be reported as a scaffold failure — the project on disk is already complete and valid,
+ * only its dependencies are missing. Returns whether it succeeded so callers can adjust what
+ * they tell the creator to do next — `bitmagic check` cannot run without node_modules.
+ */
+function installDependencies(dir) {
+    const result = spawnSync('npm', ['install'], { cwd: dir, stdio: 'inherit' });
+    if (result.error || result.status !== 0) {
+        console.warn('Warning: `npm install` failed. The project was scaffolded successfully — only its ' +
+            `dependencies are missing. cd into ${dir} and run \`npm install\` yourself.`);
+        return false;
+    }
+    return true;
+}
+function printNextSteps(dir, gameId, installSucceeded) {
+    console.log('');
+    console.log(`Created ${dir} (game ${gameId}).`);
+    console.log('');
+    console.log('Next steps:');
+    console.log(`  cd ${dir}`);
+    if (installSucceeded) {
+        console.log('  bitmagic check');
+    }
+    else {
+        console.log('  npm install');
+        console.log('  bitmagic check');
+    }
+}
+export const initCommand = defineCommand({
+    meta: { name: 'init', description: 'Scaffold a new Bitmagic game project.' },
+    args: {
+        dir: { type: 'positional', required: false, description: 'Directory to create the project in.' },
+        template: { type: 'string', description: 'Template id (see templates in the engine bundle).' },
+        name: { type: 'string', description: 'Game name.' },
+        env: { type: 'string', description: 'Environment (dev, prod, local).' },
+        force: { type: 'boolean', description: 'Scaffold into a non-empty directory.' },
+    },
+    async run({ args }) {
+        const targetDir = path.resolve(args.dir ?? '.');
+        assertScaffoldable(targetDir, args.force === true);
+        const environment = resolveEnvironment({
+            explicit: args.env,
+            storedDefault: readDefaultEnvironment(),
+        });
+        const clientId = resolveAuth0ClientId(environment);
+        const token = await getAccessToken(environment, clientId, deps);
+        console.log('Fetching the engine manifest…');
+        const manifest = await fetchEngineManifest(environment, token, { fetch: globalThis.fetch });
+        const workDir = fs.mkdtempSync(path.join(os.tmpdir(), 'bitmagic-init-'));
+        try {
+            const tarballPath = path.join(workDir, 'engine.tar.gz');
+            console.log(`Downloading engine ${manifest.version}…`);
+            await downloadAndVerify(manifest.tarballUrl, manifest.sha256, tarballPath, {
+                fetch: globalThis.fetch,
+            });
+            const extracted = path.join(workDir, 'extracted');
+            const templatesDir = path.join(workDir, 'templates');
+            await extractEngine(tarballPath, extracted, templatesDir);
+            const template = resolveTemplate(templatesDir, args.template);
+            // Minted only after the engine is in hand: a failed download must not leave an orphaned,
+            // unreachable game row behind.
+            const projectName = args.name ?? path.basename(targetDir);
+            const created = await apiPost(environment, '/api/cli/v1/games', token, { genre: template.genre, name: projectName }, { fetch: globalThis.fetch });
+            scaffoldProject({
+                targetDir,
+                extractedEngineDir: extracted,
+                templatesDir,
+                template,
+                metadata: {
+                    gameId: created.gameId,
+                    engineVersion: manifest.version,
+                    genre: template.genre,
+                    template: template.id,
+                },
+                projectName,
+            });
+            const installSucceeded = installDependencies(targetDir);
+            printNextSteps(targetDir, created.gameId, installSucceeded);
+        }
+        finally {
+            fs.rmSync(workDir, { recursive: true, force: true });
+        }
+    },
+});
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE1E,MAAM,IAAI,GAAG;IACX,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;CAC/E,CAAC;AAMF,oGAAoG;AACpG,SAAS,kBAAkB,CAAC,GAAW,EAAE,KAAc;IACrD,IAAI,KAAK;QAAE,OAAO;IAClB,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAC;QAC7C,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,2DAA2D;YAC3D,OAAO;QACT,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,yBAAyB,GAAG,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAChB,GAAG,GAAG,4EAA4E,CACnF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,GAAW;IACtC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7E,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CACV,oFAAoF;YAClF,qCAAqC,GAAG,oCAAoC,CAC/E,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,GAAW,EAAE,MAAc,EAAE,gBAAyB;IAC5E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,UAAU,MAAM,IAAI,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;IAC3B,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,uCAAuC,EAAE;IAC5E,IAAI,EAAE;QACJ,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,qCAAqC,EAAE;QAChG,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mDAAmD,EAAE;QAC9F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;QACnD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;QACvE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;KAChF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;QAChD,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;QAEnD,MAAM,WAAW,GAAG,kBAAkB,CAAC;YACrC,QAAQ,EAAE,IAAI,CAAC,GAAG;YAClB,aAAa,EAAE,sBAAsB,EAAE;SACxC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEhE,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;QAE5F,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,sBAAsB,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC;YACvD,MAAM,iBAAiB,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE;gBACzE,KAAK,EAAE,UAAU,CAAC,KAAK;aACxB,CAAC,CAAC;YAEH,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAClD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACrD,MAAM,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;YAC1D,MAAM,QAAQ,GAAG,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAE9D,yFAAyF;YACzF,+BAA+B;YAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,MAAM,OAAO,CAC3B,WAAW,EACX,mBAAmB,EACnB,KAAK,EACL,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAC5C,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAC5B,CAAC;YAEF,eAAe,CAAC;gBACd,SAAS;gBACT,kBAAkB,EAAE,SAAS;gBAC7B,YAAY;gBACZ,QAAQ;gBACR,QAAQ,EAAE;oBACR,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,aAAa,EAAE,QAAQ,CAAC,OAAO;oBAC/B,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,QAAQ,EAAE,QAAQ,CAAC,EAAE;iBACtB;gBACD,WAAW;aACZ,CAAC,CAAC;YAEH,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;YACxD,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAC9D,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/login.d.ts

@@ -0,0 +1,6 @@
+export declare const loginCommand: import("citty").CommandDef<{
+    readonly env: {
+        readonly type: "string";
+        readonly description: "Environment to log in to (dev, prod, local).";
+    };
+}>;

package/dist/commands/login.js

@@ -0,0 +1,36 @@
+import { defineCommand } from 'citty';
+import { resolveEnvironment, resolveAuth0ClientId } from '../config/environments.js';
+import { writeCredentials, writeDefaultEnvironment, readDefaultEnvironment } from '../config/credentials.js';
+import { requestDeviceCode, pollForToken } from '../auth/device-flow.js';
+import { runWhoami } from './whoami.js';
+const deps = {
+    fetch: globalThis.fetch,
+    sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+};
+export const loginCommand = defineCommand({
+    meta: { name: 'login', description: 'Authenticate with Bitmagic via your browser.' },
+    args: {
+        env: { type: 'string', description: 'Environment to log in to (dev, prod, local).' },
+    },
+    async run({ args }) {
+        const environment = resolveEnvironment({
+            explicit: args.env,
+            storedDefault: readDefaultEnvironment(),
+        });
+        const clientId = resolveAuth0ClientId(environment);
+        const grant = await requestDeviceCode(environment, clientId, deps);
+        // Always print the URL: agent tools frequently run without a browser.
+        console.log(`Open:  ${grant.verificationUriComplete}`);
+        console.log(`Code:  ${grant.userCode}`);
+        console.log('Waiting for approval…');
+        const credentials = await pollForToken(environment, clientId, grant, deps);
+        writeCredentials(environment.name, credentials);
+        writeDefaultEnvironment(environment.name);
+        // Prove the login rather than assuming it: a token Auth0 accepted is not the same as an
+        // account api-server accepts with the Admin role.
+        const me = await runWhoami(environment.name);
+        console.log(`Logged in to ${environment.name} as ${me.userId}.`);
+        console.log(`roles: ${me.roles.length > 0 ? me.roles.join(', ') : '(none)'}`);
+    },
+});
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC7G,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,IAAI,GAAG;IACX,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;CAC/E,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;IACxC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,8CAA8C,EAAE;IACpF,IAAI,EAAE;QACJ,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;KACrF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,WAAW,GAAG,kBAAkB,CAAC;YACrC,QAAQ,EAAE,IAAI,CAAC,GAAG;YAClB,aAAa,EAAE,sBAAsB,EAAE;SACxC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAEnD,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEnE,sEAAsE;QACtE,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,uBAAuB,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QAErC,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC3E,gBAAgB,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAChD,uBAAuB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAE1C,wFAAwF;QACxF,kDAAkD;QAClD,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,gBAAgB,WAAW,CAAC,IAAI,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChF,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/logout.d.ts

@@ -0,0 +1,6 @@
+export declare const logoutCommand: import("citty").CommandDef<{
+    readonly env: {
+        readonly type: "string";
+        readonly description: "Environment to log out of (dev, prod, local).";
+    };
+}>;

package/dist/commands/logout.js

@@ -0,0 +1,18 @@
+import { defineCommand } from 'citty';
+import { resolveEnvironment } from '../config/environments.js';
+import { clearCredentials, readDefaultEnvironment } from '../config/credentials.js';
+export const logoutCommand = defineCommand({
+    meta: { name: 'logout', description: 'Remove stored credentials for an environment.' },
+    args: {
+        env: { type: 'string', description: 'Environment to log out of (dev, prod, local).' },
+    },
+    run({ args }) {
+        const environment = resolveEnvironment({
+            explicit: args.env,
+            storedDefault: readDefaultEnvironment(),
+        });
+        clearCredentials(environment.name);
+        console.log(`Logged out of ${environment.name}.`);
+    },
+});
+//# sourceMappingURL=logout.js.map

package/dist/commands/logout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;IACtF,IAAI,EAAE;QACJ,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;KACtF;IACD,GAAG,CAAC,EAAE,IAAI,EAAE;QACV,MAAM,WAAW,GAAG,kBAAkB,CAAC;YACrC,QAAQ,EAAE,IAAI,CAAC,GAAG;YAClB,aAAa,EAAE,sBAAsB,EAAE;SACxC,CAAC,CAAC;QACH,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,iBAAiB,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/verify.d.ts

@@ -0,0 +1,6 @@
+export declare const verifyCommand: import("citty").CommandDef<{
+    readonly timeout: {
+        readonly type: "string";
+        readonly description: "Settle time in ms (default 15000).";
+    };
+}>;