@drawbridge/drawbridge-utils 0.0.105 → 0.0.107

package/dist/pricing.d.ts

@@ -74,21 +74,102 @@ import '@drawbridge/drawbridge-telemetry';
 //   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.
+// As of 2026-08-30 we sell about 2x the email we buy, against real usage of
+// ~622 sends a month — so this is a shape to watch, not a fire.
+//
+// Exceeding the included volume does NOT stop sends. The provider bills
+// overage per email (see overageCents), so the consequence is a bill and the
+// question is only ever "is the next plan up cheaper than the overage yet".
+// Both halves stay comfortable: at 0.133c of overage against 1.5-2.5c of
+// action overage, email we send past the plan still earns more than ten times
+// what it costs.
+//
+// Raising a tier's allowance should still move the plan below, or the included
+// volume quietly becomes the number that decides the bill.
+// The provider's plan ladder, so the ceiling is DERIVED from which plan we are
+// on rather than being a loose number somebody has to remember to change. Read
+// from the SendGrid Email API Plans page 2026-08-30.
+//
+//   included       EMAILS per calendar month before overage starts.
+//   overageCents   CENTS per additional email. $0.00133 is 0.133 CENTS — the
+//                  decimal is the whole reason this is not stored in dollars.
+//   monthly        CENTS per month for the plan itself.
+//
+// Pro is not "cheaper email" — Pro 100K costs more per overage email than
+// Essentials 100K. What Pro buys is a dedicated IP, subusers, regional data
+// residency, and link branding. Move for those, not for the rate.
+const emailPlans = {
+	essentials50k : {
+		included : 50000,
+		// The plan's own price is not shown in the console once you are on it —
+		// it reads "Your Current Plan" where the price would be. Left null rather
+		// than guessed; fill from an invoice. Nothing derives from it yet, and an
+		// invented figure would quietly become the basis of an upgrade decision.
+		monthly : null,
+		overageCents : 0.133,
+		title : 'Essentials 50K'
+	},
+	essentials100k : {
+		included : 100000,
+		monthly : 3495,
+		overageCents : 0.09,
+		title : 'Essentials 100K'
+	},
+	pro100k : {
+		included : 100000,
+		monthly : 8995,
+		overageCents : 0.11,
+		title : 'Pro 100K'
+	},
+	pro300k : {
+		included : 300000,
+		monthly : 24900,
+		overageCents : 0.091,
+		title : 'Pro 300K'
+	},
+	pro700k : {
+		included : 700000,
+		monthly : 49900,
+		overageCents : 0.078,
+		title : 'Pro 700K'
+	},
+	pro1500k : {
+		included : 1500000,
+		monthly : 79900,
+		overageCents : 0.059,
+		title : 'Pro 1.5 Million'
+	},
+	pro2500k : {
+		included : 2500000,
+		monthly : 109900,
+		overageCents : 0.047,
+		title : 'Pro 2.5 Million'
+	}
+};
+
+// THE ONE FIELD TO CHANGE when the provider plan changes. Everything else here
+// follows from it.
+const emailPlan = 'essentials50k';
+
 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.
+		// Fraction of the included volume that raises the alarm. Far enough ahead
+		// to act on, high enough not to fire on ordinary growth.
+		//
+		// Crossing it is NOT an outage. The provider bills overage rather than
+		// stopping sends, so the alarm is a COST signal: past the included volume
+		// every email is charged at overageCents, and at some run rate the next
+		// plan up is cheaper than the overage. That is the decision it exists to
+		// prompt, and it is why nobody should be woken by it.
 		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
+		// Emails per calendar month included, 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 : emailPlans[ emailPlan ].included,
+		overageCents : emailPlans[ emailPlan ].overageCents,
+		plan : emailPlan,
+		plans : emailPlans,
+		title : emailPlans[ emailPlan ].title
 	}
 };
 

package/dist/pricing.js

@@ -71,11 +71,6 @@ var connection = {
     error: "Plan does not include Mailchimp connection",
     feature: "Mailchimp connection"
   },
-  sender: {
-    key: "organization:connection:sender",
-    error: "Plan does not include a verified sending domain",
-    feature: "Sending domain connection"
-  },
   sendgrid: {
     key: "organization:connection:sendgrid",
     error: "Plan does not include SendGrid connection",
@@ -118,6 +113,19 @@ var organization = {
     error: "Your plan does not include brands",
     feature: "Organization brands management"
   },
+  // Gates the Networking section as a whole — a verified sending domain today,
+  // the SMS number and a custom page domain as they land. One key rather than
+  // one per type: they are the same capability to a merchant, and splitting
+  // them would mean a plan could grant half a section.
+  //
+  // It replaces `connection.sender`, which named a connection this stopped
+  // being. Free organizations cannot send lead-facing email at all, so a
+  // sending identity there is one they could never send from.
+  networking: {
+    key: "organization:networking",
+    error: "Your plan does not include a custom sending identity",
+    feature: "Organization networking"
+  },
   members: {
     key: "organization:members",
     error: "Your plan does not include team members",
@@ -302,7 +310,7 @@ var plans = {
     // lead-facing email at all (the send path gates on an active
     // subscription), so granting it there would offer a domain that can
     // never send from.
-    features: all.features([connection.sender.key, organization.members.key]),
+    features: all.features([organization.networking.key, organization.members.key]),
     limits: all.limits({ actions: 5e3, members: 3, storage: gigabyte * 10 }),
     marketing: {
       description: "Tools to fine-tune campaigns and improve lead quality.",
@@ -323,7 +331,7 @@ var plans = {
   },
   DB00003: {
     features: all.features([
-      connection.sender.key,
+      organization.networking.key,
       organization.advertisements.key,
       organization.analytics.key,
       organization.members.key,
@@ -354,7 +362,7 @@ var plans = {
   },
   DB00004: {
     features: all.features([
-      connection.sender.key,
+      organization.networking.key,
       organization.advertisements.key,
       organization.analytics.key,
       organization.members.key,
@@ -385,7 +393,7 @@ var plans = {
   },
   DB00005: {
     features: all.features([
-      connection.sender.key,
+      organization.networking.key,
       organization.advertisements.key,
       organization.analytics.key,
       organization.members.key,
@@ -430,7 +438,7 @@ var resolvePlan = (subscription) => {
     // baseline whether or not the deal thought to name it. Today that is the
     // sending domain: every catalog paid tier grants it, and a custom plan
     // silently lacking it would be a support ticket, not a pricing decision.
-    features: all.features([connection.sender.key, ...((_a = custom.features) == null ? void 0 : _a.granted) || []]),
+    features: all.features([organization.networking.key, ...((_a = custom.features) == null ? void 0 : _a.granted) || []]),
     limits: all.limits(((_b = custom.limits) == null ? void 0 : _b.organization) || {}),
     // A custom plan stores its overage BARE on `custom.overages` — a different
     // shape from the catalog's nested one. Number() so a deal stored as a string
@@ -725,15 +733,74 @@ var scrape = {
 };
 
 // lib/pricing.js
+var emailPlans = {
+  essentials50k: {
+    included: 5e4,
+    // The plan's own price is not shown in the console once you are on it —
+    // it reads "Your Current Plan" where the price would be. Left null rather
+    // than guessed; fill from an invoice. Nothing derives from it yet, and an
+    // invented figure would quietly become the basis of an upgrade decision.
+    monthly: null,
+    overageCents: 0.133,
+    title: "Essentials 50K"
+  },
+  essentials100k: {
+    included: 1e5,
+    monthly: 3495,
+    overageCents: 0.09,
+    title: "Essentials 100K"
+  },
+  pro100k: {
+    included: 1e5,
+    monthly: 8995,
+    overageCents: 0.11,
+    title: "Pro 100K"
+  },
+  pro300k: {
+    included: 3e5,
+    monthly: 24900,
+    overageCents: 0.091,
+    title: "Pro 300K"
+  },
+  pro700k: {
+    included: 7e5,
+    monthly: 49900,
+    overageCents: 0.078,
+    title: "Pro 700K"
+  },
+  pro1500k: {
+    included: 15e5,
+    monthly: 79900,
+    overageCents: 0.059,
+    title: "Pro 1.5 Million"
+  },
+  pro2500k: {
+    included: 25e5,
+    monthly: 109900,
+    overageCents: 0.047,
+    title: "Pro 2.5 Million"
+  }
+};
+var emailPlan = "essentials50k";
 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.
+    // Fraction of the included volume that raises the alarm. Far enough ahead
+    // to act on, high enough not to fire on ordinary growth.
+    //
+    // Crossing it is NOT an outage. The provider bills overage rather than
+    // stopping sends, so the alarm is a COST signal: past the included volume
+    // every email is charged at overageCents, and at some run rate the next
+    // plan up is cheaper than the overage. That is the decision it exists to
+    // prompt, and it is why nobody should be woken by it.
     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
+    // Emails per calendar month included, 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: emailPlans[emailPlan].included,
+    overageCents: emailPlans[emailPlan].overageCents,
+    plan: emailPlan,
+    plans: emailPlans,
+    title: emailPlans[emailPlan].title
   }
 };
 var channels = {

package/package.json

@@ -172,6 +172,16 @@
       "types": "./dist/fields-validate.d.ts",
       "import": "./dist/fields-validate.js",
       "require": "./dist/fields-validate.cjs"
+    },
+    "./connections": {
+      "types": "./dist/connections/index.d.ts",
+      "import": "./dist/connections/index.js",
+      "require": "./dist/connections/index.cjs"
+    },
+    "./connections/oauth": {
+      "types": "./dist/connections/oauth.d.ts",
+      "import": "./dist/connections/oauth.js",
+      "require": "./dist/connections/oauth.cjs"
     }
   },
   "files": [
@@ -190,5 +200,5 @@
     "test": ". \"$HOME/.nvm/nvm.sh\" && nvm use && node --test"
   },
   "types": "dist/index.d.ts",
-  "version": "0.0.105"
+  "version": "0.0.107"
 }