@pylonsync/create-pylon 0.3.53 → 0.3.55

package/templates/mac/consumer/apps/mac/Sources/__APP_NAME_PASCAL__/ProfileSetupView.swift

@@ -0,0 +1,68 @@
+import SwiftUI
+import PylonClient
+import PylonSync
+
+struct ProfileSetupView: View {
+	@EnvironmentObject var session: AppSession
+	let engine: SyncEngine
+	let existingHandles: [String]
+
+	@State private var handle = ""
+	@State private var displayName = ""
+	@State private var bio = ""
+	@State private var saving = false
+	@State private var errorMessage: String?
+
+	var body: some View {
+		NavigationStack {
+			Form {
+				Section("Set up your profile") {
+					TextField("handle (lowercase, 2–20)", text: $handle)
+						.autocorrectionDisabled()
+						.textInputAutocapitalization(.never)
+					TextField("Display name", text: $displayName)
+					TextField("Bio (optional)", text: $bio)
+				}
+				if let errorMessage {
+					Section {
+						Text(errorMessage)
+							.foregroundStyle(.red)
+							.font(.caption)
+					}
+				}
+				Section {
+					Button(saving ? "Saving…" : "Save") {
+						Task { await save() }
+					}
+					.disabled(saving
+						|| handle.trimmingCharacters(in: .whitespaces).isEmpty
+						|| displayName.trimmingCharacters(in: .whitespaces).isEmpty)
+				}
+			}
+			.navigationTitle("__APP_NAME__")
+		}
+	}
+
+	private func save() async {
+		saving = true
+		defer { saving = false }
+		let lower = handle.trimmingCharacters(in: .whitespaces).lowercased()
+		if existingHandles.contains(lower) {
+			errorMessage = "@\(lower) is taken"
+			return
+		}
+		do {
+			let profile: Profile = try await session.client.callFn(
+				"upsertProfile",
+				args: UpsertProfileArgs(
+					handle: lower,
+					displayName: displayName.trimmingCharacters(in: .whitespaces),
+					bio: bio.trimmingCharacters(in: .whitespaces),
+				),
+			)
+			session.setMyProfileId(profile.id)
+		} catch {
+			errorMessage = "Save failed: \(error.localizedDescription)"
+		}
+	}
+}

package/templates/mac/consumer/apps/mac/Sources/__APP_NAME_PASCAL__/RootView.swift

@@ -0,0 +1,40 @@
+import SwiftUI
+import PylonClient
+import PylonSync
+import PylonSwiftUI
+
+/// Watches the live Profile collection. If we have a saved profileId
+/// AND a Profile row in the local store with that id, render the
+/// feed; otherwise, profile setup. The profile row appears in the
+/// store via the SyncEngine, so a fresh device sees its own profile
+/// pop in moments after `upsertProfile` returns.
+struct RootView: View {
+	@EnvironmentObject var session: AppSession
+	let engine: SyncEngine
+	@StateObject private var profiles: PylonQuery<Profile>
+
+	init(engine: SyncEngine) {
+		self.engine = engine
+		_profiles = StateObject(
+			wrappedValue: PylonQuery<Profile>(engine: engine, entity: "Profile"),
+		)
+	}
+
+	var body: some View {
+		Group {
+			if let me = currentProfile {
+				FeedView(engine: engine, me: me, profiles: profiles.rows)
+			} else {
+				ProfileSetupView(
+					engine: engine,
+					existingHandles: profiles.rows.map { $0.handle },
+				)
+			}
+		}
+	}
+
+	private var currentProfile: Profile? {
+		guard let id = session.myProfileId else { return nil }
+		return profiles.rows.first { $0.id == id }
+	}
+}

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

@@ -0,0 +1,59 @@
+import SwiftUI
+import PylonClient
+import PylonSync
+
+@main
+struct __APP_NAME_PASCAL__App: App {
+	@StateObject private var session = AppSession()
+
+	var body: some Scene {
+		Window("__APP_NAME__", id: "main") {
+			Group {
+				if let engine = session.engine {
+					RootView(engine: engine)
+						.environmentObject(session)
+						.frame(minWidth: 480, minHeight: 600)
+				} else {
+					ProgressView()
+						.frame(maxWidth: .infinity, maxHeight: .infinity)
+				}
+			}
+			.task { await session.bootIfNeeded() }
+		}
+		.windowResizability(.contentMinSize)
+	}
+}
+
+@MainActor
+final class AppSession: ObservableObject {
+	let client: PylonClient
+	@Published private(set) var engine: SyncEngine?
+	@Published var myProfileId: String?
+
+	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.client = PylonClient(baseURL: url, appName: "__APP_NAME_SNAKE__")
+		self.myProfileId = UserDefaults.standard.string(forKey: "myProfileId")
+	}
+
+	func bootIfNeeded() async {
+		guard engine == nil else { return }
+		let baseURLString = ProcessInfo.processInfo.environment["PYLON_BASE_URL"]
+			?? "http://localhost:4321"
+		guard let url = URL(string: baseURLString) else { return }
+		let config = SyncEngineConfig(baseURL: url, appName: "__APP_NAME_SNAKE__")
+		let engine = await SyncEngine(config: config, client: client)
+		await engine.start()
+		self.engine = engine
+	}
+
+	func setMyProfileId(_ id: String?) {
+		myProfileId = id
+		if let id { UserDefaults.standard.set(id, forKey: "myProfileId") }
+		else { UserDefaults.standard.removeObject(forKey: "myProfileId") }
+	}
+}

package/templates/mac/consumer/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/consumer/apps/mac/project.yml

@@ -0,0 +1,36 @@
+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: PylonSync
+      - package: pylon
+        product: PylonSwiftUI

package/templates/mac/todo/apps/mac/Package.swift

@@ -0,0 +1,33 @@
+// swift-tools-version:5.9
+import PackageDescription
+
+// SwiftPM package for the __APP_NAME__ macOS app.
+//
+// The executable target runs locally with `swift run`. For a proper
+// signed `.app` bundle:
+//
+//     brew install xcodegen
+//     xcodegen generate
+//     open __APP_NAME_PASCAL__.xcodeproj
+//
+// The Xcode project pulls the same Sources/__APP_NAME_PASCAL__/ tree
+// as `swift build`, so SwiftPM and Xcode share one source set.
+let package = Package(
+	name: "__APP_NAME_PASCAL__",
+	platforms: [
+		.macOS(.v13),
+	],
+	dependencies: [
+		.package(url: "https://github.com/pylonsync/pylon.git", from: "0.3.0"),
+	],
+	targets: [
+		.executableTarget(
+			name: "__APP_NAME_PASCAL__",
+			dependencies: [
+				.product(name: "PylonClient", package: "pylon"),
+				.product(name: "PylonSwiftUI", package: "pylon"),
+			],
+			path: "Sources/__APP_NAME_PASCAL__"
+		),
+	]
+)

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

@@ -0,0 +1,19 @@
+import Foundation
+
+/// Mirrors `Todo` from `apps/api/schema.ts`. Regenerate from the
+/// schema with `pylon codegen client schema.ts --target swift` for
+/// production.
+struct Todo: Codable, Identifiable, Hashable {
+	let id: String
+	var title: String
+	var done: Bool
+	let createdAt: String
+	var position: Double?
+}
+
+struct AddTodoArgs: Encodable { let title: String }
+struct ToggleTodoArgs: Encodable { let id: String; let done: Bool }
+struct EditTodoArgs: Encodable { let id: String; let title: String }
+struct DeleteTodoArgs: Encodable { let id: String }
+struct ReorderTodoArgs: Encodable { let id: String; let position: Double }
+struct EmptyArgs: Encodable {}

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": {} },
+};