@ak--47/dungeon-master 1.4.5 → 1.5.1

package/dungeons/vertical/ecommerce.js

@@ -1,78 +1,40 @@
-// ── TWEAK THESE ──
-const SEED = "simple is best";
-const num_days = 120;
-const num_users = 42_000;
-const avg_events_per_user_per_day = 0.37;
-let token = "your-mixpanel-token";
-
-// ── env overrides ──
-if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
-
+// ── IMPORTS ──
 import dayjs from "dayjs";
 import utc from "dayjs/plugin/utc.js";
 dayjs.extend(utc);
-import { uid, comma } from 'ak-tools';
-import { weighNumRange, date, integer, weighChoices, decimal, initChance } from "../../lib/utils/utils.js";
+import { uid } from "ak-tools";
+import { weighNumRange, integer, weighChoices, decimal, initChance } from "../../lib/utils/utils.js";
 import { scaleFunnelTTC } from "../../lib/hook-helpers/timing.js";
-const chance = initChance(SEED);
-
 /** @typedef {import("../../types").Dungeon} Config */
-const itemCategories = ["Books", "Movies", "Music", "Games", "Electronics", "Computers", "Smart Home", "Home", "Garden", "Pet", "Beauty", "Health", "Toys", "Kids", "Baby", "Handmade", "Sports", "Outdoors", "Automotive", "Industrial", "Entertainment", "Art", "Food", "Appliances", "Office", "Wedding", "Software"];
-const videoCategories = ["funny", "educational", "inspirational", "music", "news", "sports", "cooking", "DIY", "travel", "gaming"];
-const spiritAnimals = ["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"];
 
+// ── OVERVIEW ──
 /*
- * ============================================================================
- * DATASET OVERVIEW
- * ============================================================================
- *
- * App: eCommerce marketplace with integrated video content
- * Scale: 50K users, 2M events, 108 days
- *
- * Core loop: Users browse products, watch videos, build carts, and check out.
- * A signup funnel converts browsers into registered users. Video engagement
- * (likes/dislikes) runs alongside the shopping flow.
- *
- * Events:
- *   page view (10) > view item (8) > watch video (8) > like video (6)
- *   > save item (5) > add to cart (4) > dislike video (4) > checkout (2) > sign up (1)
- *
- * Funnels:
- *   - Signup Flow: page view → view item → save item → page view → sign up (50%)
- *   - Video Likes: watch → like → watch → like (60%)
- *   - Video Dislikes: watch → dislike → watch → dislike (20%)
- *   - eCommerce Purchase: view → view → add to cart → view → add to cart → checkout (15%)
- *
- * User props: title, luckyNumber, spiritAnimal
- * Super props: theme (light/dark/custom)
- * ============================================================================
+ * NAME:       ShopStream
+ * APP:        eCommerce marketplace with integrated video content. Users browse
+ *             products, watch videos, build carts, and check out. A signup
+ *             funnel converts anonymous browsers into registered users; video
+ *             engagement (like/dislike) runs alongside the shopping flow.
+ * SCALE:      42,000 users, ~2M events, 121 days (2026-01-01 → 2026-05-01)
+ * CORE LOOP:  page view → view item → save/add to cart → checkout (+ video like/dislike side loop)
+ *
+ * EVENTS (9):
+ *   page view (10) > view item (8) > watch video (8) > like video (6) > save item (5)
+ *   > add to cart (4) > dislike video (4) > checkout (2) > sign up (1)
+ *
+ * FUNNELS (4):
+ *   - Signup Flow:        page view → view item → save item → page view → sign up (50%)
+ *   - Video Likes:        watch video → like video → watch video → like video (60%)
+ *   - Video Dislikes:     watch video → dislike video → watch video → dislike video (20%)
+ *   - eCommerce Purchase: view item → view item → add to cart → view item → add to cart → checkout (15%, A/B/C experiment)
+ *
+ * USER PROPS:  title, luckyNumber, spiritAnimal, theme
+ * SUPER PROPS: theme
+ * SCD PROPS:   loyalty_tier (bronze/silver/gold/platinum, monthly fuzzy, max 8)
+ * GROUPS:      none
  */
 
+// ── HOOK STORIES ──
 /*
- * ============================================================================
- * ANALYTICS HOOKS (10 hooks)
- *
- * Adds 7. SIGNUP FLOW TIME-TO-CONVERT: gold/platinum loyalty 0.67x faster,
- * bronze 1.33x slower (everything hook via scaleFunnelTTC on the page-view-
- * to-sign-up window). Loyalty tier is determined from SCD data
- * (meta.scd.loyalty_tier) with deterministic hash fallback. Discover via
- * bound-sequence funnel TTC breakdown by loyalty tier.
- *
- * Adds 8. CHECKOUT FLOW EXPERIMENT: A/B/C experiment on the eCommerce
- * Purchase funnel — "Control", "Express Checkout" (1.25x conversion),
- * "Social Proof" (1.15x conversion, 0.9x TTC). Engine-managed via funnel
- * experiment config; starts 30 days before dataset end.
- *
- * Adds 9. DARK THEME POWER USERS: funnel-pre hook that boosts purchase
- * funnel conversion 1.3x for dark-theme users and penalizes light-theme
- * users to 0.85x. Discoverable by breakdown of funnel conversion by theme.
- *
- * Adds 10. SAVE-ITEM RETENTION: born-in-dataset users who save 2+ items
- * in their first 10 days retain long-term; those below threshold lose ~70%
- * of post-day-25 events. Discoverable by retention or frequency analysis
- * segmented by early save-item count.
- * ============================================================================
- *
  * ----------------------------------------------------------------------------
  * Hook 1: Signup Flow Improvement (event + everything)
  * ----------------------------------------------------------------------------
@@ -386,30 +348,69 @@ const spiritAnimals = ["duck", "dog", "otter", "penguin", "cat", "elephant", "li
  * ============================================================================
  */
 
+// ── SCALE ──
+const SEED = "simple is best";
+const NUM_USERS = 42_000;
+const DATASET_START = "2026-01-01T00:00:00Z";
+const DATASET_END = "2026-05-01T23:59:59Z";
+const EVENTS_PER_DAY = 0.37;
+const token = process.env.MP_TOKEN || "your-mixpanel-token";
+
+const chance = initChance(SEED);
+
+// ── KNOBS (tweak these to reshape stories) ──
+const SIGNUP_FIX_DAYS_AGO = 7;
+const WATCH_INFLECTION_DAYS_AGO = 30;
+const WATCH_FACTOR_MIN = 0.25;
+const WATCH_FACTOR_MAX = 0.79;
+const VIEW_SWEET_MIN = 3;
+const VIEW_SWEET_MAX = 8;
+const VIEW_OVER_THRESHOLD = 9;
+const SWEET_CART_BOOST = 1.25;
+const SWEET_CLONE_LIKELIHOOD = 45;
+const OVER_CHECKOUT_DROP_LIKELIHOOD = 30;
+const LOYALTY_TTC_FAST = 0.67;
+const LOYALTY_TTC_SLOW = 1.33;
+const LOYALTY_LOOKBACK_DAYS = 2;
+const SAVE_RETENTION_MIN = 2;
+const SAVE_RETENTION_WINDOW_DAYS = 10;
+const SAVE_RETENTION_CUTOFF_DAYS = 25;
+const SAVE_RETENTION_DROP_LIKELIHOOD = 70;
+const QUALITY_FACTORS = {
+	"2160p": 1.5,
+	"1440p": 1.4,
+	"1080p": 1.3,
+	"720p": 1.15,
+	"480p": 1.0,
+	"360p": 0.85,
+	"240p": 0.7,
+};
 
+// ── DATA ARRAYS ──
+const videoCategories = ["funny", "educational", "inspirational", "music", "news", "sports", "cooking", "DIY", "travel", "gaming"];
+const spiritAnimals = ["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"];
+const productCategories = ["electronics", "books", "clothing", "home", "garden", "toys", "sports", "automotive", "beauty", "health", "grocery", "jewelry", "shoes", "tools", "office supplies"];
+const productDescriptors = ["brand new", "open box", "refurbished", "used", "like new", "vintage", "antique", "collectible"];
+const productSuffixes = ["item", "product", "good", "merchandise", "thing", "object", "widget", "gadget", "device", "apparatus", "contraption", "instrument", "tool", "implement", "utensil", "appliance", "machine", "equipment", "gear", "kit", "set", "package"];
+const assetPreview = [".png", ".jpg", ".jpeg", ".heic", ".mp4", ".mov", ".avi"];
+
+// ── HELPER FUNCTIONS ──
 function makeProducts(maxItems = 5) {
 	return function () {
-		const categories = ["electronics", "books", "clothing", "home", "garden", "toys", "sports", "automotive", "beauty", "health", "grocery", "jewelry", "shoes", "tools", "office supplies"];
-		const descriptors = ["brand new", "open box", "refurbished", "used", "like new", "vintage", "antique", "collectible"];
-		const suffix = ["item", "product", "good", "merchandise", "thing", "object", "widget", "gadget", "device", "apparatus", "contraption", "instrument", "tool", "implement", "utensil", "appliance", "machine", "equipment", "gear", "kit", "set", "package"];
-		const assetPreview = ['.png', '.jpg', '.jpeg', '.heic', '.mp4', '.mov', '.avi'];
 		const data = [];
 		const numOfItems = integer(1, maxItems);
 
-		for (var i = 0; i < numOfItems; i++) {
-			const category = chance.pickone(categories);
-			const descriptor = chance.pickone(descriptors);
-			const suffixWord = chance.pickone(suffix);
-			const slug = `${descriptor.replace(/\s+/g, '-').toLowerCase()}-${suffixWord.replace(/\s+/g, '-').toLowerCase()}`;
+		for (let i = 0; i < numOfItems; i++) {
+			const category = chance.pickone(productCategories);
+			const descriptor = chance.pickone(productDescriptors);
+			const suffixWord = chance.pickone(productSuffixes);
+			const slug = `${descriptor.replace(/\s+/g, "-").toLowerCase()}-${suffixWord.replace(/\s+/g, "-").toLowerCase()}`;
 			const asset = chance.pickone(assetPreview);
 
-			// const product_id = chance.guid();
 			const price = integer(1, 100);
 			const quantity = integer(1, 5);
 
-			const item = {
-				// product_id: product_id,
-				// sku: integer(11111, 99999),
+			data.push({
 				amount: price,
 				quantity: quantity,
 				total_value: price * quantity,
@@ -418,132 +419,303 @@ function makeProducts(maxItems = 5) {
 				descriptor: descriptor,
 				slug: slug,
 				assetPreview: `https://example.com/assets/${slug}${asset}`,
-				assetType: asset
-
-			};
-
-			data.push(item);
+				assetType: asset,
+			});
 		}
 
 		return () => [data];
 	};
-};
+}
+
+function handleFunnelPreHooks(record, meta) {
+	// H9: Dark Theme Power Users — dark +30%, light -15%, custom unchanged
+	const isPurchaseFunnel = meta.funnel?.sequence?.includes("checkout");
+	if (isPurchaseFunnel) {
+		const theme = meta.profile?.theme;
+		if (theme === "dark") record.conversionRate = Math.min(95, Math.round(record.conversionRate * 1.3));
+		else if (theme === "light") record.conversionRate = Math.round(record.conversionRate * 0.85);
+	}
+	return record;
+}
 
+function handleEventHooks(record) {
+	// H5: Item flattening — promote first item's fields to top level
+	if (record.item && Array.isArray(record.item)) {
+		record = { ...record, ...record.item[0] };
+		delete record.item;
+	}
+
+	// H3: Toys + Shoes cart correlation
+	if (record.event === "checkout" && Array.isArray(record.cart)) {
+		const hasToys = record.cart.some(item => item.category === "toys");
+		const hasShoes = record.cart.some(item => item.category === "shoes");
+		if (hasToys && !hasShoes) {
+			const bigCart = makeProducts(20)()()[0];
+			const shoeItems = bigCart.filter(item => item.category === "shoes");
+			if (shoeItems.length > 0) record.cart.push(shoeItems[0]);
+		}
+		if (hasShoes && !hasToys) {
+			const bigCart = makeProducts(20)()()[0];
+			const toyItems = bigCart.filter(item => item.category === "toys");
+			if (toyItems.length > 0) record.cart.push(toyItems[0]);
+		}
+		if (!hasToys && !hasShoes) {
+			const cheapFactor = decimal(0.75, 0.9);
+			record.cart = record.cart.map(item => ({
+				...item,
+				amount: Math.round(item.amount * cheapFactor),
+				total_value: Math.round(item.total_value * cheapFactor),
+			}));
+		}
+	}
 
-/** @type {import('../types.d.ts').Dungeon} */
+	// H4: Quality → watch time correlation
+	if (record.event === "watch video") {
+		const quality = record.quality || "480p";
+		const factor = QUALITY_FACTORS[quality] ?? 1.0;
+		record.watchTimeSec = Math.round(record.watchTimeSec * factor);
+	}
+
+	return record;
+}
+
+function handleEverythingHooks(record, meta) {
+	const profile = meta.profile;
+	record.forEach(e => {
+		e.theme = profile.theme;
+	});
+
+	const datasetEnd = dayjs.unix(meta.datasetEnd);
+	const DAY_SIGNUPS_IMPROVED = datasetEnd.subtract(SIGNUP_FIX_DAYS_AGO, "day");
+	const DAY_WATCH_TIME_WENT_UP = datasetEnd.subtract(WATCH_INFLECTION_DAYS_AGO, "day");
+
+	// H1: Signup flow v1 → v2; pre-fix v1 signups lose 50% to _drop
+	record.forEach(e => {
+		if (e.event !== "sign up") return;
+		const eventTime = dayjs(e.time);
+		e.signup_flow = "v1";
+		if (eventTime.isBefore(DAY_SIGNUPS_IMPROVED)) {
+			if (chance.bool({ likelihood: 50 })) e._drop = true;
+		}
+		if (eventTime.isAfter(DAY_SIGNUPS_IMPROVED)) {
+			e.signup_flow = "v2";
+		}
+	});
+
+	// H2: Watch time inflection — before: shrink, after: grow
+	record.forEach(e => {
+		if (e.event !== "watch video") return;
+		const eventTime = dayjs(e.time);
+		const factor = decimal(WATCH_FACTOR_MIN, WATCH_FACTOR_MAX);
+		if (eventTime.isBefore(DAY_WATCH_TIME_WENT_UP)) {
+			e.watchTimeSec = Math.round(e.watchTimeSec * (1 - factor));
+		}
+		if (eventTime.isAfter(DAY_WATCH_TIME_WENT_UP)) {
+			e.watchTimeSec = Math.round(e.watchTimeSec * (1 + factor));
+		}
+	});
+
+	// H6: View-item magic number — sweet spot (3-8) boost; over (9+) checkout drop
+	const viewItemCount = record.filter(e => e.event === "view item").length;
+	if (viewItemCount >= VIEW_SWEET_MIN && viewItemCount <= VIEW_SWEET_MAX) {
+		record.forEach(e => {
+			if (e.event === "checkout" && Array.isArray(e.cart)) {
+				e.cart = e.cart.map(it => ({
+					...it,
+					amount: typeof it.amount === "number" ? Math.round(it.amount * SWEET_CART_BOOST) : it.amount,
+					total_value: typeof it.total_value === "number" ? Math.round(it.total_value * SWEET_CART_BOOST) : it.total_value,
+				}));
+			}
+		});
+		const addToCartEvents = record.filter(e => e.event === "add to cart");
+		const clones = [];
+		addToCartEvents.forEach(e => {
+			if (chance.bool({ likelihood: SWEET_CLONE_LIKELIHOOD })) {
+				const offsetMs = integer(60_000, 600_000);
+				clones.push({
+					...e,
+					insert_id: uid(),
+					time: dayjs(e.time).add(offsetMs, "milliseconds").toISOString(),
+				});
+			}
+		});
+		if (clones.length > 0) record.push(...clones);
+	} else if (viewItemCount >= VIEW_OVER_THRESHOLD) {
+		for (let i = record.length - 1; i >= 0; i--) {
+			if (record[i].event === "checkout" && chance.bool({ likelihood: OVER_CHECKOUT_DROP_LIKELIHOOD })) {
+				record.splice(i, 1);
+			}
+		}
+	}
+
+	// H7: Signup-flow TTC scaled by loyalty tier (gold/plat fast, bronze slow)
+	{
+		let loyaltyTier = "silver";
+		const scdEntries = meta?.scd?.loyalty_tier;
+		if (Array.isArray(scdEntries) && scdEntries.length > 0) {
+			const latest = scdEntries.reduce((a, b) => (a.time > b.time ? a : b));
+			loyaltyTier = latest.loyalty_tier || "silver";
+		} else {
+			const uidStr = record[0]?.user_id || "";
+			const hash = uidStr.split("").reduce((acc, c) => acc + c.charCodeAt(0), 0);
+			const bucket = hash % 100;
+			loyaltyTier = bucket < 20 ? "gold" : bucket < 50 ? "silver" : "bronze";
+		}
+		const ttcFactor = (
+			loyaltyTier === "gold" || loyaltyTier === "platinum" ? LOYALTY_TTC_FAST :
+			loyaltyTier === "bronze" ? LOYALTY_TTC_SLOW :
+			1.0
+		);
+		if (ttcFactor !== 1.0) {
+			const funnelSteps = new Set(["page view", "view item", "save item", "sign up"]);
+			const sorted = record.slice().sort((a, b) => new Date(a.time) - new Date(b.time));
+			const signupEvent = sorted.find(e => e.event === "sign up");
+			if (signupEvent) {
+				const signupMs = new Date(signupEvent.time).getTime();
+				const windowMs = LOYALTY_LOOKBACK_DAYS * 24 * 60 * 60 * 1000;
+				const funnelEvents = sorted.filter(e =>
+					funnelSteps.has(e.event) &&
+					new Date(e.time).getTime() >= signupMs - windowMs &&
+					new Date(e.time).getTime() <= signupMs
+				);
+				if (funnelEvents.length >= 2) scaleFunnelTTC(funnelEvents, ttcFactor);
+			}
+		}
+	}
+
+	// H10: Save-item retention — born-in users below threshold churn after day 25
+	if (meta.userIsBornInDataset) {
+		const firstT = record[0]?.time;
+		if (firstT) {
+			const window10 = dayjs(firstT).add(SAVE_RETENTION_WINDOW_DAYS, "days").toISOString();
+			const saves = record.filter(e => e.event === "save item" && e.time <= window10).length;
+			if (saves < SAVE_RETENTION_MIN) {
+				const cutoff = dayjs(firstT).add(SAVE_RETENTION_CUTOFF_DAYS, "days");
+				for (let i = record.length - 1; i >= 0; i--) {
+					if (dayjs(record[i].time).isAfter(cutoff) && chance.bool({ likelihood: SAVE_RETENTION_DROP_LIKELIHOOD })) {
+						record.splice(i, 1);
+					}
+				}
+			}
+		}
+	}
+
+	return record.filter(e => !e._drop);
+}
+
+// ── CONFIG ──
+/** @type {Config} */
 const config = {
 	version: 2,
-	token,
 	seed: SEED,
-	datasetStart: "2026-01-01T00:00:00Z",
-	datasetEnd: "2026-05-01T23:59:59Z",
-	// numDays: num_days,
-	avgEventsPerUserPerDay: avg_events_per_user_per_day,
-	numUsers: num_users,
-	format: 'json', //csv or json
-	region: "US",
-	hasAnonIds: true,
-	avgDevicePerUser: 2,
-	hasSessionIds: true,
-	hasAdSpend: false,
-	hasLocation: true,
-	hasAndroidDevices: true,
-	hasIOSDevices: true,
-	hasDesktopDevices: true,
-	hasBrowser: true,
-	hasCampaigns: false,
-	isAnonymous: false,
-	alsoInferFunnels: false,
+	datasetStart: DATASET_START,
+	datasetEnd: DATASET_END,
+	avgEventsPerUserPerDay: EVENTS_PER_DAY,
+	numUsers: NUM_USERS,
+	format: "json",
+	credentials: {
+		token,
+		region: "US",
+	},
+	switches: {
+		hasSessionIds: true,
+		hasAdSpend: false,
+		hasLocation: true,
+		hasAndroidDevices: true,
+		hasIOSDevices: true,
+		hasDesktopDevices: true,
+		hasBrowser: true,
+		hasCampaigns: false,
+		isAnonymous: false,
+		alsoInferFunnels: false,
+	},
+	identity: {
+		avgDevicePerUser: 2,
+	},
 	concurrency: 1,
 	events: [
 		{
 			event: "checkout",
 			weight: 2,
+			isStrictEvent: false,
 			properties: {
 				currency: ["USD", "CAD", "EUR", "BTC", "ETH", "JPY"],
 				coupon: weighChoices(["none", "none", "none", "none", "10%OFF", "20%OFF", "10%OFF", "20%OFF", "30%OFF", "40%OFF", "50%OFF"]),
 				cart: makeProducts(),
-			}
+			},
 		},
 		{
 			event: "add to cart",
 			weight: 4,
+			isStrictEvent: false,
 			properties: {
 				item: makeProducts(1),
 				amount: weighNumRange(1, 100, 0.3),
 				quantity: weighNumRange(1, 5, 0.3),
 				total_value: weighNumRange(1, 500, 0.3),
 				featured: [true, false, false],
-				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"],
+				category: productCategories,
+				descriptor: productDescriptors,
 				slug: ["item"],
 				assetPreview: ["https://example.com/assets/item.png"],
-				assetType: [".png", ".jpg", ".jpeg", ".heic", ".mp4", ".mov", ".avi"],
-			}
+				assetType: assetPreview,
+			},
 		},
 		{
 			event: "view item",
 			weight: 8,
+			isStrictEvent: false,
 			properties: {
 				item: makeProducts(1),
 				amount: weighNumRange(1, 100, 0.3),
 				quantity: weighNumRange(1, 5, 0.3),
 				total_value: weighNumRange(1, 500, 0.3),
 				featured: [true, false, false],
-				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"],
+				category: productCategories,
+				descriptor: productDescriptors,
 				slug: ["item"],
 				assetPreview: ["https://example.com/assets/item.png"],
-				assetType: [".png", ".jpg", ".jpeg", ".heic", ".mp4", ".mov", ".avi"],
-			}
+				assetType: assetPreview,
+			},
 		},
 		{
 			event: "save item",
 			weight: 5,
+			isStrictEvent: false,
 			properties: {
 				item: makeProducts(1),
 				amount: weighNumRange(1, 100, 0.3),
 				quantity: weighNumRange(1, 5, 0.3),
 				total_value: weighNumRange(1, 500, 0.3),
 				featured: [true, false, false],
-				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"],
+				category: productCategories,
+				descriptor: productDescriptors,
 				slug: ["item"],
 				assetPreview: ["https://example.com/assets/item.png"],
-				assetType: [".png", ".jpg", ".jpeg", ".heic", ".mp4", ".mov", ".avi"],
-			}
+				assetType: assetPreview,
+			},
 		},
 		{
 			event: "page view",
 			weight: 10,
+			isStrictEvent: false,
 			properties: {
 				page: ["/", "/help", "/account", "/watch", "/listen", "/product", "/people", "/peace"],
-			}
+			},
 		},
 		{
 			event: "watch video",
 			weight: 8,
+			isStrictEvent: false,
 			properties: {
-				watchTimeSec: weighNumRange(10, 600, .25),
+				watchTimeSec: weighNumRange(10, 600, 0.25),
 				quality: ["2160p", "1440p", "1080p", "720p", "480p", "360p", "240p"],
 				format: ["mp4", "avi", "mov", "mpg"],
 				uploader_id: chance.guid.bind(chance),
-			}
-		},
-		{
-			event: "like video",
-			weight: 6,
-			properties: {
-
-			}
-		},
-		{
-			event: "dislike video",
-			weight: 4,
-			properties: {
-
-			}
+			},
 		},
+		{ event: "like video", weight: 6, properties: {} },
+		{ event: "dislike video", weight: 4, properties: {} },
 		{
 			event: "sign up",
 			weight: 1,
@@ -553,9 +725,8 @@ const config = {
 				signupMethod: ["email", "google", "facebook", "twitter", "linkedin", "github"],
 				referral: weighChoices(["none", "none", "none", "friend", "ad", "ad", "ad", "friend", "friend", "friend", "friend"]),
 				signup_flow: ["v1"],
-			}
+			},
 		},
-
 	],
 	funnels: [
 		{
@@ -566,8 +737,7 @@ const config = {
 			isFirstFunnel: true,
 			timeToConvert: 2,
 			experiment: false,
-			name: "Signup Flow"
-
+			name: "Signup Flow",
 		},
 		{
 			sequence: ["watch video", "like video", "watch video", "like video"],
@@ -577,8 +747,8 @@ const config = {
 				videoCategory: videoCategories,
 				quality: ["2160p", "1440p", "1080p", "720p", "480p", "360p", "240p"],
 				format: ["mp4", "avi", "mov", "mpg"],
-				uploader_id: chance.guid.bind(chance)
-			}
+				uploader_id: chance.guid.bind(chance),
+			},
 		},
 		{
 			name: "Video Dislikes",
@@ -588,8 +758,8 @@ const config = {
 				videoCategory: videoCategories,
 				quality: ["2160p", "1440p", "1080p", "720p", "480p", "360p", "240p"],
 				format: ["mp4", "avi", "mov", "mpg"],
-				uploader_id: chance.guid.bind(chance)
-			}
+				uploader_id: chance.guid.bind(chance),
+			},
 		},
 		{
 			name: "eCommerce Purchase",
@@ -607,19 +777,14 @@ const config = {
 				],
 				startDaysBeforeEnd: 30,
 			},
-		}
-
+		},
 	],
 	superProps: {
 		theme: ["light", "dark", "custom", "light", "dark"],
 	},
-	/*
-	user properties work the same as event properties
-	each key should be an array or function reference
-	*/
 	userProps: {
 		title: chance.profession.bind(chance),
-		luckyNumber: weighNumRange(42, 420, .3),
+		luckyNumber: weighNumRange(42, 420, 0.3),
 		spiritAnimal: spiritAnimals,
 		theme: ["light", "dark", "custom", "light", "dark"],
 	},
@@ -628,256 +793,19 @@ const config = {
 			values: ["bronze", "silver", "gold", "platinum"],
 			frequency: "month",
 			timing: "fuzzy",
-			max: 8
-		}
+			max: 8,
+		},
 	},
 	mirrorProps: {},
-
-	/*
-	for group analytics keys, we need an array of arrays [[],[],[]]
-	each pair represents a group_key and the number of profiles for that key
-	*/
 	groupKeys: [],
 	groupProps: {},
 	lookupTables: [],
-	hook: function (record, type, meta) {
-
-		// H9: Dark Theme Power Users (funnel-pre)
-		// Dark-theme users convert 1.3x better on the purchase funnel;
-		// light-theme users convert 0.85x. Custom-theme is unchanged.
-		if (type === "funnel-pre") {
-			const isPurchaseFunnel = meta.funnel?.sequence?.includes("checkout");
-			if (isPurchaseFunnel) {
-				const theme = meta.profile?.theme;
-				if (theme === "dark") record.conversionRate = Math.min(95, Math.round(record.conversionRate * 1.3));
-				else if (theme === "light") record.conversionRate = Math.round(record.conversionRate * 0.85);
-			}
-		}
-
-		if (type === "event") {
-			// unflattering 'items'
-			if (record.item && Array.isArray(record.item)) {
-				record = { ...record, ...record.item[0] };
-				delete record.item;
-			}
-
-			// toys + shoes frequently purchases together (and are higher cart values)
-			if (record.event === 'checkout' && Array.isArray(record.cart)) {
-				const hasToys = record.cart.some(item => item.category === 'toys');
-				const hasShoes = record.cart.some(item => item.category === 'shoes');
-				if (hasToys && !hasShoes) {
-					const bigCart = makeProducts(20)()()[0];
-					const shoeItems = bigCart.filter(item => item.category === 'shoes');
-					if (shoeItems.length > 0) {
-						record.cart.push(shoeItems[0]);
-					}
-				}
-
-				if (hasShoes && !hasToys) {
-					const bigCart = makeProducts(20)()()[0];
-					const toyItems = bigCart.filter(item => item.category === 'toys');
-					if (toyItems.length > 0) {
-						record.cart.push(toyItems[0]);
-					}
-				}
-
-				if (!hasToys && !hasShoes) {
-					const cheapFactor = decimal(.75, 0.9);
-					// make every item a bit cheaper
-					record.cart = record.cart.map(item => {
-						return {
-							...item,
-							amount: Math.round(item.amount * cheapFactor),
-							total_value: Math.round(item.total_value * cheapFactor)
-						};
-					});
-				}
-			}
-			// high quality video means longer watch times (lower quality shorter watch times)
-			if (record.event === 'watch video') {
-				const qualityFactors = {
-					"2160p": 1.5,
-					"1440p": 1.4,
-					"1080p": 1.3,
-					"720p": 1.15,
-					"480p": 1.0,
-					"360p": 0.85,
-					"240p": 0.7
-				};
-				const quality = record.quality || "480p";
-				const factor = qualityFactors[quality] || 1.0;
-				record.watchTimeSec = Math.round(record.watchTimeSec * factor);
-			}
-
-
-
-		}
-
-
-
-		if (type === "everything") {
-			// Stamp superProps from profile for consistency
-			const profile = meta.profile;
-			record.forEach(e => {
-				e.theme = profile.theme;
-			});
-
-			const datasetEnd = dayjs.unix(meta.datasetEnd);
-			const DAY_SIGNUPS_IMPROVED = datasetEnd.subtract(7, 'day');
-			const DAY_WATCH_TIME_WENT_UP = datasetEnd.subtract(30, 'day');
-
-			// Hook 1: Signup flow improvement — pre-fix signups (v1) get 50% dropped
-			record.forEach(e => {
-				if (e.event !== 'sign up') return;
-				const eventTime = dayjs(e.time);
-				e.signup_flow = "v1";
-				if (eventTime.isBefore(DAY_SIGNUPS_IMPROVED)) {
-					if (chance.bool({ likelihood: 50 })) {
-						e._drop = true;
-					}
-				}
-				if (eventTime.isAfter(DAY_SIGNUPS_IMPROVED)) {
-					e.signup_flow = "v2";
-				}
-			});
-
-			// Hook 2: Watch time inflection — before 30 days ago: reduce, after: increase
-			record.forEach(e => {
-				if (e.event !== 'watch video') return;
-				const eventTime = dayjs(e.time);
-				const factor = decimal(0.25, 0.79);
-				if (eventTime.isBefore(DAY_WATCH_TIME_WENT_UP)) {
-					e.watchTimeSec = Math.round(e.watchTimeSec * (1 - factor));
-				}
-				if (eventTime.isAfter(DAY_WATCH_TIME_WENT_UP)) {
-					e.watchTimeSec = Math.round(e.watchTimeSec * (1 + factor));
-				}
-			});
-
-			// Hook 6: View-Item Magic Number (behavioral, no flags)
-			// Users in 3-8 view-item sweet spot show ~25% higher cart amounts
-			// AND elevated add-to-cart rate (~45% boost via cloned events).
-			// Users >=9 are over-engaged window-shoppers; ~30% of their checkouts drop.
-			const viewItemCount = record.filter(e => e.event === 'view item').length;
-			if (viewItemCount >= 3 && viewItemCount <= 8) {
-				record.forEach(e => {
-					if (e.event === 'checkout' && Array.isArray(e.cart)) {
-						e.cart = e.cart.map(it => ({
-							...it,
-							amount: typeof it.amount === 'number' ? Math.round(it.amount * 1.25) : it.amount,
-							total_value: typeof it.total_value === 'number' ? Math.round(it.total_value * 1.25) : it.total_value
-						}));
-					}
-				});
-				// Clone ~45% of add-to-cart events to boost cart add rate
-				const addToCartEvents = record.filter(e => e.event === 'add to cart');
-				const clones = [];
-				addToCartEvents.forEach(e => {
-					if (chance.bool({ likelihood: 45 })) {
-						const offsetMs = integer(60_000, 600_000); // 1-10 min offset
-						clones.push({
-							...e,
-							insert_id: uid(),
-							time: dayjs(e.time).add(offsetMs, 'milliseconds').toISOString()
-						});
-					}
-				});
-				if (clones.length > 0) record.push(...clones);
-			} else if (viewItemCount >= 9) {
-				for (let i = record.length - 1; i >= 0; i--) {
-					if (record[i].event === 'checkout' && chance.bool({ likelihood: 30 })) {
-						record.splice(i, 1);
-					}
-				}
-			}
-
-			// Hook 7 (TTC): SIGNUP FLOW TIME-TO-CONVERT (everything)
-			// Gold/platinum loyalty users complete the Signup Flow funnel
-			// 0.67x faster; bronze users 1.33x slower. Loyalty tier is read
-			// from SCD data (meta.scd.loyalty_tier); falls back to a
-			// deterministic hash of user_id for consistent assignment.
-			//
-			// The funnel uses order:"first-and-last-fixed" so middle steps
-			// can reorder. We anchor on the first "sign up" event, look back
-			// up to 2 days for all funnel-step events in that window, and
-			// scale the whole cluster via scaleFunnelTTC.
-			{
-				// Determine loyalty tier from SCD (latest entry) or hash fallback
-				let loyaltyTier = "silver"; // default baseline
-				const scdEntries = meta?.scd?.loyalty_tier;
-				if (Array.isArray(scdEntries) && scdEntries.length > 0) {
-					// Pick the latest SCD entry
-					const latest = scdEntries.reduce((a, b) =>
-						(a.time > b.time ? a : b));
-					loyaltyTier = latest.loyalty_tier || "silver";
-				} else {
-					// Deterministic hash fallback: gold ~20%, silver ~30%, bronze ~50%
-					const uid = record[0]?.user_id || "";
-					const hash = uid.split("").reduce((acc, c) => acc + c.charCodeAt(0), 0);
-					const bucket = hash % 100;
-					loyaltyTier = bucket < 20 ? "gold" : bucket < 50 ? "silver" : "bronze";
-				}
-
-				const ttcFactor = (
-					loyaltyTier === "gold" || loyaltyTier === "platinum" ? 0.67 :
-					loyaltyTier === "bronze" ? 1.33 :
-					1.0
-				);
-				if (ttcFactor !== 1.0) {
-					// Find signup funnel: anchor on first "sign up", look back 2 days
-					// for the cluster of funnel-step events
-					const funnelSteps = new Set(["page view", "view item", "save item", "sign up"]);
-					const sorted = record.slice().sort((a, b) =>
-						new Date(a.time) - new Date(b.time));
-					const signupEvent = sorted.find(e => e.event === "sign up");
-					if (signupEvent) {
-						const signupMs = new Date(signupEvent.time).getTime();
-						const windowMs = 2 * 24 * 60 * 60 * 1000; // 2-day lookback
-						const funnelEvents = sorted.filter(e =>
-							funnelSteps.has(e.event) &&
-							new Date(e.time).getTime() >= signupMs - windowMs &&
-							new Date(e.time).getTime() <= signupMs
-						);
-						if (funnelEvents.length >= 2) {
-							scaleFunnelTTC(funnelEvents, ttcFactor);
-						}
-					}
-				}
-			}
-
-		}
-
-		// H10: Save-Item Retention (everything — retention magic number)
-		// Born-in-dataset users with 2+ "save item" in their first 10 days
-		// retain; users below the threshold lose ~70% of events after day 25.
-		if (type === "everything" && meta.userIsBornInDataset) {
-			const firstT = record[0]?.time;
-			if (firstT) {
-				const window10 = dayjs(firstT).add(10, 'days').toISOString();
-				const saves = record.filter(e => e.event === 'save item' && e.time <= window10).length;
-				if (saves < 2) {
-					const cutoff = dayjs(firstT).add(25, 'days');
-					for (let i = record.length - 1; i >= 0; i--) {
-						if (dayjs(record[i].time).isAfter(cutoff) && chance.bool({ likelihood: 70 })) {
-							record.splice(i, 1);
-						}
-					}
-				}
-			}
-		}
-
-		// Filter out events tagged for removal in the event hook
-		if (type === "everything") {
-			record = record.filter(e => !e._drop);
-		}
-
+	hook(record, type, meta) {
+		if (type === "funnel-pre") return handleFunnelPreHooks(record, meta);
+		if (type === "event") return handleEventHooks(record);
+		if (type === "everything") return handleEverythingHooks(record, meta);
 		return record;
-	}
+	},
 };
 
-function flip(likelihood = 50) {
-	return chance.bool({ likelihood });
-}
-
-
 export default config;