@stacksjs/newsletter 0.72.57 → 0.72.61

package/dist/index.js

@@ -1,2 +1,2 @@
 // @bun
-var C=import.meta.require;import{db as H,sqlDateTime as G}from"@stacksjs/database";import{db as _}from"@stacksjs/database";function y(f){return f.toLowerCase().trim().replace(/[^\w\s-]+/g,"").replace(/\s+/g,"-").replace(/-+/g,"-")}function S(f){return{name:f.name,slug:f.slug??y(f.name),description:f.description??null,status:"active",is_public:f.isPublic===!1?0:1,double_opt_in:f.doubleOptIn===!1?0:1,subscriber_count:0,active_count:0,unsubscribed_count:0,bounced_count:0}}var $={async create(f){let r=S(f);await _.insertInto("email_lists").values(r).execute();let U=await $.find(String(r.slug));if(!U)throw Error(`[newsletter] List '${String(r.slug)}' could not be read back after creation`);return U},async find(f){let r=_.selectFrom("email_lists").selectAll();return typeof f==="number"?await r.where("id","=",f).executeTakeFirst():await r.where("slug","=",f).executeTakeFirst()},async all(){return await _.selectFrom("email_lists").selectAll().where("status","=","active").execute()},async archive(f){let r=await $.find(f);if(!r)throw Error(`[newsletter] List '${String(f)}' not found`);return await _.updateTable("email_lists").set({status:"archived"}).where("id","=",Number(r.id)).execute()}};async function D(f){if(f.emailListId)return f.emailListId;if(f.emailListSlug){let r=await $.find(f.emailListSlug);if(!r)throw Error(`[newsletter] List '${f.emailListSlug}' not found`);return r.id}throw Error("[newsletter] Campaign requires emailListId or emailListSlug")}class q extends Error{constructor(f){super(`[newsletter] Campaign ${f} changed before delivery could be queued`);this.name="CampaignStateConflictError"}}function Z(f,r,U){if(typeof f?.get==="function"){let x=f.get(r);if(x!==void 0)return x;return f.get(U)}return f?.[r]??f?.[U]}function B(f){let r=Z(f,"scheduled_at","scheduledAt"),U=Z(f,"updated_at","updatedAt");return{status:String(Z(f,"status","status")||""),scheduledAt:r===null||r===void 0||r===""?null:String(r),updatedAt:U===null||U===void 0||U===""?null:String(U)}}function k(f,r,U,x){return`newsletter:campaign:${f}:${r}:${x||"now"}:${U}`}function R(f){return["draft","scheduled","paused","failed"].includes(String(f||"").toLowerCase())}function K(f){if(Array.isArray(f))return f.reduce((x,n)=>x+K(n),0);if(typeof f==="number"||typeof f==="bigint")return Number(f);let r=f,U=r?.changes??r?.affectedRows??r?.numAffectedRows??r?.numUpdatedRows;if(typeof U==="object"&&U!==null)return Number(U.changes||0);return Number(U||0)}function v(f,r){return r===null?f.whereNull("scheduled_at"):f.where("scheduled_at","=",r)}function b(f,r){return r===null?f.whereNull("updated_at"):f.where("updated_at","=",r)}async function V(f,r,U){let n=await b(v(H.updateTable("campaigns").set({status:U.status,scheduled_at:U.scheduledAt,updated_at:U.updatedAt}).where("id","=",f).where("status","=",r.status),r.scheduledAt),r.updatedAt).execute();if(K(n)!==1)throw new q(f)}async function A(f,r,U){await v(H.updateTable("campaigns").set({status:U.status,scheduled_at:U.scheduledAt,updated_at:G()}).where("id","=",f).where("status","=",r.status).where("updated_at","=",r.updatedAt),r.scheduledAt).execute()}async function j(f,r,U,x,n,o=0){let{job:w}=await import("@stacksjs/queue"),F=n?"scheduled":"immediate";try{await w("SendCampaign",{campaignId:f,chunkSize:x.chunkSize??50,dryRun:x.dryRun??!1,...n?{scheduledAt:n}:{}}).onQueue("campaigns").delay(o).withIdempotencyKey(k(f,F,r.attemptId,n)).dispatch()}catch(z){try{await A(f,r,U)}catch(Y){throw AggregateError([z,Y],`[newsletter] Campaign ${f} could not be dispatched or restored`)}throw z}}function rf(f,r){if(!r)return!0;if(String(f.status||"")!=="scheduled")return!1;let U=f.scheduled_at??f.scheduledAt,x=new Date(String(U||"")).getTime(),n=new Date(r).getTime();return Number.isFinite(x)&&Number.isFinite(n)&&x===n}function m(f,r){return{name:f.name,description:f.description??null,type:"email",status:f.scheduledAt?"scheduled":"draft",subject:f.subject,template:f.template,text:f.text??null,from_name:f.fromName??null,from_address:f.fromAddress??null,email_list_id:r,scheduled_at:f.scheduledAt??null,sent_count:0}}function g(f,r){let U={};if(f.name!==void 0)U.name=f.name;if(f.description!==void 0)U.description=f.description;if(f.subject!==void 0)U.subject=f.subject;if(f.template!==void 0)U.template=f.template;if(f.text!==void 0)U.text=f.text;if(f.fromName!==void 0)U.from_name=f.fromName;if(f.fromAddress!==void 0)U.from_address=f.fromAddress;if(r!==void 0)U.email_list_id=r;if(f.scheduledAt!==void 0)U.scheduled_at=f.scheduledAt||null,U.status=f.scheduledAt?"scheduled":"draft";return U}var Q={async create(f){let r=await D(f),U=m(f,r),x=crypto.randomUUID();await H.insertInto("campaigns").values({...U,uuid:x}).execute();let n=await H.selectFrom("campaigns").selectAll().where("uuid","=",x).executeTakeFirst();if(!n)throw Error("[newsletter] Campaign could not be read back after creation");return n},async find(f){return await H.selectFrom("campaigns").selectAll().where("id","=",f).executeTakeFirst()},async update(f,r){let U=await Q.find(f);if(!U)throw Error(`[newsletter] Campaign ${f} not found`);if(U.status!=="draft"&&U.status!=="scheduled")throw Error(`[newsletter] Cannot edit campaign in status '${U.status}'`);let n=r.emailListId!==void 0||r.emailListSlug!==void 0?await D(r):void 0;return U.update(g(r,n))},async sendNow(f,r={}){let U=await Q.find(f);if(!U)throw Error(`[newsletter] Campaign ${f} not found`);if(!R(U.status))throw Error(`[newsletter] Campaign ${f} in status '${U.status}' cannot be queued`);let x=B(U),n={status:"sending",scheduledAt:x.scheduledAt,updatedAt:G(),attemptId:crypto.randomUUID()};return await V(f,x,n),await j(f,n,x,r),{ok:!0,campaignId:f}},async schedule(f,r,U={}){let x=await Q.find(f);if(!x)throw Error(`[newsletter] Campaign ${f} not found`);if(!R(x.status))throw Error(`[newsletter] Campaign ${f} in status '${x.status}' cannot be scheduled`);let n=r instanceof Date?r:new Date(r);if(!Number.isFinite(n.getTime()))throw Error("[newsletter] scheduledAt must be a valid date");let o=Math.max(0,Math.floor((n.getTime()-Date.now())/1000)),w=n.toISOString(),F=B(x),z={status:o===0?"sending":"scheduled",scheduledAt:w,updatedAt:G(),attemptId:crypto.randomUUID()};return await V(f,F,z),await j(f,z,F,U,o>0?w:void 0,o),{ok:!0,campaignId:f,scheduledAt:w}},async cancel(f){let r=await Q.find(f);if(!r)throw Error(`[newsletter] Campaign ${f} not found`);if(r.status==="sent")throw Error(`[newsletter] Campaign ${f} already sent. It cannot be cancelled`);let U=B(r),x={status:"cancelled",scheduledAt:U.scheduledAt,updatedAt:G(),attemptId:crypto.randomUUID()};return await V(f,U,x),Q.find(f)}};function h(f){let r=2166136261;for(let U=0;U<f.length;U++)r^=f.charCodeAt(U),r=Math.imul(r,16777619);return r>>>0}function xf(f,r){if(r.length===0)throw Error("At least one delivery variant is required");let U=r.reduce((o,w)=>o+w.allocation,0);if(U<=0)throw Error("Delivery variant allocation must be greater than zero");let x=h(f)%U,n=0;for(let o of r){if(!Number.isFinite(o.allocation)||o.allocation<0)throw Error("Delivery variant allocation must be a non-negative number");if(n+=o.allocation,x<n)return o}return r[r.length-1]}function nf(f){return["delivery",f.teamId,f.campaignId,f.channel,f.recipient.trim().toLowerCase(),f.occurrence||"once"].join(":")}function of(f){let r=f.find((U)=>{if(U.limit===null)return!1;return U.used+(U.requested??1)>U.limit});if(r)throw Error(`Usage limit exceeded for ${r.meter}`)}function wf(f,r=""){let U=r.toLowerCase();if(["suppressed","unsubscribe","complaint","stop"].some((x)=>U.includes(x)))return"suppressed";if(Number(f)===429||U.includes("rate"))return"rate_limited";if(Number(f)>=500||["timeout","temporary","unavailable"].some((x)=>U.includes(x)))return"transient";return"permanent"}function Nf(f){if(!f.url||!/^https?:\/\//i.test(f.url))throw Error("[newsletter] List-Unsubscribe URL must be absolute (http/https)");let r=[];if(f.mailto)r.push(`<mailto:${f.mailto}>`);return r.push(`<${f.url}>`),{"List-Unsubscribe":r.join(", "),"List-Unsubscribe-Post":"List-Unsubscribe=One-Click"}}import{db as N}from"@stacksjs/database";async function l(f){if(f==null){let U=await $.find("default");if(!U)U=await $.create({name:"Default",slug:"default"});return U.id}let r=await $.find(f);if(!r)throw Error(`[newsletter] List '${String(f)}' not found`);return r.id}async function J(f,r={}){if(!f||!f.includes("@"))throw Error("[newsletter] subscribe() requires a valid email address");let U=await l(r.list),x=r.source??"api",n=await N.selectFrom("subscribers").selectAll().where("email","=",f).executeTakeFirst();if(!n)await N.insertInto("subscribers").values({uuid:crypto.randomUUID(),email:f,status:"subscribed",source:x}).execute(),n=await N.selectFrom("subscribers").selectAll().where("email","=",f).executeTakeFirst();let o=await N.selectFrom("email_list_subscribers").selectAll().where("subscriber_id","=",Number(n.id)).where("email_list_id","=",U).executeTakeFirst();if(o){if(o.status==="unsubscribed")await N.updateTable("email_list_subscribers").set({status:"subscribed",unsubscribed_at:null}).where("id","=",Number(o.id)).execute();return{created:!1,email:f,listId:U,token:o.uuid}}let w=crypto.randomUUID();return await N.insertInto("email_list_subscribers").values({uuid:w,subscriber_id:Number(n.id),email_list_id:U,status:"subscribed",source:x}).execute(),{created:!0,email:f,listId:U,token:w}}async function E(f){if(!f)return{ok:!1};let r=await N.selectFrom("email_list_subscribers").selectAll().where("uuid","=",f).executeTakeFirst();if(!r)return{ok:!1};let U=async()=>{return(await N.selectFrom("subscribers").select(["email"]).where("id","=",Number(r.subscriber_id)).executeTakeFirst())?.email};if(r.status==="unsubscribed")return{ok:!0,alreadyUnsubscribed:!0,email:await U(),listId:r.email_list_id};return await N.updateTable("email_list_subscribers").set({status:"unsubscribed",unsubscribed_at:new Date().toISOString()}).where("id","=",Number(r.id)).execute(),{ok:!0,email:await U(),listId:r.email_list_id}}async function T(f){let r=await N.selectFrom("subscribers").select(["id"]).where("email","=",f).executeTakeFirst();if(!r)return 0;let U=await N.selectFrom("email_list_subscribers").select(["id"]).where("subscriber_id","=",Number(r.id)).where("status","=","subscribed").execute();for(let x of U)await N.updateTable("email_list_subscribers").set({status:"unsubscribed",unsubscribed_at:new Date().toISOString()}).where("id","=",Number(x.id)).execute();return U.length}var Jf={lists:$,campaigns:Q,subscribe:J,unsubscribe:E,unsubscribeAll:T};import{db as W}from"@stacksjs/database";function X(f){return Boolean(f)&&f.includes("@")&&!f.startsWith("@")&&!f.endsWith("@")}function u(f,r){if(!X(f))return"skip-invalid";if(r.duplicate)return"skip-duplicate";if(r.suppressed)return"skip-suppressed";if(r.listStatus==="unsubscribed")return"skip-unsubscribed";return r.listStatus==="subscribed"?"existing":"add"}async function Zf(f,r,U={}){let x={added:0,existing:0,unsubscribed:0,suppressed:0,invalid:0,skipped:{unsubscribed:[],suppressed:[],invalid:[]}},n=new Set;for(let o of r){let w=String(o.email??""),F=w.trim().toLowerCase(),z=null;if(X(F)&&!n.has(F)){let M=await W.selectFrom("subscribers").select(["id"]).where("email","=",F).executeTakeFirst();if(M)z=(await W.selectFrom("email_list_subscribers").select(["status"]).where("subscriber_id","=",Number(M.id)).where("email_list_id","=",await c(f)).executeTakeFirst())?.status??null}let Y=u(F,{duplicate:n.has(F),suppressed:X(F)?await e(F):!1,listStatus:z});if(X(F))n.add(F);switch(Y){case"skip-invalid":x.invalid++,x.skipped.invalid.push(w);continue;case"skip-duplicate":continue;case"skip-suppressed":x.suppressed++,x.skipped.suppressed.push(F);continue;case"skip-unsubscribed":x.unsubscribed++,x.skipped.unsubscribed.push(F);continue;case"existing":x.existing++;continue;case"add":break}if((await J(F,{list:f,source:o.source??U.source??"sync",upsert:!0})).created)x.added++;else x.existing++}return x}async function e(f){try{let{isSuppressed:r}=await import("@stacksjs/email");return await r(f)}catch{return!1}}async function c(f){if(typeof f==="number")return f;let r=await W.selectFrom("email_lists").select(["id"]).where("slug","=",f).executeTakeFirst();return Number(r?.id??0)}class P extends Error{code;constructor(f,r){let U={unavailable:`Usage meter unavailable for ${r}`,invalid:`Usage meter state is invalid for ${r}`,exceeded:`Usage limit exceeded for ${r}`,contention:`Usage reservation contention for ${r}`};super(U[f]);this.code=f;this.name="UsageQuotaError"}}function O(f){return Number.isFinite(f)&&f>0}function I(f,r){return f.meter===r&&Number.isFinite(f.used)&&f.used>=0&&(f.limit===null||Number.isFinite(f.limit)&&f.limit>=0)}function L(f){return Number.isInteger(f)&&f>0?f:1}async function Vf(f,r,U=1,x=5){if(!r||!O(U))throw new P("invalid",r||"unknown");for(let n=0;n<L(x);n++){let o=await f.read(r);if(!o)throw new P("unavailable",r);if(!I(o,r))throw new P("invalid",r);let w=o.used+U;if(o.limit!==null&&w>o.limit)throw new P("exceeded",r);if(await f.compareAndSet(o,w))return{meter:r,quantity:U,previousUsed:o.used,used:w,limit:o.limit}}throw new P("contention",r)}async function Mf(f,r,U=5){if(!r.meter||!O(r.quantity))throw new P("invalid",r.meter||"unknown");for(let x=0;x<L(U);x++){let n=await f.read(r.meter);if(!n)throw new P("unavailable",r.meter);if(!I(n,r.meter)||n.used<r.quantity)throw new P("invalid",r.meter);if(await f.compareAndSet(n,n.used-r.quantity))return}throw new P("contention",r.meter)}export{T as unsubscribeAll,E as unsubscribe,Zf as syncListSubscribers,u as syncDecision,J as subscribe,rf as shouldRunScheduledCampaign,Vf as reserveUsage,Mf as releaseUsage,Jf as newsletter,X as looksLikeEmail,$ as lists,S as emailListCreateData,nf as deliveryIdempotencyKey,wf as classifyDeliveryFailure,R as canQueueCampaignStatus,Q as campaigns,g as campaignUpdateData,B as campaignDeliverySnapshot,k as campaignDeliveryDispatchKey,m as campaignCreateData,Nf as buildUnsubscribeHeaders,of as assertUsageAvailable,xf as allocateDeliveryVariant,P as UsageQuotaError,q as CampaignStateConflictError};
+var S=import.meta.require;import{db as b,sqlDateTime as f}from"@stacksjs/database";import{db as p}from"@stacksjs/database";function P(e){return e.toLowerCase().trim().replace(/[^\w\s-]+/g,"").replace(/\s+/g,"-").replace(/-+/g,"-")}function q(e){return{name:e.name,slug:e.slug??P(e.name),description:e.description??null,status:"active",is_public:e.isPublic===!1?0:1,double_opt_in:e.doubleOptIn===!1?0:1,subscriber_count:0,active_count:0,unsubscribed_count:0,bounced_count:0}}var d={async create(e){let t=q(e);await p.insertInto("email_lists").values(t).execute();let n=await d.find(String(t.slug));if(!n)throw Error(`[newsletter] List '${String(t.slug)}' could not be read back after creation`);return n},async find(e){let t=p.selectFrom("email_lists").selectAll();return typeof e==="number"?await t.where("id","=",e).executeTakeFirst():await t.where("slug","=",e).executeTakeFirst()},async all(){return await p.selectFrom("email_lists").selectAll().where("status","=","active").execute()},async archive(e){let t=await d.find(e);if(!t)throw Error(`[newsletter] List '${String(e)}' not found`);return await p.updateTable("email_lists").set({status:"archived"}).where("id","=",Number(t.id)).execute()}};async function k(e){if(e.emailListId)return e.emailListId;if(e.emailListSlug){let t=await d.find(e.emailListSlug);if(!t)throw Error(`[newsletter] List '${e.emailListSlug}' not found`);return t.id}throw Error("[newsletter] Campaign requires emailListId or emailListSlug")}class D extends Error{constructor(e){super(`[newsletter] Campaign ${e} changed before delivery could be queued`);this.name="CampaignStateConflictError"}}function x(e,t,n){if(typeof e?.get==="function"){let r=e.get(t);if(r!==void 0)return r;return e.get(n)}return e?.[t]??e?.[n]}function C(e){let t=x(e,"scheduled_at","scheduledAt"),n=x(e,"updated_at","updatedAt");return{status:String(x(e,"status","status")||""),scheduledAt:t===null||t===void 0||t===""?null:String(t),updatedAt:n===null||n===void 0||n===""?null:String(n)}}function j(e,t,n,r){return`newsletter:campaign:${e}:${t}:${r||"now"}:${n}`}function A(e){return["draft","scheduled","paused","failed"].includes(String(e||"").toLowerCase())}function U(e){if(Array.isArray(e))return e.reduce((r,s)=>r+U(s),0);if(typeof e==="number"||typeof e==="bigint")return Number(e);let t=e,n=t?.changes??t?.affectedRows??t?.numAffectedRows??t?.numUpdatedRows;if(typeof n==="object"&&n!==null)return Number(n.changes||0);return Number(n||0)}function L(e,t){return t===null?e.whereNull("scheduled_at"):e.where("scheduled_at","=",t)}function O(e,t){return t===null?e.whereNull("updated_at"):e.where("updated_at","=",t)}async function v(e,t,n){let s=await O(L(b.updateTable("campaigns").set({status:n.status,scheduled_at:n.scheduledAt,updated_at:n.updatedAt}).where("id","=",e).where("status","=",t.status),t.scheduledAt),t.updatedAt).execute();if(U(s)!==1)throw new D(e)}async function V(e,t,n){await L(b.updateTable("campaigns").set({status:n.status,scheduled_at:n.scheduledAt,updated_at:f()}).where("id","=",e).where("status","=",t.status).where("updated_at","=",t.updatedAt),t.scheduledAt).execute()}async function I(e,t,n,r,s,i=0){let{job:a}=await import("@stacksjs/queue"),u=s?"scheduled":"immediate";try{await a("SendCampaign",{campaignId:e,chunkSize:r.chunkSize??50,dryRun:r.dryRun??!1,...s?{scheduledAt:s}:{}}).onQueue("campaigns").delay(i).withIdempotencyKey(j(e,u,t.attemptId,s)).dispatch()}catch(l){try{await V(e,t,n)}catch(y){throw AggregateError([l,y],`[newsletter] Campaign ${e} could not be dispatched or restored`)}throw l}}function ne(e,t){if(!t)return!0;if(String(e.status||"")!=="scheduled")return!1;let n=e.scheduled_at??e.scheduledAt,r=new Date(String(n||"")).getTime(),s=new Date(t).getTime();return Number.isFinite(r)&&Number.isFinite(s)&&r===s}function Q(e,t){return{name:e.name,description:e.description??null,type:"email",status:e.scheduledAt?"scheduled":"draft",subject:e.subject,template:e.template,text:e.text??null,from_name:e.fromName??null,from_address:e.fromAddress??null,email_list_id:t,scheduled_at:e.scheduledAt??null,sent_count:0}}function W(e,t){let n={};if(e.name!==void 0)n.name=e.name;if(e.description!==void 0)n.description=e.description;if(e.subject!==void 0)n.subject=e.subject;if(e.template!==void 0)n.template=e.template;if(e.text!==void 0)n.text=e.text;if(e.fromName!==void 0)n.from_name=e.fromName;if(e.fromAddress!==void 0)n.from_address=e.fromAddress;if(t!==void 0)n.email_list_id=t;if(e.scheduledAt!==void 0)n.scheduled_at=e.scheduledAt||null,n.status=e.scheduledAt?"scheduled":"draft";return n}var m={async create(e){let t=await k(e),n=Q(e,t),r=crypto.randomUUID();await b.insertInto("campaigns").values({...n,uuid:r}).execute();let s=await b.selectFrom("campaigns").selectAll().where("uuid","=",r).executeTakeFirst();if(!s)throw Error("[newsletter] Campaign could not be read back after creation");return s},async find(e){return await b.selectFrom("campaigns").selectAll().where("id","=",e).executeTakeFirst()},async update(e,t){let n=await m.find(e);if(!n)throw Error(`[newsletter] Campaign ${e} not found`);if(n.status!=="draft"&&n.status!=="scheduled")throw Error(`[newsletter] Cannot edit campaign in status '${n.status}'`);let s=t.emailListId!==void 0||t.emailListSlug!==void 0?await k(t):void 0;return n.update(W(t,s))},async sendNow(e,t={}){let n=await m.find(e);if(!n)throw Error(`[newsletter] Campaign ${e} not found`);if(!A(n.status))throw Error(`[newsletter] Campaign ${e} in status '${n.status}' cannot be queued`);let r=C(n),s={status:"sending",scheduledAt:r.scheduledAt,updatedAt:f(),attemptId:crypto.randomUUID()};return await v(e,r,s),await I(e,s,r,t),{ok:!0,campaignId:e}},async schedule(e,t,n={}){let r=await m.find(e);if(!r)throw Error(`[newsletter] Campaign ${e} not found`);if(!A(r.status))throw Error(`[newsletter] Campaign ${e} in status '${r.status}' cannot be scheduled`);let s=t instanceof Date?t:new Date(t);if(!Number.isFinite(s.getTime()))throw Error("[newsletter] scheduledAt must be a valid date");let i=Math.max(0,Math.floor((s.getTime()-Date.now())/1000)),a=s.toISOString(),u=C(r),l={status:i===0?"sending":"scheduled",scheduledAt:a,updatedAt:f(),attemptId:crypto.randomUUID()};return await v(e,u,l),await I(e,l,u,n,i>0?a:void 0,i),{ok:!0,campaignId:e,scheduledAt:a}},async cancel(e){let t=await m.find(e);if(!t)throw Error(`[newsletter] Campaign ${e} not found`);if(t.status==="sent")throw Error(`[newsletter] Campaign ${e} already sent. It cannot be cancelled`);let n=C(t),r={status:"cancelled",scheduledAt:n.scheduledAt,updatedAt:f(),attemptId:crypto.randomUUID()};return await v(e,n,r),m.find(e)}};function M(e){let t=2166136261;for(let n=0;n<e.length;n++)t^=e.charCodeAt(n),t=Math.imul(t,16777619);return t>>>0}function se(e,t){if(t.length===0)throw Error("At least one delivery variant is required");let n=t.reduce((i,a)=>i+a.allocation,0);if(n<=0)throw Error("Delivery variant allocation must be greater than zero");let r=M(e)%n,s=0;for(let i of t){if(!Number.isFinite(i.allocation)||i.allocation<0)throw Error("Delivery variant allocation must be a non-negative number");if(s+=i.allocation,r<s)return i}return t[t.length-1]}function ie(e){return["delivery",e.teamId,e.campaignId,e.channel,e.recipient.trim().toLowerCase(),e.occurrence||"once"].join(":")}function ae(e){let t=e.find((n)=>{if(n.limit===null)return!1;return n.used+(n.requested??1)>n.limit});if(t)throw Error(`Usage limit exceeded for ${t.meter}`)}function ue(e,t=""){let n=t.toLowerCase();if(["suppressed","unsubscribe","complaint","stop"].some((r)=>n.includes(r)))return"suppressed";if(Number(e)===429||n.includes("rate"))return"rate_limited";if(Number(e)>=500||["timeout","temporary","unavailable"].some((r)=>n.includes(r)))return"transient";return"permanent"}function de(e){if(!e.url||!/^https?:\/\//i.test(e.url))throw Error("[newsletter] List-Unsubscribe URL must be absolute (http/https)");let t=[];if(e.mailto)t.push(`<mailto:${e.mailto}>`);return t.push(`<${e.url}>`),{"List-Unsubscribe":t.join(", "),"List-Unsubscribe-Post":"List-Unsubscribe=One-Click"}}import{db as o}from"@stacksjs/database";async function z(e){if(e==null){let n=await d.find("default");if(!n)n=await d.create({name:"Default",slug:"default"});return n.id}let t=await d.find(e);if(!t)throw Error(`[newsletter] List '${String(e)}' not found`);return t.id}async function g(e,t={}){if(!e||!e.includes("@"))throw Error("[newsletter] subscribe() requires a valid email address");let n=await z(t.list),r=t.source??"api",s=await o.selectFrom("subscribers").selectAll().where("email","=",e).executeTakeFirst();if(!s)await o.insertInto("subscribers").values({uuid:crypto.randomUUID(),email:e,status:"subscribed",source:r}).execute(),s=await o.selectFrom("subscribers").selectAll().where("email","=",e).executeTakeFirst();let i=await o.selectFrom("email_list_subscribers").selectAll().where("subscriber_id","=",Number(s.id)).where("email_list_id","=",n).executeTakeFirst();if(i){if(i.status==="unsubscribed")await o.updateTable("email_list_subscribers").set({status:"subscribed",unsubscribed_at:null}).where("id","=",Number(i.id)).execute();return{created:!1,email:e,listId:n,token:i.uuid}}let a=crypto.randomUUID();return await o.insertInto("email_list_subscribers").values({uuid:a,subscriber_id:Number(s.id),email_list_id:n,status:"subscribed",source:r}).execute(),{created:!0,email:e,listId:n,token:a}}async function R(e){if(!e)return{ok:!1};let t=await o.selectFrom("email_list_subscribers").selectAll().where("uuid","=",e).executeTakeFirst();if(!t)return{ok:!1};let n=async()=>(await o.selectFrom("subscribers").select(["email"]).where("id","=",Number(t.subscriber_id)).executeTakeFirst())?.email;if(t.status==="unsubscribed")return{ok:!0,alreadyUnsubscribed:!0,email:await n(),listId:t.email_list_id};return await o.updateTable("email_list_subscribers").set({status:"unsubscribed",unsubscribed_at:new Date().toISOString()}).where("id","=",Number(t.id)).execute(),{ok:!0,email:await n(),listId:t.email_list_id}}async function F(e){let t=await o.selectFrom("subscribers").select(["id"]).where("email","=",e).executeTakeFirst();if(!t)return 0;let n=await o.selectFrom("email_list_subscribers").select(["id"]).where("subscriber_id","=",Number(t.id)).where("status","=","subscribed").execute();for(let r of n)await o.updateTable("email_list_subscribers").set({status:"unsubscribed",unsubscribed_at:new Date().toISOString()}).where("id","=",Number(r.id)).execute();return n.length}var we={lists:d,campaigns:m,subscribe:g,unsubscribe:R,unsubscribeAll:F};import{db as w}from"@stacksjs/database";function h(e){return Boolean(e)&&e.includes("@")&&!e.startsWith("@")&&!e.endsWith("@")}function H(e,t){if(!h(e))return"skip-invalid";if(t.duplicate)return"skip-duplicate";if(t.suppressed)return"skip-suppressed";if(t.listStatus==="unsubscribed")return"skip-unsubscribed";return t.listStatus==="subscribed"?"existing":"add"}async function Ce(e,t,n={}){let r={added:0,existing:0,unsubscribed:0,suppressed:0,invalid:0,skipped:{unsubscribed:[],suppressed:[],invalid:[]}},s=new Set;for(let i of t){let a=String(i.email??""),u=a.trim().toLowerCase(),l=null;if(h(u)&&!s.has(u)){let _=await w.selectFrom("subscribers").select(["id"]).where("email","=",u).executeTakeFirst();if(_)l=(await w.selectFrom("email_list_subscribers").select(["status"]).where("subscriber_id","=",Number(_.id)).where("email_list_id","=",await K(e)).executeTakeFirst())?.status??null}let y=H(u,{duplicate:s.has(u),suppressed:h(u)?await B(u):!1,listStatus:l});if(h(u))s.add(u);switch(y){case"skip-invalid":r.invalid++,r.skipped.invalid.push(a);continue;case"skip-duplicate":continue;case"skip-suppressed":r.suppressed++,r.skipped.suppressed.push(u);continue;case"skip-unsubscribed":r.unsubscribed++,r.skipped.unsubscribed.push(u);continue;case"existing":r.existing++;continue;case"add":break}if((await g(u,{list:e,source:i.source??n.source??"sync",upsert:!0})).created)r.added++;else r.existing++}return r}async function B(e){try{let{isSuppressed:t}=await import("@stacksjs/email");return await t(e)}catch{return!1}}async function K(e){if(typeof e==="number")return e;let t=await w.selectFrom("email_lists").select(["id"]).where("slug","=",e).executeTakeFirst();return Number(t?.id??0)}class c extends Error{code;constructor(e,t){let n={unavailable:`Usage meter unavailable for ${t}`,invalid:`Usage meter state is invalid for ${t}`,exceeded:`Usage limit exceeded for ${t}`,contention:`Usage reservation contention for ${t}`};super(n[e]);this.code=e;this.name="UsageQuotaError"}}function T(e){return Number.isFinite(e)&&e>0}function E(e,t){return e.meter===t&&Number.isFinite(e.used)&&e.used>=0&&(e.limit===null||Number.isFinite(e.limit)&&e.limit>=0)}function N(e){return Number.isInteger(e)&&e>0?e:1}async function _e(e,t,n=1,r=5){if(!t||!T(n))throw new c("invalid",t||"unknown");for(let s=0;s<N(r);s++){let i=await e.read(t);if(!i)throw new c("unavailable",t);if(!E(i,t))throw new c("invalid",t);let a=i.used+n;if(i.limit!==null&&a>i.limit)throw new c("exceeded",t);if(await e.compareAndSet(i,a))return{meter:t,quantity:n,previousUsed:i.used,used:a,limit:i.limit}}throw new c("contention",t)}async function Se(e,t,n=5){if(!t.meter||!T(t.quantity))throw new c("invalid",t.meter||"unknown");for(let r=0;r<N(n);r++){let s=await e.read(t.meter);if(!s)throw new c("unavailable",t.meter);if(!E(s,t.meter)||s.used<t.quantity)throw new c("invalid",t.meter);if(await e.compareAndSet(s,s.used-t.quantity))return}throw new c("contention",t.meter)}export{D as CampaignStateConflictError,c as UsageQuotaError,se as allocateDeliveryVariant,ae as assertUsageAvailable,de as buildUnsubscribeHeaders,Q as campaignCreateData,j as campaignDeliveryDispatchKey,C as campaignDeliverySnapshot,W as campaignUpdateData,m as campaigns,A as canQueueCampaignStatus,ue as classifyDeliveryFailure,ie as deliveryIdempotencyKey,q as emailListCreateData,d as lists,h as looksLikeEmail,we as newsletter,Se as releaseUsage,_e as reserveUsage,ne as shouldRunScheduledCampaign,g as subscribe,H as syncDecision,Ce as syncListSubscribers,R as unsubscribe,F as unsubscribeAll};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/newsletter",
   "type": "module",
   "sideEffects": false,
-  "version": "0.72.57",
+  "version": "0.72.61",
   "description": "Promotional email & newsletter primitives for Stacks. Lists, campaigns, subscribers, and one-click unsubscribe — sent through @stacksjs/email.",
   "author": "Chris Breuer",
   "contributors": [
@@ -61,15 +61,15 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/database": "0.72.57",
-    "@stacksjs/orm": "0.72.57",
-    "@stacksjs/queue": "0.72.57"
+    "@stacksjs/database": "0.72.61",
+    "@stacksjs/orm": "0.72.61",
+    "@stacksjs/queue": "0.72.61"
   },
   "devDependencies": {
-    "@stacksjs/cli": "0.72.57",
-    "@stacksjs/config": "0.72.57",
+    "@stacksjs/cli": "0.72.61",
+    "@stacksjs/config": "0.72.61",
     "better-dx": "^0.2.24",
-    "@stacksjs/error-handling": "0.72.57",
-    "@stacksjs/types": "0.72.57"
+    "@stacksjs/error-handling": "0.72.61",
+    "@stacksjs/types": "0.72.61"
   }
 }