@sembix/cli 1.5.0 → 1.5.1

package/dist/utils/input-parser.js

@@ -1,34 +1,165 @@
 /**
- * Parse workflow inputs from JSON string and detect format.
- * Supports two formats:
- * 1. Simple key-value object: {"key": "value"} -> maps to inputVariables (deprecated)
- * 2. InitialInstructions array: [{"id": "x", "instruction": "value"}] -> maps to initialInstructions
- * 3. Complete StartWorkflowConfiguration object with initialInstructions or workspaceMetadata
+ * Parse workflow inputs from JSON string with automatic format detection.
  *
- * @param inputsJson - JSON string containing workflow inputs
- * @returns StartWorkflowConfiguration object ready to send to API
+ * Supports three input formats:
+ * 1. ID-based array: [{"id": "var_123", "instruction": "value"}]
+ * 2. Name-based object: {"repositoryUrl": "value"} (requires template)
+ * 3. Complete configuration: {"initialInstructions": [...], "workspaceMetadata": {...}}
+ *
+ * @param options.inputsJson - JSON string containing workflow inputs
+ * @param options.template - Template instructions (required for name-based format)
+ * @returns StartWorkflowConfiguration with initialInstructions
  * @throws Error if JSON is invalid or format is unrecognized
  */
-export function parseWorkflowInputs(inputsJson) {
+export function parseWorkflowInputs(options) {
+    const { inputsJson, template, validate = false } = options;
     const parsed = JSON.parse(inputsJson);
-    // Detect format by structure
+    let initialInstructions;
+    let preserveFullConfig = false;
+    let fullConfig;
+    // Format 1: Array → ID-based initialInstructions
     if (Array.isArray(parsed)) {
-        // Array format → InitialInstructions
-        return {
-            initialInstructions: parsed
-        };
-    }
-    else if (typeof parsed === 'object' && parsed !== null) {
-        // Check if it's already a complete StartWorkflowConfiguration
-        if ('initialInstructions' in parsed || 'workspaceMetadata' in parsed || 'inputVariables' in parsed) {
-            // Already in correct format
-            return parsed;
+        initialInstructions = parsed;
+    }
+    // Validate object type before checking properties
+    else if (typeof parsed !== 'object' || parsed === null) {
+        throw new Error('Invalid input format. Expected object or array.');
+    }
+    // Format 2: Complete configuration (has config fields)
+    else if ('initialInstructions' in parsed || 'workspaceMetadata' in parsed) {
+        fullConfig = parsed;
+        initialInstructions = parsed.initialInstructions;
+        preserveFullConfig = true;
+    }
+    // Format 3: Name-based object (needs template resolution)
+    else {
+        if (!template || template.length === 0) {
+            throw new Error('Cannot resolve input variable names: name-based format requires workflow template.\n\n' +
+                'Either:\n' +
+                '  1. Use ID-based format: --inputs \'[{"id": "var_123", "instruction": "value"}]\'\n' +
+                '  2. Run interactively to see input prompts\n\n' +
+                'To see available IDs:\n' +
+                '  sembix workflow template show --project-id <id> --workflow-id <id>');
         }
-        // Simple key-value object → Legacy inputVariables
-        return {
-            inputVariables: parsed
-        };
+        // Resolve names to IDs
+        initialInstructions = resolveNames(parsed, template);
+    }
+    // Validate and normalize inputs if requested and template is available
+    if (validate && template && template.length > 0) {
+        initialInstructions = validateWorkflowInputs(initialInstructions, template);
+    }
+    // Build and return configuration
+    if (preserveFullConfig) {
+        // Preserve all fields from original config, update initialInstructions if present
+        if (initialInstructions) {
+            return {
+                ...fullConfig,
+                initialInstructions
+            };
+        }
+        return fullConfig;
+    }
+    return { initialInstructions };
+}
+/**
+ * Internal helper: Resolve input variable names to IDs using template.
+ *
+ * @param inputVariables - Object with input variable names as keys
+ * @param templateInstructions - Array of template instructions with id/name mappings
+ * @returns Array of InitialInstructions with resolved IDs
+ * @throws Error if input name not found in template
+ */
+function resolveNames(inputVariables, templateInstructions) {
+    const resolvedInstructions = [];
+    const availableNames = templateInstructions.map(t => t.name).filter(Boolean);
+    for (const [inputName, inputValue] of Object.entries(inputVariables)) {
+        // Find matching template instruction by name (case-sensitive)
+        const matchingInstruction = templateInstructions.find(t => t.name === inputName);
+        if (!matchingInstruction) {
+            throw new Error(`Input variable name "${inputName}" not found in workflow template.\n\n` +
+                `Available input variables:\n` +
+                availableNames.map(name => `  - ${name}`).join('\n') +
+                '\n\n' +
+                'To see full details:\n' +
+                '  sembix workflow template show --project-id <id> --workflow-id <id>');
+        }
+        // Create a full InitialInstructions object with all fields from template
+        // and the user-provided instruction value
+        resolvedInstructions.push({
+            id: matchingInstruction.id,
+            name: matchingInstruction.name,
+            description: matchingInstruction.description,
+            instruction: inputValue,
+            dataType: matchingInstruction.dataType,
+            isRequired: matchingInstruction.isRequired
+        });
+    }
+    return resolvedInstructions;
+}
+/**
+ * Validate workflow inputs against template requirements.
+ * Ensures required fields have values and data types are correct.
+ * Fills in optional fields with empty strings if not provided.
+ *
+ * @param instructions - Array of initial instructions to validate
+ * @param template - Template instructions with requirements
+ * @returns Validated and normalized instructions
+ * @throws Error if validation fails
+ */
+export function validateWorkflowInputs(instructions, template) {
+    const validated = [];
+    const errors = [];
+    // Create map of provided instructions by ID
+    const providedMap = new Map(instructions.map(i => [i.id, i]));
+    // Iterate through template to validate all fields
+    for (const templateInstr of template) {
+        const provided = providedMap.get(templateInstr.id);
+        const value = provided?.instruction;
+        // Validate required fields
+        if (templateInstr.isRequired) {
+            if (value === undefined || value === null || value === '') {
+                errors.push(`Required input "${templateInstr.name}" is missing or empty`);
+                continue;
+            }
+            // Validate boolean fields
+            if (templateInstr.dataType === 'boolean') {
+                if (typeof value === 'boolean') {
+                    // Convert boolean to string for API
+                    validated.push({
+                        ...templateInstr,
+                        instruction: String(value)
+                    });
+                }
+                else if (value === 'true' || value === 'false') {
+                    validated.push({
+                        ...templateInstr,
+                        instruction: value
+                    });
+                }
+                else {
+                    errors.push(`Input "${templateInstr.name}" must be true or false (got: ${value})`);
+                }
+                continue;
+            }
+        }
+        // Handle optional fields - always include with empty string if not provided
+        if (!templateInstr.isRequired && (value === undefined || value === null)) {
+            validated.push({
+                ...templateInstr,
+                instruction: ''
+            });
+            continue;
+        }
+        // For provided values, pass through with template metadata
+        validated.push({
+            ...templateInstr,
+            instruction: value !== undefined ? value : ''
+        });
+    }
+    if (errors.length > 0) {
+        throw new Error('Input validation failed:\n' +
+            errors.map(e => `  - ${e}`).join('\n'));
     }
-    throw new Error('Invalid input format. Expected object or array.');
+    return validated;
 }
 //# sourceMappingURL=input-parser.js.map

package/dist/utils/input-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"input-parser.js","sourceRoot":"","sources":["../../src/utils/input-parser.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAEtC,6BAA6B;IAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,qCAAqC;QACrC,OAAO;YACL,mBAAmB,EAAE,MAAM;SAC5B,CAAC;IACJ,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACzD,8DAA8D;QAC9D,IAAI,qBAAqB,IAAI,MAAM,IAAI,mBAAmB,IAAI,MAAM,IAAI,gBAAgB,IAAI,MAAM,EAAE,CAAC;YACnG,4BAA4B;YAC5B,OAAO,MAAoC,CAAC;QAC9C,CAAC;QAED,kDAAkD;QAClD,OAAO;YACL,cAAc,EAAE,MAAM;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"input-parser.js","sourceRoot":"","sources":["../../src/utils/input-parser.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sembix/cli",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "CLI tool for managing Sembix products",
   "type": "module",
   "bin": {