@constructive-io/graphql-codegen 4.12.2 → 4.13.0

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

@@ -6,6 +6,7 @@ export interface MultiTargetCommandMapInput {
     builtinNames: {
         auth: string;
         context: string;
+        config: string;
     };
     targets: Array<{
         name: string;

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

@@ -223,6 +223,9 @@ function generateMultiTargetCommandMap(input) {
     const authImportName = `${builtinNames.auth}Cmd`;
     commandEntries.push({ kebab: builtinNames.auth, importName: authImportName });
     statements.push(createImportDeclaration(`./commands/${builtinNames.auth}`, authImportName));
+    const configImportName = `${builtinNames.config}Cmd`;
+    commandEntries.push({ kebab: builtinNames.config, importName: configImportName });
+    statements.push(createImportDeclaration(`./commands/${builtinNames.config}`, configImportName));
     for (const target of targets) {
         for (const table of target.tables) {
             const { singularName } = (0, utils_1.getTableNames)(table);
@@ -259,6 +262,7 @@ function generateMultiTargetCommandMap(input) {
         'Commands:',
         `  ${builtinNames.context.padEnd(20)} Manage API contexts`,
         `  ${builtinNames.auth.padEnd(20)} Manage authentication`,
+        `  ${builtinNames.config.padEnd(20)} Manage config key-value store`,
     ];
     for (const target of targets) {
         usageLines.push('');

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

@@ -0,0 +1,11 @@
+import type { GeneratedFile } from './executor-generator';
+/**
+ * Generate the config command file (get/set/list/delete for per-context vars).
+ *
+ * Usage:
+ *   <tool> config get <key>
+ *   <tool> config set <key> <value>
+ *   <tool> config list
+ *   <tool> config delete <key>
+ */
+export declare function generateConfigCommand(toolName: string, commandName: string): GeneratedFile;

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

@@ -0,0 +1,458 @@
+"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.generateConfigCommand = generateConfigCommand;
+const t = __importStar(require("@babel/types"));
+const babel_ast_1 = require("../babel-ast");
+const utils_1 = require("../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;
+}
+function buildSwitchCase(testValue, handlerName, args) {
+    return t.switchCase(t.stringLiteral(testValue), [
+        t.returnStatement(t.callExpression(t.identifier(handlerName), args)),
+    ]);
+}
+function buildDefaultSwitchCase(usageVarName) {
+    return t.switchCase(null, [
+        t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [t.identifier(usageVarName)])),
+        t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('process'), t.identifier('exit')), [t.numericLiteral(1)])),
+    ]);
+}
+/**
+ * Generate the config command file (get/set/list/delete for per-context vars).
+ *
+ * Usage:
+ *   <tool> config get <key>
+ *   <tool> config set <key> <value>
+ *   <tool> config list
+ *   <tool> config delete <key>
+ */
+function generateConfigCommand(toolName, commandName) {
+    const statements = [];
+    statements.push(createImportDeclaration('inquirerer', [
+        'CLIOptions',
+        'Inquirerer',
+        'extractFirst',
+    ]));
+    statements.push(createImportDeclaration('../executor', ['getStore']));
+    const usageStr = `
+${toolName} ${commandName} <command>
+
+Commands:
+  get <key>             Get a config value
+  set <key> <value>     Set a config value
+  list                  List all config values
+  delete <key>          Delete a config value
+
+  --help, -h            Show this help message
+`;
+    statements.push(t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('usage'), t.stringLiteral(usageStr)),
+    ]));
+    // Main export: default async (argv, prompter, _options) => { ... }
+    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 mainBody = [
+        // Help check
+        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)])),
+        ])),
+        // const store = getStore();
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('store'), t.callExpression(t.identifier('getStore'), [])),
+        ]),
+        // const { first: subcommand, newArgv } = extractFirst(argv);
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.objectPattern([
+                t.objectProperty(t.identifier('first'), t.identifier('subcommand')),
+                t.objectProperty(t.identifier('newArgv'), t.identifier('newArgv'), false, true),
+            ]), t.callExpression(t.identifier('extractFirst'), [
+                t.identifier('argv'),
+            ])),
+        ]),
+        // If no subcommand, prompt
+        t.ifStatement(t.unaryExpression('!', t.identifier('subcommand')), 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('subcommand')),
+                            t.objectProperty(t.identifier('message'), t.stringLiteral('What do you want to do?')),
+                            t.objectProperty(t.identifier('options'), t.arrayExpression([
+                                t.stringLiteral('get'),
+                                t.stringLiteral('set'),
+                                t.stringLiteral('list'),
+                                t.stringLiteral('delete'),
+                            ])),
+                        ]),
+                    ]),
+                ]))),
+            ]),
+            t.returnStatement(t.callExpression(t.identifier('handleSubcommand'), [
+                t.memberExpression(t.identifier('answer'), t.identifier('subcommand')),
+                t.identifier('newArgv'),
+                t.identifier('prompter'),
+                t.identifier('store'),
+            ])),
+        ])),
+        t.returnStatement(t.callExpression(t.identifier('handleSubcommand'), [
+            t.identifier('subcommand'),
+            t.identifier('newArgv'),
+            t.identifier('prompter'),
+            t.identifier('store'),
+        ])),
+    ];
+    const mainExport = t.exportDefaultDeclaration(t.arrowFunctionExpression([argvParam, prompterParam, optionsParam], t.blockStatement(mainBody), true));
+    statements.push(mainExport);
+    // handleSubcommand function
+    const subcmdParam = t.identifier('subcommand');
+    subcmdParam.typeAnnotation = t.tsTypeAnnotation(t.tsStringKeyword());
+    const argvParam2 = t.identifier('argv');
+    argvParam2.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Partial'), t.tsTypeParameterInstantiation([
+        t.tsTypeReference(t.identifier('Record'), t.tsTypeParameterInstantiation([
+            t.tsStringKeyword(),
+            t.tsUnknownKeyword(),
+        ])),
+    ])));
+    const prompterParam2 = t.identifier('prompter');
+    prompterParam2.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('Inquirerer')));
+    const storeParam = t.identifier('store');
+    storeParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('ReturnType'), t.tsTypeParameterInstantiation([
+        t.tsTypeQuery(t.identifier('getStore')),
+    ])));
+    const handleSubcommandFunc = t.functionDeclaration(t.identifier('handleSubcommand'), [subcmdParam, argvParam2, prompterParam2, storeParam], t.blockStatement([
+        t.switchStatement(t.identifier('subcommand'), [
+            buildSwitchCase('get', 'handleGet', [
+                t.identifier('argv'),
+                t.identifier('prompter'),
+                t.identifier('store'),
+            ]),
+            buildSwitchCase('set', 'handleSet', [
+                t.identifier('argv'),
+                t.identifier('prompter'),
+                t.identifier('store'),
+            ]),
+            buildSwitchCase('list', 'handleList', [t.identifier('store')]),
+            buildSwitchCase('delete', 'handleDelete', [
+                t.identifier('argv'),
+                t.identifier('prompter'),
+                t.identifier('store'),
+            ]),
+            buildDefaultSwitchCase('usage'),
+        ]),
+    ]), false, true);
+    statements.push(handleSubcommandFunc);
+    // handleGet
+    statements.push(buildGetHandler());
+    // handleSet
+    statements.push(buildSetHandler());
+    // handleList
+    statements.push(buildListHandler());
+    // handleDelete
+    statements.push(buildDeleteHandler());
+    const header = (0, utils_1.getGeneratedFileHeader)('Config key-value store commands');
+    const code = (0, babel_ast_1.generateCode)(statements);
+    return {
+        fileName: `commands/${commandName}.ts`,
+        content: header + '\n' + code,
+    };
+}
+function buildGetHandler() {
+    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 storeParam = t.identifier('store');
+    storeParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('ReturnType'), t.tsTypeParameterInstantiation([
+        t.tsTypeQuery(t.identifier('getStore')),
+    ])));
+    const body = [
+        // const { first: key } = extractFirst(argv);
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.objectPattern([
+                t.objectProperty(t.identifier('first'), t.identifier('key')),
+            ]), t.callExpression(t.identifier('extractFirst'), [
+                t.identifier('argv'),
+            ])),
+        ]),
+        // Prompt if no key
+        t.ifStatement(t.unaryExpression('!', t.identifier('key')), t.blockStatement([
+            t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('answers'), 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('text')),
+                            t.objectProperty(t.identifier('name'), t.stringLiteral('key')),
+                            t.objectProperty(t.identifier('message'), t.stringLiteral('Config key')),
+                            t.objectProperty(t.identifier('required'), t.booleanLiteral(true)),
+                        ]),
+                    ]),
+                ]))),
+            ]),
+            t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('value'), t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('getVar')), [t.memberExpression(t.identifier('answers'), t.identifier('key'))])),
+            ]),
+            t.ifStatement(t.binaryExpression('===', t.identifier('value'), t.identifier('undefined')), t.blockStatement([
+                t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('error')), [
+                    t.templateLiteral([
+                        t.templateElement({ raw: 'Key "', cooked: 'Key "' }),
+                        t.templateElement({ raw: '" not found.', cooked: '" not found.' }, true),
+                    ], [t.memberExpression(t.identifier('answers'), t.identifier('key'))]),
+                ])),
+            ]), t.blockStatement([
+                t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [t.identifier('value')])),
+            ])),
+            t.returnStatement(),
+        ])),
+        // const value = store.getVar(key);
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('value'), t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('getVar')), [t.identifier('key')])),
+        ]),
+        t.ifStatement(t.binaryExpression('===', t.identifier('value'), t.identifier('undefined')), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('error')), [
+                t.templateLiteral([
+                    t.templateElement({ raw: 'Key "', cooked: 'Key "' }),
+                    t.templateElement({ raw: '" not found.', cooked: '" not found.' }, true),
+                ], [t.identifier('key')]),
+            ])),
+        ]), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [t.identifier('value')])),
+        ])),
+    ];
+    return t.functionDeclaration(t.identifier('handleGet'), [argvParam, prompterParam, storeParam], t.blockStatement(body), false, true);
+}
+function buildSetHandler() {
+    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 storeParam = t.identifier('store');
+    storeParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('ReturnType'), t.tsTypeParameterInstantiation([
+        t.tsTypeQuery(t.identifier('getStore')),
+    ])));
+    const body = [
+        // const { first: key, newArgv: restArgv } = extractFirst(argv);
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.objectPattern([
+                t.objectProperty(t.identifier('first'), t.identifier('key')),
+                t.objectProperty(t.identifier('newArgv'), t.identifier('restArgv')),
+            ]), t.callExpression(t.identifier('extractFirst'), [
+                t.identifier('argv'),
+            ])),
+        ]),
+        // const { first: value } = extractFirst(restArgv);
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.objectPattern([
+                t.objectProperty(t.identifier('first'), t.identifier('value')),
+            ]), t.callExpression(t.identifier('extractFirst'), [
+                t.identifier('restArgv'),
+            ])),
+        ]),
+        // Prompt if missing key or value
+        t.ifStatement(t.logicalExpression('||', t.unaryExpression('!', t.identifier('key')), t.unaryExpression('!', t.identifier('value'))), t.blockStatement([
+            t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('answers'), t.awaitExpression(t.callExpression(t.memberExpression(t.identifier('prompter'), t.identifier('prompt')), [
+                    t.objectExpression([
+                        t.objectProperty(t.identifier('key'), t.identifier('key'), false, true),
+                        t.objectProperty(t.identifier('value'), t.identifier('value'), false, true),
+                    ]),
+                    t.arrayExpression([
+                        t.objectExpression([
+                            t.objectProperty(t.identifier('type'), t.stringLiteral('text')),
+                            t.objectProperty(t.identifier('name'), t.stringLiteral('key')),
+                            t.objectProperty(t.identifier('message'), t.stringLiteral('Config key')),
+                            t.objectProperty(t.identifier('required'), t.booleanLiteral(true)),
+                        ]),
+                        t.objectExpression([
+                            t.objectProperty(t.identifier('type'), t.stringLiteral('text')),
+                            t.objectProperty(t.identifier('name'), t.stringLiteral('value')),
+                            t.objectProperty(t.identifier('message'), t.stringLiteral('Config value')),
+                            t.objectProperty(t.identifier('required'), t.booleanLiteral(true)),
+                        ]),
+                    ]),
+                ]))),
+            ]),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('setVar')), [
+                t.memberExpression(t.identifier('answers'), t.identifier('key')),
+                t.callExpression(t.memberExpression(t.identifier('String'), t.identifier('call')), [
+                    t.identifier('undefined'),
+                    t.memberExpression(t.identifier('answers'), t.identifier('value')),
+                ]),
+            ])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [
+                t.templateLiteral([
+                    t.templateElement({ raw: 'Set ', cooked: 'Set ' }),
+                    t.templateElement({ raw: ' = ', cooked: ' = ' }),
+                    t.templateElement({ raw: '', cooked: '' }, true),
+                ], [
+                    t.memberExpression(t.identifier('answers'), t.identifier('key')),
+                    t.memberExpression(t.identifier('answers'), t.identifier('value')),
+                ]),
+            ])),
+            t.returnStatement(),
+        ])),
+        // store.setVar(key, String(value));
+        t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('setVar')), [
+            t.identifier('key'),
+            t.callExpression(t.identifier('String'), [t.identifier('value')]),
+        ])),
+        t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [
+            t.templateLiteral([
+                t.templateElement({ raw: 'Set ', cooked: 'Set ' }),
+                t.templateElement({ raw: ' = ', cooked: ' = ' }),
+                t.templateElement({ raw: '', cooked: '' }, true),
+            ], [t.identifier('key'), t.identifier('value')]),
+        ])),
+    ];
+    return t.functionDeclaration(t.identifier('handleSet'), [argvParam, prompterParam, storeParam], t.blockStatement(body), false, true);
+}
+function buildListHandler() {
+    const storeParam = t.identifier('store');
+    storeParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('ReturnType'), t.tsTypeParameterInstantiation([
+        t.tsTypeQuery(t.identifier('getStore')),
+    ])));
+    const body = [
+        // const vars = store.listVars();
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('vars'), t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('listVars')), [])),
+        ]),
+        // const entries = Object.entries(vars);
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.identifier('entries'), t.callExpression(t.memberExpression(t.identifier('Object'), t.identifier('entries')), [t.identifier('vars')])),
+        ]),
+        t.ifStatement(t.binaryExpression('===', t.memberExpression(t.identifier('entries'), t.identifier('length')), t.numericLiteral(0)), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [t.stringLiteral('No config values set.')])),
+            t.returnStatement(),
+        ])),
+        // for (const [key, value] of entries) { console.log(`${key} = ${value}`); }
+        t.forOfStatement(t.variableDeclaration('const', [
+            t.variableDeclarator(t.arrayPattern([t.identifier('key'), t.identifier('value')])),
+        ]), t.identifier('entries'), t.blockStatement([
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [
+                t.templateLiteral([
+                    t.templateElement({ raw: '', cooked: '' }),
+                    t.templateElement({ raw: ' = ', cooked: ' = ' }),
+                    t.templateElement({ raw: '', cooked: '' }, true),
+                ], [t.identifier('key'), t.identifier('value')]),
+            ])),
+        ])),
+    ];
+    return t.functionDeclaration(t.identifier('handleList'), [storeParam], t.blockStatement(body));
+}
+function buildDeleteHandler() {
+    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 storeParam = t.identifier('store');
+    storeParam.typeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('ReturnType'), t.tsTypeParameterInstantiation([
+        t.tsTypeQuery(t.identifier('getStore')),
+    ])));
+    const body = [
+        // const { first: key } = extractFirst(argv);
+        t.variableDeclaration('const', [
+            t.variableDeclarator(t.objectPattern([
+                t.objectProperty(t.identifier('first'), t.identifier('key')),
+            ]), t.callExpression(t.identifier('extractFirst'), [
+                t.identifier('argv'),
+            ])),
+        ]),
+        // Prompt if no key
+        t.ifStatement(t.unaryExpression('!', t.identifier('key')), t.blockStatement([
+            t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('answers'), 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('text')),
+                            t.objectProperty(t.identifier('name'), t.stringLiteral('key')),
+                            t.objectProperty(t.identifier('message'), t.stringLiteral('Config key to delete')),
+                            t.objectProperty(t.identifier('required'), t.booleanLiteral(true)),
+                        ]),
+                    ]),
+                ]))),
+            ]),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('deleteVar')), [t.memberExpression(t.identifier('answers'), t.identifier('key'))])),
+            t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [
+                t.templateLiteral([
+                    t.templateElement({ raw: 'Deleted key: ', cooked: 'Deleted key: ' }),
+                    t.templateElement({ raw: '', cooked: '' }, true),
+                ], [t.memberExpression(t.identifier('answers'), t.identifier('key'))]),
+            ])),
+            t.returnStatement(),
+        ])),
+        // store.deleteVar(key);
+        t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('deleteVar')), [t.identifier('key')])),
+        t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('console'), t.identifier('log')), [
+            t.templateLiteral([
+                t.templateElement({ raw: 'Deleted key: ', cooked: 'Deleted key: ' }),
+                t.templateElement({ raw: '', cooked: '' }, true),
+            ], [t.identifier('key')]),
+        ])),
+    ];
+    return t.functionDeclaration(t.identifier('handleDelete'), [argvParam, prompterParam, storeParam], t.blockStatement(body), false, true);
+}

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

@@ -0,0 +1,15 @@
+import type { GeneratedFile } from './executor-generator';
+export interface HelpersGeneratorInput {
+    name: string;
+    ormImportPath: string;
+}
+/**
+ * Generate helpers.ts with typed per-target client factories.
+ *
+ * Each target gets a `createXxxClient(contextName?)` function that uses
+ * `store.getClientConfig(targetName, contextName)` under the hood with
+ * 3-tier resolution: appstash store -> env vars -> throw.
+ *
+ * Also re-exports the store for direct config/var access.
+ */
+export declare function generateHelpersFile(toolName: string, targets: HelpersGeneratorInput[]): GeneratedFile;

package/core/codegen/cli/helpers-generator.js

@@ -0,0 +1,119 @@
+"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.generateHelpersFile = generateHelpersFile;
+const t = __importStar(require("@babel/types"));
+const babel_ast_1 = require("../babel-ast");
+const utils_1 = require("../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;
+}
+/**
+ * Generate helpers.ts with typed per-target client factories.
+ *
+ * Each target gets a `createXxxClient(contextName?)` function that uses
+ * `store.getClientConfig(targetName, contextName)` under the hood with
+ * 3-tier resolution: appstash store -> env vars -> throw.
+ *
+ * Also re-exports the store for direct config/var access.
+ */
+function generateHelpersFile(toolName, targets) {
+    const statements = [];
+    // import { createConfigStore } from 'appstash';
+    statements.push(createImportDeclaration('appstash', ['createConfigStore']));
+    // import type { ClientConfig } from 'appstash';
+    statements.push(createImportDeclaration('appstash', ['ClientConfig'], true));
+    // Import createClient from each target's ORM
+    for (const target of targets) {
+        const aliasName = `create${target.name[0].toUpperCase()}${target.name.slice(1)}OrmClient`;
+        const specifier = t.importSpecifier(t.identifier(aliasName), t.identifier('createClient'));
+        statements.push(t.importDeclaration([specifier], t.stringLiteral(target.ormImportPath)));
+    }
+    // const store = createConfigStore('toolName');
+    statements.push(t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('store'), t.callExpression(t.identifier('createConfigStore'), [
+            t.stringLiteral(toolName),
+        ])),
+    ]));
+    // export const getStore = () => store;
+    const getStoreExport = t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier('getStore'), t.arrowFunctionExpression([], t.identifier('store'))),
+    ]);
+    statements.push(t.exportNamedDeclaration(getStoreExport));
+    // export function getClientConfig(targetName: string, contextName?: string): ClientConfig
+    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 getClientConfigBody = t.blockStatement([
+        t.returnStatement(t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('getClientConfig')), [t.identifier('targetName'), t.identifier('contextName')])),
+    ]);
+    const getClientConfigFunc = t.functionDeclaration(t.identifier('getClientConfig'), [targetNameParam, contextNameParam], getClientConfigBody);
+    // Add return type annotation
+    const returnTypeAnnotation = t.tsTypeAnnotation(t.tsTypeReference(t.identifier('ClientConfig')));
+    getClientConfigFunc.returnType = returnTypeAnnotation;
+    statements.push(t.exportNamedDeclaration(getClientConfigFunc));
+    // Generate typed factory for each target
+    for (const target of targets) {
+        const factoryName = `create${target.name[0].toUpperCase()}${target.name.slice(1)}Client`;
+        const ormAliasName = `create${target.name[0].toUpperCase()}${target.name.slice(1)}OrmClient`;
+        const ctxParam = t.identifier('contextName');
+        ctxParam.optional = true;
+        ctxParam.typeAnnotation = t.tsTypeAnnotation(t.tsStringKeyword());
+        const factoryBody = t.blockStatement([
+            t.variableDeclaration('const', [
+                t.variableDeclarator(t.identifier('config'), t.callExpression(t.memberExpression(t.identifier('store'), t.identifier('getClientConfig')), [t.stringLiteral(target.name), t.identifier('contextName')])),
+            ]),
+            t.returnStatement(t.callExpression(t.identifier(ormAliasName), [
+                t.objectExpression([
+                    t.objectProperty(t.identifier('endpoint'), t.memberExpression(t.identifier('config'), t.identifier('endpoint'))),
+                    t.objectProperty(t.identifier('headers'), t.memberExpression(t.identifier('config'), t.identifier('headers'))),
+                ]),
+            ])),
+        ]);
+        const factoryFunc = t.functionDeclaration(t.identifier(factoryName), [ctxParam], factoryBody);
+        statements.push(t.exportNamedDeclaration(factoryFunc));
+    }
+    const header = (0, utils_1.getGeneratedFileHeader)('SDK helpers — typed per-target client factories with 3-tier credential resolution');
+    const code = (0, babel_ast_1.generateCode)(statements);
+    return {
+        fileName: 'helpers.ts',
+        content: header + '\n' + code,
+    };
+}

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

@@ -47,12 +47,16 @@ export interface GenerateMultiTargetCliOptions {
 export declare function resolveBuiltinNames(targetNames: string[], userOverrides?: BuiltinNames): {
     auth: string;
     context: string;
+    config: 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 { generateConfigCommand } from './config-command-generator';
+export { generateHelpersFile } from './helpers-generator';
+export type { HelpersGeneratorInput } from './helpers-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';