@pylonsync/create-pylon 0.11.1 → 0.11.3

package/templates/consumer/components/social/use-social.ts

@@ -0,0 +1,86 @@
+"use client";
+
+import { useMemo } from "react";
+import { db } from "@pylonsync/react";
+import { useAuth } from "@pylonsync/client";
+import {
+  countBy,
+  followingOf,
+  groupBy,
+  newestFirst,
+  type Comment,
+  type Follow,
+  type Like,
+  type Post,
+  type Profile,
+  type Save,
+} from "@/lib/social";
+
+/**
+ * Everything the screens read, joined once. Each `db.useQuery` is live, so a
+ * like, comment, or follow from another tab shows up here without a reload.
+ * Fine for a demo-sized network; a large one would query per screen with
+ * `where` and `limit` instead of reading every row.
+ */
+export function useSocial() {
+  const { userId } = useAuth();
+  const profiles = db.useQuery<Profile>("Profile");
+  const posts = db.useQuery<Post>("Post");
+  const likes = db.useQuery<Like>("Like");
+  const comments = db.useQuery<Comment>("Comment");
+  const follows = db.useQuery<Follow>("Follow");
+  const saves = db.useQuery<Save>("Save");
+
+  return useMemo(() => {
+    const me = userId ?? null;
+    const profileByUser = new Map(profiles.data.map((p) => [p.userId, p]));
+    const profileByUsername = new Map(profiles.data.map((p) => [p.username, p]));
+    const myLikes = new Map(likes.data.filter((l) => l.userId === me).map((l) => [l.postId, l]));
+    const mySaves = new Map(saves.data.filter((s) => s.userId === me).map((s) => [s.postId, s]));
+    const myFollows = new Map(follows.data.filter((f) => f.followerId === me).map((f) => [f.followingId, f]));
+    return {
+      me,
+      myProfile: me ? profileByUser.get(me) ?? null : null,
+      loading: posts.loading && posts.data.length === 0,
+      profiles: profiles.data,
+      posts: newestFirst(posts.data),
+      follows: follows.data,
+      profileByUser,
+      profileByUsername,
+      likeCount: countBy(likes.data, (l) => l.postId),
+      commentsByPost: groupBy(newestFirst(comments.data).reverse(), (c) => c.postId),
+      postsByAuthor: groupBy(newestFirst(posts.data), (p) => p.authorId),
+      followerCount: countBy(follows.data, (f) => f.followingId),
+      followingCount: countBy(follows.data, (f) => f.followerId),
+      following: followingOf(follows.data, me),
+      myLikes,
+      mySaves,
+      myFollows,
+    };
+  }, [userId, profiles.data, posts.data, posts.loading, likes.data, comments.data, follows.data, saves.data]);
+}
+
+export type Social = ReturnType<typeof useSocial>;
+
+/** Writes. Likes, saves, and follows are direct; posts and comments go through functions. */
+export const actions = {
+  toggleLike(social: Social, postId: string) {
+    const mine = social.myLikes.get(postId);
+    if (mine) void db.delete("Like", mine.id);
+    else if (social.me) void db.insert("Like", { postId, userId: social.me });
+  },
+  like(social: Social, postId: string) {
+    if (social.me && !social.myLikes.has(postId)) void db.insert("Like", { postId, userId: social.me });
+  },
+  toggleSave(social: Social, postId: string) {
+    const mine = social.mySaves.get(postId);
+    if (mine) void db.delete("Save", mine.id);
+    else if (social.me) void db.insert("Save", { postId, userId: social.me });
+  },
+  toggleFollow(social: Social, userId: string) {
+    if (!social.me || userId === social.me) return;
+    const mine = social.myFollows.get(userId);
+    if (mine) void db.delete("Follow", mine.id);
+    else void db.insert("Follow", { followingId: userId, followerId: social.me });
+  },
+};

package/templates/consumer/functions/addComment.ts

@@ -0,0 +1,27 @@
+import { mutation, v } from "@pylonsync/functions";
+import { COMMENT_MAX } from "../lib/social";
+
+/** Comment on a post. The post must exist and the text must fit. */
+export default mutation<{ postId: string; text: string }, { id: string }>({
+  // Guest sessions count: a visitor can post without signing up.
+  auth: "guest",
+  args: { postId: v.string(), text: v.string() },
+  async handler(ctx, args) {
+    const userId = ctx.auth.userId;
+    if (!userId) throw ctx.error("AUTH_REQUIRED", "Open the app to start a session first.");
+    const text = args.text.trim();
+    if (!text) throw ctx.error("INVALID_COMMENT", "Write something first.");
+    if (text.length > COMMENT_MAX) throw ctx.error("INVALID_COMMENT", `Use at most ${COMMENT_MAX} characters.`);
+    const post = await ctx.db.get("Post", args.postId);
+    if (!post) throw ctx.error("NOT_FOUND", "That post was deleted.");
+    // The Comment policy refuses client inserts; this function is the
+    // checked path, so it writes past the policy on purpose.
+    const id = await ctx.db.unsafe.insert("Comment", {
+      postId: args.postId,
+      authorId: userId,
+      text,
+      createdAt: new Date().toISOString(),
+    });
+    return { id };
+  },
+});

package/templates/consumer/functions/createPost.ts

@@ -0,0 +1,39 @@
+import { mutation, v } from "@pylonsync/functions";
+import { CAPTION_MAX, isPostImageUrl } from "../lib/social";
+
+/**
+ * Publish a photo. The client uploads the file first (uploadFile with
+ * visibility "public", so every visitor can load it) and sends its URL here.
+ * The URL, caption length, and crop shape are checked on the server.
+ */
+export default mutation<
+  { imageUrl: string; caption?: string; shape?: string },
+  { id: string }
+>({
+  // Guest sessions count: a visitor can post without signing up.
+  auth: "guest",
+  args: {
+    imageUrl: v.string(),
+    caption: v.optional(v.string()),
+    shape: v.optional(v.string()),
+  },
+  async handler(ctx, args) {
+    const userId = ctx.auth.userId;
+    if (!userId) throw ctx.error("AUTH_REQUIRED", "Open the app to start a session first.");
+    const imageUrl = args.imageUrl.trim();
+    if (!isPostImageUrl(imageUrl)) throw ctx.error("INVALID_IMAGE", "Upload the photo again.");
+    const caption = (args.caption ?? "").trim();
+    if (caption.length > CAPTION_MAX) throw ctx.error("INVALID_CAPTION", `Use at most ${CAPTION_MAX} characters.`);
+    const shape = args.shape === "portrait" ? "portrait" : "square";
+    // The Post policy refuses client inserts; this function is the checked
+    // path, so it writes past the policy on purpose.
+    const id = await ctx.db.unsafe.insert("Post", {
+      authorId: userId,
+      imageUrl,
+      caption: caption || null,
+      shape,
+      createdAt: new Date().toISOString(),
+    });
+    return { id };
+  },
+});

package/templates/consumer/functions/ensureProfile.ts

@@ -0,0 +1,39 @@
+import { mutation } from "@pylonsync/functions";
+import { starterUsername } from "../lib/social";
+
+/**
+ * The caller's profile, created on first use. Every page calls this once a
+ * session exists, so a visitor has a username before they post, like, or
+ * comment. A starter username is `visitor_xxxxxx`; the profile page can
+ * change it.
+ */
+export default mutation<Record<string, never>, { id: string; username: string; created: boolean }>({
+  // Guest sessions count: a visitor can post without signing up.
+  auth: "guest",
+  args: {},
+  async handler(ctx) {
+    const userId = ctx.auth.userId;
+    if (!userId) throw ctx.error("AUTH_REQUIRED", "Open the app to start a session first.");
+    // Two tabs opening at once must not create two profiles.
+    await ctx.db.advisoryLock(`profile:${userId}`);
+    const [existing] = await ctx.db.query("Profile", { userId, $limit: 1 });
+    if (existing) return { id: String(existing.id), username: String(existing.username), created: false };
+
+    const base = starterUsername(userId);
+    for (let attempt = 0; attempt < 5; attempt++) {
+      const username = attempt === 0 ? base : `${base}${attempt}`;
+      const [taken] = await ctx.db.query("Profile", { username, $limit: 1 });
+      if (taken) continue;
+      // The Profile policy refuses client writes; this function is the
+      // checked path, so it writes past the policy on purpose.
+      const id = await ctx.db.unsafe.insert("Profile", {
+        userId,
+        username,
+        displayName: "Visitor",
+        createdAt: new Date().toISOString(),
+      });
+      return { id, username, created: true };
+    }
+    throw ctx.error("USERNAME_UNAVAILABLE", "Could not pick a free username. Try again.");
+  },
+});

package/templates/consumer/functions/seedFeed.ts

@@ -0,0 +1,38 @@
+import { mutation } from "@pylonsync/functions";
+import { shapeSeed } from "../lib/seed";
+
+/**
+ * Load the demo people, posts, likes, comments, and follows once. The feed
+ * calls this on mount; it returns at once when the demo data exists, and a
+ * lock keeps two first visits from seeding twice.
+ *
+ * Public so an anonymous first visitor seeds it. `unsafe.insert` writes past
+ * the policies, which only accept the caller's own id, so the posts read as
+ * twelve different people. It only writes lib/seed.ts. Delete this function
+ * and lib/seed.ts when you launch.
+ */
+export default mutation<Record<string, never>, { seeded: boolean }>({
+  auth: "public",
+  args: {},
+  async handler(ctx) {
+    await ctx.db.advisoryLock("consumer_seed_feed");
+    const existing = await ctx.db.unsafe.query("Profile", { userId: "demo_mara_bakes", $limit: 1 });
+    if (existing.length > 0) return { seeded: false };
+
+    const seed = shapeSeed();
+    for (const profile of seed.profiles) await ctx.db.unsafe.insert("Profile", profile);
+
+    const postIds = new Map<string, string>();
+    for (const post of seed.posts) {
+      postIds.set(post.key, await ctx.db.unsafe.insert("Post", post.row));
+    }
+    for (const like of seed.likes) {
+      await ctx.db.unsafe.insert("Like", { ...like.row, postId: postIds.get(like.post) });
+    }
+    for (const comment of seed.comments) {
+      await ctx.db.unsafe.insert("Comment", { ...comment.row, postId: postIds.get(comment.post) });
+    }
+    for (const follow of seed.follows) await ctx.db.unsafe.insert("Follow", follow);
+    return { seeded: true };
+  },
+});

package/templates/consumer/functions/updateProfile.ts

@@ -0,0 +1,61 @@
+import { mutation, v } from "@pylonsync/functions";
+import {
+  BIO_MAX,
+  DISPLAY_NAME_MAX,
+  isPostImageUrl,
+  normalizeUsername,
+  usernameProblem,
+} from "../lib/social";
+
+/**
+ * Change the caller's username, name, bio, or avatar. A function rather
+ * than a client update so the username rules and uniqueness are checked on
+ * the server; the Profile policy refuses direct writes.
+ */
+export default mutation<
+  { username: string; displayName: string; bio?: string; avatarUrl?: string },
+  { username: string }
+>({
+  // Guest sessions count: a visitor can post without signing up.
+  auth: "guest",
+  args: {
+    username: v.string(),
+    displayName: v.string(),
+    bio: v.optional(v.string()),
+    // An empty string removes the photo.
+    avatarUrl: v.optional(v.string()),
+  },
+  async handler(ctx, args) {
+    const userId = ctx.auth.userId;
+    if (!userId) throw ctx.error("AUTH_REQUIRED", "Open the app to start a session first.");
+    const [profile] = await ctx.db.query("Profile", { userId, $limit: 1 });
+    if (!profile) throw ctx.error("NOT_FOUND", "Open the app once to create your profile first.");
+
+    const username = normalizeUsername(args.username);
+    const problem = usernameProblem(username);
+    if (problem) throw ctx.error("INVALID_USERNAME", problem);
+    if (username !== profile.username) {
+      await ctx.db.advisoryLock(`username:${username}`);
+      const [taken] = await ctx.db.query("Profile", { username, $limit: 1 });
+      if (taken) throw ctx.error("USERNAME_TAKEN", `@${username} is taken.`);
+    }
+
+    const displayName = args.displayName.trim();
+    if (!displayName) throw ctx.error("INVALID_NAME", "Add a name.");
+    if (displayName.length > DISPLAY_NAME_MAX) throw ctx.error("INVALID_NAME", `Use at most ${DISPLAY_NAME_MAX} characters for the name.`);
+    const bio = (args.bio ?? "").trim();
+    if (bio.length > BIO_MAX) throw ctx.error("INVALID_BIO", `Use at most ${BIO_MAX} characters for the bio.`);
+    const avatarUrl = args.avatarUrl ? args.avatarUrl.trim() : null;
+    if (avatarUrl && !isPostImageUrl(avatarUrl)) throw ctx.error("INVALID_IMAGE", "Upload the photo again.");
+
+    // The Profile policy refuses client writes; this function is the
+    // checked path, so it writes past the policy on purpose.
+    await ctx.db.unsafe.update("Profile", String(profile.id), {
+      username,
+      displayName,
+      bio: bio || null,
+      avatarUrl,
+    });
+    return { username };
+  },
+});

package/templates/consumer/lib/seed.ts

@@ -0,0 +1,192 @@
+// Demo data for a new app: twelve people who post, follow each other, like,
+// and comment, so the first visit opens on a feed that looks lived in.
+//
+// Photos live in public/images (avatars/ and posts/). Demo user ids start
+// with "demo_" so they never collide with a real or guest account.
+// Pure data + pure shaping; functions/seedFeed.ts is a thin wrapper.
+
+export interface SeedProfile {
+  username: string;
+  displayName: string;
+  bio: string;
+}
+
+export interface SeedPost {
+  key: string;
+  author: string;
+  caption: string;
+  shape: "square" | "portrait";
+  /** Hours ago. */
+  age: number;
+}
+
+export interface SeedComment {
+  post: string;
+  author: string;
+  text: string;
+  /** Hours after the post. */
+  after: number;
+}
+
+export const SEED_PROFILES: SeedProfile[] = [
+  { username: "mara.bakes", displayName: "Mara Lindqvist", bio: "Sourdough, mostly. Stockholm." },
+  { username: "theo.climbs", displayName: "Theo Adeyemi", bio: "Bouldering most evenings. Route setter at Blocworks." },
+  { username: "ines.clay", displayName: "Inés Moreno", bio: "Wheel-thrown stoneware from a small studio in Valencia." },
+  { username: "kenji.rides", displayName: "Kenji Watanabe", bio: "Gravel on weekends, commuting on weekdays." },
+  { username: "lou.streets", displayName: "Louise Carter", bio: "35mm film, mostly Brooklyn." },
+  { username: "sam.grows", displayName: "Sam Okafor", bio: "Allotment 14B. Tomatoes, beans, too many courgettes." },
+  { username: "rosa.roasts", displayName: "Rosa Delgado", bio: "Head roaster at a small shop in Oakland." },
+  { username: "biscuit.corgi", displayName: "Biscuit", bio: "Corgi. Professional napper. Managed by @nora.h" },
+  { username: "nora.h", displayName: "Nora Hughes", bio: "Product designer. Biscuit's person." },
+  { username: "ari.wanders", displayName: "Ari Cohen", bio: "Trains over planes." },
+  { username: "dev.draws", displayName: "Dev Patel", bio: "Architect. A sketch every morning before work." },
+  { username: "june.surfs", displayName: "June Tanaka", bio: "Cold water surfer on the Oregon coast." },
+];
+
+export const SEED_POSTS: SeedPost[] = [
+  { key: "mara-loaf", author: "mara.bakes", caption: "Sunday loaf. 78% hydration and finally an ear I am happy with.", shape: "portrait", age: 3 },
+  { key: "june-dawn", author: "june.surfs", caption: "Glassy at 6am and nobody else out. Worth the cold hands.", shape: "portrait", age: 5 },
+  { key: "biscuit-couch", author: "biscuit.corgi", caption: "Guarding the couch from nothing in particular.", shape: "square", age: 8 },
+  { key: "rosa-roaster", author: "rosa.roasts", caption: "New Ethiopia lot on the roaster today. Blueberry and jasmine in the cup.", shape: "square", age: 11 },
+  { key: "ines-glaze", author: "ines.clay", caption: "Out of the kiln: the speckled oat glaze on a batch of mugs. Shop update Friday.", shape: "portrait", age: 14 },
+  { key: "lou-crosswalk", author: "lou.streets", caption: "Bedford Ave, late afternoon. Portra 400.", shape: "portrait", age: 20 },
+  { key: "dev-sketch", author: "dev.draws", caption: "Morning sketch of the old library stairs. Twenty minutes, one pen.", shape: "square", age: 26 },
+  { key: "kenji-gravel", author: "kenji.rides", caption: "82 km, 1,400 m of climbing, one flat. Good day.", shape: "portrait", age: 30 },
+  { key: "sam-tomatoes", author: "sam.grows", caption: "First proper harvest of the year. The yellow ones are Sungold.", shape: "square", age: 34 },
+  { key: "theo-boulder", author: "theo.climbs", caption: "Set a new blue circuit this week. This one is the crux of number 6.", shape: "portrait", age: 40 },
+  { key: "ari-train", author: "ari.wanders", caption: "Night train from Vienna to Venice. Woke up to this.", shape: "portrait", age: 46 },
+  { key: "nora-desk", author: "nora.h", caption: "New desk setup. @biscuit.corgi approved the rug.", shape: "square", age: 52 },
+  { key: "mara-buns", author: "mara.bakes", caption: "Cardamom buns for the neighbours. Kept two.", shape: "square", age: 60 },
+  { key: "june-board", author: "june.surfs", caption: "Waxed and ready for tomorrow.", shape: "square", age: 70 },
+  { key: "rosa-latte", author: "rosa.roasts", caption: "Tuesday latte art practice. Getting there.", shape: "square", age: 78 },
+  { key: "ines-wheel", author: "ines.clay", caption: "Trimming feet on a batch of bowls. The quiet part of the week.", shape: "portrait", age: 90 },
+  { key: "lou-diner", author: "lou.streets", caption: "Counter seats at the diner on Graham. Coffee refills forever.", shape: "square", age: 100 },
+  { key: "biscuit-beach", author: "biscuit.corgi", caption: "First time at the beach. Sand everywhere. No regrets.", shape: "portrait", age: 110 },
+  { key: "dev-model", author: "dev.draws", caption: "Card model for the community centre competition entry.", shape: "square", age: 124 },
+  { key: "kenji-coffee", author: "kenji.rides", caption: "Mid-ride coffee stop. The bike rests too.", shape: "square", age: 140 },
+  { key: "sam-shed", author: "sam.grows", caption: "Seed trays in the shed. Kale, chard, and far too much basil.", shape: "portrait", age: 155 },
+  { key: "theo-chalk", author: "theo.climbs", caption: "Chalk bag, tape, and a very tired pair of shoes.", shape: "square", age: 170 },
+  { key: "ari-market", author: "ari.wanders", caption: "Morning market in Palermo. I bought too many lemons.", shape: "square", age: 190 },
+  { key: "nora-sketches", author: "nora.h", caption: "Paper first, screens later. Wireframes for the booking flow.", shape: "square", age: 210 },
+  { key: "mara-starter", author: "mara.bakes", caption: "Meet Olof, the starter. Eleven years old this month.", shape: "portrait", age: 240 },
+  { key: "june-van", author: "june.surfs", caption: "Home for the weekend.", shape: "square", age: 280 },
+  { key: "ines-studio", author: "ines.clay", caption: "The studio shelves on a good week.", shape: "portrait", age: 320 },
+  { key: "lou-rain", author: "lou.streets", caption: "Rain on the J train platform.", shape: "portrait", age: 360 },
+];
+
+export const SEED_COMMENTS: SeedComment[] = [
+  { post: "mara-loaf", author: "rosa.roasts", text: "That crumb. Trading you a bag of the new Ethiopia for one.", after: 0.5 },
+  { post: "mara-loaf", author: "sam.grows", text: "What flour are you using?", after: 1 },
+  { post: "mara-loaf", author: "mara.bakes", text: "@sam.grows 80% bread flour, 20% whole wheat from the mill down the road.", after: 1.5 },
+  { post: "june-dawn", author: "kenji.rides", text: "Unreal colours.", after: 1 },
+  { post: "june-dawn", author: "ari.wanders", text: "Which beach is this?", after: 2 },
+  { post: "biscuit-couch", author: "nora.h", text: "He has not moved in three hours.", after: 0.2 },
+  { post: "biscuit-couch", author: "lou.streets", text: "A very serious job.", after: 2 },
+  { post: "biscuit-couch", author: "theo.climbs", text: "Those ears.", after: 3 },
+  { post: "rosa-roaster", author: "mara.bakes", text: "Saving me a bag?", after: 1 },
+  { post: "rosa-roaster", author: "rosa.roasts", text: "@mara.bakes already set aside.", after: 1.2 },
+  { post: "ines-glaze", author: "dev.draws", text: "The speckle on that glaze is lovely.", after: 2 },
+  { post: "ines-glaze", author: "nora.h", text: "Setting an alarm for Friday.", after: 3 },
+  { post: "lou-crosswalk", author: "ari.wanders", text: "The light in this one.", after: 4 },
+  { post: "dev-sketch", author: "ines.clay", text: "Twenty minutes? Show-off.", after: 1 },
+  { post: "kenji-gravel", author: "june.surfs", text: "Where was the flat?", after: 2 },
+  { post: "kenji-gravel", author: "kenji.rides", text: "@june.surfs about 5 km from the end, of course.", after: 3 },
+  { post: "sam-tomatoes", author: "mara.bakes", text: "Tomato and bread season.", after: 1 },
+  { post: "theo-boulder", author: "kenji.rides", text: "Looks sandbagged.", after: 2 },
+  { post: "theo-boulder", author: "theo.climbs", text: "@kenji.rides it is a fair blue. Mostly.", after: 2.5 },
+  { post: "ari-train", author: "lou.streets", text: "Adding this to the list.", after: 5 },
+  { post: "nora-desk", author: "dev.draws", text: "Where is the lamp from?", after: 1 },
+  { post: "mara-buns", author: "rosa.roasts", text: "Recipe please.", after: 2 },
+  { post: "biscuit-beach", author: "june.surfs", text: "Surf lessons next.", after: 1 },
+  { post: "dev-model", author: "ines.clay", text: "Good luck with the entry.", after: 3 },
+  { post: "sam-shed", author: "mara.bakes", text: "Pesto for the whole street then.", after: 4 },
+  { post: "mara-starter", author: "biscuit.corgi", text: "Can I eat Olof.", after: 2 },
+  { post: "mara-starter", author: "mara.bakes", text: "@biscuit.corgi no.", after: 2.2 },
+];
+
+/** Who each demo user follows, as username → usernames. */
+export const SEED_FOLLOWS: Record<string, string[]> = {
+  "mara.bakes": ["rosa.roasts", "sam.grows", "ines.clay", "biscuit.corgi", "lou.streets"],
+  "theo.climbs": ["kenji.rides", "june.surfs", "ari.wanders", "biscuit.corgi"],
+  "ines.clay": ["dev.draws", "mara.bakes", "nora.h", "lou.streets"],
+  "kenji.rides": ["theo.climbs", "june.surfs", "rosa.roasts", "ari.wanders"],
+  "lou.streets": ["ari.wanders", "dev.draws", "biscuit.corgi", "ines.clay"],
+  "sam.grows": ["mara.bakes", "rosa.roasts", "biscuit.corgi"],
+  "rosa.roasts": ["mara.bakes", "kenji.rides", "ines.clay", "sam.grows"],
+  "biscuit.corgi": ["nora.h", "june.surfs"],
+  "nora.h": ["biscuit.corgi", "dev.draws", "ines.clay", "lou.streets", "mara.bakes"],
+  "ari.wanders": ["lou.streets", "june.surfs", "kenji.rides", "theo.climbs"],
+  "dev.draws": ["ines.clay", "nora.h", "lou.streets"],
+  "june.surfs": ["kenji.rides", "biscuit.corgi", "ari.wanders", "theo.climbs"],
+};
+
+export const demoUserId = (username: string) => `demo_${username.replace(/\./g, "_")}`;
+export const avatarPath = (username: string) => `/images/avatars/${username}.jpg`;
+export const postImagePath = (key: string) => `/images/posts/${key}.jpg`;
+
+/**
+ * Which demo users like a post: a stable pick from everyone but the author,
+ * between four and eleven people, so counts differ from post to post.
+ */
+export function likersOf(post: SeedPost): string[] {
+  const others = SEED_PROFILES.map((p) => p.username).filter((u) => u !== post.author);
+  let h = 2166136261;
+  for (let i = 0; i < post.key.length; i++) {
+    h ^= post.key.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  const count = 4 + ((h >>> 0) % (others.length - 3));
+  const start = (h >>> 8) % others.length;
+  return Array.from({ length: count }, (_, i) => others[(start + i) % others.length]);
+}
+
+export interface ShapedSeed {
+  profiles: Record<string, unknown>[];
+  posts: Array<{ key: string; row: Record<string, unknown> }>;
+  likes: Array<{ post: string; row: Record<string, unknown> }>;
+  comments: Array<{ post: string; row: Record<string, unknown> }>;
+  follows: Record<string, unknown>[];
+}
+
+export function shapeSeed(now: number = Date.now()): ShapedSeed {
+  const hoursAgo = (h: number) => new Date(now - h * 3_600_000).toISOString();
+  const postAge = new Map(SEED_POSTS.map((p) => [p.key, p.age]));
+
+  return {
+    profiles: SEED_PROFILES.map((p, i) => ({
+      userId: demoUserId(p.username),
+      username: p.username,
+      displayName: p.displayName,
+      bio: p.bio,
+      avatarUrl: avatarPath(p.username),
+      createdAt: hoursAgo(2000 - i * 40),
+    })),
+    posts: SEED_POSTS.map((p) => ({
+      key: p.key,
+      row: {
+        authorId: demoUserId(p.author),
+        imageUrl: postImagePath(p.key),
+        caption: p.caption,
+        shape: p.shape,
+        createdAt: hoursAgo(p.age),
+      },
+    })),
+    likes: SEED_POSTS.flatMap((p) =>
+      likersOf(p).map((u, i) => ({
+        post: p.key,
+        row: { userId: demoUserId(u), createdAt: hoursAgo(Math.max(0.1, p.age - 0.5 - i * 0.7)) },
+      })),
+    ),
+    comments: SEED_COMMENTS.map((c) => ({
+      post: c.post,
+      row: {
+        authorId: demoUserId(c.author),
+        text: c.text,
+        createdAt: hoursAgo(Math.max(0.05, (postAge.get(c.post) ?? 0) - c.after)),
+      },
+    })),
+    follows: Object.entries(SEED_FOLLOWS).flatMap(([from, tos], i) =>
+      tos.map((to) => ({ followerId: demoUserId(from), followingId: demoUserId(to), createdAt: hoursAgo(1500 - i * 30) })),
+    ),
+  };
+}

package/templates/consumer/lib/site.ts

@@ -0,0 +1,6 @@
+// The app's name as people see it: the wordmark, page titles, and llms.txt.
+// Rename it here.
+export const SITE = {
+  name: "Glimpse",
+  description: "Share photos with the people you follow. Likes, comments, and follows update live.",
+};