@pylonsync/create-pylon 0.3.53 → 0.3.54

package/templates/mac/todo/apps/mac/Sources/__APP_NAME_PASCAL__/TodoListView.swift

@@ -0,0 +1,244 @@
+import SwiftUI
+import PylonClient
+
+/// macOS Todo list. List with inline checkbox + edit-on-double-click +
+/// delete on hover. macOS doesn't ship `EditButton`, so reordering is
+/// drag-and-drop via `.onMove(perform:)` which works in editable List.
+struct TodoListView: View {
+	@EnvironmentObject var session: AppSession
+	@State private var todos: [Todo] = []
+	@State private var draftTitle: String = ""
+	@State private var loading = true
+	@State private var pending = false
+	@State private var errorMessage: String?
+	@State private var editingId: String?
+	@State private var editingDraft: String = ""
+	@State private var hoveredId: String?
+
+	var body: some View {
+		VStack(spacing: 0) {
+			HStack(spacing: 8) {
+				TextField("What needs doing?", text: $draftTitle)
+					.textFieldStyle(.roundedBorder)
+					.onSubmit { Task { await add() } }
+				Button("Add") { Task { await add() } }
+					.keyboardShortcut(.defaultAction)
+					.disabled(draftTitle.trimmingCharacters(in: .whitespaces).isEmpty || pending)
+			}
+			.padding(16)
+
+			Divider()
+
+			if loading {
+				ProgressView().padding()
+				Spacer()
+			} else if todos.isEmpty {
+				Spacer()
+				Text("No todos yet.")
+					.foregroundStyle(.secondary)
+				Spacer()
+			} else {
+				List {
+					ForEach(todos) { todo in
+						row(todo)
+					}
+					.onMove { source, destination in
+						Task { await reorder(from: source, to: destination) }
+					}
+				}
+				.listStyle(.inset)
+			}
+
+			if let errorMessage {
+				Divider()
+				Text(errorMessage)
+					.foregroundStyle(.red)
+					.font(.caption)
+					.padding(8)
+			}
+		}
+		.task { await load() }
+		.toolbar {
+			ToolbarItem(placement: .primaryAction) {
+				Button { Task { await load() } } label: {
+					Image(systemName: "arrow.clockwise")
+				}
+				.disabled(loading)
+			}
+		}
+	}
+
+	@ViewBuilder
+	private func row(_ todo: Todo) -> some View {
+		HStack(spacing: 10) {
+			Button { Task { await toggle(todo) } } label: {
+				Image(systemName: todo.done ? "checkmark.circle.fill" : "circle")
+					.foregroundStyle(todo.done ? .green : .secondary)
+					.imageScale(.large)
+			}
+			.buttonStyle(.plain)
+
+			if editingId == todo.id {
+				TextField("Title", text: $editingDraft)
+					.textFieldStyle(.roundedBorder)
+					.onSubmit { Task { await commitEdit(todo) } }
+				Button("Save") { Task { await commitEdit(todo) } }
+					.buttonStyle(.bordered)
+				Button("Cancel") {
+					editingId = nil
+					editingDraft = ""
+				}
+				.buttonStyle(.bordered)
+			} else {
+				Text(todo.title)
+					.strikethrough(todo.done, color: .secondary)
+					.foregroundStyle(todo.done ? .secondary : .primary)
+					.onTapGesture(count: 2) {
+						editingId = todo.id
+						editingDraft = todo.title
+					}
+				Spacer()
+				if hoveredId == todo.id {
+					Button("Edit") {
+						editingId = todo.id
+						editingDraft = todo.title
+					}
+					.buttonStyle(.borderless)
+					.font(.caption)
+					Button("Delete") { Task { await delete(todo) } }
+						.buttonStyle(.borderless)
+						.font(.caption)
+						.foregroundStyle(.red)
+				}
+			}
+		}
+		.padding(.vertical, 4)
+		.contentShape(Rectangle())
+		.onHover { hovering in
+			hoveredId = hovering ? todo.id : (hoveredId == todo.id ? nil : hoveredId)
+		}
+	}
+
+	// MARK: - Network
+
+	private func load() async {
+		loading = true
+		defer { loading = false }
+		do {
+			let rows: [Todo] = try await session.pylon.callFn("listTodos", args: EmptyArgs())
+			todos = rows
+			errorMessage = nil
+		} catch {
+			errorMessage = "Load failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func add() async {
+		let trimmed = draftTitle.trimmingCharacters(in: .whitespaces)
+		guard !trimmed.isEmpty else { return }
+		pending = true
+		defer { pending = false }
+		do {
+			let todo: Todo = try await session.pylon.callFn(
+				"addTodo",
+				args: AddTodoArgs(title: trimmed),
+			)
+			todos.append(todo)
+			draftTitle = ""
+		} catch {
+			errorMessage = "Add failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func toggle(_ todo: Todo) async {
+		let nextDone = !todo.done
+		if let i = todos.firstIndex(where: { $0.id == todo.id }) {
+			todos[i].done = nextDone
+		}
+		do {
+			let _: Todo = try await session.pylon.callFn(
+				"toggleTodo",
+				args: ToggleTodoArgs(id: todo.id, done: nextDone),
+			)
+		} catch {
+			if let i = todos.firstIndex(where: { $0.id == todo.id }) {
+				todos[i].done = todo.done
+			}
+			errorMessage = "Toggle failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func commitEdit(_ todo: Todo) async {
+		let trimmed = editingDraft.trimmingCharacters(in: .whitespaces)
+		guard !trimmed.isEmpty, trimmed != todo.title else {
+			editingId = nil
+			editingDraft = ""
+			return
+		}
+		let originalTitle = todo.title
+		if let i = todos.firstIndex(where: { $0.id == todo.id }) {
+			todos[i].title = trimmed
+		}
+		editingId = nil
+		editingDraft = ""
+		do {
+			let _: Todo = try await session.pylon.callFn(
+				"editTodo",
+				args: EditTodoArgs(id: todo.id, title: trimmed),
+			)
+		} catch {
+			if let i = todos.firstIndex(where: { $0.id == todo.id }) {
+				todos[i].title = originalTitle
+			}
+			errorMessage = "Rename failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func delete(_ todo: Todo) async {
+		let snapshot = todos
+		todos.removeAll { $0.id == todo.id }
+		do {
+			let _: Todo = try await session.pylon.callFn(
+				"deleteTodo",
+				args: DeleteTodoArgs(id: todo.id),
+			)
+		} catch {
+			todos = snapshot
+			errorMessage = "Delete failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func reorder(from source: IndexSet, to destination: Int) async {
+		var moved = todos
+		moved.move(fromOffsets: source, toOffset: destination)
+		guard let movedIndex = source.first else { return }
+		let newIndex = destination > movedIndex ? destination - 1 : destination
+		guard newIndex < moved.count else { return }
+		let movedTodo = moved[newIndex]
+		let prev = newIndex > 0 ? moved[newIndex - 1] : nil
+		let next = newIndex + 1 < moved.count ? moved[newIndex + 1] : nil
+		let prevPos = prev?.position ?? 0
+		let nextPos = next?.position ?? 0
+		let position: Double
+		if prev != nil && next != nil {
+			position = (prevPos + nextPos) / 2
+		} else if prev != nil {
+			position = prevPos + 1024
+		} else if next != nil {
+			position = nextPos - 1024
+		} else {
+			position = 1024
+		}
+		let snapshot = todos
+		todos = moved
+		do {
+			let _: Todo = try await session.pylon.callFn(
+				"reorderTodo",
+				args: ReorderTodoArgs(id: movedTodo.id, position: position),
+			)
+		} catch {
+			todos = snapshot
+			errorMessage = "Reorder failed: \(error.localizedDescription)"
+		}
+	}
+}

package/templates/mac/todo/apps/mac/Sources/__APP_NAME_PASCAL__/__APP_NAME_PASCAL__App.swift

@@ -0,0 +1,30 @@
+import SwiftUI
+import PylonClient
+
+@main
+struct __APP_NAME_PASCAL__App: App {
+	@StateObject private var session = AppSession()
+
+	var body: some Scene {
+		Window("__APP_NAME__", id: "main") {
+			TodoListView()
+				.environmentObject(session)
+				.frame(minWidth: 480, minHeight: 360)
+		}
+		.windowResizability(.contentMinSize)
+	}
+}
+
+@MainActor
+final class AppSession: ObservableObject {
+	let pylon: PylonClient
+
+	init() {
+		let baseURLString = ProcessInfo.processInfo.environment["PYLON_BASE_URL"]
+			?? "http://localhost:4321"
+		guard let url = URL(string: baseURLString) else {
+			fatalError("Invalid PYLON_BASE_URL: \(baseURLString)")
+		}
+		self.pylon = PylonClient(baseURL: url, appName: "__APP_NAME_SNAKE__")
+	}
+}

package/templates/mac/todo/apps/mac/__APP_NAME_PASCAL__.entitlements

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<!-- App Sandbox + outgoing-network client. Without these the
+	     scaffolded app can't reach localhost:4321 during dev or
+	     a remote Pylon Cloud URL in production. -->
+	<key>com.apple.security.app-sandbox</key>
+	<true/>
+	<key>com.apple.security.network.client</key>
+	<true/>
+</dict>
+</plist>

package/templates/mac/todo/apps/mac/project.yml

@@ -0,0 +1,34 @@
+name: __APP_NAME_PASCAL__
+options:
+  bundleIdPrefix: com.example
+  deploymentTarget:
+    macOS: "13.0"
+
+packages:
+  pylon:
+    url: https://github.com/pylonsync/pylon.git
+    from: "0.3.0"
+
+targets:
+  __APP_NAME_PASCAL__:
+    type: application
+    platform: macOS
+    sources:
+      - path: Sources/__APP_NAME_PASCAL__
+    settings:
+      base:
+        GENERATE_INFOPLIST_FILE: YES
+        INFOPLIST_KEY_CFBundleDisplayName: __APP_NAME__
+        INFOPLIST_KEY_LSApplicationCategoryType: "public.app-category.developer-tools"
+        INFOPLIST_KEY_NSHumanReadableCopyright: ""
+        SWIFT_VERSION: "5.9"
+        ENABLE_PREVIEWS: YES
+        # The mac app talks to the local Pylon control plane during dev.
+        # App Sandbox needs the network client entitlement to reach
+        # localhost; we declare it via codesign entitlements at build time.
+        CODE_SIGN_ENTITLEMENTS: __APP_NAME_PASCAL__.entitlements
+    dependencies:
+      - package: pylon
+        product: PylonClient
+      - package: pylon
+        product: PylonSwiftUI

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

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

package/templates/web/b2b/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/b2b/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/b2b/apps/web/postcss.config.mjs

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

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;