@constructive-io/graphql-codegen 4.26.0 → 4.27.0

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

@@ -36,7 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateCommandMap = generateCommandMap;
 exports.generateMultiTargetCommandMap = generateMultiTargetCommandMap;
 const t = __importStar(require("@babel/types"));
-const komoji_1 = require("komoji");
+const inflekt_1 = require("inflekt");
 const babel_ast_1 = require("../babel-ast");
 const utils_1 = require("../utils");
 function createImportDeclaration(moduleSpecifier, defaultImportName) {
@@ -81,13 +81,13 @@ function generateCommandMap(tables, customOperations, toolName) {
     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 kebab = (0, inflekt_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 kebab = (0, inflekt_1.toKebabCase)(op.name);
         const importName = `${op.name}Cmd`;
         commandEntries.push({ kebab, importName });
         statements.push(createImportDeclaration(`./commands/${kebab}`, importName));
@@ -115,11 +115,11 @@ function generateCommandMap(tables, customOperations, toolName) {
     ];
     for (const table of tables) {
         const { singularName } = (0, utils_1.getTableNames)(table);
-        const kebab = (0, komoji_1.toKebabCase)(singularName);
+        const kebab = (0, inflekt_1.toKebabCase)(singularName);
         usageLines.push(`  ${kebab.padEnd(20)} ${singularName} CRUD operations`);
     }
     for (const op of customOperations) {
-        const kebab = (0, komoji_1.toKebabCase)(op.name);
+        const kebab = (0, inflekt_1.toKebabCase)(op.name);
         usageLines.push(`  ${kebab.padEnd(20)} ${op.description || op.name}`);
     }
     usageLines.push('');
@@ -229,14 +229,14 @@ function generateMultiTargetCommandMap(input) {
     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 kebab = (0, inflekt_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 kebab = (0, inflekt_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 });
@@ -269,12 +269,12 @@ function generateMultiTargetCommandMap(input) {
         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 kebab = (0, inflekt_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 kebab = (0, inflekt_1.toKebabCase)(op.name);
             const cmd = `${target.name}:${kebab}`;
             usageLines.push(`    ${cmd.padEnd(22)} ${op.description || op.name}`);
         }

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

@@ -35,7 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateCustomCommand = generateCustomCommand;
 const t = __importStar(require("@babel/types"));
-const komoji_1 = require("komoji");
+const inflekt_1 = require("inflekt");
 const babel_ast_1 = require("../babel-ast");
 const utils_1 = require("../utils");
 const arg_mapper_1 = require("./arg-mapper");
@@ -132,7 +132,7 @@ function buildOrmCustomCall(opKind, opName, argsExpr, selectExpr, hasArgs = true
     return t.callExpression(t.memberExpression(t.callExpression(t.memberExpression(t.memberExpression(t.identifier('client'), t.identifier(opKind)), t.identifier(opName)), callArgs), t.identifier('execute')), []);
 }
 function generateCustomCommand(op, options) {
-    const commandName = (0, komoji_1.toKebabCase)(op.name);
+    const commandName = (0, inflekt_1.toKebabCase)(op.name);
     const opKind = op.kind === 'mutation' ? 'mutation' : 'query';
     const statements = [];
     const executorPath = options?.executorImportPath ?? '../executor';

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

@@ -7,7 +7,7 @@ exports.generateSkills = generateSkills;
 exports.generateMultiTargetReadme = generateMultiTargetReadme;
 exports.generateMultiTargetAgentsDocs = generateMultiTargetAgentsDocs;
 exports.generateMultiTargetSkills = generateMultiTargetSkills;
-const komoji_1 = require("komoji");
+const inflekt_1 = require("inflekt");
 const docs_utils_1 = require("../docs-utils");
 const utils_1 = require("../utils");
 const table_command_generator_1 = require("./table-command-generator");
@@ -38,11 +38,11 @@ function generateReadme(tables, customOperations, toolName, registry) {
     lines.push('| `config` | Manage config key-value store (per-context) |');
     for (const table of tables) {
         const { singularName } = (0, utils_1.getTableNames)(table);
-        const kebab = (0, komoji_1.toKebabCase)(singularName);
+        const kebab = (0, inflekt_1.toKebabCase)(singularName);
         lines.push(`| \`${kebab}\` | ${singularName} CRUD operations |`);
     }
     for (const op of customOperations) {
-        const kebab = (0, komoji_1.toKebabCase)(op.name);
+        const kebab = (0, inflekt_1.toKebabCase)(op.name);
         lines.push(`| \`${kebab}\` | ${op.description || op.name} |`);
     }
     lines.push('');
@@ -90,7 +90,7 @@ function generateReadme(tables, customOperations, toolName, registry) {
         lines.push('');
         for (const table of tables) {
             const { singularName } = (0, utils_1.getTableNames)(table);
-            const kebab = (0, komoji_1.toKebabCase)(singularName);
+            const kebab = (0, inflekt_1.toKebabCase)(singularName);
             const pk = (0, utils_1.getPrimaryKeyInfo)(table)[0];
             const scalarFields = (0, utils_1.getScalarFields)(table);
             const editableFields = (0, docs_utils_1.getEditableFields)(table, registry);
@@ -134,6 +134,7 @@ function generateReadme(tables, customOperations, toolName, registry) {
             }
             const specialGroups = (0, docs_utils_1.categorizeSpecialFields)(table, registry);
             lines.push(...(0, docs_utils_1.buildSpecialFieldsMarkdown)(specialGroups));
+            lines.push(...(0, docs_utils_1.buildSearchExamplesMarkdown)(specialGroups, toolName, kebab));
             lines.push('');
         }
     }
@@ -141,7 +142,7 @@ function generateReadme(tables, customOperations, toolName, registry) {
         lines.push('## Custom Operations');
         lines.push('');
         for (const op of customOperations) {
-            const kebab = (0, komoji_1.toKebabCase)(op.name);
+            const kebab = (0, inflekt_1.toKebabCase)(op.name);
             const flat = (0, docs_utils_1.flattenArgs)(op.args, registry);
             lines.push(`### \`${kebab}\``);
             lines.push('');
@@ -317,7 +318,7 @@ function generateSkills(tables, customOperations, toolName, targetName, registry
     // Table references
     for (const table of tables) {
         const { singularName } = (0, utils_1.getTableNames)(table);
-        const kebab = (0, komoji_1.toKebabCase)(singularName);
+        const kebab = (0, inflekt_1.toKebabCase)(singularName);
         const pk = (0, utils_1.getPrimaryKeyInfo)(table)[0];
         const editableFields = (0, docs_utils_1.getEditableFields)(table, registry);
         const defaultFields = (0, table_command_generator_1.getFieldsWithDefaults)(table, registry);
@@ -368,18 +369,13 @@ function generateSkills(tables, customOperations, toolName, targetName, registry
                     },
                     {
                         description: `List ${singularName} records with field selection`,
-                        code: [`${toolName} ${kebab} list --fields id,${pk.name}`],
+                        code: [`${toolName} ${kebab} list --select id,${pk.name}`],
                     },
                     {
                         description: `List ${singularName} records with filtering and ordering`,
                         code: [`${toolName} ${kebab} list --where.${pk.name}.equalTo <value> --orderBy ${pk.name.replace(/([A-Z])/g, '_$1').toUpperCase()}_ASC`],
                     },
-                    ...(skillSpecialGroups.some((g) => g.category === 'search' || g.category === 'embedding')
-                        ? [{
-                                description: `Search ${singularName} records`,
-                                code: [`${toolName} ${kebab} search "query text" --limit 10 --fields id,searchScore`],
-                            }]
-                        : []),
+                    ...(0, docs_utils_1.buildSearchExamples)(skillSpecialGroups, toolName, kebab),
                     {
                         description: `Create a ${singularName}`,
                         code: [
@@ -396,7 +392,7 @@ function generateSkills(tables, customOperations, toolName, targetName, registry
     }
     // Custom operation references
     for (const op of customOperations) {
-        const kebab = (0, komoji_1.toKebabCase)(op.name);
+        const kebab = (0, inflekt_1.toKebabCase)(op.name);
         const flat = (0, docs_utils_1.flattenArgs)(op.args, registry);
         const usage = flat.length > 0
             ? `${toolName} ${kebab} ${(0, docs_utils_1.flattenedArgsToFlags)(flat)}`
@@ -418,7 +414,7 @@ function generateSkills(tables, customOperations, toolName, targetName, registry
         });
     }
     // Overview SKILL.md
-    const tableKebabs = tables.slice(0, 5).map((t) => (0, komoji_1.toKebabCase)((0, utils_1.getTableNames)(t).singularName));
+    const tableKebabs = tables.slice(0, 5).map((t) => (0, inflekt_1.toKebabCase)((0, utils_1.getTableNames)(t).singularName));
     files.push({
         fileName: `${skillName}/SKILL.md`,
         content: (0, docs_utils_1.buildSkillFile)({
@@ -505,7 +501,7 @@ function generateMultiTargetReadme(input) {
     if (authTarget) {
         const authMutation = authTarget.customOperations.find((op) => op.kind === 'mutation' && /login|sign.?in|auth/i.test(op.name));
         if (authMutation) {
-            const kebab = (0, komoji_1.toKebabCase)(authMutation.name);
+            const kebab = (0, inflekt_1.toKebabCase)(authMutation.name);
             lines.push('Or authenticate via a login mutation (auto-saves token):');
             lines.push('');
             lines.push('```bash');
@@ -540,11 +536,11 @@ function generateMultiTargetReadme(input) {
         lines.push('|---------|-------------|');
         for (const table of tgt.tables) {
             const { singularName } = (0, utils_1.getTableNames)(table);
-            const kebab = (0, komoji_1.toKebabCase)(singularName);
+            const kebab = (0, inflekt_1.toKebabCase)(singularName);
             lines.push(`| \`${tgt.name}:${kebab}\` | ${singularName} CRUD operations |`);
         }
         for (const op of tgt.customOperations) {
-            const kebab = (0, komoji_1.toKebabCase)(op.name);
+            const kebab = (0, inflekt_1.toKebabCase)(op.name);
             lines.push(`| \`${tgt.name}:${kebab}\` | ${op.description || op.name} |`);
         }
         lines.push('');
@@ -622,7 +618,7 @@ function generateMultiTargetReadme(input) {
         lines.push('');
         for (const table of tgt.tables) {
             const { singularName } = (0, utils_1.getTableNames)(table);
-            const kebab = (0, komoji_1.toKebabCase)(singularName);
+            const kebab = (0, inflekt_1.toKebabCase)(singularName);
             const pk = (0, utils_1.getPrimaryKeyInfo)(table)[0];
             const scalarFields = (0, utils_1.getScalarFields)(table);
             const editableFields = (0, docs_utils_1.getEditableFields)(table, registry);
@@ -666,10 +662,11 @@ function generateMultiTargetReadme(input) {
             }
             const mtSpecialGroups = (0, docs_utils_1.categorizeSpecialFields)(table, registry);
             lines.push(...(0, docs_utils_1.buildSpecialFieldsMarkdown)(mtSpecialGroups));
+            lines.push(...(0, docs_utils_1.buildSearchExamplesMarkdown)(mtSpecialGroups, toolName, `${tgt.name}:${kebab}`));
             lines.push('');
         }
         for (const op of tgt.customOperations) {
-            const kebab = (0, komoji_1.toKebabCase)(op.name);
+            const kebab = (0, inflekt_1.toKebabCase)(op.name);
             const flat = (0, docs_utils_1.flattenArgs)(op.args, registry);
             lines.push(`### \`${tgt.name}:${kebab}\``);
             lines.push('');
@@ -702,7 +699,7 @@ function generateMultiTargetReadme(input) {
     lines.push('```bash');
     if (targets.length > 0 && targets[0].tables.length > 0) {
         const tgt = targets[0];
-        const kebab = (0, komoji_1.toKebabCase)((0, utils_1.getTableNames)(tgt.tables[0]).singularName);
+        const kebab = (0, inflekt_1.toKebabCase)((0, utils_1.getTableNames)(tgt.tables[0]).singularName);
         lines.push(`${toolName} ${tgt.name}:${kebab} list | jq '.[]'`);
         lines.push(`${toolName} ${tgt.name}:${kebab} get --id <uuid> | jq '.'`);
     }
@@ -715,7 +712,7 @@ function generateMultiTargetReadme(input) {
     lines.push('```bash');
     if (targets.length > 0 && targets[0].tables.length > 0) {
         const tgt = targets[0];
-        const kebab = (0, komoji_1.toKebabCase)((0, utils_1.getTableNames)(tgt.tables[0]).singularName);
+        const kebab = (0, inflekt_1.toKebabCase)((0, utils_1.getTableNames)(tgt.tables[0]).singularName);
         lines.push(`${toolName} --no-tty ${tgt.name}:${kebab} create --name "Example"`);
     }
     lines.push('```');
@@ -914,7 +911,7 @@ function generateMultiTargetSkills(input) {
         const tgtReferenceNames = [];
         for (const table of tgt.tables) {
             const { singularName } = (0, utils_1.getTableNames)(table);
-            const kebab = (0, komoji_1.toKebabCase)(singularName);
+            const kebab = (0, inflekt_1.toKebabCase)(singularName);
             const pk = (0, utils_1.getPrimaryKeyInfo)(table)[0];
             const editableFields = (0, docs_utils_1.getEditableFields)(table, registry);
             const defaultFields = (0, table_command_generator_1.getFieldsWithDefaults)(table, registry);
@@ -968,12 +965,7 @@ function generateMultiTargetSkills(input) {
                             description: `List ${singularName} records with filtering and ordering`,
                             code: [`${toolName} ${cmd} list --where.${pk.name}.equalTo <value> --orderBy ${pk.name.replace(/([A-Z])/g, '_$1').toUpperCase()}_ASC`],
                         },
-                        ...(mtSkillSpecialGroups.some((g) => g.category === 'search' || g.category === 'embedding')
-                            ? [{
-                                    description: `Search ${singularName} records`,
-                                    code: [`${toolName} ${cmd} search "query text" --limit 10 --fields id,searchScore`],
-                                }]
-                            : []),
+                        ...(0, docs_utils_1.buildSearchExamples)(mtSkillSpecialGroups, toolName, cmd),
                         {
                             description: `Create a ${singularName}`,
                             code: [
@@ -985,7 +977,7 @@ function generateMultiTargetSkills(input) {
             });
         }
         for (const op of tgt.customOperations) {
-            const kebab = (0, komoji_1.toKebabCase)(op.name);
+            const kebab = (0, inflekt_1.toKebabCase)(op.name);
             const cmd = `${tgt.name}:${kebab}`;
             const flat = (0, docs_utils_1.flattenArgs)(op.args, registry);
             const baseUsage = flat.length > 0
@@ -1013,7 +1005,7 @@ function generateMultiTargetSkills(input) {
         }
         // Target SKILL.md
         const firstKebab = tgt.tables.length > 0
-            ? (0, komoji_1.toKebabCase)((0, utils_1.getTableNames)(tgt.tables[0]).singularName)
+            ? (0, inflekt_1.toKebabCase)((0, utils_1.getTableNames)(tgt.tables[0]).singularName)
             : 'model';
         files.push({
             fileName: `${tgtSkillName}/SKILL.md`,

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

@@ -43,6 +43,8 @@ export interface GenerateMultiTargetCliOptions {
     nodeHttpAdapter?: boolean;
     /** Generate a runnable index.ts entry point */
     entryPoint?: boolean;
+    /** Whether PostGraphile condition types are enabled (default: true) */
+    condition?: boolean;
 }
 export declare function resolveBuiltinNames(targetNames: string[], userOverrides?: BuiltinNames): {
     auth: string;
@@ -62,5 +64,5 @@ export { generateReadme, generateAgentsDocs, generateSkills, generateMultiTarget
 export type { MultiTargetDocsInput } from './docs-generator';
 export { resolveDocsConfig } from '../docs-utils';
 export type { GeneratedDocFile } from '../docs-utils';
-export { generateUtilsFile, generateEntryPointFile } from './utils-generator';
+export { generateUtilsFile, generateEntryPointFile, generateEmbedderFile } from './utils-generator';
 export type { GeneratedFile, MultiTargetExecutorInput } from './executor-generator';

package/core/codegen/cli/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateEntryPointFile = exports.generateUtilsFile = exports.resolveDocsConfig = exports.generateMultiTargetSkills = exports.generateMultiTargetAgentsDocs = exports.generateMultiTargetReadme = exports.generateSkills = exports.generateAgentsDocs = exports.generateReadme = exports.generateAuthCommandWithName = exports.generateMultiTargetContextCommand = exports.generateAuthCommand = exports.generateContextCommand = exports.generateHelpersFile = exports.generateConfigCommand = exports.generateMultiTargetCommandMap = exports.generateCommandMap = exports.generateCustomCommand = exports.generateTableCommand = exports.generateMultiTargetExecutorFile = exports.generateExecutorFile = void 0;
+exports.generateEmbedderFile = exports.generateEntryPointFile = exports.generateUtilsFile = exports.resolveDocsConfig = exports.generateMultiTargetSkills = exports.generateMultiTargetAgentsDocs = exports.generateMultiTargetReadme = exports.generateSkills = exports.generateAgentsDocs = exports.generateReadme = exports.generateAuthCommandWithName = exports.generateMultiTargetContextCommand = exports.generateAuthCommand = exports.generateContextCommand = exports.generateHelpersFile = exports.generateConfigCommand = exports.generateMultiTargetCommandMap = exports.generateCommandMap = exports.generateCustomCommand = exports.generateTableCommand = exports.generateMultiTargetExecutorFile = exports.generateExecutorFile = void 0;
 exports.generateCli = generateCli;
 exports.resolveBuiltinNames = resolveBuiltinNames;
 exports.generateMultiTargetCli = generateMultiTargetCli;
@@ -27,6 +27,11 @@ function generateCli(options) {
     files.push(executorFile);
     const utilsFile = (0, utils_generator_1.generateUtilsFile)();
     files.push(utilsFile);
+    // Generate embedder module if any table has vector embedding fields
+    const hasAnyEmbeddings = tables.some((t) => t.fields.some((f) => f.type.gqlType === 'Vector' || f.type.gqlType === '[Float]'));
+    if (hasAnyEmbeddings) {
+        files.push((0, utils_generator_1.generateEmbedderFile)());
+    }
     // Generate node HTTP adapter if configured (for *.localhost subdomain routing)
     if (useNodeHttpAdapter) {
         files.push((0, utils_generator_1.generateNodeFetchFile)());
@@ -35,9 +40,11 @@ function generateCli(options) {
     files.push(contextFile);
     const authFile = (0, infra_generator_1.generateAuthCommand)(toolName);
     files.push(authFile);
+    const conditionEnabled = config.codegen?.condition === true;
     for (const table of tables) {
         const tableFile = (0, table_command_generator_1.generateTableCommand)(table, {
             typeRegistry: options.typeRegistry,
+            condition: conditionEnabled,
         });
         files.push(tableFile);
     }
@@ -84,6 +91,7 @@ function resolveBuiltinNames(targetNames, userOverrides) {
 }
 function generateMultiTargetCli(options) {
     const { toolName, targets } = options;
+    const conditionEnabled = options.condition === true;
     const files = [];
     const targetNames = targets.map((t) => t.name);
     const builtinNames = resolveBuiltinNames(targetNames, options.builtinNames);
@@ -98,6 +106,11 @@ function generateMultiTargetCli(options) {
     files.push(executorFile);
     const utilsFile = (0, utils_generator_1.generateUtilsFile)();
     files.push(utilsFile);
+    // Generate embedder module if any target has tables with vector embedding fields
+    const hasAnyMtEmbeddings = targets.some((tgt) => tgt.tables.some((t) => t.fields.some((f) => f.type.gqlType === 'Vector' || f.type.gqlType === '[Float]')));
+    if (hasAnyMtEmbeddings) {
+        files.push((0, utils_generator_1.generateEmbedderFile)());
+    }
     // Generate node HTTP adapter if configured (for *.localhost subdomain routing)
     if (options.nodeHttpAdapter) {
         files.push((0, utils_generator_1.generateNodeFetchFile)());
@@ -128,6 +141,7 @@ function generateMultiTargetCli(options) {
                 targetName: target.name,
                 executorImportPath: '../../executor',
                 typeRegistry: target.typeRegistry,
+                condition: conditionEnabled,
             });
             files.push(tableFile);
         }
@@ -201,3 +215,4 @@ Object.defineProperty(exports, "resolveDocsConfig", { enumerable: true, get: fun
 var utils_generator_2 = require("./utils-generator");
 Object.defineProperty(exports, "generateUtilsFile", { enumerable: true, get: function () { return utils_generator_2.generateUtilsFile; } });
 Object.defineProperty(exports, "generateEntryPointFile", { enumerable: true, get: function () { return utils_generator_2.generateEntryPointFile; } });
+Object.defineProperty(exports, "generateEmbedderFile", { enumerable: true, get: function () { return utils_generator_2.generateEmbedderFile; } });

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

@@ -6,5 +6,7 @@ export interface TableCommandOptions {
     executorImportPath?: string;
     /** TypeRegistry from introspection, used to check field defaults */
     typeRegistry?: TypeRegistry;
+    /** Whether PostGraphile condition types are enabled (default: true) */
+    condition?: boolean;
 }
 export declare function generateTableCommand(table: Table, options?: TableCommandOptions): GeneratedFile;