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

package/dungeons/technical/retention-cadence-schema.json

@@ -0,0 +1,37 @@
+{
+  "events": [
+    {
+      "event": "first behavior",
+      "isFirstEvent": true
+    },
+    {
+      "event": "hourly behavior",
+      "weight": 40
+    },
+    {
+      "event": "daily behavior",
+      "weight": 30
+    },
+    {
+      "event": "weekly behavior",
+      "weight": 15
+    },
+    {
+      "event": "monthly behavior",
+      "weight": 10
+    },
+    {
+      "event": "placeholder",
+      "weight": 50
+    }
+  ],
+  "userProps": {
+    "favorite color": [
+      "red",
+      "blue",
+      "green",
+      "yellow",
+      "purple"
+    ]
+  }
+}

package/dungeons/{retention-cadence.js → technical/retention-cadence.js}

@@ -2,14 +2,14 @@ const SEED = "kurby-retention";
 import dayjs from 'dayjs';
 import utc from 'dayjs/plugin/utc.js';
 dayjs.extend(utc);
-import * as u from "../lib/utils/utils.js";
+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 */
 
 /**
  * ═══════════════════════════════════════════════════════════════
@@ -119,7 +119,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

@@ -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"
+    }
+  ],
+  "funnels": [
+    {
+      "sequence": [
+        "qux",
+        "garply",
+        "durtle",
+        "linny",
+        "fonk",
+        "crumn",
+        "yak"
+      ]
+    },
+    {
+      "sequence": [
+        "foo",
+        "bar",
+        "baz"
+      ],
+      "isFirstFunnel": true
+    }
+  ],
+  "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"
+    ]
+  }
+}

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

@@ -3,8 +3,9 @@ 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";
 
+/** @typedef {import("../../types").Dungeon} Config */
 /**
  * ═══════════════════════════════════════════════════════════════
  * DATASET OVERVIEW
@@ -106,11 +107,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";
+
+/** @typedef {import("../../types").Dungeon} Config */
+/**
+ * ═══════════════════════════════════════════════════════════════
+ * 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,
+	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;