@drawbridge/drawbridge-utils 0.0.103 → 0.0.105

package/dist/pricing.d.cts

@@ -0,0 +1,111 @@
+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 './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.
+//
+// Nothing is DEFINED here except the channel weights: the values still live
+// where their accounting lives, and this file re-exports them so a rate can be
+// found without knowing which module owns it. It is also the seam if we ever
+// migrate the values for real.
+//
+// Every number below carries its UNIT in the map, because the unit is exactly
+// what got lost: `overages.actions` was '2.5' and read as $2.50 by everyone who
+// met it — twice, once in production (2026-05-31, every paid tier billed 10x).
+//
+// ─── Plan overages (lib/plans.js) ─────────────────────────────────────────────
+//   actionCents            CENTS per action, number. 2.5 = $0.025.
+//                          Starter 2.5 · Pro 2 · Premium 1.85 · Elite 1.5.
+//                          Free has none — it is hard-capped at 200 actions.
+//   overages.actions       DEPRECATED alias of actionCents, as a string. Kept for
+//                          one release so consumers pin-bump in any order.
+//   unitAmountDecimal()    cents → Stripe `unit_amount_decimal` (a cents string).
+//   plans[ id ].conversion PERCENT of order value taken as the conversion fee.
+//   limits.*               counts, except storage which is BYTES.
+//
+// ─── Channel weights (owned here) ─────────────────────────────────────────────
+//   channels.email.actionsPerSend      ACTIONS per email send.
+//   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.
+//   PREMIUM_RATE_PER_GB    DOLLARS per GB, premium hosts.
+//   STANDARD_CPM_CENTS     CENTS per request, BrightData Web Unlocker.
+//   PREMIUM_CPM_CENTS      CENTS per request, premium hosts.
+//   LOCAL_FLAT_CENTS       CENTS per cold local render.
+//   REUSE_FLAT_CENTS       CENTS per cache reuse.
+//   ai.rates               CENTS per 1,000,000 tokens, wholesale + retail, per
+//                          model; ai.rates.tools is CENTS per request.
+//
+// lib/ai.js is NOT re-exported here on purpose: its `models` registry names WHICH
+// model we call, not what it costs (the rate table lives in billing.js), and
+// importing it would pull @google/genai and construct a client into every
+// 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 = {
+	email : {
+		actionsPerSend : 1,
+		includedInAllowance : true
+	},
+	sms : {
+		// Two actions PER SEGMENT (a long message is several segments), billed from
+		// the FIRST segment and never drawn from the plan's included allowance —
+		// carrier cost is real from message one, so there is no free tier of it.
+		actionsPerSegment : 2,
+		includedInAllowance : false
+	}
+};
+
+export { channels, sending };

package/dist/pricing.d.ts

@@ -0,0 +1,111 @@
+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 './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.
+//
+// Nothing is DEFINED here except the channel weights: the values still live
+// where their accounting lives, and this file re-exports them so a rate can be
+// found without knowing which module owns it. It is also the seam if we ever
+// migrate the values for real.
+//
+// Every number below carries its UNIT in the map, because the unit is exactly
+// what got lost: `overages.actions` was '2.5' and read as $2.50 by everyone who
+// met it — twice, once in production (2026-05-31, every paid tier billed 10x).
+//
+// ─── Plan overages (lib/plans.js) ─────────────────────────────────────────────
+//   actionCents            CENTS per action, number. 2.5 = $0.025.
+//                          Starter 2.5 · Pro 2 · Premium 1.85 · Elite 1.5.
+//                          Free has none — it is hard-capped at 200 actions.
+//   overages.actions       DEPRECATED alias of actionCents, as a string. Kept for
+//                          one release so consumers pin-bump in any order.
+//   unitAmountDecimal()    cents → Stripe `unit_amount_decimal` (a cents string).
+//   plans[ id ].conversion PERCENT of order value taken as the conversion fee.
+//   limits.*               counts, except storage which is BYTES.
+//
+// ─── Channel weights (owned here) ─────────────────────────────────────────────
+//   channels.email.actionsPerSend      ACTIONS per email send.
+//   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.
+//   PREMIUM_RATE_PER_GB    DOLLARS per GB, premium hosts.
+//   STANDARD_CPM_CENTS     CENTS per request, BrightData Web Unlocker.
+//   PREMIUM_CPM_CENTS      CENTS per request, premium hosts.
+//   LOCAL_FLAT_CENTS       CENTS per cold local render.
+//   REUSE_FLAT_CENTS       CENTS per cache reuse.
+//   ai.rates               CENTS per 1,000,000 tokens, wholesale + retail, per
+//                          model; ai.rates.tools is CENTS per request.
+//
+// lib/ai.js is NOT re-exported here on purpose: its `models` registry names WHICH
+// model we call, not what it costs (the rate table lives in billing.js), and
+// importing it would pull @google/genai and construct a client into every
+// 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 = {
+	email : {
+		actionsPerSend : 1,
+		includedInAllowance : true
+	},
+	sms : {
+		// Two actions PER SEGMENT (a long message is several segments), billed from
+		// the FIRST segment and never drawn from the plan's included allowance —
+		// carrier cost is real from message one, so there is no free tier of it.
+		actionsPerSegment : 2,
+		includedInAllowance : false
+	}
+};
+
+export { channels, sending };