@drawbridge/drawbridge-utils 0.0.103 → 0.0.104

package/dist/ai.cjs

@@ -268,6 +268,10 @@ var billRequest = async ({ db, user, model, usage, tools }) => {
   });
 };
 var ai = {
+  // The rate tables themselves, in cents per 1,000,000 tokens (`tools` in cents
+  // per request). Read-only surface for lib/pricing.js — the fee math above is
+  // still the only thing that should compute from them.
+  rates: { wholesale: cost, retail: pricing, tools: { wholesale: toolCost, retail: toolPricing } },
   // Retail cents for a request (what the user pays).
   price: priceForRequest,
   // Wholesale cents for a request (what we pay the provider).

package/dist/ai.js

@@ -234,6 +234,10 @@ var billRequest = async ({ db, user, model, usage, tools }) => {
   });
 };
 var ai = {
+  // The rate tables themselves, in cents per 1,000,000 tokens (`tools` in cents
+  // per request). Read-only surface for lib/pricing.js — the fee math above is
+  // still the only thing that should compute from them.
+  rates: { wholesale: cost, retail: pricing, tools: { wholesale: toolCost, retail: toolPricing } },
   // Retail cents for a request (what the user pays).
   price: priceForRequest,
   // Wholesale cents for a request (what we pay the provider).

package/dist/billing.cjs

@@ -19,7 +19,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // lib/billing.js
 var billing_exports = {};
 __export(billing_exports, {
+  LOCAL_FLAT_CENTS: () => LOCAL_FLAT_CENTS,
   MARKUP: () => MARKUP,
+  PREMIUM_CPM_CENTS: () => PREMIUM_CPM_CENTS,
+  PREMIUM_RATE_PER_GB: () => PREMIUM_RATE_PER_GB,
+  REUSE_FLAT_CENTS: () => REUSE_FLAT_CENTS,
+  STANDARD_CPM_CENTS: () => STANDARD_CPM_CENTS,
+  STANDARD_RATE_PER_GB: () => STANDARD_RATE_PER_GB,
   action: () => action,
   ai: () => ai,
   balance: () => balance,
@@ -268,6 +274,10 @@ var billRequest = async ({ db, user, model, usage, tools }) => {
   });
 };
 var ai = {
+  // The rate tables themselves, in cents per 1,000,000 tokens (`tools` in cents
+  // per request). Read-only surface for lib/pricing.js — the fee math above is
+  // still the only thing that should compute from them.
+  rates: { wholesale: cost, retail: pricing, tools: { wholesale: toolCost, retail: toolPricing } },
   // Retail cents for a request (what the user pays).
   price: priceForRequest,
   // Wholesale cents for a request (what we pay the provider).
@@ -511,7 +521,13 @@ var action = {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  LOCAL_FLAT_CENTS,
   MARKUP,
+  PREMIUM_CPM_CENTS,
+  PREMIUM_RATE_PER_GB,
+  REUSE_FLAT_CENTS,
+  STANDARD_CPM_CENTS,
+  STANDARD_RATE_PER_GB,
   action,
   ai,
   balance,

package/dist/billing.d.cts

@@ -185,6 +185,11 @@ const billRequest = async ({ db, user, model, usage, tools }) => {
 
 const ai = {
 
+	// The rate tables themselves, in cents per 1,000,000 tokens (`tools` in cents
+	// per request). Read-only surface for lib/pricing.js — the fee math above is
+	// still the only thing that should compute from them.
+	rates : { wholesale : cost, retail : pricing, tools : { wholesale : toolCost, retail : toolPricing } },
+
 	// Retail cents for a request (what the user pays).
 	price : priceForRequest,
 
@@ -211,6 +216,7 @@ const ai = {
 // Both carry the same 30% margin (MARKUP). A cold local render and a cache reuse
 // have no external cost, so they're small flat fees (set to 0 to make either
 // free). Tune the rates against real BrightData invoices.
+// Exported so lib/pricing.js can index every customer-facing rate in one place.
 const STANDARD_RATE_PER_GB = 8;
 const PREMIUM_RATE_PER_GB = 11;
 // Web Unlocker CPM in cents-per-request: $1.50/1,000 = 0.15¢, $2.50/1,000 = 0.25¢.
@@ -577,4 +583,4 @@ const action = {
 
 };
 
-export { MARKUP, action, ai, balance, grant, scrape };
+export { LOCAL_FLAT_CENTS, MARKUP, PREMIUM_CPM_CENTS, PREMIUM_RATE_PER_GB, REUSE_FLAT_CENTS, STANDARD_CPM_CENTS, STANDARD_RATE_PER_GB, action, ai, balance, grant, scrape };

package/dist/billing.d.ts

@@ -185,6 +185,11 @@ const billRequest = async ({ db, user, model, usage, tools }) => {
 
 const ai = {
 
+	// The rate tables themselves, in cents per 1,000,000 tokens (`tools` in cents
+	// per request). Read-only surface for lib/pricing.js — the fee math above is
+	// still the only thing that should compute from them.
+	rates : { wholesale : cost, retail : pricing, tools : { wholesale : toolCost, retail : toolPricing } },
+
 	// Retail cents for a request (what the user pays).
 	price : priceForRequest,
 
@@ -211,6 +216,7 @@ const ai = {
 // Both carry the same 30% margin (MARKUP). A cold local render and a cache reuse
 // have no external cost, so they're small flat fees (set to 0 to make either
 // free). Tune the rates against real BrightData invoices.
+// Exported so lib/pricing.js can index every customer-facing rate in one place.
 const STANDARD_RATE_PER_GB = 8;
 const PREMIUM_RATE_PER_GB = 11;
 // Web Unlocker CPM in cents-per-request: $1.50/1,000 = 0.15¢, $2.50/1,000 = 0.25¢.
@@ -577,4 +583,4 @@ const action = {
 
 };
 
-export { MARKUP, action, ai, balance, grant, scrape };
+export { LOCAL_FLAT_CENTS, MARKUP, PREMIUM_CPM_CENTS, PREMIUM_RATE_PER_GB, REUSE_FLAT_CENTS, STANDARD_CPM_CENTS, STANDARD_RATE_PER_GB, action, ai, balance, grant, scrape };

package/dist/billing.js

@@ -238,6 +238,10 @@ var billRequest = async ({ db, user, model, usage, tools }) => {
   });
 };
 var ai = {
+  // The rate tables themselves, in cents per 1,000,000 tokens (`tools` in cents
+  // per request). Read-only surface for lib/pricing.js — the fee math above is
+  // still the only thing that should compute from them.
+  rates: { wholesale: cost, retail: pricing, tools: { wholesale: toolCost, retail: toolPricing } },
   // Retail cents for a request (what the user pays).
   price: priceForRequest,
   // Wholesale cents for a request (what we pay the provider).
@@ -480,7 +484,13 @@ var action = {
   }
 };
 export {
+  LOCAL_FLAT_CENTS,
   MARKUP,
+  PREMIUM_CPM_CENTS,
+  PREMIUM_RATE_PER_GB,
+  REUSE_FLAT_CENTS,
+  STANDARD_CPM_CENTS,
+  STANDARD_RATE_PER_GB,
   action,
   ai,
   balance,

package/dist/features.cjs

@@ -99,6 +99,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",

package/dist/features.d.cts

@@ -73,6 +73,11 @@ const 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',

package/dist/features.d.ts

@@ -73,6 +73,11 @@ const 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',

package/dist/features.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",

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 };