@constructive-io/cli 6.0.4 → 6.1.0

package/esm/utils/display.js

@@ -15,6 +15,11 @@ export const usageText = `
   Jobs:
     jobs up            Start combined server (jobs runtime)
 
+  Execution Engine:
+    context            Manage contexts (create, list, use, current, delete)
+    auth               Manage authentication (set-token, status, logout)
+    execute            Execute GraphQL queries against configured endpoints
+
   Global Options:
     -h, --help         Display this help information
     -v, --version      Display version information
@@ -32,6 +37,11 @@ export const usageText = `
     cnc get-graphql-schema --out schema.graphql  Export schema SDL
     cnc jobs up                       Start combined server (jobs runtime)
 
+    # Execution Engine
+    cnc context create my-api --endpoint https://api.example.com/graphql
+    cnc auth set-token
+    cnc execute --query 'query { __typename }'
+
   Database Operations:
     For database migrations, packages, and deployment, use pgpm:
     https://pgpm.io

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/cli",
-  "version": "6.0.4",
+  "version": "6.1.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "Constructive CLI",
   "main": "index.js",
@@ -45,18 +45,19 @@
     "ts-node": "^10.9.2"
   },
   "dependencies": {
-    "@constructive-io/graphql-codegen": "^3.0.4",
+    "@constructive-io/graphql-codegen": "^3.1.1",
     "@constructive-io/graphql-env": "^2.9.4",
     "@constructive-io/graphql-explorer": "^3.0.3",
     "@constructive-io/graphql-server": "^3.0.3",
-    "@constructive-io/knative-job-service": "^1.0.3",
+    "@constructive-io/knative-job-service": "^1.0.4",
     "@inquirerer/utils": "^3.2.0",
     "@pgpmjs/core": "^5.0.1",
     "@pgpmjs/logger": "^2.0.0",
     "@pgpmjs/server-utils": "^3.0.0",
     "@pgpmjs/types": "^2.15.0",
+    "appstash": "^0.3.0",
     "find-and-require-package-json": "^0.9.0",
-    "inquirerer": "^4.4.0",
+    "inquirerer": "^4.5.0",
     "js-yaml": "^4.1.0",
     "pg-cache": "^2.0.0",
     "pg-env": "^1.3.0",
@@ -75,5 +76,5 @@
     "postgres",
     "graphile"
   ],
-  "gitHead": "aa8ec75966a41a019eda2003b2d970f0a75608aa"
+  "gitHead": "03cfe7dad85283c7364bc38261136933a20ba73d"
 }

package/sdk/client.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Simple GraphQL client for the CNC execution engine
+ * Uses native fetch - no external dependencies
+ */
+export interface GraphQLError {
+    message: string;
+    locations?: Array<{
+        line: number;
+        column: number;
+    }>;
+    path?: Array<string | number>;
+    extensions?: Record<string, unknown>;
+}
+export interface QueryResult<T> {
+    ok: boolean;
+    data: T | null;
+    errors?: GraphQLError[];
+}
+export interface ClientConfig {
+    endpoint: string;
+    headers?: Record<string, string>;
+}
+/**
+ * Execute a GraphQL query/mutation against an endpoint
+ */
+export declare function executeGraphQL<T>(endpoint: string, query: string, variables?: Record<string, unknown>, headers?: Record<string, string>): Promise<QueryResult<T>>;
+/**
+ * Create a configured client for a specific endpoint
+ */
+export declare function createClient(config: ClientConfig): {
+    execute: <T>(query: string, variables?: Record<string, unknown>) => Promise<QueryResult<T>>;
+    config: ClientConfig;
+};

package/sdk/client.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Simple GraphQL client for the CNC execution engine
+ * Uses native fetch - no external dependencies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeGraphQL = executeGraphQL;
+exports.createClient = createClient;
+/**
+ * Execute a GraphQL query/mutation against an endpoint
+ */
+async function executeGraphQL(endpoint, query, variables, headers) {
+    try {
+        const response = await fetch(endpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+                ...headers,
+            },
+            body: JSON.stringify({
+                query,
+                variables: variables ?? {},
+            }),
+        });
+        if (!response.ok) {
+            return {
+                ok: false,
+                data: null,
+                errors: [
+                    { message: `HTTP ${response.status}: ${response.statusText}` },
+                ],
+            };
+        }
+        const json = (await response.json());
+        if (json.errors && json.errors.length > 0) {
+            return {
+                ok: false,
+                data: json.data ?? null,
+                errors: json.errors,
+            };
+        }
+        return {
+            ok: true,
+            data: json.data,
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            data: null,
+            errors: [
+                {
+                    message: error instanceof Error ? error.message : 'Unknown error occurred',
+                },
+            ],
+        };
+    }
+}
+/**
+ * Create a configured client for a specific endpoint
+ */
+function createClient(config) {
+    return {
+        execute: (query, variables) => {
+            return executeGraphQL(config.endpoint, query, variables, config.headers);
+        },
+        config,
+    };
+}

package/sdk/executor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Simple GraphQL executor for the CNC execution engine
+ * Executes raw GraphQL queries against configured endpoints
+ */
+import { QueryResult } from './client';
+import type { ContextConfig } from '../config';
+/**
+ * Execution context - bundles context config with credentials
+ */
+export interface ExecutionContext {
+    context: ContextConfig;
+    token: string;
+}
+/**
+ * Get execution context for the current or specified context
+ */
+export declare function getExecutionContext(contextName?: string): Promise<ExecutionContext>;
+/**
+ * Execute a raw GraphQL query/mutation
+ */
+export declare function execute<T = unknown>(query: string, variables?: Record<string, unknown>, execContext?: ExecutionContext): Promise<QueryResult<T>>;

package/sdk/executor.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Simple GraphQL executor for the CNC execution engine
+ * Executes raw GraphQL queries against configured endpoints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExecutionContext = getExecutionContext;
+exports.execute = execute;
+const client_1 = require("./client");
+const config_1 = require("../config");
+/**
+ * Get execution context for the current or specified context
+ */
+async function getExecutionContext(contextName) {
+    let context;
+    if (contextName) {
+        context = (0, config_1.loadContext)(contextName);
+        if (!context) {
+            throw new Error(`Context "${contextName}" not found.`);
+        }
+    }
+    else {
+        context = (0, config_1.getCurrentContext)();
+        if (!context) {
+            throw new Error('No active context. Run "cnc context create" or "cnc context use" first.');
+        }
+    }
+    if (!(0, config_1.hasValidCredentials)(context.name)) {
+        throw new Error(`No valid credentials for context "${context.name}". Run "cnc auth set-token" first.`);
+    }
+    const creds = (0, config_1.getContextCredentials)(context.name);
+    if (!creds || !creds.token) {
+        throw new Error(`No token found for context "${context.name}". Run "cnc auth set-token" first.`);
+    }
+    return {
+        context,
+        token: creds.token,
+    };
+}
+/**
+ * Execute a raw GraphQL query/mutation
+ */
+async function execute(query, variables, execContext) {
+    const ctx = execContext || (await getExecutionContext());
+    return (0, client_1.executeGraphQL)(ctx.context.endpoint, query, variables, {
+        Authorization: `Bearer ${ctx.token}`,
+    });
+}

package/sdk/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * SDK module exports
+ */
+export * from './client';
+export * from './executor';

package/sdk/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * SDK module exports
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client"), exports);
+__exportStar(require("./executor"), exports);

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  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  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    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  ";

package/utils/display.js

@@ -18,6 +18,11 @@ exports.usageText = `
   Jobs:
     jobs up            Start combined server (jobs runtime)
 
+  Execution Engine:
+    context            Manage contexts (create, list, use, current, delete)
+    auth               Manage authentication (set-token, status, logout)
+    execute            Execute GraphQL queries against configured endpoints
+
   Global Options:
     -h, --help         Display this help information
     -v, --version      Display version information
@@ -35,6 +40,11 @@ exports.usageText = `
     cnc get-graphql-schema --out schema.graphql  Export schema SDL
     cnc jobs up                       Start combined server (jobs runtime)
 
+    # Execution Engine
+    cnc context create my-api --endpoint https://api.example.com/graphql
+    cnc auth set-token
+    cnc execute --query 'query { __typename }'
+
   Database Operations:
     For database migrations, packages, and deployment, use pgpm:
     https://pgpm.io