@stacksjs/newsletter 0.72.11 → 0.72.13

package/dist/index.js

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

package/dist/lists.d.ts

@@ -1,6 +1,15 @@
 import type { CreateListInput } from './types';
 export declare function emailListCreateData(input: CreateListInput): Record<string, string | number | null>;
 /**
+ * Data access goes through `db`, not the generated model statics.
+ *
+ * The statics only exist where the ORM globals have been wired - the
+ * framework repo, and an app whose auto-import manifest happens to list the
+ * model. An installed app that publishes the marketing models still has to
+ * regenerate that manifest before `EmailList.where()` exists, so a package
+ * built on the statics fails in the very place it is meant to run.
+ * `@stacksjs/cms`, `@stacksjs/forms` and `@stacksjs/sites` all query through
+ * `db` for this reason; this package now does too.
  * @defaultValue
  * ```ts
  * {

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/newsletter",
   "type": "module",
   "sideEffects": false,
-  "version": "0.72.11",
+  "version": "0.72.13",
   "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.11",
-    "@stacksjs/orm": "0.72.11",
-    "@stacksjs/queue": "0.72.11"
+    "@stacksjs/database": "0.72.13",
+    "@stacksjs/orm": "0.72.13",
+    "@stacksjs/queue": "0.72.13"
   },
   "devDependencies": {
-    "@stacksjs/cli": "0.72.11",
-    "@stacksjs/config": "0.72.11",
+    "@stacksjs/cli": "0.72.13",
+    "@stacksjs/config": "0.72.13",
     "better-dx": "^0.2.23",
-    "@stacksjs/error-handling": "0.72.11",
-    "@stacksjs/types": "0.72.11"
+    "@stacksjs/error-handling": "0.72.13",
+    "@stacksjs/types": "0.72.13"
   }
 }