@getjack/jack 0.1.32 → 0.1.34

package/templates/nextjs-shadcn/package.json

@@ -0,0 +1,55 @@
+{
+	"name": "jack-template",
+	"type": "module",
+	"private": true,
+	"scripts": {
+		"dev": "next dev",
+		"build": "next build",
+		"preview": "opennextjs-cloudflare build && opennextjs-cloudflare preview",
+		"deploy": "opennextjs-cloudflare build && opennextjs-cloudflare deploy",
+		"cf-typegen": "wrangler types --env-interface CloudflareEnv cloudflare-env.d.ts"
+	},
+	"dependencies": {
+		"@base-ui/react": "^1.1.0",
+		"@dnd-kit/core": "^6.3.1",
+		"@dnd-kit/modifiers": "^9.0.0",
+		"@dnd-kit/sortable": "^10.0.0",
+		"@dnd-kit/utilities": "^3.2.2",
+		"@hookform/resolvers": "^5.2.2",
+		"@opennextjs/cloudflare": "^1.0.0",
+		"@tabler/icons-react": "^3.36.1",
+		"@tailwindcss/postcss": "^4.1.18",
+		"@tanstack/react-table": "^8.21.3",
+		"class-variance-authority": "^0.7.1",
+		"clsx": "^2.1.1",
+		"cmdk": "^1.1.1",
+		"date-fns": "^4.1.0",
+		"embla-carousel-react": "^8.6.0",
+		"geist": "^1.7.0",
+		"input-otp": "^1.4.2",
+		"lucide-react": "^0.563.0",
+		"next": "^15.0.0",
+		"next-themes": "^0.4.6",
+		"postcss": "^8.5.6",
+		"radix-ui": "^1.4.3",
+		"react": "^19.0.0",
+		"react-day-picker": "^9.13.2",
+		"react-dom": "^19.0.0",
+		"react-hook-form": "^7.71.1",
+		"react-resizable-panels": "^4",
+		"recharts": "2.15.4",
+		"sonner": "^2.0.7",
+		"tailwind-merge": "^3.4.0",
+		"tailwindcss": "^4.1.18",
+		"vaul": "^1.1.2",
+		"zod": "^4.3.6"
+	},
+	"devDependencies": {
+		"@cloudflare/workers-types": "^4.20241205.0",
+		"@types/react": "^19.0.0",
+		"@types/react-dom": "^19.0.0",
+		"shadcn": "^3.8.4",
+		"tw-animate-css": "^1.4.0",
+		"typescript": "^5.6.0"
+	}
+}

package/templates/nextjs-shadcn/postcss.config.mjs

@@ -0,0 +1,8 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+	plugins: {
+		"@tailwindcss/postcss": {},
+	},
+};
+
+export default config;

package/templates/nextjs-shadcn/tsconfig.json

@@ -0,0 +1,28 @@
+{
+	"compilerOptions": {
+		"target": "ES2022",
+		"lib": ["ES2022", "DOM", "DOM.Iterable"],
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"jsx": "preserve",
+		"strict": true,
+		"skipLibCheck": true,
+		"noEmit": true,
+		"incremental": true,
+		"esModuleInterop": true,
+		"resolveJsonModule": true,
+		"isolatedModules": true,
+		"paths": {
+			"@/*": ["./*"]
+		},
+		"plugins": [
+			{
+				"name": "next"
+			}
+		],
+		"types": ["@cloudflare/workers-types"],
+		"allowJs": true
+	},
+	"include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", "cloudflare-env.d.ts"],
+	"exclude": ["node_modules"]
+}

package/templates/nextjs-shadcn/wrangler.jsonc

@@ -0,0 +1,23 @@
+{
+	"$schema": "node_modules/wrangler/config-schema.json",
+	"name": "jack-template",
+	"main": ".open-next/worker.js",
+	"compatibility_date": "2024-12-30",
+	"compatibility_flags": ["nodejs_compat"],
+	"assets": {
+		"directory": ".open-next/assets",
+		"binding": "ASSETS"
+	},
+	"d1_databases": [
+		{
+			"binding": "DB",
+			"database_name": "jack-template-db"
+		}
+	],
+	"r2_buckets": [
+		{
+			"binding": "NEXT_INC_CACHE_R2_BUCKET",
+			"bucket_name": "jack-template-cache"
+		}
+	]
+}

package/templates/resend/.jack.json

@@ -0,0 +1,64 @@
+{
+	"name": "resend",
+	"description": "Transactional email API powered by Resend",
+	"secrets": ["RESEND_API_KEY"],
+	"capabilities": ["db"],
+	"requires": ["DB"],
+	"intent": {
+		"keywords": [
+			"email",
+			"resend",
+			"transactional",
+			"notification",
+			"mail",
+			"smtp"
+		],
+		"examples": [
+			"email sending API",
+			"transactional email service",
+			"notification emails"
+		]
+	},
+	"agentContext": {
+		"summary": "A transactional email API using Resend with D1-backed email logging.",
+		"full_text": "## Project Structure\n\n- `src/index.ts` - Hono API with email send and log endpoints\n- `src/email.ts` - Resend email helper with D1 logging\n- `schema.sql` - D1 schema for email_log table\n\n## Sending Email\n\n```bash\ncurl -X POST https://your-app.workers.dev/api/send \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"to\": \"user@example.com\", \"subject\": \"Hello\", \"html\": \"<p>Welcome!</p>\"}'\n```\n\n## Email Templates\n\nBuilt-in template helpers:\n```typescript\nimport { welcomeEmail, notificationEmail } from './email';\n\n// Send welcome email\nawait sendEmail(env, db, welcomeEmail('user@example.com', 'Alice'));\n\n// Send notification\nawait sendEmail(env, db, notificationEmail('user@example.com', 'New order received', 'Order #123'));\n```\n\n## Email Log\n\nAll sent emails are logged to D1 for tracking:\n```bash\ncurl https://your-app.workers.dev/api/emails        # List recent emails\ncurl https://your-app.workers.dev/api/emails/stats    # Send stats\n```\n\n## Endpoints\n\n- `POST /api/send` - Send an email\n- `GET /api/emails` - List recent emails (last 50)\n- `GET /api/emails/stats` - Email send statistics\n- `GET /health` - Health check\n\n## Environment Variables\n\n- `RESEND_API_KEY` - Resend API key (re_...)\n- `FROM_EMAIL` - Default sender email (defaults to onboarding@resend.dev)\n\n## Resources\n\n- [Resend Docs](https://resend.com/docs)\n- [Resend API Reference](https://resend.com/docs/api-reference)\n- [Hono Documentation](https://hono.dev)"
+	},
+	"hooks": {
+		"preCreate": [
+			{
+				"action": "require",
+				"source": "secret",
+				"key": "RESEND_API_KEY",
+				"message": "Resend API key for transactional email",
+				"setupUrl": "https://resend.com/api-keys",
+				"onMissing": "prompt",
+				"promptMessage": "Enter your Resend API key (re_...):"
+			}
+		],
+		"postDeploy": [
+			{
+				"action": "clipboard",
+				"text": "{{url}}",
+				"message": "Deploy URL copied to clipboard"
+			},
+			{
+				"action": "shell",
+				"command": "curl -s {{url}}/health | head -c 200",
+				"message": "Testing worker health..."
+			},
+			{
+				"action": "box",
+				"title": "Email API live: {{name}}",
+				"lines": [
+					"{{url}}",
+					"",
+					"Endpoints:",
+					"  POST {{url}}/api/send    — send an email",
+					"  GET  {{url}}/api/emails  — email log",
+					"",
+					"Verify Resend domain: https://resend.com/domains"
+				]
+			}
+		]
+	}
+}

package/templates/resend/bun.lock

@@ -0,0 +1,23 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "jack-template",
+      "dependencies": {
+        "hono": "^4.6.0",
+      },
+      "devDependencies": {
+        "@cloudflare/workers-types": "^4.20241205.0",
+        "typescript": "^5.0.0",
+      },
+    },
+  },
+  "packages": {
+    "@cloudflare/workers-types": ["@cloudflare/workers-types@4.20260212.0", "", {}, "sha512-ZK+e8T/2tWBCrE8PoAi9oqTxcBen9Apq+dxbsy1R5LFVdB6M4pY+oP49OFuHTTezrvNXbyvmzbf/vjtrCPGdNg=="],
+
+    "hono": ["hono@4.11.9", "", {}, "sha512-Eaw2YTGM6WOxA6CXbckaEvslr2Ne4NFsKrvc0v97JD5awbmeBLO5w9Ho9L9kmKonrwF9RJlW6BxT1PVv/agBHQ=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+  }
+}

package/templates/resend/package.json

@@ -0,0 +1,16 @@
+{
+	"name": "jack-template",
+	"type": "module",
+	"private": true,
+	"scripts": {
+		"dev": "wrangler dev",
+		"deploy": "wrangler deploy"
+	},
+	"dependencies": {
+		"hono": "^4.6.0"
+	},
+	"devDependencies": {
+		"@cloudflare/workers-types": "^4.20241205.0",
+		"typescript": "^5.0.0"
+	}
+}

package/templates/resend/schema.sql

@@ -0,0 +1,13 @@
+CREATE TABLE IF NOT EXISTS email_log (
+  id TEXT PRIMARY KEY,
+  to_address TEXT NOT NULL,
+  from_address TEXT NOT NULL,
+  subject TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'sent',
+  resend_id TEXT,
+  error TEXT,
+  created_at INTEGER NOT NULL DEFAULT (unixepoch())
+);
+
+CREATE INDEX IF NOT EXISTS idx_email_log_created ON email_log(created_at);
+CREATE INDEX IF NOT EXISTS idx_email_log_to ON email_log(to_address);

package/templates/resend/src/email.ts

@@ -0,0 +1,165 @@
+export interface EmailOptions {
+	to: string;
+	subject: string;
+	html?: string;
+	text?: string;
+}
+
+export interface SendResult {
+	success: boolean;
+	id?: string;
+	error?: string;
+}
+
+export interface Env {
+	RESEND_API_KEY: string;
+	FROM_EMAIL?: string;
+}
+
+/**
+ * Send an email via Resend API and log the result to D1.
+ */
+export async function sendEmail(
+	env: Env,
+	db: D1Database,
+	opts: EmailOptions,
+): Promise<SendResult> {
+	const from = env.FROM_EMAIL || "onboarding@resend.dev";
+	const id = crypto.randomUUID();
+
+	try {
+		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({
+				from,
+				to: opts.to,
+				subject: opts.subject,
+				html: opts.html,
+				text: opts.text,
+			}),
+		});
+
+		if (!response.ok) {
+			const errorBody = await response.text();
+			let errorMessage: string;
+			try {
+				const parsed = JSON.parse(errorBody);
+				errorMessage = parsed.message || parsed.error || errorBody;
+			} catch {
+				errorMessage = errorBody;
+			}
+
+			await db
+				.prepare(
+					"INSERT INTO email_log (id, to_address, from_address, subject, status, error, created_at) VALUES (?, ?, ?, ?, ?, ?, ?)",
+				)
+				.bind(id, opts.to, from, opts.subject, "failed", errorMessage, Math.floor(Date.now() / 1000))
+				.run();
+
+			return { success: false, error: errorMessage };
+		}
+
+		const data = (await response.json()) as { id: string };
+
+		await db
+			.prepare(
+				"INSERT INTO email_log (id, to_address, from_address, subject, status, resend_id, created_at) VALUES (?, ?, ?, ?, ?, ?, ?)",
+			)
+			.bind(id, opts.to, from, opts.subject, "sent", data.id, Math.floor(Date.now() / 1000))
+			.run();
+
+		return { success: true, id: data.id };
+	} catch (err) {
+		const errorMessage = err instanceof Error ? err.message : "Unknown error";
+
+		await db
+			.prepare(
+				"INSERT INTO email_log (id, to_address, from_address, subject, status, error, created_at) VALUES (?, ?, ?, ?, ?, ?, ?)",
+			)
+			.bind(id, opts.to, from, opts.subject, "failed", errorMessage, Math.floor(Date.now() / 1000))
+			.run();
+
+		return { success: false, error: errorMessage };
+	}
+}
+
+/**
+ * Welcome email template.
+ */
+export function welcomeEmail(to: string, name: string): EmailOptions {
+	return {
+		to,
+		subject: `Welcome, ${name}!`,
+		html: `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+</head>
+<body style="margin:0;padding:0;background:#f6f9fc;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;">
+  <table width="100%" cellpadding="0" cellspacing="0" style="background:#f6f9fc;padding:40px 0;">
+    <tr>
+      <td align="center">
+        <table width="560" cellpadding="0" cellspacing="0" style="background:#ffffff;border-radius:8px;padding:40px;">
+          <tr>
+            <td>
+              <h1 style="margin:0 0 16px;font-size:24px;color:#1a1a1a;">Welcome, ${name}!</h1>
+              <p style="margin:0 0 24px;font-size:16px;line-height:1.5;color:#4a4a4a;">
+                Thanks for signing up. We're glad to have you on board.
+              </p>
+              <p style="margin:0;font-size:16px;line-height:1.5;color:#4a4a4a;">
+                If you have any questions, just reply to this email.
+              </p>
+            </td>
+          </tr>
+        </table>
+      </td>
+    </tr>
+  </table>
+</body>
+</html>`,
+	};
+}
+
+/**
+ * Notification email template.
+ */
+export function notificationEmail(
+	to: string,
+	title: string,
+	body: string,
+): EmailOptions {
+	return {
+		to,
+		subject: title,
+		html: `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+</head>
+<body style="margin:0;padding:0;background:#f6f9fc;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;">
+  <table width="100%" cellpadding="0" cellspacing="0" style="background:#f6f9fc;padding:40px 0;">
+    <tr>
+      <td align="center">
+        <table width="560" cellpadding="0" cellspacing="0" style="background:#ffffff;border-radius:8px;padding:40px;">
+          <tr>
+            <td>
+              <h1 style="margin:0 0 16px;font-size:24px;color:#1a1a1a;">${title}</h1>
+              <p style="margin:0;font-size:16px;line-height:1.5;color:#4a4a4a;">
+                ${body}
+              </p>
+            </td>
+          </tr>
+        </table>
+      </td>
+    </tr>
+  </table>
+</body>
+</html>`,
+	};
+}

package/templates/resend/src/index.ts

@@ -0,0 +1,108 @@
+import { Hono } from "hono";
+import { cors } from "hono/cors";
+import { sendEmail, welcomeEmail, notificationEmail } from "./email";
+
+type Bindings = {
+	DB: D1Database;
+	RESEND_API_KEY: string;
+	FROM_EMAIL?: string;
+};
+
+const app = new Hono<{ Bindings: Bindings }>();
+
+app.use("/*", cors());
+
+app.get("/", (c) => {
+	return c.json({ message: "Email API running", name: "jack-template" });
+});
+
+app.get("/health", (c) => {
+	return c.json({ status: "ok", timestamp: Date.now() });
+});
+
+// Send an email
+app.post("/api/send", async (c) => {
+	const db = c.env.DB;
+
+	let body: {
+		to: string;
+		subject?: string;
+		html?: string;
+		text?: string;
+		template?: "welcome" | "notification";
+		templateData?: Record<string, string>;
+	};
+
+	try {
+		body = await c.req.json();
+	} catch {
+		return c.json({ error: "Invalid JSON body" }, 400);
+	}
+
+	if (!body.to) {
+		return c.json({ error: "Missing required field: to" }, 400);
+	}
+
+	// Build email options from template or raw fields
+	let emailOpts: { to: string; subject: string; html?: string; text?: string };
+
+	if (body.template === "welcome") {
+		const name = body.templateData?.name || "there";
+		emailOpts = welcomeEmail(body.to, name);
+	} else if (body.template === "notification") {
+		const title = body.templateData?.title || "Notification";
+		const notifBody = body.templateData?.body || "";
+		emailOpts = notificationEmail(body.to, title, notifBody);
+	} else {
+		if (!body.subject) {
+			return c.json({ error: "Missing required field: subject" }, 400);
+		}
+		if (!body.html && !body.text) {
+			return c.json(
+				{ error: "At least one of html or text is required" },
+				400,
+			);
+		}
+		emailOpts = {
+			to: body.to,
+			subject: body.subject,
+			html: body.html,
+			text: body.text,
+		};
+	}
+
+	const result = await sendEmail(c.env, db, emailOpts);
+
+	if (result.success) {
+		return c.json({ success: true, id: result.id });
+	}
+	return c.json({ error: result.error }, 500);
+});
+
+// List recent emails
+app.get("/api/emails", async (c) => {
+	const db = c.env.DB;
+
+	const { results } = await db
+		.prepare(
+			"SELECT * FROM email_log ORDER BY created_at DESC LIMIT 50",
+		)
+		.all();
+
+	return c.json({ emails: results });
+});
+
+// Email send statistics
+app.get("/api/emails/stats", async (c) => {
+	const db = c.env.DB;
+
+	const { results } = await db
+		.prepare(
+			"SELECT status, COUNT(*) as count FROM email_log GROUP BY status",
+		)
+		.all();
+
+	return c.json({ stats: results });
+});
+
+export default app;

package/templates/resend/tsconfig.json

@@ -0,0 +1,17 @@
+{
+	"compilerOptions": {
+		"target": "ESNext",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"lib": ["ESNext"],
+		"types": ["@cloudflare/workers-types"],
+		"strict": true,
+		"esModuleInterop": true,
+		"skipLibCheck": true,
+		"forceConsistentCasingInFileNames": true,
+		"resolveJsonModule": true,
+		"isolatedModules": true
+	},
+	"include": ["src/**/*.ts"],
+	"exclude": ["node_modules"]
+}

package/templates/resend/wrangler.jsonc

@@ -0,0 +1,11 @@
+{
+	"name": "jack-template",
+	"main": "src/index.ts",
+	"compatibility_date": "2024-12-01",
+	"d1_databases": [
+		{
+			"binding": "DB",
+			"database_name": "jack-template-db"
+		}
+	]
+}

package/templates/saas/.jack.json

@@ -14,7 +14,7 @@
 		"examples": ["subscription app", "paid membership site", "saas product"]
 	},
 	"agentContext": {
-		"summary": "A SaaS starter with Better Auth authentication, Stripe payments, React + Vite frontend, and Hono API on Cloudflare Workers with D1 SQLite database.",
+		"summary": "A SaaS starter with Better Auth authentication, Stripe payments, React + Vite frontend, and Hono API with D1 SQLite database.",
 		"full_text": "## Project Structure\n\n- `src/index.ts` - Hono API entry point with auth and payment routes\n- `src/auth.ts` - Better Auth configuration with Stripe plugin\n- `src/client/App.tsx` - React application entry point\n- `src/client/lib/auth-client.ts` - Better Auth client\n- `src/client/hooks/` - useAuth, useSubscription hooks\n- `src/client/pages/` - Page components (HomePage, DashboardPage, etc.)\n- `src/client/components/ui/` - shadcn/ui components\n- `schema.sql` - D1 database schema (user, session, account, subscription)\n- `wrangler.jsonc` - Cloudflare Workers configuration\n\n## Authentication\n\nUses Better Auth with email/password. Auth routes are handled at `/api/auth/*`.\n\n### Client-side\n```tsx\nimport { authClient } from './lib/auth-client';\n\n// Sign up\nawait authClient.signUp.email({ email, password, name });\n\n// Sign in\nawait authClient.signIn.email({ email, password });\n\n// Get session\nconst { data: session } = await authClient.getSession();\n```\n\n## Payments (Stripe)\n\nUses Better Auth Stripe plugin for subscription management.\n\n### Upgrade Flow\n```tsx\nimport { authClient } from './lib/auth-client';\n\nasync function handleUpgrade(plan: 'pro' | 'enterprise') {\n  const { data, error } = await authClient.subscription.upgrade({\n    plan,\n    successUrl: '/dashboard?upgraded=true',\n    cancelUrl: '/pricing',\n  });\n\n  if (data?.url) {\n    window.location.href = data.url;  // Redirect to Stripe Checkout\n  }\n}\n```\n\n### Check Subscription\n```tsx\nconst { data: subscriptions } = await authClient.subscription.list();\nconst activeSubscription = subscriptions?.find(s =>\n  s.status === 'active' || s.status === 'trialing'\n);\nconst plan = activeSubscription?.plan || 'free';\n```\n\n## Webhook Setup\n\nStripe webhooks are handled at `/api/auth/stripe/webhook`. Required events:\n- `checkout.session.completed`\n- `customer.subscription.created`\n- `customer.subscription.updated`\n- `customer.subscription.deleted`\n\n## Database Schema\n\nUses Better Auth's default schema (singular table names, camelCase columns):\n- `user` - User accounts\n- `session` - Active sessions\n- `account` - OAuth/password credentials\n- `verification` - Email verification tokens\n- `subscription` - Stripe subscriptions\n\n## Environment Variables\n\n- `BETTER_AUTH_SECRET` - Random secret for auth tokens (generate with: openssl rand -base64 32)\n- `STRIPE_SECRET_KEY` - Stripe API secret key\n- `STRIPE_WEBHOOK_SECRET` - Stripe webhook signing secret (whsec_...)\n- `STRIPE_PRO_PRICE_ID` - Stripe price ID for Pro plan\n- `STRIPE_ENTERPRISE_PRICE_ID` - Stripe price ID for Enterprise plan\n\n## Resources\n\n- [Better Auth Docs](https://www.betterauth.com/docs)\n- [Better Auth Stripe Plugin](https://www.betterauth.com/docs/plugins/stripe)\n- [Stripe Subscriptions](https://docs.stripe.com/billing/subscriptions)\n- [Hono Documentation](https://hono.dev)\n- [Cloudflare D1 Docs](https://developers.cloudflare.com/d1)"
 	},
 	"hooks": {