lytx 0.3.0

package/lib/random_name.ts

@@ -0,0 +1,41 @@
+/**
+ * Generates a random name by combining an adjective and a noun with a hyphen
+ * @returns A string in the format "adjective-noun"
+ */
+export function randomName() {
+  const adjectives: string[] = [
+    'agile', 'atomic', 'awesome', 'blazing', 'bold', 'brave', 'bright', 'brilliant', 'busy',
+    'clever', 'cosmic', 'crisp', 'curious', 'dapper', 'dazzling', 'dynamic', 'eager', 'elegant',
+    'epic', 'fancy', 'fast', 'fluent', 'flying', 'friendly', 'fuzzy', 'gentle', 'glowing',
+    'happy', 'harmonic', 'hidden', 'hyper', 'iconic', 'infinite', 'jolly', 'keen', 'logical',
+    'magical', 'mighty', 'mini', 'modern', 'nimble', 'noble', 'novel', 'optimal', 'parallel',
+    'peaceful', 'perfect', 'prime', 'quantum', 'quick', 'quiet', 'rapid', 'reactive', 'resilient',
+    'robust', 'rustic', 'sacred', 'secure', 'sharp', 'shiny', 'silent', 'sleek', 'smooth',
+    'solid', 'speedy', 'stellar', 'super', 'swift', 'tidy', 'tiny', 'turbo', 'vibrant',
+    'vigilant', 'virtual', 'vivid', 'wild', 'wise', 'witty', 'wonderful', 'zealous'
+  ];
+
+  const nouns: string[] = [
+    'algorithm', 'api', 'app', 'array', 'atom', 'badge', 'bash', 'bit', 'block', 'bot', 'byte',
+    'cache', 'cat', 'chip', 'cli', 'cloud', 'code', 'commit', 'compiler', 'component', 'cookie',
+    'core', 'crab', 'dashboard', 'data', 'db', 'dev', 'docker', 'docs', 'dom', 'dragon', 'edge',
+    'element', 'falcon', 'feature', 'ferret', 'file', 'flow', 'flux', 'fox', 'framework', 'function',
+    'gator', 'gem', 'git', 'graph', 'grid', 'hawk', 'heap', 'hook', 'hub', 'image', 'index',
+    'iterator', 'jam', 'java', 'json', 'key', 'lab', 'lambda', 'leaf', 'lib', 'link', 'lint',
+    'lion', 'list', 'logic', 'loop', 'lynx', 'map', 'matrix', 'mesh', 'method', 'micro', 'module',
+    'monkey', 'net', 'node', 'object', 'octo', 'otter', 'package', 'panda', 'parser', 'path',
+    'pattern', 'phoenix', 'pixel', 'plugin', 'pod', 'pointer', 'pony', 'portal', 'proxy', 'puma',
+    'python', 'query', 'queue', 'rabbit', 'raccoon', 'react', 'repo', 'request', 'response',
+    'router', 'ruby', 'script', 'server', 'service', 'shell', 'sloth', 'snake', 'socket', 'spark',
+    'spec', 'sql', 'stack', 'state', 'static', 'stream', 'string', 'struct', 'style', 'syntax',
+    'system', 'table', 'tag', 'task', 'template', 'tiger', 'token', 'tool', 'tree', 'type',
+    'ui', 'util', 'vector', 'view', 'vm', 'web', 'widget', 'wolf', 'worker', 'yaml', 'zebra'
+  ];
+
+  // Get random index for adjective and noun
+  const randomAdjectiveIndex = Math.floor(Math.random() * adjectives.length);
+  const randomNounIndex = Math.floor(Math.random() * nouns.length);
+
+  // Combine the randomly selected adjective and noun with a hyphen
+  return `${adjectives[randomAdjectiveIndex]}-${nouns[randomNounIndex]}`;
+}

package/lib/sendMail.ts

@@ -0,0 +1,252 @@
+"use server";
+
+import { env } from "cloudflare:workers";
+import { IS_DEV } from "rwsdk/constants";
+
+const DEFAULT_EMAIL_FROM_PLACEHOLDER = "noreply@example.com";
+let email_from_override: string | undefined;
+
+export function setEmailFromAddress(value?: string) {
+	email_from_override = value?.trim() || undefined;
+}
+
+function getFromAddress(): string {
+	const from = email_from_override ?? env.EMAIL_FROM ?? DEFAULT_EMAIL_FROM_PLACEHOLDER;
+	const normalized = from.trim();
+
+	if (!normalized || normalized.toLowerCase() === DEFAULT_EMAIL_FROM_PLACEHOLDER) {
+		throw new Error(
+			"EMAIL_FROM is not configured. Set EMAIL_FROM in your environment bindings or pass createLytxApp({ env: { EMAIL_FROM: \"noreply@yourdomain.com\" } }).",
+		);
+	}
+
+	return normalized;
+}
+
+interface SendEmailOptions {
+	from: string;
+	to: string | string[];
+	subject: string;
+	html?: string;
+	text?: string;
+	bcc?: string | string[];
+	cc?: string | string[];
+	reply_to?: string | string[];
+	headers?: Record<string, string>;
+	tags?: Array<{ name: string; value: string }>;
+}
+
+function normalizeRecipients(value: string | string[]): string[] {
+	return Array.isArray(value) ? value : [value];
+}
+
+function redactRecipient(value: string): string {
+	const [local, domain] = value.split("@");
+	if (!domain) return "invalid-recipient";
+	const local_prefix = local?.slice(0, 2) ?? "";
+	return `${local_prefix}***@${domain}`;
+}
+
+function logEmailDebug(event: string, details: Record<string, unknown>) {
+	if (!IS_DEV) return;
+	console.log("[email][dev]", event, details);
+}
+
+async function sendEmail(options: SendEmailOptions) {
+	logEmailDebug("attempt", {
+		from: options.from,
+		to: normalizeRecipients(options.to).map(redactRecipient),
+		subject: options.subject,
+		hasResendApiKey: Boolean(env.RESEND_API_KEY),
+	});
+
+	const response = await fetch("https://api.resend.com/emails", {
+		method: "POST",
+		headers: {
+			Authorization: `Bearer ${env.RESEND_API_KEY}`,
+			"Content-Type": "application/json",
+		},
+		body: JSON.stringify(options),
+	});
+
+	if (!response.ok) {
+		const error = await response.text();
+		logEmailDebug("failed", {
+			status: response.status,
+			error,
+		});
+		throw new Error(`Resend API error: ${response.status} - ${error}`);
+	}
+
+	const data = await response.json();
+	logEmailDebug("sent", {
+		status: response.status,
+		response: data,
+	});
+
+	return data;
+}
+
+interface EmailTemplateOptions {
+	title: string;
+	message: string;
+	buttonLabel: string;
+	buttonUrl: string;
+	footerNote: string;
+}
+
+function buildEmailTemplate({
+	title,
+	message,
+	buttonLabel,
+	buttonUrl,
+	footerNote,
+}: EmailTemplateOptions) {
+	return `
+		<!doctype html>
+		<html>
+			<head>
+				<meta charset="utf-8" />
+				<meta name="viewport" content="width=device-width, initial-scale=1" />
+				<title>${title}</title>
+				<style>
+					@media only screen and (max-width: 600px) {
+						.email-card {
+							border-radius: 10px !important;
+						}
+						.email-pad {
+							padding-left: 20px !important;
+							padding-right: 20px !important;
+						}
+						.email-title {
+							font-size: 22px !important;
+						}
+						.email-body {
+							font-size: 16px !important;
+						}
+						.email-button {
+							font-size: 15px !important;
+							padding: 12px 18px !important;
+						}
+						.email-footnote {
+							font-size: 13px !important;
+						}
+					}
+				</style>
+			</head>
+			<body style="margin:0;padding:0;background-color:#3c3c3c;">
+				<table role="presentation" cellpadding="0" cellspacing="0" width="100%" style="background-color:#3c3c3c;">
+					<tr>
+						<td align="center" style="padding:32px 16px;">
+							<table role="presentation" cellpadding="0" cellspacing="0" width="100%" class="email-card" style="max-width:560px;width:100%;background-color:#484743;border:1px solid #575353;border-radius:12px;overflow:hidden;">
+								<tr>
+									<td class="email-pad" style="padding:20px 28px 0 28px;">
+										<div style="font-family:'Space Grotesk','Avenir Next','Trebuchet MS',sans-serif;font-size:12px;letter-spacing:0.2em;text-transform:uppercase;color:#d1d5db;">LYTX</div>
+									</td>
+								</tr>
+								<tr>
+									<td class="email-pad" style="padding:8px 28px 8px 28px;">
+										<h1 class="email-title" style="margin:0;font-family:'Space Grotesk','Avenir Next','Trebuchet MS',sans-serif;font-size:24px;line-height:1.3;color:#ffffff;">${title}</h1>
+									</td>
+								</tr>
+								<tr>
+									<td class="email-pad" style="padding:0 28px 20px 28px;">
+										<p class="email-body" style="margin:0;font-family:'Space Grotesk','Avenir Next','Trebuchet MS',sans-serif;font-size:16px;line-height:1.6;color:#e5e7eb;">${message}</p>
+									</td>
+								</tr>
+								<tr>
+									<td class="email-pad" align="left" style="padding:0 28px 24px 28px;">
+										<a href="${buttonUrl}" class="email-button" style="display:inline-block;font-family:'Space Grotesk','Avenir Next','Trebuchet MS',sans-serif;font-size:15px;letter-spacing:0.02em;text-decoration:none;background-color:#6b7280;color:#ffffff;padding:12px 20px;border-radius:8px;">${buttonLabel}</a>
+									</td>
+								</tr>
+								<tr>
+									<td class="email-pad" style="padding:0 28px 20px 28px;">
+										<p class="email-footnote" style="margin:0;font-family:'Space Grotesk','Avenir Next','Trebuchet MS',sans-serif;font-size:13px;line-height:1.6;color:#9ca3af;">${footerNote}</p>
+									</td>
+								</tr>
+								<tr>
+									<td class="email-pad" style="padding:0 28px 28px 28px;">
+										<p class="email-footnote" style="margin:0;font-family:'Space Grotesk','Avenir Next','Trebuchet MS',sans-serif;font-size:13px;line-height:1.6;color:#9ca3af;">If the button does not work, paste this link into your browser:</p>
+										<p class="email-footnote" style="margin:6px 0 0 0;font-family:'Space Grotesk','Avenir Next','Trebuchet MS',sans-serif;font-size:13px;line-height:1.6;color:#e5e7eb;word-break:break-word;overflow-wrap:anywhere;">${buttonUrl}</p>
+									</td>
+								</tr>
+							</table>
+						</td>
+					</tr>
+				</table>
+			</body>
+		</html>
+	`;
+}
+
+function buildEmailText({
+	title,
+	message,
+	buttonLabel,
+	buttonUrl,
+	footerNote,
+}: EmailTemplateOptions) {
+	return [
+		title,
+		"",
+		message,
+		"",
+		`${buttonLabel}: ${buttonUrl}`,
+		"",
+		footerNote,
+	].join("\n");
+}
+
+export async function sendTeamInviteEmail(email: string, link: string) {
+	const template = {
+		title: "Join your Lytx team",
+		message: "You have been invited to join a Lytx team. Accept the invite to access shared dashboards and insights.",
+		buttonLabel: "Accept invitation",
+		buttonUrl: link,
+		footerNote: "If you were not expecting this invitation, you can safely ignore this email.",
+	};
+
+	return sendEmail({
+		from: getFromAddress(),
+		to: email,
+		subject: "You've been invited to join a Lytx team",
+		html: buildEmailTemplate(template),
+		text: buildEmailText(template),
+	});
+}
+
+export async function newAccountInviteEmail(email: string, link: string) {
+	const template = {
+		title: "Create your Lytx account",
+		message: "You have been invited to join a Lytx team. Create your account to get started with your new workspace.",
+		buttonLabel: "Create account",
+		buttonUrl: link,
+		footerNote: "If you were not expecting this invitation, you can safely ignore this email.",
+	};
+
+	return sendEmail({
+		from: getFromAddress(),
+		to: email,
+		subject: "You've been invited to join a Lytx team",
+		html: buildEmailTemplate(template),
+		text: buildEmailText(template),
+	});
+}
+
+export async function sendVerificationEmail(email: string, link: string) {
+	const template = {
+		title: "Verify your email",
+		message: "Welcome to Lytx. Confirm your email to finish setting up your account and access your dashboard.",
+		buttonLabel: "Verify email",
+		buttonUrl: link,
+		footerNote: "If you did not create a Lytx account, you can ignore this email.",
+	};
+
+	return sendEmail({
+		from: getFromAddress(),
+		to: email,
+		subject: "Verify your Lytx account",
+		html: buildEmailTemplate(template),
+		text: buildEmailText(template),
+	});
+}

package/package.json

@@ -0,0 +1,142 @@
+{
+  "name": "lytx",
+  "version": "0.3.0",
+  "private": false,
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "./index.d.ts",
+  "main": "index.ts",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lytx-io/lytx.git",
+    "directory": "core"
+  },
+  "homepage": "https://github.com/lytx-io/lytx#readme",
+  "bugs": {
+    "url": "https://github.com/lytx-io/lytx/issues"
+  },
+  "keywords": [
+    "analytics",
+    "cloudflare",
+    "redwoodsdk",
+    "web-analytics"
+  ],
+  "files": [
+    "src/",
+    "lib/",
+    "db/",
+    "cli/",
+    "endpoints/",
+    "public/",
+    "types/",
+    "vite/",
+    "index.ts",
+    "README.md",
+    "tsconfig.json",
+    "vite.config.ts",
+    "alchemy.run.ts",
+    ".env.example",
+    "worker-configuration.d.ts",
+    "index.d.ts"
+  ],
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.ts",
+      "default": "./index.ts"
+    },
+    "./worker": {
+      "types": "./src/worker.tsx",
+      "import": "./src/worker.tsx",
+      "default": "./src/worker.tsx"
+    },
+    "./db/durable/siteDurableObject": {
+      "types": "./db/durable/siteDurableObject.ts",
+      "import": "./db/durable/siteDurableObject.ts",
+      "default": "./db/durable/siteDurableObject.ts"
+    },
+    "./resource-names": {
+      "types": "./src/config/resourceNames.ts",
+      "import": "./src/config/resourceNames.ts",
+      "default": "./src/config/resourceNames.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "lytx-setup": "./cli/setup.js"
+  },
+  "scripts": {
+    "dev": "bun alchemy dev --stage dev",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint . --fix",
+    "build": "bun run vite build",
+    "clean": "rm -rf node_modules/.vite .vite",
+    "db_analytics:migrate": "bunx drizzle-kit generate --config=db/postgres/drizzle.config.ts",
+    "db:generate": "bunx drizzle-kit generate --config=db/d1/drizzle.config.ts",
+    "db:studio": "bunx drizzle-kit studio --config=db/d1/drizzle.config.ts",
+    "import-sites": "bun run cli/import-sites.ts",
+    "import-events": "bun run cli/import-events.ts",
+    "bootstrap-admin": "bun run cli/bootstrap-admin.ts",
+    "setup": "bun run cli/setup.ts",
+    "deploy": "bun alchemy deploy --env-file .env.prod --stage prod"
+  },
+  "devDependencies": {
+    "@cloudflare/vite-plugin": "^1.13.10",
+    "@tailwindcss/vite": "^4.1.8",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/bun": "^1.2.21",
+    "@types/mustache": "^4.2.2",
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.1.7",
+    "@types/react-dom": "^19.1.6",
+    "@vitejs/plugin-react": "^5.1.2",
+    "babel-plugin-react-compiler": "^1.0.0",
+    "blinkx.io-sveltekit": "^1.0.10",
+    "dotenv": "^17.2.1",
+    "drizzle-kit": "^0.31.8",
+    "oxlint": "^1.48.0",
+    "tailwindcss": "^4.1.8",
+    "typescript": "^5.3.2",
+    "wrangler": "^4.59.3"
+  },
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "^2.0.26",
+    "@ai-sdk/react": "^3.0.70",
+    "@fontsource/montserrat": "^5.2.8",
+    "@hono/swagger-ui": "^0.5.3",
+    "@hono/zod-openapi": "^1.2.1",
+    "@hono/zod-validator": "^0.7.6",
+    "@nivo/bar": "^0.99.0",
+    "@nivo/core": "^0.99.0",
+    "@nivo/funnel": "^0.99.0",
+    "@nivo/line": "^0.99.0",
+    "@nivo/pie": "^0.99.0",
+    "@nivo/sankey": "^0.99.0",
+    "@paralleldrive/cuid2": "^2.2.2",
+    "@tanstack/react-query": "^5.90.2",
+    "@tanstack/react-table": "^8.21.3",
+    "ai": "^6.0.68",
+    "alchemy": "^0.84.0",
+    "better-auth": "^1.2.9",
+    "better-sqlite3": "^11.10.0",
+    "country-flag-icons": "^1.6.12",
+    "device-detector-js": "^3.0.3",
+    "drizzle-orm": "^0.44.7",
+    "esbuild": "^0.27.2",
+    "hono": "^4.11.7",
+    "modern-monaco": "^0.3.7",
+    "mustache": "^4.2.0",
+    "postgres": "^3.4.3",
+    "prism-react-renderer": "^2.4.1",
+    "react": "^19.3.0-canary-4fdf7cf2-20251003",
+    "react-dom": "^19.3.0-canary-4fdf7cf2-20251003",
+    "react-server-dom-webpack": "^19.3.0-canary-4fdf7cf2-20251003",
+    "react-simple-maps": "^3.0.0",
+    "rwsdk": "1.0.0-beta.49",
+    "vite": "^7.3.1",
+    "zod": "^4.3.6"
+  }
+}