@contenthero/cli 0.1.0

package/dist/commands/post.js

@@ -0,0 +1,267 @@
+/**
+ * `contenthero post` - the content pipeline (posts, destinations, assets).
+ *   post list | get | create | update | archive | schedule | publish
+ *   post destination add | update
+ *   post asset add
+ *
+ * A post is the container: create it, attach destinations (platforms) and assets
+ * (media URLs), then schedule or publish. Stages accept an id, slug, or name and
+ * resolve server-side. Writes need pipeline:write (assets need assets:write,
+ * publish needs publish:write); the key's scopes are the consent.
+ */
+import { makeClient } from '../context.js';
+import { emit, keyValues, table } from '../output.js';
+import { CliError, EXIT } from '../errors.js';
+import { compact } from '../generation.js';
+import { toInt } from '../args.js';
+const PLATFORMS = [
+    'youtube',
+    'instagram',
+    'tiktok',
+    'facebook',
+    'linkedin',
+    'x',
+    'threads',
+    'general',
+];
+const STATUSES = ['draft', 'active', 'completed', 'archived'];
+const CLEAR = ['null', 'clear', 'none'];
+function assertPlatform(value) {
+    if (value && !PLATFORMS.includes(value)) {
+        throw new CliError(`Invalid platform "${value}". Expected one of: ${PLATFORMS.join(', ')}.`, EXIT.USAGE);
+    }
+}
+function assertStatus(value) {
+    if (value && !STATUSES.includes(value)) {
+        throw new CliError(`Invalid status "${value}". Expected one of: ${STATUSES.join(', ')}.`, EXIT.USAGE);
+    }
+}
+function summaryHuman(p, action) {
+    return keyValues([
+        ...(action ? [[action, p.title]] : [['Title', p.title]]),
+        ['Id', p.id],
+        ['Status', p.status],
+        ['Platform', p.platform ?? ''],
+        ...(p.scheduledAt ? [['Scheduled', p.scheduledAt]] : []),
+        ...(p.publishedAt ? [['Published', p.publishedAt]] : []),
+    ]);
+}
+function destinationHuman(d) {
+    return keyValues([
+        ['Destination', d.id],
+        ['Platform', d.platform ?? ''],
+        ['Format', d.format ?? ''],
+        ['Connected account', d.connectedAccountId ?? '(none)'],
+        ['Status', d.status ?? ''],
+        ...(d.scheduledAt ? [['Scheduled', d.scheduledAt]] : []),
+    ]);
+}
+export function registerPost(program) {
+    const post = program.command('post').description('Content pipeline: posts, destinations, assets');
+    post
+        .command('list')
+        .description('List posts (newest-updated first)')
+        .option('--status <status>', `filter by status: ${STATUSES.join(', ')}`)
+        .option('--platform <platform>', 'filter by platform')
+        .option('--stage <stage>', 'filter by pipeline stage (id, slug, or name)')
+        .option('--search <text>', 'case-insensitive title search')
+        .option('--favorite', 'only favorited posts')
+        .option('--limit <n>', 'how many to return (default 50)', toInt)
+        .option('--offset <n>', 'pagination offset', toInt)
+        .action(async (opts, command) => {
+        assertStatus(opts.status);
+        assertPlatform(opts.platform);
+        const { client, ctx } = makeClient(command);
+        const result = await client.listPosts({
+            status: opts.status,
+            platform: opts.platform,
+            pipelineStage: opts.stage,
+            search: opts.search,
+            isFavorite: opts.favorite === true ? true : undefined,
+            limit: opts.limit,
+            offset: opts.offset,
+        });
+        emit(result, ctx, (r) => {
+            const t = table(['ID', 'STATUS', 'PLATFORM', 'TITLE'], r.posts.map((p) => [p.id.slice(0, 8), p.status, p.platform ?? '', p.title]));
+            return `${t}\n\n${r.posts.length} of ${r.total}${r.hasMore ? ' (more available)' : ''}`;
+        });
+    });
+    post
+        .command('get')
+        .description('Get one post with its destinations and assets')
+        .argument('<id>', 'the post id')
+        .action(async (id, _opts, command) => {
+        const { client, ctx } = makeClient(command);
+        const p = await client.getPost(id);
+        emit(p, ctx, (post) => {
+            const head = keyValues([
+                ['Title', post.title],
+                ['Id', post.id],
+                ['Status', post.status],
+                ['Platform', post.platform ?? ''],
+                ...(post.scheduledAt ? [['Scheduled', post.scheduledAt]] : []),
+                ...(post.description ? [['Description', post.description]] : []),
+            ]);
+            const dests = post.destinations.length
+                ? '\n\nDestinations:\n' +
+                    table(['PLATFORM', 'FORMAT', 'ACCOUNT', 'STATUS'], post.destinations.map((d) => [
+                        d.platform ?? '',
+                        d.format ?? '',
+                        d.connectedAccountId ?? '',
+                        d.status ?? '',
+                    ]))
+                : '';
+            const assets = post.assets.length
+                ? '\n\nAssets:\n' +
+                    table(['TYPE', 'NAME', 'URL'], post.assets.map((a) => [a.assetType ?? '', a.displayName ?? '', a.assetUrl ?? '']))
+                : '';
+            return head + dests + assets;
+        });
+    });
+    post
+        .command('create')
+        .description('Create a post (requires pipeline:write)')
+        .argument('<title>', 'post title')
+        .requiredOption('--platform <platform>', `primary platform: ${PLATFORMS.join(', ')}`)
+        .option('--description <text>', 'description / caption draft')
+        .option('--stage <stage>', 'pipeline stage id, slug, or name (defaults to the first stage)')
+        .action(async (title, opts, command) => {
+        assertPlatform(opts.platform);
+        const { client, ctx } = makeClient(command);
+        const input = compact({
+            title,
+            platform: opts.platform,
+            description: opts.description,
+            stage: opts.stage,
+        });
+        emit(await client.createPost(input), ctx, (p) => summaryHuman(p, 'Created'));
+    });
+    post
+        .command('update')
+        .description("Update a post's fields, including its pipeline stage (requires pipeline:write)")
+        .argument('<id>', 'the post id')
+        .option('--title <text>')
+        .option('--description <text>')
+        .option('--platform <platform>')
+        .option('--status <status>')
+        .option('--stage <stage>', 'move the post to this stage (id, slug, or name)')
+        .option('--script <text>')
+        .option('--notes <text>')
+        .action(async (id, opts, command) => {
+        assertPlatform(opts.platform);
+        assertStatus(opts.status);
+        const { client, ctx } = makeClient(command);
+        const input = compact({
+            title: opts.title,
+            description: opts.description,
+            platform: opts.platform,
+            status: opts.status,
+            stage: opts.stage,
+            script: opts.script,
+            notes: opts.notes,
+        });
+        emit(await client.updatePost(id, input), ctx, (p) => summaryHuman(p, 'Updated'));
+    });
+    post
+        .command('archive')
+        .description('Archive a post (status -> archived; reversible)')
+        .argument('<id>', 'the post id')
+        .action(async (id, _opts, command) => {
+        const { client, ctx } = makeClient(command);
+        emit(await client.archivePost(id), ctx, (p) => summaryHuman(p, 'Archived'));
+    });
+    post
+        .command('schedule')
+        .description('Set or clear the scheduled publish time on a post and its destinations')
+        .argument('<id>', 'the post id')
+        .argument('<when>', 'ISO-8601 timestamp, or "clear" to unschedule')
+        .action(async (id, when, _opts, command) => {
+        const { client, ctx } = makeClient(command);
+        const scheduledAt = CLEAR.includes(when.toLowerCase()) ? null : when;
+        emit(await client.schedulePost(id, scheduledAt), ctx, (p) => summaryHuman(p, scheduledAt ? 'Scheduled' : 'Unscheduled'));
+    });
+    post
+        .command('publish')
+        .description('Publish a post NOW to its destinations (requires publish:write; pushes to live socials)')
+        .argument('<id>', 'the post id')
+        .option('--platform <platform>', 'publish only this platform (default: all destinations)')
+        .action(async (id, opts, command) => {
+        assertPlatform(opts.platform);
+        const { client, ctx } = makeClient(command);
+        const result = await client.publishPost(id, { platform: opts.platform });
+        emit(result, ctx, (r) => {
+            const t = table(['PLATFORM', 'OK', 'URL / ERROR'], r.results.map((d) => [d.platform, d.success ? 'yes' : 'no', d.url ?? d.error ?? '']));
+            return `${t}\n\nPublished ${r.publishedCount}, failed ${r.failedCount}`;
+        });
+        if (result.failedCount > 0)
+            process.exitCode = EXIT.GENERAL;
+    });
+    // -- post destination -----------------------------------------------------
+    const destination = post.command('destination').description('Manage a post\'s publish destinations');
+    destination
+        .command('add')
+        .description('Attach (or replace) a destination on a post (requires pipeline:write)')
+        .argument('<postId>', 'the post id')
+        .requiredOption('--platform <platform>', `destination platform: ${PLATFORMS.join(', ')}`)
+        .option('--format <format>', "platform format, e.g. post, reel, story, short, thread")
+        .option('--account <id>', 'connected account id (from `connected-account list`)')
+        .option('--scheduled <iso>', 'ISO-8601 scheduled time for this destination')
+        .action(async (postId, opts, command) => {
+        assertPlatform(opts.platform);
+        const { client, ctx } = makeClient(command);
+        const d = await client.addPostDestination(postId, {
+            platform: opts.platform,
+            format: opts.format,
+            connectedAccountId: opts.account,
+            scheduledAt: opts.scheduled,
+        });
+        emit(d, ctx, destinationHuman);
+    });
+    destination
+        .command('update')
+        .description('Update one of a post\'s destinations (requires pipeline:write)')
+        .argument('<postId>', 'the post id')
+        .argument('<destinationId>', 'the destination id (from `post get`)')
+        .option('--format <format>')
+        .option('--account <id>', 'connected account id')
+        .option('--scheduled <iso>', 'ISO-8601 scheduled time')
+        .option('--status <status>')
+        .action(async (postId, destinationId, opts, command) => {
+        const { client, ctx } = makeClient(command);
+        const d = await client.updatePostDestination(postId, destinationId, {
+            format: opts.format,
+            connectedAccountId: opts.account,
+            scheduledAt: opts.scheduled,
+            status: opts.status,
+        });
+        emit(d, ctx, destinationHuman);
+    });
+    // -- post asset -----------------------------------------------------------
+    const asset = post.command('asset').description('Manage a post\'s assets');
+    asset
+        .command('add')
+        .description('Attach an asset to a post by URL (requires assets:write)')
+        .argument('<postId>', 'the post id')
+        .requiredOption('--type <type>', 'asset type: image, video, audio, document, link')
+        .requiredOption('--url <url>', 'public URL of the asset')
+        .option('--name <name>', 'optional display name')
+        .action(async (postId, opts, command) => {
+        const types = ['image', 'video', 'audio', 'document', 'link'];
+        if (!types.includes(opts.type)) {
+            throw new CliError(`Invalid --type "${opts.type}". Expected one of: ${types.join(', ')}.`, EXIT.USAGE);
+        }
+        const { client, ctx } = makeClient(command);
+        const a = await client.addPostAsset(postId, {
+            assetType: opts.type,
+            assetUrl: opts.url,
+            displayName: opts.name,
+        });
+        emit(a, ctx, () => keyValues([
+            ['Asset', a.id],
+            ['Type', a.assetType ?? ''],
+            ['Name', a.displayName ?? ''],
+            ['URL', a.assetUrl ?? ''],
+        ]));
+    });
+}
+//# sourceMappingURL=post.js.map

package/dist/commands/post.js.map

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

package/dist/commands/schema.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `contenthero schema [command...]` - dump the input schema of the CLI's commands
+ * as JSON, so an agent can discover argument and option shapes without docs (our
+ * analog to HeyGen's `--request-schema`). With no argument it dumps every leaf
+ * command; with a path (e.g. `schema generate image`) it dumps just that subtree.
+ *
+ * Needs no API key: it reflects over the command tree, it does not call the API.
+ */
+import type { Command } from 'commander';
+export declare function registerSchema(program: Command): void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/commands/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAqEhD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4BrD"}

package/dist/commands/schema.js

@@ -0,0 +1,82 @@
+/**
+ * `contenthero schema [command...]` - dump the input schema of the CLI's commands
+ * as JSON, so an agent can discover argument and option shapes without docs (our
+ * analog to HeyGen's `--request-schema`). With no argument it dumps every leaf
+ * command; with a path (e.g. `schema generate image`) it dumps just that subtree.
+ *
+ * Needs no API key: it reflects over the command tree, it does not call the API.
+ */
+import { globalsOf } from '../context.js';
+import { emit } from '../output.js';
+import { CliError, EXIT } from '../errors.js';
+/** Subcommands minus the auto-added `help`. */
+function realSubcommands(cmd) {
+    return cmd.commands.filter((c) => c.name() !== 'help');
+}
+function describeOption(o) {
+    const schema = {
+        flags: o.flags,
+        required: o.mandatory === true,
+        takesValue: o.required === true || o.optional === true,
+    };
+    if (o.description)
+        schema.description = o.description;
+    if (o.defaultValue !== undefined)
+        schema.default = o.defaultValue;
+    return schema;
+}
+function describe(cmd, path) {
+    const args = (cmd.registeredArguments ?? []).map((a) => {
+        const schema = { name: a.name(), required: a.required, variadic: a.variadic };
+        if (a.description)
+            schema.description = a.description;
+        return schema;
+    });
+    return {
+        command: path,
+        description: cmd.description(),
+        arguments: args,
+        options: cmd.options.map(describeOption),
+    };
+}
+/** Collect every leaf (action-bearing) command, with its full space-joined path. */
+function collectLeaves(cmd, prefix) {
+    const out = [];
+    for (const sub of realSubcommands(cmd)) {
+        const path = [...prefix, sub.name()];
+        if (realSubcommands(sub).length === 0) {
+            out.push(describe(sub, path.join(' ')));
+        }
+        else {
+            out.push(...collectLeaves(sub, path));
+        }
+    }
+    return out;
+}
+export function registerSchema(program) {
+    program
+        .command('schema')
+        .description('Dump the input schema of the CLI commands as JSON (for agents)')
+        .argument('[command...]', 'a command path to scope the dump, e.g. "generate image"')
+        .action((parts, _opts, command) => {
+        const target = parts.join(' ');
+        const all = collectLeaves(program, []);
+        const commands = target
+            ? all.filter((c) => c.command === target || c.command.startsWith(target + ' '))
+            : all;
+        if (target && commands.length === 0) {
+            throw new CliError(`No command matches "${target}". Run \`contenthero schema\` for the full list.`, EXIT.USAGE);
+        }
+        const globalOptions = program.options.map(describeOption);
+        const data = { globalOptions, commands };
+        const { json } = globalsOf(command);
+        emit(data, { json }, (d) => d.commands
+            .map((c) => {
+            const argline = c.arguments.map((a) => (a.required ? `<${a.name}>` : `[${a.name}]`)).join(' ');
+            const opts = c.options.map((o) => `    ${o.flags}${o.description ? `  - ${o.description}` : ''}`);
+            return [`contenthero ${c.command}${argline ? ' ' + argline : ''}`, ...opts].join('\n');
+        })
+            .join('\n\n'));
+    });
+}
+//# sourceMappingURL=schema.js.map

package/dist/commands/schema.js.map

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

package/dist/commands/upscale.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `contenthero upscale <source>` - upscale an existing image or video.
+ *
+ * Whether the source is bucketed as an image or a video reference depends on the
+ * model, so we resolve the model's content type from the discovery catalog first
+ * (rather than asking the user to declare it). Video upscalers also price on the
+ * source duration, so --duration is required for them.
+ */
+import type { Command } from 'commander';
+export declare function registerUpscale(program: Command): void;
+//# sourceMappingURL=upscale.d.ts.map

package/dist/commands/upscale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upscale.d.ts","sourceRoot":"","sources":["../../src/commands/upscale.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AASxC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkDtD"}

package/dist/commands/upscale.js

@@ -0,0 +1,56 @@
+/**
+ * `contenthero upscale <source>` - upscale an existing image or video.
+ *
+ * Whether the source is bucketed as an image or a video reference depends on the
+ * model, so we resolve the model's content type from the discovery catalog first
+ * (rather than asking the user to declare it). Video upscalers also price on the
+ * source duration, so --duration is required for them.
+ */
+import { makeClient } from '../context.js';
+import { compact, runGeneration } from '../generation.js';
+import { CliError, EXIT } from '../errors.js';
+import { toFloat, toInt } from '../args.js';
+const DEFAULT_TIMEOUT_SEC = 600;
+export function registerUpscale(program) {
+    program
+        .command('upscale')
+        .description('Upscale an existing image or video to a higher resolution')
+        .argument('<source>', 'source media (URL or output id) to upscale')
+        .requiredOption('-m, --model <id>', 'upscale model id (see `contenthero model list`)')
+        .requiredOption('--factor <factor>', 'upscale factor, e.g. 2x, 4x (model-dependent)')
+        .option('--duration <seconds>', 'source video length in seconds (required for video upscalers)', toFloat)
+        .option('--cost', 'estimate the credit cost instead of upscaling')
+        .option('--no-wait', 'return the outputId immediately instead of waiting')
+        .option('--timeout <seconds>', 'how long to wait before handing back the outputId', toInt, DEFAULT_TIMEOUT_SEC)
+        .action(async (source, opts, command) => {
+        const { client, ctx } = makeClient(command);
+        // Resolve the model so we bucket the source correctly and validate it is
+        // actually an upscaler. listModels is the discovery source of truth.
+        const modelId = opts.model;
+        const models = await client.listModels();
+        const model = models.find((m) => m.modelId === modelId);
+        if (!model) {
+            throw new CliError(`Unknown model "${modelId}". See \`contenthero model list\`.`, EXIT.USAGE);
+        }
+        if (model.kind !== 'upscale') {
+            throw new CliError(`Model "${modelId}" is a ${model.kind} model, not an upscaler.`, EXIT.USAGE);
+        }
+        const isVideo = model.contentType === 'video';
+        if (isVideo && opts.duration == null) {
+            throw new CliError('Video upscalers require --duration <seconds> for pricing.', EXIT.USAGE);
+        }
+        const request = compact({
+            contentType: isVideo ? 'video' : 'image',
+            modelId,
+            upscaleFactor: opts.factor,
+            duration: isVideo ? opts.duration : undefined,
+            references: isVideo ? { videos: [source] } : { images: [source] },
+        });
+        await runGeneration(client, ctx, request, {
+            cost: opts.cost === true,
+            wait: opts.wait !== false,
+            timeoutSec: opts.timeout ?? DEFAULT_TIMEOUT_SEC,
+        });
+    });
+}
+//# sourceMappingURL=upscale.js.map

package/dist/commands/upscale.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * On-disk config + credential storage for the CLI.
+ *
+ * Two files under the config dir (default `~/.contenthero`, override with
+ * CONTENTHERO_CONFIG_DIR):
+ *   - `credentials`  : the stored API key (written by `contenthero login`).
+ *                      Mode 0600; it is the only secret on disk.
+ *   - `config.json`  : non-secret preferences (e.g. baseUrl).
+ *
+ * Reads tolerate a missing or malformed file by returning empty, so a fresh
+ * machine just falls through the auth ladder to env / flag. Writes create the
+ * dir at 0700 first.
+ */
+/** A stored credential. JSON so we can grow it (label, createdAt) without a format break. */
+export interface StoredCredential {
+    apiKey: string;
+    /** The key's display label, when minted via the browser flow (e.g. "CLI (host)"). */
+    label?: string;
+    /** ISO timestamp the credential was stored. */
+    createdAt?: string;
+}
+/** Non-secret CLI preferences. */
+export interface StoredConfig {
+    /** Override API base URL (e.g. a preview deployment). */
+    baseUrl?: string;
+}
+export declare function configDir(): string;
+export declare function credentialsPath(): string;
+export declare function configPath(): string;
+export declare function readCredential(): StoredCredential | undefined;
+export declare function writeCredential(cred: StoredCredential): void;
+export declare function clearCredential(): boolean;
+export declare function readConfig(): StoredConfig;
+export declare function writeConfig(config: StoredConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAkBD,wBAAgB,cAAc,IAAI,gBAAgB,GAAG,SAAS,CAE7D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAM5D;AAED,wBAAgB,eAAe,IAAI,OAAO,CAKzC;AAED,wBAAgB,UAAU,IAAI,YAAY,CAEzC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAGtD"}

package/dist/config.js

@@ -0,0 +1,68 @@
+/**
+ * On-disk config + credential storage for the CLI.
+ *
+ * Two files under the config dir (default `~/.contenthero`, override with
+ * CONTENTHERO_CONFIG_DIR):
+ *   - `credentials`  : the stored API key (written by `contenthero login`).
+ *                      Mode 0600; it is the only secret on disk.
+ *   - `config.json`  : non-secret preferences (e.g. baseUrl).
+ *
+ * Reads tolerate a missing or malformed file by returning empty, so a fresh
+ * machine just falls through the auth ladder to env / flag. Writes create the
+ * dir at 0700 first.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+export function configDir() {
+    return process.env.CONTENTHERO_CONFIG_DIR || join(homedir(), '.contenthero');
+}
+export function credentialsPath() {
+    return join(configDir(), 'credentials');
+}
+export function configPath() {
+    return join(configDir(), 'config.json');
+}
+function ensureDir() {
+    const dir = configDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+}
+function readJson(path) {
+    try {
+        if (!existsSync(path))
+            return undefined;
+        const raw = readFileSync(path, 'utf8').trim();
+        if (!raw)
+            return undefined;
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function readCredential() {
+    return readJson(credentialsPath());
+}
+export function writeCredential(cred) {
+    ensureDir();
+    const path = credentialsPath();
+    writeFileSync(path, JSON.stringify(cred, null, 2) + '\n', { mode: 0o600 });
+    // writeFileSync only applies mode on create; force it in case the file existed.
+    chmodSync(path, 0o600);
+}
+export function clearCredential() {
+    const path = credentialsPath();
+    if (!existsSync(path))
+        return false;
+    rmSync(path);
+    return true;
+}
+export function readConfig() {
+    return readJson(configPath()) ?? {};
+}
+export function writeConfig(config) {
+    ensureDir();
+    writeFileSync(configPath(), JSON.stringify(config, null, 2) + '\n', { mode: 0o644 });
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EACZ,MAAM,EACN,aAAa,GACd,MAAM,SAAS,CAAA;AAiBhB,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAA;AAC9E,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,CAAA;AACzC,CAAC;AAED,SAAS,SAAS;IAChB,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;AACxE,CAAC;AAED,SAAS,QAAQ,CAAI,IAAY;IAC/B,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAA;QACvC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;QAC7C,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAA;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,QAAQ,CAAmB,eAAe,EAAE,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAsB;IACpD,SAAS,EAAE,CAAA;IACX,MAAM,IAAI,GAAG,eAAe,EAAE,CAAA;IAC9B,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC1E,gFAAgF;IAChF,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAA;IAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IACnC,MAAM,CAAC,IAAI,CAAC,CAAA;IACZ,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,CAAe,UAAU,EAAE,CAAC,IAAI,EAAE,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,SAAS,EAAE,CAAA;IACX,aAAa,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;AACtF,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Per-invocation context: resolve global options, the API key, and the SDK client.
+ *
+ * Auth ladder (highest priority first):
+ *   1. --api-key flag
+ *   2. CONTENTHERO_API_KEY env
+ *   3. the stored credential file (written by `contenthero login`)
+ *
+ * Base URL ladder: --base-url flag, then CONTENTHERO_BASE_URL env, then the
+ * stored config, then the SDK default. The SDK reads the same env vars itself,
+ * but resolving here keeps the precedence explicit and lets us report the key
+ * source in `auth status` / `config list`.
+ */
+import { ContentHero } from '@contenthero/sdk';
+import type { Command } from 'commander';
+/** Where the active key came from (for diagnostics, never the key itself). */
+export type KeySource = 'flag' | 'env' | 'file' | 'none';
+/** Global options merged onto every command. */
+export interface GlobalOptions {
+    json: boolean;
+    human: boolean;
+    apiKey?: string;
+    baseUrl?: string;
+}
+/** The resolved invocation context. */
+export interface Context {
+    /** True when output should be raw JSON (the default). */
+    json: boolean;
+    apiKey?: string;
+    keySource: KeySource;
+    baseUrl?: string;
+}
+/** Read the merged global options off any command in the tree. */
+export declare function globalsOf(command: Command): GlobalOptions;
+/** Resolve the API key and where it came from, without constructing a client. */
+export declare function resolveContext(command: Command): Context;
+/**
+ * Build an authenticated SDK client for this command, or throw a CliError with
+ * the auth exit code when no key is configured anywhere in the ladder.
+ */
+export declare function makeClient(command: Command): {
+    client: ContentHero;
+    ctx: Context;
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAIxC,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAExD,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,uCAAuC;AACvC,MAAM,WAAW,OAAO;IACtB,yDAAyD;IACzD,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CASzD;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAuBxD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAUlF"}