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

package/dungeons/technical/ad-spend-schema.json

@@ -120,9 +120,9 @@
       "enterprise"
     ],
     "signup_source": [
-      "referral",
+      "organic",
       "paid",
-      "organic"
+      "referral"
     ]
   }
 }

package/dungeons/technical/ad-spend.js

@@ -1,3 +1,13 @@
+// ── TWEAK THESE ──
+const SEED = "ad spend test";
+const num_days = 90;
+const num_users = 1_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: Ad Spend & Campaign Attribution
@@ -24,11 +35,12 @@ import { weighNumRange, date, integer, weighChoices } from "../../lib/utils/util
 
 /** @type {import('../../types').Dungeon} */
 const config = {
-	seed: "ad spend test",
+	token,
+	seed: SEED,
 	name: "ad-spend",
-	numDays: 90,
-	numEvents: 50_000,
-	numUsers: 1_000,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
+	numUsers: num_users,
 	format: 'json',
 	region: "US",
 	hasAnonIds: true,
@@ -43,7 +55,6 @@ const config = {
 	isAnonymous: false,
 	alsoInferFunnels: false,
 	concurrency: 1,
-	batchSize: 500_000,
 	writeToDisk: false,
 
 	events: [

package/dungeons/technical/anonymous-users-schema.json

@@ -5,9 +5,10 @@
       "weight": 10,
       "properties": {
         "page": [
+          "/",
           "/features",
-          "/docs",
           "/pricing",
+          "/docs",
           "/blog"
         ],
         "referrer": [
@@ -50,8 +51,8 @@
       "properties": {
         "amount": {
           "$range": [
-            108,
-            392
+            114,
+            397
           ]
         },
         "plan": [

package/dungeons/technical/anonymous-users.js

@@ -1,3 +1,13 @@
+// ── TWEAK THESE ──
+const SEED = "anonymous-users";
+const num_days = 180;
+const num_users = 1_000;
+const avg_events_per_user = 50;
+let token = "your-mixpanel-token";
+
+// ── env overrides ──
+if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
+
 /**
  * Anonymous Users — tests anonymous user mode, anonIds, and identity merge.
  *
@@ -14,13 +24,14 @@ import Chance from 'chance';
 let chance = new Chance();
 import { weighNumRange, weighChoices } from "../../lib/utils/utils.js";
 
+/** @typedef {import("../../types").Dungeon} Config */
 /** @type {import('../../types').Dungeon} */
 const config = {
-	token: "",
-	seed: "anonymous-users",
-	numDays: 180,
-	numEvents: 50_000,
-	numUsers: 1_000,
+	token,
+	seed: SEED,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
+	numUsers: num_users,
 	format: "json",
 	region: "US",
 	isAnonymous: true,
@@ -35,7 +46,6 @@ const config = {
 	hasCampaigns: false,
 	alsoInferFunnels: false,
 	concurrency: 1,
-	batchSize: 2_500_000,
 	writeToDisk: false,
 
 	events: [

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

@@ -92,8 +92,8 @@
   ],
   "superProps": {
     "theme": [
-      "dark",
       "light",
+      "dark",
       "custom"
     ]
   },

package/dungeons/technical/array-of-object-lookup.js

@@ -1,3 +1,13 @@
+// ── TWEAK THESE ──
+const SEED = "dm4-array-of-object-lookup";
+const num_days = 60;
+const num_users = 1_000;
+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';
 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 */
 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"];
 
@@ -39,12 +50,12 @@ const spiritAnimals = ["duck", "dog", "otter", "penguin", "cat", "elephant", "li
 
 /** @type {import('../types.js').Dungeon} */
 const config = {
-	// token: "",
-	seed: "test array of objects lookup",
+	token,
+	seed: SEED,
 	name: "array-of-object-lookup",
-	numDays: 60, //how many days worth1 of data
-	numEvents: 100_000, //how many events
-	numUsers: 1_000, //how many users
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
+	numUsers: num_users,
 	format: 'json', //csv or json
 	region: "US",
 	hasAnonIds: true, //if true, anonymousIds are created for each user
@@ -59,7 +70,6 @@ const config = {
 	isAnonymous: false,
 	alsoInferFunnels: true,
 	concurrency: 1,
-	batchSize: 250_000,
 	writeToDisk: false,
 	events: [
 		{
@@ -109,6 +119,7 @@ const config = {
 	each key should be an array or function reference
 	*/
 	userProps: {
+		theme: ["light", "dark", "custom", "light", "dark"],
 		// title: chance.profession.bind(chance),
 		// luckyNumber: weighNumRange(1, 500, .3),
 		spiritAnimal: spiritAnimals
@@ -160,6 +171,11 @@ const config = {
 		}
 
 		if (type === "everything") {
+			const profile = meta.profile;
+			record.forEach(e => {
+				e.theme = profile.theme;
+			});
+
 			// Pattern 3: Users who view 5+ items but never checkout are tagged as window shoppers
 			const views = record.filter(e => e.event === "view item").length;
 			const checkouts = record.filter(e => e.event === "checkout").length;

package/dungeons/technical/experiments-schema.json

@@ -5,8 +5,9 @@
       "weight": 10,
       "properties": {
         "page": [
-          "/pricing",
+          "/",
           "/features",
+          "/pricing",
           "/docs",
           "/about"
         ]
@@ -72,8 +73,8 @@
       "properties": {
         "amount": {
           "$range": [
-            129,
-            400
+            123,
+            389
           ]
         },
         "plan": [
@@ -120,21 +121,6 @@
       }
     }
   ],
-  "superProps": {
-    "platform": [
-      "ios",
-      "web",
-      "android"
-    ]
-  },
-  "userProps": {
-    "plan": [
-      "free",
-      "starter",
-      "growth",
-      "enterprise"
-    ]
-  },
   "funnels": [
     {
       "sequence": [
@@ -143,6 +129,7 @@
         "feature viewed",
         "action taken"
       ],
+      "name": "Onboarding Flow",
       "isFirstFunnel": true,
       "conversionRate": 45,
       "timeToConvert": 3,
@@ -156,6 +143,7 @@
         "button click",
         "checkout"
       ],
+      "name": "Purchase Funnel",
       "conversionRate": 30,
       "timeToConvert": 5,
       "order": "first-and-last-fixed",
@@ -169,12 +157,14 @@
         "help viewed",
         "action taken"
       ],
+      "name": "Feature Adoption",
       "conversionRate": 50,
       "timeToConvert": 2,
       "order": "random",
       "weight": 4,
       "requireRepeats": true,
       "experiment": true,
+      "bindPropsIndex": 2,
       "props": {
         "experiment_cohort": [
           "new_ui",
@@ -188,10 +178,26 @@
         "button click",
         "signup"
       ],
+      "name": "Quick Signup",
       "isFirstFunnel": true,
       "conversionRate": 40,
       "timeToConvert": 1,
       "weight": 6
     }
-  ]
+  ],
+  "superProps": {
+    "platform": [
+      "web",
+      "ios",
+      "android"
+    ]
+  },
+  "userProps": {
+    "plan": [
+      "free",
+      "starter",
+      "growth",
+      "enterprise"
+    ]
+  }
 }

package/dungeons/technical/experiments.js

@@ -1,3 +1,13 @@
+// ── TWEAK THESE ──
+const SEED = "experiments";
+const num_days = 60;
+const num_users = 2_000;
+const avg_events_per_user = 50;
+let token = "your-mixpanel-token";
+
+// ── env overrides ──
+if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
+
 /**
  * Experiments — tests funnel experiments with A/B/C variants.
  *
@@ -14,13 +24,14 @@ import Chance from 'chance';
 let chance = new Chance();
 import { weighNumRange, weighChoices } from "../../lib/utils/utils.js";
 
+/** @typedef {import("../../types").Dungeon} Config */
 /** @type {import('../../types').Dungeon} */
 const config = {
-	token: "",
-	seed: "experiments",
-	numDays: 60,
-	numEvents: 100_000,
-	numUsers: 2_000,
+	token,
+	seed: SEED,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
+	numUsers: num_users,
 	format: "json",
 	region: "US",
 	hasAnonIds: false,
@@ -35,7 +46,6 @@ const config = {
 	isAnonymous: false,
 	alsoInferFunnels: false,
 	concurrency: 1,
-	batchSize: 2_500_000,
 	writeToDisk: false,
 
 	events: [
@@ -152,6 +162,7 @@ const config = {
 
 	userProps: {
 		plan: weighChoices(["free", "free", "free", "starter", "growth", "enterprise"]),
+		platform: ["web", "web", "ios", "android"],
 	},
 
 	scdProps: {},
@@ -161,6 +172,13 @@ const config = {
 	lookupTables: [],
 
 	hook: function (record, type, meta) {
+		if (type === "everything") {
+			const profile = meta.profile;
+			record.forEach(e => {
+				e.platform = profile.platform;
+			});
+			return record;
+		}
 		return record;
 	}
 };

package/dungeons/technical/foobar.js

@@ -1,3 +1,13 @@
+// ── TWEAK THESE ──
+const SEED = "dm4-foobar";
+const num_days = 30;
+const num_users = 4_000_000;
+const avg_events_per_user = 500;
+let token = "your-mixpanel-token";
+
+// ── env overrides ──
+if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
+
 /**
  * ═══════════════════════════════════════════════════════════════
  * DATASET OVERVIEW
@@ -46,6 +56,7 @@ function integer(min = 1, max = 100) {
 	return Math.floor(Math.random() * (max - min + 1)) + min;
 }
 
+/** @typedef {import("../../types").Dungeon} Config */
 
 const dates = [
 	"2024-09-18T21:48:28.173Z",
@@ -150,25 +161,17 @@ const dates = [
 	"2024-06-03T06:52:21.652Z"
 ];
 
-const billionsOfEvents = 2
-
-const numEvents = billionsOfEvents * 1_000_000_000;
-const eventPerUser = 1_000;
-const numUsers = Math.floor(numEvents / eventPerUser);
-const seed = Math.random().toString()
-
 /** @type {import('../../types').Dungeon} */
 const config = {
-	token: "",
-	seed: seed,
-	numDays: 30, //how many days worth of data
-	numEvents: numEvents, //how many events
-	numUsers: numUsers, //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
 	hasSessionIds: false, //if true, hasSessionIds are created for each user
-	batchSize: 2_500_000,
 	hasAdSpend: false,
 	hasAvatar: false,
 	hasBrowser: false,
@@ -244,6 +247,11 @@ const config = {
 		luckyNumber: integer,
 		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"],
 		created: dates,
+		string: ["red", "orange", "yellow", "green", "blue", "indigo", "violet"],
+		number: integer,
+		boolean: [true, false],
+		date: dates,
+		temperature: ["warm"],
 	},
 
 	scdProps: {},
@@ -270,6 +278,14 @@ const config = {
 
 		// everything hook: hash-based cohort — 10% of users (by distinct_id) get doubled events
 		if (type === "everything") {
+			const profile = meta.profile;
+			record.forEach(e => {
+				e.string = profile.string;
+				e.number = profile.number;
+				e.boolean = profile.boolean;
+				e.date = profile.date;
+				e.temperature = profile.temperature;
+			});
 			if (record.length > 0) {
 				const userId = record[0].user_id || record[0].distinct_id || "";
 				if (userId && userId.charCodeAt(0) % 10 === 0) {

package/dungeons/technical/group-analytics-schema.json

@@ -145,5 +145,97 @@
       "manager",
       "exec"
     ]
+  },
+  "groupKeys": [
+    {
+      "key": "company_id",
+      "count": 50,
+      "affectsEvents": [
+        "feature used",
+        "subscription change",
+        "support ticket"
+      ]
+    },
+    {
+      "key": "team_id",
+      "count": 200,
+      "affectsEvents": [
+        "feature used",
+        "task completed",
+        "meeting scheduled"
+      ]
+    },
+    {
+      "key": "project_id",
+      "count": 500,
+      "affectsEvents": [
+        "task completed",
+        "code committed",
+        "deployment run"
+      ]
+    }
+  ],
+  "groupProps": {
+    "company_id": {
+      "name": {
+        "$type": "string"
+      },
+      "industry": [
+        "technology",
+        "finance",
+        "healthcare",
+        "retail",
+        "education",
+        "manufacturing"
+      ],
+      "plan": [
+        "free",
+        "starter",
+        "business",
+        "enterprise"
+      ],
+      "employee_count": {
+        "$range": [
+          964,
+          3784
+        ]
+      }
+    },
+    "team_id": {
+      "name": {
+        "$type": "string"
+      },
+      "department": [
+        "engineering",
+        "design",
+        "product",
+        "marketing",
+        "sales",
+        "support"
+      ],
+      "size": {
+        "$range": [
+          3,
+          20
+        ]
+      }
+    },
+    "project_id": {
+      "name": {
+        "$type": "string"
+      },
+      "status": [
+        "active",
+        "paused",
+        "completed",
+        "archived"
+      ],
+      "priority": [
+        "low",
+        "medium",
+        "high",
+        "critical"
+      ]
+    }
   }
 }

package/dungeons/technical/group-analytics.js

@@ -1,3 +1,13 @@
+// ── TWEAK THESE ──
+const SEED = "group-analytics";
+const num_days = 60;
+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;
+
 /**
  * Group Analytics — tests multiple group keys with varied entity counts.
  *
@@ -14,13 +24,14 @@ import Chance from 'chance';
 let chance = new Chance();
 import { weighNumRange, weighChoices } from "../../lib/utils/utils.js";
 
+/** @typedef {import("../../types").Dungeon} Config */
 /** @type {import('../../types').Dungeon} */
 const config = {
-	token: "",
-	seed: "group-analytics",
-	numDays: 60,
-	numEvents: 30_000,
-	numUsers: 500,
+	token,
+	seed: SEED,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
+	numUsers: num_users,
 	format: "json",
 	region: "US",
 	hasAnonIds: false,
@@ -35,7 +46,6 @@ const config = {
 	isAnonymous: false,
 	alsoInferFunnels: false,
 	concurrency: 1,
-	batchSize: 2_500_000,
 	writeToDisk: false,
 
 	events: [

package/dungeons/technical/mirror-strategies-schema.json

@@ -5,11 +5,11 @@
       "weight": 10,
       "properties": {
         "page": [
-          "/account",
           "/",
           "/help",
-          "/product",
-          "/pricing"
+          "/account",
+          "/pricing",
+          "/product"
         ]
       }
     },
@@ -20,7 +20,7 @@
         "amount": {
           "$range": [
             44,
-            154
+            157
           ]
         },
         "currency": [

package/dungeons/technical/mirror-strategies.js

@@ -1,3 +1,13 @@
+// ── TWEAK THESE ──
+const SEED = "mirror-strategies";
+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;
+
 /**
  * Mirror Strategies — tests all 4 mirror data strategies.
  *
@@ -13,13 +23,14 @@ import Chance from 'chance';
 let chance = new Chance();
 import { weighNumRange, weighChoices } from "../../lib/utils/utils.js";
 
+/** @typedef {import("../../types").Dungeon} Config */
 /** @type {import('../../types').Dungeon} */
 const config = {
-	token: "",
-	seed: "mirror-strategies",
-	numDays: 30,
-	numEvents: 30_000,
-	numUsers: 500,
+	token,
+	seed: SEED,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
+	numUsers: num_users,
 	format: "json",
 	region: "US",
 	hasAnonIds: false,
@@ -34,7 +45,6 @@ const config = {
 	isAnonymous: false,
 	alsoInferFunnels: false,
 	concurrency: 1,
-	batchSize: 2_500_000,
 	writeToDisk: false,
 
 	events: [