@ronaldroe/micro-flow 1.3.0 → 1.3.1

package/dist/src/classes/steps/logic_step.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/classes/steps/logic_step.js"],
-  "sourcesContent": ["import Step from './step.js';\nimport { conditional_step_comparators, step_types } from '../../enums/index.js';\n\n/**\n * LogicStep class for conditional logic operations.\n * @class LogicStep\n * @extends Step\n */\nexport default class LogicStep extends Step {\n  static step_name = 'logic';\n\n  /**\n   * Creates a new LogicStep instance.\n   * @param {Object} options - Configuration options.\n   * @param {string} [options.name] - Name of the step.\n   * @param {Object} [options.conditional] - Conditional configuration.\n   * @param {*|Function} [options.conditional.subject] - Subject to evaluate. Can be a function that returns the value.\n   * @param {conditional_step_comparators|string} [options.conditional.operator] - Comparison operator.\n   * @param {*|Function} [options.conditional.value] - Value to compare against. Can be a function that returns the value.\n   * @param {Function} [options.callable=async () => {}] - Function to execute.\n   */\n  constructor({\n    name,\n    callable = async () => {},\n    conditional = {\n      operator: null,\n      subject: null,\n      value: null,\n    },\n  }) {\n    super({\n      name,\n      step_type: step_types.LOGIC,\n      callable\n    });\n\n    this.setConditional(conditional);\n  }\n\n  /**\n   * Evaluates the conditional expression.\n   * Supports function subjects and values - they are called to get the actual value.\n   * @returns {boolean} True if the condition is met.\n   * @throws {Error} Throws if operator is unknown.\n   */\n  checkCondition() {\n    const rawSubject = this.conditional_config.subject;\n    const rawValue = this.conditional_config.value;\n    const operator = this.conditional_config.operator;\n    \n    // Resolve subject - call it if it's a function\n    const subject = typeof rawSubject === 'function' ? rawSubject() : rawSubject;\n    \n    // Don't resolve value for CUSTOM_FUNCTION - the value IS the function to call\n    const isCustomFunction = operator === this.getState('conditional_step_comparators.CUSTOM_FUNCTION');\n    const value = (!isCustomFunction && typeof rawValue === 'function') ? rawValue() : rawValue;\n\n    switch (operator) {\n      case this.getState('conditional_step_comparators.STRICT_EQUALS'):\n      case this.getState('conditional_step_comparators.SIGN_STRICT_EQUALS'):\n        return subject === value;\n      case this.getState('conditional_step_comparators.SIGN_EQUALS'):\n      case this.getState('conditional_step_comparators.EQUALS'):\n        return subject == value;\n      case this.getState('conditional_step_comparators.NOT_EQUALS'):\n      case this.getState('conditional_step_comparators.SIGN_NOT_EQUALS'):\n        return subject != value;\n      case this.getState('conditional_step_comparators.STRICT_NOT_EQUALS'):\n      case this.getState('conditional_step_comparators.SIGN_STRICT_NOT_EQUALS'):\n        return subject !== value;\n      case this.getState('conditional_step_comparators.GREATER_THAN'):\n      case this.getState('conditional_step_comparators.SIGN_GREATER_THAN'):\n        return subject > value;\n      case this.getState('conditional_step_comparators.LESS_THAN'):\n      case this.getState('conditional_step_comparators.SIGN_LESS_THAN'):\n        return subject < value;\n      case this.getState('conditional_step_comparators.GREATER_THAN_OR_EQUAL'):\n      case this.getState('conditional_step_comparators.SIGN_GREATER_THAN_OR_EQUAL'):\n        return subject >= value;\n      case this.getState('conditional_step_comparators.LESS_THAN_OR_EQUAL'):\n      case this.getState('conditional_step_comparators.SIGN_LESS_THAN_OR_EQUAL'):\n        return subject <= value;\n      case this.getState('conditional_step_comparators.STRING_CONTAINS'):\n      case this.getState('conditional_step_comparators.STRING_INCLUDES'):\n      case this.getState('conditional_step_comparators.ARRAY_CONTAINS'):\n      case this.getState('conditional_step_comparators.ARRAY_INCLUDES'):\n        return (Array.isArray(subject) || typeof subject === 'string') && subject.includes(value);\n      case this.getState('conditional_step_comparators.IN'):\n        return (Array.isArray(value) || typeof value === 'string') && value.includes(subject);\n      case this.getState('conditional_step_comparators.STRING_NOT_CONTAINS'):\n      case this.getState('conditional_step_comparators.STRING_NOT_INCLUDES'):\n      case this.getState('conditional_step_comparators.ARRAY_NOT_CONTAINS'):\n      case this.getState('conditional_step_comparators.ARRAY_NOT_INCLUDES'):\n        return (Array.isArray(subject) || typeof subject === 'string') && !subject.includes(value);\n      case this.getState('conditional_step_comparators.NOT_IN'):\n        return (Array.isArray(value) || typeof value === 'string') && !value.includes(subject);\n      case this.getState('conditional_step_comparators.EMPTY'):\n        return subject === '' || subject === null || subject === undefined || subject.length === 0;\n      case this.getState('conditional_step_comparators.NOT_EMPTY'):\n        return subject !== '' && subject !== null && subject !== undefined && subject.length > 0;\n      case this.getState('conditional_step_comparators.REGEX_MATCH'):\n        if (typeof value !== 'string') {\n          throw new Error(`Regex input must be a string.`);\n        }\n        const regex = new RegExp(value);\n        return regex.test(subject);\n      case this.getState('conditional_step_comparators.REGEX_NOT_MATCH'):\n        if (typeof value !== 'string') {\n          throw new Error(`Regex input must be a string.`);\n        }\n        const notMatchRegex = new RegExp(value);\n        return !notMatchRegex.test(subject);\n      case this.getState('conditional_step_comparators.STRING_STARTS_WITH'):\n        return typeof subject === 'string' && typeof value === 'string' && subject.startsWith(value);\n      case this.getState('conditional_step_comparators.STRING_ENDS_WITH'):\n        return typeof subject === 'string' && typeof value === 'string' && subject.endsWith(value);\n      case this.getState('conditional_step_comparators.NULLISH'):\n        return subject === null || subject === undefined;\n      case this.getState('conditional_step_comparators.NOT_NULLISH'):\n        return subject !== null && subject !== undefined;\n      case this.getState('conditional_step_comparators.IS_TYPE'):\n        return typeof subject === value;\n      case this.getState('conditional_step_comparators.IS_NOT_TYPE'):\n        return typeof subject !== value;\n      case this.getState('conditional_step_comparators.CUSTOM_FUNCTION'):\n        if (typeof value !== 'function') {\n          throw new Error(`Invalid custom function: ${value}`);\n        }\n        return value(subject);\n      default:\n        throw new Error(`Unknown operator: ${operator}`);\n    }\n  }\n\n  /**\n   * Checks if the conditional configuration is valid.\n   * A valid conditional has subject and operator set (not null/undefined).\n   * Functions are valid as subject or value - they will be called during checkCondition().\n   * @returns {boolean} True if conditional is valid.\n   */\n  conditionalIsValid() {\n    // Check if all conditional properties are set (not null or undefined)\n    // Can't use falsy check here because valid values could be falsy (e.g. empty string, 0, false)\n    // Functions are valid - they'll be called to get the actual value\n    return (\n      this.conditional_config.subject !== null &&\n      this.conditional_config.subject !== undefined &&\n      this.conditional_config.operator !== null &&\n      this.conditional_config.operator !== undefined\n    );\n  }\n\n  /**\n   * Sets the conditional properties.\n   * @param {Object} conditional - Conditional configuration object.\n   */\n  setConditional(conditional) {\n    this.conditional_config = { subject: conditional.subject, operator: conditional.operator, value: conditional.value };\n  }\n}\n"],
+  "sourcesContent": ["import Step from './step.js';\nimport { conditional_step_comparators, step_types } from '../../enums/index.js';\n\n/**\n * LogicStep class for conditional logic operations.\n * @class LogicStep\n * @extends Step\n */\nexport default class LogicStep extends Step {\n  static step_name = 'logic';\n\n  /**\n   * Creates a new LogicStep instance.\n   * @param {Object} options - Configuration options.\n   * @param {string} [options.name] - Name of the step.\n   * @param {Object} [options.conditional] - Conditional configuration.\n   * @param {*|Function} [options.conditional.subject] - Subject to evaluate. Can be a function that returns the value.\n   * @param {conditional_step_comparators|string} [options.conditional.operator] - Comparison operator.\n   * @param {*|Function, optional} [options.conditional.value] - Value to compare against. Can be a function that returns the value.\n   * @param {Function} [options.callable=async () => {}] - Function to execute.\n   */\n  constructor({\n    name,\n    callable = async () => {},\n    conditional = {\n      operator: null,\n      subject: null,\n      value: null,\n    },\n  }) {\n    super({\n      name,\n      step_type: step_types.LOGIC,\n      callable\n    });\n\n    this.setConditional(conditional);\n  }\n\n  /**\n   * Evaluates the conditional expression.\n   * Supports function subjects and values - they are called to get the actual value.\n   * @returns {boolean} True if the condition is met.\n   * @throws {Error} Throws if operator is unknown.\n   */\n  checkCondition() {\n    const rawSubject = this.conditional_config.subject;\n    const rawValue = this.conditional_config.value;\n    const operator = this.conditional_config.operator;\n    \n    // Resolve subject - call it if it's a function\n    const subject = typeof rawSubject === 'function' ? rawSubject() : rawSubject;\n    \n    // Don't resolve value for CUSTOM_FUNCTION - the value IS the function to call\n    const isCustomFunction = operator === this.getState('conditional_step_comparators.CUSTOM_FUNCTION');\n    const value = (!isCustomFunction && typeof rawValue === 'function') ? rawValue() : rawValue;\n\n    switch (operator) {\n      case this.getState('conditional_step_comparators.STRICT_EQUALS'):\n      case this.getState('conditional_step_comparators.SIGN_STRICT_EQUALS'):\n        return subject === value;\n      case this.getState('conditional_step_comparators.SIGN_EQUALS'):\n      case this.getState('conditional_step_comparators.EQUALS'):\n        return subject == value;\n      case this.getState('conditional_step_comparators.NOT_EQUALS'):\n      case this.getState('conditional_step_comparators.SIGN_NOT_EQUALS'):\n        return subject != value;\n      case this.getState('conditional_step_comparators.STRICT_NOT_EQUALS'):\n      case this.getState('conditional_step_comparators.SIGN_STRICT_NOT_EQUALS'):\n        return subject !== value;\n      case this.getState('conditional_step_comparators.GREATER_THAN'):\n      case this.getState('conditional_step_comparators.SIGN_GREATER_THAN'):\n        return subject > value;\n      case this.getState('conditional_step_comparators.LESS_THAN'):\n      case this.getState('conditional_step_comparators.SIGN_LESS_THAN'):\n        return subject < value;\n      case this.getState('conditional_step_comparators.GREATER_THAN_OR_EQUAL'):\n      case this.getState('conditional_step_comparators.SIGN_GREATER_THAN_OR_EQUAL'):\n        return subject >= value;\n      case this.getState('conditional_step_comparators.LESS_THAN_OR_EQUAL'):\n      case this.getState('conditional_step_comparators.SIGN_LESS_THAN_OR_EQUAL'):\n        return subject <= value;\n      case this.getState('conditional_step_comparators.STRING_CONTAINS'):\n      case this.getState('conditional_step_comparators.STRING_INCLUDES'):\n      case this.getState('conditional_step_comparators.ARRAY_CONTAINS'):\n      case this.getState('conditional_step_comparators.ARRAY_INCLUDES'):\n        return (Array.isArray(subject) || typeof subject === 'string') && subject.includes(value);\n      case this.getState('conditional_step_comparators.IN'):\n        return (Array.isArray(value) || typeof value === 'string') && value.includes(subject);\n      case this.getState('conditional_step_comparators.STRING_NOT_CONTAINS'):\n      case this.getState('conditional_step_comparators.STRING_NOT_INCLUDES'):\n      case this.getState('conditional_step_comparators.ARRAY_NOT_CONTAINS'):\n      case this.getState('conditional_step_comparators.ARRAY_NOT_INCLUDES'):\n        return (Array.isArray(subject) || typeof subject === 'string') && !subject.includes(value);\n      case this.getState('conditional_step_comparators.NOT_IN'):\n        return (Array.isArray(value) || typeof value === 'string') && !value.includes(subject);\n      case this.getState('conditional_step_comparators.EMPTY'):\n        return subject === '' || subject === null || subject === undefined || subject.length === 0;\n      case this.getState('conditional_step_comparators.NOT_EMPTY'):\n        return subject !== '' && subject !== null && subject !== undefined && subject.length > 0;\n      case this.getState('conditional_step_comparators.REGEX_MATCH'):\n        if (typeof value !== 'string') {\n          throw new Error(`Regex input must be a string.`);\n        }\n        const regex = new RegExp(value);\n        return regex.test(subject);\n      case this.getState('conditional_step_comparators.REGEX_NOT_MATCH'):\n        if (typeof value !== 'string') {\n          throw new Error(`Regex input must be a string.`);\n        }\n        const notMatchRegex = new RegExp(value);\n        return !notMatchRegex.test(subject);\n      case this.getState('conditional_step_comparators.STRING_STARTS_WITH'):\n        return typeof subject === 'string' && typeof value === 'string' && subject.startsWith(value);\n      case this.getState('conditional_step_comparators.STRING_ENDS_WITH'):\n        return typeof subject === 'string' && typeof value === 'string' && subject.endsWith(value);\n      case this.getState('conditional_step_comparators.NULLISH'):\n        return subject === null || subject === undefined;\n      case this.getState('conditional_step_comparators.NOT_NULLISH'):\n        return subject !== null && subject !== undefined;\n      case this.getState('conditional_step_comparators.IS_TYPE'):\n        return typeof subject === value;\n      case this.getState('conditional_step_comparators.IS_NOT_TYPE'):\n        return typeof subject !== value;\n      case this.getState('conditional_step_comparators.CUSTOM_FUNCTION'):\n        if (typeof value !== 'function') {\n          throw new Error(`Invalid custom function: ${value}`);\n        }\n        return value(subject);\n      default:\n        throw new Error(`Unknown operator: ${operator}`);\n    }\n  }\n\n  /**\n   * Checks if the conditional configuration is valid.\n   * A valid conditional has subject and operator set (not null/undefined).\n   * Functions are valid as subject or value - they will be called during checkCondition().\n   * @returns {boolean} True if conditional is valid.\n   */\n  conditionalIsValid() {\n    // Check if all conditional properties are set (not null or undefined)\n    // Can't use falsy check here because valid values could be falsy (e.g. empty string, 0, false)\n    // Functions are valid - they'll be called to get the actual value\n    return (\n      this.conditional_config.subject !== null &&\n      this.conditional_config.subject !== undefined &&\n      this.conditional_config.operator !== null &&\n      this.conditional_config.operator !== undefined\n    );\n  }\n\n  /**\n   * Sets the conditional properties.\n   * @param {Object} conditional - Conditional configuration object.\n   */\n  setConditional(conditional) {\n    this.conditional_config = { subject: conditional.subject, operator: conditional.operator, value: conditional.value };\n  }\n}\n"],
   "mappings": "+EAAA,OAAOA,MAAU,YACjB,OAAuC,cAAAC,MAAkB,uBAOzD,MAAOC,UAAgCF,CAAK,CAR5C,MAQ4C,CAAAG,EAAA,kBAC1C,OAAO,UAAY,QAYnB,YAAY,CACV,KAAAC,EACA,SAAAC,EAAWF,EAAA,SAAY,CAAC,EAAb,YACX,YAAAG,EAAc,CACZ,SAAU,KACV,QAAS,KACT,MAAO,IACT,CACF,EAAG,CACD,MAAM,CACJ,KAAAF,EACA,UAAWH,EAAW,MACtB,SAAAI,CACF,CAAC,EAED,KAAK,eAAeC,CAAW,CACjC,CAQA,gBAAiB,CACf,MAAMC,EAAa,KAAK,mBAAmB,QACrCC,EAAW,KAAK,mBAAmB,MACnCC,EAAW,KAAK,mBAAmB,SAGnCC,EAAU,OAAOH,GAAe,WAAaA,EAAW,EAAIA,EAI5DI,EAAS,EADUF,IAAa,KAAK,SAAS,8CAA8C,IAC9D,OAAOD,GAAa,WAAcA,EAAS,EAAIA,EAEnF,OAAQC,EAAU,CAChB,KAAK,KAAK,SAAS,4CAA4C,EAC/D,KAAK,KAAK,SAAS,iDAAiD,EAClE,OAAOC,IAAYC,EACrB,KAAK,KAAK,SAAS,0CAA0C,EAC7D,KAAK,KAAK,SAAS,qCAAqC,EACtD,OAAOD,GAAWC,EACpB,KAAK,KAAK,SAAS,yCAAyC,EAC5D,KAAK,KAAK,SAAS,8CAA8C,EAC/D,OAAOD,GAAWC,EACpB,KAAK,KAAK,SAAS,gDAAgD,EACnE,KAAK,KAAK,SAAS,qDAAqD,EACtE,OAAOD,IAAYC,EACrB,KAAK,KAAK,SAAS,2CAA2C,EAC9D,KAAK,KAAK,SAAS,gDAAgD,EACjE,OAAOD,EAAUC,EACnB,KAAK,KAAK,SAAS,wCAAwC,EAC3D,KAAK,KAAK,SAAS,6CAA6C,EAC9D,OAAOD,EAAUC,EACnB,KAAK,KAAK,SAAS,oDAAoD,EACvE,KAAK,KAAK,SAAS,yDAAyD,EAC1E,OAAOD,GAAWC,EACpB,KAAK,KAAK,SAAS,iDAAiD,EACpE,KAAK,KAAK,SAAS,sDAAsD,EACvE,OAAOD,GAAWC,EACpB,KAAK,KAAK,SAAS,8CAA8C,EACjE,KAAK,KAAK,SAAS,8CAA8C,EACjE,KAAK,KAAK,SAAS,6CAA6C,EAChE,KAAK,KAAK,SAAS,6CAA6C,EAC9D,OAAQ,MAAM,QAAQD,CAAO,GAAK,OAAOA,GAAY,WAAaA,EAAQ,SAASC,CAAK,EAC1F,KAAK,KAAK,SAAS,iCAAiC,EAClD,OAAQ,MAAM,QAAQA,CAAK,GAAK,OAAOA,GAAU,WAAaA,EAAM,SAASD,CAAO,EACtF,KAAK,KAAK,SAAS,kDAAkD,EACrE,KAAK,KAAK,SAAS,kDAAkD,EACrE,KAAK,KAAK,SAAS,iDAAiD,EACpE,KAAK,KAAK,SAAS,iDAAiD,EAClE,OAAQ,MAAM,QAAQA,CAAO,GAAK,OAAOA,GAAY,WAAa,CAACA,EAAQ,SAASC,CAAK,EAC3F,KAAK,KAAK,SAAS,qCAAqC,EACtD,OAAQ,MAAM,QAAQA,CAAK,GAAK,OAAOA,GAAU,WAAa,CAACA,EAAM,SAASD,CAAO,EACvF,KAAK,KAAK,SAAS,oCAAoC,EACrD,OAAOA,IAAY,IAAMA,IAAY,MAAQA,IAAY,QAAaA,EAAQ,SAAW,EAC3F,KAAK,KAAK,SAAS,wCAAwC,EACzD,OAAOA,IAAY,IAAMA,IAAY,MAAQA,IAAY,QAAaA,EAAQ,OAAS,EACzF,KAAK,KAAK,SAAS,0CAA0C,EAC3D,GAAI,OAAOC,GAAU,SACnB,MAAM,IAAI,MAAM,+BAA+B,EAGjD,OADc,IAAI,OAAOA,CAAK,EACjB,KAAKD,CAAO,EAC3B,KAAK,KAAK,SAAS,8CAA8C,EAC/D,GAAI,OAAOC,GAAU,SACnB,MAAM,IAAI,MAAM,+BAA+B,EAGjD,MAAO,CADe,IAAI,OAAOA,CAAK,EAChB,KAAKD,CAAO,EACpC,KAAK,KAAK,SAAS,iDAAiD,EAClE,OAAO,OAAOA,GAAY,UAAY,OAAOC,GAAU,UAAYD,EAAQ,WAAWC,CAAK,EAC7F,KAAK,KAAK,SAAS,+CAA+C,EAChE,OAAO,OAAOD,GAAY,UAAY,OAAOC,GAAU,UAAYD,EAAQ,SAASC,CAAK,EAC3F,KAAK,KAAK,SAAS,sCAAsC,EACvD,OAAOD,GAAY,KACrB,KAAK,KAAK,SAAS,0CAA0C,EAC3D,OAAOA,GAAY,KACrB,KAAK,KAAK,SAAS,sCAAsC,EACvD,OAAO,OAAOA,IAAYC,EAC5B,KAAK,KAAK,SAAS,0CAA0C,EAC3D,OAAO,OAAOD,IAAYC,EAC5B,KAAK,KAAK,SAAS,8CAA8C,EAC/D,GAAI,OAAOA,GAAU,WACnB,MAAM,IAAI,MAAM,4BAA4BA,CAAK,EAAE,EAErD,OAAOA,EAAMD,CAAO,EACtB,QACE,MAAM,IAAI,MAAM,qBAAqBD,CAAQ,EAAE,CACnD,CACF,CAQA,oBAAqB,CAInB,OACE,KAAK,mBAAmB,UAAY,MACpC,KAAK,mBAAmB,UAAY,QACpC,KAAK,mBAAmB,WAAa,MACrC,KAAK,mBAAmB,WAAa,MAEzC,CAMA,eAAeH,EAAa,CAC1B,KAAK,mBAAqB,CAAE,QAASA,EAAY,QAAS,SAAUA,EAAY,SAAU,MAAOA,EAAY,KAAM,CACrH,CACF",
   "names": ["Step", "step_types", "LogicStep", "__name", "name", "callable", "conditional", "rawSubject", "rawValue", "operator", "subject", "value"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ronaldroe/micro-flow",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "A lightweight, flexible workflow orchestration library for Node.js and browser environments. Build complex, sequential processes with ease using an intuitive API that supports conditional logic, flow control, event handling, and state management.",
   "main": "dist/index.js",
   "exports": {

package/src/classes/steps/logic_step.js

@@ -16,7 +16,7 @@ export default class LogicStep extends Step {
    * @param {Object} [options.conditional] - Conditional configuration.
    * @param {*|Function} [options.conditional.subject] - Subject to evaluate. Can be a function that returns the value.
    * @param {conditional_step_comparators|string} [options.conditional.operator] - Comparison operator.
-   * @param {*|Function} [options.conditional.value] - Value to compare against. Can be a function that returns the value.
+   * @param {*|Function, optional} [options.conditional.value] - Value to compare against. Can be a function that returns the value.
    * @param {Function} [options.callable=async () => {}] - Function to execute.
    */
   constructor({