@xtr-dev/payload-automation 0.0.51 → 0.0.53

package/README.md

@@ -8,15 +8,13 @@ A workflow automation plugin for PayloadCMS 3.x. Build visual workflows triggere
 
 ## Features
 
-- **Visual Workflow Builder** - Drag-and-drop workflow editor in PayloadCMS admin
-- **Workflow Visualizer** - React component for displaying workflows with real-time execution status
-- **Collection Triggers** - Run workflows when documents are created, updated, or deleted
-- **Webhook Triggers** - Trigger workflows via HTTP endpoints
-- **Step Dependencies** - Define execution order with parallel and sequential steps
-- **Execution Tracking** - Full history with step-by-step results, duration, and logs
-- **Built-in Steps** - HTTP requests, document CRUD, email sending
-- **Custom Steps** - Create your own step types with the step factory
-- **JSONata Expressions** - Powerful data transformation between steps
+- 🔄 Visual workflow builder in PayloadCMS admin
+- ⚡ Run workflows when documents are created/updated/deleted
+- 🎯 Trigger workflows via webhooks
+- 📊 Track workflow execution history
+- 🔧 HTTP requests, document operations, email sending
+- 🔗 Use data from previous steps in templates
+- ⚙️ Step dependencies with parallel and sequential execution
 
 ## Installation
 
@@ -30,20 +28,20 @@ npm install @xtr-dev/payload-automation
 
 ```typescript
 import { buildConfig } from 'payload'
-import { workflowsPlugin } from '@xtr-dev/payload-automation'
+import { workflowsPlugin } from '@xtr-dev/payload-automation/server'
 
 export default buildConfig({
+  // ... your config
   plugins: [
     workflowsPlugin({
-      enabled: true,
       collectionTriggers: {
-        orders: true,  // Enable all hooks for orders
-        users: {
-          afterChange: true,  // Only specific hooks
+        posts: true,    // Enable all CRUD triggers for posts
+        users: { 
+          create: true, // Only enable create trigger for users
+          update: true
         }
       },
-      // Register custom steps
-      steps: [myCustomStep],
+      enabled: true,
     }),
   ],
 })
@@ -52,10 +50,10 @@ export default buildConfig({
 ## Imports
 
 ```typescript
-// Main plugin
-import { workflowsPlugin } from '@xtr-dev/payload-automation'
+// Server plugin
+import { workflowsPlugin } from '@xtr-dev/payload-automation/server'
 
-// Client components
+// Client components  
 import { StatusCell, ErrorDisplay } from '@xtr-dev/payload-automation/client'
 
 // Types
@@ -89,13 +87,80 @@ const exampleWorkflows: SeedWorkflow[] = [
         name: 'Send Email',
         type: 'send-email',
         input: {
-          to: '$.trigger.doc.email',
+          to: '{{trigger.doc.email}}',
           subject: 'Welcome!',
           text: 'Thanks for joining us!',
         },
       },
     ],
   },
+  {
+    slug: 'example-order-processing',
+    name: 'Example: Order Processing Pipeline',
+    description: 'Process order with validation, inventory check, and notifications',
+    triggers: [
+      {
+        type: 'collection-hook',
+        parameters: {
+          collectionSlug: 'orders',
+          hook: 'afterChange',
+        },
+        condition: 'trigger.operation = "create"',
+      },
+    ],
+    steps: [
+      {
+        name: 'Validate Order',
+        type: 'http-request-step',
+        input: {
+          url: 'https://api.example.com/validate',
+          method: 'POST',
+          body: {
+            orderId: '{{trigger.doc.id}}',
+            items: '{{trigger.doc.items}}',
+          },
+        },
+      },
+      {
+        name: 'Check Inventory',
+        type: 'http-request-step',
+        input: {
+          url: 'https://api.example.com/inventory/check',
+          method: 'POST',
+          body: {
+            items: '{{trigger.doc.items}}',
+          },
+        },
+        // This step runs only after Validate Order succeeds
+        dependencies: ['Validate Order'],
+      },
+      {
+        name: 'Create Shipment',
+        type: 'create-document',
+        input: {
+          collection: 'shipments',
+          data: {
+            orderId: '{{trigger.doc.id}}',
+            status: 'pending',
+            items: '{{trigger.doc.items}}',
+          },
+        },
+        // This step waits for both validation and inventory check
+        dependencies: ['Validate Order', 'Check Inventory'],
+      },
+      {
+        name: 'Send Confirmation Email',
+        type: 'send-email',
+        input: {
+          to: '{{trigger.doc.customer.email}}',
+          subject: 'Order Confirmed',
+          text: 'Your order {{trigger.doc.id}} has been confirmed!',
+        },
+        // Only send email after shipment is created
+        dependencies: ['Create Shipment'],
+      },
+    ],
+  },
 ]
 
 workflowsPlugin({
@@ -114,8 +179,73 @@ Seeded workflows:
 
 See [docs/SEEDING_WORKFLOWS.md](./docs/SEEDING_WORKFLOWS.md) for detailed documentation.
 
+## Step Dependencies
+
+Steps can declare dependencies on other steps to control execution order. The workflow executor uses topological sorting to determine the optimal execution order.
+
+### How Dependencies Work
+
+- **Parallel Execution**: Steps without dependencies run in parallel
+- **Sequential Execution**: Steps with dependencies wait for their dependencies to complete successfully
+- **Multiple Dependencies**: A step can depend on multiple other steps (all must succeed)
+- **Failure Handling**: If a dependency fails, the dependent step is skipped
+
+### Example: Parallel and Sequential Steps
+
+```typescript
+steps: [
+  {
+    name: 'Fetch User Data',
+    type: 'http-request-step',
+    // No dependencies - runs immediately
+  },
+  {
+    name: 'Fetch Order Data',
+    type: 'http-request-step',
+    // No dependencies - runs in parallel with Fetch User Data
+  },
+  {
+    name: 'Generate Report',
+    type: 'http-request-step',
+    dependencies: ['Fetch User Data', 'Fetch Order Data'],
+    // Waits for both API calls to complete
+    input: {
+      url: 'https://api.example.com/reports',
+      body: {
+        user: '{{steps.FetchUserData.output.user}}',
+        orders: '{{steps.FetchOrderData.output.orders}}',
+      },
+    },
+  },
+]
+```
+
+### Accessing Step Output
+
+Use `{{steps.<stepName>.output.<field>}}` to reference data from completed steps:
+
+```typescript
+{
+  name: 'Process Result',
+  type: 'create-document',
+  dependencies: ['API Call'],
+  input: {
+    collection: 'results',
+    data: {
+      // Access output from the "API Call" step
+      apiResponse: '{{steps.APICall.output.data}}',
+      status: '{{steps.APICall.output.status}}',
+    },
+  },
+}
+```
+
 ## Step Types
 
+> **Note:** Steps are just regular [PayloadCMS tasks](https://payloadcms.com/docs/jobs/overview). This plugin uses Payload's built-in job queue system, so you can leverage all of Payload's task features including retries, scheduling, and monitoring. Any `TaskConfig` you create is a valid step.
+
+The plugin comes with a few built-in step types found below.
+
 ### HTTP Request
 Call external APIs with full configuration:
 
@@ -156,12 +286,13 @@ Send notifications via PayloadCMS email adapter:
 
 ## Custom Steps
 
-Create reusable step types with the `createStep` factory:
+Steps are standard PayloadCMS tasks, so creating custom steps is just defining a `TaskConfig`. No proprietary APIs to learn:
 
 ```typescript
-import { createStep } from '@xtr-dev/payload-automation/steps'
+import type { TaskConfig } from 'payload'
 
-export const SlackNotificationStep = createStep({
+// Define the step configuration
+export const SlackNotificationStep: TaskConfig<'slack-notification'> = {
   slug: 'slack-notification',
   label: 'Send Slack Message',
 
@@ -175,42 +306,40 @@ export const SlackNotificationStep = createStep({
     { name: 'timestamp', type: 'text' },
   ],
 
-  visual: {
-    icon: '💬',
-    color: '#4A154B',
-  },
-
-  validate: (input) => {
-    if (!input.channel?.startsWith('#')) {
-      throw new Error('Channel must start with #')
-    }
-  },
-
-  execute: async (input, req) => {
-    const response = await fetch('https://slack.com/api/chat.postMessage', {
-      method: 'POST',
-      headers: {
-        'Authorization': `Bearer ${process.env.SLACK_TOKEN}`,
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify({
-        channel: input.channel,
-        text: input.message,
-      }),
-    })
-
-    const data = await response.json()
-    return {
-      messageId: data.message.ts,
-      timestamp: new Date().toISOString(),
+  handler: async ({ input, req }) => {
+    try {
+      const response = await fetch('https://slack.com/api/chat.postMessage', {
+        method: 'POST',
+        headers: {
+          'Authorization': `Bearer ${process.env.SLACK_TOKEN}`,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          channel: input.channel,
+          text: input.message,
+        }),
+      })
+
+      const data = await response.json()
+
+      return {
+        output: {
+          messageId: data.message.ts,
+          timestamp: new Date().toISOString(),
+        },
+        state: 'succeeded'
+      }
+    } catch (error) {
+      return {
+        output: {},
+        state: 'failed',
+        errorMessage: error instanceof Error ? error.message : 'Unknown error'
+      }
     }
   },
-})
-```
-
-Register custom steps in the plugin config:
+}
 
-```typescript
+// Register in plugin config
 workflowsPlugin({
   steps: [SlackNotificationStep],
 })

package/dist/core/expression-engine.js

@@ -142,9 +142,9 @@ const MAX_CACHE_SIZE = 1000;
  */ export async function transform(template, context, options = {}) {
     if (typeof template === 'string') {
         // Check if it looks like a JSONata expression (starts with common patterns)
-        if (template.startsWith('{') || template.startsWith('[') || template.startsWith('$') || template.includes('.') || template.includes('(')) {
+        if (template.startsWith('{{')) {
             try {
-                return await evaluate(template, context, options);
+                return await evaluate(template.trim().slice(2, -2), context, options);
             } catch (e) {
                 if (options.debug && options.logger) {
                     options.logger.info(e instanceof Error ? e.message : e, 'Failed to evaluate expression:');

package/dist/core/expression-engine.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/expression-engine.ts"],"sourcesContent":["import jsonata from 'jsonata'\nimport type {Payload} from \"payload\";\n\n/**\n * Expression engine using JSONata for safe, sandboxed expression evaluation.\n * Used for both conditions and data transformation in workflows.\n *\n * @example Conditions\n * ```\n * trigger.doc._status = \"published\"\n * trigger.doc.count > 10 and trigger.doc.enabled\n * $exists(steps.validate.output.error) = false\n * ```\n *\n * @example Data Transformation\n * ```\n * {\n *   \"id\": trigger.doc.id,\n *   \"title\": $uppercase(trigger.doc.title),\n *   \"tags\": trigger.doc.tags[category = \"featured\"].name\n * }\n * ```\n */\n\nexport interface ExpressionContext {\n  trigger: Record<string, unknown>\n  steps: Record<string, unknown>\n  [key: string]: unknown\n}\n\nexport interface EvaluateOptions {\n  /** Timeout in milliseconds (default: 5000) */\n  timeout?: number\n  debug?: boolean\n  logger?: Payload['logger']\n}\n\n// Cache compiled expressions for performance\nconst expressionCache = new Map<string, jsonata.Expression>()\nconst MAX_CACHE_SIZE = 1000\n\n/**\n * Compile a JSONata expression with caching\n */\nfunction compileExpression(expression: string): jsonata.Expression {\n  let compiled = expressionCache.get(expression)\n\n  if (!compiled) {\n    compiled = jsonata(expression)\n\n    // Register custom functions\n    registerCustomFunctions(compiled)\n\n    // Manage cache size\n    if (expressionCache.size >= MAX_CACHE_SIZE) {\n      const firstKey = expressionCache.keys().next().value\n      if (firstKey) expressionCache.delete(firstKey)\n    }\n\n    expressionCache.set(expression, compiled)\n  }\n\n  return compiled\n}\n\n/**\n * Register custom functions on a JSONata expression\n */\nfunction registerCustomFunctions(expr: jsonata.Expression): void {\n  // $env(name) - Get environment variable (only non-sensitive ones)\n  expr.registerFunction('env', (name: string) => {\n    // Only allow specific prefixes for security\n    if (typeof name === 'string' && name.startsWith('PUBLIC_')) {\n      return process.env[name]\n    }\n    return undefined\n  }, '<s:s>')\n\n  // $now() - Current ISO timestamp\n  expr.registerFunction('now', () => new Date().toISOString(), '<:s>')\n\n  // $timestamp() - Current Unix timestamp in milliseconds\n  expr.registerFunction('timestamp', () => Date.now(), '<:n>')\n\n  // $uuid() - Generate a UUID v4\n  expr.registerFunction('uuid', () => {\n    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n      const r = (Math.random() * 16) | 0\n      const v = c === 'x' ? r : (r & 0x3) | 0x8\n      return v.toString(16)\n    })\n  }, '<:s>')\n\n  // $default(value, defaultValue) - Return default if value is null/undefined\n  expr.registerFunction('default', (value: unknown, defaultValue: unknown) => {\n    return value === null || value === undefined ? defaultValue : value\n  }, '<xx:x>')\n\n  // $json(value) - Parse JSON string\n  expr.registerFunction('json', (value: string) => {\n    try {\n      return JSON.parse(value)\n    } catch {\n      return undefined\n    }\n  }, '<s:x>')\n\n  // $stringify(value) - Convert to JSON string\n  expr.registerFunction('stringify', (value: unknown) => {\n    try {\n      return JSON.stringify(value)\n    } catch {\n      return undefined\n    }\n  }, '<x:s>')\n\n  // $keys(object) - Get object keys\n  expr.registerFunction('keys', (obj: Record<string, unknown>) => {\n    if (obj && typeof obj === 'object' && !Array.isArray(obj)) {\n      return Object.keys(obj)\n    }\n    return []\n  }, '<o:a>')\n\n  // $values(object) - Get object values\n  expr.registerFunction('values', (obj: Record<string, unknown>) => {\n    if (obj && typeof obj === 'object' && !Array.isArray(obj)) {\n      return Object.values(obj)\n    }\n    return []\n  }, '<o:a>')\n\n  // $has(object, key) - Check if object has key\n  expr.registerFunction('has', (obj: Record<string, unknown>, key: string) => {\n    if (obj && typeof obj === 'object') {\n      return key in obj\n    }\n    return false\n  }, '<os:b>')\n\n  // $coalesce(values...) - Return first non-null value\n  expr.registerFunction('coalesce', (...values: unknown[]) => {\n    for (const v of values) {\n      if (v !== null && v !== undefined) {\n        return v\n      }\n    }\n    return null\n  }, '<x+:x>')\n}\n\n/**\n * Evaluate a JSONata expression against a context\n */\nexport async function evaluate(\n  expression: string,\n  context: ExpressionContext,\n  options: EvaluateOptions = {}\n): Promise<unknown> {\n  const { timeout = 5000 } = options\n\n  const compiled = compileExpression(expression)\n\n  // Create a promise that rejects on timeout\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    setTimeout(() => reject(new Error(`Expression evaluation timed out after ${timeout}ms`)), timeout)\n  })\n\n  // Race between evaluation and timeout\n  return Promise.race([\n    compiled.evaluate(context),\n    timeoutPromise\n  ])\n}\n\n/**\n * Evaluate a condition expression and return a boolean\n */\nexport async function evaluateCondition(\n  expression: string,\n  context: ExpressionContext,\n  options: EvaluateOptions = {}\n): Promise<boolean> {\n  try {\n    const result = await evaluate(expression, context, options)\n\n    // Convert result to boolean\n    if (result === undefined || result === null) {\n      return false\n    }\n    if (typeof result === 'boolean') {\n      return result\n    }\n    if (typeof result === 'number') {\n      return result !== 0\n    }\n    if (typeof result === 'string') {\n      return result.length > 0\n    }\n    if (Array.isArray(result)) {\n      return result.length > 0\n    }\n    return true\n  } catch (error) {\n    // Log error but return false for failed conditions\n    console.warn('Condition evaluation failed:', error instanceof Error ? error.message : error)\n    return false\n  }\n}\n\n/**\n * Transform data using a JSONata expression\n * The expression can be a JSONata query or a JSON object with embedded expressions\n */\nexport async function transform(\n  template: unknown,\n  context: ExpressionContext,\n  options: EvaluateOptions = {}\n): Promise<unknown> {\n  if (typeof template === 'string') {\n    // Check if it looks like a JSONata expression (starts with common patterns)\n    if (\n      template.startsWith('{') ||\n      template.startsWith('[') ||\n      template.startsWith('$') ||\n      template.includes('.') ||\n      template.includes('(')\n    ) {\n      try {\n        return await evaluate(template, context, options)\n      } catch (e) {\n        if (options.debug && options.logger) {\n          options.logger.info(\n              e instanceof Error ? e.message : e,\n            'Failed to evaluate expression:',\n          )\n        }\n        // If it fails to evaluate, return as literal string\n        return template\n      }\n    }\n    return template\n  }\n\n  if (Array.isArray(template)) {\n    return Promise.all(template.map(item => transform(item, context, options)))\n  }\n\n  if (template && typeof template === 'object') {\n    const result: Record<string, unknown> = {}\n    for (const [key, value] of Object.entries(template)) {\n      result[key] = await transform(value, context, options)\n    }\n    return result\n  }\n\n  return template\n}\n\n/**\n * Resolve a step input configuration using JSONata\n * Handles both simple values and expressions\n */\nexport async function resolveStepInput(\n  config: Record<string, unknown>,\n  context: ExpressionContext,\n  options: EvaluateOptions = {}\n): Promise<Record<string, unknown>> {\n  const result: Record<string, unknown> = {}\n\n  for (const [key, value] of Object.entries(config)) {\n    result[key] = await transform(value, context, options)\n  }\n\n  return result\n}\n\n/**\n * Clear the expression cache\n */\nexport function clearCache(): void {\n  expressionCache.clear()\n}\n\n/**\n * Get cache statistics\n */\nexport function getCacheStats(): { size: number; maxSize: number } {\n  return {\n    size: expressionCache.size,\n    maxSize: MAX_CACHE_SIZE\n  }\n}\n"],"names":["jsonata","expressionCache","Map","MAX_CACHE_SIZE","compileExpression","expression","compiled","get","registerCustomFunctions","size","firstKey","keys","next","value","delete","set","expr","registerFunction","name","startsWith","process","env","undefined","Date","toISOString","now","replace","c","r","Math","random","v","toString","defaultValue","JSON","parse","stringify","obj","Array","isArray","Object","values","key","evaluate","context","options","timeout","timeoutPromise","Promise","_","reject","setTimeout","Error","race","evaluateCondition","result","length","error","console","warn","message","transform","template","includes","e","debug","logger","info","all","map","item","entries","resolveStepInput","config","clearCache","clear","getCacheStats","maxSize"],"mappings":"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"}
+{"version":3,"sources":["../../src/core/expression-engine.ts"],"sourcesContent":["import jsonata from 'jsonata'\nimport type {Payload} from \"payload\";\n\n/**\n * Expression engine using JSONata for safe, sandboxed expression evaluation.\n * Used for both conditions and data transformation in workflows.\n *\n * @example Conditions\n * ```\n * trigger.doc._status = \"published\"\n * trigger.doc.count > 10 and trigger.doc.enabled\n * $exists(steps.validate.output.error) = false\n * ```\n *\n * @example Data Transformation\n * ```\n * {\n *   \"id\": trigger.doc.id,\n *   \"title\": $uppercase(trigger.doc.title),\n *   \"tags\": trigger.doc.tags[category = \"featured\"].name\n * }\n * ```\n */\n\nexport interface ExpressionContext {\n  trigger: Record<string, unknown>\n  steps: Record<string, unknown>\n  [key: string]: unknown\n}\n\nexport interface EvaluateOptions {\n  /** Timeout in milliseconds (default: 5000) */\n  timeout?: number\n  debug?: boolean\n  logger?: Payload['logger']\n}\n\n// Cache compiled expressions for performance\nconst expressionCache = new Map<string, jsonata.Expression>()\nconst MAX_CACHE_SIZE = 1000\n\n/**\n * Compile a JSONata expression with caching\n */\nfunction compileExpression(expression: string): jsonata.Expression {\n  let compiled = expressionCache.get(expression)\n\n  if (!compiled) {\n    compiled = jsonata(expression)\n\n    // Register custom functions\n    registerCustomFunctions(compiled)\n\n    // Manage cache size\n    if (expressionCache.size >= MAX_CACHE_SIZE) {\n      const firstKey = expressionCache.keys().next().value\n      if (firstKey) expressionCache.delete(firstKey)\n    }\n\n    expressionCache.set(expression, compiled)\n  }\n\n  return compiled\n}\n\n/**\n * Register custom functions on a JSONata expression\n */\nfunction registerCustomFunctions(expr: jsonata.Expression): void {\n  // $env(name) - Get environment variable (only non-sensitive ones)\n  expr.registerFunction('env', (name: string) => {\n    // Only allow specific prefixes for security\n    if (typeof name === 'string' && name.startsWith('PUBLIC_')) {\n      return process.env[name]\n    }\n    return undefined\n  }, '<s:s>')\n\n  // $now() - Current ISO timestamp\n  expr.registerFunction('now', () => new Date().toISOString(), '<:s>')\n\n  // $timestamp() - Current Unix timestamp in milliseconds\n  expr.registerFunction('timestamp', () => Date.now(), '<:n>')\n\n  // $uuid() - Generate a UUID v4\n  expr.registerFunction('uuid', () => {\n    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n      const r = (Math.random() * 16) | 0\n      const v = c === 'x' ? r : (r & 0x3) | 0x8\n      return v.toString(16)\n    })\n  }, '<:s>')\n\n  // $default(value, defaultValue) - Return default if value is null/undefined\n  expr.registerFunction('default', (value: unknown, defaultValue: unknown) => {\n    return value === null || value === undefined ? defaultValue : value\n  }, '<xx:x>')\n\n  // $json(value) - Parse JSON string\n  expr.registerFunction('json', (value: string) => {\n    try {\n      return JSON.parse(value)\n    } catch {\n      return undefined\n    }\n  }, '<s:x>')\n\n  // $stringify(value) - Convert to JSON string\n  expr.registerFunction('stringify', (value: unknown) => {\n    try {\n      return JSON.stringify(value)\n    } catch {\n      return undefined\n    }\n  }, '<x:s>')\n\n  // $keys(object) - Get object keys\n  expr.registerFunction('keys', (obj: Record<string, unknown>) => {\n    if (obj && typeof obj === 'object' && !Array.isArray(obj)) {\n      return Object.keys(obj)\n    }\n    return []\n  }, '<o:a>')\n\n  // $values(object) - Get object values\n  expr.registerFunction('values', (obj: Record<string, unknown>) => {\n    if (obj && typeof obj === 'object' && !Array.isArray(obj)) {\n      return Object.values(obj)\n    }\n    return []\n  }, '<o:a>')\n\n  // $has(object, key) - Check if object has key\n  expr.registerFunction('has', (obj: Record<string, unknown>, key: string) => {\n    if (obj && typeof obj === 'object') {\n      return key in obj\n    }\n    return false\n  }, '<os:b>')\n\n  // $coalesce(values...) - Return first non-null value\n  expr.registerFunction('coalesce', (...values: unknown[]) => {\n    for (const v of values) {\n      if (v !== null && v !== undefined) {\n        return v\n      }\n    }\n    return null\n  }, '<x+:x>')\n}\n\n/**\n * Evaluate a JSONata expression against a context\n */\nexport async function evaluate(\n  expression: string,\n  context: ExpressionContext,\n  options: EvaluateOptions = {}\n): Promise<unknown> {\n  const { timeout = 5000 } = options\n\n  const compiled = compileExpression(expression)\n\n  // Create a promise that rejects on timeout\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    setTimeout(() => reject(new Error(`Expression evaluation timed out after ${timeout}ms`)), timeout)\n  })\n\n  // Race between evaluation and timeout\n  return Promise.race([\n    compiled.evaluate(context),\n    timeoutPromise\n  ])\n}\n\n/**\n * Evaluate a condition expression and return a boolean\n */\nexport async function evaluateCondition(\n  expression: string,\n  context: ExpressionContext,\n  options: EvaluateOptions = {}\n): Promise<boolean> {\n  try {\n    const result = await evaluate(expression, context, options)\n\n    // Convert result to boolean\n    if (result === undefined || result === null) {\n      return false\n    }\n    if (typeof result === 'boolean') {\n      return result\n    }\n    if (typeof result === 'number') {\n      return result !== 0\n    }\n    if (typeof result === 'string') {\n      return result.length > 0\n    }\n    if (Array.isArray(result)) {\n      return result.length > 0\n    }\n    return true\n  } catch (error) {\n    // Log error but return false for failed conditions\n    console.warn('Condition evaluation failed:', error instanceof Error ? error.message : error)\n    return false\n  }\n}\n\n/**\n * Transform data using a JSONata expression\n * The expression can be a JSONata query or a JSON object with embedded expressions\n */\nexport async function transform(\n  template: unknown,\n  context: ExpressionContext,\n  options: EvaluateOptions = {}\n): Promise<unknown> {\n  if (typeof template === 'string') {\n    // Check if it looks like a JSONata expression (starts with common patterns)\n    if (\n      template.startsWith('{{')\n    ) {\n      try {\n        return await evaluate(template.trim().slice(2, -2), context, options)\n      } catch (e) {\n        if (options.debug && options.logger) {\n          options.logger.info(\n              e instanceof Error ? e.message : e,\n            'Failed to evaluate expression:',\n          )\n        }\n        // If it fails to evaluate, return as literal string\n        return template\n      }\n    }\n    return template\n  }\n\n  if (Array.isArray(template)) {\n    return Promise.all(template.map(item => transform(item, context, options)))\n  }\n\n  if (template && typeof template === 'object') {\n    const result: Record<string, unknown> = {}\n    for (const [key, value] of Object.entries(template)) {\n      result[key] = await transform(value, context, options)\n    }\n    return result\n  }\n\n  return template\n}\n\n/**\n * Resolve a step input configuration using JSONata\n * Handles both simple values and expressions\n */\nexport async function resolveStepInput(\n  config: Record<string, unknown>,\n  context: ExpressionContext,\n  options: EvaluateOptions = {}\n): Promise<Record<string, unknown>> {\n  const result: Record<string, unknown> = {}\n\n  for (const [key, value] of Object.entries(config)) {\n    result[key] = await transform(value, context, options)\n  }\n\n  return result\n}\n\n/**\n * Clear the expression cache\n */\nexport function clearCache(): void {\n  expressionCache.clear()\n}\n\n/**\n * Get cache statistics\n */\nexport function getCacheStats(): { size: number; maxSize: number } {\n  return {\n    size: expressionCache.size,\n    maxSize: MAX_CACHE_SIZE\n  }\n}\n"],"names":["jsonata","expressionCache","Map","MAX_CACHE_SIZE","compileExpression","expression","compiled","get","registerCustomFunctions","size","firstKey","keys","next","value","delete","set","expr","registerFunction","name","startsWith","process","env","undefined","Date","toISOString","now","replace","c","r","Math","random","v","toString","defaultValue","JSON","parse","stringify","obj","Array","isArray","Object","values","key","evaluate","context","options","timeout","timeoutPromise","Promise","_","reject","setTimeout","Error","race","evaluateCondition","result","length","error","console","warn","message","transform","template","trim","slice","e","debug","logger","info","all","map","item","entries","resolveStepInput","config","clearCache","clear","getCacheStats","maxSize"],"mappings":"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"}

package/dist/steps/index.d.ts

@@ -1,5 +1,3 @@
-export { createStep } from './create-step.js';
-export type { StepDefinition, StepTask } from './create-step.js';
 export { CreateDocumentStepTask } from './create-document.js';
 export { createDocumentHandler } from './create-document-handler.js';
 export { DeleteDocumentStepTask } from './delete-document.js';

package/dist/steps/index.js

@@ -1,5 +1,3 @@
-// Step factory for creating new steps
-export { createStep } from './create-step.js';
 // Built-in steps
 export { CreateDocumentStepTask } from './create-document.js';
 export { createDocumentHandler } from './create-document-handler.js';

package/dist/steps/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/steps/index.ts"],"sourcesContent":["// Step factory for creating new steps\nexport { createStep } from './create-step.js'\nexport type { StepDefinition, StepTask } from './create-step.js'\n\n// Built-in steps\nexport { CreateDocumentStepTask } from './create-document.js'\nexport { createDocumentHandler } from './create-document-handler.js'\nexport { DeleteDocumentStepTask } from './delete-document.js'\nexport { deleteDocumentHandler } from './delete-document-handler.js'\nexport { HttpRequestStepTask } from './http-request.js'\nexport { httpStepHandler } from './http-request-handler.js'\n\nexport { ReadDocumentStepTask } from './read-document.js'\nexport { readDocumentHandler } from './read-document-handler.js'\nexport { SendEmailStepTask } from './send-email.js'\nexport { sendEmailHandler } from './send-email-handler.js'\nexport { UpdateDocumentStepTask } from './update-document.js'\nexport { updateDocumentHandler } from './update-document-handler.js'\n"],"names":["createStep","CreateDocumentStepTask","createDocumentHandler","DeleteDocumentStepTask","deleteDocumentHandler","HttpRequestStepTask","httpStepHandler","ReadDocumentStepTask","readDocumentHandler","SendEmailStepTask","sendEmailHandler","UpdateDocumentStepTask","updateDocumentHandler"],"mappings":"AAAA,sCAAsC;AACtC,SAASA,UAAU,QAAQ,mBAAkB;AAG7C,iBAAiB;AACjB,SAASC,sBAAsB,QAAQ,uBAAsB;AAC7D,SAASC,qBAAqB,QAAQ,+BAA8B;AACpE,SAASC,sBAAsB,QAAQ,uBAAsB;AAC7D,SAASC,qBAAqB,QAAQ,+BAA8B;AACpE,SAASC,mBAAmB,QAAQ,oBAAmB;AACvD,SAASC,eAAe,QAAQ,4BAA2B;AAE3D,SAASC,oBAAoB,QAAQ,qBAAoB;AACzD,SAASC,mBAAmB,QAAQ,6BAA4B;AAChE,SAASC,iBAAiB,QAAQ,kBAAiB;AACnD,SAASC,gBAAgB,QAAQ,0BAAyB;AAC1D,SAASC,sBAAsB,QAAQ,uBAAsB;AAC7D,SAASC,qBAAqB,QAAQ,+BAA8B"}
+{"version":3,"sources":["../../src/steps/index.ts"],"sourcesContent":["// Built-in steps\nexport { CreateDocumentStepTask } from './create-document.js'\nexport { createDocumentHandler } from './create-document-handler.js'\nexport { DeleteDocumentStepTask } from './delete-document.js'\nexport { deleteDocumentHandler } from './delete-document-handler.js'\nexport { HttpRequestStepTask } from './http-request.js'\nexport { httpStepHandler } from './http-request-handler.js'\n\nexport { ReadDocumentStepTask } from './read-document.js'\nexport { readDocumentHandler } from './read-document-handler.js'\nexport { SendEmailStepTask } from './send-email.js'\nexport { sendEmailHandler } from './send-email-handler.js'\nexport { UpdateDocumentStepTask } from './update-document.js'\nexport { updateDocumentHandler } from './update-document-handler.js'\n"],"names":["CreateDocumentStepTask","createDocumentHandler","DeleteDocumentStepTask","deleteDocumentHandler","HttpRequestStepTask","httpStepHandler","ReadDocumentStepTask","readDocumentHandler","SendEmailStepTask","sendEmailHandler","UpdateDocumentStepTask","updateDocumentHandler"],"mappings":"AAAA,iBAAiB;AACjB,SAASA,sBAAsB,QAAQ,uBAAsB;AAC7D,SAASC,qBAAqB,QAAQ,+BAA8B;AACpE,SAASC,sBAAsB,QAAQ,uBAAsB;AAC7D,SAASC,qBAAqB,QAAQ,+BAA8B;AACpE,SAASC,mBAAmB,QAAQ,oBAAmB;AACvD,SAASC,eAAe,QAAQ,4BAA2B;AAE3D,SAASC,oBAAoB,QAAQ,qBAAoB;AACzD,SAASC,mBAAmB,QAAQ,6BAA4B;AAChE,SAASC,iBAAiB,QAAQ,kBAAiB;AACnD,SAASC,gBAAgB,QAAQ,0BAAyB;AAC1D,SAASC,sBAAsB,QAAQ,uBAAsB;AAC7D,SAASC,qBAAqB,QAAQ,+BAA8B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtr-dev/payload-automation",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "description": "PayloadCMS Automation Plugin - Comprehensive workflow automation system with visual workflow building, execution tracking, and step types",
   "license": "MIT",
   "type": "module",

package/dist/steps/create-step.d.ts

@@ -1,66 +0,0 @@
-import type { Field, JsonObject, PayloadRequest, TaskConfig } from 'payload';
-/**
- * Configuration for creating a step with the factory.
- */
-export interface StepDefinition<TSlug extends string> {
-    /** Unique identifier for the step */
-    slug: TSlug;
-    /** Human-readable label for the step (optional, defaults to slug) */
-    label?: string;
-    /** Input fields schema */
-    inputSchema: Field[];
-    /** Output fields schema */
-    outputSchema: Field[];
-    /**
-     * Optional validation function. Throw an error if validation fails.
-     * Runs before the execute function.
-     */
-    validate?: (input: JsonObject) => void;
-    /**
-     * The main execution function for the step.
-     * Should return the output data on success, or throw an error on failure.
-     */
-    execute: (input: JsonObject, req: PayloadRequest) => Promise<JsonObject>;
-}
-/**
- * The result type returned by createStep.
- * Combines TaskConfig with the handler for convenience.
- */
-export type StepTask<TSlug extends string> = TaskConfig<TSlug>;
-/**
- * Creates a step definition that combines TaskConfig and handler in one place.
- *
- * This factory eliminates the need for separate `{step}.ts` and `{step}-handler.ts` files
- * by providing a single unified definition.
- *
- * @example
- * ```typescript
- * export const myStep = createStep({
- *   slug: 'my-step',
- *   inputSchema: [
- *     { name: 'url', type: 'text', required: true }
- *   ],
- *   outputSchema: [
- *     { name: 'result', type: 'json' }
- *   ],
- *   validate: (input) => {
- *     if (!input.url) throw new Error('URL is required')
- *   },
- *   execute: async (input, req) => {
- *     const response = await fetch(input.url)
- *     return { result: await response.json() }
- *   }
- * })
- * ```
- */
-export declare function createStep<TSlug extends string>(definition: StepDefinition<TSlug>): StepTask<TSlug>;
-/**
- * Helper type to extract input type from a step's inputSchema.
- * Note: This provides a basic type based on field names, not full type inference.
- */
-export type StepInput<T extends StepTask<string>> = T extends StepTask<infer _> ? Record<string, unknown> : never;
-/**
- * Helper type to extract output type from a step's outputSchema.
- * Note: This provides a basic type based on field names, not full type inference.
- */
-export type StepOutput<T extends StepTask<string>> = T extends StepTask<infer _> ? Record<string, unknown> : never;

package/dist/steps/create-step.js

@@ -1,59 +0,0 @@
-/**
- * Creates a step definition that combines TaskConfig and handler in one place.
- *
- * This factory eliminates the need for separate `{step}.ts` and `{step}-handler.ts` files
- * by providing a single unified definition.
- *
- * @example
- * ```typescript
- * export const myStep = createStep({
- *   slug: 'my-step',
- *   inputSchema: [
- *     { name: 'url', type: 'text', required: true }
- *   ],
- *   outputSchema: [
- *     { name: 'result', type: 'json' }
- *   ],
- *   validate: (input) => {
- *     if (!input.url) throw new Error('URL is required')
- *   },
- *   execute: async (input, req) => {
- *     const response = await fetch(input.url)
- *     return { result: await response.json() }
- *   }
- * })
- * ```
- */ export function createStep(definition) {
-    const { slug, label, inputSchema, outputSchema, validate, execute } = definition;
-    // Create the handler that wraps validation and execution
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const handler = async ({ input, req })=>{
-        try {
-            const jsonInput = input ?? {};
-            // Run validation if provided
-            if (validate) {
-                validate(jsonInput);
-            }
-            // Execute the step
-            const output = await execute(jsonInput, req);
-            return {
-                output,
-                state: 'succeeded'
-            };
-        } catch (error) {
-            return {
-                errorMessage: error instanceof Error ? error.message : 'Unknown error',
-                state: 'failed'
-            };
-        }
-    };
-    return {
-        slug,
-        label,
-        handler,
-        inputSchema,
-        outputSchema
-    };
-}
-
-//# sourceMappingURL=create-step.js.map

package/dist/steps/create-step.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/steps/create-step.ts"],"sourcesContent":["import type { Field, JsonObject, PayloadRequest, TaskConfig, TaskHandler } from 'payload'\n\n/**\n * Configuration for creating a step with the factory.\n */\nexport interface StepDefinition<TSlug extends string> {\n  /** Unique identifier for the step */\n  slug: TSlug\n  /** Human-readable label for the step (optional, defaults to slug) */\n  label?: string\n  /** Input fields schema */\n  inputSchema: Field[]\n  /** Output fields schema */\n  outputSchema: Field[]\n  /**\n   * Optional validation function. Throw an error if validation fails.\n   * Runs before the execute function.\n   */\n  validate?: (input: JsonObject) => void\n  /**\n   * The main execution function for the step.\n   * Should return the output data on success, or throw an error on failure.\n   */\n  execute: (input: JsonObject, req: PayloadRequest) => Promise<JsonObject>\n}\n\n/**\n * The result type returned by createStep.\n * Combines TaskConfig with the handler for convenience.\n */\nexport type StepTask<TSlug extends string> = TaskConfig<TSlug>\n\n/**\n * Creates a step definition that combines TaskConfig and handler in one place.\n *\n * This factory eliminates the need for separate `{step}.ts` and `{step}-handler.ts` files\n * by providing a single unified definition.\n *\n * @example\n * ```typescript\n * export const myStep = createStep({\n *   slug: 'my-step',\n *   inputSchema: [\n *     { name: 'url', type: 'text', required: true }\n *   ],\n *   outputSchema: [\n *     { name: 'result', type: 'json' }\n *   ],\n *   validate: (input) => {\n *     if (!input.url) throw new Error('URL is required')\n *   },\n *   execute: async (input, req) => {\n *     const response = await fetch(input.url)\n *     return { result: await response.json() }\n *   }\n * })\n * ```\n */\nexport function createStep<TSlug extends string>(\n  definition: StepDefinition<TSlug>\n): StepTask<TSlug> {\n  const { slug, label, inputSchema, outputSchema, validate, execute } = definition\n\n  // Create the handler that wraps validation and execution\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const handler = async ({ input, req }: any) => {\n    try {\n      const jsonInput = (input ?? {}) as JsonObject\n\n      // Run validation if provided\n      if (validate) {\n        validate(jsonInput)\n      }\n\n      // Execute the step\n      const output = await execute(jsonInput, req)\n      return {\n        output,\n        state: 'succeeded'\n      }\n    } catch (error) {\n      return {\n        errorMessage: error instanceof Error ? error.message : 'Unknown error',\n        state: 'failed'\n      }\n    }\n  }\n\n  return {\n    slug,\n    label,\n    handler,\n    inputSchema,\n    outputSchema\n  } as StepTask<TSlug>\n}\n\n/**\n * Helper type to extract input type from a step's inputSchema.\n * Note: This provides a basic type based on field names, not full type inference.\n */\nexport type StepInput<T extends StepTask<string>> = T extends StepTask<infer _>\n  ? Record<string, unknown>\n  : never\n\n/**\n * Helper type to extract output type from a step's outputSchema.\n * Note: This provides a basic type based on field names, not full type inference.\n */\nexport type StepOutput<T extends StepTask<string>> = T extends StepTask<infer _>\n  ? Record<string, unknown>\n  : never\n"],"names":["createStep","definition","slug","label","inputSchema","outputSchema","validate","execute","handler","input","req","jsonInput","output","state","error","errorMessage","Error","message"],"mappings":"AAgCA;;;;;;;;;;;;;;;;;;;;;;;;;CAyBC,GACD,OAAO,SAASA,WACdC,UAAiC;IAEjC,MAAM,EAAEC,IAAI,EAAEC,KAAK,EAAEC,WAAW,EAAEC,YAAY,EAAEC,QAAQ,EAAEC,OAAO,EAAE,GAAGN;IAEtE,yDAAyD;IACzD,8DAA8D;IAC9D,MAAMO,UAAU,OAAO,EAAEC,KAAK,EAAEC,GAAG,EAAO;QACxC,IAAI;YACF,MAAMC,YAAaF,SAAS,CAAC;YAE7B,6BAA6B;YAC7B,IAAIH,UAAU;gBACZA,SAASK;YACX;YAEA,mBAAmB;YACnB,MAAMC,SAAS,MAAML,QAAQI,WAAWD;YACxC,OAAO;gBACLE;gBACAC,OAAO;YACT;QACF,EAAE,OAAOC,OAAO;YACd,OAAO;gBACLC,cAAcD,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG;gBACvDJ,OAAO;YACT;QACF;IACF;IAEA,OAAO;QACLX;QACAC;QACAK;QACAJ;QACAC;IACF;AACF"}