@winkjs/composer 0.5.1 → 0.6.0

package/src/flow/flow.js

@@ -91,7 +91,7 @@ const flow = function ( flowName = 'flow1' ) {
     const enforceConfigFirst = function ( methodName ) {
         if ( pipelineStarted ) {
             throw new Error(
-                `WinkComposer/flow: .${methodName}() must be called before any nodes or .switch()/.groupBy()`
+                `winkComposer/flow: .${methodName}() must be called before any nodes or .switch()/.groupBy()`
             );
         }
     };
@@ -100,11 +100,11 @@ const flow = function ( flowName = 'flow1' ) {
     const validateSwitchComplete = function () {
         if ( switchState.active ) {
             if ( switchState.caseOrder.length === 0 ) {
-                throw new Error( 'WinkComposer/flow: .switch() requires at least one .case()' );
+                throw new Error( 'winkComposer/flow: .switch() requires at least one .case()' );
             }
             if ( !switchState.caseEnded ) {
                 throw new Error(
-                    `WinkComposer/flow: case '${switchState.currentCase}' must end with .break()`
+                    `winkComposer/flow: case '${switchState.currentCase}' must end with .break()`
                 );
             }
         }
@@ -118,7 +118,7 @@ const flow = function ( flowName = 'flow1' ) {
         const collisions = collectFlowOutputCollisions( switchState, flowDefinition );
         if ( collisions.length > 0 ) {
             throw new Error(
-                'WinkComposer/flow: output field collision(s) - two nodes on one path ' +
+                'winkComposer/flow: output field collision(s) - two nodes on one path ' +
                 'write the same message field:\n  - ' + collisions.join( '\n  - ' )
             );
         }
@@ -160,10 +160,10 @@ const flow = function ( flowName = 'flow1' ) {
     api.source = function ( adapter, sourceConfig = {} ) {
         enforceConfigFirst( 'source' );
         if ( typeof adapter !== 'object' || adapter === null ) {
-            throw new Error( 'WinkComposer/flow: source adapter must be an imported module' );
+            throw new Error( 'winkComposer/flow: source adapter must be an imported module' );
         }
         if ( typeof adapter.start !== 'function' ) {
-            throw new Error( 'WinkComposer/flow: source adapter must have a start() function' );
+            throw new Error( 'winkComposer/flow: source adapter must have a start() function' );
         }
 
         // If the adapter provides a configSchema, we validate config here.
@@ -171,7 +171,7 @@ const flow = function ( flowName = 'flow1' ) {
         // not later inside adapter.start().
         if ( adapter.configSchema ) {
             const validation = validateWithSchema( adapter.configSchema, sourceConfig, 'source' );
-            validation.throwIfInvalid( `flow/source:${adapter.id || 'unknown'}` );
+            validation.throwIfInvalid( `flow.source.${adapter.id || 'unknown'}` );
         }
 
         runtime.source = { adapter, config: sourceConfig };
@@ -181,13 +181,13 @@ const flow = function ( flowName = 'flow1' ) {
     api.emitter = function ( adapter, emitterConfig = {} ) {
         enforceConfigFirst( 'emitter' );
         if ( typeof adapter !== 'object' || adapter === null ) {
-            throw new Error( 'WinkComposer/flow: emitter adapter must be an imported module' );
+            throw new Error( 'winkComposer/flow: emitter adapter must be an imported module' );
         }
         if ( typeof adapter.id !== 'string' || !adapter.id ) {
-            throw new Error( 'WinkComposer/flow: emitter adapter must have an id' );
+            throw new Error( 'winkComposer/flow: emitter adapter must have an id' );
         }
         if ( typeof adapter.createEmitter !== 'function' ) {
-            throw new Error( 'WinkComposer/flow: emitter adapter must have a createEmitter() function' );
+            throw new Error( 'winkComposer/flow: emitter adapter must have a createEmitter() function' );
         }
 
         // If the adapter provides a configSchema, we validate config here.
@@ -195,7 +195,7 @@ const flow = function ( flowName = 'flow1' ) {
         // not later inside adapter.createEmitter().
         if ( adapter.configSchema ) {
             const validation = validateWithSchema( adapter.configSchema, emitterConfig, 'emitter' );
-            validation.throwIfInvalid( `flow/emitter:${adapter.id}` );
+            validation.throwIfInvalid( `flow.emitter.${adapter.id}` );
         }
 
         runtime.emitters[ adapter.id ] = { adapter, config: emitterConfig };
@@ -205,13 +205,13 @@ const flow = function ( flowName = 'flow1' ) {
     api.storage = function ( adapter, storageConfig = {} ) {
         enforceConfigFirst( 'storage' );
         if ( typeof adapter !== 'object' || adapter === null ) {
-            throw new Error( 'WinkComposer/flow: storage adapter must be an imported module' );
+            throw new Error( 'winkComposer/flow: storage adapter must be an imported module' );
         }
         if ( typeof adapter.id !== 'string' || !adapter.id ) {
-            throw new Error( 'WinkComposer/flow: storage adapter must have an id' );
+            throw new Error( 'winkComposer/flow: storage adapter must have an id' );
         }
         if ( typeof adapter.createStorage !== 'function' ) {
-            throw new Error( 'WinkComposer/flow: storage adapter must have a createStorage() function' );
+            throw new Error( 'winkComposer/flow: storage adapter must have a createStorage() function' );
         }
 
         // If the adapter provides a configSchema, we validate config here.
@@ -219,7 +219,7 @@ const flow = function ( flowName = 'flow1' ) {
         // not later inside adapter.createStorage().
         if ( adapter.configSchema ) {
             const validation = validateWithSchema( adapter.configSchema, storageConfig, 'storage' );
-            validation.throwIfInvalid( `flow/storage:${adapter.id}` );
+            validation.throwIfInvalid( `flow.storage.${adapter.id}` );
         }
 
         runtime.storages[ adapter.id ] = { adapter, config: storageConfig };
@@ -230,7 +230,7 @@ const flow = function ( flowName = 'flow1' ) {
         enforceConfigFirst( 'assetId' );
 
         if ( typeof field !== 'string' || field.length === 0 ) {
-            throw new Error( 'WinkComposer/flow: .assetId() requires a non-empty string field name' );
+            throw new Error( 'winkComposer/flow: .assetId() requires a non-empty string field name' );
         }
 
         // Schema-based validation for robust error handling
@@ -251,7 +251,7 @@ const flow = function ( flowName = 'flow1' ) {
         if ( assetClassDef === null || assetClassDef === undefined || typeof assetClassDef !== 'object' ) {
             const actualType = assetClassDef === null ? 'null' : typeof assetClassDef;
             throw new Error(
-                `WinkComposer/flow.assetClass: Expected object, got ${actualType}`
+                `winkComposer/flow.assetClass: Expected object, got ${actualType}`
             );
         }
 
@@ -266,7 +266,7 @@ const flow = function ( flowName = 'flow1' ) {
         const validation = validateWithSchema( assetClassSchema, assetClassDef, 'assetClass' );
         if ( !validation.valid ) {
             throw new Error(
-                `WinkComposer/flow.assetClass: validation failed:\n  - ${validation.errors.join( '\n  - ' )}`
+                `winkComposer/flow.assetClass: validation failed:\n  - ${validation.errors.join( '\n  - ' )}`
             );
         }
 
@@ -298,7 +298,7 @@ const flow = function ( flowName = 'flow1' ) {
      */
     api.switch = function ( field ) {
         if ( typeof field !== 'string' || field.length === 0 ) {
-            throw new Error( 'WinkComposer/flow: .switch() requires a non-empty string field name' );
+            throw new Error( 'winkComposer/flow: .switch() requires a non-empty string field name' );
         }
 
         // Schema-based validation: field must be a valid identifier (mirrors .assetId())
@@ -307,21 +307,21 @@ const flow = function ( flowName = 'flow1' ) {
 
         // Check groupBy before switchState (endGroup sets switchState.active)
         if ( groupByState.active || groupByState.expanded ) {
-            throw new Error( 'WinkComposer/flow: .switch() cannot be used with .groupBy()' );
+            throw new Error( 'winkComposer/flow: .switch() cannot be used with .groupBy()' );
         }
         if ( switchState.active ) {
-            throw new Error( 'WinkComposer/flow: .switch() can only be called once per flow' );
+            throw new Error( 'winkComposer/flow: .switch() can only be called once per flow' );
         }
         if ( flowDefinition.length > 0 ) {
             throw new Error(
-                'WinkComposer/flow: .switch() cannot be called after nodes - ' +
+                'winkComposer/flow: .switch() cannot be called after nodes - ' +
                 'use .switch() before defining any nodes, or omit .switch() for single-pipeline flows'
             );
         }
 
         // Validate field conflict with partition
         if ( runtime.partitionField === field ) {
-            throw new Error( 'WinkComposer/flow: partition field and switch field must be different' );
+            throw new Error( 'winkComposer/flow: partition field and switch field must be different' );
         }
 
         runtime.specializationField = field;
@@ -340,15 +340,15 @@ const flow = function ( flowName = 'flow1' ) {
      */
     api.case = function ( key ) {
         if ( !switchState.active ) {
-            throw new Error( 'WinkComposer/flow: .case() requires an active .switch()' );
+            throw new Error( 'winkComposer/flow: .case() requires an active .switch()' );
         }
         if ( switchState.currentCase !== null && !switchState.caseEnded ) {
             throw new Error(
-                `WinkComposer/flow: previous case '${switchState.currentCase}' must end with .break() before starting a new case`
+                `winkComposer/flow: previous case '${switchState.currentCase}' must end with .break() before starting a new case`
             );
         }
         if ( switchState.caseSpecs[ key ] !== undefined ) {
-            throw new Error( `WinkComposer/flow: duplicate case key '${key}'` );
+            throw new Error( `winkComposer/flow: duplicate case key '${key}'` );
         }
 
         switchState.currentCase = key;
@@ -367,14 +367,14 @@ const flow = function ( flowName = 'flow1' ) {
      */
     api.break = function () {
         if ( !switchState.active ) {
-            throw new Error( 'WinkComposer/flow: .break() requires an active .switch()' );
+            throw new Error( 'winkComposer/flow: .break() requires an active .switch()' );
         }
         if ( switchState.currentCase === null || switchState.caseEnded ) {
-            throw new Error( 'WinkComposer/flow: .break() must follow a .case() with at least one node' );
+            throw new Error( 'winkComposer/flow: .break() must follow a .case() with at least one node' );
         }
         if ( switchState.caseSpecs[ switchState.currentCase ].length === 0 ) {
             throw new Error(
-                `WinkComposer/flow: case '${switchState.currentCase}' is empty - add at least one node before .break()`
+                `winkComposer/flow: case '${switchState.currentCase}' is empty - add at least one node before .break()`
             );
         }
 
@@ -408,7 +408,7 @@ const flow = function ( flowName = 'flow1' ) {
     api.groupBy = function ( field, values ) {
         // Validation: field must be non-empty string
         if ( typeof field !== 'string' || field.length === 0 ) {
-            throw new Error( 'WinkComposer/flow: .groupBy() requires a non-empty string field name' );
+            throw new Error( 'winkComposer/flow: .groupBy() requires a non-empty string field name' );
         }
 
         // Schema-based validation: field must be a valid identifier (mirrors .assetId())
@@ -417,14 +417,14 @@ const flow = function ( flowName = 'flow1' ) {
 
         // Validation: values must be array with at least 2 elements
         if ( !Array.isArray( values ) || values.length < 2 ) {
-            throw new Error( 'WinkComposer/flow: .groupBy() requires at least 2 group values' );
+            throw new Error( 'winkComposer/flow: .groupBy() requires at least 2 group values' );
         }
 
         // Validation: each value must be string or number
         for ( let i = 0; i < values.length; i += 1 ) {
             const v = values[ i ];
             if ( typeof v !== 'string' && typeof v !== 'number' ) {
-                throw new Error( `WinkComposer/flow: group value at index ${i} must be a string or number` );
+                throw new Error( `winkComposer/flow: group value at index ${i} must be a string or number` );
             }
         }
 
@@ -433,32 +433,32 @@ const flow = function ( flowName = 'flow1' ) {
         for ( let i = 0; i < values.length; i += 1 ) {
             const v = values[ i ];
             if ( seen[ v ] ) {
-                throw new Error( `WinkComposer/flow: duplicate group value '${v}' in .groupBy()` );
+                throw new Error( `winkComposer/flow: duplicate group value '${v}' in .groupBy()` );
             }
             seen[ v ] = 1;
         }
 
         // Validation: cannot call groupBy twice (check this first - user intent is to reuse groupBy)
         if ( groupByState.active || groupByState.expanded ) {
-            throw new Error( 'WinkComposer/flow: .groupBy() can only be called once per flow' );
+            throw new Error( 'winkComposer/flow: .groupBy() can only be called once per flow' );
         }
 
         // Validation: cannot use groupBy if switchState is active (manual switch, not from endGroup)
         if ( switchState.active ) {
-            throw new Error( 'WinkComposer/flow: .groupBy() cannot be used inside .switch()' );
+            throw new Error( 'winkComposer/flow: .groupBy() cannot be used inside .switch()' );
         }
 
         // Validation: must come before any nodes
         if ( flowDefinition.length > 0 ) {
             throw new Error(
-                'WinkComposer/flow: .groupBy() cannot be called after nodes - ' +
+                'winkComposer/flow: .groupBy() cannot be called after nodes - ' +
                 'use .groupBy() before defining any nodes'
             );
         }
 
         // Validation: groupBy field cannot equal partition field
         if ( runtime.partitionField === field ) {
-            throw new Error( 'WinkComposer/flow: partition field and groupBy field must be different' );
+            throw new Error( 'winkComposer/flow: partition field and groupBy field must be different' );
         }
 
         // Initialize groupBy state
@@ -487,12 +487,12 @@ const flow = function ( flowName = 'flow1' ) {
     api.endGroup = function () {
         // Validation: must be in active groupBy state
         if ( !groupByState.active ) {
-            throw new Error( 'WinkComposer/flow: .endGroup() requires an active .groupBy()' );
+            throw new Error( 'winkComposer/flow: .endGroup() requires an active .groupBy()' );
         }
 
         // Validation: must have at least one template node
         if ( groupByState.templateSpecs.length === 0 ) {
-            throw new Error( 'WinkComposer/flow: .groupBy() must contain at least one node before .endGroup()' );
+            throw new Error( 'winkComposer/flow: .groupBy() must contain at least one node before .endGroup()' );
         }
 
         // Set specialization field (same as switch does)
@@ -553,7 +553,7 @@ const flow = function ( flowName = 'flow1' ) {
 
         // Single-pipeline mode (backward compatible)
         if ( flowDefinition.length === 0 ) {
-            throw new Error( 'WinkComposer/flow: Cannot build empty flow - add at least one node' );
+            throw new Error( 'winkComposer/flow: Cannot build empty flow - add at least one node' );
         }
         const imports = Array.from( importSet ).sort();
         return serializeModule( { imports, flowName, specs: flowDefinition } );
@@ -646,7 +646,7 @@ const flow = function ( flowName = 'flow1' ) {
 
         // Single-pipeline mode (backward compatible)
         if ( flowDefinition.length === 0 ) {
-            throw new Error( 'WinkComposer/flow: Cannot run empty flow - add at least one node' );
+            throw new Error( 'winkComposer/flow: Cannot run empty flow - add at least one node' );
         }
         const handle = await runFlow( flowName, flowDefinition, importSet, runtime );
         return handle;

package/src/flow/for-each.js

@@ -31,6 +31,7 @@ import { getSignaturePattern } from './get-signature-pattern.js';
 import { specBuilder } from './spec-builder.js';
 import { getTargetArray } from './get-target-array.js';
 import { resolvePickByField } from './resolve-pick-by-field.js';
+import { logger } from '../core/logger/index.js';
 
 /**
  * Locate the index of a named argument slot in a signature schema (the source of
@@ -90,7 +91,7 @@ export const makeForEach = function ( api, flowState ) {
             // rather than emit a silently-wrong per-field controller.
             if ( pattern === SIGNATURE_PATTERNS.nameLogic ) {
                 throw new Error(
-                    `WinkComposer/flow: forEach cannot fan a controller ('${args[ 0 ]}'); ` +
+                    `winkComposer/flow: forEach cannot fan a controller ('${args[ 0 ]}'); ` +
                     'fan data-processing nodes only.'
                 );
             }
@@ -109,7 +110,7 @@ export const makeForEach = function ( api, flowState ) {
             // Node-name collision check before building stats (matches make-node-method),
             // so a rejected node never registers its output params in the global checker.
             if ( isNodeNameDuplicate( t[ 0 ] ) ) {
-                throw new Error( `WinkComposer/flow: duplicate node ${t[ 0 ]} found.` );
+                throw new Error( `winkComposer/flow: duplicate node ${t[ 0 ]} found.` );
             }
 
             // Outputs: store each labelled output as `${field}_${label}`, and record the
@@ -121,8 +122,8 @@ export const makeForEach = function ( api, flowState ) {
                 for ( let i = 0; i < outKeys.length; i += 1 ) {
                     const label = rawOutputs[ outKeys[ i ] ];
                     if ( Object.prototype.hasOwnProperty.call( recorded, label ) ) {
-                        console.warn(
-                            `WinkComposer/flow: forEach output label '${label}' written by ` +
+                        logger.warn(
+                            `winkComposer/flow: forEach output label '${label}' written by ` +
                             `more than one step on field '${field}'; each.out will return the last.`
                         );
                     }
@@ -146,7 +147,7 @@ export const makeForEach = function ( api, flowState ) {
             targetArray.push( spec );
         } catch ( error ) {
             throw new Error(
-                `WinkComposer/flow: Failed to process "${callContext}"\n` +
+                `winkComposer/flow: Failed to process "${callContext}"\n` +
                 `  Reason: ${error.message}\n`
             );
         }
@@ -170,7 +171,7 @@ export const makeForEach = function ( api, flowState ) {
         each.out = function ( label ) {
             if ( !Object.prototype.hasOwnProperty.call( recorded, label ) ) {
                 throw new Error(
-                    `WinkComposer/flow: each.out( '${label}' ) on field '${field}': ` +
+                    `winkComposer/flow: each.out( '${label}' ) on field '${field}': ` +
                     `no earlier step in this chain wrote an output labelled '${label}'.`
                 );
             }
@@ -191,25 +192,25 @@ export const makeForEach = function ( api, flowState ) {
         // that only resolves at .endGroup(), so the callback cannot run where written.
         if ( groupByState.active ) {
             throw new Error(
-                'WinkComposer/flow: forEach inside groupBy is not supported yet; ' +
+                'winkComposer/flow: forEach inside groupBy is not supported yet; ' +
                 'the field list must be a concrete array at the call site.'
             );
         }
         if ( !Array.isArray( fields ) || fields.length === 0 ) {
-            throw new Error( 'WinkComposer/flow: forEach requires a non-empty array of field names.' );
+            throw new Error( 'winkComposer/flow: forEach requires a non-empty array of field names.' );
         }
         if ( typeof callback !== 'function' ) {
-            throw new Error( 'WinkComposer/flow: forEach requires a callback function.' );
+            throw new Error( 'winkComposer/flow: forEach requires a callback function.' );
         }
 
         const seen = Object.create( null );
         for ( let i = 0; i < fields.length; i += 1 ) {
             const field = fields[ i ];
             if ( typeof field !== 'string' || field.length === 0 ) {
-                throw new Error( 'WinkComposer/flow: forEach field names must be non-empty strings.' );
+                throw new Error( 'winkComposer/flow: forEach field names must be non-empty strings.' );
             }
             if ( Object.prototype.hasOwnProperty.call( seen, field ) ) {
-                throw new Error( `WinkComposer/flow: forEach duplicate field '${field}' in field list.` );
+                throw new Error( `winkComposer/flow: forEach duplicate field '${field}' in field list.` );
             }
             seen[ field ] = 1;
         }

package/src/flow/get-target-array.js

@@ -29,13 +29,13 @@ export const getTargetArray = function ( switchState, groupByState, flowDefiniti
     if ( switchState && switchState.active ) {
         if ( switchState.currentCase === null ) {
             throw new Error(
-                'WinkComposer/flow: node called outside of a .case() block - ' +
+                'winkComposer/flow: node called outside of a .case() block - ' +
                 'after .switch(), you must call .case() before adding nodes'
             );
         }
         if ( switchState.caseEnded ) {
             throw new Error(
-                'WinkComposer/flow: node called after .break() - ' +
+                'winkComposer/flow: node called after .break() - ' +
                 'start a new .case() before adding more nodes'
             );
         }

package/src/flow/load-node-module.js

@@ -31,7 +31,7 @@ const moduleCache = new Map();
 export const loadNodeModule = async function ( nodeName ) {
     // Validate node name
     if ( !isValidNodeName( nodeName ) ) {
-        throw new Error( `Unknown node type: "${nodeName}"` );
+        throw new Error( `winkComposer/flow: Unknown node type: "${nodeName}"` );
     }
 
     // Return cached module if available

package/src/flow/make-node-method.js

@@ -8,7 +8,7 @@ import { specBuilder } from './spec-builder.js';
 import { getTargetArray } from './get-target-array.js';
 
 /**
- * Creates a chainable DSL method for a WinkComposer node.
+ * Creates a chainable DSL method for a winkComposer node.
  *
  * @param {Object} api - The fluent API object to extend
  * @param {string} node - Node type name (e.g., 'esMean')
@@ -79,9 +79,9 @@ export const makeNodeMethod = function ( api, node, meta, flowState ) {
             } else {
                 // Canonical builder path
                 const instName = args[ 0 ];
-                if ( effectiveNodeChecker( instName ) ) throw Error( `WinkComposer/flow: duplicate node ${instName} found.` );
+                if ( effectiveNodeChecker( instName ) ) throw Error( `winkComposer/flow: duplicate node ${instName} found.` );
                 const pattern = getSignaturePattern( schema );
-                if ( pattern === SIGNATURE_PATTERNS.unknown ) throw Error( `WinkComposer/flow: unknown signature pattern found for ${instName}.` );
+                if ( pattern === SIGNATURE_PATTERNS.unknown ) throw Error( `winkComposer/flow: unknown signature pattern found for ${instName}.` );
                 const status = validateWithSchema( schemas[ pattern ], [ ...args ], 'Arg' );
                 status.throwIfInvalid( 'argument' );
                 built = buildSpecFor[ pattern ]( [ ...args ] );
@@ -101,7 +101,7 @@ export const makeNodeMethod = function ( api, node, meta, flowState ) {
             }
         } catch ( error ) {
             const enhancedError = new Error(
-                `WinkComposer/flow: Failed to process "${callContext}"\n` +
+                `winkComposer/flow: Failed to process "${callContext}"\n` +
                 `  Reason: ${error.message}\n`
             );
 

package/src/flow/resolve-pick-by-field.js

@@ -35,7 +35,7 @@ export const resolvePickByField = function ( value, field ) {
         const map = value.semantics.map;
         if ( !Object.prototype.hasOwnProperty.call( map, field ) ) {
             throw new Error(
-                `WinkComposer/flow: pickByField has no entry for field '${field}' ` +
+                `winkComposer/flow: pickByField has no entry for field '${field}' ` +
                 `(map keys: ${Object.keys( map ).join( ', ' )}).`
             );
         }