@xtr-dev/payload-automation 0.0.42 → 0.0.45

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

@@ -0,0 +1 @@
+{"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"}

package/dist/steps/index.d.ts

@@ -1,3 +1,5 @@
+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,3 +1,6 @@
+// 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';
 export { DeleteDocumentStepTask } from './delete-document.js';

package/dist/steps/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/steps/index.ts"],"sourcesContent":["export { 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,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"}
+{"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"}

package/dist/steps/read-document-handler.js

@@ -44,7 +44,7 @@ export const readDocumentHandler = async ({ input, req })=>{
         };
     } catch (error) {
         return {
-            errorName: error instanceof Error ? error.message : 'Failed to read document(s)',
+            errorMessage: error instanceof Error ? error.message : 'Failed to read document(s)',
             state: 'failed'
         };
     }

package/dist/steps/read-document-handler.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/steps/read-document-handler.ts"],"sourcesContent":["import type { TaskHandler } from \"payload\"\n\nexport const readDocumentHandler: TaskHandler<'read-document'> = async ({ input, req }) => {\n  if (!input) {\n    throw new Error('No input provided')\n  }\n\n  const { id, collectionSlug, depth, limit, locale, sort, where } = input\n\n  if (!collectionSlug || typeof collectionSlug !== 'string') {\n    throw new Error('Collection slug is required')\n  }\n\n  try {\n    // If ID is provided, find by ID\n    if (id) {\n      const result = await req.payload.findByID({\n        id: id.toString(),\n        collection: collectionSlug,\n        depth: typeof depth === 'number' ? depth : undefined,\n        locale: locale || undefined,\n        req\n      })\n\n      return {\n        output: {\n          doc: result,\n          totalDocs: 1\n        },\n        state: 'succeeded'\n      }\n    }\n\n    // Otherwise, find multiple documents\n    const parsedWhere = where ? (typeof where === 'string' ? JSON.parse(where) : where) : {}\n\n    const result = await req.payload.find({\n      collection: collectionSlug,\n      depth: typeof depth === 'number' ? depth : undefined,\n      limit: typeof limit === 'number' ? limit : 10,\n      locale: locale || undefined,\n      req,\n      sort: sort || undefined,\n      where: parsedWhere\n    })\n\n    return {\n      output: {\n        doc: result.docs,\n        totalDocs: result.totalDocs\n      },\n      state: 'succeeded'\n    }\n  } catch (error) {\n    return {\n      errorName: error instanceof Error ? error.message : 'Failed to read document(s)',\n      state: 'failed'\n    }\n  }\n}\n"],"names":["readDocumentHandler","input","req","Error","id","collectionSlug","depth","limit","locale","sort","where","result","payload","findByID","toString","collection","undefined","output","doc","totalDocs","state","parsedWhere","JSON","parse","find","docs","error","errorName","message"],"mappings":"AAEA,OAAO,MAAMA,sBAAoD,OAAO,EAAEC,KAAK,EAAEC,GAAG,EAAE;IACpF,IAAI,CAACD,OAAO;QACV,MAAM,IAAIE,MAAM;IAClB;IAEA,MAAM,EAAEC,EAAE,EAAEC,cAAc,EAAEC,KAAK,EAAEC,KAAK,EAAEC,MAAM,EAAEC,IAAI,EAAEC,KAAK,EAAE,GAAGT;IAElE,IAAI,CAACI,kBAAkB,OAAOA,mBAAmB,UAAU;QACzD,MAAM,IAAIF,MAAM;IAClB;IAEA,IAAI;QACF,gCAAgC;QAChC,IAAIC,IAAI;YACN,MAAMO,SAAS,MAAMT,IAAIU,OAAO,CAACC,QAAQ,CAAC;gBACxCT,IAAIA,GAAGU,QAAQ;gBACfC,YAAYV;gBACZC,OAAO,OAAOA,UAAU,WAAWA,QAAQU;gBAC3CR,QAAQA,UAAUQ;gBAClBd;YACF;YAEA,OAAO;gBACLe,QAAQ;oBACNC,KAAKP;oBACLQ,WAAW;gBACb;gBACAC,OAAO;YACT;QACF;QAEA,qCAAqC;QACrC,MAAMC,cAAcX,QAAS,OAAOA,UAAU,WAAWY,KAAKC,KAAK,CAACb,SAASA,QAAS,CAAC;QAEvF,MAAMC,SAAS,MAAMT,IAAIU,OAAO,CAACY,IAAI,CAAC;YACpCT,YAAYV;YACZC,OAAO,OAAOA,UAAU,WAAWA,QAAQU;YAC3CT,OAAO,OAAOA,UAAU,WAAWA,QAAQ;YAC3CC,QAAQA,UAAUQ;YAClBd;YACAO,MAAMA,QAAQO;YACdN,OAAOW;QACT;QAEA,OAAO;YACLJ,QAAQ;gBACNC,KAAKP,OAAOc,IAAI;gBAChBN,WAAWR,OAAOQ,SAAS;YAC7B;YACAC,OAAO;QACT;IACF,EAAE,OAAOM,OAAO;QACd,OAAO;YACLC,WAAWD,iBAAiBvB,QAAQuB,MAAME,OAAO,GAAG;YACpDR,OAAO;QACT;IACF;AACF,EAAC"}
+{"version":3,"sources":["../../src/steps/read-document-handler.ts"],"sourcesContent":["import type { TaskHandler } from \"payload\"\n\nexport const readDocumentHandler: TaskHandler<'read-document'> = async ({ input, req }) => {\n  if (!input) {\n    throw new Error('No input provided')\n  }\n\n  const { id, collectionSlug, depth, limit, locale, sort, where } = input\n\n  if (!collectionSlug || typeof collectionSlug !== 'string') {\n    throw new Error('Collection slug is required')\n  }\n\n  try {\n    // If ID is provided, find by ID\n    if (id) {\n      const result = await req.payload.findByID({\n        id: id.toString(),\n        collection: collectionSlug,\n        depth: typeof depth === 'number' ? depth : undefined,\n        locale: locale || undefined,\n        req\n      })\n\n      return {\n        output: {\n          doc: result,\n          totalDocs: 1\n        },\n        state: 'succeeded'\n      }\n    }\n\n    // Otherwise, find multiple documents\n    const parsedWhere = where ? (typeof where === 'string' ? JSON.parse(where) : where) : {}\n\n    const result = await req.payload.find({\n      collection: collectionSlug,\n      depth: typeof depth === 'number' ? depth : undefined,\n      limit: typeof limit === 'number' ? limit : 10,\n      locale: locale || undefined,\n      req,\n      sort: sort || undefined,\n      where: parsedWhere\n    })\n\n    return {\n      output: {\n        doc: result.docs,\n        totalDocs: result.totalDocs\n      },\n      state: 'succeeded'\n    }\n  } catch (error) {\n    return {\n      errorMessage: error instanceof Error ? error.message : 'Failed to read document(s)',\n      state: 'failed'\n    }\n  }\n}\n"],"names":["readDocumentHandler","input","req","Error","id","collectionSlug","depth","limit","locale","sort","where","result","payload","findByID","toString","collection","undefined","output","doc","totalDocs","state","parsedWhere","JSON","parse","find","docs","error","errorMessage","message"],"mappings":"AAEA,OAAO,MAAMA,sBAAoD,OAAO,EAAEC,KAAK,EAAEC,GAAG,EAAE;IACpF,IAAI,CAACD,OAAO;QACV,MAAM,IAAIE,MAAM;IAClB;IAEA,MAAM,EAAEC,EAAE,EAAEC,cAAc,EAAEC,KAAK,EAAEC,KAAK,EAAEC,MAAM,EAAEC,IAAI,EAAEC,KAAK,EAAE,GAAGT;IAElE,IAAI,CAACI,kBAAkB,OAAOA,mBAAmB,UAAU;QACzD,MAAM,IAAIF,MAAM;IAClB;IAEA,IAAI;QACF,gCAAgC;QAChC,IAAIC,IAAI;YACN,MAAMO,SAAS,MAAMT,IAAIU,OAAO,CAACC,QAAQ,CAAC;gBACxCT,IAAIA,GAAGU,QAAQ;gBACfC,YAAYV;gBACZC,OAAO,OAAOA,UAAU,WAAWA,QAAQU;gBAC3CR,QAAQA,UAAUQ;gBAClBd;YACF;YAEA,OAAO;gBACLe,QAAQ;oBACNC,KAAKP;oBACLQ,WAAW;gBACb;gBACAC,OAAO;YACT;QACF;QAEA,qCAAqC;QACrC,MAAMC,cAAcX,QAAS,OAAOA,UAAU,WAAWY,KAAKC,KAAK,CAACb,SAASA,QAAS,CAAC;QAEvF,MAAMC,SAAS,MAAMT,IAAIU,OAAO,CAACY,IAAI,CAAC;YACpCT,YAAYV;YACZC,OAAO,OAAOA,UAAU,WAAWA,QAAQU;YAC3CT,OAAO,OAAOA,UAAU,WAAWA,QAAQ;YAC3CC,QAAQA,UAAUQ;YAClBd;YACAO,MAAMA,QAAQO;YACdN,OAAOW;QACT;QAEA,OAAO;YACLJ,QAAQ;gBACNC,KAAKP,OAAOc,IAAI;gBAChBN,WAAWR,OAAOQ,SAAS;YAC7B;YACAC,OAAO;QACT;IACF,EAAE,OAAOM,OAAO;QACd,OAAO;YACLC,cAAcD,iBAAiBvB,QAAQuB,MAAME,OAAO,GAAG;YACvDR,OAAO;QACT;IACF;AACF,EAAC"}

package/dist/steps/update-document-handler.js

@@ -31,7 +31,7 @@ export const updateDocumentHandler = async ({ input, req })=>{
         };
     } catch (error) {
         return {
-            errorName: error instanceof Error ? error.message : 'Failed to update document',
+            errorMessage: error instanceof Error ? error.message : 'Failed to update document',
             state: 'failed'
         };
     }

package/dist/steps/update-document-handler.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/steps/update-document-handler.ts"],"sourcesContent":["import type { TaskHandler } from \"payload\"\n\nexport const updateDocumentHandler: TaskHandler<'update-document'> = async ({ input, req }) => {\n  if (!input) {\n    throw new Error('No input provided')\n  }\n\n  const { id, collectionSlug, data, draft, locale } = input\n\n  if (!collectionSlug || typeof collectionSlug !== 'string') {\n    throw new Error('Collection slug is required')\n  }\n\n  if (!id) {\n    throw new Error('Document ID is required')\n  }\n\n  if (!data) {\n    throw new Error('Update data is required')\n  }\n\n  try {\n    const parsedData = typeof data === 'string' ? JSON.parse(data) : data\n\n    const result = await req.payload.update({\n      id: id.toString(),\n      collection: collectionSlug,\n      data: parsedData,\n      draft: draft || false,\n      locale: locale || undefined,\n      req\n    })\n\n    return {\n      output: {\n        id: result.id,\n        doc: result\n      },\n      state: 'succeeded'\n    }\n  } catch (error) {\n    return {\n      errorName: error instanceof Error ? error.message : 'Failed to update document',\n      state: 'failed'\n    }\n  }\n}\n"],"names":["updateDocumentHandler","input","req","Error","id","collectionSlug","data","draft","locale","parsedData","JSON","parse","result","payload","update","toString","collection","undefined","output","doc","state","error","errorName","message"],"mappings":"AAEA,OAAO,MAAMA,wBAAwD,OAAO,EAAEC,KAAK,EAAEC,GAAG,EAAE;IACxF,IAAI,CAACD,OAAO;QACV,MAAM,IAAIE,MAAM;IAClB;IAEA,MAAM,EAAEC,EAAE,EAAEC,cAAc,EAAEC,IAAI,EAAEC,KAAK,EAAEC,MAAM,EAAE,GAAGP;IAEpD,IAAI,CAACI,kBAAkB,OAAOA,mBAAmB,UAAU;QACzD,MAAM,IAAIF,MAAM;IAClB;IAEA,IAAI,CAACC,IAAI;QACP,MAAM,IAAID,MAAM;IAClB;IAEA,IAAI,CAACG,MAAM;QACT,MAAM,IAAIH,MAAM;IAClB;IAEA,IAAI;QACF,MAAMM,aAAa,OAAOH,SAAS,WAAWI,KAAKC,KAAK,CAACL,QAAQA;QAEjE,MAAMM,SAAS,MAAMV,IAAIW,OAAO,CAACC,MAAM,CAAC;YACtCV,IAAIA,GAAGW,QAAQ;YACfC,YAAYX;YACZC,MAAMG;YACNF,OAAOA,SAAS;YAChBC,QAAQA,UAAUS;YAClBf;QACF;QAEA,OAAO;YACLgB,QAAQ;gBACNd,IAAIQ,OAAOR,EAAE;gBACbe,KAAKP;YACP;YACAQ,OAAO;QACT;IACF,EAAE,OAAOC,OAAO;QACd,OAAO;YACLC,WAAWD,iBAAiBlB,QAAQkB,MAAME,OAAO,GAAG;YACpDH,OAAO;QACT;IACF;AACF,EAAC"}
+{"version":3,"sources":["../../src/steps/update-document-handler.ts"],"sourcesContent":["import type { TaskHandler } from \"payload\"\n\nexport const updateDocumentHandler: TaskHandler<'update-document'> = async ({ input, req }) => {\n  if (!input) {\n    throw new Error('No input provided')\n  }\n\n  const { id, collectionSlug, data, draft, locale } = input\n\n  if (!collectionSlug || typeof collectionSlug !== 'string') {\n    throw new Error('Collection slug is required')\n  }\n\n  if (!id) {\n    throw new Error('Document ID is required')\n  }\n\n  if (!data) {\n    throw new Error('Update data is required')\n  }\n\n  try {\n    const parsedData = typeof data === 'string' ? JSON.parse(data) : data\n\n    const result = await req.payload.update({\n      id: id.toString(),\n      collection: collectionSlug,\n      data: parsedData,\n      draft: draft || false,\n      locale: locale || undefined,\n      req\n    })\n\n    return {\n      output: {\n        id: result.id,\n        doc: result\n      },\n      state: 'succeeded'\n    }\n  } catch (error) {\n    return {\n      errorMessage: error instanceof Error ? error.message : 'Failed to update document',\n      state: 'failed'\n    }\n  }\n}\n"],"names":["updateDocumentHandler","input","req","Error","id","collectionSlug","data","draft","locale","parsedData","JSON","parse","result","payload","update","toString","collection","undefined","output","doc","state","error","errorMessage","message"],"mappings":"AAEA,OAAO,MAAMA,wBAAwD,OAAO,EAAEC,KAAK,EAAEC,GAAG,EAAE;IACxF,IAAI,CAACD,OAAO;QACV,MAAM,IAAIE,MAAM;IAClB;IAEA,MAAM,EAAEC,EAAE,EAAEC,cAAc,EAAEC,IAAI,EAAEC,KAAK,EAAEC,MAAM,EAAE,GAAGP;IAEpD,IAAI,CAACI,kBAAkB,OAAOA,mBAAmB,UAAU;QACzD,MAAM,IAAIF,MAAM;IAClB;IAEA,IAAI,CAACC,IAAI;QACP,MAAM,IAAID,MAAM;IAClB;IAEA,IAAI,CAACG,MAAM;QACT,MAAM,IAAIH,MAAM;IAClB;IAEA,IAAI;QACF,MAAMM,aAAa,OAAOH,SAAS,WAAWI,KAAKC,KAAK,CAACL,QAAQA;QAEjE,MAAMM,SAAS,MAAMV,IAAIW,OAAO,CAACC,MAAM,CAAC;YACtCV,IAAIA,GAAGW,QAAQ;YACfC,YAAYX;YACZC,MAAMG;YACNF,OAAOA,SAAS;YAChBC,QAAQA,UAAUS;YAClBf;QACF;QAEA,OAAO;YACLgB,QAAQ;gBACNd,IAAIQ,OAAOR,EAAE;gBACbe,KAAKP;YACP;YACAQ,OAAO;QACT;IACF,EAAE,OAAOC,OAAO;QACd,OAAO;YACLC,cAAcD,iBAAiBlB,QAAQkB,MAAME,OAAO,GAAG;YACvDH,OAAO;QACT;IACF;AACF,EAAC"}

package/dist/triggers/hook-options.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Grouped hook options for better UX in the admin panel.
+ * Organized by category instead of a flat list of 32+ hooks.
+ */
+export interface HookOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+export interface HookOptionGroup {
+    label: string;
+    options: HookOption[];
+}
+/**
+ * Collection hook options grouped by category.
+ */
+export declare const collectionHookGroups: HookOptionGroup[];
+/**
+ * Global hook options grouped by category.
+ */
+export declare const globalHookGroups: HookOptionGroup[];
+/**
+ * Flat list of collection hook options for select fields.
+ */
+export declare const collectionHookOptions: HookOption[];
+/**
+ * Flat list of global hook options for select fields.
+ */
+export declare const globalHookOptions: HookOption[];
+/**
+ * All hook values as a simple string array for validation.
+ */
+export declare const allCollectionHooks: string[];
+export declare const allGlobalHooks: string[];

package/dist/triggers/hook-options.js

@@ -0,0 +1,158 @@
+/**
+ * Grouped hook options for better UX in the admin panel.
+ * Organized by category instead of a flat list of 32+ hooks.
+ */ /**
+ * Collection hook options grouped by category.
+ */ export const collectionHookGroups = [
+    {
+        label: 'Document Lifecycle',
+        options: [
+            {
+                value: 'afterChange',
+                label: 'After Create/Update',
+                description: 'Fires after a document is created or updated'
+            },
+            {
+                value: 'afterDelete',
+                label: 'After Delete',
+                description: 'Fires after a document is deleted'
+            },
+            {
+                value: 'afterRead',
+                label: 'After Read',
+                description: 'Fires after a document is fetched'
+            }
+        ]
+    },
+    {
+        label: 'Before Operations',
+        options: [
+            {
+                value: 'beforeValidate',
+                label: 'Before Validate',
+                description: 'Fires before field validation runs'
+            },
+            {
+                value: 'beforeChange',
+                label: 'Before Save',
+                description: 'Fires after validation, before saving'
+            },
+            {
+                value: 'beforeDelete',
+                label: 'Before Delete',
+                description: 'Fires before a document is deleted'
+            },
+            {
+                value: 'beforeRead',
+                label: 'Before Read',
+                description: 'Fires before a document is fetched'
+            }
+        ]
+    },
+    {
+        label: 'Authentication',
+        options: [
+            {
+                value: 'afterLogin',
+                label: 'After Login',
+                description: 'Fires after user successfully logs in'
+            },
+            {
+                value: 'afterLogout',
+                label: 'After Logout',
+                description: 'Fires after user logs out'
+            },
+            {
+                value: 'beforeLogin',
+                label: 'Before Login',
+                description: 'Fires before login attempt'
+            },
+            {
+                value: 'afterForgotPassword',
+                label: 'After Forgot Password',
+                description: 'Fires after forgot password request'
+            },
+            {
+                value: 'afterRefresh',
+                label: 'After Token Refresh',
+                description: 'Fires after auth token is refreshed'
+            },
+            {
+                value: 'afterMe',
+                label: 'After Me Query',
+                description: 'Fires after /me endpoint is called'
+            }
+        ]
+    },
+    {
+        label: 'Advanced',
+        options: [
+            {
+                value: 'beforeOperation',
+                label: 'Before Operation',
+                description: 'Fires before any CRUD operation'
+            },
+            {
+                value: 'afterOperation',
+                label: 'After Operation',
+                description: 'Fires after any CRUD operation'
+            },
+            {
+                value: 'afterError',
+                label: 'After Error',
+                description: 'Fires when an error occurs'
+            }
+        ]
+    }
+];
+/**
+ * Global hook options grouped by category.
+ */ export const globalHookGroups = [
+    {
+        label: 'Document Lifecycle',
+        options: [
+            {
+                value: 'afterChange',
+                label: 'After Update',
+                description: 'Fires after the global is updated'
+            },
+            {
+                value: 'afterRead',
+                label: 'After Read',
+                description: 'Fires after the global is fetched'
+            }
+        ]
+    },
+    {
+        label: 'Before Operations',
+        options: [
+            {
+                value: 'beforeValidate',
+                label: 'Before Validate',
+                description: 'Fires before field validation runs'
+            },
+            {
+                value: 'beforeChange',
+                label: 'Before Save',
+                description: 'Fires after validation, before saving'
+            },
+            {
+                value: 'beforeRead',
+                label: 'Before Read',
+                description: 'Fires before the global is fetched'
+            }
+        ]
+    }
+];
+/**
+ * Flat list of collection hook options for select fields.
+ */ export const collectionHookOptions = collectionHookGroups.flatMap((group)=>group.options);
+/**
+ * Flat list of global hook options for select fields.
+ */ export const globalHookOptions = globalHookGroups.flatMap((group)=>group.options);
+/**
+ * All hook values as a simple string array for validation.
+ */ export const allCollectionHooks = collectionHookOptions.map((opt)=>opt.value);
+export const allGlobalHooks = globalHookOptions.map((opt)=>opt.value);
+
+//# sourceMappingURL=hook-options.js.map

package/dist/triggers/hook-options.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/triggers/hook-options.ts"],"sourcesContent":["/**\n * Grouped hook options for better UX in the admin panel.\n * Organized by category instead of a flat list of 32+ hooks.\n */\n\nexport interface HookOption {\n  value: string\n  label: string\n  description?: string\n}\n\nexport interface HookOptionGroup {\n  label: string\n  options: HookOption[]\n}\n\n/**\n * Collection hook options grouped by category.\n */\nexport const collectionHookGroups: HookOptionGroup[] = [\n  {\n    label: 'Document Lifecycle',\n    options: [\n      { value: 'afterChange', label: 'After Create/Update', description: 'Fires after a document is created or updated' },\n      { value: 'afterDelete', label: 'After Delete', description: 'Fires after a document is deleted' },\n      { value: 'afterRead', label: 'After Read', description: 'Fires after a document is fetched' },\n    ]\n  },\n  {\n    label: 'Before Operations',\n    options: [\n      { value: 'beforeValidate', label: 'Before Validate', description: 'Fires before field validation runs' },\n      { value: 'beforeChange', label: 'Before Save', description: 'Fires after validation, before saving' },\n      { value: 'beforeDelete', label: 'Before Delete', description: 'Fires before a document is deleted' },\n      { value: 'beforeRead', label: 'Before Read', description: 'Fires before a document is fetched' },\n    ]\n  },\n  {\n    label: 'Authentication',\n    options: [\n      { value: 'afterLogin', label: 'After Login', description: 'Fires after user successfully logs in' },\n      { value: 'afterLogout', label: 'After Logout', description: 'Fires after user logs out' },\n      { value: 'beforeLogin', label: 'Before Login', description: 'Fires before login attempt' },\n      { value: 'afterForgotPassword', label: 'After Forgot Password', description: 'Fires after forgot password request' },\n      { value: 'afterRefresh', label: 'After Token Refresh', description: 'Fires after auth token is refreshed' },\n      { value: 'afterMe', label: 'After Me Query', description: 'Fires after /me endpoint is called' },\n    ]\n  },\n  {\n    label: 'Advanced',\n    options: [\n      { value: 'beforeOperation', label: 'Before Operation', description: 'Fires before any CRUD operation' },\n      { value: 'afterOperation', label: 'After Operation', description: 'Fires after any CRUD operation' },\n      { value: 'afterError', label: 'After Error', description: 'Fires when an error occurs' },\n    ]\n  }\n]\n\n/**\n * Global hook options grouped by category.\n */\nexport const globalHookGroups: HookOptionGroup[] = [\n  {\n    label: 'Document Lifecycle',\n    options: [\n      { value: 'afterChange', label: 'After Update', description: 'Fires after the global is updated' },\n      { value: 'afterRead', label: 'After Read', description: 'Fires after the global is fetched' },\n    ]\n  },\n  {\n    label: 'Before Operations',\n    options: [\n      { value: 'beforeValidate', label: 'Before Validate', description: 'Fires before field validation runs' },\n      { value: 'beforeChange', label: 'Before Save', description: 'Fires after validation, before saving' },\n      { value: 'beforeRead', label: 'Before Read', description: 'Fires before the global is fetched' },\n    ]\n  }\n]\n\n/**\n * Flat list of collection hook options for select fields.\n */\nexport const collectionHookOptions: HookOption[] = collectionHookGroups.flatMap(group => group.options)\n\n/**\n * Flat list of global hook options for select fields.\n */\nexport const globalHookOptions: HookOption[] = globalHookGroups.flatMap(group => group.options)\n\n/**\n * All hook values as a simple string array for validation.\n */\nexport const allCollectionHooks = collectionHookOptions.map(opt => opt.value)\nexport const allGlobalHooks = globalHookOptions.map(opt => opt.value)\n"],"names":["collectionHookGroups","label","options","value","description","globalHookGroups","collectionHookOptions","flatMap","group","globalHookOptions","allCollectionHooks","map","opt","allGlobalHooks"],"mappings":"AAAA;;;CAGC,GAaD;;CAEC,GACD,OAAO,MAAMA,uBAA0C;IACrD;QACEC,OAAO;QACPC,SAAS;YACP;gBAAEC,OAAO;gBAAeF,OAAO;gBAAuBG,aAAa;YAA+C;YAClH;gBAAED,OAAO;gBAAeF,OAAO;gBAAgBG,aAAa;YAAoC;YAChG;gBAAED,OAAO;gBAAaF,OAAO;gBAAcG,aAAa;YAAoC;SAC7F;IACH;IACA;QACEH,OAAO;QACPC,SAAS;YACP;gBAAEC,OAAO;gBAAkBF,OAAO;gBAAmBG,aAAa;YAAqC;YACvG;gBAAED,OAAO;gBAAgBF,OAAO;gBAAeG,aAAa;YAAwC;YACpG;gBAAED,OAAO;gBAAgBF,OAAO;gBAAiBG,aAAa;YAAqC;YACnG;gBAAED,OAAO;gBAAcF,OAAO;gBAAeG,aAAa;YAAqC;SAChG;IACH;IACA;QACEH,OAAO;QACPC,SAAS;YACP;gBAAEC,OAAO;gBAAcF,OAAO;gBAAeG,aAAa;YAAwC;YAClG;gBAAED,OAAO;gBAAeF,OAAO;gBAAgBG,aAAa;YAA4B;YACxF;gBAAED,OAAO;gBAAeF,OAAO;gBAAgBG,aAAa;YAA6B;YACzF;gBAAED,OAAO;gBAAuBF,OAAO;gBAAyBG,aAAa;YAAsC;YACnH;gBAAED,OAAO;gBAAgBF,OAAO;gBAAuBG,aAAa;YAAsC;YAC1G;gBAAED,OAAO;gBAAWF,OAAO;gBAAkBG,aAAa;YAAqC;SAChG;IACH;IACA;QACEH,OAAO;QACPC,SAAS;YACP;gBAAEC,OAAO;gBAAmBF,OAAO;gBAAoBG,aAAa;YAAkC;YACtG;gBAAED,OAAO;gBAAkBF,OAAO;gBAAmBG,aAAa;YAAiC;YACnG;gBAAED,OAAO;gBAAcF,OAAO;gBAAeG,aAAa;YAA6B;SACxF;IACH;CACD,CAAA;AAED;;CAEC,GACD,OAAO,MAAMC,mBAAsC;IACjD;QACEJ,OAAO;QACPC,SAAS;YACP;gBAAEC,OAAO;gBAAeF,OAAO;gBAAgBG,aAAa;YAAoC;YAChG;gBAAED,OAAO;gBAAaF,OAAO;gBAAcG,aAAa;YAAoC;SAC7F;IACH;IACA;QACEH,OAAO;QACPC,SAAS;YACP;gBAAEC,OAAO;gBAAkBF,OAAO;gBAAmBG,aAAa;YAAqC;YACvG;gBAAED,OAAO;gBAAgBF,OAAO;gBAAeG,aAAa;YAAwC;YACpG;gBAAED,OAAO;gBAAcF,OAAO;gBAAeG,aAAa;YAAqC;SAChG;IACH;CACD,CAAA;AAED;;CAEC,GACD,OAAO,MAAME,wBAAsCN,qBAAqBO,OAAO,CAACC,CAAAA,QAASA,MAAMN,OAAO,EAAC;AAEvG;;CAEC,GACD,OAAO,MAAMO,oBAAkCJ,iBAAiBE,OAAO,CAACC,CAAAA,QAASA,MAAMN,OAAO,EAAC;AAE/F;;CAEC,GACD,OAAO,MAAMQ,qBAAqBJ,sBAAsBK,GAAG,CAACC,CAAAA,MAAOA,IAAIT,KAAK,EAAC;AAC7E,OAAO,MAAMU,iBAAiBJ,kBAAkBE,GAAG,CAACC,CAAAA,MAAOA,IAAIT,KAAK,EAAC"}

package/dist/triggers/index.d.ts

@@ -1,2 +1,2 @@
-export { collectionTrigger } from './collection-trigger.js';
-export { globalTrigger } from './global-trigger.js';
+export { collectionHookGroups, collectionHookOptions, globalHookGroups, globalHookOptions, allCollectionHooks, allGlobalHooks } from './hook-options.js';
+export type { HookOption, HookOptionGroup } from './hook-options.js';

package/dist/triggers/index.js

@@ -1,4 +1,3 @@
-export { collectionTrigger } from './collection-trigger.js';
-export { globalTrigger } from './global-trigger.js';
+export { collectionHookGroups, collectionHookOptions, globalHookGroups, globalHookOptions, allCollectionHooks, allGlobalHooks } from './hook-options.js';
 
 //# sourceMappingURL=index.js.map

package/dist/triggers/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/triggers/index.ts"],"sourcesContent":["export { collectionTrigger } from './collection-trigger.js'\nexport { globalTrigger } from './global-trigger.js'\n"],"names":["collectionTrigger","globalTrigger"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,0BAAyB;AAC3D,SAASC,aAAa,QAAQ,sBAAqB"}
+{"version":3,"sources":["../../src/triggers/index.ts"],"sourcesContent":["export {\n  collectionHookGroups,\n  collectionHookOptions,\n  globalHookGroups,\n  globalHookOptions,\n  allCollectionHooks,\n  allGlobalHooks\n} from './hook-options.js'\n\nexport type { HookOption, HookOptionGroup } from './hook-options.js'\n"],"names":["collectionHookGroups","collectionHookOptions","globalHookGroups","globalHookOptions","allCollectionHooks","allGlobalHooks"],"mappings":"AAAA,SACEA,oBAAoB,EACpBC,qBAAqB,EACrBC,gBAAgB,EAChBC,iBAAiB,EACjBC,kBAAkB,EAClBC,cAAc,QACT,oBAAmB"}

package/dist/types/index.d.ts

@@ -22,3 +22,11 @@ export interface ExecutionContext {
     req: any;
 }
 export type { WorkflowsPluginConfig, SeedWorkflow } from '../plugin/config-types.js';
+/**
+ * Logging configuration options for the workflows plugin.
+ * @deprecated Use the full WorkflowsPluginConfig from '@xtr-dev/payload-automation/server' instead.
+ */
+export interface WorkflowLoggingConfig {
+    level?: 'debug' | 'info' | 'warn' | 'error';
+    enabled?: boolean;
+}

package/dist/types/index.js

@@ -1,9 +1,8 @@
 // Pure type definitions for client-safe exports
 // This file contains NO runtime code and can be safely bundled
-// NOTE: Workflow, WorkflowStep, and WorkflowTrigger types are now imported from the generated PayloadCMS types
-// These interfaces have been removed to avoid duplication and inconsistencies
-// Import them from 'payload' or the generated payload-types.ts file instead
-// Re-export plugin config types
-export { };
+/**
+ * Logging configuration options for the workflows plugin.
+ * @deprecated Use the full WorkflowsPluginConfig from '@xtr-dev/payload-automation/server' instead.
+ */ export { };
 
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["// Pure type definitions for client-safe exports\n// This file contains NO runtime code and can be safely bundled\n\nexport interface CustomTriggerOptions {\n  workflowId: string\n  triggerData?: any\n  req?: any // PayloadRequest type, but avoiding import to keep this client-safe\n}\n\nexport interface TriggerResult {\n  success: boolean\n  runId?: string\n  error?: string\n}\n\nexport interface ExecutionContext {\n  trigger: {\n    type: string\n    doc?: any\n    data?: any\n  }\n  steps: Record<string, {\n    output?: any\n    state: 'pending' | 'running' | 'succeeded' | 'failed'\n  }>\n  payload: any // Payload instance\n  req: any // PayloadRequest\n}\n\n// NOTE: Workflow, WorkflowStep, and WorkflowTrigger types are now imported from the generated PayloadCMS types\n// These interfaces have been removed to avoid duplication and inconsistencies\n// Import them from 'payload' or the generated payload-types.ts file instead\n\n// Re-export plugin config types\nexport type { WorkflowsPluginConfig, SeedWorkflow } from '../plugin/config-types.js'"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,+DAA+D;AA4B/D,+GAA+G;AAC/G,8EAA8E;AAC9E,4EAA4E;AAE5E,gCAAgC;AAChC,WAAoF"}
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["// Pure type definitions for client-safe exports\n// This file contains NO runtime code and can be safely bundled\n\nexport interface CustomTriggerOptions {\n  workflowId: string\n  triggerData?: any\n  req?: any // PayloadRequest type, but avoiding import to keep this client-safe\n}\n\nexport interface TriggerResult {\n  success: boolean\n  runId?: string\n  error?: string\n}\n\nexport interface ExecutionContext {\n  trigger: {\n    type: string\n    doc?: any\n    data?: any\n  }\n  steps: Record<string, {\n    output?: any\n    state: 'pending' | 'running' | 'succeeded' | 'failed'\n  }>\n  payload: any // Payload instance\n  req: any // PayloadRequest\n}\n\n// NOTE: Workflow, WorkflowStep, and WorkflowTrigger types are now imported from the generated PayloadCMS types\n// These interfaces have been removed to avoid duplication and inconsistencies\n// Import them from 'payload' or the generated payload-types.ts file instead\n\nexport type { WorkflowsPluginConfig, SeedWorkflow } from '../plugin/config-types.js'\n\n/**\n * Logging configuration options for the workflows plugin.\n * @deprecated Use the full WorkflowsPluginConfig from '@xtr-dev/payload-automation/server' instead.\n */\nexport interface WorkflowLoggingConfig {\n    level?: 'debug' | 'info' | 'warn' | 'error'\n    enabled?: boolean\n}\n"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,+DAA+D;AAkC/D;;;CAGC,GACD,WAGC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Validation utilities for step handlers.
+ * Reduces boilerplate by providing common validation functions.
+ */
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validates that required fields are present and non-null in the input object.
+ * @throws ValidationError if any required field is missing
+ */
+export declare function validateRequired<T extends Record<string, unknown>>(input: T | null | undefined, fields: (keyof T)[]): asserts input is T;
+/**
+ * Validates that a string field is present and is actually a string.
+ * @throws ValidationError if the field is missing or not a string
+ */
+export declare function validateString(value: unknown, fieldName: string): asserts value is string;
+/**
+ * Validates that a URL is valid.
+ * @throws ValidationError if the URL is invalid
+ */
+export declare function validateUrl(url: string): void;
+/**
+ * Validates that the value is a valid email address.
+ * Uses a simple regex for basic validation.
+ * @throws ValidationError if the email is invalid
+ */
+export declare function validateEmail(email: string, fieldName?: string): void;
+/**
+ * Parses a value that might be JSON string or already an object.
+ * @returns The parsed object
+ * @throws ValidationError if parsing fails
+ */
+export declare function parseJsonOrObject<T = unknown>(value: string | T, fieldName: string): T;
+/**
+ * Validates that a number is within a range.
+ * @throws ValidationError if the value is out of range
+ */
+export declare function validateNumberRange(value: number, fieldName: string, min?: number, max?: number): void;
+/**
+ * Creates a standardized failed response for step handlers.
+ */
+export declare function createFailedResponse(error: unknown): {
+    errorMessage: string;
+    state: "failed";
+};
+/**
+ * Creates a standardized success response for step handlers.
+ */
+export declare function createSuccessResponse<T>(output: T): {
+    output: T;
+    state: "succeeded";
+};
+/**
+ * Wraps a step handler function with automatic error handling.
+ * Catches errors and returns standardized failed responses.
+ */
+export declare function withErrorHandling<TInput, TOutput>(handler: (input: TInput) => Promise<TOutput>): (input: TInput) => Promise<{
+    output: TOutput;
+    state: 'succeeded';
+} | {
+    errorMessage: string;
+    state: 'failed';
+}>;

package/dist/utils/validation.js

@@ -0,0 +1,107 @@
+/**
+ * Validation utilities for step handlers.
+ * Reduces boilerplate by providing common validation functions.
+ */ export class ValidationError extends Error {
+    constructor(message){
+        super(message);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Validates that required fields are present and non-null in the input object.
+ * @throws ValidationError if any required field is missing
+ */ export function validateRequired(input, fields) {
+    if (!input) {
+        throw new ValidationError('No input provided');
+    }
+    for (const field of fields){
+        const value = input[field];
+        if (value === undefined || value === null) {
+            throw new ValidationError(`${String(field)} is required`);
+        }
+    }
+}
+/**
+ * Validates that a string field is present and is actually a string.
+ * @throws ValidationError if the field is missing or not a string
+ */ export function validateString(value, fieldName) {
+    if (!value || typeof value !== 'string') {
+        throw new ValidationError(`${fieldName} is required and must be a string`);
+    }
+}
+/**
+ * Validates that a URL is valid.
+ * @throws ValidationError if the URL is invalid
+ */ export function validateUrl(url) {
+    try {
+        new URL(url);
+    } catch  {
+        throw new ValidationError(`Invalid URL: ${url}`);
+    }
+}
+/**
+ * Validates that the value is a valid email address.
+ * Uses a simple regex for basic validation.
+ * @throws ValidationError if the email is invalid
+ */ export function validateEmail(email, fieldName = 'email') {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    if (!emailRegex.test(email)) {
+        throw new ValidationError(`${fieldName} must be a valid email address`);
+    }
+}
+/**
+ * Parses a value that might be JSON string or already an object.
+ * @returns The parsed object
+ * @throws ValidationError if parsing fails
+ */ export function parseJsonOrObject(value, fieldName) {
+    if (typeof value === 'string') {
+        try {
+            return JSON.parse(value);
+        } catch  {
+            throw new ValidationError(`${fieldName} must be valid JSON`);
+        }
+    }
+    return value;
+}
+/**
+ * Validates that a number is within a range.
+ * @throws ValidationError if the value is out of range
+ */ export function validateNumberRange(value, fieldName, min, max) {
+    if (min !== undefined && value < min) {
+        throw new ValidationError(`${fieldName} must be at least ${min}`);
+    }
+    if (max !== undefined && value > max) {
+        throw new ValidationError(`${fieldName} must be at most ${max}`);
+    }
+}
+/**
+ * Creates a standardized failed response for step handlers.
+ */ export function createFailedResponse(error) {
+    return {
+        errorMessage: error instanceof Error ? error.message : 'Unknown error',
+        state: 'failed'
+    };
+}
+/**
+ * Creates a standardized success response for step handlers.
+ */ export function createSuccessResponse(output) {
+    return {
+        output,
+        state: 'succeeded'
+    };
+}
+/**
+ * Wraps a step handler function with automatic error handling.
+ * Catches errors and returns standardized failed responses.
+ */ export function withErrorHandling(handler) {
+    return async (input)=>{
+        try {
+            const output = await handler(input);
+            return createSuccessResponse(output);
+        } catch (error) {
+            return createFailedResponse(error);
+        }
+    };
+}
+
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/validation.ts"],"sourcesContent":["/**\n * Validation utilities for step handlers.\n * Reduces boilerplate by providing common validation functions.\n */\n\nexport class ValidationError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'ValidationError'\n  }\n}\n\n/**\n * Validates that required fields are present and non-null in the input object.\n * @throws ValidationError if any required field is missing\n */\nexport function validateRequired<T extends Record<string, unknown>>(\n  input: T | null | undefined,\n  fields: (keyof T)[]\n): asserts input is T {\n  if (!input) {\n    throw new ValidationError('No input provided')\n  }\n\n  for (const field of fields) {\n    const value = input[field]\n    if (value === undefined || value === null) {\n      throw new ValidationError(`${String(field)} is required`)\n    }\n  }\n}\n\n/**\n * Validates that a string field is present and is actually a string.\n * @throws ValidationError if the field is missing or not a string\n */\nexport function validateString(\n  value: unknown,\n  fieldName: string\n): asserts value is string {\n  if (!value || typeof value !== 'string') {\n    throw new ValidationError(`${fieldName} is required and must be a string`)\n  }\n}\n\n/**\n * Validates that a URL is valid.\n * @throws ValidationError if the URL is invalid\n */\nexport function validateUrl(url: string): void {\n  try {\n    new URL(url)\n  } catch {\n    throw new ValidationError(`Invalid URL: ${url}`)\n  }\n}\n\n/**\n * Validates that the value is a valid email address.\n * Uses a simple regex for basic validation.\n * @throws ValidationError if the email is invalid\n */\nexport function validateEmail(email: string, fieldName = 'email'): void {\n  const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/\n  if (!emailRegex.test(email)) {\n    throw new ValidationError(`${fieldName} must be a valid email address`)\n  }\n}\n\n/**\n * Parses a value that might be JSON string or already an object.\n * @returns The parsed object\n * @throws ValidationError if parsing fails\n */\nexport function parseJsonOrObject<T = unknown>(\n  value: string | T,\n  fieldName: string\n): T {\n  if (typeof value === 'string') {\n    try {\n      return JSON.parse(value) as T\n    } catch {\n      throw new ValidationError(`${fieldName} must be valid JSON`)\n    }\n  }\n  return value as T\n}\n\n/**\n * Validates that a number is within a range.\n * @throws ValidationError if the value is out of range\n */\nexport function validateNumberRange(\n  value: number,\n  fieldName: string,\n  min?: number,\n  max?: number\n): void {\n  if (min !== undefined && value < min) {\n    throw new ValidationError(`${fieldName} must be at least ${min}`)\n  }\n  if (max !== undefined && value > max) {\n    throw new ValidationError(`${fieldName} must be at most ${max}`)\n  }\n}\n\n/**\n * Creates a standardized failed response for step handlers.\n */\nexport function createFailedResponse(error: unknown) {\n  return {\n    errorMessage: error instanceof Error ? error.message : 'Unknown error',\n    state: 'failed' as const\n  }\n}\n\n/**\n * Creates a standardized success response for step handlers.\n */\nexport function createSuccessResponse<T>(output: T) {\n  return {\n    output,\n    state: 'succeeded' as const\n  }\n}\n\n/**\n * Wraps a step handler function with automatic error handling.\n * Catches errors and returns standardized failed responses.\n */\nexport function withErrorHandling<TInput, TOutput>(\n  handler: (input: TInput) => Promise<TOutput>\n): (input: TInput) => Promise<{ output: TOutput; state: 'succeeded' } | { errorMessage: string; state: 'failed' }> {\n  return async (input: TInput) => {\n    try {\n      const output = await handler(input)\n      return createSuccessResponse(output)\n    } catch (error) {\n      return createFailedResponse(error)\n    }\n  }\n}\n"],"names":["ValidationError","Error","message","name","validateRequired","input","fields","field","value","undefined","String","validateString","fieldName","validateUrl","url","URL","validateEmail","email","emailRegex","test","parseJsonOrObject","JSON","parse","validateNumberRange","min","max","createFailedResponse","error","errorMessage","state","createSuccessResponse","output","withErrorHandling","handler"],"mappings":"AAAA;;;CAGC,GAED,OAAO,MAAMA,wBAAwBC;IACnC,YAAYC,OAAe,CAAE;QAC3B,KAAK,CAACA;QACN,IAAI,CAACC,IAAI,GAAG;IACd;AACF;AAEA;;;CAGC,GACD,OAAO,SAASC,iBACdC,KAA2B,EAC3BC,MAAmB;IAEnB,IAAI,CAACD,OAAO;QACV,MAAM,IAAIL,gBAAgB;IAC5B;IAEA,KAAK,MAAMO,SAASD,OAAQ;QAC1B,MAAME,QAAQH,KAAK,CAACE,MAAM;QAC1B,IAAIC,UAAUC,aAAaD,UAAU,MAAM;YACzC,MAAM,IAAIR,gBAAgB,GAAGU,OAAOH,OAAO,YAAY,CAAC;QAC1D;IACF;AACF;AAEA;;;CAGC,GACD,OAAO,SAASI,eACdH,KAAc,EACdI,SAAiB;IAEjB,IAAI,CAACJ,SAAS,OAAOA,UAAU,UAAU;QACvC,MAAM,IAAIR,gBAAgB,GAAGY,UAAU,iCAAiC,CAAC;IAC3E;AACF;AAEA;;;CAGC,GACD,OAAO,SAASC,YAAYC,GAAW;IACrC,IAAI;QACF,IAAIC,IAAID;IACV,EAAE,OAAM;QACN,MAAM,IAAId,gBAAgB,CAAC,aAAa,EAAEc,KAAK;IACjD;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASE,cAAcC,KAAa,EAAEL,YAAY,OAAO;IAC9D,MAAMM,aAAa;IACnB,IAAI,CAACA,WAAWC,IAAI,CAACF,QAAQ;QAC3B,MAAM,IAAIjB,gBAAgB,GAAGY,UAAU,8BAA8B,CAAC;IACxE;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASQ,kBACdZ,KAAiB,EACjBI,SAAiB;IAEjB,IAAI,OAAOJ,UAAU,UAAU;QAC7B,IAAI;YACF,OAAOa,KAAKC,KAAK,CAACd;QACpB,EAAE,OAAM;YACN,MAAM,IAAIR,gBAAgB,GAAGY,UAAU,mBAAmB,CAAC;QAC7D;IACF;IACA,OAAOJ;AACT;AAEA;;;CAGC,GACD,OAAO,SAASe,oBACdf,KAAa,EACbI,SAAiB,EACjBY,GAAY,EACZC,GAAY;IAEZ,IAAID,QAAQf,aAAaD,QAAQgB,KAAK;QACpC,MAAM,IAAIxB,gBAAgB,GAAGY,UAAU,kBAAkB,EAAEY,KAAK;IAClE;IACA,IAAIC,QAAQhB,aAAaD,QAAQiB,KAAK;QACpC,MAAM,IAAIzB,gBAAgB,GAAGY,UAAU,iBAAiB,EAAEa,KAAK;IACjE;AACF;AAEA;;CAEC,GACD,OAAO,SAASC,qBAAqBC,KAAc;IACjD,OAAO;QACLC,cAAcD,iBAAiB1B,QAAQ0B,MAAMzB,OAAO,GAAG;QACvD2B,OAAO;IACT;AACF;AAEA;;CAEC,GACD,OAAO,SAASC,sBAAyBC,MAAS;IAChD,OAAO;QACLA;QACAF,OAAO;IACT;AACF;AAEA;;;CAGC,GACD,OAAO,SAASG,kBACdC,OAA4C;IAE5C,OAAO,OAAO5B;QACZ,IAAI;YACF,MAAM0B,SAAS,MAAME,QAAQ5B;YAC7B,OAAOyB,sBAAsBC;QAC/B,EAAE,OAAOJ,OAAO;YACd,OAAOD,qBAAqBC;QAC9B;IACF;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtr-dev/payload-automation",
-  "version": "0.0.42",
+  "version": "0.0.45",
   "description": "PayloadCMS Automation Plugin - Comprehensive workflow automation system with visual workflow building, execution tracking, and step types",
   "license": "MIT",
   "type": "module",
@@ -138,6 +138,7 @@
   "dependencies": {
     "@xyflow/react": "^12.10.0",
     "handlebars": "^4.7.8",
+    "jsonata": "^2.1.0",
     "node-cron": "^4.2.1",
     "pino": "^9.9.0"
   }

package/dist/plugin/collection-hook.d.ts

@@ -1 +0,0 @@
-export declare const createCollectionTriggerHook: (collectionSlug: string, hookType: string) => (args: any) => Promise<void>;