make-mp-data 1.0.17 → 1.1.0

package/cli.js

@@ -18,10 +18,13 @@ function cliParams() {
 		.scriptName("make-mp-data")
 		.usage(`\nusage:\nnpx $0 [dataModel.js] [options]
 ex:
-npx $0 --token 1234 --events 1000000
-npx $0 myDataOutline.js --token 1234 --days 90
+npx $0
+npx $0 --token 1234 --u 100 --e 1000 --d 7 --w false
+npx $0 myDataConfig.js
 
-DOCS: https://github.com/ak--47/make-mp-data`)
+DOCS: https://github.com/ak--47/make-mp-data
+DATA MODEL: https://github.com/ak--47/make-mp-data/blob/main/default.js
+`)
 		.command('$0', 'model mixpanel data', () => { })
 		.option("token", {
 			demandOption: false,

package/default.js

@@ -1,7 +1,16 @@
+/**
+ * This is the default configuration file for the data generator
+ * notice how the config object is structured, and see it's type definition in ./types.d.ts
+ * feel free to modify this file to customize the data you generate
+ * see helper functions in utils.js for more ways to generate data
+ */
+
+
 const Chance = require('chance');
 const chance = new Chance();
-const { weightedRange, makeProducts, date, generateEmoji } = require('./utils.js');
+const { weightedRange, makeProducts, date, generateEmoji, makeHashTags } = require('./utils.js');
 
+/** @type {import('./types.d.ts').Config} */
 const config = {
 	token: "",
 	seed: "foo bar baz",
@@ -40,6 +49,19 @@ const config = {
 				utm_source: ["$organic", "$organic", "$organic", "$organic", "google", "google", "google", "facebook", "facebook", "twitter", "linkedin"],
 			}
 		},
+		{
+			"event": "watch video",
+			"weight": 8,
+			"properties": {
+				category: ["funny", "educational", "inspirational", "music", "news", "sports", "cooking", "DIY", "travel", "gaming"],
+				hashTags: makeHashTags,
+				watchTimeSec: weightedRange(10, 600, 1000, .25),
+				quality: ["2160p", "1440p", "1080p", "720p", "480p", "360p", "240p"],
+				format: ["mp4", "avi", "mov", "mpg"],
+				uploader_id: chance.guid.bind(chance)
+
+			}
+		},
 		{
 			"event": "view item",
 			"weight": 8,
@@ -67,7 +89,7 @@ const config = {
 		}
 	],
 	superProps: {
-		platform: ["web", "mobile", "web", "mobile", "web", "kiosk"],
+		platform: ["web", "mobile", "web", "mobile", "web", "kiosk", "smartTV"],
 		emotions: generateEmoji(),
 
 	},
@@ -78,7 +100,7 @@ const config = {
 	userProps: {
 		title: chance.profession.bind(chance),
 		luckyNumber: weightedRange(42, 420),
-		vibe: generateEmoji(),		
+		vibe: generateEmoji(),
 		spiritAnimal: chance.animal.bind(chance)
 	},
 
@@ -101,7 +123,7 @@ const config = {
 	groupProps: {
 		company_id: {
 			$name: () => { return chance.company(); },
-			$email: () => { return `CSM ${chance.pickone(["AK", "Jessica", "Michelle", "Dana", "Brian", "Dave"])}`; },
+			$email: () => { return `CSM: ${chance.pickone(["AK", "Jessica", "Michelle", "Dana", "Brian", "Dave"])}`; },
 			"# of employees": weightedRange(3, 10000),
 			"sector": ["tech", "finance", "healthcare", "education", "government", "non-profit"],
 			"segment": ["enterprise", "SMB", "mid-market"],

package/e2e.test.js

@@ -9,15 +9,16 @@ const { execSync } = require("child_process");
 const u = require('ak-tools');
 
 const timeout = 60000;
+const testToken = process.env.TEST_TOKEN;
 
 
 describe('e2e', () => {
 
 	test('works as module', async () => {
 		console.log('MODULE TEST');
-		const results = await generate({ writeToDisk: false, numEvents: 1000, numUsers: 100, seed: "deal with it" });
+		const results = await generate({ writeToDisk: false, numEvents: 1100, numUsers: 100, seed: "deal with it" });
 		const { eventData, groupProfilesData, lookupTableData, scdTableData, userProfilesData } = results;
-		expect(eventData.length).toBeGreaterThan(900);
+		expect(eventData.length).toBeGreaterThan(980);
 		expect(groupProfilesData.length).toBe(0);
 		expect(lookupTableData.length).toBe(0);
 		expect(scdTableData.length).toBeGreaterThan(200);
@@ -33,6 +34,16 @@ describe('e2e', () => {
 		expect(csvs.length).toBe(5);
 	}, timeout);
 
+	test('sends data to mixpanel', async () => {
+		console.log('NETWORK TEST');
+		const results = await generate({ writeToDisk: false, numEvents: 1100, numUsers: 100, seed: "deal with it", token: testToken});
+		const {events, users, groups } = results.import;
+		expect(events.success).toBeGreaterThan(980);
+		expect(users.success).toBe(100);
+		expect(groups.length).toBe(0);		
+
+	}, timeout);
+	
 
 
 });

package/index.js

@@ -35,11 +35,15 @@ const dayjs = require("dayjs");
 const utc = require("dayjs/plugin/utc");
 dayjs.extend(utc);
 const cliParams = require("./cli.js");
-// @ts-ignore
+const { makeName } = require('ak-tools');
+
 Array.prototype.pickOne = pick;
 const NOW = dayjs().unix();
+let VERBOSE = false;
 
 /** @typedef {import('./types.d.ts').Config} Config */
+/** @typedef {import('./types.d.ts').EventConfig} EventConfig */
+
 
 const PEAK_DAYS = [
 	dayjs().subtract(2, "day").unix(),
@@ -78,18 +82,10 @@ async function main(config) {
 		token = null,
 		region = "US",
 		writeToDisk = false,
+		verbose = false,
 	} = config;
-
-	//ensure we have a token or are writing to disk
-	if (require.main === module) {
-		if (!token) {
-			if (!writeToDisk) {
-				writeToDisk = true;
-				config.writeToDisk = true;
-			}
-		}
-	}
-
+	VERBOSE = verbose;
+	config.simulationName = makeName();
 	const uuidChance = new Chance(seed);
 
 	//the function which generates $distinct_id + $created, skewing towards the present
@@ -115,10 +111,12 @@ async function main(config) {
 		.reduce((acc, event) => {
 			const weight = event.weight || 1;
 			for (let i = 0; i < weight; i++) {
+				
 				acc.push(event);
 			}
 			return acc;
 		}, [])
+		
 		.filter((e) => !e.isFirstEvent);
 
 	const firstEvents = events.filter((e) => e.isFirstEvent);
@@ -133,18 +131,19 @@ async function main(config) {
 	for (let i = 1; i < numUsers + 1; i++) {
 		progress("users", i);
 		const user = uuid();
-		const { distinct_id, $created } = user;
+		const { distinct_id, $created, anonymousIds } = user;
 		userProfilesData.push(makeProfile(userProps, user));
-		const mutations = chance.integer({ min: 1, max: 20 });
+		const mutations = chance.integer({ min: 1, max: 10 });
 		scdTableData.push(makeSCD(scdProps, distinct_id, mutations, $created));
 		const numEventsThisUser = Math.round(
-			chance.normal({ mean: avgEvPerUser, dev: avgEvPerUser / 4 })
+			chance.normal({ mean: avgEvPerUser, dev: avgEvPerUser / integer(3, 7) })
 		);
 
 		if (firstEvents.length) {
 			eventData.push(
 				makeEvent(
 					distinct_id,
+					anonymousIds,
 					dayjs($created).unix(),
 					firstEvents,
 					superProps,
@@ -159,6 +158,7 @@ async function main(config) {
 			eventData.push(
 				makeEvent(
 					distinct_id,
+					anonymousIds,
 					dayjs($created).unix(),
 					weightedEvents,
 					superProps,
@@ -170,7 +170,7 @@ async function main(config) {
 	//flatten SCD
 	scdTableData = scdTableData.flat();
 
-	console.log("\n");
+	log("\n");
 
 	// make group profiles
 	for (const groupPair of groupKeys) {
@@ -188,7 +188,7 @@ async function main(config) {
 		}
 		groupProfilesData.push({ key: groupKey, data: groupProfiles });
 	}
-	console.log("\n");
+	log("\n");
 
 	// make lookup tables
 	for (const lookupTable of lookupTables) {
@@ -213,7 +213,7 @@ async function main(config) {
 		[groupFiles, groupProfilesData],
 		[lookupFiles, lookupTableData],
 	];
-	console.log("\n");
+	log("\n");
 
 	if (!writeToDisk && !token)
 		return {
@@ -224,82 +224,89 @@ async function main(config) {
 			lookupTableData,
 		};
 	//write the files
-	for (const pair of pairs) {
-		const [paths, data] = pair;
-		for (const path of paths) {
-			let datasetsToWrite;
-			if (data?.[0]?.["key"]) datasetsToWrite = data.map((d) => d.data);
-			else datasetsToWrite = [data];
-			for (const writeData of datasetsToWrite) {
-				if (format === "csv") {
-					console.log(`writing ${path}`);
-					const columns = getUniqueKeys(writeData);
-					//papa parse needs nested JSON stringified
-					writeData.forEach((e) => {
-						for (const key in e) {
-							if (typeof e[key] === "object") e[key] = JSON.stringify(e[key]);
-						}
-					})
-					const csv = Papa.unparse(writeData, { columns });
-					await touch(path, csv);
-					console.log(`\tdone\n`);
-				} else {
-					await touch(path, data, true);
+	if (writeToDisk) {
+		if (verbose) log(`writing files... for ${config.simulationName}`);
+		for (const pair of pairs) {
+			const [paths, data] = pair;
+			for (const path of paths) {
+				let datasetsToWrite;
+				if (data?.[0]?.["key"]) datasetsToWrite = data.map((d) => d.data);
+				else datasetsToWrite = [data];
+				for (const writeData of datasetsToWrite) {
+					if (format === "csv") {
+						log(`writing ${path}`);
+						const columns = getUniqueKeys(writeData);
+						//papa parse needs nested JSON stringified
+						writeData.forEach((e) => {
+							for (const key in e) {
+								if (typeof e[key] === "object") e[key] = JSON.stringify(e[key]);
+							}
+						});
+						const csv = Papa.unparse(writeData, { columns });
+						await touch(path, csv);
+						log(`\tdone\n`);
+					} else {
+						await touch(path, data, true);
+					}
 				}
 			}
 		}
 	}
 
 	const importResults = { events: {}, users: {}, groups: [] };
-	/** @type {import('mixpanel-import').Creds} */
-	const creds = { token };
-	/** @type {import('mixpanel-import').Options} */
-	const importOpts = {
-		region,
-		fixData: true,
-		verbose: false,
-		forceStream: true,
-		strict: false,
-		dryRun: false,
-		abridged: false,
-	};
+
 	//send to mixpanel
 	if (token) {
+		/** @type {import('mixpanel-import').Creds} */
+		const creds = { token };
+		/** @type {import('mixpanel-import').Options} */
+		const commonOpts = {
+			
+			region,
+			fixData: true,
+			verbose: false,
+			forceStream: true,
+			strict: false,
+			dryRun: false,
+			abridged: false,
+		};
+
 		if (eventData) {
-			console.log(`importing events to mixpanel...`);
+			log(`importing events to mixpanel...`);
 			const imported = await mp(creds, eventData, {
 				recordType: "event",
 				fixData: true,
 				fixJson: true,
 				strict: false,
-				...importOpts,
+				...commonOpts,
 			});
-			console.log(`\tsent ${comma(imported.success)} events\n`);
+			log(`\tsent ${comma(imported.success)} events\n`);
 			importResults.events = imported;
 		}
 		if (userProfilesData) {
-			console.log(`importing user profiles to mixpanel...`);
+			log(`importing user profiles to mixpanel...`);
 			const imported = await mp(creds, userProfilesData, {
 				recordType: "user",
-				...importOpts,
+				...commonOpts,
 			});
-			console.log(`\tsent ${comma(imported.success)} user profiles\n`);
+			log(`\tsent ${comma(imported.success)} user profiles\n`);
 			importResults.users = imported;
 		}
 		if (groupProfilesData) {
 			for (const groupProfiles of groupProfilesData) {
 				const groupKey = groupProfiles.key;
 				const data = groupProfiles.data;
-				console.log(`importing ${groupKey} profiles to mixpanel...`);
+				log(`importing ${groupKey} profiles to mixpanel...`);
 				const imported = await mp({ token, groupKey }, data, {
 					recordType: "group",
-					...importOpts,
+					...commonOpts,
 				});
-				console.log(`\tsent ${comma(imported.success)} ${groupKey} profiles\n`);
+				log(`\tsent ${comma(imported.success)} ${groupKey} profiles\n`);
+				
 				importResults.groups.push(imported);
 			}
 		}
-		console.log(`\n\n`);
+		log(`\n\n`);
 	}
 	return {
 		import: importResults,
@@ -344,19 +351,33 @@ function makeSCD(props, distinct_id, mutations, $created) {
 	return scdEntries;
 }
 
-function makeEvent(distinct_id, earliestTime, events, superProps, groupKeys, isFirstEvent = false) {
+/**
+ * creates a random event
+ * @param  {string} distinct_id
+ * @param  {string[]} anonymousIds
+ * @param  {number} earliestTime
+ * @param  {Object[]} events
+ * @param  {Object} superProps
+ * @param  {Object} groupKeys
+ * @param  {Boolean} isFirstEvent=false
+ */
+function makeEvent(distinct_id, anonymousIds, earliestTime, events, superProps, groupKeys, isFirstEvent = false) {
+	
 	let chosenEvent = events.pickOne();
 	if (typeof chosenEvent === "string")
 		chosenEvent = { event: chosenEvent, properties: {} };
 	const event = {
 		event: chosenEvent.event,
-		distinct_id,
+		$device_id: chance.pickone(anonymousIds), // always have a $device_id		
 		$source: "AKsTimeSoup",
 	};
 
 	if (isFirstEvent) event.time = dayjs.unix(earliestTime).toISOString();
 	if (!isFirstEvent) event.time = AKsTimeSoup(earliestTime, NOW, PEAK_DAYS);
 
+	//sometimes have a $user_id
+	if (!isFirstEvent && chance.bool({ likelihood: 42 })) event.$user_id = distinct_id;
+
 	const props = { ...chosenEvent.properties, ...superProps };
 
 	//iterate through custom properties
@@ -364,6 +385,7 @@ function makeEvent(distinct_id, earliestTime, events, superProps, groupKeys, isF
 		try {
 			event[key] = choose(props[key]);
 		} catch (e) {
+			console.error(`error with ${key} in ${chosenEvent.event} event`, e);
 			debugger;
 		}
 	}
@@ -372,6 +394,7 @@ function makeEvent(distinct_id, earliestTime, events, superProps, groupKeys, isF
 	for (const groupPair of groupKeys) {
 		const groupKey = groupPair[0];
 		const groupCardinality = groupPair[1];
+		
 		event[groupKey] = weightedRange(1, groupCardinality).pickOne();
 	}
 
@@ -381,14 +404,15 @@ function makeEvent(distinct_id, earliestTime, events, superProps, groupKeys, isF
 function buildFileNames(config) {
 	const { format = "csv", groupKeys = [], lookupTables = [] } = config;
 	const extension = format === "csv" ? "csv" : "json";
-	const current = dayjs.utc().format("MM-DD-HH");
+	// const current = dayjs.utc().format("MM-DD-HH");
+	const simName = config.simulationName;
 	let writeDir = "./";
 	if (config.writeToDisk) writeDir = mkdir("./data");
 
 	const writePaths = {
-		eventFiles: [path.join(writeDir, `events-${current}.${extension}`)],
-		userFiles: [path.join(writeDir, `users-${current}.${extension}`)],
-		scdFiles: [path.join(writeDir, `scd-${current}.${extension}`)],
+		eventFiles: [path.join(writeDir, `events-${simName}.${extension}`)],
+		userFiles: [path.join(writeDir, `users-${simName}.${extension}`)],
+		scdFiles: [path.join(writeDir, `scd-${simName}.${extension}`)],
 		groupFiles: [],
 		lookupFiles: [],
 		folder: writeDir,
@@ -397,14 +421,14 @@ function buildFileNames(config) {
 	for (const groupPair of groupKeys) {
 		const groupKey = groupPair[0];
 		writePaths.groupFiles.push(
-			path.join(writeDir, `group-${groupKey}-${current}.${extension}`)
+			path.join(writeDir, `group-${groupKey}-${simName}.${extension}`)
 		);
 	}
 
 	for (const lookupTable of lookupTables) {
 		const { key } = lookupTable;
 		writePaths.lookupFiles.push(
-			path.join(writeDir, `lookup-${key}-${current}.${extension}`)
+			path.join(writeDir, `lookup-${key}-${simName}.${extension}`)
 		);
 	}
 
@@ -452,7 +476,7 @@ function AKsTimeSoup(earliestTime, latestTime = NOW, peakDays = PEAK_DAYS) {
 
 	// usually, ensure the event time is within business hours
 	if (chance.bool({ likelihood: 42 })) eventTime = Math.min(Math.max(eventTime, businessStart), businessEnd);
-	
+
 	return dayjs.unix(eventTime).toISOString();
 }
 
@@ -467,10 +491,10 @@ if (require.main === module) {
 	//if the user specifics an separate config file
 	let config = null;
 	if (suppliedConfig) {
-		console.log(`using ${suppliedConfig} for data\n`);
+		log(`using ${suppliedConfig} for data\n`);
 		config = require(path.resolve(suppliedConfig));
 	} else {
-		console.log(`... using default configuration ...\n`);
+		log(`... using default configuration ...\n`);
 		config = require("./default.js");
 	}
 
@@ -483,13 +507,15 @@ if (require.main === module) {
 	if (numEvents) config.numEvents = numEvents;
 	if (region) config.region = region;
 	if (writeToDisk) config.writeToDisk = writeToDisk;
+	if (writeToDisk === 'false') config.writeToDisk = false;
+	config.verbose = true;
 
 	main(config)
 		.then((data) => {
-			console.log(`------------------SUMMARY------------------`);
+			log(`------------------SUMMARY------------------`);
 			const { events, groups, users } = data.import;
 			const files = data.files;
-			const folder = files.pop();
+			const folder = files?.pop();
 			const groupBytes = groups.reduce((acc, group) => {
 				return acc + group.bytes;
 			}, 0);
@@ -504,18 +530,18 @@ if (require.main === module) {
 				bytes: bytesHuman(bytes || 0),
 			};
 			if (bytes > 0) console.table(stats);
-			console.log(`\nfiles written to ${folder}...`);
-			console.log("\t" + files.flat().join("\n\t"));
-			console.log(`\n------------------SUMMARY------------------\n\n\n`);
+			log(`\nfiles written to ${folder}...`);
+			log("\t" + files?.flat().join("\n\t"));
+			log(`\n------------------SUMMARY------------------\n\n\n`);
 		})
 		.catch((e) => {
-			console.log(`------------------ERROR------------------`);
+			log(`------------------ERROR------------------`);
 			console.error(e);
-			console.log(`------------------ERROR------------------`);
+			log(`------------------ERROR------------------`);
 			debugger;
 		})
 		.finally(() => {
-			console.log("have a wonderful day :)");
+			log("have a wonderful day :)");
 			openFinder(path.resolve("./data"));
 		});
 } else {
@@ -535,3 +561,8 @@ if (require.main === module) {
 		openFinder,
 	};
 }
+
+
+function log(...args) {
+	if (VERBOSE) console.log(...args);
+}

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "make-mp-data",
-  "version": "1.0.17",
+  "version": "1.1.0",
   "description": "builds all mixpanel primitives for a given project",
   "main": "index.js",
   "types": "types.d.ts",
   "scripts": {
     "start": "node index.js",
     "prune": "rm ./data/*",
-	"go": "sh ./go.sh",
-	"post": "npm publish",
-	"test": "jest"
+    "go": "sh ./scripts/go.sh",
+    "post": "npm publish",
+    "test": "jest",
+    "deps": "sh ./scripts/deps.sh"
   },
   "repository": {
     "type": "git",
@@ -25,10 +26,10 @@
     "tracking",
     "server",
     "CLI",
-	"datamart",
-	"scd 2",
-	"dummy data",
-	"fake data"
+    "datamart",
+    "scd 2",
+    "dummy data",
+    "fake data"
   ],
   "author": "ak@mixpanel.com",
   "license": "ISC",
@@ -37,10 +38,10 @@
   },
   "homepage": "https://github.com/ak--47/make-mp-data#readme",
   "dependencies": {
-    "ak-tools": "^1.0.51",
+    "ak-tools": "^1.0.52",
     "chance": "^1.1.7",
     "dayjs": "^1.11.10",
-    "mixpanel-import": "^2.5.33",
+    "mixpanel-import": "^2.5.5",
     "yargs": "^17.7.2"
   }
 }

package/scripts/deps.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+npm i mixpanel-import@latest --save
+npm i ak-tools@latest --save

package/scripts/go.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+RUNTIME=local node --inspect index.js --writeToDisk false -u 100 -e 10000

package/types.d.ts

@@ -1,5 +1,7 @@
 // types.d.ts
-import { Chance } from "chance";
+
+type primitives = string | number | boolean | Date | Object;
+type valueValid = primitives | primitives[] | (() => primitives | primitives[]);
 
 export interface Config {
   token?: string;
@@ -10,44 +12,34 @@ export interface Config {
   format?: "csv" | "json";
   region?: string;
   events?: EventConfig[];
-  superProps?: Record<string, string[]>; // Flexible for any string keys
-  userProps?: Record<string, any>; // Could be more specific based on actual usage
-  scdProps?: {
-    plan?: string[];
-    MRR?: number;
-    NPS?: number;
-    marketingOptIn?: boolean[];
-    dateOfRenewal?: Date;
-  };
+  superProps?: Record<string, valueValid>; 
+  userProps?: Record<string, valueValid>; 
+  scdProps?: Record<string, valueValid>;
   groupKeys?: [string, number][];
   groupProps?: Record<string, GroupProperty>; // Adjust according to usage
   lookupTables?: LookupTable[];
   writeToDisk?: boolean;
+  simulationName?: string;
+  verbose?: boolean;
 }
 
 interface EventConfig {
   event?: string;
   weight?: number;
   properties?: {
-    [key: string]: any; // Consider refining based on actual properties used
+    [key: string]: valueValid; // Consider refining based on actual properties used
   };
   isFirstEvent?: boolean;
 }
 
 interface GroupProperty {
-  [key?: string]: any;
+  [key?: string]: valueValid;
 }
 
 interface LookupTable {
-  key?: string;
-  entries?: number;
-  attributes?: {
-    category?: string[];
-    demand?: string[];
-    supply?: string[];
-    manufacturer?: () => string;
-    price?: number;
-    rating?: number;
-    reviews?: number;
+  key: string;
+  entries: number;
+  attributes: {
+    [key?: string]: valueValid;
   };
 }

package/utils.js

@@ -1,7 +1,7 @@
 const Chance = require('chance');
 const chance = new Chance();
 const readline = require('readline');
-const { comma } = require('ak-tools');
+const { comma, uid } = require('ak-tools');
 const { spawn } = require('child_process');
 const dayjs = require('dayjs');
 const utc = require('dayjs/plugin/utc');
@@ -111,6 +111,30 @@ function integer(min, max) {
 	return 0;
 }
 
+function makeHashTags() {
+	const popularHashtags = [
+		'#GalacticAdventures',
+		'#EnchantedExplorations',
+		'#MagicalMoments',
+		'#EpicQuests',
+		'#WonderfulWorlds',
+		'#FantasyFrenzy',
+		'#MysticalMayhem',
+		'#MythicalMarvels',
+		'#LegendaryLegends',
+		'#DreamlandDiaries',
+		'#WhimsicalWonders',
+		'#FabledFables'
+	];
+
+	const numHashtags = integer(integer(1, 5), integer(5, 10));
+	const hashtags = [];
+	for (let i = 0; i < numHashtags; i++) {
+		hashtags.push(chance.pickone(popularHashtags));
+	}
+	return hashtags;
+}
+
 function makeProducts() {
 	let categories = ["Device Accessories", "eBooks", "Automotive", "Baby Products", "Beauty", "Books", "Camera & Photo", "Cell Phones & Accessories", "Collectible Coins", "Consumer Electronics", "Entertainment Collectibles", "Fine Art", "Grocery & Gourmet Food", "Health & Personal Care", "Home & Garden", "Independent Design", "Industrial & Scientific", "Accessories", "Major Appliances", "Music", "Musical Instruments", "Office Products", "Outdoors", "Personal Computers", "Pet Supplies", "Software", "Sports", "Sports Collectibles", "Tools & Home Improvement", "Toys & Games", "Video, DVD & Blu-ray", "Video Games", "Watches"];
 	let slugs = ['/sale/', '/featured/', '/home/', '/search/', '/wishlist/', '/'];
@@ -207,12 +231,18 @@ function person(bornDaysAgo = 30) {
 	const avPath = gender === 'male' ? `/men/${randomAvatarNumber}.jpg` : `/women/${randomAvatarNumber}.jpg`;
 	const $avatar = avatarPrefix + avPath;
 	const $created = date(bornDaysAgo, true, null)();
+	const anonymousIds = [];
+	const clusterSize = integer(2, 10);
+	for (let i = 0; i < clusterSize; i++) {
+		anonymousIds.push(uid(42));
+	}
 
 	return {
 		$name,
 		$email,
 		$avatar,
-		$created
+		$created,
+		anonymousIds
 	};
 }
 
@@ -255,9 +285,77 @@ function generateEmoji(max = 10, array = false) {
 		}
 		if (array) return arr;
 		if (!array) return arr.join(', ');
+		return "🤷";
 	};
 }
 
+function generateName() {
+	var adjs = [
+		"autumn", "hidden", "bitter", "misty", "silent", "empty", "dry", "dark",
+		"summer", "icy", "delicate", "quiet", "white", "cool", "spring", "winter",
+		"patient", "twilight", "dawn", "crimson", "wispy", "weathered", "blue",
+		"billowing", "broken", "cold", "damp", "falling", "frosty", "green",
+		"long", "late", "lingering", "bold", "little", "morning", "muddy", "old",
+		"red", "rough", "still", "small", "sparkling", "throbbing", "shy",
+		"wandering", "withered", "wild", "black", "young", "holy", "solitary",
+		"fragrant", "aged", "snowy", "proud", "floral", "restless", "divine",
+		"polished", "ancient", "purple", "lively", "nameless", "gentle", "gleaming", "furious", "luminous", "obscure", "poised", "shimmering", "swirling",
+		"sombre", "steamy", "whispering", "jagged", "melodic", "moonlit", "starry", "forgotten",
+		"peaceful", "restive", "rustling", "sacred", "ancient", "haunting", "solitary", "mysterious",
+		"silver", "dusky", "earthy", "golden", "hallowed", "misty", "roaring", "serene", "vibrant",
+		"stalwart", "whimsical", "timid", "tranquil", "vast", "youthful", "zephyr", "raging",
+		"sapphire", "turbulent", "whirling", "sleepy", "ethereal", "tender", "unseen", "wistful"
+	];
+
+	var nouns = [
+		"waterfall", "river", "breeze", "moon", "rain", "wind", "sea", "morning",
+		"snow", "lake", "sunset", "pine", "shadow", "leaf", "dawn", "glitter",
+		"forest", "hill", "cloud", "meadow", "sun", "glade", "bird", "brook",
+		"butterfly", "bush", "dew", "dust", "field", "fire", "flower", "firefly",
+		"feather", "grass", "haze", "mountain", "night", "pond", "darkness",
+		"snowflake", "silence", "sound", "sky", "shape", "surf", "thunder",
+		"violet", "water", "wildflower", "wave", "water", "resonance", "sun",
+		"wood", "dream", "cherry", "tree", "fog", "frost", "voice", "paper",
+		"frog", "smoke", "star", "glow", "wave", "riverbed", "cliff", "deluge", "prairie", "creek", "ocean",
+		"peak", "valley", "starlight", "quartz", "woodland", "marsh", "earth", "canopy",
+		"petal", "stone", "orb", "gale", "bay", "canyon", "watercourse", "vista", "raindrop",
+		"boulder", "grove", "plateau", "sand", "mist", "tide", "blossom", "leaf", "flame",
+		"shade", "coil", "grotto", "pinnacle", "scallop", "serenity", "abyss", "skyline",
+		"drift", "echo", "nebula", "horizon", "crest", "wreath", "twilight", "balm", "glimmer"
+	];
+
+	var verbs = [
+		"dancing", "whispering", "flowing", "shimmering", "swirling", "echoing", "sparkling", "glistening",
+		"cascading", "drifting", "glowing", "rippling", "quivering", "singing", "twinkling", "radiating",
+		"enveloping", "enchanting", "captivating", "embracing", "embracing", "illuminating", "pulsating", "gliding",
+		"soaring", "wandering", "meandering", "dazzling", "cuddling", "embracing", "caressing", "twisting",
+		"twirling", "tumbling", "surging", "glimmering", "gushing", "splashing", "rolling", "splintering",
+		"splintering", "crescendoing", "whirling", "bursting", "shining", "gushing", "emerging", "revealing",
+		"emerging", "unfolding", "unveiling", "emerging", "surrounding", "unveiling", "materializing", "revealing"
+	];
+	
+	var adverbs = [
+		"gracefully", "softly", "smoothly", "gently", "tenderly", "quietly", "serenely", "peacefully",
+		"delicately", "effortlessly", "subtly", "tranquilly", "majestically", "silently", "calmly", "harmoniously",
+		"elegantly", "luminously", "ethereally", "mysteriously", "sublimely", "radiantly", "dreamily", "ethereally",
+		"mesmerizingly", "hypnotically", "mystically", "enigmatically", "spellbindingly", "enchantingly", "fascinatingly",
+		"bewitchingly", "captivatingly", "entrancingly", "alluringly", "rapturously", "seductively", "charismatically",
+		"seductively", "envelopingly", "ensnaringly", "entrancingly", "intoxicatingly", "irresistibly", "transcendentally",
+		"envelopingly", "rapturously", "intimately", "intensely", "tangibly", "vividly", "intensely", "deeply"
+	];
+	
+
+	// ? http://stackoverflow.com/a/17516862/103058
+	var adj = adjs[Math.floor(Math.random() * adjs.length)]; 
+	var noun = nouns[Math.floor(Math.random() * nouns.length)];
+	var verb = verbs[Math.floor(Math.random() * verbs.length)];
+	var adverb = adverbs[Math.floor(Math.random() * adverbs.length)];
+	
+	
+	return adj + '-' + noun + '-' + verb + '-' + adverb
+
+}
+
 module.exports = {
 	weightedRange,
 	pick,
@@ -274,5 +372,7 @@ module.exports = {
 	applySkew,
 	boxMullerRandom,
 	generateEmoji,
-	getUniqueKeys
+	getUniqueKeys,
+	makeHashTags,
+	generateName,
 };