@mobilizehub/payload-plugin 0.1.0 → 0.3.0

package/dist/fields/name.js

@@ -0,0 +1,12 @@
+/**
+ * Creates a 'name' text field configuration for a Collection.
+ */ export const createNameField = ()=>{
+    const field = {
+        name: 'name',
+        type: 'text',
+        required: true
+    };
+    return field;
+};
+
+//# sourceMappingURL=name.js.map

package/dist/fields/name.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fields/name.ts"],"sourcesContent":["import type { TextField } from 'payload'\n\n/**\n * Creates a 'name' text field configuration for a Collection.\n */\nexport const createNameField = (): TextField => {\n  const field: TextField = {\n    name: 'name',\n    type: 'text',\n    required: true,\n  }\n\n  return field\n}\n"],"names":["createNameField","field","name","type","required"],"mappings":"AAEA;;CAEC,GACD,OAAO,MAAMA,kBAAkB;IAC7B,MAAMC,QAAmB;QACvBC,MAAM;QACNC,MAAM;QACNC,UAAU;IACZ;IAEA,OAAOH;AACT,EAAC"}

package/dist/fields/publishedAt.d.ts

@@ -0,0 +1,5 @@
+import type { DateField } from 'payload';
+/**
+ * Creates a 'publishedAt' date field configuration for a Collection.
+ */
+export declare const createPublishedAtField: () => DateField;

package/dist/fields/publishedAt.js

@@ -0,0 +1,16 @@
+/**
+ * Creates a 'publishedAt' date field configuration for a Collection.
+ */ export const createPublishedAtField = ()=>{
+    const field = {
+        name: 'publishedAt',
+        type: 'date',
+        admin: {
+            date: {
+                pickerAppearance: 'dayAndTime'
+            }
+        }
+    };
+    return field;
+};
+
+//# sourceMappingURL=publishedAt.js.map

package/dist/fields/publishedAt.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fields/publishedAt.ts"],"sourcesContent":["import type { DateField } from 'payload'\n\n/**\n * Creates a 'publishedAt' date field configuration for a Collection.\n */\nexport const createPublishedAtField = (): DateField => {\n  const field: DateField = {\n    name: 'publishedAt',\n    type: 'date',\n    admin: {\n      date: {\n        pickerAppearance: 'dayAndTime',\n      },\n    },\n  }\n\n  return field\n}\n"],"names":["createPublishedAtField","field","name","type","admin","date","pickerAppearance"],"mappings":"AAEA;;CAEC,GACD,OAAO,MAAMA,yBAAyB;IACpC,MAAMC,QAAmB;QACvBC,MAAM;QACNC,MAAM;QACNC,OAAO;YACLC,MAAM;gBACJC,kBAAkB;YACpB;QACF;IACF;IAEA,OAAOL;AACT,EAAC"}

package/dist/fields/slug.d.ts

@@ -0,0 +1,7 @@
+import type { TextField } from 'payload';
+/**
+ * Creates a 'slug' text field configuration for a Collection.
+ * The slug is auto-generated from the title if not provided,
+ * and is validated to ensure it is URL-friendly.
+ */
+export declare const createSlugField: () => TextField;

package/dist/fields/slug.js

@@ -0,0 +1,47 @@
+/**
+ * Creates a 'slug' text field configuration for a Collection.
+ * The slug is auto-generated from the title if not provided,
+ * and is validated to ensure it is URL-friendly.
+ */ export const createSlugField = ()=>{
+    const field = {
+        name: 'slug',
+        type: 'text',
+        admin: {
+            position: 'sidebar'
+        },
+        hooks: {
+            beforeChange: [
+                ({ data, value })=>{
+                    /**
+           * Auto-generate slug from title if not provided
+           */ if (!value && data?.title) {
+                        return data.title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+                    }
+                    return value;
+                }
+            ],
+            beforeValidate: [
+                ({ operation, value })=>{
+                    if (operation === 'create' && !value) {
+                        return value;
+                    }
+                    // Ensure slug is URL-friendly
+                    return value?.toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-');
+                }
+            ]
+        },
+        required: true,
+        unique: true,
+        validate: (value)=>{
+            /**
+       * Custom validation to ensure slug format
+       */ if (value && !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value)) {
+                return 'Slug must be lowercase and can only contain letters, numbers, and hyphens.';
+            }
+            return true;
+        }
+    };
+    return field;
+};
+
+//# sourceMappingURL=slug.js.map

package/dist/fields/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fields/slug.ts"],"sourcesContent":["import type { TextField } from 'payload'\n\n/**\n * Creates a 'slug' text field configuration for a Collection.\n * The slug is auto-generated from the title if not provided,\n * and is validated to ensure it is URL-friendly.\n */\nexport const createSlugField = (): TextField => {\n  const field: TextField = {\n    name: 'slug',\n    type: 'text',\n    admin: {\n      position: 'sidebar',\n    },\n    hooks: {\n      beforeChange: [\n        ({ data, value }) => {\n          /**\n           * Auto-generate slug from title if not provided\n           */\n          if (!value && data?.title) {\n            return data.title\n              .toLowerCase()\n              .replace(/[^a-z0-9]+/g, '-')\n              .replace(/^-+|-+$/g, '')\n          }\n          return value\n        },\n      ],\n      beforeValidate: [\n        ({ operation, value }) => {\n          if (operation === 'create' && !value) {\n            return value\n          }\n          // Ensure slug is URL-friendly\n          return value\n            ?.toLowerCase()\n            .replace(/[^a-z0-9-]/g, '-')\n            .replace(/-+/g, '-')\n        },\n      ],\n    },\n    required: true,\n    unique: true,\n    validate: (value: null | string | undefined) => {\n      /**\n       * Custom validation to ensure slug format\n       */\n      if (value && !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value)) {\n        return 'Slug must be lowercase and can only contain letters, numbers, and hyphens.'\n      }\n\n      return true\n    },\n  }\n\n  return field\n}\n"],"names":["createSlugField","field","name","type","admin","position","hooks","beforeChange","data","value","title","toLowerCase","replace","beforeValidate","operation","required","unique","validate","test"],"mappings":"AAEA;;;;CAIC,GACD,OAAO,MAAMA,kBAAkB;IAC7B,MAAMC,QAAmB;QACvBC,MAAM;QACNC,MAAM;QACNC,OAAO;YACLC,UAAU;QACZ;QACAC,OAAO;YACLC,cAAc;gBACZ,CAAC,EAAEC,IAAI,EAAEC,KAAK,EAAE;oBACd;;WAEC,GACD,IAAI,CAACA,SAASD,MAAME,OAAO;wBACzB,OAAOF,KAAKE,KAAK,CACdC,WAAW,GACXC,OAAO,CAAC,eAAe,KACvBA,OAAO,CAAC,YAAY;oBACzB;oBACA,OAAOH;gBACT;aACD;YACDI,gBAAgB;gBACd,CAAC,EAAEC,SAAS,EAAEL,KAAK,EAAE;oBACnB,IAAIK,cAAc,YAAY,CAACL,OAAO;wBACpC,OAAOA;oBACT;oBACA,8BAA8B;oBAC9B,OAAOA,OACHE,cACDC,QAAQ,eAAe,KACvBA,QAAQ,OAAO;gBACpB;aACD;QACH;QACAG,UAAU;QACVC,QAAQ;QACRC,UAAU,CAACR;YACT;;OAEC,GACD,IAAIA,SAAS,CAAC,6BAA6BS,IAAI,CAACT,QAAQ;gBACtD,OAAO;YACT;YAEA,OAAO;QACT;IACF;IAEA,OAAOR;AACT,EAAC"}

package/dist/fields/status.d.ts

@@ -0,0 +1,5 @@
+import type { SelectField } from 'payload';
+/**
+ * Creates a 'status' select field configuration for a Collection.
+ */
+export declare const createStatusField: () => SelectField;

package/dist/fields/status.js

@@ -0,0 +1,25 @@
+/**
+ * Creates a 'status' select field configuration for a Collection.
+ */ export const createStatusField = ()=>{
+    const field = {
+        name: 'status',
+        type: 'select',
+        admin: {
+            position: 'sidebar'
+        },
+        defaultValue: 'draft',
+        options: [
+            {
+                label: 'Draft',
+                value: 'draft'
+            },
+            {
+                label: 'Published',
+                value: 'published'
+            }
+        ]
+    };
+    return field;
+};
+
+//# sourceMappingURL=status.js.map

package/dist/fields/status.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fields/status.ts"],"sourcesContent":["import type { SelectField } from 'payload'\n\n/**\n * Creates a 'status' select field configuration for a Collection.\n */\nexport const createStatusField = (): SelectField => {\n  const field: SelectField = {\n    name: 'status',\n    type: 'select',\n    admin: {\n      position: 'sidebar',\n    },\n    defaultValue: 'draft',\n    options: [\n      { label: 'Draft', value: 'draft' },\n      { label: 'Published', value: 'published' },\n    ],\n  }\n  return field\n}\n"],"names":["createStatusField","field","name","type","admin","position","defaultValue","options","label","value"],"mappings":"AAEA;;CAEC,GACD,OAAO,MAAMA,oBAAoB;IAC/B,MAAMC,QAAqB;QACzBC,MAAM;QACNC,MAAM;QACNC,OAAO;YACLC,UAAU;QACZ;QACAC,cAAc;QACdC,SAAS;YACP;gBAAEC,OAAO;gBAASC,OAAO;YAAQ;YACjC;gBAAED,OAAO;gBAAaC,OAAO;YAAY;SAC1C;IACH;IACA,OAAOR;AACT,EAAC"}

package/dist/index.js

@@ -1,14 +1,59 @@
+import { generateBroadcastsCollection } from './collections/broadcasts/generateBroadcastsCollection.js';
 import { generateContactsCollection } from './collections/contacts/generateContactsCollection.js';
+import { generateEmailsCollection } from './collections/emails/generateEmailsCollection.js';
 import { generateTagsCollection } from './collections/tags/generateTagsCollection.js';
+import { generateUnsubscribeTokensCollection } from './collections/unsubscribe-tokens/generateUnsubscribeTokens.js';
+import { sendBroadcastHandler } from './endpoints/sendBroadcastHandler.js';
+import { sendTestEmailHandler } from './endpoints/sendTestBroadcastHandler.js';
+import { unsubscribeHandler } from './endpoints/unsubscribeHandler.js';
+import { createSendBroadcastsTask } from './tasks/sendBroadcastsTask.js';
+import { createSendEmailTask } from './tasks/sendEmailTask.js';
 export * from './types/index.js';
 export const mobilizehubPlugin = (pluginOptions)=>(config)=>{
+        if (pluginOptions.disabled) {
+            return config;
+        }
         if (!config.collections) {
             config.collections = [];
         }
-        config.collections.push(generateTagsCollection(pluginOptions), generateContactsCollection(pluginOptions));
-        if (pluginOptions.disabled) {
-            return config;
+        config.collections.push(generateTagsCollection(pluginOptions), generateContactsCollection(pluginOptions), generateBroadcastsCollection(pluginOptions), generateEmailsCollection(pluginOptions), generateUnsubscribeTokensCollection());
+        if (!config.endpoints) {
+            config.endpoints = [];
+        }
+        const endpoints = [
+            {
+                handler: sendBroadcastHandler(),
+                method: 'post',
+                path: '/send-broadcast'
+            },
+            {
+                handler: sendTestEmailHandler(pluginOptions),
+                method: 'post',
+                path: '/send-test-email'
+            },
+            {
+                handler: unsubscribeHandler(),
+                method: 'post',
+                path: '/unsubscribe'
+            }
+        ];
+        config.endpoints = [
+            ...config.endpoints,
+            ...endpoints
+        ];
+        if (!config.jobs) {
+            config.jobs = {
+                tasks: []
+            };
         }
+        const tasks = [
+            createSendBroadcastsTask(pluginOptions),
+            createSendEmailTask(pluginOptions)
+        ];
+        config.jobs.tasks = [
+            ...config.jobs.tasks ?? [],
+            ...tasks
+        ];
         const incomingOnInit = config.onInit;
         config.onInit = async (payload)=>{
             if (incomingOnInit) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Config } from 'payload'\n\nimport type { MobilizehubPluginConfig } from './types/index.js'\n\nimport { generateContactsCollection } from './collections/contacts/generateContactsCollection.js'\nimport { generateTagsCollection } from './collections/tags/generateTagsCollection.js'\n\nexport * from './types/index.js'\n\nexport const mobilizehubPlugin =\n  (pluginOptions: MobilizehubPluginConfig) =>\n  (config: Config): Config => {\n    if (!config.collections) {\n      config.collections = []\n    }\n\n    config.collections.push(\n      generateTagsCollection(pluginOptions),\n      generateContactsCollection(pluginOptions),\n    )\n\n    if (pluginOptions.disabled) {\n      return config\n    }\n\n    const incomingOnInit = config.onInit\n\n    config.onInit = async (payload) => {\n      if (incomingOnInit) {\n        await incomingOnInit(payload)\n      }\n    }\n\n    return config\n  }\n"],"names":["generateContactsCollection","generateTagsCollection","mobilizehubPlugin","pluginOptions","config","collections","push","disabled","incomingOnInit","onInit","payload"],"mappings":"AAIA,SAASA,0BAA0B,QAAQ,uDAAsD;AACjG,SAASC,sBAAsB,QAAQ,+CAA8C;AAErF,cAAc,mBAAkB;AAEhC,OAAO,MAAMC,oBACX,CAACC,gBACD,CAACC;QACC,IAAI,CAACA,OAAOC,WAAW,EAAE;YACvBD,OAAOC,WAAW,GAAG,EAAE;QACzB;QAEAD,OAAOC,WAAW,CAACC,IAAI,CACrBL,uBAAuBE,gBACvBH,2BAA2BG;QAG7B,IAAIA,cAAcI,QAAQ,EAAE;YAC1B,OAAOH;QACT;QAEA,MAAMI,iBAAiBJ,OAAOK,MAAM;QAEpCL,OAAOK,MAAM,GAAG,OAAOC;YACrB,IAAIF,gBAAgB;gBAClB,MAAMA,eAAeE;YACvB;QACF;QAEA,OAAON;IACT,EAAC"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Config, Endpoint, TaskConfig } from 'payload'\n\nimport type { MobilizehubPluginConfig } from './types/index.js'\n\nimport { generateBroadcastsCollection } from './collections/broadcasts/generateBroadcastsCollection.js'\nimport { generateContactsCollection } from './collections/contacts/generateContactsCollection.js'\nimport { generateEmailsCollection } from './collections/emails/generateEmailsCollection.js'\nimport { generateTagsCollection } from './collections/tags/generateTagsCollection.js'\nimport { generateUnsubscribeTokensCollection } from './collections/unsubscribe-tokens/generateUnsubscribeTokens.js'\nimport { sendBroadcastHandler } from './endpoints/sendBroadcastHandler.js'\nimport { sendTestEmailHandler } from './endpoints/sendTestBroadcastHandler.js'\nimport { unsubscribeHandler } from './endpoints/unsubscribeHandler.js'\nimport { createSendBroadcastsTask } from './tasks/sendBroadcastsTask.js'\nimport { createSendEmailTask } from './tasks/sendEmailTask.js'\n\nexport * from './types/index.js'\n\nexport const mobilizehubPlugin =\n  (pluginOptions: MobilizehubPluginConfig) =>\n  (config: Config): Config => {\n    if (pluginOptions.disabled) {\n      return config\n    }\n\n    if (!config.collections) {\n      config.collections = []\n    }\n\n    config.collections.push(\n      generateTagsCollection(pluginOptions),\n      generateContactsCollection(pluginOptions),\n      generateBroadcastsCollection(pluginOptions),\n      generateEmailsCollection(pluginOptions),\n      generateUnsubscribeTokensCollection(),\n    )\n\n    if (!config.endpoints) {\n      config.endpoints = []\n    }\n\n    const endpoints: Endpoint[] = [\n      {\n        handler: sendBroadcastHandler(),\n        method: 'post',\n        path: '/send-broadcast',\n      },\n      {\n        handler: sendTestEmailHandler(pluginOptions),\n        method: 'post',\n        path: '/send-test-email',\n      },\n      {\n        handler: unsubscribeHandler(),\n        method: 'post',\n        path: '/unsubscribe',\n      },\n    ]\n\n    config.endpoints = [...config.endpoints, ...endpoints]\n\n    if (!config.jobs) {\n      config.jobs = {\n        tasks: [],\n      }\n    }\n\n    const tasks: TaskConfig[] = [\n      createSendBroadcastsTask(pluginOptions),\n      createSendEmailTask(pluginOptions),\n    ]\n\n    config.jobs.tasks = [...(config.jobs.tasks ?? []), ...tasks]\n\n    const incomingOnInit = config.onInit\n\n    config.onInit = async (payload) => {\n      if (incomingOnInit) {\n        await incomingOnInit(payload)\n      }\n    }\n\n    return config\n  }\n"],"names":["generateBroadcastsCollection","generateContactsCollection","generateEmailsCollection","generateTagsCollection","generateUnsubscribeTokensCollection","sendBroadcastHandler","sendTestEmailHandler","unsubscribeHandler","createSendBroadcastsTask","createSendEmailTask","mobilizehubPlugin","pluginOptions","config","disabled","collections","push","endpoints","handler","method","path","jobs","tasks","incomingOnInit","onInit","payload"],"mappings":"AAIA,SAASA,4BAA4B,QAAQ,2DAA0D;AACvG,SAASC,0BAA0B,QAAQ,uDAAsD;AACjG,SAASC,wBAAwB,QAAQ,mDAAkD;AAC3F,SAASC,sBAAsB,QAAQ,+CAA8C;AACrF,SAASC,mCAAmC,QAAQ,gEAA+D;AACnH,SAASC,oBAAoB,QAAQ,sCAAqC;AAC1E,SAASC,oBAAoB,QAAQ,0CAAyC;AAC9E,SAASC,kBAAkB,QAAQ,oCAAmC;AACtE,SAASC,wBAAwB,QAAQ,gCAA+B;AACxE,SAASC,mBAAmB,QAAQ,2BAA0B;AAE9D,cAAc,mBAAkB;AAEhC,OAAO,MAAMC,oBACX,CAACC,gBACD,CAACC;QACC,IAAID,cAAcE,QAAQ,EAAE;YAC1B,OAAOD;QACT;QAEA,IAAI,CAACA,OAAOE,WAAW,EAAE;YACvBF,OAAOE,WAAW,GAAG,EAAE;QACzB;QAEAF,OAAOE,WAAW,CAACC,IAAI,CACrBZ,uBAAuBQ,gBACvBV,2BAA2BU,gBAC3BX,6BAA6BW,gBAC7BT,yBAAyBS,gBACzBP;QAGF,IAAI,CAACQ,OAAOI,SAAS,EAAE;YACrBJ,OAAOI,SAAS,GAAG,EAAE;QACvB;QAEA,MAAMA,YAAwB;YAC5B;gBACEC,SAASZ;gBACTa,QAAQ;gBACRC,MAAM;YACR;YACA;gBACEF,SAASX,qBAAqBK;gBAC9BO,QAAQ;gBACRC,MAAM;YACR;YACA;gBACEF,SAASV;gBACTW,QAAQ;gBACRC,MAAM;YACR;SACD;QAEDP,OAAOI,SAAS,GAAG;eAAIJ,OAAOI,SAAS;eAAKA;SAAU;QAEtD,IAAI,CAACJ,OAAOQ,IAAI,EAAE;YAChBR,OAAOQ,IAAI,GAAG;gBACZC,OAAO,EAAE;YACX;QACF;QAEA,MAAMA,QAAsB;YAC1Bb,yBAAyBG;YACzBF,oBAAoBE;SACrB;QAEDC,OAAOQ,IAAI,CAACC,KAAK,GAAG;eAAKT,OAAOQ,IAAI,CAACC,KAAK,IAAI,EAAE;eAAMA;SAAM;QAE5D,MAAMC,iBAAiBV,OAAOW,MAAM;QAEpCX,OAAOW,MAAM,GAAG,OAAOC;YACrB,IAAIF,gBAAgB;gBAClB,MAAMA,eAAeE;YACvB;QACF;QAEA,OAAOZ;IACT,EAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1 @@
+export { confirmUnsubscribe } from './unsubscribe.js';

package/dist/react/index.js

@@ -0,0 +1,3 @@
+export { confirmUnsubscribe } from './unsubscribe.js';
+
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/index.ts"],"sourcesContent":["export { confirmUnsubscribe } from './unsubscribe.js'\n"],"names":["confirmUnsubscribe"],"mappings":"AAAA,SAASA,kBAAkB,QAAQ,mBAAkB"}

package/dist/react/unsubscribe.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Confirms an unsubscribe request by sending the token to the backend.
+ */
+export declare function confirmUnsubscribe({ token }: {
+    token: string;
+}): Promise<any>;

package/dist/react/unsubscribe.js

@@ -0,0 +1,16 @@
+const apiUrl = '/api/unsubscribe';
+/**
+ * Confirms an unsubscribe request by sending the token to the backend.
+ */ export async function confirmUnsubscribe({ token }) {
+    return fetch(apiUrl, {
+        body: JSON.stringify({
+            token
+        }),
+        headers: {
+            'Content-Type': 'application/json'
+        },
+        method: 'POST'
+    }).then((res)=>res.json());
+}
+
+//# sourceMappingURL=unsubscribe.js.map

package/dist/react/unsubscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/unsubscribe.ts"],"sourcesContent":["const apiUrl = '/api/unsubscribe'\n\n/**\n * Confirms an unsubscribe request by sending the token to the backend.\n */\nexport async function confirmUnsubscribe({ token }: { token: string }) {\n  return fetch(apiUrl, {\n    body: JSON.stringify({ token }),\n    headers: {\n      'Content-Type': 'application/json',\n    },\n    method: 'POST',\n  }).then((res) => res.json())\n}\n"],"names":["apiUrl","confirmUnsubscribe","token","fetch","body","JSON","stringify","headers","method","then","res","json"],"mappings":"AAAA,MAAMA,SAAS;AAEf;;CAEC,GACD,OAAO,eAAeC,mBAAmB,EAAEC,KAAK,EAAqB;IACnE,OAAOC,MAAMH,QAAQ;QACnBI,MAAMC,KAAKC,SAAS,CAAC;YAAEJ;QAAM;QAC7BK,SAAS;YACP,gBAAgB;QAClB;QACAC,QAAQ;IACV,GAAGC,IAAI,CAAC,CAACC,MAAQA,IAAIC,IAAI;AAC3B"}

package/dist/tasks/sendBroadcastsTask.d.ts

@@ -0,0 +1,11 @@
+import type { TaskConfig } from 'payload';
+import type { MobilizehubPluginConfig } from '../types/index.js';
+/**
+ * Creates the send-broadcasts scheduled task.
+ *
+ * Processes broadcasts by polling for documents with status 'sending' and
+ * queuing batches of send-email jobs. Each invocation processes one broadcast
+ * and one batch of contacts, allowing the task to be distributed across
+ * multiple schedule intervals.
+ */
+export declare const createSendBroadcastsTask: (pluginConfig: MobilizehubPluginConfig) => TaskConfig;

package/dist/tasks/sendBroadcastsTask.js

@@ -0,0 +1,196 @@
+import z from 'zod';
+/**
+ * Schema for validating broadcast documents before processing.
+ */ const BroadcastSchema = z.object({
+    id: z.number(),
+    content: z.any().refine((val)=>val !== undefined && val !== null, {
+        message: 'Broadcast content is missing'
+    }),
+    fromAddress: z.email({
+        message: 'Invalid from address email format'
+    }),
+    fromName: z.string().min(1, {
+        message: 'From name is required'
+    }),
+    meta: z.object({
+        contactsCount: z.number().min(0),
+        lastProcessedContactId: z.number().min(0).default(0),
+        processedCount: z.number().min(0)
+    }),
+    subject: z.string().min(1, {
+        message: 'Subject is required'
+    }),
+    tags: z.array(z.any()).optional(),
+    to: z.literal('all').or(z.literal('tags'))
+});
+/**
+ * Validates a broadcast document against the schema.
+ * Returns typed data on success, or flattened field errors on failure.
+ */ function safeParseBroadcast(broadcast) {
+    const result = BroadcastSchema.safeParse(broadcast);
+    if (!result.success) {
+        return {
+            data: null,
+            errors: z.flattenError(result.error).fieldErrors,
+            success: false
+        };
+    }
+    return {
+        data: result.data,
+        success: true
+    };
+}
+/**
+ * Builds the where clause for fetching the next batch of contacts.
+ * Uses cursor-based pagination (id > lastProcessedContactId) for consistent
+ * ordering and efficient queries at scale.
+ */ function buildContactsWhereClause(broadcast, rawBroadcast) {
+    const conditions = [
+        {
+            emailOptIn: {
+                equals: true
+            }
+        },
+        {
+            id: {
+                greater_than: broadcast.meta.lastProcessedContactId
+            }
+        }
+    ];
+    // Tags may be populated objects or raw IDs depending on query depth
+    if (broadcast.to === 'tags' && Array.isArray(rawBroadcast.tags) && rawBroadcast.tags.length > 0) {
+        const tagIds = rawBroadcast.tags.map((t)=>typeof t === 'object' ? t.id : t);
+        conditions.push({
+            tags: {
+                in: tagIds
+            }
+        });
+    }
+    return {
+        and: conditions
+    };
+}
+/**
+ * Extracts a numeric ID from a contact, handling string IDs from some database adapters.
+ */ function getLastContactId(contact) {
+    return typeof contact.id === 'number' ? contact.id : parseInt(contact.id, 10);
+}
+/**
+ * Creates the send-broadcasts scheduled task.
+ *
+ * Processes broadcasts by polling for documents with status 'sending' and
+ * queuing batches of send-email jobs. Each invocation processes one broadcast
+ * and one batch of contacts, allowing the task to be distributed across
+ * multiple schedule intervals.
+ */ export const createSendBroadcastsTask = (pluginConfig)=>{
+    const BATCH_SIZE = pluginConfig.broadcastConfig?.batchSize || 100;
+    const TASK_SCHEDULE = pluginConfig.broadcastConfig?.taskSchedule || '*/5 * * * *';
+    const QUEUE_NAME = pluginConfig.broadcastConfig?.broadcastQueueName || 'send-broadcasts';
+    return {
+        slug: 'send-broadcasts',
+        handler: async ({ req })=>{
+            const { payload } = req;
+            const logger = payload.logger;
+            logger.info('Send Broadcast task handler called');
+            const { docs } = await payload.find({
+                collection: 'broadcasts',
+                limit: 1,
+                sort: 'id',
+                where: {
+                    status: {
+                        equals: 'sending'
+                    }
+                }
+            });
+            const rawBroadcast = docs[0];
+            if (!rawBroadcast) {
+                logger.info('No broadcasts with status "sending" found');
+                return {
+                    output: {
+                        success: true
+                    }
+                };
+            }
+            const parsed = safeParseBroadcast(rawBroadcast);
+            if (!parsed.success) {
+                logger.error({
+                    errors: parsed.errors
+                }, `Broadcast ${rawBroadcast.id} validation failed`);
+                await payload.update({
+                    id: rawBroadcast.id,
+                    collection: 'broadcasts',
+                    data: {
+                        status: 'failed'
+                    }
+                });
+                return {
+                    output: {
+                        success: false
+                    }
+                };
+            }
+            const broadcast = parsed.data;
+            const whereClause = buildContactsWhereClause(broadcast, rawBroadcast);
+            const { docs: contacts } = await payload.find({
+                collection: 'contacts',
+                limit: BATCH_SIZE,
+                sort: 'id',
+                where: whereClause
+            });
+            if (contacts.length === 0) {
+                logger.info(`Broadcast ${broadcast.id} complete. ` + `Processed: ${broadcast.meta.processedCount}, Expected: ${broadcast.meta.contactsCount}`);
+                await payload.update({
+                    id: broadcast.id,
+                    collection: 'broadcasts',
+                    data: {
+                        status: 'sent'
+                    }
+                });
+                return {
+                    output: {
+                        success: true
+                    }
+                };
+            }
+            await Promise.all(contacts.map((contact)=>payload.jobs.queue({
+                    input: {
+                        broadcastId: broadcast.id,
+                        contactId: contact.id
+                    },
+                    queue: 'send-emails',
+                    task: 'send-email'
+                })));
+            await payload.update({
+                id: broadcast.id,
+                collection: 'broadcasts',
+                data: {
+                    meta: {
+                        lastProcessedContactId: getLastContactId(contacts[contacts.length - 1]),
+                        processedCount: broadcast.meta.processedCount + contacts.length
+                    }
+                }
+            });
+            logger.info(`Broadcast ${broadcast.id}: queued ${contacts.length} emails, ` + `total processed: ${broadcast.meta.processedCount + contacts.length}`);
+            return {
+                output: {
+                    success: true
+                }
+            };
+        },
+        outputSchema: [
+            {
+                name: 'success',
+                type: 'checkbox'
+            }
+        ],
+        retries: 3,
+        schedule: [
+            {
+                cron: TASK_SCHEDULE,
+                queue: QUEUE_NAME
+            }
+        ]
+    };
+};
+
+//# sourceMappingURL=sendBroadcastsTask.js.map

package/dist/tasks/sendBroadcastsTask.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tasks/sendBroadcastsTask.ts"],"sourcesContent":["import type { TaskConfig, Where } from 'payload'\n\nimport z from 'zod'\n\nimport type { MobilizehubPluginConfig } from '../types/index.js'\n\n/**\n * Schema for validating broadcast documents before processing.\n */\nconst BroadcastSchema = z.object({\n  id: z.number(),\n  content: z.any().refine((val) => val !== undefined && val !== null, {\n    message: 'Broadcast content is missing',\n  }),\n  fromAddress: z.email({ message: 'Invalid from address email format' }),\n  fromName: z.string().min(1, { message: 'From name is required' }),\n  meta: z.object({\n    contactsCount: z.number().min(0),\n    lastProcessedContactId: z.number().min(0).default(0),\n    processedCount: z.number().min(0),\n  }),\n  subject: z.string().min(1, { message: 'Subject is required' }),\n  tags: z.array(z.any()).optional(),\n  to: z.literal('all').or(z.literal('tags')),\n})\n\ntype ParsedBroadcast = z.infer<typeof BroadcastSchema>\n\n/**\n * Validates a broadcast document against the schema.\n * Returns typed data on success, or flattened field errors on failure.\n */\nfunction safeParseBroadcast(broadcast: unknown) {\n  const result = BroadcastSchema.safeParse(broadcast)\n\n  if (!result.success) {\n    return {\n      data: null,\n      errors: z.flattenError(result.error).fieldErrors,\n      success: false as const,\n    }\n  }\n\n  return {\n    data: result.data,\n    success: true as const,\n  }\n}\n\n/**\n * Builds the where clause for fetching the next batch of contacts.\n * Uses cursor-based pagination (id > lastProcessedContactId) for consistent\n * ordering and efficient queries at scale.\n */\nfunction buildContactsWhereClause(\n  broadcast: ParsedBroadcast,\n  rawBroadcast: Record<string, unknown>,\n): Where {\n  const conditions: Where[] = [\n    { emailOptIn: { equals: true } },\n    { id: { greater_than: broadcast.meta.lastProcessedContactId } },\n  ]\n\n  // Tags may be populated objects or raw IDs depending on query depth\n  if (broadcast.to === 'tags' && Array.isArray(rawBroadcast.tags) && rawBroadcast.tags.length > 0) {\n    const tagIds = rawBroadcast.tags.map((t: { id: number | string } | number | string) =>\n      typeof t === 'object' ? t.id : t,\n    )\n    conditions.push({ tags: { in: tagIds } })\n  }\n\n  return { and: conditions }\n}\n\n/**\n * Extracts a numeric ID from a contact, handling string IDs from some database adapters.\n */\nfunction getLastContactId(contact: { id: number | string }): number {\n  return typeof contact.id === 'number' ? contact.id : parseInt(contact.id, 10)\n}\n\n/**\n * Creates the send-broadcasts scheduled task.\n *\n * Processes broadcasts by polling for documents with status 'sending' and\n * queuing batches of send-email jobs. Each invocation processes one broadcast\n * and one batch of contacts, allowing the task to be distributed across\n * multiple schedule intervals.\n */\nexport const createSendBroadcastsTask = (pluginConfig: MobilizehubPluginConfig): TaskConfig => {\n  const BATCH_SIZE = pluginConfig.broadcastConfig?.batchSize || 100\n  const TASK_SCHEDULE = pluginConfig.broadcastConfig?.taskSchedule || '*/5 * * * *'\n  const QUEUE_NAME = pluginConfig.broadcastConfig?.broadcastQueueName || 'send-broadcasts'\n\n  return {\n    slug: 'send-broadcasts',\n    handler: async ({ req }) => {\n      const { payload } = req\n      const logger = payload.logger\n\n      logger.info('Send Broadcast task handler called')\n\n      const { docs } = await payload.find({\n        collection: 'broadcasts',\n        limit: 1,\n        sort: 'id',\n        where: { status: { equals: 'sending' } },\n      })\n\n      const rawBroadcast = docs[0]\n\n      if (!rawBroadcast) {\n        logger.info('No broadcasts with status \"sending\" found')\n        return { output: { success: true } }\n      }\n\n      const parsed = safeParseBroadcast(rawBroadcast)\n\n      if (!parsed.success) {\n        logger.error({ errors: parsed.errors }, `Broadcast ${rawBroadcast.id} validation failed`)\n        await payload.update({\n          id: rawBroadcast.id,\n          collection: 'broadcasts',\n          data: { status: 'failed' },\n        })\n        return { output: { success: false } }\n      }\n\n      const broadcast = parsed.data\n      const whereClause = buildContactsWhereClause(\n        broadcast,\n        rawBroadcast as Record<string, unknown>,\n      )\n\n      const { docs: contacts } = await payload.find({\n        collection: 'contacts',\n        limit: BATCH_SIZE,\n        sort: 'id',\n        where: whereClause,\n      })\n\n      if (contacts.length === 0) {\n        logger.info(\n          `Broadcast ${broadcast.id} complete. ` +\n            `Processed: ${broadcast.meta.processedCount}, Expected: ${broadcast.meta.contactsCount}`,\n        )\n        await payload.update({\n          id: broadcast.id,\n          collection: 'broadcasts',\n          data: { status: 'sent' },\n        })\n        return { output: { success: true } }\n      }\n\n      await Promise.all(\n        contacts.map((contact) =>\n          payload.jobs.queue({\n            input: { broadcastId: broadcast.id, contactId: contact.id },\n            queue: 'send-emails',\n            task: 'send-email',\n          }),\n        ),\n      )\n\n      await payload.update({\n        id: broadcast.id,\n        collection: 'broadcasts',\n        data: {\n          meta: {\n            lastProcessedContactId: getLastContactId(contacts[contacts.length - 1]),\n            processedCount: broadcast.meta.processedCount + contacts.length,\n          },\n        },\n      })\n\n      logger.info(\n        `Broadcast ${broadcast.id}: queued ${contacts.length} emails, ` +\n          `total processed: ${broadcast.meta.processedCount + contacts.length}`,\n      )\n\n      return { output: { success: true } }\n    },\n    outputSchema: [\n      {\n        name: 'success',\n        type: 'checkbox',\n      },\n    ],\n    retries: 3,\n    schedule: [\n      {\n        cron: TASK_SCHEDULE,\n        queue: QUEUE_NAME,\n      },\n    ],\n  }\n}\n"],"names":["z","BroadcastSchema","object","id","number","content","any","refine","val","undefined","message","fromAddress","email","fromName","string","min","meta","contactsCount","lastProcessedContactId","default","processedCount","subject","tags","array","optional","to","literal","or","safeParseBroadcast","broadcast","result","safeParse","success","data","errors","flattenError","error","fieldErrors","buildContactsWhereClause","rawBroadcast","conditions","emailOptIn","equals","greater_than","Array","isArray","length","tagIds","map","t","push","in","and","getLastContactId","contact","parseInt","createSendBroadcastsTask","pluginConfig","BATCH_SIZE","broadcastConfig","batchSize","TASK_SCHEDULE","taskSchedule","QUEUE_NAME","broadcastQueueName","slug","handler","req","payload","logger","info","docs","find","collection","limit","sort","where","status","output","parsed","update","whereClause","contacts","Promise","all","jobs","queue","input","broadcastId","contactId","task","outputSchema","name","type","retries","schedule","cron"],"mappings":"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"}

package/dist/tasks/sendEmailTask.d.ts

@@ -0,0 +1,9 @@
+import type { TaskConfig } from 'payload';
+import type { MobilizehubPluginConfig } from '../types/index.js';
+/**
+ * Creates the send-email task configuration.
+ *
+ * Handles delivery of a single email for one contact within a broadcast.
+ * Queued by the send-broadcasts task, one job per contact.
+ */
+export declare const createSendEmailTask: (pluginConfig: MobilizehubPluginConfig) => TaskConfig;