perspectapi-ts-sdk 6.4.1 → 6.5.1

package/dist/index.d.mts

@@ -1405,7 +1405,7 @@ interface V2OrderLineItemPriceData {
 }
 interface V2OrderLineItem {
     sku_id?: number;
-    product_id?: number;
+    product_id?: string | number;
     price_data?: V2OrderLineItemPriceData;
     price?: string;
     quantity: number;

package/dist/index.d.ts

@@ -1405,7 +1405,7 @@ interface V2OrderLineItemPriceData {
 }
 interface V2OrderLineItem {
     sku_id?: number;
-    product_id?: number;
+    product_id?: string | number;
     price_data?: V2OrderLineItemPriceData;
     price?: string;
     quantity: number;

package/dist/index.js

@@ -4259,15 +4259,16 @@ function createPerspectAb(options) {
           `${VID_COOKIE}=${visitorId}; Path=/; Max-Age=${VID_COOKIE_MAX_AGE}; SameSite=Lax; Secure; HttpOnly`
         );
       }
+      const isBot = classifyBotFromCfRequest(request);
       const config = await getConfig(options.cache, apiKey, siteName, baseUrl);
-      return { ab: buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId), responseHeaders };
+      return { ab: buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId, isBot), responseHeaders };
     },
     async refreshConfig() {
       await fetchAndStoreConfig(options.cache, apiKey, siteName, baseUrl);
     }
   };
 }
-function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId) {
+function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId, isBot) {
   return {
     async getVariant(flagKey) {
       const flag = config.flags[flagKey];
@@ -4287,6 +4288,7 @@ function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId) {
         version: flag.currentVersion,
         variant: assigned,
         visitorId,
+        isBot,
         dedup: await dedupFor(visitorId, flagKey, flag.currentVersion, assigned, "exposure"),
         ts: Math.floor(Date.now() / 1e3)
       });
@@ -4307,6 +4309,7 @@ function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId) {
           version: flag.currentVersion,
           variant: assigned,
           visitorId,
+          isBot,
           event,
           dedup: await dedupFor(visitorId, flagKey, flag.currentVersion, assigned, event),
           ts: Math.floor(Date.now() / 1e3),
@@ -4345,6 +4348,13 @@ function emit(apiKey, baseUrl, ctx, body) {
   }).then(() => void 0).catch(() => void 0);
   if (ctx) ctx.waitUntil(task);
 }
+function classifyBotFromCfRequest(request) {
+  const cf = request.cf;
+  if (!cf?.botManagement) return false;
+  if (cf.botManagement.verifiedBot) return true;
+  if (typeof cf.botManagement.score === "number") return cf.botManagement.score < 30;
+  return false;
+}
 function readOrMintVid(request) {
   const cookie = request.headers.get("cookie") ?? "";
   const match = cookie.match(/(?:^|; )perspect_vid=([^;]+)/);

package/dist/index.mjs

@@ -4183,15 +4183,16 @@ function createPerspectAb(options) {
           `${VID_COOKIE}=${visitorId}; Path=/; Max-Age=${VID_COOKIE_MAX_AGE}; SameSite=Lax; Secure; HttpOnly`
         );
       }
+      const isBot = classifyBotFromCfRequest(request);
       const config = await getConfig(options.cache, apiKey, siteName, baseUrl);
-      return { ab: buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId), responseHeaders };
+      return { ab: buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId, isBot), responseHeaders };
     },
     async refreshConfig() {
       await fetchAndStoreConfig(options.cache, apiKey, siteName, baseUrl);
     }
   };
 }
-function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId) {
+function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId, isBot) {
   return {
     async getVariant(flagKey) {
       const flag = config.flags[flagKey];
@@ -4211,6 +4212,7 @@ function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId) {
         version: flag.currentVersion,
         variant: assigned,
         visitorId,
+        isBot,
         dedup: await dedupFor(visitorId, flagKey, flag.currentVersion, assigned, "exposure"),
         ts: Math.floor(Date.now() / 1e3)
       });
@@ -4231,6 +4233,7 @@ function buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId) {
           version: flag.currentVersion,
           variant: assigned,
           visitorId,
+          isBot,
           event,
           dedup: await dedupFor(visitorId, flagKey, flag.currentVersion, assigned, event),
           ts: Math.floor(Date.now() / 1e3),
@@ -4269,6 +4272,13 @@ function emit(apiKey, baseUrl, ctx, body) {
   }).then(() => void 0).catch(() => void 0);
   if (ctx) ctx.waitUntil(task);
 }
+function classifyBotFromCfRequest(request) {
+  const cf = request.cf;
+  if (!cf?.botManagement) return false;
+  if (cf.botManagement.verifiedBot) return true;
+  if (typeof cf.botManagement.score === "number") return cf.botManagement.score < 30;
+  return false;
+}
 function readOrMintVid(request) {
   const cookie = request.headers.get("cookie") ?? "";
   const match = cookie.match(/(?:^|; )perspect_vid=([^;]+)/);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perspectapi-ts-sdk",
-  "version": "6.4.1",
+  "version": "6.5.1",
   "description": "TypeScript SDK for PerspectAPI - Cloudflare Workers compatible",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/ab/ab-client.ts

@@ -88,8 +88,9 @@ export function createPerspectAb(options: CreatePerspectAbOptions): PerspectAb {
           `${VID_COOKIE}=${visitorId}; Path=/; Max-Age=${VID_COOKIE_MAX_AGE}; SameSite=Lax; Secure; HttpOnly`,
         );
       }
+      const isBot = classifyBotFromCfRequest(request);
       const config = await getConfig(options.cache, apiKey, siteName, baseUrl);
-      return { ab: buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId), responseHeaders };
+      return { ab: buildAbClient(apiKey, siteName, baseUrl, ctx, config, visitorId, isBot), responseHeaders };
     },
 
     async refreshConfig(): Promise<void> {
@@ -109,6 +110,7 @@ function buildAbClient(
   ctx: { waitUntil(p: Promise<unknown>): void } | undefined,
   config: AbConfigBlob,
   visitorId: string,
+  isBot: boolean,
 ): AbClient {
   return {
     async getVariant(flagKey: string): Promise<AbVariantResult> {
@@ -129,6 +131,7 @@ function buildAbClient(
         version: flag.currentVersion,
         variant: assigned,
         visitorId,
+        isBot,
         dedup: await dedupFor(visitorId, flagKey, flag.currentVersion, assigned, 'exposure'),
         ts: Math.floor(Date.now() / 1000),
       });
@@ -150,6 +153,7 @@ function buildAbClient(
           version: flag.currentVersion,
           variant: assigned,
           visitorId,
+          isBot,
           event,
           dedup: await dedupFor(visitorId, flagKey, flag.currentVersion, assigned, event),
           ts: Math.floor(Date.now() / 1000),
@@ -209,6 +213,7 @@ interface EventBody {
   version: number;
   variant: string;
   visitorId: string;
+  isBot: boolean;
   dedup: string;
   ts: number;
   event?: string;
@@ -231,6 +236,21 @@ function emit(
   if (ctx) ctx.waitUntil(task);
 }
 
+// ---------------------------------------------------------------------------
+// Bot classification from CF request metadata
+// ---------------------------------------------------------------------------
+
+// CF Workers attach botManagement to the request object at runtime. The SDK
+// uses the standard Request type, so we access it via an unsafe cast rather
+// than importing CF-specific types as a peer dependency.
+function classifyBotFromCfRequest(request: Request): boolean {
+  const cf = (request as unknown as { cf?: { botManagement?: { score?: number; verifiedBot?: boolean } } }).cf;
+  if (!cf?.botManagement) return false;
+  if (cf.botManagement.verifiedBot) return true;
+  if (typeof cf.botManagement.score === 'number') return cf.botManagement.score < 30;
+  return false;
+}
+
 // ---------------------------------------------------------------------------
 // Visitor ID
 // ---------------------------------------------------------------------------

package/src/v2/types.ts

@@ -266,7 +266,7 @@ export interface V2OrderLineItemPriceData {
 
 export interface V2OrderLineItem {
   sku_id?: number;
-  product_id?: number;
+  product_id?: string | number;
   price_data?: V2OrderLineItemPriceData;
   price?: string;
   quantity: number;