make-mp-data 1.5.0 → 1.5.2

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,37 +4,72 @@
 	// 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": "run dungeon",
+            "runtimeExecutable": "nodemon",
+            "runtimeArgs": ["--inspect"],
+            "program": "${workspaceFolder}/index.js",
+			"args": ["--ignore", "./data/*", "${file}"],
+            "restart": true,
+            "console": "integratedTerminal",
+            "internalConsoleOptions": "neverOpen",
+            "skipFiles": ["<node_internals>/**"],
+			"preLaunchTask": "npm: prune",
+        },
 		{
 			"type": "node",
 			"request": "launch",
-			"name": "go",
+			"name": "current file",
 			"runtimeExecutable": "nodemon",
 			"program": "${file}",
 			"restart": true,
 			"console": "integratedTerminal",
 			"internalConsoleOptions": "neverOpen",
-			"args": [
-				"--ignore",
-				"./data/*"
-			]
-		}
+			"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",
+            "name": "sanity",
+            "runtimeExecutable": "nodemon",
+            "runtimeArgs": ["--inspect"],
+            "program": "${workspaceFolder}/index.js",
+			"args": ["--ignore", "./data/*", "./schemas/sanity.js"],
+            "restart": true,
+            "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/{src → 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/{src → 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',
@@ -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

@@ -0,0 +1,166 @@
+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.
+ *
+ * @param {Object} params - Parameters for the function.
+ * @param {string} [params.oauth=""] - OAuth token for authentication.
+ * @param {string} [params.orgId=""] - Organization ID.
+ * @param {Array<Object>} [params.groups=[]] - List of groups to add to the project.
+ * @param {string} [params.name=""] - Name of the user.
+ * @param {string} [params.email=""] - Email of the user.
+ * @param {string} [params.projectName=""] - Name of the project.
+ * @returns {Promise<Object>} The created project with additional group keys.
+ * @throws Will throw an error if OAUTH_TOKEN is not set.
+ * @throws Will throw an error if orgId is not found.
+ */
+async function main(params = {}) {
+	let { oauth = "", orgId = "", groups = [], name = "", email = "", projectName } = params;
+	if (oauth) OAUTH_TOKEN = oauth;
+	if (!OAUTH_TOKEN) throw new Error('No OAUTH_TOKEN in .env');
+	if (!orgId) {
+		({ orgId, name, email } = await getUser());
+	}
+	if (!orgId) throw new Error('No orgId found');
+	if (!projectName) projectName = makeName();
+	const project = await makeProject(orgId);
+	project.user = name;
+	project.email = email;
+	project.groups = groups;
+	project.orgId = orgId;
+	const groupKeys = [
+		// { display_name: 'Account', property_name: 'account_id' },
+	];
+	groupKeys.push(...groups);
+	const addedGroupKeys = await addGroupKeys(groupKeys, project.id);
+	project.groupsAdded = addedGroupKeys;
+
+	return project;
+}
+
+
+async function makeProject(orgId, oauthToken = OAUTH_TOKEN) {
+	const excludedOrgs = [
+		1, // Mixpanel
+		328203, // Mixpanel Demo
+		1673847, // SE Demo
+		1866253 // Demo Projects
+	];
+	if (!orgId || !oauthToken) throw new Error('Missing orgId or oauthToken');
+	const url = `https://mixpanel.com/api/app/organizations/${orgId}/create-project`;
+	const projectPayload = {
+		"cluster_id": 1,
+		"project_name": `GTM Metrics: Test Env ${rand(1000, 9999)}`,
+		"timezone_id": 404
+	};
+
+	const payload = {
+		method: 'POST',
+
+		headers: {
+			Authorization: `Bearer ${oauthToken}`,
+		},
+		body: JSON.stringify(projectPayload)
+
+	};
+
+	const projectsReq = await fetch(url, payload);
+	const projectsRes = await projectsReq.json();
+	const { api_secret, id, name, token } = projectsRes.results;
+
+	const data = {
+		api_secret,
+		id,
+		name,
+		token,
+		url: `https://mixpanel.com/project/${id}/app/settings#project/${id}`
+
+	};
+
+	return data;
+}
+
+async function getUser(oauthToken = OAUTH_TOKEN) {
+	const user = {};
+	try {
+		if (oauthToken) {
+			const info = await fetch(`https://mixpanel.com/api/app/me/?include_workspace_users=false`, { headers: { Authorization: `Bearer ${oauthToken}` } });
+			const data = await info.json();
+			if (data?.results) {
+				const { user_name = "", user_email = "" } = data.results;
+				if (user_name) user.name = user_name;
+				if (user_email) user.email = user_email;
+				const foundOrg = Object.values(data.results.organizations).filter(o => o.name.includes(user_name))?.pop();
+				if (foundOrg) {
+					user.orgId = foundOrg.id?.toString();
+					user.orgName = foundOrg.name;
+				}
+				if (!foundOrg) {
+					// the name is not in the orgs, so we need to find the org in which the user is the owner
+					const ignoreProjects = [1673847, 1866253, 328203];
+					const possibleOrg = Object.values(data.results.organizations)
+						.filter(o => o.role === 'owner')
+						.filter(o => !ignoreProjects.includes(o.id))?.pop();
+					if (possibleOrg) {
+						user.orgId = possibleOrg?.id?.toString();
+						user.orgName = possibleOrg.name;
+					}
+				}
+			}
+		}
+	}
+	catch (err) {
+		console.error('get user err', err);
+	}
+
+	return user;
+}
+
+
+async function addGroupKeys(groupKeyDfns = [], projectId, oauthToken = OAUTH_TOKEN) {
+	const url = `https://mixpanel.com/api/app/projects/${projectId}/data-groups/`;
+	const results = [];
+	loopKeys: for (const { display_name, property_name } of groupKeyDfns) {
+		const body = {
+			display_name,
+			property_name
+		};
+		const payload = {
+			method: 'POST',
+			headers: {
+				Authorization: `Bearer ${oauthToken}`,
+				'Content-Type': 'application/json'
+			},
+			body: JSON.stringify(body)
+		};
+
+		try {
+			const res = await fetch(url, payload);
+			const data = await res.json();
+			results.push(data?.results);
+		}
+		catch (err) {
+			console.error('add group keys err', err);
+			continue loopKeys;
+		}
+
+	}
+	return results;
+}
+
+
+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