@synergenius/flow-weaver 0.30.6 → 0.30.8

package/dist/cli/flow-weaver.mjs

@@ -5987,7 +5987,7 @@ var VERSION;
 var init_generated_version = __esm({
   "src/generated-version.ts"() {
     "use strict";
-    VERSION = "0.30.6";
+    VERSION = "0.30.8";
   }
 });
 
@@ -88935,7 +88935,7 @@ function parseIntStrict(value) {
 // src/cli/index.ts
 init_logger();
 init_error_utils();
-var version2 = true ? "0.30.6" : "0.0.0-dev";
+var version2 = true ? "0.30.8" : "0.0.0-dev";
 var program2 = new Command();
 program2.name("fw").description("Flow Weaver Annotations - Compile and validate workflow files").option("-v, --version", "Output the current version").option("--no-color", "Disable colors").option("--color", "Force colors").on("option:version", () => {
   logger.banner(version2);

package/dist/generated-version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.30.6";
+export declare const VERSION = "0.30.8";
 //# sourceMappingURL=generated-version.d.ts.map

package/dist/generated-version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/generate-version.ts — do not edit manually
-export const VERSION = '0.30.6';
+export const VERSION = '0.30.8';
 //# sourceMappingURL=generated-version.js.map

package/dist/npm-packages.d.ts

@@ -15,6 +15,8 @@ export type TNpmPackagePort = {
     type: TDataType;
     direction: 'INPUT' | 'OUTPUT';
     scope?: string;
+    defaultOrder?: number;
+    failure?: boolean;
 };
 /**
  * Node type for npm package functions

package/dist/npm-packages.js

@@ -115,6 +115,7 @@ function inferNodeTypeFromDtsFunction(fn, packageName) {
         reference: 'execute',
         type: 'STEP',
         direction: 'INPUT',
+        defaultOrder: 0,
     });
     // Infer inputs from parameters
     for (const param of fn.getParameters()) {
@@ -142,25 +143,23 @@ function inferNodeTypeFromDtsFunction(fn, packageName) {
         }
     }
     const unwrappedText = returnType.getText();
-    if (unwrappedText !== 'void' && unwrappedText !== 'undefined') {
+    if (unwrappedText !== 'void' && unwrappedText !== 'undefined' && unwrappedText !== 'never') {
         const isPrimitive = PRIMITIVE_TYPES.has(unwrappedText);
         const isArray = unwrappedText.endsWith('[]') || unwrappedText.startsWith('Array<');
         const properties = returnType.getProperties();
         const isObjectLike = !isPrimitive && !isArray && returnType.isObject() && properties.length > 0;
-        if (isObjectLike) {
-            // Multiple output ports from object properties
-            for (const prop of properties) {
+        const dataProps = isObjectLike
+            ? properties.filter(p => p.getName() !== 'onSuccess' && p.getName() !== 'onFailure')
+            : [];
+        if (isObjectLike && dataProps.length <= 8) {
+            for (const prop of dataProps) {
                 const propName = prop.getName();
-                if (propName === 'onSuccess' || propName === 'onFailure')
-                    continue;
                 const propType = prop.getTypeAtLocation(fn.getTypeResolutionNode());
-                const propTypeText = propType.getText();
-                const dataType = inferDataTypeFromTS(propTypeText);
                 ports.push({
                     name: propName,
                     defaultLabel: capitalize(propName),
                     reference: propName,
-                    type: dataType,
+                    type: inferDataTypeFromTS(propType.getText()),
                     direction: 'OUTPUT',
                 });
             }
@@ -184,6 +183,7 @@ function inferNodeTypeFromDtsFunction(fn, packageName) {
         reference: 'onSuccess',
         type: 'STEP',
         direction: 'OUTPUT',
+        defaultOrder: 100,
     });
     ports.push({
         name: 'onFailure',
@@ -191,6 +191,8 @@ function inferNodeTypeFromDtsFunction(fn, packageName) {
         reference: 'onFailure',
         type: 'STEP',
         direction: 'OUTPUT',
+        defaultOrder: 101,
+        failure: true,
     });
     return {
         name: `npm/${packageName}/${fnName}`,
@@ -244,10 +246,12 @@ export function getPackageExports(packageName, workdir, nodeModulesOverride) {
         const nodeTypes = [];
         const seenFunctionNames = new Set();
         // First pass: try symbol-based enumeration (handles re-exports, declare const, etc.)
+        // Maximum data output ports before collapsing to a single "result" port
+        const MAX_DATA_OUTPUT_PORTS = 8;
         const fileSymbol = dtsFile.getSymbol();
         if (fileSymbol) {
             for (const exportSymbol of fileSymbol.getExports()) {
-                const exportName = exportSymbol.getName();
+                let exportName = exportSymbol.getName();
                 if (seenFunctionNames.has(exportName))
                     continue;
                 // Check if this export is callable (has call signatures)
@@ -255,29 +259,66 @@ export function getPackageExports(packageName, workdir, nodeModulesOverride) {
                 const callSignatures = exportType.getCallSignatures();
                 if (callSignatures.length === 0)
                     continue;
+                // Handle export= (CJS): skip namespaces, include single functions
+                if (exportName === 'export=') {
+                    // If the type has many non-call properties, it's a namespace (lodash)
+                    const props = exportType.getProperties().filter(p => !p.getName().startsWith('__'));
+                    if (props.length > 5)
+                        continue; // Namespace with many methods — skip
+                    // Try to get the real name from the declaration
+                    const decl = exportSymbol.getValueDeclaration();
+                    const declName = decl && 'getName' in decl ? decl.getName?.() : undefined;
+                    if (declName && declName !== 'export=') {
+                        exportName = declName;
+                    }
+                    else {
+                        // Try aliased declarations
+                        const aliased = exportSymbol.getAliasedSymbol?.();
+                        const aliasedName = aliased?.getName();
+                        if (aliasedName && aliasedName !== 'export=' && aliasedName !== '__type') {
+                            exportName = aliasedName;
+                        }
+                        else {
+                            continue; // Can't determine a useful name — skip
+                        }
+                    }
+                }
+                // Handle default exports: resolve to the actual function name
+                if (exportName === 'default') {
+                    const decl = exportSymbol.getValueDeclaration();
+                    const declName = decl && 'getName' in decl ? decl.getName?.() : undefined;
+                    if (declName && declName !== 'default') {
+                        exportName = declName;
+                    }
+                    else {
+                        const aliased = exportSymbol.getAliasedSymbol?.();
+                        const aliasedName = aliased?.getName();
+                        if (aliasedName && aliasedName !== 'default' && aliasedName !== '__type') {
+                            exportName = aliasedName;
+                        }
+                        // If still "default", keep it — some packages genuinely have unnamed default exports
+                    }
+                }
+                if (seenFunctionNames.has(exportName))
+                    continue;
                 seenFunctionNames.add(exportName);
                 // Use the first call signature to infer ports
                 const sig = callSignatures[0];
                 const ports = [];
                 // Execute input port
                 ports.push({
-                    name: 'execute',
-                    defaultLabel: 'Execute',
-                    reference: 'execute',
-                    type: 'STEP',
-                    direction: 'INPUT',
+                    name: 'execute', defaultLabel: 'Execute', reference: 'execute',
+                    type: 'STEP', direction: 'INPUT', defaultOrder: 0,
                 });
                 // Input ports from parameters
+                let inputOrder = 1;
                 for (const param of sig.getParameters()) {
                     const paramName = param.getName();
                     const paramType = param.getTypeAtLocation(dtsFile);
                     const dataType = inferDataTypeFromTS(paramType.getText());
                     ports.push({
-                        name: paramName,
-                        defaultLabel: capitalize(paramName),
-                        reference: paramName,
-                        type: dataType,
-                        direction: 'INPUT',
+                        name: paramName, defaultLabel: capitalize(paramName), reference: paramName,
+                        type: dataType, direction: 'INPUT', defaultOrder: inputOrder++,
                     });
                 }
                 // Output ports from return type
@@ -290,50 +331,41 @@ export function getPackageExports(packageName, workdir, nodeModulesOverride) {
                     if (typeArgs.length > 0)
                         returnType = typeArgs[0];
                 }
+                let outputOrder = 0;
                 const unwrapped = returnType.getText();
-                if (unwrapped !== 'void' && unwrapped !== 'undefined') {
+                if (unwrapped !== 'void' && unwrapped !== 'undefined' && unwrapped !== 'never') {
                     const isPrimitive = PRIMITIVE_TYPES.has(unwrapped);
                     const isArray = unwrapped.endsWith('[]') || unwrapped.startsWith('Array<');
                     const properties = returnType.getProperties();
                     const isObjectLike = !isPrimitive && !isArray && returnType.isObject() && properties.length > 0;
-                    if (isObjectLike) {
-                        for (const prop of properties) {
+                    const dataProps = isObjectLike
+                        ? properties.filter(p => p.getName() !== 'onSuccess' && p.getName() !== 'onFailure')
+                        : [];
+                    if (isObjectLike && dataProps.length <= MAX_DATA_OUTPUT_PORTS) {
+                        for (const prop of dataProps) {
                             const propName = prop.getName();
-                            if (propName === 'onSuccess' || propName === 'onFailure')
-                                continue;
                             const propType = prop.getTypeAtLocation(dtsFile);
                             ports.push({
-                                name: propName,
-                                defaultLabel: capitalize(propName),
-                                reference: propName,
-                                type: inferDataTypeFromTS(propType.getText()),
-                                direction: 'OUTPUT',
+                                name: propName, defaultLabel: capitalize(propName), reference: propName,
+                                type: inferDataTypeFromTS(propType.getText()), direction: 'OUTPUT', defaultOrder: outputOrder++,
                             });
                         }
                     }
                     else {
+                        // Single result port: either primitive/array, or object with too many properties
                         ports.push({
-                            name: 'result',
-                            defaultLabel: 'Result',
-                            reference: 'result',
-                            type: inferDataTypeFromTS(unwrapped),
-                            direction: 'OUTPUT',
+                            name: 'result', defaultLabel: 'Result', reference: 'result',
+                            type: inferDataTypeFromTS(unwrapped), direction: 'OUTPUT', defaultOrder: outputOrder++,
                         });
                     }
                 }
                 ports.push({
-                    name: 'onSuccess',
-                    defaultLabel: 'On Success',
-                    reference: 'onSuccess',
-                    type: 'STEP',
-                    direction: 'OUTPUT',
+                    name: 'onSuccess', defaultLabel: 'On Success', reference: 'onSuccess',
+                    type: 'STEP', direction: 'OUTPUT', defaultOrder: 100,
                 });
                 ports.push({
-                    name: 'onFailure',
-                    defaultLabel: 'On Failure',
-                    reference: 'onFailure',
-                    type: 'STEP',
-                    direction: 'OUTPUT',
+                    name: 'onFailure', defaultLabel: 'On Failure', reference: 'onFailure',
+                    type: 'STEP', direction: 'OUTPUT', defaultOrder: 101, failure: true,
                 });
                 nodeTypes.push({
                     name: `npm/${packageName}/${exportName}`,
@@ -370,16 +402,14 @@ export function getPackageExports(packageName, workdir, nodeModulesOverride) {
                 seenFunctionNames.add(exportName);
                 const sig = callSignatures[0];
                 const ports = [];
-                ports.push({ name: 'execute', defaultLabel: 'Execute', reference: 'execute', type: 'STEP', direction: 'INPUT' });
+                ports.push({ name: 'execute', defaultLabel: 'Execute', reference: 'execute', type: 'STEP', direction: 'INPUT', defaultOrder: 0 });
+                let starInputOrder = 1;
                 for (const param of sig.getParameters()) {
                     const paramName = param.getName();
                     const paramType = param.getTypeAtLocation(targetFile);
                     ports.push({
-                        name: paramName,
-                        defaultLabel: capitalize(paramName),
-                        reference: paramName,
-                        type: inferDataTypeFromTS(paramType.getText()),
-                        direction: 'INPUT',
+                        name: paramName, defaultLabel: capitalize(paramName), reference: paramName,
+                        type: inferDataTypeFromTS(paramType.getText()), direction: 'INPUT', defaultOrder: starInputOrder++,
                     });
                 }
                 let returnType = sig.getReturnType();
@@ -392,11 +422,11 @@ export function getPackageExports(packageName, workdir, nodeModulesOverride) {
                         returnType = typeArgs[0];
                 }
                 const unwrapped = returnType.getText();
-                if (unwrapped !== 'void' && unwrapped !== 'undefined') {
-                    ports.push({ name: 'result', defaultLabel: 'Result', reference: 'result', type: inferDataTypeFromTS(unwrapped), direction: 'OUTPUT' });
+                if (unwrapped !== 'void' && unwrapped !== 'undefined' && unwrapped !== 'never') {
+                    ports.push({ name: 'result', defaultLabel: 'Result', reference: 'result', type: inferDataTypeFromTS(unwrapped), direction: 'OUTPUT', defaultOrder: 0 });
                 }
-                ports.push({ name: 'onSuccess', defaultLabel: 'On Success', reference: 'onSuccess', type: 'STEP', direction: 'OUTPUT' });
-                ports.push({ name: 'onFailure', defaultLabel: 'On Failure', reference: 'onFailure', type: 'STEP', direction: 'OUTPUT' });
+                ports.push({ name: 'onSuccess', defaultLabel: 'On Success', reference: 'onSuccess', type: 'STEP', direction: 'OUTPUT', defaultOrder: 100 });
+                ports.push({ name: 'onFailure', defaultLabel: 'On Failure', reference: 'onFailure', type: 'STEP', direction: 'OUTPUT', defaultOrder: 101, failure: true });
                 nodeTypes.push({
                     name: `npm/${packageName}/${exportName}`,
                     variant: 'FUNCTION',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flow-weaver",
-  "version": "0.30.6",
+  "version": "0.30.8",
   "description": "Flow Weaver: deterministic TypeScript workflow compiler. Define workflows with JSDoc annotations, compile to standalone functions with zero runtime dependencies.",
   "private": false,
   "type": "module",