@drawbridge/drawbridge-utils 0.0.102 → 0.0.104

package/dist/plans.cjs

@@ -32,7 +32,8 @@ __export(plans_exports, {
   conversionRate: () => conversionRate,
   free: () => free,
   plans: () => plans,
-  resolvePlan: () => resolvePlan
+  resolvePlan: () => resolvePlan,
+  unitAmountDecimal: () => unitAmountDecimal
 });
 module.exports = __toCommonJS(plans_exports);
 
@@ -109,6 +110,11 @@ 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",
@@ -262,6 +268,15 @@ var featuresFor = (array = []) => Object.values({
   },
   { denied: {}, granted: {} }
 );
+var overage = (actionCents) => ({
+  actionCents,
+  overages: { actions: String(actionCents) }
+});
+var unitAmountDecimal = (cents) => {
+  const value = Number(cents);
+  if (cents == null || !Number.isFinite(value)) throw new Error(`Invalid overage rate: ${cents}`);
+  return String(value);
+};
 var all = {
   features: (array = []) => featuresFor([
     connection.mailchimp.key,
@@ -322,7 +337,11 @@ var free = {
 };
 var plans = {
   DB00002: {
-    features: all.features([organization.members.key]),
+    // A verified sending domain is a PAID capability: free plans cannot send
+    // 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]),
     limits: all.limits({ actions: 5e3, members: 3, storage: gigabyte * 10 }),
     marketing: {
       description: "Tools to fine-tune campaigns and improve lead quality.",
@@ -337,12 +356,13 @@ var plans = {
         ["Storage", "10GB"]
       ]
     },
-    overages: { actions: "2.5" },
+    ...overage(2.5),
     title: "Starter",
     conversion: 2
   },
   DB00003: {
     features: all.features([
+      connection.sender.key,
       organization.advertisements.key,
       organization.analytics.key,
       organization.members.key,
@@ -367,12 +387,13 @@ var plans = {
         ["Storage", "20GB"]
       ]
     },
-    overages: { actions: "2" },
+    ...overage(2),
     title: "Pro",
     conversion: 1.5
   },
   DB00004: {
     features: all.features([
+      connection.sender.key,
       organization.advertisements.key,
       organization.analytics.key,
       organization.members.key,
@@ -397,12 +418,13 @@ var plans = {
         ["Storage", "50GB"]
       ]
     },
-    overages: { actions: "1.85" },
+    ...overage(1.85),
     title: "Premium",
     conversion: 1
   },
   DB00005: {
     features: all.features([
+      connection.sender.key,
       organization.advertisements.key,
       organization.analytics.key,
       organization.members.key,
@@ -427,7 +449,7 @@ var plans = {
         ["Storage", "100GB"]
       ]
     },
-    overages: { actions: "1.5" },
+    ...overage(1.5),
     title: "Elite",
     conversion: 0.5
   }
@@ -443,8 +465,17 @@ var resolvePlan = (subscription) => {
     // infinite when a deal does not name it.
     conversion: custom.conversion ?? free.conversion,
     custom: true,
-    features: all.features(((_a = custom.features) == null ? void 0 : _a.granted) || []),
+    // A custom plan is a negotiated PAID deal, so it carries the paid-tier
+    // 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) || []]),
     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
+    // still resolves to cents-per-action; an unnamed overage stays undefined
+    // (it bills nothing) rather than becoming NaN.
+    actionCents: custom.overages == null ? void 0 : Number(custom.overages),
     overages: { actions: custom.overages },
     title: custom.title || "Custom"
   };
@@ -458,5 +489,6 @@ var conversionRate = (subscription) => {
   conversionRate,
   free,
   plans,
-  resolvePlan
+  resolvePlan,
+  unitAmountDecimal
 });

package/dist/plans.d.cts

@@ -1,4 +1,4 @@
-import { organization, page, connection, fields, field } from './features.cjs';
+import { connection, organization, page, fields, field } from './features.cjs';
 import { infinite, gigabyte } from './index.cjs';
 import 'currency-codes';
 import 'nanoid';
@@ -31,6 +31,40 @@ const featuresFor = ( array = [] ) => Object.values({
 	{ denied : {}, granted : {} }
 );
 
+// Overage pricing, unit-explicit.
+//
+// `actionCents` is CENTS PER ACTION, as a number: 2.5 = $0.025. Before
+// 2026-05-31 the same rate was encoded as dollars-per-1,000-actions, Stripe read
+// it as per-action, and every paid tier billed 10x. `overages.actions` — the
+// string this used to be the only name for — is kept as a byte-identical alias
+// so consumers can be pin-bumped in any order; drop it once they all read
+// `actionCents`.
+//
+// Sub-cent precision is deliberate: Premium's 1.85¢ does not fit integer cents
+// (2¢ is +8%, 1¢ is −46%).
+const overage = ( actionCents ) => ({
+	actionCents,
+	overages : { actions : String( actionCents ) }
+});
+
+// Cents → Stripe's `unit_amount_decimal`.
+//
+// The Stripe boundary MUST use `unit_amount_decimal`, not `unit_amount`:
+// standalone invoice items reject a top-level `unit_amount` with "Received
+// unknown parameter", which is what left invoice drafts stuck on 2026-08-06.
+// It is a decimal string of CENTS, so 2.5 → '2.5' — no scaling, no rounding.
+const unitAmountDecimal = ( cents ) => {
+
+	const value = Number( cents );
+
+	// `cents == null` is checked separately because Number( null ) is 0 — an
+	// unnamed rate must fail loudly, not silently bill nothing.
+	if( cents == null || ! Number.isFinite( value ) ) throw new Error( `Invalid overage rate: ${ cents }` );
+
+	return String( value );
+
+};
+
 const all = {
 	features : ( array = [] ) => featuresFor([
 		connection.mailchimp.key,
@@ -93,7 +127,11 @@ const free = {
 
 const plans = {
 	DB00002 : {
-		features : all.features([ organization.members.key ]),
+		// A verified sending domain is a PAID capability: free plans cannot send
+		// 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 ]),
 		limits : all.limits({ actions : 5000, members : 3, storage : gigabyte * 10 }),
 		marketing : {
 			description : 'Tools to fine-tune campaigns and improve lead quality.',
@@ -108,12 +146,13 @@ const plans = {
 				[ 'Storage', '10GB' ]
 			]
 		},
-		overages : { actions : '2.5' },
+		...overage( 2.5 ),
 		title : 'Starter',
 		conversion : 2
 	},
 	DB00003 : {
 		features : all.features([
+			connection.sender.key,
 			organization.advertisements.key,
 			organization.analytics.key,
 			organization.members.key,
@@ -138,12 +177,13 @@ const plans = {
 				[ 'Storage', '20GB' ]
 			]
 		},
-		overages : { actions : '2' },
+		...overage( 2 ),
 		title : 'Pro',
 		conversion : 1.5
 	},
 	DB00004 : {
 		features : all.features([
+			connection.sender.key,
 			organization.advertisements.key,
 			organization.analytics.key,
 			organization.members.key,
@@ -168,12 +208,13 @@ const plans = {
 				[ 'Storage', '50GB' ]
 			]
 		},
-		overages : { actions : '1.85' },
+		...overage( 1.85 ),
 		title : 'Premium',
 		conversion : 1
 	},
 	DB00005 : {
 		features : all.features([
+			connection.sender.key,
 			organization.advertisements.key,
 			organization.analytics.key,
 			organization.members.key,
@@ -198,7 +239,7 @@ const plans = {
 				[ 'Storage', '100GB' ]
 			]
 		},
-		overages : { actions : '1.5' },
+		...overage( 1.5 ),
 		title : 'Elite',
 		conversion : 0.5
 	},
@@ -230,8 +271,17 @@ const resolvePlan = ( subscription ) => {
 		// infinite when a deal does not name it.
 		conversion : custom.conversion ?? free.conversion,
 		custom : true,
-		features : all.features( custom.features?.granted || [] ),
+		// A custom plan is a negotiated PAID deal, so it carries the paid-tier
+		// 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, ...( custom.features?.granted || [] ) ]),
 		limits : all.limits( custom.limits?.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
+		// still resolves to cents-per-action; an unnamed overage stays undefined
+		// (it bills nothing) rather than becoming NaN.
+		actionCents : custom.overages == null ? undefined : Number( custom.overages ),
 		overages : { actions : custom.overages },
 		title : custom.title || 'Custom'
 	};
@@ -250,4 +300,4 @@ const conversionRate = ( subscription ) =>
 	resolvePlan( subscription )?.conversion
 	?? free.conversion;
 
-export { conversionRate, free, plans, resolvePlan };
+export { conversionRate, free, plans, resolvePlan, unitAmountDecimal };

package/dist/plans.d.ts

@@ -1,4 +1,4 @@
-import { organization, page, connection, fields, field } from './features.js';
+import { connection, organization, page, fields, field } from './features.js';
 import { infinite, gigabyte } from './index.js';
 import 'currency-codes';
 import 'nanoid';
@@ -31,6 +31,40 @@ const featuresFor = ( array = [] ) => Object.values({
 	{ denied : {}, granted : {} }
 );
 
+// Overage pricing, unit-explicit.
+//
+// `actionCents` is CENTS PER ACTION, as a number: 2.5 = $0.025. Before
+// 2026-05-31 the same rate was encoded as dollars-per-1,000-actions, Stripe read
+// it as per-action, and every paid tier billed 10x. `overages.actions` — the
+// string this used to be the only name for — is kept as a byte-identical alias
+// so consumers can be pin-bumped in any order; drop it once they all read
+// `actionCents`.
+//
+// Sub-cent precision is deliberate: Premium's 1.85¢ does not fit integer cents
+// (2¢ is +8%, 1¢ is −46%).
+const overage = ( actionCents ) => ({
+	actionCents,
+	overages : { actions : String( actionCents ) }
+});
+
+// Cents → Stripe's `unit_amount_decimal`.
+//
+// The Stripe boundary MUST use `unit_amount_decimal`, not `unit_amount`:
+// standalone invoice items reject a top-level `unit_amount` with "Received
+// unknown parameter", which is what left invoice drafts stuck on 2026-08-06.
+// It is a decimal string of CENTS, so 2.5 → '2.5' — no scaling, no rounding.
+const unitAmountDecimal = ( cents ) => {
+
+	const value = Number( cents );
+
+	// `cents == null` is checked separately because Number( null ) is 0 — an
+	// unnamed rate must fail loudly, not silently bill nothing.
+	if( cents == null || ! Number.isFinite( value ) ) throw new Error( `Invalid overage rate: ${ cents }` );
+
+	return String( value );
+
+};
+
 const all = {
 	features : ( array = [] ) => featuresFor([
 		connection.mailchimp.key,
@@ -93,7 +127,11 @@ const free = {
 
 const plans = {
 	DB00002 : {
-		features : all.features([ organization.members.key ]),
+		// A verified sending domain is a PAID capability: free plans cannot send
+		// 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 ]),
 		limits : all.limits({ actions : 5000, members : 3, storage : gigabyte * 10 }),
 		marketing : {
 			description : 'Tools to fine-tune campaigns and improve lead quality.',
@@ -108,12 +146,13 @@ const plans = {
 				[ 'Storage', '10GB' ]
 			]
 		},
-		overages : { actions : '2.5' },
+		...overage( 2.5 ),
 		title : 'Starter',
 		conversion : 2
 	},
 	DB00003 : {
 		features : all.features([
+			connection.sender.key,
 			organization.advertisements.key,
 			organization.analytics.key,
 			organization.members.key,
@@ -138,12 +177,13 @@ const plans = {
 				[ 'Storage', '20GB' ]
 			]
 		},
-		overages : { actions : '2' },
+		...overage( 2 ),
 		title : 'Pro',
 		conversion : 1.5
 	},
 	DB00004 : {
 		features : all.features([
+			connection.sender.key,
 			organization.advertisements.key,
 			organization.analytics.key,
 			organization.members.key,
@@ -168,12 +208,13 @@ const plans = {
 				[ 'Storage', '50GB' ]
 			]
 		},
-		overages : { actions : '1.85' },
+		...overage( 1.85 ),
 		title : 'Premium',
 		conversion : 1
 	},
 	DB00005 : {
 		features : all.features([
+			connection.sender.key,
 			organization.advertisements.key,
 			organization.analytics.key,
 			organization.members.key,
@@ -198,7 +239,7 @@ const plans = {
 				[ 'Storage', '100GB' ]
 			]
 		},
-		overages : { actions : '1.5' },
+		...overage( 1.5 ),
 		title : 'Elite',
 		conversion : 0.5
 	},
@@ -230,8 +271,17 @@ const resolvePlan = ( subscription ) => {
 		// infinite when a deal does not name it.
 		conversion : custom.conversion ?? free.conversion,
 		custom : true,
-		features : all.features( custom.features?.granted || [] ),
+		// A custom plan is a negotiated PAID deal, so it carries the paid-tier
+		// 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, ...( custom.features?.granted || [] ) ]),
 		limits : all.limits( custom.limits?.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
+		// still resolves to cents-per-action; an unnamed overage stays undefined
+		// (it bills nothing) rather than becoming NaN.
+		actionCents : custom.overages == null ? undefined : Number( custom.overages ),
 		overages : { actions : custom.overages },
 		title : custom.title || 'Custom'
 	};
@@ -250,4 +300,4 @@ const conversionRate = ( subscription ) =>
 	resolvePlan( subscription )?.conversion
 	?? free.conversion;
 
-export { conversionRate, free, plans, resolvePlan };
+export { conversionRate, free, plans, resolvePlan, unitAmountDecimal };

package/dist/plans.js

@@ -71,6 +71,11 @@ 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",
@@ -224,6 +229,15 @@ var featuresFor = (array = []) => Object.values({
   },
   { denied: {}, granted: {} }
 );
+var overage = (actionCents) => ({
+  actionCents,
+  overages: { actions: String(actionCents) }
+});
+var unitAmountDecimal = (cents) => {
+  const value = Number(cents);
+  if (cents == null || !Number.isFinite(value)) throw new Error(`Invalid overage rate: ${cents}`);
+  return String(value);
+};
 var all = {
   features: (array = []) => featuresFor([
     connection.mailchimp.key,
@@ -284,7 +298,11 @@ var free = {
 };
 var plans = {
   DB00002: {
-    features: all.features([organization.members.key]),
+    // A verified sending domain is a PAID capability: free plans cannot send
+    // 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]),
     limits: all.limits({ actions: 5e3, members: 3, storage: gigabyte * 10 }),
     marketing: {
       description: "Tools to fine-tune campaigns and improve lead quality.",
@@ -299,12 +317,13 @@ var plans = {
         ["Storage", "10GB"]
       ]
     },
-    overages: { actions: "2.5" },
+    ...overage(2.5),
     title: "Starter",
     conversion: 2
   },
   DB00003: {
     features: all.features([
+      connection.sender.key,
       organization.advertisements.key,
       organization.analytics.key,
       organization.members.key,
@@ -329,12 +348,13 @@ var plans = {
         ["Storage", "20GB"]
       ]
     },
-    overages: { actions: "2" },
+    ...overage(2),
     title: "Pro",
     conversion: 1.5
   },
   DB00004: {
     features: all.features([
+      connection.sender.key,
       organization.advertisements.key,
       organization.analytics.key,
       organization.members.key,
@@ -359,12 +379,13 @@ var plans = {
         ["Storage", "50GB"]
       ]
     },
-    overages: { actions: "1.85" },
+    ...overage(1.85),
     title: "Premium",
     conversion: 1
   },
   DB00005: {
     features: all.features([
+      connection.sender.key,
       organization.advertisements.key,
       organization.analytics.key,
       organization.members.key,
@@ -389,7 +410,7 @@ var plans = {
         ["Storage", "100GB"]
       ]
     },
-    overages: { actions: "1.5" },
+    ...overage(1.5),
     title: "Elite",
     conversion: 0.5
   }
@@ -405,8 +426,17 @@ var resolvePlan = (subscription) => {
     // infinite when a deal does not name it.
     conversion: custom.conversion ?? free.conversion,
     custom: true,
-    features: all.features(((_a = custom.features) == null ? void 0 : _a.granted) || []),
+    // A custom plan is a negotiated PAID deal, so it carries the paid-tier
+    // 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) || []]),
     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
+    // still resolves to cents-per-action; an unnamed overage stays undefined
+    // (it bills nothing) rather than becoming NaN.
+    actionCents: custom.overages == null ? void 0 : Number(custom.overages),
     overages: { actions: custom.overages },
     title: custom.title || "Custom"
   };
@@ -419,5 +449,6 @@ export {
   conversionRate,
   free,
   plans,
-  resolvePlan
+  resolvePlan,
+  unitAmountDecimal
 };