@mrmtsu/mcms-cli 0.1.0

package/dist/commands/config.js

@@ -0,0 +1,63 @@
+import { canUseKeychain } from "../core/auth-store.js";
+import { getConfigPath, readConfig } from "../core/config.js";
+import { printSuccess } from "../core/output.js";
+import { contextFromCommand, getActionCommand } from "./utils.js";
+export function registerConfigCommands(program) {
+    const config = program.command("config").description("Inspect local CLI config");
+    config
+        .command("doctor")
+        .description("Show resolved auth/config sources and common risks")
+        .action(async (...actionArgs) => {
+        const command = getActionCommand(actionArgs);
+        const ctx = await contextFromCommand(command);
+        const keychainAvailable = await canUseKeychain();
+        const savedConfig = await readConfig();
+        const warnings = [];
+        const recommendations = [];
+        if (!ctx.serviceDomain) {
+            warnings.push("Service domain is not resolved.");
+            recommendations.push("Set --service-domain, MICROCMS_SERVICE_DOMAIN, or configure a profile.");
+        }
+        if (!ctx.apiKey) {
+            warnings.push("API key is not resolved.");
+            recommendations.push("Use auth login, MICROCMS_API_KEY, --api-key-stdin, or --prompt.");
+        }
+        if (ctx.apiKeySourceDetail === "option") {
+            warnings.push("API key was passed via --api-key and may leak via shell history/process list.");
+            recommendations.push("Prefer --api-key-stdin or auth login --prompt.");
+        }
+        if (!keychainAvailable) {
+            warnings.push("OS keychain is unavailable (keytar optional dependency). Stored keys fallback may not work.");
+            recommendations.push("Install optional keytar dependency for secure local key storage.");
+        }
+        printSuccess(ctx, {
+            resolved: {
+                profile: {
+                    value: ctx.profile ?? null,
+                    source: ctx.profileSource
+                },
+                serviceDomain: {
+                    value: ctx.serviceDomain ?? null,
+                    source: ctx.serviceDomainSource
+                },
+                apiKey: {
+                    available: Boolean(ctx.apiKey),
+                    source: ctx.apiKeySource,
+                    sourceDetail: ctx.apiKeySourceDetail
+                }
+            },
+            keychain: {
+                available: keychainAvailable
+            },
+            config: {
+                path: getConfigPath(),
+                defaultProfile: savedConfig.defaultProfile ?? null,
+                profileCount: Object.keys(savedConfig.profiles ?? {}).length,
+                hasLegacyServiceDomain: Boolean(savedConfig.serviceDomain)
+            },
+            warnings,
+            recommendations
+        });
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAEjF,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,KAAK,EAAE,GAAG,UAAqB,EAAE,EAAE;QACzC,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,iBAAiB,GAAG,MAAM,cAAc,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,MAAM,UAAU,EAAE,CAAC;QAEvC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;YACjD,eAAe,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;QACjG,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YAC1C,eAAe,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAC1F,CAAC;QAED,IAAI,GAAG,CAAC,kBAAkB,KAAK,QAAQ,EAAE,CAAC;YACxC,QAAQ,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;YAC/F,eAAe,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,6FAA6F,CAAC,CAAC;YAC7G,eAAe,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;QAC3F,CAAC;QAED,YAAY,CAAC,GAAG,EAAE;YAChB,QAAQ,EAAE;gBACR,OAAO,EAAE;oBACP,KAAK,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;oBAC1B,MAAM,EAAE,GAAG,CAAC,aAAa;iBAC1B;gBACD,aAAa,EAAE;oBACb,KAAK,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;oBAChC,MAAM,EAAE,GAAG,CAAC,mBAAmB;iBAChC;gBACD,MAAM,EAAE;oBACN,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;oBAC9B,MAAM,EAAE,GAAG,CAAC,YAAY;oBACxB,YAAY,EAAE,GAAG,CAAC,kBAAkB;iBACrC;aACF;YACD,QAAQ,EAAE;gBACR,SAAS,EAAE,iBAAiB;aAC7B;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,aAAa,EAAE;gBACrB,cAAc,EAAE,WAAW,CAAC,cAAc,IAAI,IAAI;gBAClD,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM;gBAC5D,sBAAsB,EAAE,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC;aAC3D;YACD,QAAQ;YACR,eAAe;SAChB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/content.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerContentCommands(program: Command): void;

package/dist/commands/content.js

@@ -0,0 +1,191 @@
+import { createContent, deleteContent, getContent, listContent, updateContent } from "../core/client.js";
+import { CliError } from "../core/errors.js";
+import { EXIT_CODE } from "../core/exit-codes.js";
+import { assertObjectPayload, readJsonFile } from "../core/io.js";
+import { printSuccess } from "../core/output.js";
+import { contextFromCommand, getActionCommand, parseIntegerOption } from "./utils.js";
+export function registerContentCommands(program) {
+    const content = program.command("content").description("Content API operations");
+    content
+        .command("list")
+        .argument("<endpoint>", "API endpoint")
+        .option("--limit <limit>")
+        .option("--offset <offset>")
+        .option("--orders <orders>")
+        .option("--q <q>")
+        .option("--filters <filters>")
+        .option("--fields <fields>")
+        .option("--ids <ids>")
+        .option("--depth <depth>")
+        .option("--draft-key <draftKey>")
+        .option("--all", "fetch all pages")
+        .action(async (...actionArgs) => {
+        const endpoint = actionArgs[0];
+        const options = actionArgs[1];
+        const command = getActionCommand(actionArgs);
+        const ctx = await contextFromCommand(command);
+        const queries = compactObject({
+            limit: parseIntegerOption("limit", options.limit, { min: 1, max: 100 }),
+            offset: parseIntegerOption("offset", options.offset, { min: 0, max: 100000 }),
+            orders: options.orders,
+            q: options.q,
+            filters: options.filters,
+            fields: options.fields,
+            ids: options.ids,
+            depth: parseIntegerOption("depth", options.depth, { min: 0, max: 3 }),
+            draftKey: options.draftKey
+        });
+        const result = options.all
+            ? await listContentAll(ctx, endpoint, queries)
+            : await listContent(ctx, endpoint, queries);
+        printSuccess(ctx, result.data, result.requestId);
+    });
+    content
+        .command("get")
+        .argument("<endpoint>", "API endpoint")
+        .argument("<id>", "Content ID")
+        .option("--draft-key <draftKey>")
+        .action(async (...actionArgs) => {
+        const endpoint = actionArgs[0];
+        const id = actionArgs[1];
+        const options = actionArgs[2];
+        const command = getActionCommand(actionArgs);
+        const ctx = await contextFromCommand(command);
+        const result = await getContent(ctx, endpoint, id, compactObject({ draftKey: options.draftKey }));
+        printSuccess(ctx, result.data, result.requestId);
+    });
+    content
+        .command("create")
+        .argument("<endpoint>", "API endpoint")
+        .requiredOption("--file <path>", "Payload JSON file")
+        .option("--dry-run", "show operation without sending request")
+        .action(async (...actionArgs) => {
+        const endpoint = actionArgs[0];
+        const options = actionArgs[1];
+        const command = getActionCommand(actionArgs);
+        const ctx = await contextFromCommand(command);
+        const payload = assertObjectPayload(await readJsonFile(options.file));
+        if (options.dryRun) {
+            printSuccess(ctx, {
+                dryRun: true,
+                operation: "content.create",
+                endpoint,
+                payload
+            });
+            return;
+        }
+        const result = await createContent(ctx, endpoint, payload);
+        printSuccess(ctx, result.data, result.requestId);
+    });
+    content
+        .command("update")
+        .argument("<endpoint>", "API endpoint")
+        .argument("<id>", "Content ID")
+        .requiredOption("--file <path>", "Payload JSON file")
+        .option("--dry-run", "show operation without sending request")
+        .action(async (...actionArgs) => {
+        const endpoint = actionArgs[0];
+        const id = actionArgs[1];
+        const options = actionArgs[2];
+        const command = getActionCommand(actionArgs);
+        const ctx = await contextFromCommand(command);
+        const payload = assertObjectPayload(await readJsonFile(options.file));
+        if (options.dryRun) {
+            printSuccess(ctx, {
+                dryRun: true,
+                operation: "content.update",
+                endpoint,
+                id,
+                payload
+            });
+            return;
+        }
+        const result = await updateContent(ctx, endpoint, id, payload);
+        printSuccess(ctx, result.data, result.requestId);
+    });
+    content
+        .command("delete")
+        .argument("<endpoint>", "API endpoint")
+        .argument("<id>", "Content ID")
+        .option("--dry-run", "show operation without sending request")
+        .action(async (...actionArgs) => {
+        const endpoint = actionArgs[0];
+        const id = actionArgs[1];
+        const options = actionArgs[2];
+        const command = getActionCommand(actionArgs);
+        const ctx = await contextFromCommand(command);
+        if (options.dryRun) {
+            printSuccess(ctx, {
+                dryRun: true,
+                operation: "content.delete",
+                endpoint,
+                id
+            });
+            return;
+        }
+        const result = await deleteContent(ctx, endpoint, id);
+        const data = typeof result.data === "object" && result.data !== null
+            ? result.data
+            : {
+                id,
+                deleted: true
+            };
+        printSuccess(ctx, data, result.requestId);
+    });
+}
+function compactObject(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
+}
+async function listContentAll(ctx, endpoint, queries) {
+    const pageSize = queries.limit ?? 100;
+    let offset = queries.offset ?? 0;
+    const startOffset = offset;
+    const mergedContents = [];
+    let requestId = null;
+    let totalCount;
+    for (let i = 0; i < 10_000; i += 1) {
+        const result = await listContent(ctx, endpoint, {
+            ...queries,
+            limit: pageSize,
+            offset
+        });
+        requestId = result.requestId;
+        const page = parseListShape(result.data);
+        if (!page) {
+            throw new CliError({
+                code: "API_ERROR",
+                message: "--all requires a list response containing `contents` and `totalCount`.",
+                exitCode: EXIT_CODE.UNKNOWN
+            });
+        }
+        totalCount = page.totalCount;
+        mergedContents.push(...page.contents);
+        if (mergedContents.length >= totalCount || page.contents.length === 0) {
+            break;
+        }
+        offset += page.contents.length;
+    }
+    return {
+        data: {
+            contents: mergedContents,
+            totalCount: totalCount ?? mergedContents.length,
+            offset: startOffset,
+            limit: pageSize
+        },
+        requestId
+    };
+}
+function parseListShape(data) {
+    if (typeof data !== "object" || data === null) {
+        return null;
+    }
+    const candidate = data;
+    if (!Array.isArray(candidate.contents) || typeof candidate.totalCount !== "number") {
+        return null;
+    }
+    return {
+        contents: candidate.contents,
+        totalCount: candidate.totalCount
+    };
+}
+//# sourceMappingURL=content.js.map

package/dist/commands/content.js.map

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

package/dist/commands/media.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerMediaCommands(program: Command): void;

package/dist/commands/media.js

@@ -0,0 +1,47 @@
+import { stat } from "node:fs/promises";
+import { uploadMedia } from "../core/client.js";
+import { CliError } from "../core/errors.js";
+import { EXIT_CODE } from "../core/exit-codes.js";
+import { printSuccess } from "../core/output.js";
+import { contextFromCommand, getActionCommand } from "./utils.js";
+export function registerMediaCommands(program) {
+    const media = program.command("media").description("Media operations");
+    media
+        .command("upload")
+        .argument("<path>", "Path to media file")
+        .option("--dry-run", "show operation without sending request")
+        .action(async (...actionArgs) => {
+        const path = actionArgs[0];
+        const options = actionArgs[1];
+        const command = getActionCommand(actionArgs);
+        const ctx = await contextFromCommand(command);
+        if (options.dryRun) {
+            const file = await stat(path).catch(() => {
+                throw new CliError({
+                    code: "INVALID_INPUT",
+                    message: `Could not read file: ${path}`,
+                    details: { path },
+                    exitCode: EXIT_CODE.INVALID_INPUT
+                });
+            });
+            if (!file.isFile()) {
+                throw new CliError({
+                    code: "INVALID_INPUT",
+                    message: `Path is not a file: ${path}`,
+                    details: { path },
+                    exitCode: EXIT_CODE.INVALID_INPUT
+                });
+            }
+            printSuccess(ctx, {
+                dryRun: true,
+                operation: "media.upload",
+                path,
+                size: file.size
+            });
+            return;
+        }
+        const result = await uploadMedia(ctx, path);
+        printSuccess(ctx, result.data, result.requestId);
+    });
+}
+//# sourceMappingURL=media.js.map

package/dist/commands/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/commands/media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAEvE,KAAK;SACF,OAAO,CAAC,QAAQ,CAAC;SACjB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;SACxC,MAAM,CAAC,WAAW,EAAE,wCAAwC,CAAC;SAC7D,MAAM,CAAC,KAAK,EAAE,GAAG,UAAqB,EAAE,EAAE;QACzC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QACrC,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAyB,CAAC;QACtD,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAE9C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBACvC,MAAM,IAAI,QAAQ,CAAC;oBACjB,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,wBAAwB,IAAI,EAAE;oBACvC,OAAO,EAAE,EAAE,IAAI,EAAE;oBACjB,QAAQ,EAAE,SAAS,CAAC,aAAa;iBAClC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACnB,MAAM,IAAI,QAAQ,CAAC;oBACjB,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,uBAAuB,IAAI,EAAE;oBACtC,OAAO,EAAE,EAAE,IAAI,EAAE;oBACjB,QAAQ,EAAE,SAAS,CAAC,aAAa;iBAClC,CAAC,CAAC;YACL,CAAC;YAED,YAAY,CAAC,GAAG,EAAE;gBAChB,MAAM,EAAE,IAAI;gBACZ,SAAS,EAAE,cAAc;gBACzB,IAAI;gBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5C,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/schema.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerSchemaCommands(program: Command): void;

package/dist/commands/schema.js

@@ -0,0 +1,71 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { getApiInfo, listApis } from "../core/client.js";
+import { buildSchemaBundle, extractApiEndpoints } from "../core/schema.js";
+import { CliError } from "../core/errors.js";
+import { EXIT_CODE } from "../core/exit-codes.js";
+import { printSuccess } from "../core/output.js";
+import { contextFromCommand, getActionCommand } from "./utils.js";
+export function registerSchemaCommands(program) {
+    const schema = program.command("schema").description("Schema operations");
+    schema
+        .command("pull")
+        .description("Fetch API schema metadata and save to file")
+        .option("--out <path>", "output JSON file", "microcms-schema.json")
+        .option("--endpoints <list>", "comma-separated endpoints to pull")
+        .action(async (...actionArgs) => {
+        const options = actionArgs[0];
+        const command = getActionCommand(actionArgs);
+        const ctx = await contextFromCommand(command);
+        const selectedEndpoints = parseEndpointsOption(options.endpoints);
+        let requestId = null;
+        let endpoints;
+        if (selectedEndpoints.length > 0) {
+            endpoints = selectedEndpoints;
+        }
+        else {
+            const listed = await listApis(ctx);
+            requestId = listed.requestId;
+            endpoints = extractApiEndpoints(listed.data);
+        }
+        if (endpoints.length === 0) {
+            throw new CliError({
+                code: "INVALID_INPUT",
+                message: "No endpoints were found. Specify --endpoints or check API permissions.",
+                exitCode: EXIT_CODE.INVALID_INPUT
+            });
+        }
+        const pulled = [];
+        for (const endpoint of endpoints) {
+            const info = await getApiInfo(ctx, endpoint);
+            requestId = info.requestId ?? requestId;
+            pulled.push({
+                endpoint,
+                api: info.data
+            });
+        }
+        const bundle = buildSchemaBundle({
+            serviceDomain: ctx.serviceDomain,
+            apis: pulled
+        });
+        const outPath = options.out ?? "microcms-schema.json";
+        await mkdir(dirname(outPath), { recursive: true });
+        await writeFile(outPath, JSON.stringify(bundle, null, 2), "utf8");
+        printSuccess(ctx, {
+            out: outPath,
+            endpointCount: pulled.length,
+            endpoints: pulled.map((item) => item.endpoint)
+        }, requestId);
+    });
+}
+function parseEndpointsOption(value) {
+    if (!value) {
+        return [];
+    }
+    const endpoints = value
+        .split(",")
+        .map((endpoint) => endpoint.trim())
+        .filter((endpoint) => endpoint.length > 0);
+    return [...new Set(endpoints)];
+}
+//# 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/types.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerTypesCommands(program: Command): void;

package/dist/commands/types.js

@@ -0,0 +1,85 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { getApiInfo, listApis } from "../core/client.js";
+import { readJsonFile } from "../core/io.js";
+import { buildSchemaBundle, extractApiEndpoints, generateTypesFromSchema } from "../core/schema.js";
+import { CliError } from "../core/errors.js";
+import { EXIT_CODE } from "../core/exit-codes.js";
+import { printSuccess } from "../core/output.js";
+import { contextFromCommand, getActionCommand } from "./utils.js";
+export function registerTypesCommands(program) {
+    const types = program.command("types").description("Type generation operations");
+    types
+        .command("generate")
+        .description("Generate TypeScript type definitions from microCMS API schema")
+        .option("--schema <path>", "use local schema JSON file")
+        .option("--out <path>", "output declaration file", "microcms-types.d.ts")
+        .option("--endpoints <list>", "comma-separated endpoints to fetch (when --schema is not used)")
+        .action(async (...actionArgs) => {
+        const options = actionArgs[0];
+        const command = getActionCommand(actionArgs);
+        const ctx = await contextFromCommand(command);
+        let source;
+        let requestId = null;
+        if (options.schema) {
+            source = await readJsonFile(options.schema);
+        }
+        else {
+            const selectedEndpoints = parseEndpointsOption(options.endpoints);
+            let endpoints;
+            if (selectedEndpoints.length > 0) {
+                endpoints = selectedEndpoints;
+            }
+            else {
+                const listed = await listApis(ctx);
+                requestId = listed.requestId;
+                endpoints = extractApiEndpoints(listed.data);
+            }
+            if (endpoints.length === 0) {
+                throw new CliError({
+                    code: "INVALID_INPUT",
+                    message: "No endpoints were found. Specify --endpoints or provide --schema.",
+                    exitCode: EXIT_CODE.INVALID_INPUT
+                });
+            }
+            const apis = [];
+            for (const endpoint of endpoints) {
+                const info = await getApiInfo(ctx, endpoint);
+                requestId = info.requestId ?? requestId;
+                apis.push({ endpoint, api: info.data });
+            }
+            source = buildSchemaBundle({
+                serviceDomain: ctx.serviceDomain,
+                apis
+            });
+        }
+        const generated = generateTypesFromSchema(source);
+        if (generated.endpointCount === 0) {
+            throw new CliError({
+                code: "INVALID_INPUT",
+                message: "No schema entries were found to generate types.",
+                exitCode: EXIT_CODE.INVALID_INPUT
+            });
+        }
+        const outPath = options.out ?? "microcms-types.d.ts";
+        await mkdir(dirname(outPath), { recursive: true });
+        await writeFile(outPath, generated.code, "utf8");
+        printSuccess(ctx, {
+            out: outPath,
+            endpointCount: generated.endpointCount,
+            warnings: generated.warnings,
+            source: options.schema ? "schema_file" : "management_api"
+        }, requestId);
+    });
+}
+function parseEndpointsOption(value) {
+    if (!value) {
+        return [];
+    }
+    const endpoints = value
+        .split(",")
+        .map((endpoint) => endpoint.trim())
+        .filter((endpoint) => endpoint.length > 0);
+    return [...new Set(endpoints)];
+}
+//# sourceMappingURL=types.js.map

package/dist/commands/types.js.map

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

package/dist/commands/utils.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+import { type RuntimeContext } from "../core/context.js";
+export declare function contextFromCommand(command: Command): Promise<RuntimeContext>;
+export declare function getActionCommand(args: unknown[]): Command;
+export declare function parseIntegerOption(name: string, value: string | undefined, range?: {
+    min?: number;
+    max?: number;
+}): number | undefined;

package/dist/commands/utils.js

@@ -0,0 +1,56 @@
+import { createRuntimeContext } from "../core/context.js";
+import { CliError } from "../core/errors.js";
+import { EXIT_CODE } from "../core/exit-codes.js";
+export async function contextFromCommand(command) {
+    const options = command.optsWithGlobals();
+    return createRuntimeContext(options);
+}
+export function getActionCommand(args) {
+    const command = args.at(-1);
+    if (command &&
+        typeof command === "object" &&
+        "optsWithGlobals" in command &&
+        typeof command.optsWithGlobals === "function") {
+        return command;
+    }
+    throw new Error("Command context is unavailable");
+}
+export function parseIntegerOption(name, value, range) {
+    if (!value) {
+        return undefined;
+    }
+    if (!/^\d+$/.test(value.trim())) {
+        throw invalidInteger(name, value, describeRange(range));
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed)) {
+        throw invalidInteger(name, value, describeRange(range));
+    }
+    if (range?.min !== undefined && parsed < range.min) {
+        throw invalidInteger(name, value, describeRange(range));
+    }
+    if (range?.max !== undefined && parsed > range.max) {
+        throw invalidInteger(name, value, describeRange(range));
+    }
+    return parsed;
+}
+function invalidInteger(name, value, expected) {
+    return new CliError({
+        code: "INVALID_INPUT",
+        message: `Invalid ${name}: ${value}. Expected ${expected}.`,
+        exitCode: EXIT_CODE.INVALID_INPUT
+    });
+}
+function describeRange(range) {
+    if (!range || (range.min === undefined && range.max === undefined)) {
+        return "integer";
+    }
+    if (range.min !== undefined && range.max !== undefined) {
+        return `integer in range ${range.min}-${range.max}`;
+    }
+    if (range.min !== undefined) {
+        return `integer >= ${range.min}`;
+    }
+    return `integer <= ${range.max}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/commands/utils.js.map

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

package/dist/commands/validate.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerValidateCommand(program: Command): void;

package/dist/commands/validate.js

@@ -0,0 +1,38 @@
+import { getApiInfo } from "../core/client.js";
+import { CliError } from "../core/errors.js";
+import { EXIT_CODE } from "../core/exit-codes.js";
+import { assertObjectPayload, readJsonFile } from "../core/io.js";
+import { printSuccess } from "../core/output.js";
+import { validatePayload } from "../validation/payload.js";
+import { contextFromCommand } from "./utils.js";
+export function registerValidateCommand(program) {
+    program
+        .command("validate")
+        .argument("<endpoint>", "API endpoint")
+        .requiredOption("--file <path>", "Payload JSON file")
+        .option("--strict-warnings", "treat warnings as validation errors")
+        .description("Run lightweight payload precheck before create/update")
+        .action(async (endpoint, options, command) => {
+        const ctx = await contextFromCommand(command);
+        const payload = assertObjectPayload(await readJsonFile(options.file));
+        const apiInfo = await getApiInfo(ctx, endpoint);
+        const result = validatePayload(payload, apiInfo.data);
+        const hasStrictWarningFailure = Boolean(options.strictWarnings && result.warnings.length > 0);
+        if (!result.valid || hasStrictWarningFailure) {
+            throw new CliError({
+                code: "INVALID_INPUT",
+                message: "Payload validation failed",
+                details: {
+                    ...result,
+                    strictWarnings: Boolean(options.strictWarnings)
+                },
+                exitCode: EXIT_CODE.INVALID_INPUT
+            });
+        }
+        printSuccess(ctx, {
+            endpoint,
+            ...result
+        }, apiInfo.requestId);
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;SACtC,cAAc,CAAC,eAAe,EAAE,mBAAmB,CAAC;SACpD,MAAM,CAAC,mBAAmB,EAAE,qCAAqC,CAAC;SAClE,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAAmD,EAAE,OAAgB,EAAE,EAAE;QACxG,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE9F,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,uBAAuB,EAAE,CAAC;YAC7C,MAAM,IAAI,QAAQ,CAAC;gBACjB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,2BAA2B;gBACpC,OAAO,EAAE;oBACP,GAAG,MAAM;oBACT,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;iBAChD;gBACD,QAAQ,EAAE,SAAS,CAAC,aAAa;aAClC,CAAC,CAAC;QACL,CAAC;QAED,YAAY,CACV,GAAG,EACH;YACE,QAAQ;YACR,GAAG,MAAM;SACV,EACD,OAAO,CAAC,SAAS,CAClB,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}