@constructive-io/cli 7.0.3 → 7.1.0

package/README.md

@@ -95,27 +95,33 @@ cnc codegen --api-names my_api --output ./codegen --orm
 - `--dry-run` - Preview without writing files
 - `--verbose` - Verbose output
 
-### `cnc get-graphql-schema`
+### `cnc codegen --schema-only`
 
-Fetch or build GraphQL schema SDL.
+Export GraphQL schema SDL without running full code generation. Works with any source (endpoint, file, database, PGPM).
 
 ```bash
 # From database schemas
-cnc get-graphql-schema --database mydb --schemas myapp,public --out ./schema.graphql
+cnc codegen --schema-only --schemas myapp,public --output ./schemas
 
 # From running server
-cnc get-graphql-schema --endpoint http://localhost:3000/graphql --out ./schema.graphql
+cnc codegen --schema-only --endpoint http://localhost:3000/graphql --output ./schemas
+
+# From schema file (useful for converting/validating)
+cnc codegen --schema-only --schema-file ./input.graphql --output ./schemas
+
+# From a directory of .graphql files (multi-target)
+cnc codegen --schema-only --schema-dir ./schemas --output ./exported
 ```
 
 **Options:**
 
-- `--database <name>` - Database name (for programmatic builder)
-- `--schemas <list>` - Comma-separated schemas to include (required unless using --endpoint)
-- `--endpoint <url>` - GraphQL endpoint to fetch schema via introspection
-- `--headerHost <host>` - Optional Host header for endpoint requests
-- `--auth <token>` - Optional Authorization header value
-- `--header "Name: Value"` - Optional HTTP header (repeatable)
-- `--out <path>` - Output file path (prints to stdout if omitted)
+- `--endpoint <url>` - GraphQL endpoint URL
+- `--schema-file <path>` - Path to GraphQL schema file
+- `--schemas <list>` - Comma-separated PostgreSQL schemas
+- `--api-names <list>` - Comma-separated API names (multi-target when >1)
+- `--schema-dir <path>` - Directory of .graphql files (auto-creates one target per file)
+- `--output <dir>` - Output directory (default: ./generated/graphql)
+- `--authorization <token>` - Authorization header value
 
 ## Configuration
 

package/commands/codegen.d.ts

@@ -1,3 +1,3 @@
-import { CLIOptions, Inquirerer } from 'inquirerer';
+import type { CLIOptions, Inquirerer } from 'inquirerer';
 declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
 export default _default;

package/commands/codegen.js

@@ -10,6 +10,7 @@ Source Options (choose one):
   --config <path>            Path to graphql-codegen config file
   --endpoint <url>           GraphQL endpoint URL
   --schema-file <path>       Path to GraphQL schema file
+  --schema-dir <dir>         Directory of .graphql files (auto-expands to multi-target)
 
 Database Options:
   --schemas <list>           Comma-separated PostgreSQL schemas
@@ -19,10 +20,16 @@ Generator Options:
   --react-query              Generate React Query hooks (default)
   --orm                      Generate ORM client
   --output <dir>             Output directory (default: codegen)
+  --target <name>            Target name (for multi-target configs)
   --authorization <token>    Authorization header value
   --dry-run                  Preview without writing files
   --verbose                  Verbose output
 
+Schema Export:
+  --schema-only              Export GraphQL SDL instead of running full codegen.
+                             Works with any source (endpoint, file, database, PGPM).
+                             With multiple apiNames, writes one .graphql per API.
+
   --help, -h                 Show this help message
 `;
 exports.default = async (argv, prompter, _options) => {
@@ -30,23 +37,5 @@ exports.default = async (argv, prompter, _options) => {
         console.log(usage);
         process.exit(0);
     }
-    const hasSourceFlags = Boolean(argv.endpoint || argv['schema-file'] || argv.schemas || argv['api-names']);
-    const configPath = argv.config ||
-        (!hasSourceFlags ? (0, graphql_codegen_1.findConfigFile)() : undefined);
-    let fileConfig = {};
-    if (configPath) {
-        const loaded = await (0, graphql_codegen_1.loadConfigFile)(configPath);
-        if (!loaded.success) {
-            console.error('x', loaded.error);
-            process.exit(1);
-        }
-        fileConfig = loaded.config;
-    }
-    const seeded = (0, graphql_codegen_1.seedArgvFromConfig)(argv, fileConfig);
-    const answers = (0, graphql_codegen_1.hasResolvedCodegenSource)(seeded)
-        ? seeded
-        : await prompter.prompt(seeded, graphql_codegen_1.codegenQuestions);
-    const options = (0, graphql_codegen_1.buildGenerateOptions)(answers, fileConfig);
-    const result = await (0, graphql_codegen_1.generate)(options);
-    (0, graphql_codegen_1.printResult)(result);
+    await (0, graphql_codegen_1.runCodegenHandler)(argv, prompter);
 };

package/commands.js

@@ -11,7 +11,6 @@ const codegen_1 = __importDefault(require("./commands/codegen"));
 const context_1 = __importDefault(require("./commands/context"));
 const execute_1 = __importDefault(require("./commands/execute"));
 const explorer_1 = __importDefault(require("./commands/explorer"));
-const get_graphql_schema_1 = __importDefault(require("./commands/get-graphql-schema"));
 const jobs_1 = __importDefault(require("./commands/jobs"));
 const server_1 = __importDefault(require("./commands/server"));
 const utils_2 = require("./utils");
@@ -19,7 +18,6 @@ const createCommandMap = () => {
     return {
         server: server_1.default,
         explorer: explorer_1.default,
-        'get-graphql-schema': get_graphql_schema_1.default,
         codegen: codegen_1.default,
         jobs: jobs_1.default,
         context: context_1.default,

package/esm/commands/codegen.js

@@ -1,4 +1,4 @@
-import { generate, findConfigFile, loadConfigFile, codegenQuestions, printResult, buildGenerateOptions, seedArgvFromConfig, hasResolvedCodegenSource, } from '@constructive-io/graphql-codegen';
+import { runCodegenHandler } from '@constructive-io/graphql-codegen';
 const usage = `
 Constructive GraphQL Codegen:
 
@@ -8,6 +8,7 @@ Source Options (choose one):
   --config <path>            Path to graphql-codegen config file
   --endpoint <url>           GraphQL endpoint URL
   --schema-file <path>       Path to GraphQL schema file
+  --schema-dir <dir>         Directory of .graphql files (auto-expands to multi-target)
 
 Database Options:
   --schemas <list>           Comma-separated PostgreSQL schemas
@@ -17,10 +18,16 @@ Generator Options:
   --react-query              Generate React Query hooks (default)
   --orm                      Generate ORM client
   --output <dir>             Output directory (default: codegen)
+  --target <name>            Target name (for multi-target configs)
   --authorization <token>    Authorization header value
   --dry-run                  Preview without writing files
   --verbose                  Verbose output
 
+Schema Export:
+  --schema-only              Export GraphQL SDL instead of running full codegen.
+                             Works with any source (endpoint, file, database, PGPM).
+                             With multiple apiNames, writes one .graphql per API.
+
   --help, -h                 Show this help message
 `;
 export default async (argv, prompter, _options) => {
@@ -28,23 +35,5 @@ export default async (argv, prompter, _options) => {
         console.log(usage);
         process.exit(0);
     }
-    const hasSourceFlags = Boolean(argv.endpoint || argv['schema-file'] || argv.schemas || argv['api-names']);
-    const configPath = argv.config ||
-        (!hasSourceFlags ? findConfigFile() : undefined);
-    let fileConfig = {};
-    if (configPath) {
-        const loaded = await loadConfigFile(configPath);
-        if (!loaded.success) {
-            console.error('x', loaded.error);
-            process.exit(1);
-        }
-        fileConfig = loaded.config;
-    }
-    const seeded = seedArgvFromConfig(argv, fileConfig);
-    const answers = hasResolvedCodegenSource(seeded)
-        ? seeded
-        : await prompter.prompt(seeded, codegenQuestions);
-    const options = buildGenerateOptions(answers, fileConfig);
-    const result = await generate(options);
-    printResult(result);
+    await runCodegenHandler(argv, prompter);
 };

package/esm/commands.js

@@ -5,7 +5,6 @@ import codegen from './commands/codegen';
 import context from './commands/context';
 import execute from './commands/execute';
 import explorer from './commands/explorer';
-import getGraphqlSchema from './commands/get-graphql-schema';
 import jobs from './commands/jobs';
 import server from './commands/server';
 import { usageText } from './utils';
@@ -13,7 +12,6 @@ const createCommandMap = () => {
     return {
         server,
         explorer,
-        'get-graphql-schema': getGraphqlSchema,
         codegen,
         jobs,
         context,

package/esm/utils/display.js

@@ -10,7 +10,6 @@ export const usageText = `
 
   Code Generation:
     codegen            Generate TypeScript types and SDK from GraphQL schema
-    get-graphql-schema Fetch or build GraphQL schema SDL
 
   Jobs:
     jobs up            Start combined server (jobs runtime)
@@ -34,7 +33,7 @@ export const usageText = `
     cnc server --port 8080            Start server on custom port
     cnc explorer                      Launch GraphiQL explorer
     cnc codegen --schema schema.graphql  Generate types from schema
-    cnc get-graphql-schema --out schema.graphql  Export schema SDL
+    cnc codegen --schema-only --out schema.graphql  Export schema SDL
     cnc jobs up                       Start combined server (jobs runtime)
 
     # Execution Engine

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/cli",
-  "version": "7.0.3",
+  "version": "7.1.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "Constructive CLI",
   "main": "index.js",
@@ -30,7 +30,7 @@
     "build:dev": "makage build --dev",
     "dev": "ts-node ./src/index.ts",
     "lint": "eslint . --fix",
-    "test": "jest --passWithNoTests",
+    "test": "jest",
     "test:watch": "jest --watch"
   },
   "devDependencies": {
@@ -45,14 +45,14 @@
     "ts-node": "^10.9.2"
   },
   "dependencies": {
-    "@constructive-io/graphql-codegen": "^4.0.2",
-    "@constructive-io/graphql-env": "^3.0.0",
-    "@constructive-io/graphql-explorer": "^4.0.1",
-    "@constructive-io/graphql-server": "^4.0.1",
+    "@constructive-io/graphql-codegen": "^4.1.0",
+    "@constructive-io/graphql-env": "^3.1.0",
+    "@constructive-io/graphql-explorer": "^4.1.0",
+    "@constructive-io/graphql-server": "^4.1.0",
     "@constructive-io/graphql-types": "^3.0.0",
-    "@constructive-io/knative-job-service": "^2.0.1",
+    "@constructive-io/knative-job-service": "^2.1.0",
     "@inquirerer/utils": "^3.2.3",
-    "@pgpmjs/core": "^6.0.0",
+    "@pgpmjs/core": "^6.1.0",
     "@pgpmjs/logger": "^2.1.0",
     "@pgpmjs/server-utils": "^3.1.0",
     "@pgpmjs/types": "^2.16.0",
@@ -62,7 +62,7 @@
     "js-yaml": "^4.1.0",
     "pg-cache": "^3.0.0",
     "pg-env": "^1.4.0",
-    "pgpm": "^4.0.1",
+    "pgpm": "^4.1.0",
     "shelljs": "^0.10.0",
     "yanse": "^0.2.0"
   },
@@ -77,5 +77,5 @@
     "postgres",
     "graphile"
   ],
-  "gitHead": "44410afc7857f14414b69c7e3cfa893a270bf08f"
+  "gitHead": "6dac0247c675de94b41038ac1e5095dc5df0c753"
 }

package/utils/display.d.ts

@@ -1 +1 @@
-export declare const usageText = "\n  Usage: cnc <command> [options]\n         constructive <command> [options]\n\n  Constructive CLI - API Server and Development Tools\n\n  GraphQL Server:\n    server             Start a GraphQL server\n    explorer           Launch GraphiQL explorer interface\n\n  Code Generation:\n    codegen            Generate TypeScript types and SDK from GraphQL schema\n    get-graphql-schema Fetch or build GraphQL schema SDL\n\n  Jobs:\n    jobs up            Start combined server (jobs runtime)\n\n  Execution Engine:\n    context            Manage contexts (create, list, use, current, delete)\n    auth               Manage authentication (set-token, status, logout)\n    execute            Execute GraphQL queries against configured endpoints\n\n  Global Options:\n    -h, --help         Display this help information\n    -v, --version      Display version information\n    --cwd <directory>  Working directory (default: current directory)\n\n  Individual Command Help:\n    cnc <command> --help    Display detailed help for specific command\n    cnc <command> -h        Display detailed help for specific command\n\n  Examples:\n    cnc server                        Start GraphQL server\n    cnc server --port 8080            Start server on custom port\n    cnc explorer                      Launch GraphiQL explorer\n    cnc codegen --schema schema.graphql  Generate types from schema\n    cnc get-graphql-schema --out schema.graphql  Export schema SDL\n    cnc jobs up                       Start combined server (jobs runtime)\n\n    # Execution Engine\n    cnc context create my-api --endpoint https://api.example.com/graphql\n    cnc auth set-token\n    cnc execute --query 'query { __typename }'\n\n  Database Operations:\n    For database migrations, packages, and deployment, use pgpm:\n    https://pgpm.io\n  ";
+export declare const usageText = "\n  Usage: cnc <command> [options]\n         constructive <command> [options]\n\n  Constructive CLI - API Server and Development Tools\n\n  GraphQL Server:\n    server             Start a GraphQL server\n    explorer           Launch GraphiQL explorer interface\n\n  Code Generation:\n    codegen            Generate TypeScript types and SDK from GraphQL schema\n\n  Jobs:\n    jobs up            Start combined server (jobs runtime)\n\n  Execution Engine:\n    context            Manage contexts (create, list, use, current, delete)\n    auth               Manage authentication (set-token, status, logout)\n    execute            Execute GraphQL queries against configured endpoints\n\n  Global Options:\n    -h, --help         Display this help information\n    -v, --version      Display version information\n    --cwd <directory>  Working directory (default: current directory)\n\n  Individual Command Help:\n    cnc <command> --help    Display detailed help for specific command\n    cnc <command> -h        Display detailed help for specific command\n\n  Examples:\n    cnc server                        Start GraphQL server\n    cnc server --port 8080            Start server on custom port\n    cnc explorer                      Launch GraphiQL explorer\n    cnc codegen --schema schema.graphql  Generate types from schema\n    cnc codegen --schema-only --out schema.graphql  Export schema SDL\n    cnc jobs up                       Start combined server (jobs runtime)\n\n    # Execution Engine\n    cnc context create my-api --endpoint https://api.example.com/graphql\n    cnc auth set-token\n    cnc execute --query 'query { __typename }'\n\n  Database Operations:\n    For database migrations, packages, and deployment, use pgpm:\n    https://pgpm.io\n  ";

package/utils/display.js

@@ -13,7 +13,6 @@ exports.usageText = `
 
   Code Generation:
     codegen            Generate TypeScript types and SDK from GraphQL schema
-    get-graphql-schema Fetch or build GraphQL schema SDL
 
   Jobs:
     jobs up            Start combined server (jobs runtime)
@@ -37,7 +36,7 @@ exports.usageText = `
     cnc server --port 8080            Start server on custom port
     cnc explorer                      Launch GraphiQL explorer
     cnc codegen --schema schema.graphql  Generate types from schema
-    cnc get-graphql-schema --out schema.graphql  Export schema SDL
+    cnc codegen --schema-only --out schema.graphql  Export schema SDL
     cnc jobs up                       Start combined server (jobs runtime)
 
     # Execution Engine

package/commands/get-graphql-schema.d.ts

@@ -1,3 +0,0 @@
-import { CLIOptions, Inquirerer } from 'inquirerer';
-declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
-export default _default;

package/commands/get-graphql-schema.js

@@ -1,90 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = require("fs");
-const graphql_server_1 = require("@constructive-io/graphql-server");
-const usage = `
-Constructive Get GraphQL Schema:
-
-  cnc get-graphql-schema [OPTIONS]
-
-Source Options (choose one):
-  --endpoint <url>        GraphQL endpoint to fetch schema via introspection
-  --database <name>       Database name (default: constructive)
-
-Options:
-  --schemas <list>        Comma-separated schemas to include
-  --headerHost <host>     Host header to send with endpoint requests
-  --auth <token>          Authorization header value
-  --out <path>            Output file path (default: print to stdout)
-
-  --help, -h              Show this help message
-`;
-const questions = [
-    {
-        name: 'endpoint',
-        message: 'GraphQL endpoint URL',
-        type: 'text',
-        required: false,
-    },
-    {
-        name: 'database',
-        message: 'Database name',
-        type: 'text',
-        required: false,
-    },
-    {
-        name: 'schemas',
-        message: 'Comma-separated schemas',
-        type: 'text',
-        required: false,
-    },
-    {
-        name: 'out',
-        message: 'Output file path',
-        type: 'text',
-        required: false,
-    },
-];
-exports.default = async (argv, prompter, _options) => {
-    if (argv.help || argv.h) {
-        console.log(usage);
-        process.exit(0);
-    }
-    const { endpoint, database, schemas: schemasArg, out, } = await prompter.prompt(argv, questions);
-    const schemas = String(schemasArg).split(',').map((s) => s.trim()).filter(Boolean);
-    // Parse repeated --header values into headers object
-    const headerArg = argv.header;
-    const headerList = Array.isArray(headerArg) ? headerArg : headerArg ? [headerArg] : [];
-    const headers = {};
-    for (const h of headerList) {
-        const idx = typeof h === 'string' ? h.indexOf(':') : -1;
-        if (idx <= 0)
-            continue;
-        const name = h.slice(0, idx).trim();
-        const value = h.slice(idx + 1).trim();
-        if (!name)
-            continue;
-        headers[name] = value;
-    }
-    let sdl;
-    if (endpoint) {
-        const opts = {};
-        if (argv.headerHost)
-            opts.headerHost = argv.headerHost;
-        if (argv.auth)
-            opts.auth = argv.auth;
-        if (Object.keys(headers).length)
-            opts.headers = headers;
-        sdl = await graphql_server_1.fetchEndpointSchemaSDL(endpoint, opts);
-    }
-    else {
-        sdl = await (0, graphql_server_1.buildSchemaSDL)({ database: database, schemas });
-    }
-    if (out) {
-        await fs_1.promises.writeFile(out, sdl, 'utf8');
-        console.log(`Wrote schema SDL to ${out}`);
-    }
-    else {
-        process.stdout.write(sdl + '\n');
-    }
-};

package/esm/commands/get-graphql-schema.js

@@ -1,88 +0,0 @@
-import { promises as fs } from 'fs';
-import { buildSchemaSDL, fetchEndpointSchemaSDL } from '@constructive-io/graphql-server';
-const usage = `
-Constructive Get GraphQL Schema:
-
-  cnc get-graphql-schema [OPTIONS]
-
-Source Options (choose one):
-  --endpoint <url>        GraphQL endpoint to fetch schema via introspection
-  --database <name>       Database name (default: constructive)
-
-Options:
-  --schemas <list>        Comma-separated schemas to include
-  --headerHost <host>     Host header to send with endpoint requests
-  --auth <token>          Authorization header value
-  --out <path>            Output file path (default: print to stdout)
-
-  --help, -h              Show this help message
-`;
-const questions = [
-    {
-        name: 'endpoint',
-        message: 'GraphQL endpoint URL',
-        type: 'text',
-        required: false,
-    },
-    {
-        name: 'database',
-        message: 'Database name',
-        type: 'text',
-        required: false,
-    },
-    {
-        name: 'schemas',
-        message: 'Comma-separated schemas',
-        type: 'text',
-        required: false,
-    },
-    {
-        name: 'out',
-        message: 'Output file path',
-        type: 'text',
-        required: false,
-    },
-];
-export default async (argv, prompter, _options) => {
-    if (argv.help || argv.h) {
-        console.log(usage);
-        process.exit(0);
-    }
-    const { endpoint, database, schemas: schemasArg, out, } = await prompter.prompt(argv, questions);
-    const schemas = String(schemasArg).split(',').map((s) => s.trim()).filter(Boolean);
-    // Parse repeated --header values into headers object
-    const headerArg = argv.header;
-    const headerList = Array.isArray(headerArg) ? headerArg : headerArg ? [headerArg] : [];
-    const headers = {};
-    for (const h of headerList) {
-        const idx = typeof h === 'string' ? h.indexOf(':') : -1;
-        if (idx <= 0)
-            continue;
-        const name = h.slice(0, idx).trim();
-        const value = h.slice(idx + 1).trim();
-        if (!name)
-            continue;
-        headers[name] = value;
-    }
-    let sdl;
-    if (endpoint) {
-        const opts = {};
-        if (argv.headerHost)
-            opts.headerHost = argv.headerHost;
-        if (argv.auth)
-            opts.auth = argv.auth;
-        if (Object.keys(headers).length)
-            opts.headers = headers;
-        sdl = await fetchEndpointSchemaSDL(endpoint, opts);
-    }
-    else {
-        sdl = await buildSchemaSDL({ database: database, schemas });
-    }
-    if (out) {
-        await fs.writeFile(out, sdl, 'utf8');
-        console.log(`Wrote schema SDL to ${out}`);
-    }
-    else {
-        process.stdout.write(sdl + '\n');
-    }
-};