@ductape/cli 0.3.10 → 0.3.11

package/dist/commands/graph.d.ts

@@ -1,3 +1,7 @@
+export declare function validateGraphActionFile(file: string | undefined, body: Record<string, unknown>): {
+    graphTag: string;
+    actionTag: string;
+};
 export declare function runGraph(method: string, opts: {
     file?: string;
     json?: boolean;

package/dist/commands/graph.js

@@ -3,16 +3,80 @@ import { setGraphContext } from '../lib/context-store.js';
 import { GRAPH_PROXY_METHODS } from '../lib/db-methods.js';
 import { getGraphProxy, requireSession } from '../lib/proxy/context.js';
 import { printJson } from '../lib/output.js';
+import path from 'node:path';
+const GRAPH_ACTION_FIELDS = new Set(['graphTag', 'name', 'description', 'operation', 'query', 'parameters']);
+function actionSlug(name) {
+    return name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+}
+export function validateGraphActionFile(file, body) {
+    if (!file)
+        throw new Error('Graph action validation requires -f ductape/graphs/<graph-tag>/actions/<action-tag>.action.json');
+    for (const field of ['graphTag', 'name', 'operation', 'query', 'parameters']) {
+        if (!(field in body))
+            throw new Error(`Graph action is missing required field "${field}"`);
+    }
+    for (const field of Object.keys(body)) {
+        if (!GRAPH_ACTION_FIELDS.has(field))
+            throw new Error(`Unknown graph action field "${field}"`);
+    }
+    if (typeof body.graphTag !== 'string' || !body.graphTag)
+        throw new Error('graphTag must be a non-empty string');
+    if (typeof body.name !== 'string' || !body.name)
+        throw new Error('name must be a non-empty string');
+    if (typeof body.operation !== 'string' || !body.operation)
+        throw new Error('operation must be a non-empty string');
+    if (!body.query || typeof body.query !== 'object' || Array.isArray(body.query))
+        throw new Error('query must be an object');
+    if (!Array.isArray(body.parameters))
+        throw new Error('parameters must be an array');
+    for (const [index, parameter] of body.parameters.entries()) {
+        if (!parameter || typeof parameter !== 'object' || Array.isArray(parameter))
+            throw new Error(`parameters[${index}] must be an object`);
+        const value = parameter;
+        for (const field of ['name', 'path', 'defaultValue', 'type']) {
+            if (!(field in value))
+                throw new Error(`parameters[${index}] is missing required field "${field}"`);
+        }
+        if (!['string', 'number', 'boolean', 'array', 'object'].includes(String(value.type))) {
+            throw new Error(`parameters[${index}].type is invalid`);
+        }
+    }
+    const actionTag = actionSlug(body.name);
+    const normalized = file.replaceAll('\\', '/');
+    const expectedSuffix = `ductape/graphs/${body.graphTag}/actions/${actionTag}.action.json`;
+    if (!normalized.endsWith(expectedSuffix))
+        throw new Error(`Graph action must be stored at ${expectedSuffix}`);
+    if (path.basename(file) !== `${actionTag}.action.json`)
+        throw new Error(`Graph action filename must be ${actionTag}.action.json`);
+    return { graphTag: body.graphTag, actionTag };
+}
 export async function runGraph(method, opts) {
     const session = requireSession();
     const proxy = getGraphProxy(session);
     const body = readJsonBody(opts.file);
     const m = method.includes('.') ? method : method.toLowerCase();
+    if (m === 'validateaction') {
+        const validated = validateGraphActionFile(opts.file, body);
+        printJson({ valid: true, file: opts.file, ...validated }, Boolean(opts.json));
+        return;
+    }
     if (!GRAPH_PROXY_METHODS.includes(m) && !m.includes('.')) {
         console.warn(`Method "${m}" not in known list; sending anyway. Known: ${GRAPH_PROXY_METHODS.join(', ')}`);
     }
     const params = [];
-    if (m === 'connect') {
+    if (m === 'createaction') {
+        validateGraphActionFile(opts.file, body);
+        params.push(body, session.project.product_tag);
+    }
+    else if (m === 'updateaction') {
+        const actionTag = String(body.actionTag ?? '');
+        const graphTag = String(body.graphTag ?? '');
+        if (!actionTag || !graphTag || !body.updates || typeof body.updates !== 'object') {
+            throw new Error('updateAction requires { "actionTag", "graphTag", "updates": { ... } }');
+        }
+        params.push(actionTag, body.updates, graphTag, session.project.product_tag);
+    }
+    else if (m === 'connect') {
         const cfg = {
             product: session.project.product_tag,
             env: session.project.env_slug,

package/dist/index.js

@@ -735,7 +735,7 @@ db
 }));
 const graph = program.command('graph').description('Graph runtime (graph-proxy)');
 graph
-    .argument('<verb>', 'connect | query | …')
+    .argument('<verb>', 'connect | query | createAction | validateAction | updateAction | …')
     .option('-f, --file <path>')
     .option('--json', 'JSON output')
     .action(wrap((verb, opts) => runGraph(verb, { file: opts.file, json: opts.json })));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ductape/cli",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "Ductape CLI — local platform, login, link projects, and manage resources via the proxy (Workbench-compatible)",
   "type": "module",
   "main": "dist/index.js",