@pylonsync/create-pylon 0.3.51 → 0.3.54

package/templates/ios/chat/apps/ios/Sources/__APP_NAME_PASCAL__/ChatRootView.swift

@@ -0,0 +1,120 @@
+import SwiftUI
+import PylonClient
+
+/// Two-pane chat: rooms list → room view. Polls the active room
+/// every 1.5s. For realtime, swap `pollMessages()` out for a
+/// PylonQuery<Message> from PylonSwiftUI subscribed by roomId.
+struct ChatRootView: View {
+	@EnvironmentObject var session: AppSession
+	@State private var rooms: [Room] = []
+	@State private var loadingRooms = true
+	@State private var errorMessage: String?
+
+	var body: some View {
+		NavigationStack {
+			List {
+				Section("Your name") {
+					TextField("display name", text: Binding(
+						get: { session.authorName },
+						set: { session.setAuthorName($0) },
+					))
+					.autocorrectionDisabled()
+				}
+				Section("Rooms") {
+					if loadingRooms {
+						ProgressView()
+					} else if rooms.isEmpty {
+						Text("No rooms yet. Create one below.")
+							.foregroundStyle(.secondary)
+					} else {
+						ForEach(rooms) { r in
+							NavigationLink(value: r) {
+								VStack(alignment: .leading) {
+									Text(r.name)
+									Text("#\(r.slug)")
+										.font(.system(.caption, design: .monospaced))
+										.foregroundStyle(.secondary)
+								}
+							}
+						}
+					}
+				}
+				Section {
+					Button("Create room") {
+						Task { await createRoom() }
+					}
+				}
+				if let errorMessage {
+					Section {
+						Text(errorMessage)
+							.foregroundStyle(.red)
+							.font(.caption)
+					}
+				}
+			}
+			.navigationTitle("__APP_NAME__")
+			.navigationDestination(for: Room.self) { room in
+				RoomView(room: room)
+			}
+			.task { await loadRooms() }
+			.refreshable { await loadRooms() }
+		}
+	}
+
+	private func loadRooms() async {
+		loadingRooms = true
+		defer { loadingRooms = false }
+		do {
+			rooms = try await session.pylon.callFn("listRooms", args: EmptyArgs())
+			errorMessage = nil
+		} catch {
+			errorMessage = "Load failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func createRoom() async {
+		let alert = await prompt(title: "Create room", message: "Room name?")
+		guard let name = alert?.trimmingCharacters(in: .whitespaces),
+			!name.isEmpty
+		else { return }
+		let slug = name.lowercased()
+			.replacingOccurrences(of: "[^a-z0-9]+", with: "-", options: .regularExpression)
+			.trimmingCharacters(in: CharacterSet(charactersIn: "-"))
+		do {
+			let room: Room = try await session.pylon.callFn(
+				"createRoom",
+				args: CreateRoomArgs(slug: slug, name: name),
+			)
+			rooms.append(room)
+		} catch {
+			errorMessage = "Create failed: \(error.localizedDescription)"
+		}
+	}
+
+	@MainActor
+	private func prompt(title: String, message: String) async -> String? {
+		// Minimal SwiftUI prompt — for production replace with an
+		// in-tree alert + TextField sheet. The scaffold uses a tiny
+		// UIKit detour on iOS so the demo works without a custom
+		// modal implementation.
+#if canImport(UIKit)
+		await withCheckedContinuation { (cont: CheckedContinuation<String?, Never>) in
+			let alert = UIAlertController(title: title, message: message, preferredStyle: .alert)
+			alert.addTextField()
+			alert.addAction(UIAlertAction(title: "Cancel", style: .cancel) { _ in cont.resume(returning: nil) })
+			alert.addAction(UIAlertAction(title: "Create", style: .default) { _ in cont.resume(returning: alert.textFields?.first?.text) })
+			UIApplication.shared.connectedScenes
+				.compactMap { ($0 as? UIWindowScene)?.windows.first }
+				.first?
+				.rootViewController?
+				.present(alert, animated: true)
+		}
+#else
+		return nil
+#endif
+	}
+}
+
+#if canImport(UIKit)
+import UIKit
+#endif

package/templates/ios/chat/apps/ios/Sources/__APP_NAME_PASCAL__/Models.swift

@@ -0,0 +1,26 @@
+import Foundation
+
+struct Room: Codable, Identifiable, Hashable {
+	let id: String
+	let slug: String
+	let name: String
+	let createdAt: String
+}
+
+struct Message: Codable, Identifiable, Hashable {
+	let id: String
+	let roomId: String
+	let authorId: String
+	let authorName: String
+	let body: String
+	let createdAt: String
+}
+
+struct CreateRoomArgs: Encodable { let slug: String; let name: String }
+struct RoomMessagesArgs: Encodable { let roomId: String }
+struct SendMessageArgs: Encodable {
+	let roomId: String
+	let body: String
+	let authorName: String
+}
+struct EmptyArgs: Encodable {}

package/templates/ios/chat/apps/ios/Sources/__APP_NAME_PASCAL__/RoomView.swift

@@ -0,0 +1,137 @@
+import SwiftUI
+import PylonClient
+
+struct RoomView: View {
+	@EnvironmentObject var session: AppSession
+	let room: Room
+	@State private var messages: [Message] = []
+	@State private var draft = ""
+	@State private var sending = false
+	@State private var errorMessage: String?
+	@State private var pollTimer: Task<Void, Never>?
+
+	var body: some View {
+		VStack(spacing: 0) {
+			ScrollViewReader { proxy in
+				ScrollView {
+					LazyVStack(alignment: .leading, spacing: 12) {
+						ForEach(messages) { msg in
+							messageRow(msg).id(msg.id)
+						}
+						if messages.isEmpty {
+							Text("No messages yet. Say hi.")
+								.foregroundStyle(.secondary)
+								.padding(.top, 32)
+								.frame(maxWidth: .infinity)
+						}
+					}
+					.padding(16)
+				}
+				.onChange(of: messages.count) { _, _ in
+					if let last = messages.last {
+						withAnimation { proxy.scrollTo(last.id, anchor: .bottom) }
+					}
+				}
+			}
+
+			if let errorMessage {
+				Text(errorMessage)
+					.foregroundStyle(.red)
+					.font(.caption)
+					.padding(8)
+			}
+
+			HStack {
+				TextField("Message #\(room.slug)…", text: $draft, axis: .vertical)
+					.textFieldStyle(.roundedBorder)
+					.lineLimit(1...4)
+					.onSubmit { Task { await send() } }
+				Button("Send") { Task { await send() } }
+					.keyboardShortcut(.defaultAction)
+					.disabled(draft.trimmingCharacters(in: .whitespaces).isEmpty || sending)
+			}
+			.padding(12)
+			.background(.thinMaterial)
+		}
+		.navigationTitle(room.name)
+		#if os(iOS)
+		.navigationBarTitleDisplayMode(.inline)
+		#endif
+		.task {
+			await loadMessages()
+			startPolling()
+		}
+		.onDisappear { pollTimer?.cancel() }
+	}
+
+	@ViewBuilder
+	private func messageRow(_ msg: Message) -> some View {
+		VStack(alignment: .leading, spacing: 2) {
+			HStack(alignment: .firstTextBaseline) {
+				Text(msg.authorName).font(.subheadline.weight(.medium))
+				Text(formatTime(msg.createdAt))
+					.font(.caption2)
+					.foregroundStyle(.tertiary)
+			}
+			Text(msg.body)
+				.font(.body)
+				.fixedSize(horizontal: false, vertical: true)
+		}
+	}
+
+	private func formatTime(_ iso: String) -> String {
+		let formatter = ISO8601DateFormatter()
+		formatter.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+		guard let date = formatter.date(from: iso) ?? ISO8601DateFormatter().date(from: iso) else {
+			return ""
+		}
+		let display = DateFormatter()
+		display.timeStyle = .short
+		return display.string(from: date)
+	}
+
+	private func loadMessages() async {
+		do {
+			messages = try await session.pylon.callFn(
+				"roomMessages",
+				args: RoomMessagesArgs(roomId: room.id),
+			)
+			errorMessage = nil
+		} catch {
+			errorMessage = "Load failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func startPolling() {
+		pollTimer?.cancel()
+		pollTimer = Task {
+			while !Task.isCancelled {
+				try? await Task.sleep(nanoseconds: 1_500_000_000)
+				if Task.isCancelled { break }
+				await loadMessages()
+			}
+		}
+	}
+
+	private func send() async {
+		let body = draft.trimmingCharacters(in: .whitespaces)
+		guard !body.isEmpty else { return }
+		sending = true
+		defer { sending = false }
+		do {
+			let msg: Message = try await session.pylon.callFn(
+				"sendMessage",
+				args: SendMessageArgs(
+					roomId: room.id,
+					body: body,
+					authorName: session.authorName,
+				),
+			)
+			messages.append(msg)
+			draft = ""
+			errorMessage = nil
+		} catch {
+			errorMessage = "Send failed: \(error.localizedDescription)"
+		}
+	}
+}

package/templates/ios/chat/apps/ios/Sources/__APP_NAME_PASCAL__/__APP_NAME_PASCAL__App.swift

@@ -0,0 +1,35 @@
+import SwiftUI
+import PylonClient
+
+@main
+struct __APP_NAME_PASCAL__App: App {
+	@StateObject private var session = AppSession()
+
+	var body: some Scene {
+		WindowGroup {
+			ChatRootView()
+				.environmentObject(session)
+		}
+	}
+}
+
+@MainActor
+final class AppSession: ObservableObject {
+	let pylon: PylonClient
+	@Published var authorName: 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.pylon = PylonClient(baseURL: url, appName: "__APP_NAME_SNAKE__")
+		self.authorName = UserDefaults.standard.string(forKey: "authorName") ?? "anonymous"
+	}
+
+	func setAuthorName(_ name: String) {
+		authorName = name
+		UserDefaults.standard.set(name, forKey: "authorName")
+	}
+}

package/templates/ios/chat/apps/ios/project.yml

@@ -0,0 +1,42 @@
+# xcodegen spec for the iOS build of __APP_NAME__.
+#
+# Materialize the Xcode project once with:
+#     brew install xcodegen
+#     xcodegen generate
+# Then open __APP_NAME_PASCAL__.xcodeproj.
+
+name: __APP_NAME_PASCAL__
+options:
+  bundleIdPrefix: com.example
+  deploymentTarget:
+    iOS: "16.0"
+
+packages:
+  pylon:
+    url: https://github.com/pylonsync/pylon.git
+    from: "0.3.0"
+
+targets:
+  __APP_NAME_PASCAL__:
+    type: application
+    platform: iOS
+    sources:
+      - path: Sources/__APP_NAME_PASCAL__
+    settings:
+      base:
+        GENERATE_INFOPLIST_FILE: YES
+        INFOPLIST_KEY_UIApplicationSceneManifest_Generation: YES
+        INFOPLIST_KEY_UILaunchScreen_Generation: YES
+        INFOPLIST_KEY_UISupportedInterfaceOrientations: "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight"
+        TARGETED_DEVICE_FAMILY: "1,2"
+        SWIFT_VERSION: "5.9"
+        ENABLE_PREVIEWS: YES
+        # __APP_NAME__ talks to a Pylon backend on localhost during dev.
+        # The simulator can reach localhost directly; on a physical device
+        # set PYLON_BASE_URL to your machine's LAN IP.
+        INFOPLIST_KEY_NSAppTransportSecurity: "{NSAllowsLocalNetworking = YES;}"
+    dependencies:
+      - package: pylon
+        product: PylonClient
+      - package: pylon
+        product: PylonSwiftUI

package/templates/ios/consumer/apps/ios/Package.swift

@@ -0,0 +1,23 @@
+// swift-tools-version:5.9
+import PackageDescription
+
+let package = Package(
+	name: "__APP_NAME_PASCAL__",
+	platforms: [
+		.iOS(.v16),
+		.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/ios/consumer/apps/ios/Sources/__APP_NAME_PASCAL__/FeedView.swift

@@ -0,0 +1,170 @@
+import SwiftUI
+import PylonClient
+
+struct FeedView: View {
+	@EnvironmentObject var session: AppSession
+	@State private var feed: [FeedItem] = []
+	@State private var loading = true
+	@State private var posting = false
+	@State private var draft = ""
+	@State private var errorMessage: String?
+
+	var body: some View {
+		NavigationStack {
+			List {
+				Section("Post") {
+					VStack(alignment: .leading, spacing: 8) {
+						TextEditor(text: $draft)
+							.frame(minHeight: 80)
+							.font(.body)
+						HStack {
+							Text("\(draft.count)/1000")
+								.font(.caption)
+								.foregroundStyle(.secondary)
+							Spacer()
+							Button(posting ? "Posting…" : "Post") {
+								Task { await post() }
+							}
+							.disabled(posting || draft.trimmingCharacters(in: .whitespaces).isEmpty)
+						}
+					}
+				}
+
+				Section("Feed") {
+					if loading {
+						ProgressView()
+					} else if feed.isEmpty {
+						Text("No posts yet.")
+							.foregroundStyle(.secondary)
+					} else {
+						ForEach(feed) { item in
+							row(item)
+						}
+					}
+				}
+
+				if let errorMessage {
+					Section {
+						Text(errorMessage)
+							.foregroundStyle(.red)
+							.font(.caption)
+					}
+				}
+			}
+			.navigationTitle("__APP_NAME__")
+			.task { await load() }
+			.refreshable { await load() }
+		}
+	}
+
+	@ViewBuilder
+	private func row(_ item: FeedItem) -> some View {
+		VStack(alignment: .leading, spacing: 6) {
+			HStack(alignment: .firstTextBaseline) {
+				Text(item.author?.displayName ?? "Unknown")
+					.font(.subheadline.weight(.medium))
+				Text("@\(item.author?.handle ?? "?")")
+					.font(.system(.caption, design: .monospaced))
+					.foregroundStyle(.secondary)
+				Spacer()
+				Text(item.createdAt)
+					.font(.caption2)
+					.foregroundStyle(.tertiary)
+			}
+			Text(item.body)
+				.font(.body)
+				.fixedSize(horizontal: false, vertical: true)
+			HStack {
+				Button {
+					Task { await toggleLike(item) }
+				} label: {
+					HStack(spacing: 4) {
+						Image(systemName: item.likedByMe ? "heart.fill" : "heart")
+						Text("\(item.likeCount)")
+					}
+					.font(.caption)
+					.foregroundStyle(item.likedByMe ? .pink : .secondary)
+				}
+				.buttonStyle(.plain)
+
+				if item.author?.id == session.me?.id {
+					Spacer()
+					Button("Delete", role: .destructive) {
+						Task { await delete(item) }
+					}
+					.font(.caption)
+				}
+			}
+		}
+		.padding(.vertical, 4)
+	}
+
+	// MARK: - Network
+
+	private func load() async {
+		loading = true
+		defer { loading = false }
+		do {
+			feed = try await session.pylon.callFn("feed", args: EmptyArgs())
+			errorMessage = nil
+		} catch {
+			errorMessage = "Load failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func post() async {
+		let body = draft.trimmingCharacters(in: .whitespaces)
+		guard !body.isEmpty else { return }
+		posting = true
+		defer { posting = false }
+		do {
+			let item: FeedItem = try await session.pylon.callFn(
+				"createPost",
+				args: CreatePostArgs(body: body),
+			)
+			feed.insert(item, at: 0)
+			draft = ""
+		} catch {
+			errorMessage = "Post failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func toggleLike(_ item: FeedItem) async {
+		// Optimistic
+		if let i = feed.firstIndex(where: { $0.id == item.id }) {
+			feed[i].likedByMe.toggle()
+			feed[i].likeCount += feed[i].likedByMe ? 1 : -1
+		}
+		do {
+			let result: ToggleLikeResult = try await session.pylon.callFn(
+				"toggleLike",
+				args: ToggleLikeArgs(postId: item.id),
+			)
+			if let i = feed.firstIndex(where: { $0.id == item.id }) {
+				feed[i].likedByMe = result.liked
+				feed[i].likeCount = result.likeCount
+			}
+		} catch {
+			// Revert
+			if let i = feed.firstIndex(where: { $0.id == item.id }) {
+				feed[i].likedByMe = item.likedByMe
+				feed[i].likeCount = item.likeCount
+			}
+			errorMessage = "Like failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func delete(_ item: FeedItem) async {
+		let snapshot = feed
+		feed.removeAll { $0.id == item.id }
+		do {
+			let _: FeedItem = try await session.pylon.callFn(
+				"deletePost",
+				args: DeletePostArgs(id: item.id),
+			)
+		} catch {
+			feed = snapshot
+			errorMessage = "Delete failed: \(error.localizedDescription)"
+		}
+	}
+}

package/templates/ios/consumer/apps/ios/Sources/__APP_NAME_PASCAL__/Models.swift

@@ -0,0 +1,42 @@
+import Foundation
+
+struct Profile: Codable, Identifiable, Hashable {
+	let id: String
+	let userId: String
+	let handle: String
+	let displayName: String
+	let bio: String?
+	let createdAt: String
+}
+
+struct FeedItem: Codable, Identifiable, Hashable {
+	let id: String
+	let body: String
+	let createdAt: String
+	let author: AuthorCard?
+	var likeCount: Int
+	var likedByMe: Bool
+}
+
+struct AuthorCard: Codable, Hashable {
+	let id: String
+	let handle: String
+	let displayName: String
+}
+
+struct UpsertProfileArgs: Encodable {
+	let handle: String
+	let displayName: String
+	let bio: String
+}
+
+struct CreatePostArgs: Encodable { let body: String }
+struct DeletePostArgs: Encodable { let id: String }
+struct ToggleLikeArgs: Encodable { let postId: String }
+
+struct ToggleLikeResult: Codable {
+	let liked: Bool
+	let likeCount: Int
+}
+
+struct EmptyArgs: Encodable {}

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

@@ -0,0 +1,60 @@
+import SwiftUI
+import PylonClient
+
+struct ProfileSetupView: View {
+	@EnvironmentObject var session: AppSession
+	@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 }
+		do {
+			let profile: Profile = try await session.pylon.callFn(
+				"upsertProfile",
+				args: UpsertProfileArgs(
+					handle: handle.trimmingCharacters(in: .whitespaces).lowercased(),
+					displayName: displayName.trimmingCharacters(in: .whitespaces),
+					bio: bio.trimmingCharacters(in: .whitespaces),
+				),
+			)
+			session.me = profile
+		} catch {
+			errorMessage = "Save failed: \(error.localizedDescription)"
+		}
+	}
+}

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

@@ -0,0 +1,30 @@
+import SwiftUI
+import PylonClient
+
+struct RootView: View {
+	@EnvironmentObject var session: AppSession
+	@State private var loading = true
+
+	var body: some View {
+		Group {
+			if loading {
+				ProgressView()
+					.frame(maxWidth: .infinity, maxHeight: .infinity)
+			} else if session.me == nil {
+				ProfileSetupView()
+			} else {
+				FeedView()
+			}
+		}
+		.task { await load() }
+	}
+
+	private func load() async {
+		do {
+			session.me = try await session.pylon.callFn("myProfile", args: EmptyArgs())
+		} catch {
+			session.me = nil
+		}
+		loading = false
+	}
+}