@pylonsync/create-pylon 0.19.0 → 0.20.0

package/templates/saas/lib/members.ts

@@ -0,0 +1,53 @@
+import { personName } from "./names";
+
+// Server-side membership lookups shared by the task functions. Functions
+// bypass entity policies, so every lookup here is scoped to one workspace id
+// the caller has already been checked against with `ctx.requireMember`.
+
+type Reader = {
+  unsafe: {
+    get(entity: string, id: string): Promise<Record<string, unknown> | null>;
+    query(entity: string, filter: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+  };
+};
+
+/** Every member of `orgId` with the name the UI shows for them. */
+export async function workspaceMembers(
+  db: Reader,
+  orgId: string,
+): Promise<{ userId: string; name: string; role: string }[]> {
+  const rows = await db.unsafe.query("OrgMember", { orgId });
+  const out: { userId: string; name: string; role: string }[] = [];
+  for (const row of rows) {
+    const userId = String(row.userId);
+    const user = await db.unsafe.get("User", userId);
+    out.push({
+      userId,
+      role: String(row.role ?? "member"),
+      name: personName({
+        displayName: (user?.displayName as string | undefined) ?? null,
+        email: (user?.email as string | undefined) ?? null,
+      }),
+    });
+  }
+  return out;
+}
+
+/**
+ * The display name of `userId` if they belong to `orgId`, else null. The
+ * task functions call this before assigning, so a task can only point at a
+ * member of its own workspace.
+ */
+export async function memberName(
+  db: Reader,
+  orgId: string,
+  userId: string,
+): Promise<string | null> {
+  const rows = await db.unsafe.query("OrgMember", { orgId, userId });
+  if (rows.length === 0) return null;
+  const user = await db.unsafe.get("User", userId);
+  return personName({
+    displayName: (user?.displayName as string | undefined) ?? null,
+    email: (user?.email as string | undefined) ?? null,
+  });
+}

package/templates/saas/lib/names.ts

@@ -0,0 +1,53 @@
+// How a person is named in the UI. The saved display name wins; without one,
+// a readable name is built from the email's local part. tests/names.test.ts
+// covers the cases.
+
+/**
+ * "dana.reyes+work@acme.com" → "Dana Reyes". The `+tag` suffix and digits
+ * are dropped, and `.`, `_`, `-` separate words. Returns "" when nothing
+ * readable is left.
+ */
+export function nameFromEmail(email: string | null | undefined): string {
+  const local = (email ?? "").split("@")[0]?.split("+")[0] ?? "";
+  return local
+    .replace(/\d+/g, " ")
+    .split(/[._\-\s]+/)
+    .filter(Boolean)
+    .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+    .join(" ");
+}
+
+/** Longest name the UI shows. updateProfile enforces the same limit on save. */
+export const MAX_NAME = 60;
+
+/**
+ * The display name, else a name built from the email, else the email. A
+ * saved name that is itself an email address (the members endpoint falls
+ * back to the email when no name is set) counts as no name.
+ */
+export function personName(p: {
+  displayName?: string | null;
+  name?: string | null;
+  email?: string | null;
+}): string {
+  const saved = (p.displayName ?? p.name ?? "").trim().slice(0, MAX_NAME);
+  if (saved && !saved.includes("@")) return saved;
+  return (nameFromEmail(p.email) || (p.email ?? "")).slice(0, MAX_NAME);
+}
+
+/** First word of `personName`, for greetings. */
+export function firstName(p: {
+  displayName?: string | null;
+  name?: string | null;
+  email?: string | null;
+}): string {
+  return personName(p).split(/\s+/)[0] ?? "";
+}
+
+/** One or two initials for an avatar. */
+export function initials(name: string): string {
+  const parts = name.trim().split(/\s+/).filter(Boolean);
+  if (parts.length === 0) return "?";
+  const letters = parts.length === 1 ? parts[0].slice(0, 1) : parts[0][0] + parts[parts.length - 1][0];
+  return letters.toUpperCase();
+}

package/templates/saas/lib/plans.ts

@@ -86,6 +86,17 @@ export function canCreateProject(plan: PlanId, activeProjects: number): boolean
 /** A subscription counts as Pro while Stripe reports it usable. */
 export const ACTIVE_STATUSES = ["active", "trialing", "past_due"];
 
+/**
+ * The plan for one workspace given all of its subscription rows. A workspace
+ * can have several (an old canceled one and a new active one), so any usable
+ * Pro row wins over row order.
+ */
+export function planFromSubscriptions(
+  subs: Array<{ plan?: string; status?: string }>,
+): PlanId {
+  return subs.some((s) => planFromSubscription(s) === "pro") ? "pro" : "free";
+}
+
 export function planFromSubscription(
   sub: { plan?: string; status?: string } | null | undefined,
 ): PlanId {

package/templates/saas/lib/sample-workspace.ts

@@ -0,0 +1,117 @@
+import type { TaskPriority, TaskStatus } from "./tasks";
+import { isoDay } from "./tasks";
+
+// The sample projects `seedWorkspace` adds to a new workspace, so the first
+// dashboard a person sees has real rows to click through. Replace them with
+// your own domain's data, or delete this file and the "Start with sample
+// projects" button in app/onboarding/onboarding-client.tsx.
+//
+// Two projects are active and one is archived, so a free workspace still has
+// room for one project of its own under FREE_PROJECT_LIMIT (lib/plans.ts).
+
+interface SampleTask {
+  title: string;
+  status: TaskStatus;
+  priority: TaskPriority;
+  /** Days from today. Negative is in the past. */
+  due: number;
+  /** Index into the member list, taken modulo its length; null = unassigned. */
+  assignee: number | null;
+}
+
+interface SampleProject {
+  name: string;
+  description: string;
+  status: "active" | "archived";
+  tasks: SampleTask[];
+}
+
+export const SAMPLE_PROJECTS: SampleProject[] = [
+  {
+    name: "Website relaunch",
+    description: "New marketing site, pricing page, and docs, live by the end of the month.",
+    status: "active",
+    tasks: [
+      { title: "Fix the mobile nav overlap on Safari", status: "in_progress", priority: "urgent", due: 0, assignee: 0 },
+      { title: "Build the pricing page", status: "in_review", priority: "high", due: 1, assignee: 1 },
+      { title: "Move the docs to the new layout", status: "in_progress", priority: "medium", due: 4, assignee: 2 },
+      { title: "Set up redirects from the old URLs", status: "todo", priority: "high", due: 6, assignee: 0 },
+      { title: "Record the product walkthrough video", status: "todo", priority: "medium", due: 9, assignee: 3 },
+      { title: "Update the Open Graph images", status: "todo", priority: "low", due: 12, assignee: null },
+      { title: "Write the homepage copy", status: "done", priority: "high", due: -6, assignee: 1 },
+      { title: "Pick the new type scale", status: "done", priority: "medium", due: -9, assignee: 2 },
+      { title: "Compress the hero images", status: "done", priority: "low", due: -3, assignee: 0 },
+    ],
+  },
+  {
+    name: "Mobile app beta",
+    description: "A TestFlight build for 50 customers, with crash reporting and a feedback form.",
+    status: "active",
+    tasks: [
+      { title: "Ship build 0.9 to TestFlight", status: "in_progress", priority: "urgent", due: 2, assignee: 3 },
+      { title: "Write the beta invite email", status: "in_review", priority: "medium", due: 3, assignee: 1 },
+      { title: "Add a notification settings screen", status: "todo", priority: "medium", due: 10, assignee: 2 },
+      { title: "Offline mode for the task list", status: "todo", priority: "high", due: 14, assignee: null },
+      { title: "Take the App Store screenshots", status: "todo", priority: "low", due: 18, assignee: 0 },
+      { title: "Add crash reporting", status: "done", priority: "high", due: -4, assignee: 3 },
+      { title: "Fix the login loop on Android 13", status: "done", priority: "urgent", due: -1, assignee: 0 },
+    ],
+  },
+  {
+    name: "Onboarding emails",
+    description: "A five-email sequence for new workspaces.",
+    status: "archived",
+    tasks: [
+      { title: "Draft the welcome email", status: "done", priority: "medium", due: -30, assignee: 1 },
+      { title: "Write the day-3 tips email", status: "done", priority: "low", due: -26, assignee: 2 },
+      { title: "Set up the send schedule", status: "done", priority: "medium", due: -24, assignee: 0 },
+    ],
+  },
+];
+
+export interface SampleMember {
+  userId: string;
+  name: string;
+}
+
+export interface PlannedProject {
+  name: string;
+  description: string;
+  status: "active" | "archived";
+  tasks: {
+    title: string;
+    status: TaskStatus;
+    priority: TaskPriority;
+    dueDate: string;
+    completedAt: string | null;
+    assigneeId: string | null;
+    assigneeName: string | null;
+  }[];
+}
+
+/**
+ * The rows to insert for `members` as of `now`. Pure, so tests/
+ * sample-workspace.test.ts checks dates and assignment without a server.
+ * Tasks are only assigned to people in `members`; with no members every
+ * task is unassigned.
+ */
+export function planSampleWorkspace(members: SampleMember[], now: Date): PlannedProject[] {
+  const day = (offset: number) => isoDay(new Date(now.getTime() + offset * 86_400_000));
+  return SAMPLE_PROJECTS.map((p) => ({
+    name: p.name,
+    description: p.description,
+    status: p.status,
+    tasks: p.tasks.map((t) => {
+      const who = t.assignee === null || members.length === 0 ? null : members[t.assignee % members.length];
+      return {
+        title: t.title,
+        status: t.status,
+        priority: t.priority,
+        dueDate: day(t.due),
+        completedAt: t.status === "done" ? `${day(Math.min(t.due, 0))}T16:00:00.000Z` : null,
+        assigneeId: who?.userId ?? null,
+        assigneeName: who?.name ?? null,
+      };
+    }),
+  }));
+}