@pylonsync/create-pylon 0.3.53 → 0.3.55

package/templates/web/b2b/apps/web/src/app/components/OrgPicker.tsx

@@ -0,0 +1,171 @@
+"use client";
+
+import { useState, useTransition } from "react";
+import { Button, Input, Card, CardHeader, CardContent } from "@__APP_NAME_KEBAB__/ui";
+
+type Org = {
+	id: string;
+	slug: string;
+	name: string;
+	role: string;
+	createdAt: string;
+};
+
+export function OrgPicker({ initialOrgs }: { initialOrgs: Org[] }) {
+	const [orgs, setOrgs] = useState(initialOrgs);
+	const [activeId, setActiveId] = useState<string | null>(
+		initialOrgs[0]?.id ?? null,
+	);
+	const [creating, setCreating] = useState(false);
+	const [name, setName] = useState("");
+	const [slug, setSlug] = useState("");
+	const [pending, startTransition] = useTransition();
+	const [error, setError] = useState<string | null>(null);
+
+	async function create(e: React.FormEvent) {
+		e.preventDefault();
+		setError(null);
+		startTransition(async () => {
+			const res = await fetch("/api/fn/createOrg", {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ slug, name }),
+			});
+			if (res.ok) {
+				const org = (await res.json()) as Org;
+				setOrgs((prev) => [
+					{ ...org, role: "owner" },
+					...prev,
+				]);
+				setActiveId(org.id);
+				setName("");
+				setSlug("");
+				setCreating(false);
+			} else {
+				const body = await res.json().catch(() => ({}));
+				setError(body?.message ?? "create failed");
+			}
+		});
+	}
+
+	const active = orgs.find((o) => o.id === activeId) ?? null;
+
+	return (
+		<div className="space-y-6">
+			<Card>
+				<CardHeader>
+					<div className="flex items-center justify-between">
+						<h2 className="text-sm font-medium">Your organizations</h2>
+						<Button
+							size="sm"
+							variant={creating ? "ghost" : "default"}
+							onClick={() => setCreating((v) => !v)}
+						>
+							{creating ? "Cancel" : "New org"}
+						</Button>
+					</div>
+				</CardHeader>
+				<CardContent>
+					{creating && (
+						<form onSubmit={create} className="grid grid-cols-2 gap-2 mb-4">
+							<Input
+								placeholder="Org name"
+								value={name}
+								onChange={(e) => setName(e.target.value)}
+								disabled={pending}
+								required
+							/>
+							<Input
+								placeholder="acme-corp"
+								value={slug}
+								onChange={(e) => setSlug(e.target.value.toLowerCase())}
+								disabled={pending}
+								pattern="[a-z0-9][a-z0-9-]{1,30}[a-z0-9]"
+								required
+							/>
+							<Button
+								type="submit"
+								variant="primary"
+								disabled={pending || !name.trim() || !slug.trim()}
+								className="col-span-2"
+							>
+								{pending ? "Creating…" : "Create org"}
+							</Button>
+							{error && (
+								<p className="text-xs text-red-500 col-span-2">{error}</p>
+							)}
+						</form>
+					)}
+
+					{orgs.length === 0 ? (
+						<p className="text-sm text-neutral-500 py-2">
+							You&apos;re not in any orgs yet. Create one above to get started.
+						</p>
+					) : (
+						<ul className="divide-y divide-neutral-200 dark:divide-neutral-800 -mx-5">
+							{orgs.map((o) => (
+								<li
+									key={o.id}
+									className="flex items-center justify-between px-5 py-2.5 cursor-pointer hover:bg-neutral-50 dark:hover:bg-neutral-900"
+									data-active={o.id === activeId || undefined}
+									onClick={() => setActiveId(o.id)}
+								>
+									<div>
+										<div className="text-sm font-medium">{o.name}</div>
+										<div className="text-xs text-neutral-400 font-mono">
+											{o.slug}
+										</div>
+									</div>
+									<span
+										className={`text-xs font-mono uppercase tracking-wide px-2 py-0.5 rounded ${
+											o.role === "owner"
+												? "bg-blue-100 text-blue-700 dark:bg-blue-950 dark:text-blue-300"
+												: o.role === "admin"
+													? "bg-amber-100 text-amber-700 dark:bg-amber-950 dark:text-amber-300"
+													: "bg-neutral-100 text-neutral-600 dark:bg-neutral-800 dark:text-neutral-400"
+										}`}
+									>
+										{o.role}
+									</span>
+								</li>
+							))}
+						</ul>
+					)}
+				</CardContent>
+			</Card>
+
+			{active && <OrgDetail org={active} />}
+		</div>
+	);
+}
+
+function OrgDetail({ org }: { org: Org }) {
+	return (
+		<Card>
+			<CardHeader>
+				<div className="flex items-baseline justify-between">
+					<h2 className="text-sm font-medium">
+						{org.name}{" "}
+						<span className="text-xs text-neutral-400 font-mono ml-1">
+							/{org.slug}
+						</span>
+					</h2>
+					<span className="text-xs text-neutral-500">your role: {org.role}</span>
+				</div>
+			</CardHeader>
+			<CardContent className="space-y-4">
+				<p className="text-sm text-neutral-500">
+					Wire member management and project lists into this panel by calling
+					<code className="font-mono text-xs mx-1">/api/fn/orgMembers</code>
+					and
+					<code className="font-mono text-xs mx-1">/api/fn/orgProjects</code>
+					with this org&apos;s id. Both queries enforce membership; you only
+					see what your role allows.
+				</p>
+				<div className="text-xs font-mono text-neutral-400">
+					orgId: {org.id}
+				</div>
+			</CardContent>
+		</Card>
+	);
+}

package/templates/web/b2b/apps/web/src/app/globals.css

@@ -0,0 +1,6 @@
+@import "tailwindcss";
+@source "../../../../packages/ui/src/**/*.{ts,tsx}";
+
+:root { color-scheme: light dark; }
+html, body { height: 100%; }
+body { font-family: ui-sans-serif, system-ui, -apple-system, sans-serif; }

package/templates/web/b2b/apps/web/src/app/layout.tsx

@@ -0,0 +1,21 @@
+import type { Metadata } from "next";
+import "./globals.css";
+
+export const metadata: Metadata = {
+	title: "__APP_NAME__",
+	description: "Multi-tenant SaaS scaffold powered by Pylon",
+};
+
+export default function RootLayout({
+	children,
+}: {
+	children: React.ReactNode;
+}) {
+	return (
+		<html lang="en">
+			<body className="antialiased min-h-screen bg-white dark:bg-neutral-950 text-neutral-900 dark:text-neutral-100">
+				{children}
+			</body>
+		</html>
+	);
+}

package/templates/web/b2b/apps/web/src/app/page.tsx

@@ -0,0 +1,39 @@
+import { pylon } from "@/lib/pylon";
+import { OrgPicker } from "./components/OrgPicker";
+
+export const dynamic = "force-dynamic";
+
+type Org = {
+	id: string;
+	slug: string;
+	name: string;
+	role: string;
+	createdAt: string;
+};
+
+export default async function HomePage() {
+	const orgs = await pylon
+		.json<Org[]>("/api/fn/myOrgs", {
+			method: "POST",
+			body: "{}",
+			headers: { "Content-Type": "application/json" },
+		})
+		.catch(() => [] as Org[]);
+
+	return (
+		<main className="mx-auto max-w-3xl px-6 py-12 space-y-8">
+			<header className="space-y-2">
+				<h1 className="text-3xl font-semibold tracking-tight">__APP_NAME__</h1>
+				<p className="text-sm text-neutral-500 dark:text-neutral-400">
+					Multi-tenant SaaS scaffold. Pick an org to manage its members and
+					projects, or create a new one. Tenant isolation is enforced
+					server-side by Pylon row-level policies — clients can&apos;t leak
+					data across orgs even if they fabricate <code className="font-mono text-xs">orgId</code>{" "}
+					in a request.
+				</p>
+			</header>
+
+			<OrgPicker initialOrgs={orgs} />
+		</main>
+	);
+}

package/templates/web/b2b/apps/web/src/lib/pylon.ts

@@ -0,0 +1,5 @@
+import { createPylonServer } from "@pylonsync/next/server";
+
+export const pylon = createPylonServer({
+	cookieName: "__APP_NAME_SNAKE___session",
+});

package/templates/web/b2b/apps/web/tsconfig.json

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

package/templates/web/chat/apps/web/next-env.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />

package/templates/web/chat/apps/web/next.config.ts

@@ -0,0 +1,24 @@
+import type { NextConfig } from "next";
+
+const PYLON_API_URL = process.env.PYLON_API_URL ?? "http://localhost:4321";
+
+const config: NextConfig = {
+	transpilePackages: [
+		"@__APP_NAME_KEBAB__/ui",
+		"@pylonsync/sdk",
+		"@pylonsync/react",
+		"@pylonsync/next",
+		"@pylonsync/functions",
+		"@pylonsync/sync",
+	],
+	async rewrites() {
+		return [
+			{ source: "/api/fn/:path*", destination: `${PYLON_API_URL}/api/fn/:path*` },
+			{ source: "/api/auth/:path*", destination: `${PYLON_API_URL}/api/auth/:path*` },
+			{ source: "/api/sync/:path*", destination: `${PYLON_API_URL}/api/sync/:path*` },
+			{ source: "/api/:path*", destination: `${PYLON_API_URL}/api/:path*` },
+		];
+	},
+};
+
+export default config;

package/templates/web/chat/apps/web/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@__APP_NAME_KEBAB__/web",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev --port 3000",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@__APP_NAME_KEBAB__/ui": "__WORKSPACE_DEP__",
+    "@pylonsync/sdk": "^__PYLON_VERSION__",
+    "@pylonsync/react": "^__PYLON_VERSION__",
+    "@pylonsync/next": "^__PYLON_VERSION__",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@tailwindcss/postcss": "^4.0.0",
+    "tailwindcss": "^4.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/templates/web/chat/apps/web/postcss.config.mjs

@@ -0,0 +1,3 @@
+export default {
+	plugins: { "@tailwindcss/postcss": {} },
+};

package/templates/web/chat/apps/web/src/app/components/ChatRoom.tsx

@@ -0,0 +1,231 @@
+"use client";
+
+import { useEffect, useRef, useState } from "react";
+import { db, callFn } from "@pylonsync/react";
+import { Button, Input } from "@__APP_NAME_KEBAB__/ui";
+
+type Room = {
+	id: string;
+	slug: string;
+	name: string;
+	createdAt: string;
+};
+
+type Message = {
+	id: string;
+	roomId: string;
+	authorId: string;
+	authorName: string;
+	body: string;
+	createdAt: string;
+};
+
+const NAME_KEY = "__APP_NAME_SNAKE___author_name";
+
+export function ChatRoom() {
+	// Live subscriptions. The sync engine pushes diffs over WebSocket
+	// — every Room insert + every Message append from any other client
+	// re-renders these components without a fetch / poll / refresh.
+	const { data: rooms = [] } = db.useQuery<Room>("Room", {
+		orderBy: { createdAt: "asc" },
+	});
+	const [activeId, setActiveId] = useState<string | null>(null);
+	useEffect(() => {
+		if (!activeId && rooms.length > 0) setActiveId(rooms[0].id);
+	}, [rooms, activeId]);
+
+	const { data: messages = [] } = db.useQuery<Message>("Message", {
+		where: activeId ? { roomId: activeId } : undefined,
+		orderBy: { createdAt: "asc" },
+		limit: 200,
+	});
+
+	const [body, setBody] = useState("");
+	const [authorName, setAuthorName] = useState("anonymous");
+	const [sending, setSending] = useState(false);
+	const scrollerRef = useRef<HTMLDivElement>(null);
+
+	useEffect(() => {
+		const stored =
+			typeof window !== "undefined"
+				? window.localStorage.getItem(NAME_KEY)
+				: null;
+		if (stored) setAuthorName(stored);
+	}, []);
+
+	useEffect(() => {
+		// Auto-scroll to bottom when message count changes.
+		scrollerRef.current?.scrollTo({
+			top: scrollerRef.current.scrollHeight,
+			behavior: "smooth",
+		});
+	}, [messages.length, activeId]);
+
+	function persistName(next: string) {
+		setAuthorName(next);
+		window.localStorage.setItem(NAME_KEY, next);
+	}
+
+	const active = rooms.find((r) => r.id === activeId) ?? null;
+
+	async function send() {
+		const trimmed = body.trim();
+		if (!trimmed || !active) return;
+		setBody("");
+		setSending(true);
+		try {
+			// Server validates body length / auth, runs ctx.db.insert,
+			// the resulting change_event hits every subscriber's local
+			// store. We don't append to local state ourselves — the
+			// useQuery above re-renders when the new row lands.
+			await callFn("sendMessage", {
+				roomId: active.id,
+				body: trimmed,
+				authorName,
+			});
+		} finally {
+			setSending(false);
+		}
+	}
+
+	async function createRoom() {
+		const name = window.prompt("Room name?");
+		if (!name) return;
+		const slug = name
+			.toLowerCase()
+			.replace(/[^a-z0-9]+/g, "-")
+			.replace(/^-|-$/g, "");
+		try {
+			const room = (await callFn("createRoom", { slug, name })) as Room;
+			setActiveId(room.id);
+		} catch (e) {
+			window.alert(`Create failed: ${String(e)}`);
+		}
+	}
+
+	return (
+		<>
+			<aside className="w-64 border-r border-neutral-200 dark:border-neutral-800 flex flex-col">
+				<div className="p-4 border-b border-neutral-200 dark:border-neutral-800">
+					<div className="flex items-center justify-between mb-2">
+						<h2 className="text-sm font-medium">Rooms</h2>
+						<button
+							onClick={createRoom}
+							className="text-xs text-neutral-500 hover:text-neutral-800 dark:hover:text-neutral-200"
+						>
+							+ New
+						</button>
+					</div>
+					<Input
+						value={authorName}
+						onChange={(e) => persistName(e.target.value)}
+						placeholder="Your name"
+						className="text-xs"
+					/>
+				</div>
+				<ul className="flex-1 overflow-auto divide-y divide-neutral-200 dark:divide-neutral-800">
+					{rooms.map((r) => (
+						<li key={r.id}>
+							<button
+								onClick={() => setActiveId(r.id)}
+								className={`w-full text-left px-4 py-2.5 text-sm hover:bg-neutral-50 dark:hover:bg-neutral-900 ${
+									r.id === activeId
+										? "bg-neutral-100 dark:bg-neutral-800 font-medium"
+										: ""
+								}`}
+							>
+								<div>{r.name}</div>
+								<div className="text-xs text-neutral-400 font-mono">
+									#{r.slug}
+								</div>
+							</button>
+						</li>
+					))}
+					{rooms.length === 0 && (
+						<li className="px-4 py-3 text-xs text-neutral-500">
+							No rooms yet. Create one above.
+						</li>
+					)}
+				</ul>
+			</aside>
+
+			<section className="flex-1 flex flex-col min-w-0">
+				{active ? (
+					<>
+						<header className="px-6 py-3 border-b border-neutral-200 dark:border-neutral-800">
+							<h1 className="text-sm font-medium">{active.name}</h1>
+							<p className="text-xs text-neutral-400 font-mono">
+								#{active.slug}
+							</p>
+						</header>
+
+						<div
+							ref={scrollerRef}
+							className="flex-1 overflow-auto px-6 py-4 space-y-3"
+						>
+							{messages.length === 0 ? (
+								<p className="text-sm text-neutral-500 text-center py-12">
+									No messages yet. Say hi.
+								</p>
+							) : (
+								messages.map((m) => (
+									<div key={m.id} className="space-y-0.5">
+										<div className="flex items-baseline gap-2">
+											<span className="text-sm font-medium">
+												{m.authorName}
+											</span>
+											<span className="text-xs text-neutral-400">
+												{new Date(m.createdAt).toLocaleTimeString(undefined, {
+													hour: "numeric",
+													minute: "2-digit",
+												})}
+											</span>
+										</div>
+										<p className="text-sm whitespace-pre-wrap break-words">
+											{m.body}
+										</p>
+									</div>
+								))
+							)}
+						</div>
+
+						<form
+							onSubmit={(e) => {
+								e.preventDefault();
+								send();
+							}}
+							className="px-6 py-3 border-t border-neutral-200 dark:border-neutral-800 flex gap-2"
+						>
+							<Input
+								value={body}
+								onChange={(e) => setBody(e.target.value)}
+								placeholder={`Message ${active.name}…`}
+								disabled={sending}
+								className="flex-1"
+							/>
+							<Button
+								type="submit"
+								variant="primary"
+								disabled={sending || !body.trim()}
+							>
+								Send
+							</Button>
+						</form>
+					</>
+				) : (
+					<div className="flex-1 flex items-center justify-center">
+						<div className="text-center space-y-2">
+							<p className="text-sm text-neutral-500">No room selected.</p>
+							<button
+								onClick={createRoom}
+								className="text-sm text-blue-600 hover:underline"
+							>
+								Create the first one
+							</button>
+						</div>
+					</div>
+				)}
+			</section>
+		</>
+	);
+}

package/templates/web/chat/apps/web/src/app/globals.css

@@ -0,0 +1,6 @@
+@import "tailwindcss";
+@source "../../../../packages/ui/src/**/*.{ts,tsx}";
+
+:root { color-scheme: light dark; }
+html, body { height: 100%; }
+body { font-family: ui-sans-serif, system-ui, -apple-system, sans-serif; }

package/templates/web/chat/apps/web/src/app/layout.tsx

@@ -0,0 +1,22 @@
+import type { Metadata } from "next";
+import "./globals.css";
+import { Providers } from "./providers";
+
+export const metadata: Metadata = {
+	title: "__APP_NAME__",
+	description: "Realtime chat powered by Pylon's sync engine",
+};
+
+export default function RootLayout({
+	children,
+}: {
+	children: React.ReactNode;
+}) {
+	return (
+		<html lang="en">
+			<body className="antialiased min-h-screen bg-white dark:bg-neutral-950 text-neutral-900 dark:text-neutral-100">
+				<Providers>{children}</Providers>
+			</body>
+		</html>
+	);
+}

package/templates/web/chat/apps/web/src/app/page.tsx

@@ -0,0 +1,12 @@
+import { ChatRoom } from "./components/ChatRoom";
+
+// All data flows through `db.useQuery` in the client component below —
+// no server-side initial fetch needed. The sync engine handles initial
+// hydration + every subsequent change over the same WebSocket.
+export default function HomePage() {
+	return (
+		<main className="h-screen flex">
+			<ChatRoom />
+		</main>
+	);
+}

package/templates/web/chat/apps/web/src/app/providers.tsx

@@ -0,0 +1,25 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { init } from "@pylonsync/react";
+
+/**
+ * Boots the Pylon sync engine on first mount. Every `db.useQuery`
+ * downstream renders against the same engine instance, so a single
+ * top-level Providers wrapper is enough — no need to thread a client
+ * through context.
+ *
+ * `baseUrl` is the same-origin Next path because next.config.ts
+ * proxies /api/* to the Pylon binary on PYLON_API_URL. Browser →
+ * same-origin → Next server → Pylon: no CORS, no extra DNS, the
+ * cookie travels naturally.
+ */
+export function Providers({ children }: { children: React.ReactNode }) {
+	const [ready, setReady] = useState(false);
+	useEffect(() => {
+		init({ baseUrl: "", appName: "__APP_NAME_SNAKE__" });
+		setReady(true);
+	}, []);
+	if (!ready) return null;
+	return <>{children}</>;
+}

package/templates/web/chat/apps/web/src/lib/pylon.ts

@@ -0,0 +1,5 @@
+import { createPylonServer } from "@pylonsync/next/server";
+
+export const pylon = createPylonServer({
+	cookieName: "__APP_NAME_SNAKE___session",
+});

package/templates/web/chat/apps/web/tsconfig.json

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

package/templates/web/consumer/apps/web/next-env.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />