@drawbridge/drawbridge-utils 0.0.104 → 0.0.105

package/dist/pricing.cjs

@@ -43,6 +43,7 @@ __export(pricing_exports, {
   plans: () => plans,
   resolvePlan: () => resolvePlan,
   scrape: () => scrape,
+  sending: () => sending,
   unitAmountDecimal: () => unitAmountDecimal
 });
 module.exports = __toCommonJS(pricing_exports);
@@ -774,6 +775,17 @@ var scrape = {
 };
 
 // lib/pricing.js
+var sending = {
+  email: {
+    // Fraction of monthlyCeiling that raises the alarm. Far enough ahead of
+    // the wall to act on, high enough not to fire on ordinary growth.
+    alertThreshold: 0.8,
+    // SendGrid Essentials 50K — emails per calendar month, PLATFORM-WIDE and
+    // across every send path: lead-facing mail, workflow steps, and the sign-in
+    // codes and account mail that no plan allowance meters.
+    monthlyCeiling: 5e4
+  }
+};
 var channels = {
   email: {
     actionsPerSend: 1,
@@ -803,5 +815,6 @@ var channels = {
   plans,
   resolvePlan,
   scrape,
+  sending,
   unitAmountDecimal
 });

package/dist/pricing.d.cts

@@ -36,6 +36,11 @@ import '@drawbridge/drawbridge-telemetry';
 //   channels.sms.actionsPerSegment     ACTIONS per SMS segment.
 //   channels.*.includedInAllowance     whether the plan's included actions cover it.
 //
+// ─── Provider capacity (owned here) ───────────────────────────────────────────
+//   sending.email.monthlyCeiling   EMAILS per calendar month we have BOUGHT,
+//                                  platform-wide across every send path.
+//   sending.email.alertThreshold   FRACTION of that ceiling which alarms.
+//
 // ─── Scrape + AI (lib/billing.js) ─────────────────────────────────────────────
 //   MARKUP                 MULTIPLIER on provider cost (1.3 = 30% margin).
 //   STANDARD_RATE_PER_GB   DOLLARS per GB, BrightData Scraping Browser.
@@ -53,6 +58,40 @@ import '@drawbridge/drawbridge-telemetry';
 // consumer of this file.
 
 
+// What we have BOUGHT from the sending providers, against what the plans above
+// SELL. Here rather than in an env because it is a rate like every other number
+// in this file, and the whole point of this file is that you do not have to
+// know which environment to look in to find one. Changing it is a publish and a
+// pin bump, which is the right friction for a number that changes when a
+// contract changes.
+//
+// READ THIS BEFORE RAISING A PLAN ALLOWANCE. The ceiling is PLATFORM-WIDE while
+// every allowance above is PER ORGANIZATION, and an allowance can be spent
+// entirely on email — so the two are denominated against very different things:
+//
+//   Elite    100,000 = 200% of the whole platform's email ceiling
+//   Premium   40,000 =  80%
+//   Pro       15,000 =  30%
+//   Starter    5,000 =  10%
+//
+// As of 2026-08-30 we sell about 2x the email we buy. That is fine while real
+// usage sits far below the allowances, and it is not a margin problem — at this
+// ceiling an email costs a fraction of a cent, far under the 1.5-2.5c overage.
+// It is a CAPACITY problem: running out does not cost a few dollars, it stops
+// every merchant's mail at once. Raising a tier's allowance moves this number
+// too, or the ceiling quietly becomes the real limit.
+const sending = {
+	email : {
+		// Fraction of monthlyCeiling that raises the alarm. Far enough ahead of
+		// the wall to act on, high enough not to fire on ordinary growth.
+		alertThreshold : 0.8,
+		// SendGrid Essentials 50K — emails per calendar month, PLATFORM-WIDE and
+		// across every send path: lead-facing mail, workflow steps, and the sign-in
+		// codes and account mail that no plan allowance meters.
+		monthlyCeiling : 50000
+	}
+};
+
 // Weighted actions: what one message of each channel costs against a plan.
 // Named per unit so a bare `2` can never be read as cents.
 const channels = {
@@ -69,4 +108,4 @@ const channels = {
 	}
 };
 
-export { channels };
+export { channels, sending };

package/dist/pricing.d.ts

@@ -36,6 +36,11 @@ import '@drawbridge/drawbridge-telemetry';
 //   channels.sms.actionsPerSegment     ACTIONS per SMS segment.
 //   channels.*.includedInAllowance     whether the plan's included actions cover it.
 //
+// ─── Provider capacity (owned here) ───────────────────────────────────────────
+//   sending.email.monthlyCeiling   EMAILS per calendar month we have BOUGHT,
+//                                  platform-wide across every send path.
+//   sending.email.alertThreshold   FRACTION of that ceiling which alarms.
+//
 // ─── Scrape + AI (lib/billing.js) ─────────────────────────────────────────────
 //   MARKUP                 MULTIPLIER on provider cost (1.3 = 30% margin).
 //   STANDARD_RATE_PER_GB   DOLLARS per GB, BrightData Scraping Browser.
@@ -53,6 +58,40 @@ import '@drawbridge/drawbridge-telemetry';
 // consumer of this file.
 
 
+// What we have BOUGHT from the sending providers, against what the plans above
+// SELL. Here rather than in an env because it is a rate like every other number
+// in this file, and the whole point of this file is that you do not have to
+// know which environment to look in to find one. Changing it is a publish and a
+// pin bump, which is the right friction for a number that changes when a
+// contract changes.
+//
+// READ THIS BEFORE RAISING A PLAN ALLOWANCE. The ceiling is PLATFORM-WIDE while
+// every allowance above is PER ORGANIZATION, and an allowance can be spent
+// entirely on email — so the two are denominated against very different things:
+//
+//   Elite    100,000 = 200% of the whole platform's email ceiling
+//   Premium   40,000 =  80%
+//   Pro       15,000 =  30%
+//   Starter    5,000 =  10%
+//
+// As of 2026-08-30 we sell about 2x the email we buy. That is fine while real
+// usage sits far below the allowances, and it is not a margin problem — at this
+// ceiling an email costs a fraction of a cent, far under the 1.5-2.5c overage.
+// It is a CAPACITY problem: running out does not cost a few dollars, it stops
+// every merchant's mail at once. Raising a tier's allowance moves this number
+// too, or the ceiling quietly becomes the real limit.
+const sending = {
+	email : {
+		// Fraction of monthlyCeiling that raises the alarm. Far enough ahead of
+		// the wall to act on, high enough not to fire on ordinary growth.
+		alertThreshold : 0.8,
+		// SendGrid Essentials 50K — emails per calendar month, PLATFORM-WIDE and
+		// across every send path: lead-facing mail, workflow steps, and the sign-in
+		// codes and account mail that no plan allowance meters.
+		monthlyCeiling : 50000
+	}
+};
+
 // Weighted actions: what one message of each channel costs against a plan.
 // Named per unit so a bare `2` can never be read as cents.
 const channels = {
@@ -69,4 +108,4 @@ const channels = {
 	}
 };
 
-export { channels };
+export { channels, sending };

package/dist/pricing.js

@@ -725,6 +725,17 @@ var scrape = {
 };
 
 // lib/pricing.js
+var sending = {
+  email: {
+    // Fraction of monthlyCeiling that raises the alarm. Far enough ahead of
+    // the wall to act on, high enough not to fire on ordinary growth.
+    alertThreshold: 0.8,
+    // SendGrid Essentials 50K — emails per calendar month, PLATFORM-WIDE and
+    // across every send path: lead-facing mail, workflow steps, and the sign-in
+    // codes and account mail that no plan allowance meters.
+    monthlyCeiling: 5e4
+  }
+};
 var channels = {
   email: {
     actionsPerSend: 1,
@@ -753,5 +764,6 @@ export {
   plans,
   resolvePlan,
   scrape,
+  sending,
   unitAmountDecimal
 };

package/package.json

@@ -190,5 +190,5 @@
     "test": ". \"$HOME/.nvm/nvm.sh\" && nvm use && node --test"
   },
   "types": "dist/index.d.ts",
-  "version": "0.0.104"
+  "version": "0.0.105"
 }