@rebuy/rebuy 3.17.0 → 3.18.0

package/dist/server/analytics.d.ts

@@ -25,7 +25,7 @@ declare const TAXONOMY: {
             element_id: string;
             experiment_type: string;
         };
-        buildTags: ({ experimentId }: Record<string, unknown>) => string[] | undefined;
+        buildTags: ({ experimentId }: Record<string, unknown>, input: AnalyticsInput) => string[] | undefined;
         noun: "cart";
         subject: "abtest";
         usesWidgetId: false;
@@ -37,7 +37,7 @@ declare const TAXONOMY: {
         buildMeta: ({ productId, variantId }: Record<string, unknown>) => {
             [x: string]: true;
         };
-        buildTags: ({ experimentId }: Record<string, unknown>) => string[] | undefined;
+        buildTags: ({ experimentId }: Record<string, unknown>, input: AnalyticsInput) => string[] | undefined;
         /** Under an experiment the add belongs to the VARIANT element, not the placeholder (React parity). */
         buildWidgetId: ({ elementId }: Record<string, unknown>, input: {
             events: {
@@ -49,6 +49,11 @@ declare const TAXONOMY: {
             visitorId: string;
             cartToken?: string | undefined;
             checkoutToken?: string | undefined;
+            segments?: {
+                device?: string | undefined;
+                source?: string | undefined;
+                visitor?: string | undefined;
+            } | undefined;
             widgetId?: string | undefined;
         }) => string | undefined;
         noun: "widget";
@@ -77,7 +82,7 @@ declare const TAXONOMY: {
         verb: "tracking";
     };
     'widget-viewed': {
-        buildTags: ({ experimentId }: Record<string, unknown>) => string[] | undefined;
+        buildTags: ({ experimentId }: Record<string, unknown>, input: AnalyticsInput) => string[] | undefined;
         /** Under an experiment the view belongs to the VARIANT element, not the placeholder (React parity, same as added-to-cart) — else views credit the placeholder while adds credit the variant and per-widget conversion is meaningless. */
         buildWidgetId: ({ elementId }: Record<string, unknown>, input: {
             events: {
@@ -89,6 +94,11 @@ declare const TAXONOMY: {
             visitorId: string;
             cartToken?: string | undefined;
             checkoutToken?: string | undefined;
+            segments?: {
+                device?: string | undefined;
+                source?: string | undefined;
+                visitor?: string | undefined;
+            } | undefined;
             widgetId?: string | undefined;
         }) => string | undefined;
         noun: "widget";

package/dist/server/analyticsSegments.d.ts

@@ -0,0 +1,6 @@
+import { type AnalyticsSegmentsInput } from '../server/requestSchemas';
+/**
+ * One `<baseTag>.<dimension>.<bucket>` tag per segment whose bucket passes {@link SEGMENT_BUCKETS}; invalid
+ * or absent dimensions contribute nothing (so valid siblings still ride along).
+ */
+export declare const segmentTags: (baseTag: string, segments: AnalyticsSegmentsInput | undefined) => string[];

package/dist/server/index.cjs

@@ -22,6 +22,7 @@ var server_exports = {};
 __export(server_exports, {
   AnalyticsEventInputSchema: () => AnalyticsEventInputSchema,
   AnalyticsInputSchema: () => AnalyticsInputSchema,
+  AnalyticsSegmentsInputSchema: () => AnalyticsSegmentsInputSchema,
   CartInputSchema: () => CartInputSchema,
   CartLineInputSchema: () => CartLineInputSchema,
   DataSourceInputSchema: () => DataSourceInputSchema,
@@ -4542,6 +4543,19 @@ var validateGifts = async (input, ctx) => {
 
 // src/server/analytics.ts
 var import_es_toolkit7 = require("es-toolkit");
+
+// src/server/analyticsSegments.ts
+var SEGMENT_BUCKETS = {
+  device: ["desktop", "mobile"],
+  source: ["direct", "email", "google_ads", "meta_social", "other", "sms"],
+  visitor: ["new", "returning"]
+};
+var segmentTags = (baseTag, segments) => Object.entries(SEGMENT_BUCKETS).flatMap(([dimension, buckets]) => {
+  const bucket = segments?.[dimension];
+  return bucket !== void 0 && buckets.includes(bucket) ? [`${baseTag}.${dimension}.${bucket}`] : [];
+});
+
+// src/server/analytics.ts
 var EXPERIMENT_TYPE_MAP = {
   CheckoutOffer: "checkout_offer",
   Generic: "generic",
@@ -4549,7 +4563,11 @@ var EXPERIMENT_TYPE_MAP = {
   SmartCart: "smart_cart",
   Widget: "widget"
 };
-var experimentTags = ({ experimentId }) => experimentId != null ? [`ABN.TEST.${experimentId}`] : void 0;
+var experimentTags = ({ experimentId }, input) => {
+  if (experimentId == null) return void 0;
+  const baseTag = `ABN.TEST.${experimentId}`;
+  return [baseTag, ...segmentTags(baseTag, input.segments)];
+};
 var TAXONOMY = {
   "ab-test-viewed": {
     // Only when BOTH ids are present — otherwise the template literal would emit "undefined.undefined".
@@ -4618,7 +4636,7 @@ var translateAnalyticsEvent = (event, input) => {
   const taxonomy = TAXONOMY[event.name];
   const properties = event.properties ?? {};
   const meta = taxonomy.buildMeta?.(properties);
-  const tags = taxonomy.buildTags?.(properties);
+  const tags = taxonomy.buildTags?.(properties, input);
   const definedNounId = taxonomy.buildDefinedNounId?.(properties);
   const widgetId = taxonomy.buildWidgetId?.(properties, input) ?? input.widgetId;
   const eventTime = toEngineEventTime(event.sentAt);
@@ -4886,12 +4904,23 @@ var AnalyticsEventInputSchema = import_zod30.z.object({
   properties: import_zod30.z.record(import_zod30.z.string().max(REQUEST_BOUNDS.STRING_KEY_MAX), import_zod30.z.unknown()).optional(),
   sentAt: import_zod30.z.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional()
 });
+var AnalyticsSegmentsInputSchema = import_zod30.z.object({
+  device: import_zod30.z.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional().catch(void 0),
+  source: import_zod30.z.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional().catch(void 0),
+  visitor: import_zod30.z.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional().catch(void 0)
+});
 var AnalyticsInputSchema = import_zod30.z.object({
   /** Rebuy cart token (the `r_cart_token` cart attribute), when available — primary aggregation key. */
   cartToken: import_zod30.z.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional(),
   /** Shopify checkout token, when available — drives cart/checkout aggregation downstream. */
   checkoutToken: import_zod30.z.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional(),
   events: import_zod30.z.array(AnalyticsEventInputSchema).max(REQUEST_BOUNDS.EVENTS_MAX),
+  /**
+   * Request-scoped like the tokens: one visitor's segments apply to every event in the batch. The container
+   * degrades too (`null` is a realistic wire artifact of `attributes ? {…} : null`), so the degrade rule is
+   * total: nothing about `segments` can cost the envelope.
+   */
+  segments: AnalyticsSegmentsInputSchema.optional().catch(void 0),
   shop: import_zod30.z.string().max(REQUEST_BOUNDS.STRING_ID_MAX),
   visitorId: import_zod30.z.string().max(REQUEST_BOUNDS.STRING_ID_MAX),
   /** The widget id (smartBlockId) the events belong to. */

package/dist/server/index.d.ts

@@ -14,5 +14,5 @@ export { fetchUserConfig } from '../server/userConfig';
 export { validateGifts } from '../server/giftValidation';
 export { fetchMonetizeOffers, type MonetizeOffers } from '../server/monetizeOffers';
 export { postAnalyticsEvents, translateAnalyticsEvent, type CabAnalyticsEventName } from '../server/analytics';
-export { AnalyticsEventInputSchema, AnalyticsInputSchema, CartInputSchema, CartLineInputSchema, DataSourceInputSchema, GiftAdjustmentSchema, GiftInputSchema, GiftValidationInputSchema, GiftValidationResponseSchema, MonetizeInputSchema, MonetizeTransactionItemSchema, REQUEST_BOUNDS, UserConfigInputSchema, WidgetSettingsInputSchema, } from '../server/requestSchemas';
-export { NotFoundError, REBUY_ENGINE_HOST, UpstreamError, type AnalyticsEventInput, type AnalyticsInput, type CartInput, type CartLineInput, type DataSourceInput, type GiftAdjustment, type GiftInput, type GiftValidationInput, type GiftValidationResponse, type MonetizeInput, type MonetizeTransactionItem, type ServerContext, type ServerDrift, type UpstreamFetch, type UserConfigInput, type WidgetSettingsInput, } from '../server/shared';
+export { AnalyticsEventInputSchema, AnalyticsInputSchema, AnalyticsSegmentsInputSchema, CartInputSchema, CartLineInputSchema, DataSourceInputSchema, GiftAdjustmentSchema, GiftInputSchema, GiftValidationInputSchema, GiftValidationResponseSchema, MonetizeInputSchema, MonetizeTransactionItemSchema, REQUEST_BOUNDS, UserConfigInputSchema, WidgetSettingsInputSchema, } from '../server/requestSchemas';
+export { NotFoundError, REBUY_ENGINE_HOST, UpstreamError, type AnalyticsEventInput, type AnalyticsInput, type AnalyticsSegmentsInput, type CartInput, type CartLineInput, type DataSourceInput, type GiftAdjustment, type GiftInput, type GiftValidationInput, type GiftValidationResponse, type MonetizeInput, type MonetizeTransactionItem, type ServerContext, type ServerDrift, type UpstreamFetch, type UserConfigInput, type WidgetSettingsInput, } from '../server/shared';

package/dist/server/index.mjs

@@ -4492,6 +4492,19 @@ var validateGifts = async (input, ctx) => {
 
 // src/server/analytics.ts
 import { chunk } from "es-toolkit";
+
+// src/server/analyticsSegments.ts
+var SEGMENT_BUCKETS = {
+  device: ["desktop", "mobile"],
+  source: ["direct", "email", "google_ads", "meta_social", "other", "sms"],
+  visitor: ["new", "returning"]
+};
+var segmentTags = (baseTag, segments) => Object.entries(SEGMENT_BUCKETS).flatMap(([dimension, buckets]) => {
+  const bucket = segments?.[dimension];
+  return bucket !== void 0 && buckets.includes(bucket) ? [`${baseTag}.${dimension}.${bucket}`] : [];
+});
+
+// src/server/analytics.ts
 var EXPERIMENT_TYPE_MAP = {
   CheckoutOffer: "checkout_offer",
   Generic: "generic",
@@ -4499,7 +4512,11 @@ var EXPERIMENT_TYPE_MAP = {
   SmartCart: "smart_cart",
   Widget: "widget"
 };
-var experimentTags = ({ experimentId }) => experimentId != null ? [`ABN.TEST.${experimentId}`] : void 0;
+var experimentTags = ({ experimentId }, input) => {
+  if (experimentId == null) return void 0;
+  const baseTag = `ABN.TEST.${experimentId}`;
+  return [baseTag, ...segmentTags(baseTag, input.segments)];
+};
 var TAXONOMY = {
   "ab-test-viewed": {
     // Only when BOTH ids are present — otherwise the template literal would emit "undefined.undefined".
@@ -4568,7 +4585,7 @@ var translateAnalyticsEvent = (event, input) => {
   const taxonomy = TAXONOMY[event.name];
   const properties = event.properties ?? {};
   const meta = taxonomy.buildMeta?.(properties);
-  const tags = taxonomy.buildTags?.(properties);
+  const tags = taxonomy.buildTags?.(properties, input);
   const definedNounId = taxonomy.buildDefinedNounId?.(properties);
   const widgetId = taxonomy.buildWidgetId?.(properties, input) ?? input.widgetId;
   const eventTime = toEngineEventTime(event.sentAt);
@@ -4836,12 +4853,23 @@ var AnalyticsEventInputSchema = z30.object({
   properties: z30.record(z30.string().max(REQUEST_BOUNDS.STRING_KEY_MAX), z30.unknown()).optional(),
   sentAt: z30.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional()
 });
+var AnalyticsSegmentsInputSchema = z30.object({
+  device: z30.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional().catch(void 0),
+  source: z30.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional().catch(void 0),
+  visitor: z30.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional().catch(void 0)
+});
 var AnalyticsInputSchema = z30.object({
   /** Rebuy cart token (the `r_cart_token` cart attribute), when available — primary aggregation key. */
   cartToken: z30.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional(),
   /** Shopify checkout token, when available — drives cart/checkout aggregation downstream. */
   checkoutToken: z30.string().max(REQUEST_BOUNDS.STRING_ID_MAX).optional(),
   events: z30.array(AnalyticsEventInputSchema).max(REQUEST_BOUNDS.EVENTS_MAX),
+  /**
+   * Request-scoped like the tokens: one visitor's segments apply to every event in the batch. The container
+   * degrades too (`null` is a realistic wire artifact of `attributes ? {…} : null`), so the degrade rule is
+   * total: nothing about `segments` can cost the envelope.
+   */
+  segments: AnalyticsSegmentsInputSchema.optional().catch(void 0),
   shop: z30.string().max(REQUEST_BOUNDS.STRING_ID_MAX),
   visitorId: z30.string().max(REQUEST_BOUNDS.STRING_ID_MAX),
   /** The widget id (smartBlockId) the events belong to. */
@@ -4850,6 +4878,7 @@ var AnalyticsInputSchema = z30.object({
 export {
   AnalyticsEventInputSchema,
   AnalyticsInputSchema,
+  AnalyticsSegmentsInputSchema,
   CartInputSchema,
   CartLineInputSchema,
   DataSourceInputSchema,

package/dist/server/requestSchemas.d.ts

@@ -331,6 +331,22 @@ export declare const AnalyticsEventInputSchema: z.ZodObject<{
     properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     sentAt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * The visitor's A/B segment buckets, RAW as onsite-js wrote them into the `_r_segment_{device,source,visitor}`
+ * cart attributes (the checkout sandbox can't compute them itself). Deliberately unvalidated here: the
+ * bucket allow-list lives in the tag translation (`analyticsSegments.ts`) so a stray value drops ONE tag,
+ * never the whole batch — and the extension bundle never has to carry a copy of the list. Cart attributes
+ * are shopper-writable, so even the size bound must degrade rather than fail: `.catch(undefined)` (the
+ * `cacheKey` precedent) turns an over-limit or non-string value into a missing segment instead of a
+ * rejected envelope. `STRING_ID_MAX` (not the fat `STRING_VALUE_MAX`) because every valid bucket is a
+ * short identifier — anything longer can only be junk, and the bound is a payload guard, not validation.
+ * Only present keys are sent; the client omits an absent attribute rather than sending an empty string.
+ */
+export declare const AnalyticsSegmentsInputSchema: z.ZodObject<{
+    device: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    source: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    visitor: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
 /** Input for `postAnalyticsEvents`: a batch of events plus the request-scoped identity fields. */
 export declare const AnalyticsInputSchema: z.ZodObject<{
     cartToken: z.ZodOptional<z.ZodString>;
@@ -340,12 +356,18 @@ export declare const AnalyticsInputSchema: z.ZodObject<{
         properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         sentAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    segments: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        device: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+        source: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+        visitor: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>>;
     shop: z.ZodString;
     visitorId: z.ZodString;
     widgetId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type AnalyticsEventInput = z.infer<typeof AnalyticsEventInputSchema>;
 export type AnalyticsInput = z.infer<typeof AnalyticsInputSchema>;
+export type AnalyticsSegmentsInput = z.infer<typeof AnalyticsSegmentsInputSchema>;
 export type CartInput = z.infer<typeof CartInputSchema>;
 export type CartLineInput = z.infer<typeof CartLineInputSchema>;
 export type DataSourceInput = z.infer<typeof DataSourceInputSchema>;

package/dist/server/shared.d.ts

@@ -70,4 +70,4 @@ export declare class NotFoundError extends Error {
  * requests against the exact contract the orchestrators are typed on. Kept re-exported here so the
  * `@rebuy/rebuy/server` type surface is unchanged.
  */
-export type { AnalyticsEventInput, AnalyticsInput, CartInput, CartLineInput, DataSourceInput, GiftAdjustment, GiftInput, GiftValidationInput, GiftValidationResponse, MonetizeInput, MonetizeTransactionItem, UserConfigInput, WidgetSettingsInput, } from '../server/requestSchemas';
+export type { AnalyticsEventInput, AnalyticsInput, AnalyticsSegmentsInput, CartInput, CartLineInput, DataSourceInput, GiftAdjustment, GiftInput, GiftValidationInput, GiftValidationResponse, MonetizeInput, MonetizeTransactionItem, UserConfigInput, WidgetSettingsInput, } from '../server/requestSchemas';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rebuy/rebuy",
-    "version": "3.17.0",
+    "version": "3.18.0",
     "description": "Shared zod schemas, legacy-to-CAB widget transforms, and server orchestrators for Rebuy's Shopify consumers (rebuy-api, admin-nextjs, rebuy-shopify-extensions)",
     "license": "MIT",
     "author": "Rebuy, Inc.",