make-mp-data 1.5.1 → 1.5.3

package/.gcloudignore

@@ -0,0 +1,17 @@
+.env
+scratch.mjs
+tsconfig.json
+types.d.ts
+tmp
+tests
+scripts
+data
+.vscode
+.git
+node_modules
+env.yml
+.prettierrc
+.gitattributes
+README.md
+dungeons
+schemas

package/.vscode/launch.json

@@ -4,28 +4,16 @@
 	// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
 	"version": "0.2.0",
 	"configurations": [
-		{
-			"command": "npm run simple",
-			"name": "simple",
-			"request": "launch",
-			"type": "node-terminal"
-		},
-		{
-			"command": "npm run complex",
-			"name": "complex",
-			"request": "launch",
-			"type": "node-terminal"
-		},
 		{
 			"command": "npm run dev",
-			"name": "dev",
+			"name": "scratch",
 			"request": "launch",
 			"type": "node-terminal"
 		},
 		{
             "type": "node",
             "request": "launch",
-            "name": "go",
+            "name": "run dungeon",
             "runtimeExecutable": "nodemon",
             "runtimeArgs": ["--inspect"],
             "program": "${workspaceFolder}/index.js",
@@ -34,7 +22,30 @@
             "console": "integratedTerminal",
             "internalConsoleOptions": "neverOpen",
             "skipFiles": ["<node_internals>/**"],
+			"preLaunchTask": "npm: prune",
         },
+		{
+			"type": "node",
+			"request": "launch",
+			"name": "current file",
+			"runtimeExecutable": "nodemon",
+			"program": "${file}",
+			"restart": true,
+			"console": "integratedTerminal",
+			"internalConsoleOptions": "neverOpen",
+			"env": {
+				"NODE_ENV": "dev"
+			}
+		},
+		{
+			"command": "npm run func:local",
+			"name": "cloud local",
+			"request": "launch",
+			"type": "node-terminal",
+			"env": {
+				"NODE_ENV": "dev"
+			}
+		},
 		{
             "type": "node",
             "request": "launch",
@@ -47,6 +58,18 @@
             "console": "integratedTerminal",
             "internalConsoleOptions": "neverOpen",
             "skipFiles": ["<node_internals>/**"],
+        },
+		{
+            "type": "node-terminal",
+            "request": "launch",
+            "name": "simple",
+            "command": "node ${workspaceFolder}/index.js --simple"
+        },
+		{
+            "type": "node-terminal",
+            "request": "launch",
+            "name": "complex",
+            "command": "node ${workspaceFolder}/index.js --complex"
         }
 	]
 }

package/.vscode/settings.json

@@ -11,6 +11,7 @@
 		"Dont",
 		"durtle",
 		"fonk",
+		"gameplay",
 		"garply",
 		"jackalope",
 		"linny",
@@ -23,6 +24,7 @@
 		"nessie",
 		"nesty",
 		"planthopper",
+		"PROOMPTY",
 		"psyllid",
 		"tatzelwurm",
 		"timesoup",

package/.vscode/tasks.json

@@ -0,0 +1,12 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "npm: prune",
+            "type": "npm",
+            "script": "prune",
+            "group": "build",
+            "problemMatcher": []
+        }
+    ]
+}

package/components/ai.js

@@ -0,0 +1,93 @@
+const { GoogleGenerativeAI } = require("@google/generative-ai"); 
+const u = require("ak-tools");
+
+
+const dotenv = require("dotenv");
+dotenv.config();
+
+const { GEMINI_API_KEY: API_KEY, NODE_ENV = "unknown" } = process.env;
+if (!API_KEY) throw new Error("Please provide a Gemini API key");
+
+async function generateSchema(userInput) {
+	const gemini = new GoogleGenerativeAI(API_KEY);
+	const model = gemini.getGenerativeModel({ model: "gemini-1.5-flash" });
+	const PROOMPTY = await u.load("./components/prompt.txt");
+	const prompt = `
+Given the following information about a website or app:
+
+${userInput}
+
+${PROOMPTY}
+
+REMEMBER, YOUR INPUT IS:
+
+${userInput}
+`.trim();
+
+	let schema;
+	let schemaIsValid = false;
+	let attempts = 0;
+	do {
+		attempts++;
+		const result = await model.generateContent(prompt);
+		const response = await result.response;
+		const text = response.text();
+		schema = processResponse(text);
+		schemaIsValid = validator(schema);
+	} while (!schemaIsValid);
+
+	return schema;
+}
+
+function processResponse(text) {
+	let json;
+	// check for ```json
+	const start = text.indexOf("```json");
+	const end = text.indexOf("```", start + 1);
+
+	if (start === -1 || end === -1) {
+		const start = text.indexOf("{");
+		const end = text.lastIndexOf("}");
+		json = text.slice(start, end + 1).trim();
+	}
+
+	json = text.slice(start + 7, end).trim();
+
+	try {
+		return JSON.parse(json);
+	}
+	catch (e) {
+		return null;
+	}
+
+
+}
+
+function validator(schema) {
+	let valid = true;
+
+	//null schema are always invalid
+	if (!schema) valid = false;
+
+	//must have 3 or more events
+	if (schema.events.length < 3) valid = false;
+
+	//must have 2 or more superProps
+	if (Object.keys(schema.superProps).length < 2) valid = false;
+
+	//must have 2 or more userProps
+	if (Object.keys(schema.userProps).length < 2) valid = false;
+
+	return valid;
+}
+
+
+if (require.main === module) {
+	generateSchema(`a dungeons and dragons inspired game where players can create characters, join parties, and go on quests and fight bosses!`)
+		.then((result) => {
+			if (NODE_ENV === "dev") debugger;
+		})
+		.catch((error) => {
+			if (NODE_ENV === "dev") debugger;
+		});
+}

package/components/chart.js

@@ -5,6 +5,8 @@ const dayjs = require('dayjs');
 const { openFinder } = require('./utils');
 const { existsSync } = fs;
 const path = require('path');
+require('dotenv').config();
+const { NODE_ENV = "unknown" } = process.env;
 
 
 let tempDir;
@@ -185,3 +187,15 @@ async function generateLineChart(rawData, signupEvents = ["sign up"], fileName)
 }
 
 module.exports = { generateLineChart };
+
+
+
+if (require.main === module) {
+	generateLineChart()
+	.then((result)=>{
+		if (NODE_ENV === "dev") debugger;
+	})
+	.catch((error)=>{
+		if (NODE_ENV === "dev") debugger;
+	})
+}

package/components/cli.js

@@ -34,6 +34,12 @@ DATA MODEL: https://github.com/ak--47/make-mp-data/blob/main/default.js
 			describe: 'project token; if supplied data will be sent to mixpanel',
 			type: 'string'
 		})
+		.option("batchSize", {
+			demandOption: false,
+			alias: 'b',
+			describe: 'batch size for chunking data',
+			type: 'number'
+		})
 		.option("seed", {
 			demandOption: false,
 			alias: 's',
@@ -42,7 +48,7 @@ DATA MODEL: https://github.com/ak--47/make-mp-data/blob/main/default.js
 		})
 		.option("format", {
 			demandOption: false,
-			default: 'csv',
+			default: 'json',
 			alias: 'f',
 			describe: 'csv or json',
 			type: 'string'
@@ -81,7 +87,7 @@ DATA MODEL: https://github.com/ak--47/make-mp-data/blob/main/default.js
 			demandOption: false,
 			default: 'US',
 			alias: 'r',
-			describe: 'either US or EU',
+			describe: 'either US or EU or IN',
 			type: 'string'
 		})
 		.option('concurrency', {

package/components/project.js

@@ -2,6 +2,7 @@ require('dotenv').config();
 const akTools = require('ak-tools');
 const { rand, makeName } = akTools;
 let { OAUTH_TOKEN = "" } = process.env;
+const { NODE_ENV = "unknown" } = process.env;
 
 /**
  * Main function to create a project and add group keys to it.
@@ -152,4 +153,14 @@ async function addGroupKeys(groupKeyDfns = [], projectId, oauthToken = OAUTH_TOK
 }
 
 
+if (require.main === module) {
+	main()
+	.then((result)=>{
+		if (NODE_ENV === "dev") debugger;
+	})
+	.catch((error)=>{
+		if (NODE_ENV === "dev") debugger;
+	})
+}
+
 module.exports = main;

package/components/prompt.txt

@@ -0,0 +1,98 @@
+Please generate a JSON schema for event analytics that strictly adheres to these TypeScript types:
+
+```typescript
+type Primitives = string | number | boolean | Date | Record<string, any>;
+type ValidValue = Primitives | Primitives[];
+
+/**
+ * event schema describes a single event that we might track with any number of properties
+ */
+interface EventSchema {
+	event: string;
+	weight: number;
+	properties?: Record<string, ValidValue>;
+	isFirstEvent?: boolean;
+	isChurnEvent?: boolean;
+}
+
+/**
+ * super props are shared across all events; common dimensions
+ */
+type superProps = Record<string, ValidValue>;
+
+/**
+ * user props describe a user independent of their actions; user dimensions
+ */
+type userProps = Record<string, ValidValue>;
+
+/**
+ * the schema YOU need to build
+ */
+type Schema = {
+events: EventSchema[];
+superProps: superProps;
+userProps: userProps;
+};
+```
+
+
+The schema that YOU make should include common events and properties, super properties, and user properties that describe TYPICAL user behavior for the website i mentioned above.
+
+Let me give you a few examples, so you know how to respond.
+
+**Example 1:**
+
+Input: a generic e-commerce website thats sells a variety of products and also video streaming
+
+Output:
+```json
+{"events":[{"event":"checkout","weight":2,"properties":{"amount":[5,500],"currency":["USD","CAD","EUR","BTC","ETH","JPY"],"coupon":["none","10%OFF","20%OFF"],"numItems":[1,10]}},{"event":"add to cart","weight":4,"properties":{"amount":[5,500],"rating":[1,5],"reviews":[0,35],"isFeaturedItem":[true,false,false],"itemCategory":["electronics","clothing","accessories","home goods","toys","tools","books","music","movies"]}},{"event":"page view","weight":10,"properties":{"page":["/","/","/help","/account","/watch","/listen","/product","/people","/peace"]}},{"event":"watch video","weight":8,"properties":{"videoCategory":["humor","scary","amsr","music","documentary","educational"],"isFeaturedItem":[true,false,false],"watchTimeSec":[10,600],"quality":["2160p","1440p","1080p","720p","480p","360p","240p"],"format":["mp4","avi","mov","mpg"]}},{"event":"view item","weight":8,"properties":{"isFeaturedItem":[true,false,false],"itemCategory":["office","school","art","crafts","party","wedding","baby","kids","adults","seniors"],"rating":[1,5]}},{"event":"save item","weight":5,"properties":{"isFeaturedItem":[true,false,false],"itemCategory":["electronics","games","food","beverages","health","beauty","sports","outdoors","party","wedding","baby","kids","adults","seniors"]}},{"event":"rent item","weight":2,"properties":{"isFeaturedItem":[true,false,false],"itemCategory":["electronics","clothing","games","food","beauty","sports","outdoors","automotive","wedding","baby","seniors"]}},{"event":"sign up","isFirstEvent":true,"weight":0,"properties":{"variants":["A","B","C","Control"],"flows":["new","existing","loyal","churned"],"flags":["on","off"],"experiment_ids":["1234","5678","9012","3456","7890"],"multiVariate":[true,false]}}],"superProps":{"platform":["web","mobile","kiosk","smartTV"],"currentTheme":["light","dark","custom"]},"userProps":{"loyalty_points":[1,100000],"age":[18,70],"premium":[true,false],"language":["english","spanish","french"]}}
+```
+
+**Example 2:**
+
+Input: https://www.nytimes.com
+
+Output:
+```json
+{"events":[{"event":"page view","weight":10,"properties":{"page":["/","/section/world","/section/us","/section/politics","/section/business","/section/opinion","/section/technology","/section/science","/section/health","/section/sports","/section/arts","/section/fashion","/section/food","/section/travel"]}},{"event":"article read","weight":8,"properties":{"category":["world news","politics","business","technology","science","health","sports","arts","fashion","food","travel"],"length":["short (< 3 mins)","medium (3-5 mins)","long (> 5 mins)"],"author_reputation":["emerging","established","renowned"],"comment_interaction":["low (<10 comments)","medium (10-50 comments)","high (>50 comments)"]}},{"event":"search","weight":6,"properties":{"search_term_length":["short (1-3 words)","medium (4-6 words)","long (7+ words)"],"results_returned":["none","few (1-3 results)","some (4-10 results)","many (>10 results)"],"result_clicked":["first result","within top 5","none clicked"]}},{"event":"subscribe","weight":2,"properties":{"plan":["basic","premium","all-access"],"payment_method":["credit card","paypal","apple pay"],"trial_offer_accepted":[true,false]}},{"event":"newsletter sign up","weight":3,"properties":{"newsletter_type":["daily briefing","morning briefing","opinion","cooking","arts"],"opt_in_for_promotions":[true,false]}},{"event":"comment posted","weight":4,"properties":{"comment_length":["short (< 50 words)","medium (50-150 words)","long (> 150 words)"],"article_category":["news","opinion","review"],"visibility":["public","private","friends only"]}}],"superProps":{"platform":["web","mobile","tablet"],"loggedIn":[true,false],"time_of_day":["morning","afternoon","evening","night"],"browser_type":["Chrome","Firefox","Safari","Edge"]},"userProps":{"subscriptionType":["none","basic","premium","all-access"],"age_group":["<18","18-24","25-34","35-44","45-54","55-64","65+"],"location":["USA","Europe","Asia","Other"],"interests":["politics","technology","health","sports","arts","lifestyle","science","education"]}}
+```
+
+**Example 3:**
+
+Input: the love's truck stop app (love's connect: https://www.loves.com/en/my-love-rewards/download-loves-connect)
+
+Output:
+```json
+{"events":[{"event":"home button","weight":8,"properties":{"button type":["front","side","middle"]}},{"event":"route button","weight":6,"properties":{"from screen":["home","services"]}},{"event":"services button","weight":2,"properties":{"is emergency?":[false,true]}},{"event":"stores button","weight":3,"properties":{"is from push?":[true,false]}},{"event":"email link clicked","weight":1,"properties":{"campaign_name":["Pro Email Campaign 1","Pro Email Campaign 2","Pro Email Campaign 3"]}},{"event":"pay button","weight":4,"properties":{}},{"event":"pay with location","weight":3,"properties":{}},{"event":"payment select","weight":4,"properties":{}},{"event":"select pump","weight":5,"properties":{"pump":[1,32]}},{"event":"select fuel","weight":3,"properties":{"fuel type":["diesel","reefer","def"],"fuel price":[3.99,6.79]}},{"event":"fueling","weight":4,"properties":{"fuel volume":[20,150]}}],"superProps":{"campaign_name":["Pro Email Campaign 1","Pro Email Campaign 2","Pro Email Campaign 3"],"feature flags":[["first 100k miles"],["dark mode","first 100k miles"],["dark mode","free shower"],["free shower"]]},"userProps":{"driver type":["Leased","Owner","Fleet"],"marketing":["in-app","email","sms","call"],"member status":["base","gold","platinum","diamond"],"lifetime value":[0,10000]}}
+```
+
+**Example 4:**
+
+Input: the web app for one medical, a modern healthcare provider (https://app.onemedical.com/)
+
+Output:
+```json
+{"events":[{"event":"login","weight":9,"properties":{"method":["standard email/password","google","apple"],"success":[true,false],"error_type":["none","password incorrect","user not found","account locked"]}},{"event":"appointment booking","weight":8,"properties":{"type":["physical","virtual"],"specialty":["primary care","mental health","pediatrics","nutrition","allergy","dermatology"],"duration":["15 minutes","30 minutes","1 hour"],"booking_advance_days":["same day","1-3 days","4-7 days","more than a week"]}},{"event":"profile update","weight":4,"properties":{"section_updated":["personal information","insurance details","medical history","preferences"],"fields_changed":["1-2","3-5","more than 5"]}},{"event":"message to provider","weight":6,"properties":{"message_length":["short (<50 words)","medium (50-150 words)","long (>150 words)"],"response_time":["<1 hour","1-24 hours","1-2 days","no response"],"urgency":["low","medium","high"]}},{"event":"medication refill request","weight":5,"properties":{"medication":["prescription","over-the-counter"],"quantity":["1 month","3 months","6 months"],"auto_refill_enrolled":[true,false]}},{"event":"health record access","weight":7,"properties":{"record_type":["lab results","vaccination records","prescription history","doctor notes"],"access_device":["desktop","mobile"],"time_spent":["<1 min","1-5 mins","5+ mins"]}},{"event":"feedback submission","weight":3,"properties":{"feedback_type":["service","app usability","provider"],"rating":["1","2","3","4","5"],"comment_provided":[true,false]}},{"event":"notification settings update","weight":2,"properties":{"notifications_enabled":[true,false],"types_enabled":["appointment reminders","health updates","newsletters","promotional offers"]}}],"superProps":{"platform":["web","mobile"],"loggedIn":[true,false],"user_type":["patient","provider","admin"],"subscription_level":["free","standard","premium"]},"userProps":{"membership_status":["active","lapsed","pending renewal"],"age_group":["<18","18-24","25-34","35-44","45-54","55-64","65+"],"has_chronic_conditions":[true,false],"preferred_contact_method":["email","phone","sms"]}}
+```
+
+**Example 5:**
+
+Input: the web app for coinbase, a cryptocurrency exchange (https://www.coinbase.com/)
+
+Output:
+```json
+{"events":[{"event":"login","weight":9,"properties":{"method":["standard email/password","two-factor authentication","biometric"],"success":[true,false],"error_type":["none","password incorrect","user not found","account locked","2FA failed"]}},{"event":"trade executed","weight":8,"properties":{"crypto_pair":["BTC/USD","ETH/USD","LTC/USD","XRP/USD","BCH/USD"],"trade_type":["buy","sell"],"order_type":["market","limit","stop loss","stop limit"],"quantity":["<1","1-5","5-10","10+"],"trade_successful":[true,false],"error_type":["none","insufficient funds","slippage too high","network error"]}},{"event":"account funding","weight":7,"properties":{"method":["bank transfer","credit card","crypto deposit"],"currency":["USD","EUR","GBP"],"amount":["<100","100-1000","1000-5000","5000+"],"successful":[true,false],"error_type":["none","transaction declined","limits exceeded","network error"]}},{"event":"withdrawal request","weight":6,"properties":{"method":["bank transfer","crypto withdrawal"],"currency":["USD","BTC","ETH"],"amount":["<100","100-1000","1000-5000","5000+"],"successful":[true,false],"error_type":["none","insufficient funds","limits exceeded","network error"]}},{"event":"profile update","weight":3,"properties":{"fields_updated":["email","phone","two-factor authentication settings","payment methods"],"successful":[true,false]}},{"event":"security alert","weight":4,"properties":{"alert_type":["login from new device","suspicious transaction","profile changes"],"response_action":["no action","contact support","reset password","enable 2FA"]}},{"event":"price alert set","weight":2,"properties":{"crypto":["BTC","ETH","LTC","XRP"],"threshold":["<5000","5000-10000","10000-20000","20000+"],"alert_type":["price increase","price decrease"]}},{"event":"customer support interaction","weight":5,"properties":{"issue_type":["account access","trade issue","withdrawal problem","other"],"contact_method":["email","phone","live chat"],"resolution":["resolved","unresolved","escalated"]}}],"superProps":{"platform":["web","iOS app","Android app"],"loggedIn":[true,false],"verification_level":["none","basic","verified","pro"]},"userProps":{"account_type":["basic","pro"],"trading_frequency":["daily","weekly","monthly","rarely"],"preferred_crypto":["BTC","ETH","LTC","XRP"],"region":["North America","Europe","Asia","Other"],"investment_level":["<1000","1000-5000","5000-10000","10000+"]}}
+```
+
+**ADDITIONAL GUIDELINES:**
+
+* Use specific and descriptive event names.
+* DO NOT declare property types, properties are the key names and include an array of POSSIBLE values which could be chosen for the event or user
+	* the properties within each event should adhere to the defined TypeScript types (Primitives and ValidValue)
+* For numerical ranges, you can use [min, max] in the JSON as above
+* Consider both super properties (applied to all events) and user properties; they should be different from event props
+* DO NOT include user IDs, emails, or location properties anywhere data in the schema; ONLY highlight the properties specific to the website or app 
+	* DO NOT be lazy an say ['array of payment types'] or ['array of product categories'] - be specific ... ['USD', 'CAD', 'EUR', 'BTC', 'ETH', 'JPY'] ... we want to see the actual values that would be passed live production data
+* event names should be lower case by convention; prefer spaces to underscores so "add to cart" instead of "add_to_cart"
+* you should ALWAYS output valid JSON as your output will be fed into a JSON schema validator

package/components/utils.js

@@ -12,7 +12,7 @@ dayjs.extend(utc);
 require('dotenv').config();
 const { domainSuffix, domainPrefix } = require('./defaults');
 
-/** @typedef {import('../types').Config} Config */
+/** @typedef {import('../types').Dungeon} Config */
 /** @typedef {import('../types').EventConfig} EventConfig */
 /** @typedef {import('../types').ValueValid} ValueValid */
 /** @typedef {import('../types').HookedArray} hookArray */
@@ -179,14 +179,26 @@ function day(start, end) {
  * @param  {ValueValid} value
  */
 function choose(value) {
+	// let wasFunctionCalled = false;
 	const chance = getChance();
+
 	try {
 		// Keep resolving the value if it's a function
 		while (typeof value === 'function') {
 			value = value();
+			// wasFunctionCalled = true;
 		}
 
+		// allow functions which create arrays of objects to pass through
+		// if (Array.isArray(value) && wasFunctionCalled && value.length > 1 && value[0] === null) {
+		// 	return value.slice(1);
+		// }
+
 		// Now, if the resolved value is an array, use chance.pickone
+		if (Array.isArray(value) && hasSameKeys(value)) {
+			return value;
+		}
+
 		if (Array.isArray(value)) {
 			return chance.pickone(value);
 		}
@@ -204,10 +216,36 @@ function choose(value) {
 	}
 	catch (e) {
 		console.error(`\n\nerror on value: ${value};\n\n`, e, '\n\n');
+		throw e;
 		return '';
 	}
 }
 
+
+function hasSameKeys(arr) {
+	if (arr.length <= 1) {
+	  return true; // An empty array or an array with one object always has the same keys
+	}
+  
+	const firstKeys = Object.keys(arr[0]);
+  
+	for (let i = 1; i < arr.length; i++) {
+	  const currentKeys = Object.keys(arr[i]);
+  
+	  if (currentKeys.length !== firstKeys.length) {
+		return false; // Different number of keys
+	  }
+  
+	  for (const key of firstKeys) {
+		if (!currentKeys.includes(key)) {
+		  return false; // Key missing in current object
+		}
+	  }
+	}
+  
+	return true; // All objects have the same keys
+  }
+
 /**
  * keeps picking from an array until the array is exhausted
  * @param  {Array} arr
@@ -316,6 +354,58 @@ function range(a, b, step = 1) {
 };
 
 
+function companyName(words = 2, separator = " ") {
+	const industryAdjectives = ["advanced", "premier", "integrated", "optimized", "comprehensive", "expert",
+		"visionary", "progressive", "transformative", "pioneering", "streamlined",
+		"cutting-edge", "impactful", "purpose-driven", "value-oriented", "future-ready",
+		"scalable", "responsive", "data-driven", "cloud-based", "user-friendly",
+		"high-performance", "secure", "compliant", "ethical", "inclusive",
+		"transparent", "community-focused", "environmentally-conscious", "socially-responsible", "innovative", "dynamic", "global", "leading", "reliable", "trusted",
+		"strategic", "efficient", "sustainable", "creative", "agile", "resilient",
+		"collaborative", "customer-centric", "forward-thinking", "results-driven", "gizmo", "contraption", "doodle", "whimsy", "quirk", "spark", "zing",
+		"zap", "pop", "fizz", "whirl", "twirl", "swirl", "jumble", "tumble",
+		"hodgepodge", "mishmash", "kaleidoscope", "labyrinth", "maze", "puzzle",
+		"enigma", "conundrum", "paradox", "oxymoron", "chimera", "centaur",
+		"griffin", "phoenix", "unicorn", "dragon", "mermaid", "yeti", "bigfoot",
+		"loch ness monster", "chupacabra", "kraken", "leviathan", "behemoth",
+		"juggernaut", "goliath", "david", "odyssey", "pilgrimage", "crusade",
+		"quest", "adventure", "escapade", "frolic", "romp", "lark", "spree",
+		"binge", "jag", "bender", "tear", "rampage", "riot", "ruckus", "rumpus",
+		"hullabaloo", "brouhaha", "kerfuffle", "shindig", "hootenanny", "jamboree",
+		"fiesta", "carnival", "gala", "soiree", "bash", "fete", "jubilee"
+
+	];
+
+	const companyNouns = [
+		"solutions", "group", "partners", "ventures", "holdings", "enterprises",
+		"systems", "technologies", "innovations", "associates", "corporation", "inc.",
+		"ltd.", "plc.", "gmbh", "s.a.", "llc.", "network", "alliance", "consortium", "collective", "foundation", "institute",
+		"laboratory", "agency", "bureau", "department", "division", "branch",
+		"office", "center", "hub", "platform", "ecosystem", "marketplace",
+		"exchange", "clearinghouse", "repository", "archive", "registry",
+		"database", "framework", "infrastructure", "architecture", "protocol",
+		"standard", "specification", "guideline", "blueprint", "roadmap",
+		"strategy", "plan", "initiative", "program", "project", "campaign",
+		"operation", "mission", "task", "force", "team", "crew", "squad",
+		"unit", "cell", "pod", "cohort", "community", "network", "circle",
+		"forum", "council", "board", "committee", "panel", "jury", "tribunal"
+	];
+
+	let name = "";
+	const cycle = [industryAdjectives, companyNouns];
+	for (let i = 0; i < words; i++) {
+		const index = i % cycle.length;
+		const word = cycle[index][Math.floor(Math.random() * cycle[index].length)];
+		if (name === "") {
+			name = word;
+		} else {
+			name += separator + word;
+		}
+	}
+
+	return name;
+}
+
 
 /*
 ----
@@ -877,6 +967,8 @@ function person(userId, bornDaysAgo = 30, isAnonymous = false, hasAvatar = false
 	let avPath = gender === 'male' ? `/men/${randomAvatarNumber}.jpg` : `/women/${randomAvatarNumber}.jpg`;
 	let avatar = avatarPrefix + avPath;
 	let created = dayjs().subtract(bornDaysAgo, 'day').format('YYYY-MM-DD');
+
+
 	// const created = date(bornDaysAgo, true)();
 
 
@@ -925,7 +1017,35 @@ function person(userId, bornDaysAgo = 30, isAnonymous = false, hasAvatar = false
 };
 
 
-
+function wrapFunc(obj, func, recursion = 0, parentKey = null, grandParentKey = null, whitelist = [
+	"events",
+	"superProps",
+	"userProps",
+	"scdProps",
+	"mirrorProps",
+	"groupEvents",
+	"groupProps"
+]) {
+	if (recursion === 0) {
+		// Only process top-level keys in the whitelist
+		for (const key in obj) {
+			if (whitelist.includes(key)) {
+				obj[key] = wrapFunc(obj[key], func, recursion + 1, key, null, whitelist);
+			}
+		}
+	} else {
+		if (Array.isArray(obj) && grandParentKey === 'properties') {
+			return func(obj);
+		} else if (typeof obj === 'object' && obj !== null) {
+			for (const key in obj) {
+				if (obj.hasOwnProperty(key)) {
+					obj[key] = wrapFunc(obj[key], func, recursion + 1, key, parentKey, whitelist);
+				}
+			}
+		}
+	}
+	return obj;
+}
 
 //UNUSED
 
@@ -989,9 +1109,9 @@ module.exports = {
 	exhaust,
 	integer,
 	TimeSoup,
-
+	companyName,
 	generateEmoji,
-
+	haveSameKeys: hasSameKeys,
 
 	initChance,
 	getChance,
@@ -1025,5 +1145,6 @@ module.exports = {
 	streamJSON,
 	streamCSV,
 	datesBetween,
-	weighChoices
+	weighChoices,
+	wrapFunc,
 };

package/{schemas → dungeons}/adspend.js

@@ -16,7 +16,7 @@ dayjs.extend(utc);
 const { uid, comma } = require('ak-tools');
 const { pickAWinner, weighNumRange, date, integer } = require('../components/utils');
 
-/** @type {import('../types').Config} */
+/** @type {import('../types').Dungeon} */
 const config = {
 	token: "",
 	seed: "foo bar",

package/{schemas → dungeons}/anon.js

@@ -18,7 +18,7 @@ const { pickAWinner, weighNumRange, date, integer } = require('../components/uti
 
 
 
-/** @type {import('../types').Config} */
+/** @type {import('../types').Dungeon} */
 const config = {
 	token: "",
 	seed: "foo bar",

package/{schemas → dungeons}/big.js

@@ -18,7 +18,7 @@ dayjs.extend(utc);
 const { uid, comma } = require('ak-tools');
 const { pickAWinner, weighNumRange, date, integer } = require('../components/utils');
 
-/** @type {import('../types').Config} */
+/** @type {import('../types').Dungeon} */
 const config = {
 	token: "",
 	seed: "lets go",

package/{schemas → dungeons}/business.js

@@ -20,7 +20,7 @@ const EVENTS = 50_000
 const USERS = EVENTS / 100
 
 
-/** @type {import('../types.js').Config} */
+/** @type {import('../types.js').Dungeon} */
 const config = {
 	token: "",	
 	seed: "it's business time...",