@constructive-io/graphql-codegen 4.0.2 → 4.1.0

package/esm/core/codegen/cli/executor-generator.d.ts

@@ -0,0 +1,11 @@
+export interface GeneratedFile {
+    fileName: string;
+    content: string;
+}
+export interface MultiTargetExecutorInput {
+    name: string;
+    endpoint: string;
+    ormImportPath: string;
+}
+export declare function generateExecutorFile(toolName: string): GeneratedFile;
+export declare function generateMultiTargetExecutorFile(toolName: string, targets: MultiTargetExecutorInput[]): GeneratedFile;

package/esm/core/codegen/cli/executor-generator.js

@@ -0,0 +1,180 @@
+import * as t from '@babel/types';
+import { generateCode } from '../babel-ast';
+import { getGeneratedFileHeader } from '../utils';
+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;
+}
+export function generateExecutorFile(toolName) {
+    const statements = [];
+    statements.push(createImportDeclaration('appstash', ['createConfigStore']));
+    statements.push(createImportDeclaration('../orm', ['createClient']));
+    statements.push(t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('store'), t.callExpression(t.identifier('createConfigStore'), [
+            t.stringLiteral(toolName),
+        ])),
+    ]));
+    const getStoreExport = t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('getStore'), t.arrowFunctionExpression([], t.identifier('store'))),
+    ]);
+    statements.push(t.exportNamedDeclaration(getStoreExport));
+    const contextNameParam = t.identifier('contextName');
+    contextNameParam.optional = true;
+    contextNameParam.typeAnnotation = t.tsTypeAnnotation(t.tsStringKeyword());
+    const getClientBody = t.blockStatement([
+        t.variableDeclaration('let', [
+            t.variableDeclarator(t.identifier('ctx'), t.nullLiteral()),
+        ]),
+        t.ifStatement(t.identifier('contextName'), t.blockStatement([
+            t.expressionStatement(t.assignmentExpression('=', t.identifier('ctx'), t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('loadContext')), [t.identifier('contextName')]))),
+            t.ifStatement(t.unaryExpression('!', t.identifier('ctx')), t.blockStatement([
+                t.throwStatement(t.newExpression(t.identifier('Error'), [
+                    t.templateLiteral([
+                        t.templateElement({ raw: 'Context "', cooked: 'Context "' }),
+                        t.templateElement({ raw: '" not found.', cooked: '" not found.' }, true),
+                    ], [t.identifier('contextName')]),
+                ])),
+            ])),
+        ]), t.blockStatement([
+            t.expressionStatement(t.assignmentExpression('=', t.identifier('ctx'), t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('getCurrentContext')), []))),
+            t.ifStatement(t.unaryExpression('!', t.identifier('ctx')), t.blockStatement([
+                t.throwStatement(t.newExpression(t.identifier('Error'), [
+                    t.stringLiteral('No active context. Run "context create" or "context use" first.'),
+                ])),
+            ])),
+        ])),
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('headers'), t.objectExpression([])),
+        ]),
+        t.ifStatement(t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('hasValidCredentials')), [t.memberExpression(t.identifier('ctx'), t.identifier('name'))]), t.blockStatement([
+            t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('creds'), t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('getCredentials')), [t.memberExpression(t.identifier('ctx'), t.identifier('name'))])),
+            ]),
+            t.ifStatement(t.optionalMemberExpression(t.identifier('creds'), t.identifier('token'), false, true), t.blockStatement([
+                t.expressionStatement(t.assignmentExpression('=', t.memberExpression(t.identifier('headers'), t.identifier('Authorization')), t.templateLiteral([
+                    t.templateElement({ raw: 'Bearer ', cooked: 'Bearer ' }),
+                    t.templateElement({ raw: '', cooked: '' }, true),
+                ], [
+                    t.memberExpression(t.identifier('creds'), t.identifier('token')),
+                ]))),
+            ])),
+        ])),
+        t.returnStatement(t.callExpression(t.identifier('createClient'), [
+            t.objectExpression([
+                t.objectProperty(t.identifier('endpoint'), t.memberExpression(t.identifier('ctx'), t.identifier('endpoint'))),
+                t.objectProperty(t.identifier('headers'), t.identifier('headers')),
+            ]),
+        ])),
+    ]);
+    const getClientFunc = t.functionDeclaration(t.identifier('getClient'), [contextNameParam], getClientBody);
+    statements.push(t.exportNamedDeclaration(getClientFunc));
+    const header = getGeneratedFileHeader('Executor and config store for CLI');
+    const code = generateCode(statements);
+    return {
+        fileName: 'executor.ts',
+        content: header + '\n' + code,
+    };
+}
+export function generateMultiTargetExecutorFile(toolName, targets) {
+    const statements = [];
+    statements.push(createImportDeclaration('appstash', ['createConfigStore']));
+    for (const target of targets) {
+        const aliasName = `create${target.name[0].toUpperCase()}${target.name.slice(1)}Client`;
+        const specifier = t.importSpecifier(t.identifier(aliasName), t.identifier('createClient'));
+        statements.push(t.importDeclaration([specifier], t.stringLiteral(target.ormImportPath)));
+    }
+    statements.push(t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('store'), t.callExpression(t.identifier('createConfigStore'), [
+            t.stringLiteral(toolName),
+        ])),
+    ]));
+    const getStoreExport = t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('getStore'), t.arrowFunctionExpression([], t.identifier('store'))),
+    ]);
+    statements.push(t.exportNamedDeclaration(getStoreExport));
+    const targetClientsProps = targets.map((target) => {
+        const aliasName = `create${target.name[0].toUpperCase()}${target.name.slice(1)}Client`;
+        return t.objectProperty(t.stringLiteral(target.name), t.identifier(aliasName));
+    });
+    const targetClientsDecl = t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('targetClients'), t.objectExpression(targetClientsProps)),
+    ]);
+    statements.push(targetClientsDecl);
+    const defaultEndpointProps = targets.map((target) => t.objectProperty(t.stringLiteral(target.name), t.stringLiteral(target.endpoint)));
+    const defaultEndpointsDecl = t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('defaultEndpoints'), t.objectExpression(defaultEndpointProps)),
+    ]);
+    statements.push(defaultEndpointsDecl);
+    const getTargetNamesFunc = t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('getTargetNames'), t.arrowFunctionExpression([], t.callExpression(t.memberExpression(t.identifier('Object'), t.identifier('keys')), [t.identifier('targetClients')]))),
+    ]);
+    statements.push(t.exportNamedDeclaration(getTargetNamesFunc));
+    const getDefaultEndpointParam = t.identifier('targetName');
+    getDefaultEndpointParam.typeAnnotation = t.tsTypeAnnotation(t.tsStringKeyword());
+    const getDefaultEndpointFunc = t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('getDefaultEndpoint'), t.arrowFunctionExpression([getDefaultEndpointParam], t.logicalExpression('||', t.memberExpression(t.identifier('defaultEndpoints'), t.identifier('targetName'), true), t.stringLiteral('')))),
+    ]);
+    statements.push(t.exportNamedDeclaration(getDefaultEndpointFunc));
+    const targetNameParam = t.identifier('targetName');
+    targetNameParam.typeAnnotation = t.tsTypeAnnotation(t.tsStringKeyword());
+    const contextNameParam = t.identifier('contextName');
+    contextNameParam.optional = true;
+    contextNameParam.typeAnnotation = t.tsTypeAnnotation(t.tsStringKeyword());
+    const getClientBody = t.blockStatement([
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('createFn'), t.memberExpression(t.identifier('targetClients'), t.identifier('targetName'), true)),
+        ]),
+        t.ifStatement(t.unaryExpression('!', t.identifier('createFn')), t.blockStatement([
+            t.throwStatement(t.newExpression(t.identifier('Error'), [
+                t.templateLiteral([
+                    t.templateElement({ raw: 'Unknown target: ', cooked: 'Unknown target: ' }),
+                    t.templateElement({ raw: '', cooked: '' }, true),
+                ], [t.identifier('targetName')]),
+            ])),
+        ])),
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('headers'), t.objectExpression([])),
+        ]),
+        t.variableDeclaration('let', [
+            t.variableDeclarator(t.identifier('endpoint'), t.stringLiteral('')),
+        ]),
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('ctx'), t.conditionalExpression(t.identifier('contextName'), t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('loadContext')), [t.identifier('contextName')]), t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('getCurrentContext')), []))),
+        ]),
+        t.ifStatement(t.identifier('ctx'), t.blockStatement([
+            t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('resolved'), t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('getTargetEndpoint')), [t.identifier('targetName'), t.memberExpression(t.identifier('ctx'), t.identifier('name'))])),
+            ]),
+            t.expressionStatement(t.assignmentExpression('=', t.identifier('endpoint'), t.logicalExpression('||', t.identifier('resolved'), t.logicalExpression('||', t.memberExpression(t.identifier('defaultEndpoints'), t.identifier('targetName'), true), t.stringLiteral(''))))),
+            t.ifStatement(t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('hasValidCredentials')), [t.memberExpression(t.identifier('ctx'), t.identifier('name'))]), t.blockStatement([
+                t.variableDeclaration('const', [
+                    t.variableDeclarator(t.identifier('creds'), t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('getCredentials')), [t.memberExpression(t.identifier('ctx'), t.identifier('name'))])),
+                ]),
+                t.ifStatement(t.optionalMemberExpression(t.identifier('creds'), t.identifier('token'), false, true), t.blockStatement([
+                    t.expressionStatement(t.assignmentExpression('=', t.memberExpression(t.identifier('headers'), t.identifier('Authorization')), t.templateLiteral([
+                        t.templateElement({ raw: 'Bearer ', cooked: 'Bearer ' }),
+                        t.templateElement({ raw: '', cooked: '' }, true),
+                    ], [t.memberExpression(t.identifier('creds'), t.identifier('token'))]))),
+                ])),
+            ])),
+        ]), t.blockStatement([
+            t.expressionStatement(t.assignmentExpression('=', t.identifier('endpoint'), t.logicalExpression('||', t.memberExpression(t.identifier('defaultEndpoints'), t.identifier('targetName'), true), t.stringLiteral('')))),
+        ])),
+        t.returnStatement(t.callExpression(t.identifier('createFn'), [
+            t.objectExpression([
+                t.objectProperty(t.identifier('endpoint'), t.identifier('endpoint')),
+                t.objectProperty(t.identifier('headers'), t.identifier('headers')),
+            ]),
+        ])),
+    ]);
+    const getClientFunc = t.functionDeclaration(t.identifier('getClient'), [targetNameParam, contextNameParam], getClientBody);
+    statements.push(t.exportNamedDeclaration(getClientFunc));
+    const header = getGeneratedFileHeader('Multi-target executor and config store for CLI');
+    const code = generateCode(statements);
+    return {
+        fileName: 'executor.ts',
+        content: header + '\n' + code,
+    };
+}

package/esm/core/codegen/cli/index.d.ts

@@ -0,0 +1,53 @@
+import type { BuiltinNames, GraphQLSDKConfigTarget } from '../../../types/config';
+import type { CleanOperation, CleanTable } from '../../../types/schema';
+import type { GeneratedFile } from './executor-generator';
+export interface GenerateCliOptions {
+    tables: CleanTable[];
+    customOperations?: {
+        queries: CleanOperation[];
+        mutations: CleanOperation[];
+    };
+    config: GraphQLSDKConfigTarget;
+}
+export interface GenerateCliResult {
+    files: GeneratedFile[];
+    stats: {
+        tables: number;
+        customQueries: number;
+        customMutations: number;
+        infraFiles: number;
+        totalFiles: number;
+    };
+}
+export declare function generateCli(options: GenerateCliOptions): GenerateCliResult;
+export interface MultiTargetCliTarget {
+    name: string;
+    endpoint: string;
+    ormImportPath: string;
+    tables: CleanTable[];
+    customOperations: {
+        queries: CleanOperation[];
+        mutations: CleanOperation[];
+    };
+    isAuthTarget?: boolean;
+}
+export interface GenerateMultiTargetCliOptions {
+    toolName: string;
+    builtinNames?: BuiltinNames;
+    targets: MultiTargetCliTarget[];
+}
+export declare function resolveBuiltinNames(targetNames: string[], userOverrides?: BuiltinNames): {
+    auth: string;
+    context: string;
+};
+export declare function generateMultiTargetCli(options: GenerateMultiTargetCliOptions): GenerateCliResult;
+export { generateExecutorFile, generateMultiTargetExecutorFile } from './executor-generator';
+export { generateTableCommand } from './table-command-generator';
+export { generateCustomCommand } from './custom-command-generator';
+export { generateCommandMap, generateMultiTargetCommandMap } from './command-map-generator';
+export { generateContextCommand, generateAuthCommand, generateMultiTargetContextCommand, generateAuthCommandWithName, } from './infra-generator';
+export { generateReadme, generateAgentsDocs, getCliMcpTools, generateSkills, generateMultiTargetReadme, generateMultiTargetAgentsDocs, getMultiTargetCliMcpTools, generateMultiTargetSkills, } from './docs-generator';
+export type { MultiTargetDocsInput } from './docs-generator';
+export { resolveDocsConfig } from '../docs-utils';
+export type { GeneratedDocFile, McpTool } from '../docs-utils';
+export type { GeneratedFile, MultiTargetExecutorInput } from './executor-generator';

package/esm/core/codegen/cli/index.js

@@ -0,0 +1,128 @@
+import { generateCommandMap, generateMultiTargetCommandMap } from './command-map-generator';
+import { generateCustomCommand } from './custom-command-generator';
+import { generateExecutorFile, generateMultiTargetExecutorFile } from './executor-generator';
+import { generateAuthCommand, generateAuthCommandWithName, generateContextCommand, generateMultiTargetContextCommand, } from './infra-generator';
+import { generateTableCommand } from './table-command-generator';
+export function generateCli(options) {
+    const { tables, customOperations, config } = options;
+    const files = [];
+    const cliConfig = config.cli;
+    const toolName = typeof cliConfig === 'object' && cliConfig.toolName
+        ? cliConfig.toolName
+        : 'app';
+    const executorFile = generateExecutorFile(toolName);
+    files.push(executorFile);
+    const contextFile = generateContextCommand(toolName);
+    files.push(contextFile);
+    const authFile = generateAuthCommand(toolName);
+    files.push(authFile);
+    for (const table of tables) {
+        const tableFile = generateTableCommand(table);
+        files.push(tableFile);
+    }
+    const allCustomOps = [
+        ...(customOperations?.queries ?? []),
+        ...(customOperations?.mutations ?? []),
+    ];
+    for (const op of allCustomOps) {
+        const customFile = generateCustomCommand(op);
+        files.push(customFile);
+    }
+    const commandMapFile = generateCommandMap(tables, allCustomOps, toolName);
+    files.push(commandMapFile);
+    return {
+        files,
+        stats: {
+            tables: tables.length,
+            customQueries: customOperations?.queries.length ?? 0,
+            customMutations: customOperations?.mutations.length ?? 0,
+            infraFiles: 3,
+            totalFiles: files.length,
+        },
+    };
+}
+export function resolveBuiltinNames(targetNames, userOverrides) {
+    let authName = userOverrides?.auth ?? 'auth';
+    let contextName = userOverrides?.context ?? 'context';
+    if (targetNames.includes(authName) && !userOverrides?.auth) {
+        authName = 'credentials';
+    }
+    if (targetNames.includes(contextName) && !userOverrides?.context) {
+        contextName = 'env';
+    }
+    return { auth: authName, context: contextName };
+}
+export function generateMultiTargetCli(options) {
+    const { toolName, targets } = options;
+    const files = [];
+    const targetNames = targets.map((t) => t.name);
+    const builtinNames = resolveBuiltinNames(targetNames, options.builtinNames);
+    const executorInputs = targets.map((t) => ({
+        name: t.name,
+        endpoint: t.endpoint,
+        ormImportPath: t.ormImportPath,
+    }));
+    const executorFile = generateMultiTargetExecutorFile(toolName, executorInputs);
+    files.push(executorFile);
+    const contextFile = generateMultiTargetContextCommand(toolName, builtinNames.context, targets.map((t) => ({ name: t.name, endpoint: t.endpoint })));
+    files.push(contextFile);
+    const authFile = generateAuthCommandWithName(toolName, builtinNames.auth);
+    files.push(authFile);
+    let totalTables = 0;
+    let totalQueries = 0;
+    let totalMutations = 0;
+    const commandMapTargets = [];
+    for (const target of targets) {
+        const allOps = [
+            ...(target.customOperations?.queries ?? []),
+            ...(target.customOperations?.mutations ?? []),
+        ];
+        for (const table of target.tables) {
+            const tableFile = generateTableCommand(table, {
+                targetName: target.name,
+                executorImportPath: '../../executor',
+            });
+            files.push(tableFile);
+        }
+        for (const op of allOps) {
+            const isSaveToken = !!target.isAuthTarget && op.kind === 'mutation';
+            const customFile = generateCustomCommand(op, {
+                targetName: target.name,
+                executorImportPath: '../../executor',
+                saveToken: isSaveToken,
+            });
+            files.push(customFile);
+        }
+        totalTables += target.tables.length;
+        totalQueries += target.customOperations?.queries?.length ?? 0;
+        totalMutations += target.customOperations?.mutations?.length ?? 0;
+        commandMapTargets.push({
+            name: target.name,
+            tables: target.tables,
+            customOperations: allOps,
+        });
+    }
+    const commandMapFile = generateMultiTargetCommandMap({
+        toolName,
+        builtinNames,
+        targets: commandMapTargets,
+    });
+    files.push(commandMapFile);
+    return {
+        files,
+        stats: {
+            tables: totalTables,
+            customQueries: totalQueries,
+            customMutations: totalMutations,
+            infraFiles: 3,
+            totalFiles: files.length,
+        },
+    };
+}
+export { generateExecutorFile, generateMultiTargetExecutorFile } from './executor-generator';
+export { generateTableCommand } from './table-command-generator';
+export { generateCustomCommand } from './custom-command-generator';
+export { generateCommandMap, generateMultiTargetCommandMap } from './command-map-generator';
+export { generateContextCommand, generateAuthCommand, generateMultiTargetContextCommand, generateAuthCommandWithName, } from './infra-generator';
+export { generateReadme, generateAgentsDocs, getCliMcpTools, generateSkills, generateMultiTargetReadme, generateMultiTargetAgentsDocs, getMultiTargetCliMcpTools, generateMultiTargetSkills, } from './docs-generator';
+export { resolveDocsConfig } from '../docs-utils';

package/esm/core/codegen/cli/infra-generator.d.ts

@@ -0,0 +1,9 @@
+import type { GeneratedFile } from './executor-generator';
+export declare function generateContextCommand(toolName: string): GeneratedFile;
+export declare function generateAuthCommand(toolName: string): GeneratedFile;
+export interface MultiTargetContextInput {
+    name: string;
+    endpoint: string;
+}
+export declare function generateMultiTargetContextCommand(toolName: string, commandName: string, targets: MultiTargetContextInput[]): GeneratedFile;
+export declare function generateAuthCommandWithName(toolName: string, commandName: string): GeneratedFile;