@drawbridge/drawbridge-utils 0.0.69 → 0.0.71

package/dist/billing.cjs

@@ -253,26 +253,59 @@ var ai = {
 };
 var STANDARD_RATE_PER_GB = 8;
 var PREMIUM_RATE_PER_GB = 11;
+var STANDARD_CPM_CENTS = 0.15;
+var PREMIUM_CPM_CENTS = 0.25;
 var PREMIUM_HOSTS = /* @__PURE__ */ new Set();
 var LOCAL_FLAT_CENTS = 1;
 var REUSE_FLAT_CENTS = 1;
-var ratePerGB = (url) => {
+var isPremium = (url) => {
   try {
-    return PREMIUM_HOSTS.has(new URL(url).hostname) ? PREMIUM_RATE_PER_GB : STANDARD_RATE_PER_GB;
+    return PREMIUM_HOSTS.has(new URL(url).hostname);
   } catch {
-    return STANDARD_RATE_PER_GB;
+    return false;
   }
 };
-var scrapeFee = ({ provider, bytes, url, cold }) => {
+var ratePerGB = (url) => isPremium(url) ? PREMIUM_RATE_PER_GB : STANDARD_RATE_PER_GB;
+var cpmCents = (url) => isPremium(url) ? PREMIUM_CPM_CENTS : STANDARD_CPM_CENTS;
+var scrapeFee = ({ provider, bytes, requests, url, cold }) => {
   if (!cold) return REUSE_FLAT_CENTS;
   if (provider === "brightdata") {
     return Math.ceil((bytes || 0) / 1e9 * ratePerGB(url) * 100 * MARKUP);
   }
+  if (provider === "brightdata-unlocker") {
+    return Math.ceil((requests || 0) * cpmCents(url) * MARKUP);
+  }
   return LOCAL_FLAT_CENTS;
 };
+var scrapeBreakdown = ({ provider, bytes, requests, url }) => {
+  if (provider === "brightdata") {
+    return {
+      provider,
+      basis: "bytes",
+      units: bytes || 0,
+      rate: ratePerGB(url),
+      rateUnit: "GB",
+      cents: scrapeFee({ provider, bytes, url, cold: true })
+    };
+  }
+  if (provider === "brightdata-unlocker") {
+    return {
+      provider,
+      basis: "requests",
+      units: requests || 0,
+      // cpmCents is cents-per-request; ×10 expresses it as dollars per 1,000.
+      rate: cpmCents(url) * 10,
+      rateUnit: "1K requests",
+      cents: scrapeFee({ provider, requests, url, cold: true })
+    };
+  }
+  return { provider: provider || "local", basis: "local", units: null, rate: null, rateUnit: null, cents: LOCAL_FLAT_CENTS };
+};
 var scrape = {
   // Cents for a scrape given its provider/bytes/cold basis.
   fee: scrapeFee,
+  // Itemized cold-fee breakdown (basis/units/rate/cents) for display + the scrape doc.
+  breakdown: scrapeBreakdown,
   // Deferred bill(scrapeId) the scrape store's resolve() hands the generation
   // flow. Atomically claims the cold (first-time) fee via the `charged` flag so
   // a BrightData scrape's metered cost is recovered ONCE; later reuses pay the
@@ -290,6 +323,7 @@ var scrape = {
       const cents = scrapeFee({
         provider: (_a = page == null ? void 0 : page.provider) == null ? void 0 : _a.name,
         bytes: page == null ? void 0 : page.bytes,
+        requests: page == null ? void 0 : page.requests,
         url: (page == null ? void 0 : page.url) || url,
         cold: Boolean(claim == null ? void 0 : claim.value)
       });

package/dist/billing.d.cts

@@ -174,27 +174,39 @@ const ai = {
 
 // ─── Scrape (credit rail) ──────────────────────────────────────────────────────
 
-// BrightData (the Scraping Browser fallback) bills by GB, so its fee is METERED
-// to the traffic measured at scrape time; the 30% margin matches MARKUP above. 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 against real BrightData invoices.
+// BrightData has two unblocking tiers, billed on different bases:
+//   - Scraping Browser (the CDP fallback): bills by GB of traffic, so its fee is
+//     METERED to the bytes measured at scrape time.
+//   - Web Unlocker (the last-resort HTML tier): bills per successful request (CPM
+//     = per 1,000), so its fee is METERED to the request COUNT the tier made.
+// 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.
 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¢.
+const STANDARD_CPM_CENTS = 0.15;
+const PREMIUM_CPM_CENTS = 0.25;
+// Premium-rate domains — shared by both tiers (empty = everything standard).
 const PREMIUM_HOSTS = new Set();
 const LOCAL_FLAT_CENTS = 1;
 const REUSE_FLAT_CENTS = 1;
 
-const ratePerGB = ( url ) => {
+const isPremium = ( url ) => {
 
-	try { return PREMIUM_HOSTS.has( new URL( url ).hostname ) ? PREMIUM_RATE_PER_GB : STANDARD_RATE_PER_GB; }
-	catch { return STANDARD_RATE_PER_GB; }
+	try { return PREMIUM_HOSTS.has( new URL( url ).hostname ); }
+	catch { return false; }
 
 };
 
+const ratePerGB = ( url ) => isPremium( url ) ? PREMIUM_RATE_PER_GB : STANDARD_RATE_PER_GB;
+const cpmCents = ( url ) => isPremium( url ) ? PREMIUM_CPM_CENTS : STANDARD_CPM_CENTS;
+
 // Cents to charge. `cold` = the first generation off this scrape (charge the real
-// cost: metered for BrightData, a flat for a local render); otherwise it's a reuse
-// (flat). Rounded up so we never under-bill a fractional cent.
-const scrapeFee = ({ provider, bytes, url, cold }) => {
+// cost: metered for either BrightData tier, a flat for a local render); otherwise
+// it's a reuse (flat). Rounded up so we never under-bill a fractional cent — so a
+// typical 1–2 request unlock rounds up to the 1¢ floor.
+const scrapeFee = ({ provider, bytes, requests, url, cold }) => {
 
 	if( ! cold ) return REUSE_FLAT_CENTS;
 
@@ -204,15 +216,63 @@ const scrapeFee = ({ provider, bytes, url, cold }) => {
 
 	}
 
+	if( provider === 'brightdata-unlocker' ){
+
+		return Math.ceil( ( requests || 0 ) * cpmCents( url ) * MARKUP );
+
+	}
+
 	return LOCAL_FLAT_CENTS;
 
 };
 
+// Itemized cold-fee breakdown for the scrape doc / admin dashboard: the same cents
+// scrapeFee charges on a COLD scrape, plus the basis, the metered units, and the
+// wholesale provider rate behind it. Reuse hits aren't represented here — the doc
+// records its cold acquisition cost. `rate` is the wholesale rate in dollars per
+// `rateUnit` (pre-markup, i.e. the BrightData list price); `cents` is the retail fee
+// billed (incl MARKUP). Local renders have no external cost — flat, no rate.
+const scrapeBreakdown = ({ provider, bytes, requests, url }) => {
+
+	if( provider === 'brightdata' ){
+
+		return {
+			provider,
+			basis : 'bytes',
+			units : bytes || 0,
+			rate : ratePerGB( url ),
+			rateUnit : 'GB',
+			cents : scrapeFee({ provider, bytes, url, cold : true })
+		};
+
+	}
+
+	if( provider === 'brightdata-unlocker' ){
+
+		return {
+			provider,
+			basis : 'requests',
+			units : requests || 0,
+			// cpmCents is cents-per-request; ×10 expresses it as dollars per 1,000.
+			rate : cpmCents( url ) * 10,
+			rateUnit : '1K requests',
+			cents : scrapeFee({ provider, requests, url, cold : true })
+		};
+
+	}
+
+	return { provider : provider || 'local', basis : 'local', units : null, rate : null, rateUnit : null, cents : LOCAL_FLAT_CENTS };
+
+};
+
 const scrape = {
 
 	// Cents for a scrape given its provider/bytes/cold basis.
 	fee : scrapeFee,
 
+	// Itemized cold-fee breakdown (basis/units/rate/cents) for display + the scrape doc.
+	breakdown : scrapeBreakdown,
+
 	// Deferred bill(scrapeId) the scrape store's resolve() hands the generation
 	// flow. Atomically claims the cold (first-time) fee via the `charged` flag so
 	// a BrightData scrape's metered cost is recovered ONCE; later reuses pay the
@@ -233,6 +293,7 @@ const scrape = {
 			const cents = scrapeFee({
 				provider : page?.provider?.name,
 				bytes : page?.bytes,
+				requests : page?.requests,
 				url : page?.url || url,
 				cold : Boolean( claim?.value )
 			});

package/dist/billing.d.ts

@@ -174,27 +174,39 @@ const ai = {
 
 // ─── Scrape (credit rail) ──────────────────────────────────────────────────────
 
-// BrightData (the Scraping Browser fallback) bills by GB, so its fee is METERED
-// to the traffic measured at scrape time; the 30% margin matches MARKUP above. 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 against real BrightData invoices.
+// BrightData has two unblocking tiers, billed on different bases:
+//   - Scraping Browser (the CDP fallback): bills by GB of traffic, so its fee is
+//     METERED to the bytes measured at scrape time.
+//   - Web Unlocker (the last-resort HTML tier): bills per successful request (CPM
+//     = per 1,000), so its fee is METERED to the request COUNT the tier made.
+// 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.
 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¢.
+const STANDARD_CPM_CENTS = 0.15;
+const PREMIUM_CPM_CENTS = 0.25;
+// Premium-rate domains — shared by both tiers (empty = everything standard).
 const PREMIUM_HOSTS = new Set();
 const LOCAL_FLAT_CENTS = 1;
 const REUSE_FLAT_CENTS = 1;
 
-const ratePerGB = ( url ) => {
+const isPremium = ( url ) => {
 
-	try { return PREMIUM_HOSTS.has( new URL( url ).hostname ) ? PREMIUM_RATE_PER_GB : STANDARD_RATE_PER_GB; }
-	catch { return STANDARD_RATE_PER_GB; }
+	try { return PREMIUM_HOSTS.has( new URL( url ).hostname ); }
+	catch { return false; }
 
 };
 
+const ratePerGB = ( url ) => isPremium( url ) ? PREMIUM_RATE_PER_GB : STANDARD_RATE_PER_GB;
+const cpmCents = ( url ) => isPremium( url ) ? PREMIUM_CPM_CENTS : STANDARD_CPM_CENTS;
+
 // Cents to charge. `cold` = the first generation off this scrape (charge the real
-// cost: metered for BrightData, a flat for a local render); otherwise it's a reuse
-// (flat). Rounded up so we never under-bill a fractional cent.
-const scrapeFee = ({ provider, bytes, url, cold }) => {
+// cost: metered for either BrightData tier, a flat for a local render); otherwise
+// it's a reuse (flat). Rounded up so we never under-bill a fractional cent — so a
+// typical 1–2 request unlock rounds up to the 1¢ floor.
+const scrapeFee = ({ provider, bytes, requests, url, cold }) => {
 
 	if( ! cold ) return REUSE_FLAT_CENTS;
 
@@ -204,15 +216,63 @@ const scrapeFee = ({ provider, bytes, url, cold }) => {
 
 	}
 
+	if( provider === 'brightdata-unlocker' ){
+
+		return Math.ceil( ( requests || 0 ) * cpmCents( url ) * MARKUP );
+
+	}
+
 	return LOCAL_FLAT_CENTS;
 
 };
 
+// Itemized cold-fee breakdown for the scrape doc / admin dashboard: the same cents
+// scrapeFee charges on a COLD scrape, plus the basis, the metered units, and the
+// wholesale provider rate behind it. Reuse hits aren't represented here — the doc
+// records its cold acquisition cost. `rate` is the wholesale rate in dollars per
+// `rateUnit` (pre-markup, i.e. the BrightData list price); `cents` is the retail fee
+// billed (incl MARKUP). Local renders have no external cost — flat, no rate.
+const scrapeBreakdown = ({ provider, bytes, requests, url }) => {
+
+	if( provider === 'brightdata' ){
+
+		return {
+			provider,
+			basis : 'bytes',
+			units : bytes || 0,
+			rate : ratePerGB( url ),
+			rateUnit : 'GB',
+			cents : scrapeFee({ provider, bytes, url, cold : true })
+		};
+
+	}
+
+	if( provider === 'brightdata-unlocker' ){
+
+		return {
+			provider,
+			basis : 'requests',
+			units : requests || 0,
+			// cpmCents is cents-per-request; ×10 expresses it as dollars per 1,000.
+			rate : cpmCents( url ) * 10,
+			rateUnit : '1K requests',
+			cents : scrapeFee({ provider, requests, url, cold : true })
+		};
+
+	}
+
+	return { provider : provider || 'local', basis : 'local', units : null, rate : null, rateUnit : null, cents : LOCAL_FLAT_CENTS };
+
+};
+
 const scrape = {
 
 	// Cents for a scrape given its provider/bytes/cold basis.
 	fee : scrapeFee,
 
+	// Itemized cold-fee breakdown (basis/units/rate/cents) for display + the scrape doc.
+	breakdown : scrapeBreakdown,
+
 	// Deferred bill(scrapeId) the scrape store's resolve() hands the generation
 	// flow. Atomically claims the cold (first-time) fee via the `charged` flag so
 	// a BrightData scrape's metered cost is recovered ONCE; later reuses pay the
@@ -233,6 +293,7 @@ const scrape = {
 			const cents = scrapeFee({
 				provider : page?.provider?.name,
 				bytes : page?.bytes,
+				requests : page?.requests,
 				url : page?.url || url,
 				cold : Boolean( claim?.value )
 			});

package/dist/billing.js

@@ -224,26 +224,59 @@ var ai = {
 };
 var STANDARD_RATE_PER_GB = 8;
 var PREMIUM_RATE_PER_GB = 11;
+var STANDARD_CPM_CENTS = 0.15;
+var PREMIUM_CPM_CENTS = 0.25;
 var PREMIUM_HOSTS = /* @__PURE__ */ new Set();
 var LOCAL_FLAT_CENTS = 1;
 var REUSE_FLAT_CENTS = 1;
-var ratePerGB = (url) => {
+var isPremium = (url) => {
   try {
-    return PREMIUM_HOSTS.has(new URL(url).hostname) ? PREMIUM_RATE_PER_GB : STANDARD_RATE_PER_GB;
+    return PREMIUM_HOSTS.has(new URL(url).hostname);
   } catch {
-    return STANDARD_RATE_PER_GB;
+    return false;
   }
 };
-var scrapeFee = ({ provider, bytes, url, cold }) => {
+var ratePerGB = (url) => isPremium(url) ? PREMIUM_RATE_PER_GB : STANDARD_RATE_PER_GB;
+var cpmCents = (url) => isPremium(url) ? PREMIUM_CPM_CENTS : STANDARD_CPM_CENTS;
+var scrapeFee = ({ provider, bytes, requests, url, cold }) => {
   if (!cold) return REUSE_FLAT_CENTS;
   if (provider === "brightdata") {
     return Math.ceil((bytes || 0) / 1e9 * ratePerGB(url) * 100 * MARKUP);
   }
+  if (provider === "brightdata-unlocker") {
+    return Math.ceil((requests || 0) * cpmCents(url) * MARKUP);
+  }
   return LOCAL_FLAT_CENTS;
 };
+var scrapeBreakdown = ({ provider, bytes, requests, url }) => {
+  if (provider === "brightdata") {
+    return {
+      provider,
+      basis: "bytes",
+      units: bytes || 0,
+      rate: ratePerGB(url),
+      rateUnit: "GB",
+      cents: scrapeFee({ provider, bytes, url, cold: true })
+    };
+  }
+  if (provider === "brightdata-unlocker") {
+    return {
+      provider,
+      basis: "requests",
+      units: requests || 0,
+      // cpmCents is cents-per-request; ×10 expresses it as dollars per 1,000.
+      rate: cpmCents(url) * 10,
+      rateUnit: "1K requests",
+      cents: scrapeFee({ provider, requests, url, cold: true })
+    };
+  }
+  return { provider: provider || "local", basis: "local", units: null, rate: null, rateUnit: null, cents: LOCAL_FLAT_CENTS };
+};
 var scrape = {
   // Cents for a scrape given its provider/bytes/cold basis.
   fee: scrapeFee,
+  // Itemized cold-fee breakdown (basis/units/rate/cents) for display + the scrape doc.
+  breakdown: scrapeBreakdown,
   // Deferred bill(scrapeId) the scrape store's resolve() hands the generation
   // flow. Atomically claims the cold (first-time) fee via the `charged` flag so
   // a BrightData scrape's metered cost is recovered ONCE; later reuses pay the
@@ -261,6 +294,7 @@ var scrape = {
       const cents = scrapeFee({
         provider: (_a = page == null ? void 0 : page.provider) == null ? void 0 : _a.name,
         bytes: page == null ? void 0 : page.bytes,
+        requests: page == null ? void 0 : page.requests,
         url: (page == null ? void 0 : page.url) || url,
         cold: Boolean(claim == null ? void 0 : claim.value)
       });

package/package.json

@@ -158,5 +158,5 @@
     "build": "tsup && npm publish"
   },
   "types": "dist/index.d.ts",
-  "version": "0.0.69"
+  "version": "0.0.71"
 }