@ak--47/dungeon-master 1.0.0 → 1.1.0

package/types.d.ts

@@ -109,6 +109,26 @@ export interface Dungeon {
     /** Hook function called on every data point. The primary mechanism for engineering deliberate trends and patterns. */
     hook?: Hook<any>;
 
+    // ── Advanced Features ──
+    /** User persona/archetype definitions. Each persona defines a behavioral segment with distinct event volumes, conversion rates, and properties. */
+    personas?: Persona[];
+    /** World events that affect all users simultaneously (outages, campaigns, product launches). */
+    worldEvents?: WorldEvent[] | ResolvedWorldEvent[];
+    /** Engagement decay configuration. Controls how user activity decreases over their lifetime. */
+    engagementDecay?: EngagementDecay;
+    /** Data quality imperfections to inject (nulls, duplicates, bots, late-arriving events). */
+    dataQuality?: DataQuality;
+    /** Subscription/revenue lifecycle configuration. */
+    subscription?: Subscription;
+    /** Connected attribution configuration linking campaigns to user acquisition. */
+    attribution?: Attribution;
+    /** Geographic intelligence: sticky locations, timezone-aware activity, regional launches. */
+    geo?: GeoConfig;
+    /** Progressive feature adoption: features that launch mid-dataset with S-curve adoption. */
+    features?: FeatureConfig[];
+    /** Anomaly/outlier injection: extreme values, bursts, coordinated spikes. */
+    anomalies?: AnomalyConfig[];
+
     /** Allow arbitrary additional properties on the config. */
     [key: string]: any;
 
@@ -263,7 +283,7 @@ export interface Defaults {
     browsers: () => any[];
     campaigns: () => any[];
     devicePools: { android: any[]; ios: any[]; desktop: any[] };
-    allDevices:any[];
+    allDevices: any[];
 }
 
 /**
@@ -520,6 +540,298 @@ export type Result = {
     avgEPS?: number;
 };
 
+// ============= Advanced Feature Types =============
+
+/**
+ * User persona/archetype definition.
+ * Personas define behavioral segments with distinct event volumes, conversion rates, and properties.
+ */
+export interface Persona {
+    /** Unique name for this persona (e.g., "power_user", "casual", "churner"). */
+    name: string;
+    /** Relative weight for persona assignment (higher = more users get this persona). */
+    weight: number;
+    /** Multiplier for number of events this persona generates (1.0 = normal). */
+    eventMultiplier?: number;
+    /** Multiplier for funnel conversion rates (1.0 = normal, 1.3 = 30% better). */
+    conversionModifier?: number;
+    /** Base churn rate for this persona (0-1). */
+    churnRate?: number;
+    /** Properties merged into user profiles for this persona. */
+    properties?: Record<string, ValueValid>;
+    /** Limit how long this persona is active (e.g., trial users active for 14 days). */
+    activeWindow?: { maxDays: number };
+    /** Per-persona engagement decay override. */
+    engagementDecay?: EngagementDecay;
+    /** Per-persona soup/timing override. */
+    soupOverride?: SoupConfig;
+}
+
+/**
+ * World event that affects all users simultaneously.
+ */
+export interface WorldEvent {
+    /** Name of the world event (e.g., "black_friday", "platform_outage"). */
+    name: string;
+    /** Type category for the event. */
+    type?: "campaign" | "outage" | "product_launch" | "holiday" | "incident" | string;
+    /** Start day relative to dataset start (e.g., 60 = day 60). */
+    startDay: number;
+    /** Duration in days (0.25 = 6 hours, null = permanent from startDay onward). */
+    duration?: number | null;
+    /** Volume multiplier during this event (3.0 = 3x events, 0.1 = 90% drop). */
+    volumeMultiplier?: number;
+    /** Conversion rate modifier during this event. */
+    conversionModifier?: number;
+    /** Properties injected into affected events. */
+    injectProps?: Record<string, any>;
+    /** Which events are affected ("*" for all, or array of event names). */
+    affectsEvents?: string[] | "*";
+    /** Aftermath period after the event ends. */
+    aftermath?: { duration: number; volumeMultiplier: number };
+}
+
+/**
+ * Resolved world event with absolute timestamps (internal use).
+ */
+export interface ResolvedWorldEvent extends WorldEvent {
+    /** Absolute start time (unix seconds). */
+    startUnix: number;
+    /** Absolute end time (unix seconds), or Infinity for permanent events. */
+    endUnix: number;
+    /** Aftermath end time (unix seconds), if applicable. */
+    aftermathEndUnix?: number;
+}
+
+/**
+ * Engagement decay configuration.
+ */
+export interface EngagementDecay {
+    /** Decay model type. "none" preserves flat engagement (default). */
+    model: "exponential" | "linear" | "step" | "none";
+    /** Days until engagement halves (for exponential model). */
+    halfLife?: number;
+    /** Minimum engagement ratio (0 = can fully churn, 0.1 = never below 10%). */
+    floor?: number;
+    /** Per-day chance of re-engagement spike after decay. */
+    reactivationChance?: number;
+    /** Multiplier for engagement during reactivation. */
+    reactivationMultiplier?: number;
+}
+
+/**
+ * Data quality imperfection configuration.
+ */
+export interface DataQuality {
+    /** Fraction of property values that become null (0-1). */
+    nullRate?: number;
+    /** Which properties to null ("*" for any, or array of property names). */
+    nullProps?: string[] | "*";
+    /** Fraction of events that get duplicated (0-1). */
+    duplicateRate?: number;
+    /** Fraction of events that arrive late (shifted 1-7 days backward) (0-1). */
+    lateArrivingRate?: number;
+    /** Number of synthetic bot users to inject. */
+    botUsers?: number;
+    /** Events per bot user (bots generate repetitive, machine-like patterns). */
+    botEventsPerUser?: number;
+    /** Fraction of events with timezone offset errors (0-1). */
+    timezoneConfusion?: number;
+    /** Fraction of events missing their event name (0-1). */
+    emptyEvents?: number;
+}
+
+/**
+ * Subscription plan definition.
+ */
+export interface SubscriptionPlan {
+    /** Plan name (e.g., "free", "starter", "pro"). */
+    name: string;
+    /** Monthly price. 0 for free tier. */
+    price: number;
+    /** If true, users start on this plan. */
+    default?: boolean;
+    /** Trial period in days before requiring payment. */
+    trialDays?: number;
+}
+
+/**
+ * Subscription lifecycle rates.
+ */
+export interface SubscriptionLifecycle {
+    /** Rate of trial-to-paid conversion (0-1). */
+    trialToPayRate?: number;
+    /** Monthly upgrade rate (0-1). */
+    upgradeRate?: number;
+    /** Monthly downgrade rate (0-1). */
+    downgradeRate?: number;
+    /** Monthly churn/cancellation rate (0-1). */
+    churnRate?: number;
+    /** Rate of churned users who come back (0-1). */
+    winBackRate?: number;
+    /** Days before win-back attempt. */
+    winBackDelay?: number;
+    /** Rate of payment failures (0-1). */
+    paymentFailureRate?: number;
+}
+
+/**
+ * Subscription configuration.
+ */
+export interface Subscription {
+    /** Available plans, ordered from lowest to highest tier. */
+    plans: SubscriptionPlan[];
+    /** Lifecycle transition rates. */
+    lifecycle?: SubscriptionLifecycle;
+    /** Event names for subscription lifecycle events. */
+    events?: {
+        trialStarted?: string;
+        subscribed?: string;
+        upgraded?: string;
+        downgraded?: string;
+        renewed?: string;
+        cancelled?: string;
+        paymentFailed?: string;
+        wonBack?: string;
+    };
+}
+
+/**
+ * Attribution campaign definition.
+ */
+export interface AttributionCampaign {
+    /** Campaign name. */
+    name: string;
+    /** UTM source (e.g., "google", "facebook"). */
+    source: string;
+    /** UTM medium (e.g., "search_ad", "social"). */
+    medium?: string;
+    /** UTM content (e.g., "variant_a", "hero_image"). */
+    utm_content?: string;
+    /** UTM term (e.g., "running+shoes", "best+deals"). */
+    utm_term?: string;
+    /** Active days range [startDay, endDay] relative to dataset start. */
+    activeDays: [number, number];
+    /** Daily budget range [min, max]. */
+    dailyBudget?: [number, number];
+    /** Fraction of impressions that become users (0-1). */
+    acquisitionRate?: number;
+    /** Persona weight biases for users acquired by this campaign. */
+    userPersonaBias?: Record<string, number>;
+}
+
+/**
+ * Connected attribution configuration.
+ */
+export interface Attribution {
+    /** Attribution model type. */
+    model?: "last_touch" | "first_touch" | "linear" | "time_decay";
+    /** Attribution window in days. */
+    window?: number;
+    /** Campaign definitions. */
+    campaigns: AttributionCampaign[];
+    /** Fraction of users who arrive organically (no campaign) (0-1). */
+    organicRate?: number;
+}
+
+/**
+ * Geographic region definition.
+ */
+export interface GeoRegion {
+    /** Region name (e.g., "north_america"). */
+    name: string;
+    /** Country codes in this region. */
+    countries: string[];
+    /** Weight for user assignment (higher = more users). */
+    weight: number;
+    /** UTC timezone offset for this region (e.g., -5 for EST). */
+    timezoneOffset: number;
+    /** Properties injected for users in this region. */
+    properties?: Record<string, any>;
+}
+
+/**
+ * Regional feature launch definition.
+ */
+export interface RegionalLaunch {
+    /** Region name to match. */
+    region: string;
+    /** Feature name. */
+    featureName: string;
+    /** Day the feature launches in this region. */
+    startDay: number;
+}
+
+/**
+ * Geographic intelligence configuration.
+ */
+export interface GeoConfig {
+    /** If true, users keep their location across all events (default: false for backwards compat). */
+    sticky?: boolean;
+    /** Region definitions with timezone offsets and properties. */
+    regions?: GeoRegion[];
+    /** Regional feature launches. */
+    regionalLaunches?: RegionalLaunch[];
+}
+
+/**
+ * Progressive feature adoption configuration.
+ */
+export interface FeatureConfig {
+    /** Feature name (e.g., "dark_mode", "ai_recommendations"). */
+    name: string;
+    /** Day the feature launches (relative to dataset start). */
+    launchDay: number;
+    /** Adoption curve speed or custom logistic params. */
+    adoptionCurve?: "fast" | "slow" | "instant" | { k: number; midpoint: number };
+    /** Property name to inject on events. */
+    property: string;
+    /** Possible values for the property. First value is the "before" default if defaultBefore not set. */
+    values: any[];
+    /** Default value before the feature launches. If not set, property doesn't exist before launch. */
+    defaultBefore?: any;
+    /** Which events are affected ("*" for all, or array of event names). */
+    affectsEvents?: string[] | "*";
+    /** Conversion rate lift for users who adopted the feature. */
+    conversionLift?: number;
+    /** Resolved logistic curve params (set by config-validator). */
+    _resolvedCurve?: { k: number; midpoint: number };
+    /** Pre-computed adopted values (set by config-validator). */
+    _adoptedValues?: any[];
+}
+
+/**
+ * Anomaly/outlier configuration.
+ */
+export interface AnomalyConfig {
+    /** Type of anomaly. */
+    type: "extreme_value" | "burst" | "coordinated";
+    /** Event name this anomaly applies to. */
+    event: string;
+    /** For extreme_value: property to modify. */
+    property?: string;
+    /** For extreme_value: fraction of events affected (0-1). */
+    frequency?: number;
+    /** For extreme_value: multiplier applied to the property value. */
+    multiplier?: number;
+    /** Tag property added to anomalous events. */
+    tag?: string;
+    /** For burst/coordinated: day when the anomaly occurs. */
+    day?: number;
+    /** For burst: duration in days (0.083 = ~2 hours). */
+    duration?: number;
+    /** For burst/coordinated: time window in days (0.01 = ~15 minutes). */
+    window?: number;
+    /** For burst/coordinated: number of events to inject. */
+    count?: number;
+    /** Properties injected on anomalous events. */
+    properties?: Record<string, any>;
+    /** Resolved absolute start time in unix seconds (set by config-validator). */
+    _startUnix?: number;
+    /** Resolved absolute end time in unix seconds (set by config-validator). */
+    _endUnix?: number;
+}
+
 /**
  * dungeon-master: generate realistic Mixpanel data at scale
  *

package/dungeons/array-of-object-lookup-schema.json

@@ -1,327 +0,0 @@
-{
-  "schema": {
-    "seed": "test array of objects lookup",
-    "name": "array-of-object-lookup",
-    "numDays": 60,
-    "numEvents": 100000,
-    "numUsers": 1000,
-    "format": "json",
-    "region": "US",
-    "hasAnonIds": true,
-    "hasSessionIds": true,
-    "hasAdSpend": false,
-    "hasLocation": true,
-    "hasAndroidDevices": false,
-    "hasIOSDevices": false,
-    "hasDesktopDevices": true,
-    "hasBrowser": true,
-    "hasCampaigns": false,
-    "isAnonymous": false,
-    "alsoInferFunnels": true,
-    "concurrency": 1,
-    "batchSize": 250000,
-    "writeToDisk": false,
-    "events": [
-      {
-        "event": "checkout",
-        "weight": 2,
-        "properties": {
-          "currency": [
-            "USD",
-            "CAD",
-            "EUR",
-            "BTC",
-            "ETH",
-            "JPY"
-          ],
-          "coupon": {
-            "functionName": "arrow",
-            "body": "function generateWeightedArray() {\n\t\tconst weightedArray = [];\n\n\t\t// Add each value to the array the number of times specified by its weight\n\t\tweightedItems.forEach(({ value, weight }) => {\n\t\t\tif (!weight) weight = 1;\n\t\t\tfor (let i = 0; i < weight; i++) {\n\t\t\t\tweightedArray.push(value);\n\t\t\t}\n\t\t});\n\n\t\treturn weightedArray;\n\t}"
-          },
-          "cart": {
-            "functionName": "arrow",
-            "body": "function () {\n\t\tconst categories = [\"electronics\", \"books\", \"clothing\", \"home\", \"garden\", \"toys\", \"sports\", \"automotive\", \"beauty\", \"health\", \"grocery\", \"jewelry\", \"shoes\", \"tools\", \"office supplies\"];\n\t\tconst descriptors = [\"brand new\", \"open box\", \"refurbished\", \"used\", \"like new\", \"vintage\", \"antique\", \"collectible\"];\n\t\tconst suffix = [\"item\", \"product\", \"good\", \"merchandise\", \"thing\", \"object\", \"widget\", \"gadget\", \"device\", \"apparatus\", \"contraption\", \"instrument\", \"tool\", \"implement\", \"utensil\", \"appliance\", \"machine\", \"equipment\", \"gear\", \"kit\", \"set\", \"package\"];\n\t\tconst assetPreview = ['.png', '.jpg', '.jpeg', '.heic', '.mp4', '.mov', '.avi'];\n\t\tconst data = [];\n\t\tconst numOfItems = integer(1, maxItems);\n\n\t\tfor (var i = 0; i < numOfItems; i++) {\n\t\t\tconst category = chance.pickone(categories);\n\t\t\tconst descriptor = chance.pickone(descriptors);\n\t\t\tconst suffixWord = chance.pickone(suffix);\n\t\t\tconst slug = `${descriptor.replace(/\\s+/g, '-').toLowerCase()}-${suffixWord.replace(/\\s+/g, '-').toLowerCase()}`;\n\t\t\tconst asset = chance.pickone(assetPreview);\n\n\t\t\t// const product_id = chance.guid();\n\t\t\tconst price = integer(1, 100);\n\t\t\tconst quantity = integer(1, 5);\n\t\t\tconst product_id = integer(1, 1_000);\n\n\t\t\tconst item = {\n\t\t\t\tproduct_id: product_id,\n\t\t\t\tproduct_url: `https://example.com/assets/${product_id}`,\n\t\t\t\t// sku: integer(11111, 99999),\n\t\t\t\t// amount: price,\n\t\t\t\t// quantity: quantity,\n\t\t\t\t// total_value: price * quantity,\n\t\t\t\t// featured: chance.pickone([true, false, false]),\n\t\t\t\t// category: category,\n\t\t\t\t// descriptor: descriptor,\n\t\t\t\t// slug: slug,\n\t\t\t\t\n\t\t\t\t// assetType: asset\n\n\t\t\t};\n\n\t\t\tdata.push(item);\n\t\t}\n\n\t\treturn () => [data];\n\t}"
-          }
-        }
-      },
-      {
-        "event": "add to cart",
-        "weight": 4,
-        "properties": {
-          "item": {
-            "functionName": "arrow",
-            "body": "function () {\n\t\tconst categories = [\"electronics\", \"books\", \"clothing\", \"home\", \"garden\", \"toys\", \"sports\", \"automotive\", \"beauty\", \"health\", \"grocery\", \"jewelry\", \"shoes\", \"tools\", \"office supplies\"];\n\t\tconst descriptors = [\"brand new\", \"open box\", \"refurbished\", \"used\", \"like new\", \"vintage\", \"antique\", \"collectible\"];\n\t\tconst suffix = [\"item\", \"product\", \"good\", \"merchandise\", \"thing\", \"object\", \"widget\", \"gadget\", \"device\", \"apparatus\", \"contraption\", \"instrument\", \"tool\", \"implement\", \"utensil\", \"appliance\", \"machine\", \"equipment\", \"gear\", \"kit\", \"set\", \"package\"];\n\t\tconst assetPreview = ['.png', '.jpg', '.jpeg', '.heic', '.mp4', '.mov', '.avi'];\n\t\tconst data = [];\n\t\tconst numOfItems = integer(1, maxItems);\n\n\t\tfor (var i = 0; i < numOfItems; i++) {\n\t\t\tconst category = chance.pickone(categories);\n\t\t\tconst descriptor = chance.pickone(descriptors);\n\t\t\tconst suffixWord = chance.pickone(suffix);\n\t\t\tconst slug = `${descriptor.replace(/\\s+/g, '-').toLowerCase()}-${suffixWord.replace(/\\s+/g, '-').toLowerCase()}`;\n\t\t\tconst asset = chance.pickone(assetPreview);\n\n\t\t\t// const product_id = chance.guid();\n\t\t\tconst price = integer(1, 100);\n\t\t\tconst quantity = integer(1, 5);\n\t\t\tconst product_id = integer(1, 1_000);\n\n\t\t\tconst item = {\n\t\t\t\tproduct_id: product_id,\n\t\t\t\tproduct_url: `https://example.com/assets/${product_id}`,\n\t\t\t\t// sku: integer(11111, 99999),\n\t\t\t\t// amount: price,\n\t\t\t\t// quantity: quantity,\n\t\t\t\t// total_value: price * quantity,\n\t\t\t\t// featured: chance.pickone([true, false, false]),\n\t\t\t\t// category: category,\n\t\t\t\t// descriptor: descriptor,\n\t\t\t\t// slug: slug,\n\t\t\t\t\n\t\t\t\t// assetType: asset\n\n\t\t\t};\n\n\t\t\tdata.push(item);\n\t\t}\n\n\t\treturn () => [data];\n\t}"
-          }
-        }
-      },
-      {
-        "event": "view item",
-        "weight": 8,
-        "properties": {
-          "item": {
-            "functionName": "arrow",
-            "body": "function () {\n\t\tconst categories = [\"electronics\", \"books\", \"clothing\", \"home\", \"garden\", \"toys\", \"sports\", \"automotive\", \"beauty\", \"health\", \"grocery\", \"jewelry\", \"shoes\", \"tools\", \"office supplies\"];\n\t\tconst descriptors = [\"brand new\", \"open box\", \"refurbished\", \"used\", \"like new\", \"vintage\", \"antique\", \"collectible\"];\n\t\tconst suffix = [\"item\", \"product\", \"good\", \"merchandise\", \"thing\", \"object\", \"widget\", \"gadget\", \"device\", \"apparatus\", \"contraption\", \"instrument\", \"tool\", \"implement\", \"utensil\", \"appliance\", \"machine\", \"equipment\", \"gear\", \"kit\", \"set\", \"package\"];\n\t\tconst assetPreview = ['.png', '.jpg', '.jpeg', '.heic', '.mp4', '.mov', '.avi'];\n\t\tconst data = [];\n\t\tconst numOfItems = integer(1, maxItems);\n\n\t\tfor (var i = 0; i < numOfItems; i++) {\n\t\t\tconst category = chance.pickone(categories);\n\t\t\tconst descriptor = chance.pickone(descriptors);\n\t\t\tconst suffixWord = chance.pickone(suffix);\n\t\t\tconst slug = `${descriptor.replace(/\\s+/g, '-').toLowerCase()}-${suffixWord.replace(/\\s+/g, '-').toLowerCase()}`;\n\t\t\tconst asset = chance.pickone(assetPreview);\n\n\t\t\t// const product_id = chance.guid();\n\t\t\tconst price = integer(1, 100);\n\t\t\tconst quantity = integer(1, 5);\n\t\t\tconst product_id = integer(1, 1_000);\n\n\t\t\tconst item = {\n\t\t\t\tproduct_id: product_id,\n\t\t\t\tproduct_url: `https://example.com/assets/${product_id}`,\n\t\t\t\t// sku: integer(11111, 99999),\n\t\t\t\t// amount: price,\n\t\t\t\t// quantity: quantity,\n\t\t\t\t// total_value: price * quantity,\n\t\t\t\t// featured: chance.pickone([true, false, false]),\n\t\t\t\t// category: category,\n\t\t\t\t// descriptor: descriptor,\n\t\t\t\t// slug: slug,\n\t\t\t\t\n\t\t\t\t// assetType: asset\n\n\t\t\t};\n\n\t\t\tdata.push(item);\n\t\t}\n\n\t\treturn () => [data];\n\t}"
-          }
-        }
-      },
-      {
-        "event": "save item",
-        "weight": 5,
-        "properties": {
-          "item": {
-            "functionName": "arrow",
-            "body": "function () {\n\t\tconst categories = [\"electronics\", \"books\", \"clothing\", \"home\", \"garden\", \"toys\", \"sports\", \"automotive\", \"beauty\", \"health\", \"grocery\", \"jewelry\", \"shoes\", \"tools\", \"office supplies\"];\n\t\tconst descriptors = [\"brand new\", \"open box\", \"refurbished\", \"used\", \"like new\", \"vintage\", \"antique\", \"collectible\"];\n\t\tconst suffix = [\"item\", \"product\", \"good\", \"merchandise\", \"thing\", \"object\", \"widget\", \"gadget\", \"device\", \"apparatus\", \"contraption\", \"instrument\", \"tool\", \"implement\", \"utensil\", \"appliance\", \"machine\", \"equipment\", \"gear\", \"kit\", \"set\", \"package\"];\n\t\tconst assetPreview = ['.png', '.jpg', '.jpeg', '.heic', '.mp4', '.mov', '.avi'];\n\t\tconst data = [];\n\t\tconst numOfItems = integer(1, maxItems);\n\n\t\tfor (var i = 0; i < numOfItems; i++) {\n\t\t\tconst category = chance.pickone(categories);\n\t\t\tconst descriptor = chance.pickone(descriptors);\n\t\t\tconst suffixWord = chance.pickone(suffix);\n\t\t\tconst slug = `${descriptor.replace(/\\s+/g, '-').toLowerCase()}-${suffixWord.replace(/\\s+/g, '-').toLowerCase()}`;\n\t\t\tconst asset = chance.pickone(assetPreview);\n\n\t\t\t// const product_id = chance.guid();\n\t\t\tconst price = integer(1, 100);\n\t\t\tconst quantity = integer(1, 5);\n\t\t\tconst product_id = integer(1, 1_000);\n\n\t\t\tconst item = {\n\t\t\t\tproduct_id: product_id,\n\t\t\t\tproduct_url: `https://example.com/assets/${product_id}`,\n\t\t\t\t// sku: integer(11111, 99999),\n\t\t\t\t// amount: price,\n\t\t\t\t// quantity: quantity,\n\t\t\t\t// total_value: price * quantity,\n\t\t\t\t// featured: chance.pickone([true, false, false]),\n\t\t\t\t// category: category,\n\t\t\t\t// descriptor: descriptor,\n\t\t\t\t// slug: slug,\n\t\t\t\t\n\t\t\t\t// assetType: asset\n\n\t\t\t};\n\n\t\t\tdata.push(item);\n\t\t}\n\n\t\treturn () => [data];\n\t}"
-          }
-        }
-      }
-    ],
-    "funnels": [],
-    "superProps": {
-      "theme": {
-        "functionName": "arrow",
-        "body": "function () {\n\t\tconst weighted = [];\n\t\tfor (let i = 0; i < 10; i++) {\n\t\t\tconst rand = chance.d10(); // Random number between 1 and 10\n\n\t\t\t// 35% chance to favor the most chosen index\n\t\t\tif (chance.bool({ likelihood: 35 })) {\n\t\t\t\t// 50% chance to slightly alter the index\n\t\t\t\tif (chance.bool({ likelihood: 50 })) {\n\t\t\t\t\tweighted.push(items[mostChosenIndex]);\n\t\t\t\t} else {\n\t\t\t\t\tconst addOrSubtract = chance.bool({ likelihood: 50 }) ? -rand : rand;\n\t\t\t\t\tlet newIndex = mostChosenIndex + addOrSubtract;\n\n\t\t\t\t\t// Ensure newIndex is within bounds\n\t\t\t\t\tif (newIndex < 0) newIndex = 0;\n\t\t\t\t\tif (newIndex >= items.length) newIndex = items.length - 1;\n\t\t\t\t\tweighted.push(items[newIndex]);\n\t\t\t\t}\n\t\t\t}\n\t\t\t// 25% chance to favor the second most chosen index\n\t\t\telse if (chance.bool({ likelihood: 25 })) {\n\t\t\t\tweighted.push(items[secondMostChosenIndex]);\n\t\t\t}\n\t\t\t// 15% chance to favor the third most chosen index\n\t\t\telse if (chance.bool({ likelihood: 15 })) {\n\t\t\t\tweighted.push(items[thirdMostChosenIndex]);\n\t\t\t}\n\t\t\t// Otherwise, pick a random item from the list\n\t\t\telse {\n\t\t\t\tweighted.push(chance.pickone(items));\n\t\t\t}\n\t\t}\n\t\treturn weighted;\n\t}"
-      }
-    },
-    "userProps": {
-      "spiritAnimal": [
-        "duck",
-        "dog",
-        "otter",
-        "penguin",
-        "cat",
-        "elephant",
-        "lion",
-        "cheetah",
-        "giraffe",
-        "zebra",
-        "rhino",
-        "hippo",
-        "whale",
-        "dolphin",
-        "shark",
-        "octopus",
-        "squid",
-        "jellyfish",
-        "starfish",
-        "seahorse",
-        "crab",
-        "lobster",
-        "shrimp",
-        "clam",
-        "snail",
-        "slug",
-        "butterfly",
-        "moth",
-        "bee",
-        "wasp",
-        "ant",
-        "beetle",
-        "ladybug",
-        "caterpillar",
-        "centipede",
-        "millipede",
-        "scorpion",
-        "spider",
-        "tarantula",
-        "tick",
-        "mite",
-        "mosquito",
-        "fly",
-        "dragonfly",
-        "damselfly",
-        "grasshopper",
-        "cricket",
-        "locust",
-        "mantis",
-        "cockroach",
-        "termite",
-        "praying mantis",
-        "walking stick",
-        "stick bug",
-        "leaf insect",
-        "lacewing",
-        "aphid",
-        "cicada",
-        "thrips",
-        "psyllid",
-        "scale insect",
-        "whitefly",
-        "mealybug",
-        "planthopper",
-        "leafhopper",
-        "treehopper",
-        "flea",
-        "louse",
-        "bedbug",
-        "flea beetle",
-        "weevil",
-        "longhorn beetle",
-        "leaf beetle",
-        "tiger beetle",
-        "ground beetle",
-        "lady beetle",
-        "firefly",
-        "click beetle",
-        "rove beetle",
-        "scarab beetle",
-        "dung beetle",
-        "stag beetle",
-        "rhinoceros beetle",
-        "hercules beetle",
-        "goliath beetle",
-        "jewel beetle",
-        "tortoise beetle"
-      ]
-    },
-    "scdProps": {},
-    "mirrorProps": {},
-    "groupKeys": [],
-    "groupProps": {},
-    "lookupTables": [
-      {
-        "key": "product_id",
-        "entries": 1000,
-        "attributes": {
-          "amount": [
-            259,
-            247,
-            271,
-            269,
-            209,
-            305,
-            706,
-            344,
-            350,
-            327,
-            259,
-            225,
-            269,
-            267,
-            256,
-            705,
-            196,
-            588,
-            775,
-            235,
-            737,
-            341,
-            268,
-            409,
-            233,
-            246,
-            239,
-            737,
-            701,
-            741,
-            227,
-            230,
-            693,
-            719,
-            277,
-            706,
-            292,
-            274,
-            596,
-            263,
-            250,
-            279,
-            275,
-            799,
-            236,
-            267,
-            221,
-            230,
-            730,
-            789
-          ],
-          "quantity": [
-            4,
-            5,
-            7,
-            4,
-            8,
-            6,
-            3,
-            3,
-            4,
-            6,
-            3,
-            3,
-            8,
-            3,
-            3,
-            8,
-            3,
-            8,
-            7,
-            4,
-            8,
-            4,
-            4,
-            4,
-            4,
-            3,
-            5,
-            4,
-            3,
-            3,
-            3,
-            7,
-            3,
-            3,
-            4,
-            4,
-            6,
-            4,
-            7,
-            7,
-            4,
-            3,
-            3,
-            3,
-            3,
-            4,
-            8,
-            3,
-            3,
-            3
-          ],
-          "featured": {
-            "functionName": "arrow",
-            "body": "function flip(likelihood = 50) {\n\treturn chance.bool({ likelihood });\n}"
-          },
-          "category": [
-            "electronics",
-            "books",
-            "clothing",
-            "home",
-            "garden",
-            "toys",
-            "sports",
-            "automotive",
-            "beauty",
-            "health",
-            "grocery",
-            "jewelry",
-            "shoes",
-            "tools",
-            "office supplies"
-          ],
-          "descriptor": [
-            "brand new",
-            "open box",
-            "refurbished",
-            "used",
-            "like new",
-            "vintage",
-            "antique",
-            "collectible"
-          ]
-        }
-      }
-    ]
-  },
-  "hooks": "function (record, type, meta) {\n\n\t\tconst NOW = dayjs();\n\n\t\tif (type === \"event\") {\n\t\t\t// Pattern 1: Checkouts with coupons get a discount_applied flag and adjusted total\n\t\t\tif (record.event === \"checkout\" && record.coupon && record.coupon !== \"none\") {\n\t\t\t\trecord.discount_applied = true;\n\t\t\t\tconst pctMatch = record.coupon.match(/(\\d+)%/);\n\t\t\t\tif (pctMatch) {\n\t\t\t\t\trecord.discount_percent = parseInt(pctMatch[1]);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Pattern 2: \"save item\" events on weekends are tagged as wishlist behavior\n\t\t\tif (record.event === \"save item\") {\n\t\t\t\tconst dow = dayjs(record.time).day();\n\t\t\t\tif (dow === 0 || dow === 6) {\n\t\t\t\t\trecord.save_context = \"weekend_browse\";\n\t\t\t\t} else {\n\t\t\t\t\trecord.save_context = \"weekday_intent\";\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (type === \"everything\") {\n\t\t\t// Pattern 3: Users who view 5+ items but never checkout are tagged as window shoppers\n\t\t\tconst views = record.filter(e => e.event === \"view item\").length;\n\t\t\tconst checkouts = record.filter(e => e.event === \"checkout\").length;\n\t\t\tif (views >= 5 && checkouts === 0) {\n\t\t\t\tfor (const e of record) {\n\t\t\t\t\te.user_segment = \"window_shopper\";\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn record;\n\t}",
-  "timestamp": "2026-04-10T01:39:06.554Z",
-  "version": "4.0"
-}