@stacksjs/newsletter 0.70.229 → 0.70.230

package/dist/campaigns.d.ts

@@ -1,3 +1,4 @@
+import type { CreateCampaignInput } from './types';
 /**
  * Campaign CRUD + dispatch.
  *
@@ -9,6 +10,9 @@
  * through identical machinery.
  */
 declare function resolveListId(input: CreateCampaignInput): Promise<number>;
+export declare function shouldRunScheduledCampaign(campaign: ScheduledCampaignState, expectedScheduledAt?: string): boolean;
+export declare function campaignCreateData(input: CreateCampaignInput, emailListId: number): Record<string, CampaignWriteValue>;
+export declare function campaignUpdateData(patch: Partial<CreateCampaignInput>, emailListId?: number): Record<string, CampaignWriteValue>;
 /**
  * @defaultValue
  * ```ts
@@ -35,3 +39,9 @@ export declare const campaigns: {
   schedule: (id: number, scheduledAt: Date | string, options?: SendCampaignOptions) => Promise<void>;
   cancel: (id: number) => Promise<void>
 };
+declare interface ScheduledCampaignState {
+  status?: unknown
+  scheduled_at?: unknown
+  scheduledAt?: unknown
+}
+declare type CampaignWriteValue = string | number | null;

package/dist/index.js

@@ -1,2 +1,2 @@
 // @bun
-var H=import.meta.require;function B(x){return x.toLowerCase().trim().replace(/[^\w\s-]+/g,"").replace(/\s+/g,"-").replace(/-+/g,"-")}var J={async create(x){let{EmailList:z}=await import("@stacksjs/orm"),D=x.slug??B(x.name);return z.create({name:x.name,slug:D,description:x.description??null,status:"active",isPublic:x.isPublic===!1?0:1,doubleOptIn:x.doubleOptIn===!1?0:1,subscriberCount:0,activeCount:0,unsubscribedCount:0,bouncedCount:0})},async find(x){let{EmailList:z}=await import("@stacksjs/orm");if(typeof x==="number")return z.find(x);return z.where("slug",x).first()},async all(){let{EmailList:x}=await import("@stacksjs/orm");return x.where("status","active").get()},async archive(x){let z=await J.find(x);if(!z)throw Error(`[newsletter] List '${String(x)}' not found`);return z.update({status:"archived"})}};async function K(x){if(x.emailListId)return x.emailListId;if(x.emailListSlug){let z=await J.find(x.emailListSlug);if(!z)throw Error(`[newsletter] List '${x.emailListSlug}' not found`);return z.id}throw Error("[newsletter] Campaign requires emailListId or emailListSlug")}var V={async create(x){let{Campaign:z}=await import("@stacksjs/orm"),D=await K(x),F=x.scheduledAt?"scheduled":"draft";return z.create({name:x.name,description:x.description??null,type:"email",status:F,subject:x.subject,template:x.template,text:x.text??null,from_name:x.fromName??null,from_address:x.fromAddress??null,email_list_id:D,scheduled_at:x.scheduledAt??null,sentCount:0})},async find(x){let{Campaign:z}=await import("@stacksjs/orm");return z.find(x)},async update(x,z){let D=await V.find(x);if(!D)throw Error(`[newsletter] Campaign ${x} not found`);if(D.status!=="draft"&&D.status!=="scheduled")throw Error(`[newsletter] Cannot edit campaign in status '${D.status}'`);return D.update(z)},async sendNow(x,z={}){let D=await V.find(x);if(!D)throw Error(`[newsletter] Campaign ${x} not found`);if(D.status==="sending"||D.status==="sent")throw Error(`[newsletter] Campaign ${x} already ${D.status}`);await D.update({status:"sending"});let{job:F}=await import("@stacksjs/queue");return await F("SendCampaign",{campaignId:x,chunkSize:z.chunkSize??50,dryRun:z.dryRun??!1}).onQueue("campaigns").dispatch(),{ok:!0,campaignId:x}},async schedule(x,z,D={}){let F=await V.find(x);if(!F)throw Error(`[newsletter] Campaign ${x} not found`);let G=z instanceof Date?z:new Date(z),M=Math.max(0,Math.floor((G.getTime()-Date.now())/1000));await F.update({status:M===0?"sending":"scheduled",scheduled_at:G.toISOString()});let{job:Q}=await import("@stacksjs/queue");return await Q("SendCampaign",{campaignId:x,chunkSize:D.chunkSize??50,dryRun:D.dryRun??!1}).onQueue("campaigns").delay(M).dispatch(),{ok:!0,campaignId:x,scheduledAt:G.toISOString()}},async cancel(x){let z=await V.find(x);if(!z)throw Error(`[newsletter] Campaign ${x} not found`);if(z.status==="sent")throw Error(`[newsletter] Campaign ${x} already sent \u2014 cannot cancel`);return z.update({status:"cancelled"})}};function U(x){if(!x.url||!/^https?:\/\//i.test(x.url))throw Error("[newsletter] List-Unsubscribe URL must be absolute (http/https)");let z=[];if(x.mailto)z.push(`<mailto:${x.mailto}>`);return z.push(`<${x.url}>`),{"List-Unsubscribe":z.join(", "),"List-Unsubscribe-Post":"List-Unsubscribe=One-Click"}}async function P(x){if(x==null){let D=await J.find("default");if(!D)D=await J.create({name:"Default",slug:"default"});return D.id}let z=await J.find(x);if(!z)throw Error(`[newsletter] List '${String(x)}' not found`);return z.id}async function X(x,z={}){if(!x||!x.includes("@"))throw Error("[newsletter] subscribe() requires a valid email address");let{Subscriber:D,EmailListSubscriber:F}=await import("@stacksjs/orm"),G=await P(z.list),M=z.source??"api",Q=await D.where("email",x).first();if(!Q)Q=await D.create({email:x,status:"subscribed",source:M});let W=await F.where("subscriber_id",Q.id).where("email_list_id",G).first();if(W){if(W.status==="unsubscribed")await W.update({status:"subscribed",unsubscribed_at:null});return{created:!1,email:x,listId:G,token:W.uuid}}let $=await F.create({subscriber_id:Q.id,email_list_id:G,status:"subscribed",source:M});return{created:!0,email:x,listId:G,token:$.uuid}}async function Y(x){if(!x)return{ok:!1};let{EmailListSubscriber:z,Subscriber:D}=await import("@stacksjs/orm"),F=await z.where("uuid",x).first();if(!F)return{ok:!1};if(F.status==="unsubscribed")return{ok:!0,alreadyUnsubscribed:!0,email:(await D.find(F.subscriber_id))?.email,listId:F.email_list_id};return await F.update({status:"unsubscribed",unsubscribed_at:new Date().toISOString()}),{ok:!0,email:(await D.find(F.subscriber_id))?.email,listId:F.email_list_id}}async function Z(x){let{Subscriber:z,EmailListSubscriber:D}=await import("@stacksjs/orm"),F=await z.where("email",x).first();if(!F)return 0;let G=await D.where("subscriber_id",F.id).where("status","subscribed").get();for(let M of G)await M.update({status:"unsubscribed",unsubscribed_at:new Date().toISOString()});return G.length}var I={lists:J,campaigns:V,subscribe:X,unsubscribe:Y,unsubscribeAll:Z};export{Z as unsubscribeAll,Y as unsubscribe,X as subscribe,I as newsletter,J as lists,V as campaigns,U as buildUnsubscribeHeaders};
+var M=import.meta.require;function _(z){return z.toLowerCase().trim().replace(/[^\w\s-]+/g,"").replace(/\s+/g,"-").replace(/-+/g,"-")}function q(z){return{name:z.name,slug:z.slug??_(z.name),description:z.description??null,status:"active",is_public:z.isPublic===!1?0:1,double_opt_in:z.doubleOptIn===!1?0:1,subscriber_count:0,active_count:0,unsubscribed_count:0,bounced_count:0}}var V={async create(z){let{EmailList:F}=await import("@stacksjs/orm");return F.create(q(z))},async find(z){let{EmailList:F}=await import("@stacksjs/orm");if(typeof z==="number")return F.find(z);return F.where("slug",z).first()},async all(){let{EmailList:z}=await import("@stacksjs/orm");return z.where("status","active").get()},async archive(z){let F=await V.find(z);if(!F)throw Error(`[newsletter] List '${String(z)}' not found`);return F.update({status:"archived"})}};async function Z(z){if(z.emailListId)return z.emailListId;if(z.emailListSlug){let F=await V.find(z.emailListSlug);if(!F)throw Error(`[newsletter] List '${z.emailListSlug}' not found`);return F.id}throw Error("[newsletter] Campaign requires emailListId or emailListSlug")}function w(z,F){if(!F)return!0;if(String(z.status||"")!=="scheduled")return!1;let G=z.scheduled_at??z.scheduledAt,H=new Date(String(G||"")).getTime(),J=new Date(F).getTime();return Number.isFinite(H)&&Number.isFinite(J)&&H===J}function N(z,F){return{name:z.name,description:z.description??null,type:"email",status:z.scheduledAt?"scheduled":"draft",subject:z.subject,template:z.template,text:z.text??null,from_name:z.fromName??null,from_address:z.fromAddress??null,email_list_id:F,scheduled_at:z.scheduledAt??null,sent_count:0}}function D(z,F){let G={};if(z.name!==void 0)G.name=z.name;if(z.description!==void 0)G.description=z.description;if(z.subject!==void 0)G.subject=z.subject;if(z.template!==void 0)G.template=z.template;if(z.text!==void 0)G.text=z.text;if(z.fromName!==void 0)G.from_name=z.fromName;if(z.fromAddress!==void 0)G.from_address=z.fromAddress;if(F!==void 0)G.email_list_id=F;if(z.scheduledAt!==void 0)G.scheduled_at=z.scheduledAt||null,G.status=z.scheduledAt?"scheduled":"draft";return G}var Y={async create(z){let{Campaign:F}=await import("@stacksjs/orm"),G=await Z(z);return F.create(N(z,G))},async find(z){let{Campaign:F}=await import("@stacksjs/orm");return F.find(z)},async update(z,F){let G=await Y.find(z);if(!G)throw Error(`[newsletter] Campaign ${z} not found`);if(G.status!=="draft"&&G.status!=="scheduled")throw Error(`[newsletter] Cannot edit campaign in status '${G.status}'`);let J=F.emailListId!==void 0||F.emailListSlug!==void 0?await Z(F):void 0;return G.update(D(F,J))},async sendNow(z,F={}){let G=await Y.find(z);if(!G)throw Error(`[newsletter] Campaign ${z} not found`);if(G.status==="sending"||G.status==="sent")throw Error(`[newsletter] Campaign ${z} already ${G.status}`);await G.update({status:"sending"});let{job:H}=await import("@stacksjs/queue");return await H("SendCampaign",{campaignId:z,chunkSize:F.chunkSize??50,dryRun:F.dryRun??!1}).onQueue("campaigns").dispatch(),{ok:!0,campaignId:z}},async schedule(z,F,G={}){let H=await Y.find(z);if(!H)throw Error(`[newsletter] Campaign ${z} not found`);let J=F instanceof Date?F:new Date(F);if(!Number.isFinite(J.getTime()))throw Error("[newsletter] scheduledAt must be a valid date");let Q=Math.max(0,Math.floor((J.getTime()-Date.now())/1000)),W=J.toISOString();await H.update({status:Q===0?"sending":"scheduled",scheduled_at:W});let{job:X}=await import("@stacksjs/queue");return await X("SendCampaign",{campaignId:z,chunkSize:G.chunkSize??50,dryRun:G.dryRun??!1,...Q>0?{scheduledAt:W}:{}}).onQueue("campaigns").delay(Q).dispatch(),{ok:!0,campaignId:z,scheduledAt:W}},async cancel(z){let F=await Y.find(z);if(!F)throw Error(`[newsletter] Campaign ${z} not found`);if(F.status==="sent")throw Error(`[newsletter] Campaign ${z} already sent \u2014 cannot cancel`);return F.update({status:"cancelled"})}};function f(z){if(!z.url||!/^https?:\/\//i.test(z.url))throw Error("[newsletter] List-Unsubscribe URL must be absolute (http/https)");let F=[];if(z.mailto)F.push(`<mailto:${z.mailto}>`);return F.push(`<${z.url}>`),{"List-Unsubscribe":F.join(", "),"List-Unsubscribe-Post":"List-Unsubscribe=One-Click"}}async function U(z){if(z==null){let G=await V.find("default");if(!G)G=await V.create({name:"Default",slug:"default"});return G.id}let F=await V.find(z);if(!F)throw Error(`[newsletter] List '${String(z)}' not found`);return F.id}async function $(z,F={}){if(!z||!z.includes("@"))throw Error("[newsletter] subscribe() requires a valid email address");let{Subscriber:G,EmailListSubscriber:H}=await import("@stacksjs/orm"),J=await U(F.list),Q=F.source??"api",W=await G.where("email",z).first();if(!W)W=await G.create({email:z,status:"subscribed",source:Q});let X=await H.where("subscriber_id",W.id).where("email_list_id",J).first();if(X){if(X.status==="unsubscribed")await X.update({status:"subscribed",unsubscribed_at:null});return{created:!1,email:z,listId:J,token:X.uuid}}let P=await H.create({subscriber_id:W.id,email_list_id:J,status:"subscribed",source:Q});return{created:!0,email:z,listId:J,token:P.uuid}}async function B(z){if(!z)return{ok:!1};let{EmailListSubscriber:F,Subscriber:G}=await import("@stacksjs/orm"),H=await F.where("uuid",z).first();if(!H)return{ok:!1};if(H.status==="unsubscribed")return{ok:!0,alreadyUnsubscribed:!0,email:(await G.find(H.subscriber_id))?.email,listId:H.email_list_id};return await H.update({status:"unsubscribed",unsubscribed_at:new Date().toISOString()}),{ok:!0,email:(await G.find(H.subscriber_id))?.email,listId:H.email_list_id}}async function K(z){let{Subscriber:F,EmailListSubscriber:G}=await import("@stacksjs/orm"),H=await F.where("email",z).first();if(!H)return 0;let J=await G.where("subscriber_id",H.id).where("status","subscribed").get();for(let Q of J)await Q.update({status:"unsubscribed",unsubscribed_at:new Date().toISOString()});return J.length}var k={lists:V,campaigns:Y,subscribe:$,unsubscribe:B,unsubscribeAll:K};export{K as unsubscribeAll,B as unsubscribe,$ as subscribe,w as shouldRunScheduledCampaign,k as newsletter,V as lists,q as emailListCreateData,Y as campaigns,D as campaignUpdateData,N as campaignCreateData,f as buildUnsubscribeHeaders};

package/dist/lists.d.ts

@@ -1,11 +1,5 @@
-/**
- * EmailList CRUD wrapper.
- *
- * The model lives in `defaults/app/Models/EmailList.ts`; here we expose
- * a friendlier surface for application code so callers don't depend on
- * raw ORM idioms (which changes across releases).
- */
-declare function slugify(input: string): string;
+import type { CreateListInput } from './types';
+export declare function emailListCreateData(input: CreateListInput): Record<string, string | number | null>;
 /**
  * @defaultValue
  * ```ts

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/newsletter",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.229",
+  "version": "0.70.230",
   "description": "Promotional email & newsletter primitives for Stacks. Lists, campaigns, subscribers, and one-click unsubscribe — sent through @stacksjs/email.",
   "author": "Chris Breuer",
   "contributors": [
@@ -56,10 +56,10 @@
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {
-    "@stacksjs/cli": "0.70.229",
-    "@stacksjs/config": "0.70.229",
+    "@stacksjs/cli": "0.70.230",
+    "@stacksjs/config": "0.70.230",
     "better-dx": "^0.2.17",
-    "@stacksjs/error-handling": "0.70.229",
-    "@stacksjs/types": "0.70.229"
+    "@stacksjs/error-handling": "0.70.230",
+    "@stacksjs/types": "0.70.230"
   }
 }