@xtr-dev/payload-automation 0.0.1

package/README.md

@@ -0,0 +1,73 @@
+# @xtr-dev/payload-automation
+
+A comprehensive workflow automation plugin for PayloadCMS 3.x that enables visual workflow building, execution tracking, and parallel processing.
+
+⚠️ **Pre-release Warning**: This package is currently in active development (v0.0.x). Breaking changes may occur before v1.0.0. Not recommended for production use.
+
+## Features
+
+- 🔄 **Visual Workflow Builder** - Create complex workflows with drag-and-drop interface
+- ⚡ **Parallel Execution** - Smart dependency resolution for optimal performance
+- 🎯 **Multiple Triggers** - Collection hooks, webhooks, manual execution
+- 📊 **Execution Tracking** - Complete history and monitoring of workflow runs
+- 🔧 **Extensible Steps** - HTTP requests, document CRUD, email notifications
+- 🔍 **JSONPath Integration** - Dynamic data interpolation and transformation
+
+## Installation
+
+```bash
+npm install @xtr-dev/payload-automation
+# or
+pnpm add @xtr-dev/payload-automation
+# or
+yarn add @xtr-dev/payload-automation
+```
+
+## Quick Start
+
+```typescript
+import { buildConfig } from 'payload'
+import { payloadAutomation } from '@xtr-dev/payload-automation'
+
+export default buildConfig({
+  // ... your config
+  plugins: [
+    payloadAutomation({
+      collections: ['posts', 'users'], // Collections to monitor
+      globals: ['settings'],           // Globals to monitor
+      enabled: true,
+    }),
+  ],
+})
+```
+
+## Step Types
+
+- **HTTP Request** - Make external API calls
+- **Create Document** - Create PayloadCMS documents
+- **Read Document** - Query documents with filters
+- **Update Document** - Modify existing documents
+- **Delete Document** - Remove documents
+- **Send Email** - Send notifications via PayloadCMS email
+
+## Data Resolution
+
+Use JSONPath to access workflow data:
+
+- `$.trigger.doc.id` - Access trigger document
+- `$.steps.stepName.output` - Use previous step outputs
+- `$.context` - Access workflow context
+
+## Requirements
+
+- PayloadCMS ^3.45.0
+- Node.js ^18.20.2 || >=20.9.0
+- pnpm ^9 || ^10
+
+## Documentation
+
+Full documentation coming soon. For now, explore the development environment in the repository for examples and patterns.
+
+## License
+
+MIT

package/dist/collections/Workflow.d.ts

@@ -0,0 +1,3 @@
+import type { CollectionConfig } from 'payload';
+import type { WorkflowsPluginConfig } from "../plugin/config-types.js";
+export declare const createWorkflowCollection: <T extends string>(options: WorkflowsPluginConfig<T>) => CollectionConfig;

package/dist/collections/Workflow.js

@@ -0,0 +1,223 @@
+export const createWorkflowCollection = ({ collectionTriggers, steps, triggers })=>({
+        slug: 'workflows',
+        access: {
+            create: ()=>true,
+            delete: ()=>true,
+            read: ()=>true,
+            update: ()=>true
+        },
+        admin: {
+            defaultColumns: [
+                'name',
+                'updatedAt'
+            ],
+            description: 'Create and manage automated workflows.',
+            group: 'Automation',
+            useAsTitle: 'name'
+        },
+        fields: [
+            {
+                name: 'name',
+                type: 'text',
+                admin: {
+                    description: 'Human-readable name for the workflow'
+                },
+                required: true
+            },
+            {
+                name: 'description',
+                type: 'textarea',
+                admin: {
+                    description: 'Optional description of what this workflow does'
+                }
+            },
+            {
+                name: 'triggers',
+                type: 'array',
+                fields: [
+                    {
+                        name: 'type',
+                        type: 'select',
+                        options: [
+                            'collection-trigger',
+                            'webhook-trigger',
+                            'global-trigger',
+                            'cron-trigger',
+                            ...(triggers || []).map((t)=>t.slug)
+                        ]
+                    },
+                    {
+                        name: 'collection',
+                        type: 'select',
+                        admin: {
+                            condition: (_, siblingData)=>siblingData?.type === 'collection-trigger',
+                            description: 'Collection that triggers the workflow'
+                        },
+                        options: Object.keys(collectionTriggers || {})
+                    },
+                    {
+                        name: 'operation',
+                        type: 'select',
+                        admin: {
+                            condition: (_, siblingData)=>siblingData?.type === 'collection-trigger',
+                            description: 'Collection operation that triggers the workflow'
+                        },
+                        options: [
+                            'create',
+                            'delete',
+                            'read',
+                            'update'
+                        ]
+                    },
+                    {
+                        name: 'webhookPath',
+                        type: 'text',
+                        admin: {
+                            condition: (_, siblingData)=>siblingData?.type === 'webhook-trigger',
+                            description: 'URL path for the webhook (e.g., "my-webhook"). Full URL will be /api/workflows/webhook/my-webhook'
+                        },
+                        validate: (value, { siblingData })=>{
+                            if (siblingData?.type === 'webhook-trigger' && !value) {
+                                return 'Webhook path is required for webhook triggers';
+                            }
+                            return true;
+                        }
+                    },
+                    {
+                        name: 'global',
+                        type: 'select',
+                        admin: {
+                            condition: (_, siblingData)=>siblingData?.type === 'global-trigger',
+                            description: 'Global that triggers the workflow'
+                        },
+                        options: [] // Will be populated dynamically based on available globals
+                    },
+                    {
+                        name: 'globalOperation',
+                        type: 'select',
+                        admin: {
+                            condition: (_, siblingData)=>siblingData?.type === 'global-trigger',
+                            description: 'Global operation that triggers the workflow'
+                        },
+                        options: [
+                            'update'
+                        ]
+                    },
+                    {
+                        name: 'cronExpression',
+                        type: 'text',
+                        admin: {
+                            condition: (_, siblingData)=>siblingData?.type === 'cron-trigger',
+                            description: 'Cron expression for scheduled execution (e.g., "0 0 * * *" for daily at midnight)',
+                            placeholder: '0 0 * * *'
+                        },
+                        validate: (value, { siblingData })=>{
+                            if (siblingData?.type === 'cron-trigger' && !value) {
+                                return 'Cron expression is required for cron triggers';
+                            }
+                            // Validate cron expression format if provided
+                            if (siblingData?.type === 'cron-trigger' && value) {
+                                // Basic format validation - should be 5 parts separated by spaces
+                                const cronParts = value.trim().split(/\s+/);
+                                if (cronParts.length !== 5) {
+                                    return 'Invalid cron expression format. Expected 5 parts: "minute hour day month weekday" (e.g., "0 9 * * 1")';
+                                }
+                            // Additional validation could use node-cron but we avoid dynamic imports here
+                            // The main validation happens at runtime in the cron scheduler
+                            }
+                            return true;
+                        }
+                    },
+                    {
+                        name: 'timezone',
+                        type: 'text',
+                        admin: {
+                            condition: (_, siblingData)=>siblingData?.type === 'cron-trigger',
+                            description: 'Timezone for cron execution (e.g., "America/New_York", "Europe/London"). Defaults to UTC.',
+                            placeholder: 'UTC'
+                        },
+                        defaultValue: 'UTC',
+                        validate: (value, { siblingData })=>{
+                            if (siblingData?.type === 'cron-trigger' && value) {
+                                try {
+                                    // Test if timezone is valid by trying to create a date with it
+                                    new Intl.DateTimeFormat('en', {
+                                        timeZone: value
+                                    });
+                                    return true;
+                                } catch  {
+                                    return `Invalid timezone: ${value}. Please use a valid IANA timezone identifier (e.g., "America/New_York", "Europe/London")`;
+                                }
+                            }
+                            return true;
+                        }
+                    },
+                    {
+                        name: 'condition',
+                        type: 'text',
+                        admin: {
+                            description: 'JSONPath expression that must evaluate to true for this trigger to execute the workflow (e.g., "$.doc.status == \'published\'")'
+                        },
+                        required: false
+                    },
+                    ...(triggers || []).flatMap((t)=>(t.inputs || []).map((f)=>({
+                                ...f,
+                                admin: {
+                                    ...f.admin || {},
+                                    condition: (...args)=>args[1]?.type === t.slug && (f.admin?.condition ? f.admin.condition.call(this, ...args) : true)
+                                }
+                            })))
+                ]
+            },
+            {
+                name: 'steps',
+                type: 'array',
+                fields: [
+                    {
+                        type: 'row',
+                        fields: [
+                            {
+                                name: 'step',
+                                type: 'select',
+                                options: steps.map((t)=>t.slug)
+                            },
+                            {
+                                name: 'name',
+                                type: 'text'
+                            }
+                        ]
+                    },
+                    {
+                        name: 'input',
+                        type: 'json',
+                        required: false
+                    },
+                    {
+                        name: 'dependencies',
+                        type: 'text',
+                        admin: {
+                            description: 'Step names that must complete before this step can run'
+                        },
+                        hasMany: true,
+                        required: false
+                    },
+                    {
+                        name: 'condition',
+                        type: 'text',
+                        admin: {
+                            description: 'JSONPath expression that must evaluate to true for this step to execute (e.g., "$.trigger.doc.status == \'published\'")'
+                        },
+                        required: false
+                    }
+                ]
+            }
+        ],
+        versions: {
+            drafts: {
+                autosave: false
+            },
+            maxPerDoc: 10
+        }
+    });
+
+//# sourceMappingURL=Workflow.js.map

package/dist/collections/Workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/collections/Workflow.ts"],"sourcesContent":["import type {CollectionConfig, Field} from 'payload'\n\nimport type {WorkflowsPluginConfig} from \"../plugin/config-types.js\"\n\nexport const createWorkflowCollection: <T extends string>(options: WorkflowsPluginConfig<T>) => CollectionConfig = ({\n                                                                                                        collectionTriggers,\n                                                                                                        steps,\n                                                                                                        triggers\n                                                                                                      }) => ({\n  slug: 'workflows',\n  access: {\n    create: () => true,\n    delete: () => true,\n    read: () => true,\n    update: () => true,\n  },\n  admin: {\n    defaultColumns: ['name', 'updatedAt'],\n    description: 'Create and manage automated workflows.',\n    group: 'Automation',\n    useAsTitle: 'name',\n  },\n  fields: [\n    {\n      name: 'name',\n      type: 'text',\n      admin: {\n        description: 'Human-readable name for the workflow',\n      },\n      required: true,\n    },\n    {\n      name: 'description',\n      type: 'textarea',\n      admin: {\n        description: 'Optional description of what this workflow does',\n      },\n    },\n    {\n      name: 'triggers',\n      type: 'array',\n      fields: [\n        {\n          name: 'type',\n          type: 'select',\n          options: [\n            'collection-trigger',\n            'webhook-trigger',\n            'global-trigger',\n            'cron-trigger',\n            ...(triggers || []).map(t => t.slug)\n          ]\n        },\n        {\n          name: 'collection',\n          type: 'select',\n          admin: {\n            condition: (_, siblingData) => siblingData?.type === 'collection-trigger',\n            description: 'Collection that triggers the workflow',\n          },\n          options: Object.keys(collectionTriggers || {})\n        },\n        {\n          name: 'operation',\n          type: 'select',\n          admin: {\n            condition: (_, siblingData) => siblingData?.type === 'collection-trigger',\n            description: 'Collection operation that triggers the workflow',\n          },\n          options: [\n            'create',\n            'delete',\n            'read',\n            'update',\n          ]\n        },\n        {\n          name: 'webhookPath',\n          type: 'text',\n          admin: {\n            condition: (_, siblingData) => siblingData?.type === 'webhook-trigger',\n            description: 'URL path for the webhook (e.g., \"my-webhook\"). Full URL will be /api/workflows/webhook/my-webhook',\n          },\n          validate: (value: any, {siblingData}: any) => {\n            if (siblingData?.type === 'webhook-trigger' && !value) {\n              return 'Webhook path is required for webhook triggers'\n            }\n            return true\n          }\n        },\n        {\n          name: 'global',\n          type: 'select',\n          admin: {\n            condition: (_, siblingData) => siblingData?.type === 'global-trigger',\n            description: 'Global that triggers the workflow',\n          },\n          options: [] // Will be populated dynamically based on available globals\n        },\n        {\n          name: 'globalOperation',\n          type: 'select',\n          admin: {\n            condition: (_, siblingData) => siblingData?.type === 'global-trigger',\n            description: 'Global operation that triggers the workflow',\n          },\n          options: [\n            'update'\n          ]\n        },\n        {\n          name: 'cronExpression',\n          type: 'text',\n          admin: {\n            condition: (_, siblingData) => siblingData?.type === 'cron-trigger',\n            description: 'Cron expression for scheduled execution (e.g., \"0 0 * * *\" for daily at midnight)',\n            placeholder: '0 0 * * *'\n          },\n          validate: (value: any, {siblingData}: any) => {\n            if (siblingData?.type === 'cron-trigger' && !value) {\n              return 'Cron expression is required for cron triggers'\n            }\n\n            // Validate cron expression format if provided\n            if (siblingData?.type === 'cron-trigger' && value) {\n              // Basic format validation - should be 5 parts separated by spaces\n              const cronParts = value.trim().split(/\\s+/)\n              if (cronParts.length !== 5) {\n                return 'Invalid cron expression format. Expected 5 parts: \"minute hour day month weekday\" (e.g., \"0 9 * * 1\")'\n              }\n\n              // Additional validation could use node-cron but we avoid dynamic imports here\n              // The main validation happens at runtime in the cron scheduler\n            }\n\n            return true\n          }\n        },\n        {\n          name: 'timezone',\n          type: 'text',\n          admin: {\n            condition: (_, siblingData) => siblingData?.type === 'cron-trigger',\n            description: 'Timezone for cron execution (e.g., \"America/New_York\", \"Europe/London\"). Defaults to UTC.',\n            placeholder: 'UTC'\n          },\n          defaultValue: 'UTC',\n          validate: (value: any, {siblingData}: any) => {\n            if (siblingData?.type === 'cron-trigger' && value) {\n              try {\n                // Test if timezone is valid by trying to create a date with it\n                new Intl.DateTimeFormat('en', {timeZone: value})\n                return true\n              } catch {\n                return `Invalid timezone: ${value}. Please use a valid IANA timezone identifier (e.g., \"America/New_York\", \"Europe/London\")`\n              }\n            }\n            return true\n          }\n        },\n        {\n          name: 'condition',\n          type: 'text',\n          admin: {\n            description: 'JSONPath expression that must evaluate to true for this trigger to execute the workflow (e.g., \"$.doc.status == \\'published\\'\")'\n          },\n          required: false\n        },\n        ...(triggers || []).flatMap(t => (t.inputs || []).map(f => ({\n          ...f,\n          admin: {\n            ...(f.admin || {}),\n            condition: (...args) => args[1]?.type === t.slug && (\n              f.admin?.condition ?\n                f.admin.condition.call(this, ...args) :\n                true\n            ),\n          },\n        } as Field)))\n      ]\n    },\n    {\n      name: 'steps',\n      type: 'array',\n      fields: [\n        {\n          type: 'row',\n          fields: [\n            {\n              name: 'step',\n              type: 'select',\n              options: steps.map(t => t.slug)\n            },\n            {\n              name: 'name',\n              type: 'text',\n            }\n          ]\n        },\n        {\n          name: 'input',\n          type: 'json',\n          required: false\n        },\n        {\n          name: 'dependencies',\n          type: 'text',\n          admin: {\n            description: 'Step names that must complete before this step can run'\n          },\n          hasMany: true,\n          required: false\n        },\n        {\n          name: 'condition',\n          type: 'text',\n          admin: {\n            description: 'JSONPath expression that must evaluate to true for this step to execute (e.g., \"$.trigger.doc.status == \\'published\\'\")'\n          },\n          required: false\n        },\n      ],\n    }\n  ],\n  versions: {\n    drafts: {\n      autosave: false,\n    },\n    maxPerDoc: 10,\n  },\n})\n"],"names":["createWorkflowCollection","collectionTriggers","steps","triggers","slug","access","create","delete","read","update","admin","defaultColumns","description","group","useAsTitle","fields","name","type","required","options","map","t","condition","_","siblingData","Object","keys","validate","value","placeholder","cronParts","trim","split","length","defaultValue","Intl","DateTimeFormat","timeZone","flatMap","inputs","f","args","call","hasMany","versions","drafts","autosave","maxPerDoc"],"mappings":"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"}

package/dist/collections/WorkflowRuns.d.ts

@@ -0,0 +1,2 @@
+import type { CollectionConfig } from 'payload';
+export declare const WorkflowRunsCollection: CollectionConfig;

package/dist/collections/WorkflowRuns.js

@@ -0,0 +1,157 @@
+export const WorkflowRunsCollection = {
+    slug: 'workflow-runs',
+    access: {
+        create: ()=>true,
+        delete: ()=>true,
+        read: ()=>true,
+        update: ()=>true
+    },
+    admin: {
+        defaultColumns: [
+            'workflow',
+            'status',
+            'triggeredBy',
+            'startedAt',
+            'duration'
+        ],
+        group: 'Automation',
+        pagination: {
+            defaultLimit: 50
+        },
+        useAsTitle: 'id'
+    },
+    fields: [
+        {
+            name: 'workflow',
+            type: 'relationship',
+            admin: {
+                description: 'Reference to the workflow that was executed'
+            },
+            relationTo: 'workflows',
+            required: true
+        },
+        {
+            name: 'workflowVersion',
+            type: 'number',
+            admin: {
+                description: 'Version of the workflow that was executed'
+            },
+            required: true
+        },
+        {
+            name: 'status',
+            type: 'select',
+            admin: {
+                description: 'Current execution status'
+            },
+            defaultValue: 'pending',
+            options: [
+                {
+                    label: 'Pending',
+                    value: 'pending'
+                },
+                {
+                    label: 'Running',
+                    value: 'running'
+                },
+                {
+                    label: 'Completed',
+                    value: 'completed'
+                },
+                {
+                    label: 'Failed',
+                    value: 'failed'
+                },
+                {
+                    label: 'Cancelled',
+                    value: 'cancelled'
+                }
+            ],
+            required: true
+        },
+        {
+            name: 'startedAt',
+            type: 'date',
+            admin: {
+                date: {
+                    displayFormat: 'yyyy-MM-dd HH:mm:ss'
+                },
+                description: 'When execution began'
+            },
+            required: true
+        },
+        {
+            name: 'completedAt',
+            type: 'date',
+            admin: {
+                date: {
+                    displayFormat: 'yyyy-MM-dd HH:mm:ss'
+                },
+                description: 'When execution finished'
+            }
+        },
+        {
+            name: 'duration',
+            type: 'number',
+            admin: {
+                description: 'Total execution time in milliseconds',
+                readOnly: true
+            }
+        },
+        {
+            name: 'context',
+            type: 'json'
+        },
+        {
+            name: 'inputs',
+            type: 'json',
+            admin: {
+                description: 'Input data provided when the workflow was triggered'
+            },
+            defaultValue: {},
+            required: true
+        },
+        {
+            name: 'outputs',
+            type: 'json',
+            admin: {
+                description: 'Final output data from completed steps'
+            }
+        },
+        {
+            name: 'triggeredBy',
+            type: 'text',
+            admin: {
+                description: 'User, system, or trigger type that initiated execution'
+            },
+            required: true
+        },
+        {
+            name: 'steps',
+            type: 'json',
+            admin: {
+                description: 'Array of step execution results'
+            },
+            defaultValue: [],
+            required: true
+        },
+        {
+            name: 'error',
+            type: 'textarea',
+            admin: {
+                description: 'Error message if workflow execution failed'
+            }
+        },
+        {
+            name: 'logs',
+            type: 'json',
+            admin: {
+                description: 'Detailed execution logs'
+            },
+            defaultValue: [],
+            required: true
+        }
+    ]
+};
+
+//# sourceMappingURL=WorkflowRuns.js.map

package/dist/collections/WorkflowRuns.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/collections/WorkflowRuns.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\n\nexport const WorkflowRunsCollection: CollectionConfig = {\n  slug: 'workflow-runs',\n  access: {\n    create: () => true,\n    delete: () => true,\n    read: () => true,\n    update: () => true,\n  },\n  admin: {\n    defaultColumns: ['workflow', 'status', 'triggeredBy', 'startedAt', 'duration'],\n    group: 'Automation',\n    pagination: {\n      defaultLimit: 50,\n    },\n    useAsTitle: 'id',\n  },\n  fields: [\n    {\n      name: 'workflow',\n      type: 'relationship',\n      admin: {\n        description: 'Reference to the workflow that was executed',\n      },\n      relationTo: 'workflows',\n      required: true,\n    },\n    {\n      name: 'workflowVersion',\n      type: 'number',\n      admin: {\n        description: 'Version of the workflow that was executed',\n      },\n      required: true,\n    },\n    {\n      name: 'status',\n      type: 'select',\n      admin: {\n        description: 'Current execution status',\n      },\n      defaultValue: 'pending',\n      options: [\n        {\n          label: 'Pending',\n          value: 'pending',\n        },\n        {\n          label: 'Running',\n          value: 'running',\n        },\n        {\n          label: 'Completed',\n          value: 'completed',\n        },\n        {\n          label: 'Failed',\n          value: 'failed',\n        },\n        {\n          label: 'Cancelled',\n          value: 'cancelled',\n        },\n      ],\n      required: true,\n    },\n    {\n      name: 'startedAt',\n      type: 'date',\n      admin: {\n        date: {\n          displayFormat: 'yyyy-MM-dd HH:mm:ss',\n        },\n        description: 'When execution began',\n      },\n      required: true,\n    },\n    {\n      name: 'completedAt',\n      type: 'date',\n      admin: {\n        date: {\n          displayFormat: 'yyyy-MM-dd HH:mm:ss',\n        },\n        description: 'When execution finished',\n      },\n    },\n    {\n      name: 'duration',\n      type: 'number',\n      admin: {\n        description: 'Total execution time in milliseconds',\n        readOnly: true,\n      },\n    },\n    {\n      name: 'context',\n      type: 'json'\n    },\n    {\n      name: 'inputs',\n      type: 'json',\n      admin: {\n        description: 'Input data provided when the workflow was triggered',\n      },\n      defaultValue: {},\n      required: true,\n    },\n    {\n      name: 'outputs',\n      type: 'json',\n      admin: {\n        description: 'Final output data from completed steps',\n      },\n    },\n    {\n      name: 'triggeredBy',\n      type: 'text',\n      admin: {\n        description: 'User, system, or trigger type that initiated execution',\n      },\n      required: true,\n    },\n    {\n      name: 'steps',\n      type: 'json',\n      admin: {\n        description: 'Array of step execution results',\n      },\n      defaultValue: [],\n      required: true,\n    },\n    {\n      name: 'error',\n      type: 'textarea',\n      admin: {\n        description: 'Error message if workflow execution failed',\n      },\n    },\n    {\n      name: 'logs',\n      type: 'json',\n      admin: {\n        description: 'Detailed execution logs',\n      },\n      defaultValue: [],\n      required: true,\n    },\n  ],\n}\n"],"names":["WorkflowRunsCollection","slug","access","create","delete","read","update","admin","defaultColumns","group","pagination","defaultLimit","useAsTitle","fields","name","type","description","relationTo","required","defaultValue","options","label","value","date","displayFormat","readOnly"],"mappings":"AAEA,OAAO,MAAMA,yBAA2C;IACtDC,MAAM;IACNC,QAAQ;QACNC,QAAQ,IAAM;QACdC,QAAQ,IAAM;QACdC,MAAM,IAAM;QACZC,QAAQ,IAAM;IAChB;IACAC,OAAO;QACLC,gBAAgB;YAAC;YAAY;YAAU;YAAe;YAAa;SAAW;QAC9EC,OAAO;QACPC,YAAY;YACVC,cAAc;QAChB;QACAC,YAAY;IACd;IACAC,QAAQ;QACN;YACEC,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLS,aAAa;YACf;YACAC,YAAY;YACZC,UAAU;QACZ;QACA;YACEJ,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLS,aAAa;YACf;YACAE,UAAU;QACZ;QACA;YACEJ,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLS,aAAa;YACf;YACAG,cAAc;YACdC,SAAS;gBACP;oBACEC,OAAO;oBACPC,OAAO;gBACT;gBACA;oBACED,OAAO;oBACPC,OAAO;gBACT;gBACA;oBACED,OAAO;oBACPC,OAAO;gBACT;gBACA;oBACED,OAAO;oBACPC,OAAO;gBACT;gBACA;oBACED,OAAO;oBACPC,OAAO;gBACT;aACD;YACDJ,UAAU;QACZ;QACA;YACEJ,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLgB,MAAM;oBACJC,eAAe;gBACjB;gBACAR,aAAa;YACf;YACAE,UAAU;QACZ;QACA;YACEJ,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLgB,MAAM;oBACJC,eAAe;gBACjB;gBACAR,aAAa;YACf;QACF;QACA;YACEF,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLS,aAAa;gBACbS,UAAU;YACZ;QACF;QACA;YACEX,MAAM;YACNC,MAAM;QACR;QACA;YACED,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLS,aAAa;YACf;YACAG,cAAc,CAAC;YACfD,UAAU;QACZ;QACA;YACEJ,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLS,aAAa;YACf;QACF;QACA;YACEF,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLS,aAAa;YACf;YACAE,UAAU;QACZ;QACA;YACEJ,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLS,aAAa;YACf;YACAG,cAAc,EAAE;YAChBD,UAAU;QACZ;QACA;YACEJ,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLS,aAAa;YACf;QACF;QACA;YACEF,MAAM;YACNC,MAAM;YACNR,OAAO;gBACLS,aAAa;YACf;YACAG,cAAc,EAAE;YAChBD,UAAU;QACZ;KACD;AACH,EAAC"}

package/dist/components/TriggerWorkflowButton.d.ts

@@ -0,0 +1,7 @@
+interface TriggerWorkflowButtonProps {
+    workflowId: string;
+    workflowName: string;
+    triggerSlug?: string;
+}
+export declare const TriggerWorkflowButton: React.FC<TriggerWorkflowButtonProps>;
+export {};

package/dist/components/TriggerWorkflowButton.js

@@ -0,0 +1,46 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Button, toast } from '@payloadcms/ui';
+import { useState } from 'react';
+export const TriggerWorkflowButton = ({ workflowId, workflowName, triggerSlug = 'manual-trigger' })=>{
+    const [loading, setLoading] = useState(false);
+    const handleTrigger = async ()=>{
+        setLoading(true);
+        try {
+            const response = await fetch('/api/workflows/trigger-custom', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    workflowId,
+                    triggerSlug,
+                    data: {
+                        triggeredAt: new Date().toISOString(),
+                        source: 'admin-button'
+                    }
+                })
+            });
+            if (!response.ok) {
+                const error = await response.json();
+                throw new Error(error.message || 'Failed to trigger workflow');
+            }
+            const result = await response.json();
+            toast.success(`Workflow "${workflowName}" triggered successfully! Run ID: ${result.runId}`);
+        } catch (error) {
+            console.error('Error triggering workflow:', error);
+            toast.error(`Failed to trigger workflow: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        } finally{
+            setLoading(false);
+        }
+    };
+    return /*#__PURE__*/ _jsx(Button, {
+        onClick: handleTrigger,
+        disabled: loading,
+        size: "small",
+        buttonStyle: "secondary",
+        children: loading ? 'Triggering...' : 'Trigger Workflow'
+    });
+};
+
+//# sourceMappingURL=TriggerWorkflowButton.js.map

package/dist/components/TriggerWorkflowButton.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/TriggerWorkflowButton.tsx"],"sourcesContent":["'use client'\n\nimport { Button, toast } from '@payloadcms/ui'\nimport { useState } from 'react'\n\ninterface TriggerWorkflowButtonProps {\n  workflowId: string\n  workflowName: string\n  triggerSlug?: string\n}\n\nexport const TriggerWorkflowButton: React.FC<TriggerWorkflowButtonProps> = ({\n  workflowId,\n  workflowName,\n  triggerSlug = 'manual-trigger'\n}) => {\n  const [loading, setLoading] = useState(false)\n\n  const handleTrigger = async () => {\n    setLoading(true)\n    \n    try {\n      const response = await fetch('/api/workflows/trigger-custom', {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify({\n          workflowId,\n          triggerSlug,\n          data: {\n            triggeredAt: new Date().toISOString(),\n            source: 'admin-button'\n          }\n        }),\n      })\n\n      if (!response.ok) {\n        const error = await response.json()\n        throw new Error(error.message || 'Failed to trigger workflow')\n      }\n\n      const result = await response.json()\n      \n      toast.success(`Workflow \"${workflowName}\" triggered successfully! Run ID: ${result.runId}`)\n    } catch (error) {\n      console.error('Error triggering workflow:', error)\n      toast.error(`Failed to trigger workflow: ${error instanceof Error ? error.message : 'Unknown error'}`)\n    } finally {\n      setLoading(false)\n    }\n  }\n\n  return (\n    <Button\n      onClick={handleTrigger}\n      disabled={loading}\n      size=\"small\"\n      buttonStyle=\"secondary\"\n    >\n      {loading ? 'Triggering...' : 'Trigger Workflow'}\n    </Button>\n  )\n}"],"names":["Button","toast","useState","TriggerWorkflowButton","workflowId","workflowName","triggerSlug","loading","setLoading","handleTrigger","response","fetch","method","headers","body","JSON","stringify","data","triggeredAt","Date","toISOString","source","ok","error","json","Error","message","result","success","runId","console","onClick","disabled","size","buttonStyle"],"mappings":"AAAA;;AAEA,SAASA,MAAM,EAAEC,KAAK,QAAQ,iBAAgB;AAC9C,SAASC,QAAQ,QAAQ,QAAO;AAQhC,OAAO,MAAMC,wBAA8D,CAAC,EAC1EC,UAAU,EACVC,YAAY,EACZC,cAAc,gBAAgB,EAC/B;IACC,MAAM,CAACC,SAASC,WAAW,GAAGN,SAAS;IAEvC,MAAMO,gBAAgB;QACpBD,WAAW;QAEX,IAAI;YACF,MAAME,WAAW,MAAMC,MAAM,iCAAiC;gBAC5DC,QAAQ;gBACRC,SAAS;oBACP,gBAAgB;gBAClB;gBACAC,MAAMC,KAAKC,SAAS,CAAC;oBACnBZ;oBACAE;oBACAW,MAAM;wBACJC,aAAa,IAAIC,OAAOC,WAAW;wBACnCC,QAAQ;oBACV;gBACF;YACF;YAEA,IAAI,CAACX,SAASY,EAAE,EAAE;gBAChB,MAAMC,QAAQ,MAAMb,SAASc,IAAI;gBACjC,MAAM,IAAIC,MAAMF,MAAMG,OAAO,IAAI;YACnC;YAEA,MAAMC,SAAS,MAAMjB,SAASc,IAAI;YAElCvB,MAAM2B,OAAO,CAAC,CAAC,UAAU,EAAEvB,aAAa,kCAAkC,EAAEsB,OAAOE,KAAK,EAAE;QAC5F,EAAE,OAAON,OAAO;YACdO,QAAQP,KAAK,CAAC,8BAA8BA;YAC5CtB,MAAMsB,KAAK,CAAC,CAAC,4BAA4B,EAAEA,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG,iBAAiB;QACvG,SAAU;YACRlB,WAAW;QACb;IACF;IAEA,qBACE,KAACR;QACC+B,SAAStB;QACTuB,UAAUzB;QACV0B,MAAK;QACLC,aAAY;kBAEX3B,UAAU,kBAAkB;;AAGnC,EAAC"}

package/dist/core/trigger-custom-workflow.d.ts

@@ -0,0 +1,52 @@
+import type { Payload, PayloadRequest } from 'payload';
+export interface CustomTriggerOptions {
+    /**
+     * Data to pass to the workflow execution context
+     */
+    data?: Record<string, unknown>;
+    /**
+     * Optional PayloadRequest to use for the workflow execution
+     * If not provided, a minimal request will be created
+     */
+    req?: PayloadRequest;
+    /**
+     * The slug of the custom trigger to execute
+     */
+    slug: string;
+    /**
+     * Optional user information for tracking who triggered the workflow
+     */
+    user?: {
+        email?: string;
+        id?: string;
+    };
+}
+export interface TriggerResult {
+    error?: string;
+    runId: number | string;
+    status: 'failed' | 'triggered';
+    workflowId: string;
+    workflowName: string;
+}
+/**
+ * Programmatically trigger workflows that have a matching custom trigger
+ *
+ * @example
+ * ```typescript
+ * // In your onInit or elsewhere in your code
+ * await triggerCustomWorkflow(payload, {
+ *   slug: 'data-import',
+ *   data: {
+ *     source: 'external-api',
+ *     recordCount: 100,
+ *     importedAt: new Date().toISOString()
+ *   }
+ * })
+ * ```
+ */
+export declare function triggerCustomWorkflow(payload: Payload, options: CustomTriggerOptions): Promise<TriggerResult[]>;
+/**
+ * Helper function to trigger a single workflow by ID with custom trigger data
+ * This is useful when you know exactly which workflow you want to trigger
+ */
+export declare function triggerWorkflowById(payload: Payload, workflowId: string, triggerSlug: string, data?: Record<string, unknown>, req?: PayloadRequest): Promise<TriggerResult>;