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

package/dungeons/technical/sanity-schema.json

@@ -0,0 +1,185 @@
+{
+  "events": [
+    {
+      "event": "foo",
+      "weight": 10
+    },
+    {
+      "event": "bar",
+      "weight": 9,
+      "isFirstEvent": true
+    },
+    {
+      "event": "baz",
+      "weight": 8
+    },
+    {
+      "event": "qux",
+      "weight": 7
+    },
+    {
+      "event": "garply",
+      "weight": 6
+    },
+    {
+      "event": "durtle",
+      "weight": 5
+    },
+    {
+      "event": "linny",
+      "weight": 4
+    },
+    {
+      "event": "fonk",
+      "weight": 3
+    },
+    {
+      "event": "crumn",
+      "weight": 2
+    },
+    {
+      "event": "yak"
+    }
+  ],
+  "superProps": {
+    "color": [
+      "red",
+      "orange",
+      "yellow",
+      "green",
+      "blue",
+      "indigo",
+      "violet"
+    ],
+    "number": {
+      "$type": "number"
+    },
+    "engagement_score": [
+      0
+    ]
+  },
+  "userProps": {
+    "title": {
+      "$type": "string"
+    },
+    "luckyNumber": {
+      "$range": [
+        90,
+        380
+      ]
+    },
+    "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"
+    ]
+  },
+  "funnels": [
+    {
+      "sequence": [
+        "qux",
+        "garply",
+        "durtle",
+        "linny",
+        "fonk",
+        "crumn",
+        "yak"
+      ]
+    },
+    {
+      "sequence": [
+        "foo",
+        "bar",
+        "baz"
+      ],
+      "isFirstFunnel": true
+    }
+  ]
+}

package/dungeons/{sanity.js → technical/sanity.js}

@@ -3,7 +3,7 @@ const chance = new Chance();
 import dayjs from 'dayjs';
 import utc from 'dayjs/plugin/utc.js';
 dayjs.extend(utc);
-import { weighNumRange, integer } from "../lib/utils/utils.js";
+import { weighNumRange, integer } from "../../lib/utils/utils.js";
 
 /**
  * ═══════════════════════════════════════════════════════════════
@@ -106,11 +106,12 @@ const config = {
 	superProps: {
 		color: ["red", "orange", "yellow", "green", "blue", "indigo", "violet"],
 		number: integer,
-
+		engagement_score: [0],
 	},
 	userProps: {
 		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"]
 	},
 	hook: function (record, type, meta) {

package/dungeons/technical/scale-test-schema.json

@@ -0,0 +1,70 @@
+{
+  "events": [
+    {
+      "event": "page view",
+      "weight": 10,
+      "properties": {
+        "page": [
+          "/",
+          "/home",
+          "/about",
+          "/pricing",
+          "/docs"
+        ]
+      }
+    },
+    {
+      "event": "click",
+      "weight": 8,
+      "properties": {
+        "element": [
+          "button",
+          "link",
+          "card",
+          "nav",
+          "tab"
+        ],
+        "label": [
+          "submit",
+          "cancel",
+          "next",
+          "back",
+          "learn more"
+        ]
+      }
+    },
+    {
+      "event": "api call",
+      "weight": 6,
+      "properties": {
+        "endpoint": [
+          "/api/users",
+          "/api/data",
+          "/api/auth",
+          "/api/events"
+        ],
+        "status": [
+          200,
+          201,
+          301,
+          400,
+          404,
+          500
+        ],
+        "latency_ms": {
+          "$range": [
+            408,
+            1563
+          ]
+        }
+      }
+    }
+  ],
+  "userProps": {
+    "plan": [
+      "free",
+      "pro",
+      "enterprise"
+    ]
+  }
+}

package/dungeons/technical/scale-test.js

@@ -0,0 +1,90 @@
+import Chance from 'chance';
+let chance = new Chance();
+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 } from "../../lib/utils/utils.js";
+
+/**
+ * ═══════════════════════════════════════════════════════════════
+ * TECHNICAL TEST: Scale & Performance
+ * ═══════════════════════════════════════════════════════════════
+ *
+ * Tests high-volume generation, batch sizing, gzip compression.
+ * - 10,000 users, 500K events, 365 days (1 year)
+ * - gzip enabled, large batch size
+ * - Minimal event schema (3 events, few properties)
+ * - No hooks, no funnels, no extras
+ *
+ * Explicitly for performance benchmarking and verifying
+ * large file output + batch splitting behavior.
+ */
+
+/** @type {import('../../types').Dungeon} */
+const config = {
+	seed: "scale test",
+	name: "scale-test",
+	numDays: 365,
+	numEvents: 500_000,
+	numUsers: 10_000,
+	format: 'json',
+	gzip: true,
+	batchSize: 500_000,
+	concurrency: 1,
+	region: "US",
+	hasAnonIds: false,
+	hasSessionIds: false,
+	hasAdSpend: false,
+	hasLocation: false,
+	hasAndroidDevices: false,
+	hasIOSDevices: false,
+	hasDesktopDevices: false,
+	hasBrowser: false,
+	hasCampaigns: false,
+	isAnonymous: false,
+	alsoInferFunnels: false,
+	writeToDisk: false,
+
+	events: [
+		{
+			event: "page view",
+			weight: 10,
+			properties: {
+				page: ["/", "/home", "/about", "/pricing", "/docs"],
+			}
+		},
+		{
+			event: "click",
+			weight: 8,
+			properties: {
+				element: ["button", "link", "card", "nav", "tab"],
+				label: ["submit", "cancel", "next", "back", "learn more"],
+			}
+		},
+		{
+			event: "api call",
+			weight: 6,
+			properties: {
+				endpoint: ["/api/users", "/api/data", "/api/auth", "/api/events"],
+				status: [200, 200, 200, 200, 201, 301, 400, 404, 500],
+				latency_ms: weighNumRange(10, 2000, .25),
+			}
+		},
+	],
+	funnels: [],
+	superProps: {},
+	userProps: {
+		plan: ["free", "pro", "enterprise"],
+	},
+	scdProps: {},
+	mirrorProps: {},
+	groupKeys: [],
+	groupProps: {},
+	lookupTables: [],
+	hook: function (record, type, meta) {
+		return record;
+	}
+};
+
+export default config;

package/dungeons/technical/scd-schema.json

@@ -0,0 +1,270 @@
+{
+  "events": [
+    {
+      "event": "checkout",
+      "weight": 2,
+      "properties": {
+        "amount": {
+          "$range": [
+            104,
+            391
+          ]
+        },
+        "currency": [
+          "USD",
+          "CAD",
+          "EUR",
+          "BTC",
+          "ETH",
+          "JPY"
+        ],
+        "coupon": [
+          "none",
+          "10%OFF",
+          "20%OFF",
+          "30%OFF",
+          "40%OFF",
+          "50%OFF"
+        ],
+        "numItems": {
+          "$range": [
+            2,
+            9
+          ]
+        },
+        "discount_applied": [
+          false
+        ]
+      }
+    },
+    {
+      "event": "add to cart",
+      "weight": 4,
+      "properties": {
+        "amount": {
+          "$range": [
+            110,
+            395
+          ]
+        },
+        "rating": {
+          "$range": [
+            1,
+            5
+          ]
+        },
+        "reviews": {
+          "$range": [
+            1,
+            35
+          ]
+        },
+        "isFeaturedItem": [
+          true,
+          false
+        ],
+        "itemCategory": [
+          "Art",
+          "Pet",
+          "Handmade",
+          "Garden",
+          "Beauty",
+          "Baby",
+          "Movies"
+        ],
+        "dateItemListed": {
+          "$type": "string"
+        }
+      }
+    },
+    {
+      "event": "page view",
+      "weight": 10,
+      "properties": {
+        "page": [
+          "/watch",
+          "/product",
+          "/",
+          "/help",
+          "/listen"
+        ],
+        "utm_source": [
+          "linkedin",
+          "$organic",
+          "facebook",
+          "google"
+        ]
+      }
+    },
+    {
+      "event": "watch video",
+      "weight": 8,
+      "properties": {
+        "videoCategory": [
+          "travel",
+          "DIY",
+          "gaming",
+          "funny",
+          "news",
+          "educational"
+        ],
+        "isFeaturedItem": [
+          true,
+          false
+        ],
+        "watchTimeSec": {
+          "$range": [
+            130,
+            469
+          ]
+        },
+        "quality": [
+          "2160p",
+          "1440p",
+          "1080p",
+          "720p",
+          "480p",
+          "360p",
+          "240p"
+        ],
+        "format": [
+          "mp4",
+          "avi",
+          "mov",
+          "mpg"
+        ],
+        "uploader_id": {
+          "$type": "string"
+        },
+        "is_weekend": [
+          false
+        ]
+      }
+    },
+    {
+      "event": "view item",
+      "weight": 8,
+      "properties": {
+        "isFeaturedItem": [
+          true,
+          false
+        ],
+        "itemCategory": [
+          "Games",
+          "Handmade",
+          "Electronics",
+          "Music",
+          "Books",
+          "Movies"
+        ],
+        "dateItemListed": {
+          "$type": "string"
+        }
+      }
+    },
+    {
+      "event": "save item",
+      "weight": 5,
+      "properties": {
+        "isFeaturedItem": [
+          true,
+          false
+        ],
+        "itemCategory": [
+          "Food",
+          "Movies",
+          "Handmade",
+          "Art",
+          "Electronics",
+          "Kids",
+          "Baby"
+        ],
+        "dateItemListed": {
+          "$type": "string"
+        }
+      }
+    },
+    {
+      "event": "sign up",
+      "isFirstEvent": true,
+      "properties": {
+        "variants": [
+          "A",
+          "B",
+          "C",
+          "Control"
+        ],
+        "flows": [
+          "new",
+          "existing",
+          "loyal",
+          "churned"
+        ],
+        "flags": [
+          "on",
+          "off"
+        ],
+        "experiment_ids": [
+          "1234",
+          "5678",
+          "9012",
+          "3456",
+          "7890"
+        ],
+        "multiVariate": [
+          true,
+          false
+        ]
+      }
+    },
+    {
+      "event": "cart_abandoned",
+      "properties": {
+        "amount": {
+          "$range": [
+            110,
+            397
+          ]
+        }
+      }
+    }
+  ],
+  "superProps": {
+    "platform": [
+      "web",
+      "mobile",
+      "kiosk",
+      "smartTV"
+    ],
+    "currentTheme": [
+      "light",
+      "dark",
+      "custom"
+    ]
+  },
+  "userProps": {
+    "title": {
+      "$type": "string"
+    },
+    "luckyNumber": {
+      "$range": [
+        117,
+        344
+      ]
+    },
+    "spiritAnimal": [
+      "bee",
+      "octopus",
+      "moth",
+      "butterfly",
+      "aphid",
+      "dragonfly",
+      "ant",
+      "lobster",
+      "slug"
+    ],
+    "spendTier": [
+      "budget"
+    ]
+  }
+}