@stacksjs/newsletter 0.72.12 → 0.72.14

package/dist/index.d.ts

@@ -2,7 +2,6 @@ export * from './campaigns';
 export * from './delivery';
 export * from './headers';
 export * from './lists';
-export * from './models';
 export * from './newsletter';
 export * from './subscriptions';
 export * from './sync';

package/dist/index.js

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

package/dist/models.d.ts

@@ -1,32 +0,0 @@
-/**
- * The live model called `name`.
- *
- * Throws with the model's name rather than letting `undefined.where` surface
- * three frames later: a missing model almost always means the feature's
- * models were never published into the app (`buddy marketing:install`), and
- * the message should say which one is missing.
- */
-export declare function model(name: string): Promise<QueryableModel>;
-/**
- * Getting at the models, in both the places this package runs.
- *
- * Every function here used to open with
- * `const { EmailList } = await import('@stacksjs/orm')`. That works inside the
- * framework repo, where the ORM package exports generated models complete with
- * their query statics.
- *
- * It does NOT work in an installed app. There, the live models are the
- * auto-import globals the preloader wires up, and the package's named export
- * is a bare definition with no `.where()` on it - so every call in this file
- * failed with "EmailList.where is not a function", and the whole package was
- * unusable in exactly the apps it exists for.
- *
- * `model()` asks for the live one first and falls back to the package export,
- * so the same code works in the framework, in an app, and in a test.
- */
-export declare interface QueryableModel {
-  find: (id: number) => Promise<any>
-  where: (...args: any[]) => any
-  create: (data: Record<string, unknown>) => Promise<any>
-  [key: string]: any
-}