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

package/dungeons/technical/nested-objects.js

@@ -1,3 +1,13 @@
+// ── TWEAK THESE ──
+const SEED = "dm4-nested-objects";
+const num_days = 30;
+const num_users = 500;
+const avg_events_per_user = 60;
+let token = "your-mixpanel-token";
+
+// ── env overrides ──
+if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
+
 import Chance from 'chance';
 let chance = new Chance();
 import dayjs from "dayjs";
@@ -6,6 +16,7 @@ dayjs.extend(utc);
 import { uid, comma } from 'ak-tools';
 import { weighNumRange, date, integer, weighChoices } from "../../lib/utils/utils.js";
 
+/** @typedef {import("../../types").Dungeon} Config */
 /**
  * ═══════════════════════════════════════════════════════════════
  * TECHNICAL TEST: Nested Objects & High Cardinality
@@ -29,11 +40,12 @@ const countries = ["US", "UK", "JP", "DE", "AU", "CA", "FR", "IN", "KR", "MX", "
 
 /** @type {import('../../types').Dungeon} */
 const config = {
-	seed: "nested objects test",
+	token,
+	seed: SEED,
 	name: "nested-objects",
-	numDays: 30,
-	numEvents: 30_000,
-	numUsers: 500,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
+	numUsers: num_users,
 	format: 'json',
 	region: "US",
 	hasAnonIds: false,
@@ -48,7 +60,6 @@ const config = {
 	isAnonymous: false,
 	alsoInferFunnels: false,
 	concurrency: 1,
-	batchSize: 500_000,
 	writeToDisk: false,
 
 	events: [

package/dungeons/technical/retention-cadence.js

@@ -1,4 +1,13 @@
+// ── TWEAK THESE ──
 const SEED = "kurby-retention";
+const num_days = 360;
+const num_users = 100;
+const avg_events_per_user = 50;
+let token = "your-mixpanel-token";
+
+// ── env overrides ──
+if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
+
 import dayjs from 'dayjs';
 import utc from 'dayjs/plugin/utc.js';
 dayjs.extend(utc);
@@ -6,10 +15,7 @@ import * as u from "../../lib/utils/utils.js";
 import * as v from 'ak-tools';
 const chance = u.initChance(SEED);
 
-const num_users = 100;
-const days = 360;
-
-/** @typedef {import("../types.js").Dungeon} Config */
+/** @typedef {import("../../types").Dungeon} Config */
 
 /**
  * ═══════════════════════════════════════════════════════════════
@@ -101,10 +107,10 @@ function generateCadencedEvents(behaviorName, cadence, startTime, endTime, churn
 
 /** @type {Config} */
 const config = {
-	token: "",
-	seed: "lets go",
-	numDays: days,
-	numEvents: num_users * 50,
+	token,
+	seed: SEED,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
 	numUsers: num_users,
 	hasAnonIds: false,
 	hasSessionIds: false,
@@ -119,7 +125,6 @@ const config = {
 	isAnonymous: false,
 	hasAdSpend: false,
 	hasAvatar: false,
-	batchSize: 5_500_000,
 	concurrency: 1,
 	writeToDisk: false,
 	percentUsersBornInDataset: 100,

package/dungeons/technical/sanity-schema.json

@@ -41,6 +41,27 @@
       "event": "yak"
     }
   ],
+  "funnels": [
+    {
+      "sequence": [
+        "qux",
+        "garply",
+        "durtle",
+        "linny",
+        "fonk",
+        "crumn",
+        "yak"
+      ]
+    },
+    {
+      "sequence": [
+        "foo",
+        "bar",
+        "baz"
+      ],
+      "isFirstFunnel": true
+    }
+  ],
   "superProps": {
     "color": [
       "red",
@@ -160,26 +181,5 @@
       "jewel beetle",
       "tortoise beetle"
     ]
-  },
-  "funnels": [
-    {
-      "sequence": [
-        "qux",
-        "garply",
-        "durtle",
-        "linny",
-        "fonk",
-        "crumn",
-        "yak"
-      ]
-    },
-    {
-      "sequence": [
-        "foo",
-        "bar",
-        "baz"
-      ],
-      "isFirstFunnel": true
-    }
-  ]
+  }
 }

package/dungeons/technical/sanity.js

@@ -1,3 +1,13 @@
+// ── TWEAK THESE ──
+const SEED = "foo bar";
+const num_days = 90;
+const num_users = 500;
+const avg_events_per_user = 100;
+let token = "your-mixpanel-token";
+
+// ── env overrides ──
+if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
+
 import Chance from 'chance';
 const chance = new Chance();
 import dayjs from 'dayjs';
@@ -5,6 +15,7 @@ import utc from 'dayjs/plugin/utc.js';
 dayjs.extend(utc);
 import { weighNumRange, integer } from "../../lib/utils/utils.js";
 
+/** @typedef {import("../../types").Dungeon} Config */
 /**
  * ═══════════════════════════════════════════════════════════════
  * DATASET OVERVIEW
@@ -29,11 +40,11 @@ import { weighNumRange, integer } from "../../lib/utils/utils.js";
 
 /** @type {import('../types.js').Dungeon} */
 const config = {
-	token: "",
-	seed: "foo bar",
-	numDays: 90, //how many days worth of data
-	numEvents: 50_000, //how many events
-	numUsers: 500, //how many users	
+	token,
+	seed: SEED,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
+	numUsers: num_users,
 	format: 'json', //csv or json
 	region: "US",
 	hasAnonIds: false, //if true, anonymousIds are created for each user
@@ -112,7 +123,10 @@ const config = {
 		title: chance.profession.bind(chance),
 		luckyNumber: weighNumRange(42, 420),
 		userTier: ["regular"],
-		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"]
+		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"],
+		color: ["red", "orange", "yellow", "green", "blue", "indigo", "violet"],
+		number: integer,
+		engagement_score: [0],
 	},
 	hook: function (record, type, meta) {
 		// --- user hook: tag power users based on luckyNumber ---
@@ -137,6 +151,12 @@ const config = {
 
 		// --- everything hook: low-activity users lose their last few events (churn simulation) ---
 		if (type === "everything") {
+			const profile = meta.profile;
+			record.forEach(e => {
+				e.color = profile.color;
+				e.number = profile.number;
+				// engagement_score intentionally varies per event (set by event hook)
+			});
 			if (record.length > 3 && record.length < 8) {
 				// users with few events lose the tail end — simulates churn
 				return record.slice(0, Math.ceil(record.length * 0.6));

package/dungeons/technical/scale-test.js

@@ -1,3 +1,13 @@
+// ── TWEAK THESE ──
+const SEED = "scale test";
+const num_days = 365;
+const num_users = 10_000;
+const avg_events_per_user = 50;
+let token = "your-mixpanel-token";
+
+// ── env overrides ──
+if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
+
 import Chance from 'chance';
 let chance = new Chance();
 import dayjs from "dayjs";
@@ -6,6 +16,7 @@ dayjs.extend(utc);
 import { uid, comma } from 'ak-tools';
 import { weighNumRange, date, integer, weighChoices } from "../../lib/utils/utils.js";
 
+/** @typedef {import("../../types").Dungeon} Config */
 /**
  * ═══════════════════════════════════════════════════════════════
  * TECHNICAL TEST: Scale & Performance
@@ -23,14 +34,14 @@ import { weighNumRange, date, integer, weighChoices } from "../../lib/utils/util
 
 /** @type {import('../../types').Dungeon} */
 const config = {
-	seed: "scale test",
+	token,
+	seed: SEED,
 	name: "scale-test",
-	numDays: 365,
-	numEvents: 500_000,
-	numUsers: 10_000,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
+	numUsers: num_users,
 	format: 'json',
 	gzip: true,
-	batchSize: 500_000,
 	concurrency: 1,
 	region: "US",
 	hasAnonIds: false,

package/dungeons/technical/scd-schema.json

@@ -64,8 +64,8 @@
           false
         ],
         "itemCategory": [
-          "Art",
           "Pet",
+          "Art",
           "Handmade",
           "Garden",
           "Beauty",
@@ -82,17 +82,21 @@
       "weight": 10,
       "properties": {
         "page": [
-          "/watch",
-          "/product",
           "/",
           "/help",
-          "/listen"
+          "/account",
+          "/watch",
+          "/listen",
+          "/product",
+          "/people",
+          "/peace"
         ],
         "utm_source": [
-          "linkedin",
           "$organic",
+          "google",
           "facebook",
-          "google"
+          "twitter",
+          "linkedin"
         ]
       }
     },
@@ -101,12 +105,12 @@
       "weight": 8,
       "properties": {
         "videoCategory": [
-          "travel",
-          "DIY",
-          "gaming",
-          "funny",
-          "news",
-          "educational"
+          "cooking",
+          "inspirational",
+          "music",
+          "sports",
+          "educational",
+          "DIY"
         ],
         "isFeaturedItem": [
           true,
@@ -114,8 +118,8 @@
         ],
         "watchTimeSec": {
           "$range": [
-            130,
-            469
+            131,
+            467
           ]
         },
         "quality": [
@@ -150,12 +154,12 @@
           false
         ],
         "itemCategory": [
-          "Games",
           "Handmade",
+          "Baby",
+          "Wedding",
           "Electronics",
-          "Music",
-          "Books",
-          "Movies"
+          "Industrial",
+          "Pet"
         ],
         "dateItemListed": {
           "$type": "string"
@@ -171,13 +175,13 @@
           false
         ],
         "itemCategory": [
-          "Food",
-          "Movies",
-          "Handmade",
-          "Art",
+          "Games",
           "Electronics",
-          "Kids",
-          "Baby"
+          "Books",
+          "Entertainment",
+          "Outdoors",
+          "Pet",
+          "Computers"
         ],
         "dateItemListed": {
           "$type": "string"
@@ -219,10 +223,11 @@
     },
     {
       "event": "cart_abandoned",
+      "isStrictEvent": true,
       "properties": {
         "amount": {
           "$range": [
-            110,
+            114,
             397
           ]
         }
@@ -248,23 +253,215 @@
     },
     "luckyNumber": {
       "$range": [
-        117,
-        344
+        115,
+        326
       ]
     },
     "spiritAnimal": [
-      "bee",
+      "duck",
+      "dog",
+      "otter",
+      "penguin",
+      "cat",
+      "elephant",
+      "lion",
+      "cheetah",
+      "giraffe",
+      "zebra",
+      "rhino",
+      "hippo",
+      "whale",
+      "dolphin",
+      "shark",
       "octopus",
-      "moth",
+      "squid",
+      "jellyfish",
+      "starfish",
+      "seahorse",
+      "crab",
+      "lobster",
+      "shrimp",
+      "clam",
+      "snail",
+      "slug",
       "butterfly",
-      "aphid",
-      "dragonfly",
+      "moth",
+      "bee",
+      "wasp",
       "ant",
-      "lobster",
-      "slug"
+      "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"
     ],
     "spendTier": [
       "budget"
     ]
+  },
+  "groupKeys": [
+    {
+      "key": "company_id",
+      "count": 1000
+    }
+  ],
+  "groupProps": {
+    "company_id": {
+      "name": {
+        "$type": "string"
+      },
+      "email": [
+        "CSM: AK",
+        "CSM: Deepak",
+        "CSM: Hans",
+        "CSM: Justin",
+        "CSM: Kaan",
+        "CSM: Katie",
+        "CSM: Neha",
+        "CSM: Rajiv",
+        "CSM: Somya",
+        "CSM: Tony"
+      ],
+      "industry": [
+        "technology",
+        "education",
+        "finance",
+        "healthcare",
+        "retail",
+        "manufacturing",
+        "transportation",
+        "entertainment",
+        "media",
+        "real estate",
+        "construction",
+        "hospitality",
+        "energy",
+        "utilities",
+        "agriculture",
+        "other"
+      ],
+      "segment": [
+        "SMB",
+        "Mid Market",
+        "Enterprise"
+      ],
+      "# active users": [
+        17
+      ]
+    }
+  },
+  "scdProps": {
+    "role": {
+      "type": "user",
+      "frequency": "week",
+      "timing": "fuzzy",
+      "max": 10,
+      "values": [
+        "admin",
+        "collaborator",
+        "user",
+        "view only",
+        "no access"
+      ]
+    },
+    "NPS": {
+      "type": "user",
+      "frequency": "day",
+      "timing": "fuzzy",
+      "max": 10,
+      "values": {
+        "$range": [
+          1,
+          10
+        ]
+      }
+    },
+    "MRR": {
+      "type": "company_id",
+      "frequency": "month",
+      "timing": "fixed",
+      "max": 10,
+      "values": {
+        "$range": [
+          2240,
+          7836
+        ]
+      }
+    },
+    "AccountHealthScore": {
+      "type": "company_id",
+      "frequency": "week",
+      "timing": "fixed",
+      "max": 40,
+      "values": {
+        "$range": [
+          3,
+          8
+        ]
+      }
+    },
+    "plan": {
+      "type": "company_id",
+      "frequency": "month",
+      "timing": "fixed",
+      "max": 10,
+      "values": [
+        "free",
+        "basic",
+        "premium",
+        "enterprise"
+      ]
+    }
   }
 }

package/dungeons/technical/scd.js

@@ -1,3 +1,13 @@
+// ── TWEAK THESE ──
+const SEED = "simple is best";
+const num_days = 30;
+const num_users = 500;
+const avg_events_per_user = 100;
+let token = "your-mixpanel-token";
+
+// ── env overrides ──
+if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
+
 import Chance from 'chance';
 const chance = new Chance();
 import dayjs from "dayjs";
@@ -6,6 +16,7 @@ dayjs.extend(utc);
 import { uid, comma } from 'ak-tools';
 import { pickAWinner, weighNumRange, date, integer, weighChoices } from "../../lib/utils/utils.js";
 
+/** @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"];
@@ -50,11 +61,11 @@ const videoCategories = ["funny", "educational", "inspirational", "music", "news
 
 /** @type {import('../../types').Dungeon} */
 const config = {
-	token: "",
-	seed: "simple is best",
-	numDays: 30, //how many days worth1 of data
-	numEvents: 50000, //how many events
-	numUsers: 500, //how many users	
+	token,
+	seed: SEED,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
+	numUsers: num_users,
 	format: 'csv', //csv or json
 	region: "US",
 	hasAnonIds: false, //if true, anonymousIds are created for each user
@@ -166,6 +177,8 @@ const config = {
 		luckyNumber: weighNumRange(42, 420, .3),
 		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"],
 		spendTier: ["budget"],
+		platform: ["web", "mobile", "web", "mobile", "web", "web", "kiosk", "smartTV"],
+		currentTheme: weighChoices(["light", "dark", "custom", "light", "dark"]),
 	},
 	scdProps: {
 		role: {
@@ -258,6 +271,13 @@ const config = {
 
 		// --- everything hook: simulate cart abandonment ---
 		if (type === "everything") {
+			// stamp superProps from profile for consistency
+			const profile = meta.profile;
+			record.forEach(e => {
+				e.platform = profile.platform;
+				e.currentTheme = profile.currentTheme;
+			});
+
 			const hasAddToCart = record.some(e => e.event === "add to cart");
 			const hasCheckout = record.some(e => e.event === "checkout");
 			// users who added to cart but never checked out: remove checkout events (if any slipped through)