@constructive-io/graphql-codegen 4.0.1 → 4.1.0

package/core/codegen/cli/command-map-generator.js

@@ -0,0 +1,338 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCommandMap = generateCommandMap;
+exports.generateMultiTargetCommandMap = generateMultiTargetCommandMap;
+const t = __importStar(require("@babel/types"));
+const komoji_1 = require("komoji");
+const babel_ast_1 = require("../babel-ast");
+const utils_1 = require("../utils");
+function createImportDeclaration(moduleSpecifier, defaultImportName) {
+    return t.importDeclaration([t.importDefaultSpecifier(t.identifier(defaultImportName))], t.stringLiteral(moduleSpecifier));
+}
+function createNamedImportDeclaration(moduleSpecifier, namedImports, typeOnly = false) {
+    const specifiers = namedImports.map((name) => t.importSpecifier(t.identifier(name), t.identifier(name)));
+    const decl = t.importDeclaration(specifiers, t.stringLiteral(moduleSpecifier));
+    decl.importKind = typeOnly ? 'type' : 'value';
+    return decl;
+}
+function generateCommandMap(tables, customOperations, toolName) {
+    const statements = [];
+    statements.push(createNamedImportDeclaration('inquirerer', [
+        'CLIOptions',
+        'Inquirerer',
+        'extractFirst',
+    ]));
+    const commandEntries = [];
+    commandEntries.push({ kebab: 'context', importName: 'contextCmd' });
+    statements.push(createImportDeclaration('./commands/context', 'contextCmd'));
+    commandEntries.push({ kebab: 'auth', importName: 'authCmd' });
+    statements.push(createImportDeclaration('./commands/auth', 'authCmd'));
+    for (const table of tables) {
+        const { singularName } = (0, utils_1.getTableNames)(table);
+        const kebab = (0, komoji_1.toKebabCase)(singularName);
+        const importName = `${singularName}Cmd`;
+        commandEntries.push({ kebab, importName });
+        statements.push(createImportDeclaration(`./commands/${kebab}`, importName));
+    }
+    for (const op of customOperations) {
+        const kebab = (0, komoji_1.toKebabCase)(op.name);
+        const importName = `${op.name}Cmd`;
+        commandEntries.push({ kebab, importName });
+        statements.push(createImportDeclaration(`./commands/${kebab}`, importName));
+    }
+    const mapProperties = commandEntries.map((entry) => t.objectProperty(t.stringLiteral(entry.kebab), t.identifier(entry.importName)));
+    const createCommandMapFunc = t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('createCommandMap'), t.arrowFunctionExpression([], t.objectExpression(mapProperties))),
+    ]);
+    const createCommandMapAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Record'), t.tsTypeParameterInstantiation([
+        t.tsStringKeyword(),
+        t.tsFunctionType(null, [], t.tsTypeAnnotation(t.tsAnyKeyword())),
+    ])));
+    const createCommandMapId = t.identifier('createCommandMap');
+    createCommandMapId.typeAnnotation = t.tsTypeAnnotation(t.tsParenthesizedType(t.tsFunctionType(null, [], t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Record'), t.tsTypeParameterInstantiation([
+        t.tsStringKeyword(),
+        t.tsFunctionType(null, [], t.tsTypeAnnotation(t.tsUnknownKeyword())),
+    ]))))));
+    statements.push(createCommandMapFunc);
+    const usageLines = [
+        '',
+        `${toolName} <command>`,
+        '',
+        'Commands:',
+        '  context               Manage API contexts',
+        '  auth                  Manage authentication',
+    ];
+    for (const table of tables) {
+        const { singularName } = (0, utils_1.getTableNames)(table);
+        const kebab = (0, komoji_1.toKebabCase)(singularName);
+        usageLines.push(`  ${kebab.padEnd(20)} ${singularName} CRUD operations`);
+    }
+    for (const op of customOperations) {
+        const kebab = (0, komoji_1.toKebabCase)(op.name);
+        usageLines.push(`  ${kebab.padEnd(20)} ${op.description || op.name}`);
+    }
+    usageLines.push('');
+    usageLines.push('  --help, -h            Show this help message');
+    usageLines.push('  --version, -v         Show version');
+    usageLines.push('');
+    statements.push(t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('usage'), t.stringLiteral(usageLines.join('\n'))),
+    ]));
+    const argvParam = t.identifier('argv');
+    argvParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Partial'), t.tsTypeParameterInstantiation([
+        t.tsTypeReference(t.identifier('Record'), t.tsTypeParameterInstantiation([
+            t.tsStringKeyword(),
+            t.tsUnknownKeyword(),
+        ])),
+    ])));
+    const prompterParam = t.identifier('prompter');
+    prompterParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Inquirerer')));
+    const optionsParam = t.identifier('options');
+    optionsParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('CLIOptions')));
+    const commandsBody = [
+        t.ifStatement(t.logicalExpression('||', t.memberExpression(t.identifier('argv'), t.identifier('help')), t.memberExpression(t.identifier('argv'), t.identifier('h'))), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [t.identifier('usage')])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('process'), t.identifier('exit')), [t.numericLiteral(0)])),
+        ])),
+        t.variableDeclaration('let', [
+            t.variableDeclarator(t.objectPattern([
+                t.objectProperty(t.identifier('first'), t.identifier('command')),
+                t.objectProperty(t.identifier('newArgv'), t.identifier('newArgv'), false, true),
+            ]), t.callExpression(t.identifier('extractFirst'), [
+                t.identifier('argv'),
+            ])),
+        ]),
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('commandMap'), t.callExpression(t.identifier('createCommandMap'), [])),
+        ]),
+        t.ifStatement(t.unaryExpression('!', t.identifier('command')), t.blockStatement([
+            t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('answer'), t.awaitExpression(t.callExpression(t.memberExpression(t.identifier('prompter'), t.identifier('prompt')), [
+                    t.identifier('argv'),
+                    t.arrayExpression([
+                        t.objectExpression([
+                            t.objectProperty(t.identifier('type'), t.stringLiteral('autocomplete')),
+                            t.objectProperty(t.identifier('name'), t.stringLiteral('command')),
+                            t.objectProperty(t.identifier('message'), t.stringLiteral('What do you want to do?')),
+                            t.objectProperty(t.identifier('options'), t.callExpression(t.memberExpression(t.identifier('Object'), t.identifier('keys')), [t.identifier('commandMap')])),
+                        ]),
+                    ]),
+                ]))),
+            ]),
+            t.expressionStatement(t.assignmentExpression('=', t.identifier('command'), t.memberExpression(t.identifier('answer'), t.identifier('command')))),
+        ])),
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('commandFn'), t.memberExpression(t.identifier('commandMap'), t.identifier('command'), true)),
+        ]),
+        t.ifStatement(t.unaryExpression('!', t.identifier('commandFn')), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [t.identifier('usage')])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('error')), [
+                t.templateLiteral([
+                    t.templateElement({
+                        raw: 'Unknown command: ',
+                        cooked: 'Unknown command: ',
+                    }),
+                    t.templateElement({ raw: '', cooked: '' }, true),
+                ], [t.identifier('command')]),
+            ])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('process'), t.identifier('exit')), [t.numericLiteral(1)])),
+        ])),
+        t.expressionStatement(t.awaitExpression(t.callExpression(t.identifier('commandFn'), [
+            t.identifier('newArgv'),
+            t.identifier('prompter'),
+            t.identifier('options'),
+        ]))),
+        t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('prompter'), t.identifier('close')), [])),
+        t.returnStatement(t.identifier('argv')),
+    ];
+    const commandsFunc = t.arrowFunctionExpression([argvParam, prompterParam, optionsParam], t.blockStatement(commandsBody), true);
+    const commandsDecl = t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('commands'), commandsFunc),
+    ]);
+    statements.push(t.exportNamedDeclaration(commandsDecl));
+    const header = (0, utils_1.getGeneratedFileHeader)('CLI command map and entry point');
+    const code = (0, babel_ast_1.generateCode)(statements);
+    return {
+        fileName: 'commands.ts',
+        content: header + '\n' + code,
+    };
+}
+function generateMultiTargetCommandMap(input) {
+    const { toolName, builtinNames, targets } = input;
+    const statements = [];
+    statements.push(createNamedImportDeclaration('inquirerer', [
+        'CLIOptions',
+        'Inquirerer',
+        'extractFirst',
+    ]));
+    const commandEntries = [];
+    const contextImportName = `${builtinNames.context}Cmd`;
+    commandEntries.push({ kebab: builtinNames.context, importName: contextImportName });
+    statements.push(createImportDeclaration(`./commands/${builtinNames.context}`, contextImportName));
+    const authImportName = `${builtinNames.auth}Cmd`;
+    commandEntries.push({ kebab: builtinNames.auth, importName: authImportName });
+    statements.push(createImportDeclaration(`./commands/${builtinNames.auth}`, authImportName));
+    for (const target of targets) {
+        for (const table of target.tables) {
+            const { singularName } = (0, utils_1.getTableNames)(table);
+            const kebab = (0, komoji_1.toKebabCase)(singularName);
+            const prefixedKebab = `${target.name}:${kebab}`;
+            const importName = `${target.name}${singularName[0].toUpperCase()}${singularName.slice(1)}Cmd`;
+            commandEntries.push({ kebab: prefixedKebab, importName });
+            statements.push(createImportDeclaration(`./commands/${target.name}/${kebab}`, importName));
+        }
+        for (const op of target.customOperations) {
+            const kebab = (0, komoji_1.toKebabCase)(op.name);
+            const prefixedKebab = `${target.name}:${kebab}`;
+            const importName = `${target.name}${op.name[0].toUpperCase()}${op.name.slice(1)}Cmd`;
+            commandEntries.push({ kebab: prefixedKebab, importName });
+            statements.push(createImportDeclaration(`./commands/${target.name}/${kebab}`, importName));
+        }
+    }
+    const mapProperties = commandEntries.map((entry) => t.objectProperty(t.stringLiteral(entry.kebab), t.identifier(entry.importName)));
+    const createCommandMapFunc = t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('createCommandMap'), t.arrowFunctionExpression([], t.objectExpression(mapProperties))),
+    ]);
+    statements.push(createCommandMapFunc);
+    const usageLines = [
+        '',
+        `${toolName} <command>`,
+        '',
+        'Commands:',
+        `  ${builtinNames.context.padEnd(20)} Manage API contexts`,
+        `  ${builtinNames.auth.padEnd(20)} Manage authentication`,
+    ];
+    for (const target of targets) {
+        usageLines.push('');
+        usageLines.push(`  ${target.name}:`);
+        for (const table of target.tables) {
+            const { singularName } = (0, utils_1.getTableNames)(table);
+            const kebab = (0, komoji_1.toKebabCase)(singularName);
+            const cmd = `${target.name}:${kebab}`;
+            usageLines.push(`    ${cmd.padEnd(22)} ${singularName} CRUD operations`);
+        }
+        for (const op of target.customOperations) {
+            const kebab = (0, komoji_1.toKebabCase)(op.name);
+            const cmd = `${target.name}:${kebab}`;
+            usageLines.push(`    ${cmd.padEnd(22)} ${op.description || op.name}`);
+        }
+    }
+    usageLines.push('');
+    usageLines.push('  --help, -h            Show this help message');
+    usageLines.push('  --version, -v         Show version');
+    usageLines.push('');
+    statements.push(t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('usage'), t.stringLiteral(usageLines.join('\n'))),
+    ]));
+    const argvParam = t.identifier('argv');
+    argvParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Partial'), t.tsTypeParameterInstantiation([
+        t.tsTypeReference(t.identifier('Record'), t.tsTypeParameterInstantiation([
+            t.tsStringKeyword(),
+            t.tsUnknownKeyword(),
+        ])),
+    ])));
+    const prompterParam = t.identifier('prompter');
+    prompterParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Inquirerer')));
+    const optionsParam = t.identifier('options');
+    optionsParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('CLIOptions')));
+    const commandsBody = [
+        t.ifStatement(t.logicalExpression('||', t.memberExpression(t.identifier('argv'), t.identifier('help')), t.memberExpression(t.identifier('argv'), t.identifier('h'))), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [t.identifier('usage')])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('process'), t.identifier('exit')), [t.numericLiteral(0)])),
+        ])),
+        t.variableDeclaration('let', [
+            t.variableDeclarator(t.objectPattern([
+                t.objectProperty(t.identifier('first'), t.identifier('command')),
+                t.objectProperty(t.identifier('newArgv'), t.identifier('newArgv'), false, true),
+            ]), t.callExpression(t.identifier('extractFirst'), [
+                t.identifier('argv'),
+            ])),
+        ]),
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('commandMap'), t.callExpression(t.identifier('createCommandMap'), [])),
+        ]),
+        t.ifStatement(t.unaryExpression('!', t.identifier('command')), t.blockStatement([
+            t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('answer'), t.awaitExpression(t.callExpression(t.memberExpression(t.identifier('prompter'), t.identifier('prompt')), [
+                    t.identifier('argv'),
+                    t.arrayExpression([
+                        t.objectExpression([
+                            t.objectProperty(t.identifier('type'), t.stringLiteral('autocomplete')),
+                            t.objectProperty(t.identifier('name'), t.stringLiteral('command')),
+                            t.objectProperty(t.identifier('message'), t.stringLiteral('What do you want to do?')),
+                            t.objectProperty(t.identifier('options'), t.callExpression(t.memberExpression(t.identifier('Object'), t.identifier('keys')), [t.identifier('commandMap')])),
+                        ]),
+                    ]),
+                ]))),
+            ]),
+            t.expressionStatement(t.assignmentExpression('=', t.identifier('command'), t.memberExpression(t.identifier('answer'), t.identifier('command')))),
+        ])),
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('commandFn'), t.memberExpression(t.identifier('commandMap'), t.identifier('command'), true)),
+        ]),
+        t.ifStatement(t.unaryExpression('!', t.identifier('commandFn')), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [t.identifier('usage')])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('error')), [
+                t.templateLiteral([
+                    t.templateElement({
+                        raw: 'Unknown command: ',
+                        cooked: 'Unknown command: ',
+                    }),
+                    t.templateElement({ raw: '', cooked: '' }, true),
+                ], [t.identifier('command')]),
+            ])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('process'), t.identifier('exit')), [t.numericLiteral(1)])),
+        ])),
+        t.expressionStatement(t.awaitExpression(t.callExpression(t.identifier('commandFn'), [
+            t.identifier('newArgv'),
+            t.identifier('prompter'),
+            t.identifier('options'),
+        ]))),
+        t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('prompter'), t.identifier('close')), [])),
+        t.returnStatement(t.identifier('argv')),
+    ];
+    const commandsFunc = t.arrowFunctionExpression([argvParam, prompterParam, optionsParam], t.blockStatement(commandsBody), true);
+    const commandsDecl = t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('commands'), commandsFunc),
+    ]);
+    statements.push(t.exportNamedDeclaration(commandsDecl));
+    const header = (0, utils_1.getGeneratedFileHeader)('Multi-target CLI command map and entry point');
+    const code = (0, babel_ast_1.generateCode)(statements);
+    return {
+        fileName: 'commands.ts',
+        content: header + '\n' + code,
+    };
+}

package/core/codegen/cli/custom-command-generator.d.ts

@@ -0,0 +1,8 @@
+import type { CleanOperation } from '../../../types/schema';
+import type { GeneratedFile } from './executor-generator';
+export interface CustomCommandOptions {
+    targetName?: string;
+    executorImportPath?: string;
+    saveToken?: boolean;
+}
+export declare function generateCustomCommand(op: CleanOperation, options?: CustomCommandOptions): GeneratedFile;

package/core/codegen/cli/custom-command-generator.js

@@ -0,0 +1,155 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCustomCommand = generateCustomCommand;
+const t = __importStar(require("@babel/types"));
+const komoji_1 = require("komoji");
+const babel_ast_1 = require("../babel-ast");
+const utils_1 = require("../utils");
+const arg_mapper_1 = require("./arg-mapper");
+function createImportDeclaration(moduleSpecifier, namedImports, typeOnly = false) {
+    const specifiers = namedImports.map((name) => t.importSpecifier(t.identifier(name), t.identifier(name)));
+    const decl = t.importDeclaration(specifiers, t.stringLiteral(moduleSpecifier));
+    decl.importKind = typeOnly ? 'type' : 'value';
+    return decl;
+}
+function buildArgvType() {
+    return t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Partial'), t.tsTypeParameterInstantiation([
+        t.tsTypeReference(t.identifier('Record'), t.tsTypeParameterInstantiation([
+            t.tsStringKeyword(),
+            t.tsUnknownKeyword(),
+        ])),
+    ])));
+}
+function buildJsonLog(expr) {
+    return t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [
+        t.callExpression(t.memberExpression(t.identifier('JSON'), t.identifier('stringify')), [expr, t.nullLiteral(), t.numericLiteral(2)]),
+    ]));
+}
+function buildErrorCatch(errorMessage) {
+    return t.catchClause(t.identifier('error'), t.blockStatement([
+        t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('error')), [t.stringLiteral(errorMessage)])),
+        t.ifStatement(t.binaryExpression('instanceof', t.identifier('error'), t.identifier('Error')), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('error')), [
+                t.memberExpression(t.identifier('error'), t.identifier('message')),
+            ])),
+        ])),
+        t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('process'), t.identifier('exit')), [t.numericLiteral(1)])),
+    ]));
+}
+function buildOrmCustomCall(opKind, opName, argsExpr) {
+    return t.callExpression(t.memberExpression(t.callExpression(t.memberExpression(t.memberExpression(t.identifier('client'), t.identifier(opKind)), t.identifier(opName)), [argsExpr]), t.identifier('execute')), []);
+}
+function generateCustomCommand(op, options) {
+    const commandName = (0, komoji_1.toKebabCase)(op.name);
+    const opKind = op.kind === 'mutation' ? 'mutation' : 'query';
+    const statements = [];
+    const executorPath = options?.executorImportPath ?? '../executor';
+    const imports = ['getClient'];
+    if (options?.saveToken) {
+        imports.push('getStore');
+    }
+    statements.push(createImportDeclaration('inquirerer', ['CLIOptions', 'Inquirerer']));
+    statements.push(createImportDeclaration(executorPath, imports));
+    const questionsArray = op.args.length > 0
+        ? (0, arg_mapper_1.buildQuestionsArray)(op.args)
+        : t.arrayExpression([]);
+    const argvParam = t.identifier('argv');
+    argvParam.typeAnnotation = buildArgvType();
+    const prompterParam = t.identifier('prompter');
+    prompterParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Inquirerer')));
+    const optionsParam = t.identifier('_options');
+    optionsParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('CLIOptions')));
+    const bodyStatements = [
+        t.ifStatement(t.logicalExpression('||', t.memberExpression(t.identifier('argv'), t.identifier('help')), t.memberExpression(t.identifier('argv'), t.identifier('h'))), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [
+                t.stringLiteral(`${commandName} - ${op.description || op.name}\n\nUsage: ${commandName} [OPTIONS]\n`),
+            ])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('process'), t.identifier('exit')), [t.numericLiteral(0)])),
+        ])),
+    ];
+    if (op.args.length > 0) {
+        bodyStatements.push(t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('answers'), t.awaitExpression(t.callExpression(t.memberExpression(t.identifier('prompter'), t.identifier('prompt')), [t.identifier('argv'), questionsArray]))),
+        ]));
+    }
+    const getClientArgs = options?.targetName
+        ? [t.stringLiteral(options.targetName)]
+        : [];
+    bodyStatements.push(t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('client'), t.callExpression(t.identifier('getClient'), getClientArgs)),
+    ]));
+    const argsExpr = op.args.length > 0
+        ? t.identifier('answers')
+        : t.objectExpression([]);
+    bodyStatements.push(t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('result'), t.awaitExpression(buildOrmCustomCall(opKind, op.name, argsExpr))),
+    ]));
+    if (options?.saveToken) {
+        bodyStatements.push(t.ifStatement(t.logicalExpression('&&', t.memberExpression(t.identifier('argv'), t.identifier('saveToken')), t.identifier('result')), t.blockStatement([
+            t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('tokenValue'), t.logicalExpression('||', t.memberExpression(t.identifier('result'), t.identifier('token'), false), t.logicalExpression('||', t.memberExpression(t.identifier('result'), t.identifier('jwtToken'), false), t.memberExpression(t.identifier('result'), t.identifier('accessToken'), false)))),
+            ]),
+            t.ifStatement(t.identifier('tokenValue'), t.blockStatement([
+                t.variableDeclaration('const', [
+                    t.variableDeclarator(t.identifier('s'), t.callExpression(t.identifier('getStore'), [])),
+                ]),
+                t.variableDeclaration('const', [
+                    t.variableDeclarator(t.identifier('ctx'), t.callExpression(t.memberExpression(t.identifier('s'), t.identifier('getCurrentContext')), [])),
+                ]),
+                t.ifStatement(t.identifier('ctx'), t.blockStatement([
+                    t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('s'), t.identifier('setCredentials')), [
+                        t.memberExpression(t.identifier('ctx'), t.identifier('name')),
+                        t.objectExpression([
+                            t.objectProperty(t.identifier('token'), t.identifier('tokenValue')),
+                        ]),
+                    ])),
+                    t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [t.stringLiteral('Token saved to current context.')])),
+                ])),
+            ])),
+        ])));
+    }
+    bodyStatements.push(buildJsonLog(t.identifier('result')));
+    const tryBlock = t.tryStatement(t.blockStatement(bodyStatements), buildErrorCatch(`Failed: ${op.name}`));
+    statements.push(t.exportDefaultDeclaration(t.arrowFunctionExpression([argvParam, prompterParam, optionsParam], t.blockStatement([tryBlock]), true)));
+    const header = (0, utils_1.getGeneratedFileHeader)(`CLI command for ${op.kind} ${op.name}`);
+    const code = (0, babel_ast_1.generateCode)(statements);
+    return {
+        fileName: options?.targetName
+            ? `commands/${options.targetName}/${commandName}.ts`
+            : `commands/${commandName}.ts`,
+        content: header + '\n' + code,
+    };
+}

package/core/codegen/cli/docs-generator.d.ts

@@ -0,0 +1,26 @@
+import type { CleanTable, CleanOperation } from '../../../types/schema';
+import type { GeneratedDocFile, McpTool } from '../docs-utils';
+export { resolveDocsConfig } from '../docs-utils';
+export type { GeneratedDocFile, McpTool } from '../docs-utils';
+export declare function generateReadme(tables: CleanTable[], customOperations: CleanOperation[], toolName: string): GeneratedDocFile;
+export declare function generateAgentsDocs(tables: CleanTable[], customOperations: CleanOperation[], toolName: string): GeneratedDocFile;
+export declare function getCliMcpTools(tables: CleanTable[], customOperations: CleanOperation[], toolName: string): McpTool[];
+export declare function generateSkills(tables: CleanTable[], customOperations: CleanOperation[], toolName: string): GeneratedDocFile[];
+export interface MultiTargetDocsInput {
+    toolName: string;
+    builtinNames: {
+        auth: string;
+        context: string;
+    };
+    targets: Array<{
+        name: string;
+        endpoint: string;
+        tables: CleanTable[];
+        customOperations: CleanOperation[];
+        isAuthTarget?: boolean;
+    }>;
+}
+export declare function generateMultiTargetReadme(input: MultiTargetDocsInput): GeneratedDocFile;
+export declare function generateMultiTargetAgentsDocs(input: MultiTargetDocsInput): GeneratedDocFile;
+export declare function getMultiTargetCliMcpTools(input: MultiTargetDocsInput): McpTool[];
+export declare function generateMultiTargetSkills(input: MultiTargetDocsInput): GeneratedDocFile[];