@xtr-dev/payload-automation 0.0.39 → 0.0.42

package/README.md

@@ -1,18 +1,19 @@
 # @xtr-dev/payload-automation
 
-A comprehensive workflow automation plugin for PayloadCMS 3.x that enables visual workflow building, execution tracking, and parallel processing.
+[![npm version](https://badge.fury.io/js/@xtr-dev%2Fpayload-automation.svg)](https://www.npmjs.com/package/@xtr-dev/payload-automation)
+
+A workflow automation plugin for PayloadCMS 3.x. Run steps in workflows triggered by document changes or webhooks.
 
 ⚠️ **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
-- ⏰ **Scheduled Workflows** - Use webhook triggers with external cron services
-- 📊 **Execution Tracking** - Complete history and monitoring of workflow runs
-- 🔧 **Extensible Steps** - HTTP requests, document CRUD, email notifications
-- 🔍 **JSONPath Integration** - Dynamic data interpolation and transformation
+- 🔄 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
 
 ## Installation
 
@@ -47,94 +48,76 @@ export default buildConfig({
 })
 ```
 
-## Import Structure
-
-The plugin uses separate exports to avoid bundling server-side code in client bundles:
+## Imports
 
 ```typescript
-// Server-side plugin and functions
+// Server plugin
 import { workflowsPlugin } from '@xtr-dev/payload-automation/server'
 
-// Client-side components  
+// Client components
 import { StatusCell, ErrorDisplay } from '@xtr-dev/payload-automation/client'
 
-// Helper utilities
-import { /* helpers */ } from '@xtr-dev/payload-automation/helpers'
-
-// Types only (safe for both server and client)
-import type { WorkflowsPluginConfig } from '@xtr-dev/payload-automation'
+// Types
+import type { WorkflowsPluginConfig, SeedWorkflow } from '@xtr-dev/payload-automation'
 ```
 
-## Step Types
-
-### HTTP Request
-Make external API calls with comprehensive error handling and retry logic.
-
-**Key Features:**
-- Support for GET, POST, PUT, DELETE, PATCH methods
-- Authentication: Bearer token, Basic auth, API key headers
-- Configurable timeouts and retry logic
-- JSONPath integration for dynamic URLs and request bodies
-
-**Error Handling:**
-HTTP Request steps use a **response-based success model** rather than status-code-based failures:
+## Seeding Template Workflows
 
-- ✅ **Successful completion**: All HTTP requests that receive a response (including 4xx/5xx status codes) are marked as "succeeded"
-- ❌ **Failed execution**: Only network errors, timeouts, DNS failures, and connection issues cause step failure
-- 📊 **Error information preserved**: HTTP error status codes (404, 500, etc.) are captured in the step output for workflow conditional logic
+Provide read-only example workflows for users to learn from and reference:
 
-**Example workflow logic:**
 ```typescript
-// Step outputs for a 404 response:
-{
-  "status": 404,
-  "statusText": "Not Found", 
-  "body": "Resource not found",
-  "headers": {...},
-  "duration": 1200
-}
+import type { SeedWorkflow } from '@xtr-dev/payload-automation'
+
+const exampleWorkflows: SeedWorkflow[] = [
+  {
+    slug: 'example-welcome-email',
+    name: 'Example: Send Welcome Email',
+    description: 'Send email when user is created',
+    triggers: [
+      {
+        type: 'collection',
+        parameters: {
+          collection: 'users',
+          hook: 'afterCreate',
+        },
+      },
+    ],
+    steps: [
+      {
+        name: 'Send Email',
+        type: 'send-email',
+        input: {
+          to: '$.trigger.doc.email',
+          subject: 'Welcome!',
+          text: 'Thanks for joining us!',
+        },
+      },
+    ],
+  },
+]
 
-// Use in workflow conditions:
-// "$.steps.apiRequest.output.status >= 400" to handle errors
+workflowsPlugin({
+  seedWorkflows: exampleWorkflows,
+  // ... other config
+})
 ```
 
-This design allows workflows to handle HTTP errors gracefully rather than failing completely, enabling robust error handling and retry logic.
+Seeded workflows:
+- Are automatically created on first startup
+- Use slug as unique identifier (stable across renames)
+- Automatically update when definition changes in code
+- Cannot be edited or deleted via UI or API
+- Show a warning banner in the admin panel
+- Can be duplicated to create editable versions
 
-**Enhanced Error Tracking:**
-For network failures (timeouts, DNS errors, connection failures), the plugin provides detailed error information through an independent storage system that bypasses PayloadCMS's output limitations:
+See [docs/SEEDING_WORKFLOWS.md](./docs/SEEDING_WORKFLOWS.md) for detailed documentation.
 
-```typescript
-// Timeout error details preserved in workflow context:
-{
-  "steps": {
-    "httpStep": {
-      "state": "failed",
-      "error": "Task handler returned a failed state",
-      "errorDetails": {
-        "errorType": "timeout",
-        "duration": 2006,
-        "attempts": 1,
-        "finalError": "Request timeout after 2000ms",
-        "context": {
-          "url": "https://api.example.com/data",
-          "method": "GET",
-          "timeout": 2000
-        }
-      },
-      "executionInfo": {
-        "completed": true,
-        "success": false,
-        "executedAt": "2025-09-04T15:16:10.000Z",
-        "duration": 2006
-      }
-    }
-  }
-}
+## Step Types
 
-// Access in workflow conditions:
-// "$.steps.httpStep.errorDetails.errorType == 'timeout'"
-// "$.steps.httpStep.errorDetails.duration > 5000"
-```
+### HTTP Request
+Call external APIs. Supports GET, POST, PUT, DELETE, PATCH. Uses Bearer tokens, API keys, or basic auth.
+
+HTTP steps succeed even with 4xx/5xx status codes. Only network errors (timeouts, DNS failures) cause step failure. Check `{{steps.stepName.output.status}}` for error handling.
 
 ### Document Operations
 - **Create Document** - Create PayloadCMS documents
@@ -145,13 +128,20 @@ For network failures (timeouts, DNS errors, connection failures), the plugin pro
 ### Communication
 - **Send Email** - Send notifications via PayloadCMS email
 
-## Data Resolution
+## Templates
 
-Use JSONPath to access workflow data:
+Use `{{}}` to insert data:
 
-- `$.trigger.doc.id` - Access trigger document
-- `$.steps.stepName.output` - Use previous step outputs
-- `$.context` - Access workflow context
+- `{{trigger.doc.id}}` - Data from the document that triggered the workflow  
+- `{{steps.stepName.output}}` - Data from previous steps
+
+Example:
+```json
+{
+  "url": "https://api.example.com/posts/{{steps.createPost.output.id}}",
+  "condition": "{{trigger.doc.status}} == 'published'"
+}
+```
 
 ## Requirements
 
@@ -159,72 +149,26 @@ Use JSONPath to access workflow data:
 - Node.js ^18.20.2 || >=20.9.0
 - pnpm ^9 || ^10
 
-## Environment Variables
-
-Control plugin logging with these environment variables:
-
-### `PAYLOAD_AUTOMATION_LOG_LEVEL`
-Controls both configuration-time and runtime logging. 
-- **Values**: `silent`, `error`, `warn`, `info`, `debug`, `trace`
-- **Default**: `warn`
-- **Example**: `PAYLOAD_AUTOMATION_LOG_LEVEL=debug`
+## Logging
 
-### `PAYLOAD_AUTOMATION_CONFIG_LOG_LEVEL` (optional)
-Override log level specifically for configuration-time logs (plugin setup).
-- **Values**: Same as above
-- **Default**: Falls back to `PAYLOAD_AUTOMATION_LOG_LEVEL` or `warn`
-- **Example**: `PAYLOAD_AUTOMATION_CONFIG_LOG_LEVEL=silent`
+Set `PAYLOAD_AUTOMATION_LOG_LEVEL` to control logs:
+- `silent`, `error`, `warn` (default), `info`, `debug`, `trace`
 
-### Production Usage
-For production, keep the default (`warn`) or use `error` or `silent`:
-```bash
-PAYLOAD_AUTOMATION_LOG_LEVEL=error npm start
-```
-
-### Development Usage
-For debugging, use `debug` or `info`:
 ```bash
 PAYLOAD_AUTOMATION_LOG_LEVEL=debug npm run dev
 ```
 
 ## Scheduled Workflows
 
-For scheduled workflows, use **webhook triggers** with external cron services instead of built-in cron triggers:
-
-### GitHub Actions (Free)
-```yaml
-# .github/workflows/daily-report.yml
-on:
-  schedule:
-    - cron: '0 9 * * *'  # Daily at 9 AM UTC
-jobs:
-  trigger-workflow:
-    runs-on: ubuntu-latest
-    steps:
-      - run: curl -X POST https://your-app.com/api/workflows-webhook/daily-report
-```
+Use webhook triggers with external cron services:
 
-### Vercel Cron (Serverless)
-```js
-// api/cron/daily.js
-export default async function handler(req, res) {
-  await fetch('https://your-app.com/api/workflows-webhook/daily-report', {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ source: 'vercel-cron' })
-  });
-  res.status(200).json({ success: true });
-}
+```bash
+# Call workflow webhook from cron
+curl -X POST https://your-app.com/api/workflows-webhook/daily-report
 ```
 
-**Benefits**: Better reliability, proper process isolation, easier debugging, and leverages existing infrastructure.
-
-**Note**: Built-in cron triggers have been removed in v0.0.37+ to focus on webhook-based scheduling which provides better reliability and debugging capabilities.
-
-## Documentation
-
-Full documentation coming soon. For now, explore the development environment in the repository for examples and patterns.
+Built-in cron triggers were removed in v0.0.37+.
 
 ## License
 
-MIT
+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

@@ -7,13 +7,27 @@ export const createWorkflowCollection = (options)=>{
         slug: 'workflows',
         access: {
             create: ()=>true,
-            delete: ()=>true,
+            delete: ({ req, data })=>{
+                // Prevent deletion of read-only workflows
+                if (data?.readOnly === true) {
+                    return false;
+                }
+                return true;
+            },
             read: ()=>true,
-            update: ()=>true
+            update: ({ req, data })=>{
+                // Prevent updates to read-only workflows
+                if (data?.readOnly === true) {
+                    return false;
+                }
+                return true;
+            }
         },
         admin: {
             defaultColumns: [
                 'name',
+                'slug',
+                'readOnly',
                 'updatedAt'
             ],
             description: 'Create and manage automated workflows.',
@@ -29,6 +43,36 @@ export const createWorkflowCollection = (options)=>{
                 },
                 required: true
             },
+            {
+                name: 'slug',
+                type: 'text',
+                admin: {
+                    description: 'URL-safe unique identifier for this workflow',
+                    position: 'sidebar'
+                },
+                index: true,
+                unique: true
+            },
+            {
+                name: 'readOnly',
+                type: 'checkbox',
+                admin: {
+                    description: 'Read-only workflows cannot be edited or deleted. This is typically used for seeded template workflows.',
+                    position: 'sidebar',
+                    readOnly: true
+                },
+                defaultValue: false
+            },
+            {
+                name: 'readOnlyBanner',
+                type: 'ui',
+                admin: {
+                    components: {
+                        Field: '@xtr-dev/payload-automation/client#ReadOnlyBanner'
+                    },
+                    condition: (data)=>data?.readOnly === true
+                }
+            },
             {
                 name: 'description',
                 type: 'textarea',

package/dist/collections/Workflow.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/collections/Workflow.ts"],"sourcesContent":["import type {CollectionConfig} from 'payload'\n\nimport type {WorkflowsPluginConfig} from \"../plugin/config-types.js\"\n\nimport {parameter} from \"../fields/parameter.js\"\nimport {collectionTrigger, globalTrigger} from \"../triggers/index.js\"\n\nexport const createWorkflowCollection: <T extends string>(options: WorkflowsPluginConfig<T>) => CollectionConfig = (options) => {\n  const steps = options.steps || []\n  const triggers = (options.triggers || []).map(t => t(options)).concat(collectionTrigger(options), globalTrigger(options))\n  return {\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              ...triggers.map(t => t.slug)\n            ]\n          },\n          {\n            name: 'parameters',\n            type: 'json',\n            admin: {\n              hidden: true,\n            },\n            defaultValue: {}\n          },\n          // Virtual fields for custom triggers\n          ...triggers.flatMap(t => (t.parameters || []).map(p => parameter(t.slug, p as any))),\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., \"$.trigger.doc.status == \\'published\\'\")'\n            },\n            required: false\n          },\n        ]\n      },\n      {\n        name: 'steps',\n        type: 'array',\n        fields: [\n          {\n            name: 'name',\n            type: 'text',\n            defaultValue: 'Unnamed Step'\n          },\n          {\n            name: 'type',\n            type: 'select',\n            options: steps.map(t => t.slug)\n          },\n          {\n            name: 'input',\n            type: 'json',\n            admin: {\n              description: 'Step input configuration. Use JSONPath expressions to reference dynamic data (e.g., {\"url\": \"$.trigger.doc.webhookUrl\", \"data\": \"$.steps.previousStep.output.result\"})'\n            },\n            defaultValue: {}\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}\n"],"names":["parameter","collectionTrigger","globalTrigger","createWorkflowCollection","options","steps","triggers","map","t","concat","slug","access","create","delete","read","update","admin","defaultColumns","description","group","useAsTitle","fields","name","type","required","hidden","defaultValue","flatMap","parameters","p","hasMany","versions","drafts","autosave","maxPerDoc"],"mappings":"AAIA,SAAQA,SAAS,QAAO,yBAAwB;AAChD,SAAQC,iBAAiB,EAAEC,aAAa,QAAO,uBAAsB;AAErE,OAAO,MAAMC,2BAAsG,CAACC;IAClH,MAAMC,QAAQD,QAAQC,KAAK,IAAI,EAAE;IACjC,MAAMC,WAAW,AAACF,CAAAA,QAAQE,QAAQ,IAAI,EAAE,AAAD,EAAGC,GAAG,CAACC,CAAAA,IAAKA,EAAEJ,UAAUK,MAAM,CAACR,kBAAkBG,UAAUF,cAAcE;IAChH,OAAO;QACLM,MAAM;QACNC,QAAQ;YACNC,QAAQ,IAAM;YACdC,QAAQ,IAAM;YACdC,MAAM,IAAM;YACZC,QAAQ,IAAM;QAChB;QACAC,OAAO;YACLC,gBAAgB;gBAAC;gBAAQ;aAAY;YACrCC,aAAa;YACbC,OAAO;YACPC,YAAY;QACd;QACAC,QAAQ;YACN;gBACEC,MAAM;gBACNC,MAAM;gBACNP,OAAO;oBACLE,aAAa;gBACf;gBACAM,UAAU;YACZ;YACA;gBACEF,MAAM;gBACNC,MAAM;gBACNP,OAAO;oBACLE,aAAa;gBACf;YACF;YACA;gBACEI,MAAM;gBACNC,MAAM;gBACNF,QAAQ;oBACN;wBACEC,MAAM;wBACNC,MAAM;wBACNnB,SAAS;+BACJE,SAASC,GAAG,CAACC,CAAAA,IAAKA,EAAEE,IAAI;yBAC5B;oBACH;oBACA;wBACEY,MAAM;wBACNC,MAAM;wBACNP,OAAO;4BACLS,QAAQ;wBACV;wBACAC,cAAc,CAAC;oBACjB;oBACA,qCAAqC;uBAClCpB,SAASqB,OAAO,CAACnB,CAAAA,IAAK,AAACA,CAAAA,EAAEoB,UAAU,IAAI,EAAE,AAAD,EAAGrB,GAAG,CAACsB,CAAAA,IAAK7B,UAAUQ,EAAEE,IAAI,EAAEmB;oBACzE;wBACEP,MAAM;wBACNC,MAAM;wBACNP,OAAO;4BACLE,aAAa;wBACf;wBACAM,UAAU;oBACZ;iBACD;YACH;YACA;gBACEF,MAAM;gBACNC,MAAM;gBACNF,QAAQ;oBACN;wBACEC,MAAM;wBACNC,MAAM;wBACNG,cAAc;oBAChB;oBACA;wBACEJ,MAAM;wBACNC,MAAM;wBACNnB,SAASC,MAAME,GAAG,CAACC,CAAAA,IAAKA,EAAEE,IAAI;oBAChC;oBACA;wBACEY,MAAM;wBACNC,MAAM;wBACNP,OAAO;4BACLE,aAAa;wBACf;wBACAQ,cAAc,CAAC;oBACjB;oBACA;wBACEJ,MAAM;wBACNC,MAAM;wBACNP,OAAO;4BACLE,aAAa;wBACf;wBACAY,SAAS;wBACTN,UAAU;oBACZ;oBACA;wBACEF,MAAM;wBACNC,MAAM;wBACNP,OAAO;4BACLE,aAAa;wBACf;wBACAM,UAAU;oBACZ;iBACD;YACH;SACD;QACDO,UAAU;YACRC,QAAQ;gBACNC,UAAU;YACZ;YACAC,WAAW;QACb;IACF;AACF,EAAC"}
+{"version":3,"sources":["../../src/collections/Workflow.ts"],"sourcesContent":["import type {CollectionConfig} from 'payload'\n\nimport type {WorkflowsPluginConfig} from \"../plugin/config-types.js\"\n\nimport {parameter} from \"../fields/parameter.js\"\nimport {collectionTrigger, globalTrigger} from \"../triggers/index.js\"\n\nexport const createWorkflowCollection: <T extends string>(options: WorkflowsPluginConfig<T>) => CollectionConfig = (options) => {\n  const steps = options.steps || []\n  const triggers = (options.triggers || []).map(t => t(options)).concat(collectionTrigger(options), globalTrigger(options))\n  return {\n    slug: 'workflows',\n    access: {\n      create: () => true,\n      delete: ({ req, data }) => {\n        // Prevent deletion of read-only workflows\n        if (data?.readOnly === true) {\n          return false\n        }\n        return true\n      },\n      read: () => true,\n      update: ({ req, data }) => {\n        // Prevent updates to read-only workflows\n        if (data?.readOnly === true) {\n          return false\n        }\n        return true\n      },\n    },\n    admin: {\n      defaultColumns: ['name', 'slug', 'readOnly', '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: 'slug',\n        type: 'text',\n        admin: {\n          description: 'URL-safe unique identifier for this workflow',\n          position: 'sidebar',\n        },\n        index: true,\n        unique: true,\n      },\n      {\n        name: 'readOnly',\n        type: 'checkbox',\n        admin: {\n          description: 'Read-only workflows cannot be edited or deleted. This is typically used for seeded template workflows.',\n          position: 'sidebar',\n          readOnly: true,\n        },\n        defaultValue: false,\n      },\n      {\n        name: 'readOnlyBanner',\n        type: 'ui',\n        admin: {\n          components: {\n            Field: '@xtr-dev/payload-automation/client#ReadOnlyBanner',\n          },\n          condition: (data) => data?.readOnly === true,\n        },\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              ...triggers.map(t => t.slug)\n            ]\n          },\n          {\n            name: 'parameters',\n            type: 'json',\n            admin: {\n              hidden: true,\n            },\n            defaultValue: {}\n          },\n          // Virtual fields for custom triggers\n          ...triggers.flatMap(t => (t.parameters || []).map(p => parameter(t.slug, p as any))),\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., \"$.trigger.doc.status == \\'published\\'\")'\n            },\n            required: false\n          },\n        ]\n      },\n      {\n        name: 'steps',\n        type: 'array',\n        fields: [\n          {\n            name: 'name',\n            type: 'text',\n            defaultValue: 'Unnamed Step'\n          },\n          {\n            name: 'type',\n            type: 'select',\n            options: steps.map(t => t.slug)\n          },\n          {\n            name: 'input',\n            type: 'json',\n            admin: {\n              description: 'Step input configuration. Use JSONPath expressions to reference dynamic data (e.g., {\"url\": \"$.trigger.doc.webhookUrl\", \"data\": \"$.steps.previousStep.output.result\"})'\n            },\n            defaultValue: {}\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}\n"],"names":["parameter","collectionTrigger","globalTrigger","createWorkflowCollection","options","steps","triggers","map","t","concat","slug","access","create","delete","req","data","readOnly","read","update","admin","defaultColumns","description","group","useAsTitle","fields","name","type","required","position","index","unique","defaultValue","components","Field","condition","hidden","flatMap","parameters","p","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/components/ErrorDisplay.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+interface ErrorDisplayProps {
+    value?: string;
+    onChange?: (value: string) => void;
+    readOnly?: boolean;
+    path?: string;
+}
+export declare const ErrorDisplay: React.FC<ErrorDisplayProps>;
+export {};

package/dist/components/ReadOnlyBanner.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const ReadOnlyBanner: React.FC;

package/dist/components/ReadOnlyBanner.js

@@ -0,0 +1,67 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+export const ReadOnlyBanner = ()=>{
+    return /*#__PURE__*/ _jsxs("div", {
+        style: {
+            backgroundColor: '#fef3c7',
+            border: '1px solid #f59e0b',
+            borderRadius: '4px',
+            padding: '12px 16px',
+            marginBottom: '16px',
+            display: 'flex',
+            alignItems: 'center',
+            gap: '8px'
+        },
+        children: [
+            /*#__PURE__*/ _jsxs("svg", {
+                xmlns: "http://www.w3.org/2000/svg",
+                width: "20",
+                height: "20",
+                viewBox: "0 0 24 24",
+                fill: "none",
+                stroke: "#f59e0b",
+                strokeWidth: "2",
+                strokeLinecap: "round",
+                strokeLinejoin: "round",
+                children: [
+                    /*#__PURE__*/ _jsx("path", {
+                        d: "M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"
+                    }),
+                    /*#__PURE__*/ _jsx("line", {
+                        x1: "12",
+                        y1: "9",
+                        x2: "12",
+                        y2: "13"
+                    }),
+                    /*#__PURE__*/ _jsx("line", {
+                        x1: "12",
+                        y1: "17",
+                        x2: "12.01",
+                        y2: "17"
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsxs("div", {
+                children: [
+                    /*#__PURE__*/ _jsx("strong", {
+                        style: {
+                            color: '#92400e'
+                        },
+                        children: "Read-Only Workflow"
+                    }),
+                    /*#__PURE__*/ _jsx("p", {
+                        style: {
+                            margin: '4px 0 0 0',
+                            color: '#78350f',
+                            fontSize: '14px'
+                        },
+                        children: "This is a template workflow that cannot be edited or deleted. You can view it for reference or duplicate it to create your own version."
+                    })
+                ]
+            })
+        ]
+    });
+};
+
+//# sourceMappingURL=ReadOnlyBanner.js.map

package/dist/components/ReadOnlyBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/ReadOnlyBanner.tsx"],"sourcesContent":["'use client'\n\nimport React from 'react'\n\nexport const ReadOnlyBanner: React.FC = () => {\n  return (\n    <div\n      style={{\n        backgroundColor: '#fef3c7',\n        border: '1px solid #f59e0b',\n        borderRadius: '4px',\n        padding: '12px 16px',\n        marginBottom: '16px',\n        display: 'flex',\n        alignItems: 'center',\n        gap: '8px',\n      }}\n    >\n      <svg\n        xmlns=\"http://www.w3.org/2000/svg\"\n        width=\"20\"\n        height=\"20\"\n        viewBox=\"0 0 24 24\"\n        fill=\"none\"\n        stroke=\"#f59e0b\"\n        strokeWidth=\"2\"\n        strokeLinecap=\"round\"\n        strokeLinejoin=\"round\"\n      >\n        <path d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\" />\n        <line x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\" />\n        <line x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\" />\n      </svg>\n      <div>\n        <strong style={{ color: '#92400e' }}>Read-Only Workflow</strong>\n        <p style={{ margin: '4px 0 0 0', color: '#78350f', fontSize: '14px' }}>\n          This is a template workflow that cannot be edited or deleted. You can view it for reference or duplicate it to create your own version.\n        </p>\n      </div>\n    </div>\n  )\n}\n"],"names":["React","ReadOnlyBanner","div","style","backgroundColor","border","borderRadius","padding","marginBottom","display","alignItems","gap","svg","xmlns","width","height","viewBox","fill","stroke","strokeWidth","strokeLinecap","strokeLinejoin","path","d","line","x1","y1","x2","y2","strong","color","p","margin","fontSize"],"mappings":"AAAA;;AAEA,OAAOA,WAAW,QAAO;AAEzB,OAAO,MAAMC,iBAA2B;IACtC,qBACE,MAACC;QACCC,OAAO;YACLC,iBAAiB;YACjBC,QAAQ;YACRC,cAAc;YACdC,SAAS;YACTC,cAAc;YACdC,SAAS;YACTC,YAAY;YACZC,KAAK;QACP;;0BAEA,MAACC;gBACCC,OAAM;gBACNC,OAAM;gBACNC,QAAO;gBACPC,SAAQ;gBACRC,MAAK;gBACLC,QAAO;gBACPC,aAAY;gBACZC,eAAc;gBACdC,gBAAe;;kCAEf,KAACC;wBAAKC,GAAE;;kCACR,KAACC;wBAAKC,IAAG;wBAAKC,IAAG;wBAAIC,IAAG;wBAAKC,IAAG;;kCAChC,KAACJ;wBAAKC,IAAG;wBAAKC,IAAG;wBAAKC,IAAG;wBAAQC,IAAG;;;;0BAEtC,MAAC1B;;kCACC,KAAC2B;wBAAO1B,OAAO;4BAAE2B,OAAO;wBAAU;kCAAG;;kCACrC,KAACC;wBAAE5B,OAAO;4BAAE6B,QAAQ;4BAAaF,OAAO;4BAAWG,UAAU;wBAAO;kCAAG;;;;;;AAM/E,EAAC"}

package/dist/components/StatusCell.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+interface StatusCellProps {
+    cellData: string;
+}
+export declare const StatusCell: React.FC<StatusCellProps>;
+export {};

package/dist/components/WorkflowBuilder/StepConfigurationForm.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+import type { Node } from '@xyflow/react';
+interface StepField {
+    name: string;
+    type: string;
+    label?: string;
+    admin?: {
+        description?: string;
+        condition?: (data: any, siblingData: any) => boolean;
+    };
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    defaultValue?: any;
+    required?: boolean;
+    hasMany?: boolean;
+    fields?: StepField[];
+}
+interface StepType {
+    slug: string;
+    label?: string;
+    inputSchema?: StepField[];
+    outputSchema?: StepField[];
+}
+interface StepConfigurationFormProps {
+    selectedNode: Node | null;
+    availableStepTypes: StepType[];
+    availableSteps: string[];
+    onNodeUpdate: (nodeId: string, data: Partial<Node['data']>) => void;
+    onClose: () => void;
+}
+export declare const StepConfigurationForm: React.FC<StepConfigurationFormProps>;
+export {};

package/dist/components/WorkflowBuilder/WorkflowBuilder.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+import '@xyflow/react/dist/style.css';
+interface WorkflowData {
+    id: string;
+    name: string;
+    steps?: Array<{
+        name: string;
+        type: string;
+        position?: {
+            x: number;
+            y: number;
+        };
+        visual?: {
+            color?: string;
+            icon?: string;
+        };
+        dependencies?: string[];
+    }>;
+    layout?: {
+        viewport?: {
+            x: number;
+            y: number;
+            zoom: number;
+        };
+    };
+}
+interface StepType {
+    slug: string;
+    label?: string;
+    inputSchema?: any[];
+    outputSchema?: any[];
+}
+interface WorkflowBuilderProps {
+    workflow?: WorkflowData;
+    availableStepTypes?: StepType[];
+    onSave?: (workflow: WorkflowData) => void;
+    readonly?: boolean;
+}
+export declare const WorkflowBuilder: React.FC<WorkflowBuilderProps>;
+export {};

package/dist/components/WorkflowBuilder/WorkflowToolbar.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+interface AvailableStepType {
+    slug: string;
+    label?: string;
+    inputSchema?: any[];
+    outputSchema?: any[];
+}
+interface WorkflowToolbarProps {
+    availableStepTypes: AvailableStepType[];
+    onAddStep: (stepType: string) => void;
+    onSave: () => void;
+}
+export declare const WorkflowToolbar: React.FC<WorkflowToolbarProps>;
+export {};

package/dist/components/WorkflowBuilder/index.d.ts

@@ -0,0 +1,4 @@
+export { WorkflowBuilder } from './WorkflowBuilder.js';
+export { WorkflowToolbar } from './WorkflowToolbar.js';
+export { StepConfigurationForm } from './StepConfigurationForm.js';
+export { StepNode } from './nodes/StepNode.js';

package/dist/components/WorkflowBuilder/nodes/StepNode.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { NodeProps } from '@xyflow/react';
+export declare const StepNode: React.FC<NodeProps>;

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>;