@drawbridge/drawbridge-utils 0.0.134 → 0.0.136

package/dist/pricing.d.cts

@@ -1,14 +1,15 @@
+import { MARKUP } from './billing.cjs';
+export { LOCAL_FLAT_CENTS, PREMIUM_CPM_CENTS, PREMIUM_RATE_PER_GB, REUSE_FLAT_CENTS, STANDARD_CPM_CENTS, STANDARD_RATE_PER_GB, ai, scrape } from './billing.cjs';
 export { conversionRate, free, plans, resolvePlan, unitAmountDecimal } from './plans.cjs';
-export { LOCAL_FLAT_CENTS, MARKUP, PREMIUM_CPM_CENTS, PREMIUM_RATE_PER_GB, REUSE_FLAT_CENTS, STANDARD_CPM_CENTS, STANDARD_RATE_PER_GB, ai, scrape } from './billing.cjs';
+import './transactions.cjs';
+import '@drawbridge/drawbridge-telemetry';
+import './usage.cjs';
 import './features.cjs';
 import './index.cjs';
 import 'currency-codes';
 import 'nanoid';
 import './color.cjs';
 import 'tinycolor2';
-import './usage.cjs';
-import './transactions.cjs';
-import '@drawbridge/drawbridge-telemetry';
 
 // Pricing — the one file you open to see every customer-facing number.
 //
@@ -168,6 +169,34 @@ const sending = {
 		plan : emailPlan,
 		plans : emailPlans,
 		title : emailPlans[ emailPlan ].title
+	},
+
+	// What one outbound SMS SEGMENT costs us, against what channels.sms below
+	// sells it for. Here for the same reason the email figures are: this file is
+	// where a rate is found without knowing whose module owns it — and its
+	// absence is why "does an SMS action cover its cost" could not be answered
+	// from this repo at all.
+	//
+	// US toll-free outbound, read from Twilio's SMS pricing page 2026-09-03
+	// (https://www.twilio.com/en-us/sms/pricing/us): $0.0083 per segment, plus a
+	// carrier fee that varies by the DESTINATION carrier — $0.0035 AT&T, $0.0045
+	// T-Mobile / Verizon / US Cellular, $0.004 everywhere else. CENTS per
+	// segment, like every other rate in this file.
+	//
+	// WORST CASE, deliberately. A price floor computed from the average is a
+	// floor that half of real traffic sits underneath.
+	//
+	// A segment is 153 GSM-7 characters once a message spans more than one — or
+	// 67 if the body contains a single emoji or curly quote, which flips the
+	// whole message to UCS-2. Twilio reports the count as `num_segments` on the
+	// Message resource, which is what the send bills on.
+	sms : {
+		baseCents : 0.83,
+		// The dearest carrier fee, not the mean: see WORST CASE above.
+		carrierCents : 0.45,
+		// Stated, not summed — 0.83 + 0.45 is 1.2800000000000002 in binary
+		// floating point, and this number is compared against money.
+		segmentCostCents : 1.28
 	}
 };
 
@@ -187,6 +216,25 @@ const channels = {
 	}
 };
 
+// The lowest CENTS-per-action rate a plan may charge. Custom plans are
+// hand-entered, and the guard on them only ever rejected a MISSING rate — zero
+// is finite, passed every check, and billed nothing.
+//
+// DERIVED, so it moves when the thing it protects moves. SMS is the binding
+// channel by a wide margin: two actions must cover one segment, so the
+// break-even is segmentCostCents / actionsPerSegment = 0.64¢ per action. Email
+// breaks even at 0.133¢ and never binds.
+//
+// MARKUP is the family's existing margin multiplier (billing.js, 30%) rather
+// than a second number invented here — we do not sell an action at cost any
+// more than we sell a scrape at cost.
+//
+// For scale: the cheapest catalog rate is Elite at 1.5¢, comfortably clear. A
+// negotiated deal can still go well below the catalog; it cannot go below cost.
+const MINIMUM_ACTION_CENTS = Math.round(
+	( sending.sms.segmentCostCents / channels.sms.actionsPerSegment ) * MARKUP * 1000
+) / 1000;
+
 // The dedicated SMS number — a RECURRING SUBSCRIPTION ITEM, not an action:
 // the carrier bills for holding the number whether or not it sends, so it
 // joins the organization's subscription as its own line and leaves when the
@@ -203,4 +251,4 @@ const numbers = {
 	}
 };
 
-export { channels, numbers, sending };
+export { MARKUP, MINIMUM_ACTION_CENTS, channels, numbers, sending };

package/dist/pricing.d.ts

@@ -1,14 +1,15 @@
+import { MARKUP } from './billing.js';
+export { LOCAL_FLAT_CENTS, PREMIUM_CPM_CENTS, PREMIUM_RATE_PER_GB, REUSE_FLAT_CENTS, STANDARD_CPM_CENTS, STANDARD_RATE_PER_GB, ai, scrape } from './billing.js';
 export { conversionRate, free, plans, resolvePlan, unitAmountDecimal } from './plans.js';
-export { LOCAL_FLAT_CENTS, MARKUP, PREMIUM_CPM_CENTS, PREMIUM_RATE_PER_GB, REUSE_FLAT_CENTS, STANDARD_CPM_CENTS, STANDARD_RATE_PER_GB, ai, scrape } from './billing.js';
+import './transactions.js';
+import '@drawbridge/drawbridge-telemetry';
+import './usage.js';
 import './features.js';
 import './index.js';
 import 'currency-codes';
 import 'nanoid';
 import './color.js';
 import 'tinycolor2';
-import './usage.js';
-import './transactions.js';
-import '@drawbridge/drawbridge-telemetry';
 
 // Pricing — the one file you open to see every customer-facing number.
 //
@@ -168,6 +169,34 @@ const sending = {
 		plan : emailPlan,
 		plans : emailPlans,
 		title : emailPlans[ emailPlan ].title
+	},
+
+	// What one outbound SMS SEGMENT costs us, against what channels.sms below
+	// sells it for. Here for the same reason the email figures are: this file is
+	// where a rate is found without knowing whose module owns it — and its
+	// absence is why "does an SMS action cover its cost" could not be answered
+	// from this repo at all.
+	//
+	// US toll-free outbound, read from Twilio's SMS pricing page 2026-09-03
+	// (https://www.twilio.com/en-us/sms/pricing/us): $0.0083 per segment, plus a
+	// carrier fee that varies by the DESTINATION carrier — $0.0035 AT&T, $0.0045
+	// T-Mobile / Verizon / US Cellular, $0.004 everywhere else. CENTS per
+	// segment, like every other rate in this file.
+	//
+	// WORST CASE, deliberately. A price floor computed from the average is a
+	// floor that half of real traffic sits underneath.
+	//
+	// A segment is 153 GSM-7 characters once a message spans more than one — or
+	// 67 if the body contains a single emoji or curly quote, which flips the
+	// whole message to UCS-2. Twilio reports the count as `num_segments` on the
+	// Message resource, which is what the send bills on.
+	sms : {
+		baseCents : 0.83,
+		// The dearest carrier fee, not the mean: see WORST CASE above.
+		carrierCents : 0.45,
+		// Stated, not summed — 0.83 + 0.45 is 1.2800000000000002 in binary
+		// floating point, and this number is compared against money.
+		segmentCostCents : 1.28
 	}
 };
 
@@ -187,6 +216,25 @@ const channels = {
 	}
 };
 
+// The lowest CENTS-per-action rate a plan may charge. Custom plans are
+// hand-entered, and the guard on them only ever rejected a MISSING rate — zero
+// is finite, passed every check, and billed nothing.
+//
+// DERIVED, so it moves when the thing it protects moves. SMS is the binding
+// channel by a wide margin: two actions must cover one segment, so the
+// break-even is segmentCostCents / actionsPerSegment = 0.64¢ per action. Email
+// breaks even at 0.133¢ and never binds.
+//
+// MARKUP is the family's existing margin multiplier (billing.js, 30%) rather
+// than a second number invented here — we do not sell an action at cost any
+// more than we sell a scrape at cost.
+//
+// For scale: the cheapest catalog rate is Elite at 1.5¢, comfortably clear. A
+// negotiated deal can still go well below the catalog; it cannot go below cost.
+const MINIMUM_ACTION_CENTS = Math.round(
+	( sending.sms.segmentCostCents / channels.sms.actionsPerSegment ) * MARKUP * 1000
+) / 1000;
+
 // The dedicated SMS number — a RECURRING SUBSCRIPTION ITEM, not an action:
 // the carrier bills for holding the number whether or not it sends, so it
 // joins the organization's subscription as its own line and leaves when the
@@ -203,4 +251,4 @@ const numbers = {
 	}
 };
 
-export { channels, numbers, sending };
+export { MARKUP, MINIMUM_ACTION_CENTS, channels, numbers, sending };