@pylonsync/create-pylon 0.3.344 → 0.3.345

package/templates/helpdesk/components/kbd.tsx

@@ -0,0 +1,23 @@
+import React from "react";
+import { cn } from "@/lib/utils";
+
+/** A keyboard hint. Present in the UI because the shortcuts are real. */
+export function Kbd({
+  children,
+  className,
+}: {
+  children: React.ReactNode;
+  className?: string;
+}) {
+  return (
+    <kbd
+      className={cn(
+        "inline-flex h-5 min-w-5 items-center justify-center rounded border border-border bg-surface-2 px-1.5",
+        "font-sans text-[10px] font-medium text-muted-foreground",
+        className,
+      )}
+    >
+      {children}
+    </kbd>
+  );
+}

package/templates/helpdesk/components/new-ticket-dialog.tsx

@@ -0,0 +1,147 @@
+import React, { useEffect, useState } from "react";
+import {
+  Dialog,
+  DialogContent,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Select } from "@/components/ui/select";
+import { Textarea } from "@/components/ui/textarea";
+import { PRIORITIES } from "@/lib/tickets";
+
+export interface TicketDraft {
+  subject: string;
+  body: string;
+  customerId: string;
+  priority: string;
+}
+
+/**
+ * Open a ticket on a customer's behalf — the "log a phone call" path. The body
+ * is required as well as the subject: a ticket whose thread starts empty tells
+ * the next agent nothing about what was actually reported.
+ */
+export function NewTicketDialog({
+  open,
+  customers,
+  onOpenChange,
+  onCreate,
+}: {
+  open: boolean;
+  customers: Array<{ id: string; name: string }>;
+  onOpenChange: (open: boolean) => void;
+  onCreate: (draft: TicketDraft) => void | Promise<void>;
+}) {
+  const [subject, setSubject] = useState("");
+  const [body, setBody] = useState("");
+  const [customerId, setCustomerId] = useState("");
+  const [priority, setPriority] = useState("normal");
+  const [busy, setBusy] = useState(false);
+
+  useEffect(() => {
+    if (!open) return;
+    setSubject("");
+    setBody("");
+    setCustomerId("");
+    setPriority("normal");
+    setBusy(false);
+  }, [open]);
+
+  const canSubmit = subject.trim().length > 0 && body.trim().length > 0 && !busy;
+
+  async function submit(event: React.FormEvent) {
+    event.preventDefault();
+    if (!canSubmit) return;
+    setBusy(true);
+    try {
+      await onCreate({
+        subject: subject.trim(),
+        body: body.trim(),
+        customerId,
+        priority,
+      });
+      onOpenChange(false);
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent>
+        <DialogHeader>
+          <DialogTitle>New ticket</DialogTitle>
+        </DialogHeader>
+        <form onSubmit={submit} className="grid gap-4">
+          <div className="space-y-1.5">
+            <Label htmlFor="ticket-subject">Subject</Label>
+            <Input
+              id="ticket-subject"
+              autoFocus
+              value={subject}
+              placeholder="Export is timing out on large date ranges"
+              onChange={(event) => setSubject(event.target.value)}
+            />
+          </div>
+
+          <div className="grid grid-cols-2 gap-3">
+            <div className="space-y-1.5">
+              <Label htmlFor="ticket-customer">Customer</Label>
+              <Select
+                id="ticket-customer"
+                value={customerId}
+                onChange={(event) => setCustomerId(event.target.value)}
+              >
+                <option value="">—</option>
+                {customers.map((customer) => (
+                  <option key={customer.id} value={customer.id}>
+                    {customer.name}
+                  </option>
+                ))}
+              </Select>
+            </div>
+            <div className="space-y-1.5">
+              <Label htmlFor="ticket-priority">Priority</Label>
+              <Select
+                id="ticket-priority"
+                value={priority}
+                onChange={(event) => setPriority(event.target.value)}
+              >
+                {PRIORITIES.map((p) => (
+                  <option key={p.id} value={p.id}>
+                    {p.label}
+                  </option>
+                ))}
+              </Select>
+            </div>
+          </div>
+
+          <div className="space-y-1.5">
+            <Label htmlFor="ticket-body">What did they report?</Label>
+            <Textarea
+              id="ticket-body"
+              rows={4}
+              value={body}
+              placeholder="Pulling a 90-day export spins and eventually errors…"
+              onChange={(event) => setBody(event.target.value)}
+              className="resize-none"
+            />
+          </div>
+
+          <DialogFooter>
+            <Button type="button" variant="ghost" onClick={() => onOpenChange(false)}>
+              Cancel
+            </Button>
+            <Button type="submit" disabled={!canSubmit}>
+              {busy ? "Creating…" : "Create ticket"}
+            </Button>
+          </DialogFooter>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}

package/templates/helpdesk/components/page-header.tsx

@@ -0,0 +1,36 @@
+import React from "react";
+import { cn } from "@/lib/utils";
+
+/**
+ * The bar at the top of every view: title on the left, actions on the right.
+ * Fixed height so switching pages doesn't shift the content below it.
+ */
+export function PageHeader({
+  title,
+  count,
+  children,
+  className,
+}: {
+  title: string;
+  /** Shown beside the title — the number of rows in view. */
+  count?: number;
+  children?: React.ReactNode;
+  className?: string;
+}) {
+  return (
+    <header
+      className={cn(
+        "flex h-12 shrink-0 items-center justify-between gap-3 border-b border-border px-4",
+        className,
+      )}
+    >
+      <div className="flex min-w-0 items-baseline gap-2">
+        <h1 className="truncate text-[13px] font-semibold">{title}</h1>
+        {typeof count === "number" ? (
+          <span className="tabular text-[12px] text-muted-foreground">{count}</span>
+        ) : null}
+      </div>
+      <div className="flex items-center gap-2">{children}</div>
+    </header>
+  );
+}

package/templates/helpdesk/components/priority-badge.tsx

@@ -0,0 +1,61 @@
+import React from "react";
+import { cn } from "@/lib/utils";
+import { priorityById, statusById } from "@/lib/tickets";
+
+const PRIORITY_DOT: Record<string, string> = {
+  urgent: "bg-stage-lost",
+  high: "bg-stage-proposal",
+  normal: "bg-stage-qualified",
+  low: "bg-stage-lead",
+};
+
+/** Priority as a dot plus a label — readable in a dense row without a chip. */
+export function PriorityBadge({
+  priority,
+  className,
+}: {
+  priority: string;
+  className?: string;
+}) {
+  const meta = priorityById(priority);
+  return (
+    <span className={cn("inline-flex items-center gap-1.5 whitespace-nowrap", className)}>
+      <span
+        className={cn(
+          "size-1.5 shrink-0 rounded-full",
+          PRIORITY_DOT[priority] ?? "bg-muted-foreground",
+        )}
+      />
+      <span className="text-muted-foreground">{meta?.label ?? priority}</span>
+    </span>
+  );
+}
+
+const STATUS_STYLE: Record<string, string> = {
+  open: "border-stage-qualified/40 text-stage-qualified",
+  pending: "border-stage-proposal/40 text-stage-proposal",
+  solved: "border-stage-won/40 text-stage-won",
+  closed: "border-border text-muted-foreground",
+};
+
+/** Status as an outlined chip — it's the field agents filter on most. */
+export function StatusBadge({
+  status,
+  className,
+}: {
+  status: string;
+  className?: string;
+}) {
+  const meta = statusById(status);
+  return (
+    <span
+      className={cn(
+        "inline-flex h-5 items-center rounded border px-1.5 text-[11px] font-medium whitespace-nowrap",
+        STATUS_STYLE[status] ?? "border-border text-muted-foreground",
+        className,
+      )}
+    >
+      {meta?.label ?? status}
+    </span>
+  );
+}

package/templates/helpdesk/components/record-dialog.tsx

@@ -0,0 +1,126 @@
+import React, { useEffect, useState } from "react";
+import {
+  Dialog,
+  DialogContent,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Select } from "@/components/ui/select";
+
+export interface FieldSpec {
+  name: string;
+  label: string;
+  type?: "text" | "email" | "tel";
+  placeholder?: string;
+  required?: boolean;
+  /** Renders a picker instead of a text input. */
+  options?: Array<{ value: string; label: string }>;
+}
+
+/**
+ * A create dialog driven by a field list — used for companies and contacts,
+ * which differ only in their fields. Deals get their own dialog because value,
+ * stage and close date need real layout rather than a stack of text inputs.
+ */
+export function RecordDialog({
+  open,
+  title,
+  fields,
+  submitLabel,
+  onOpenChange,
+  onCreate,
+}: {
+  open: boolean;
+  title: string;
+  fields: FieldSpec[];
+  submitLabel: string;
+  onOpenChange: (open: boolean) => void;
+  onCreate: (values: Record<string, string>) => void | Promise<void>;
+}) {
+  const [values, setValues] = useState<Record<string, string>>({});
+  const [busy, setBusy] = useState(false);
+
+  useEffect(() => {
+    if (!open) return;
+    setValues({});
+    setBusy(false);
+  }, [open]);
+
+  const missing = fields.some(
+    (field) => field.required && !(values[field.name] ?? "").trim(),
+  );
+  const canSubmit = !missing && !busy;
+
+  async function submit(event: React.FormEvent) {
+    event.preventDefault();
+    if (!canSubmit) return;
+    setBusy(true);
+    try {
+      const trimmed: Record<string, string> = {};
+      for (const [key, value] of Object.entries(values)) {
+        const clean = value.trim();
+        if (clean) trimmed[key] = clean;
+      }
+      await onCreate(trimmed);
+      onOpenChange(false);
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent>
+        <DialogHeader>
+          <DialogTitle>{title}</DialogTitle>
+        </DialogHeader>
+        <form onSubmit={submit} className="grid gap-4">
+          {fields.map((field, index) => (
+            <div key={field.name} className="space-y-1.5">
+              <Label htmlFor={`record-${field.name}`}>{field.label}</Label>
+              {field.options ? (
+                <Select
+                  id={`record-${field.name}`}
+                  value={values[field.name] ?? ""}
+                  onChange={(event) =>
+                    setValues((v) => ({ ...v, [field.name]: event.target.value }))
+                  }
+                >
+                  <option value="">—</option>
+                  {field.options.map((option) => (
+                    <option key={option.value} value={option.value}>
+                      {option.label}
+                    </option>
+                  ))}
+                </Select>
+              ) : (
+                <Input
+                  id={`record-${field.name}`}
+                  autoFocus={index === 0}
+                  type={field.type ?? "text"}
+                  placeholder={field.placeholder}
+                  value={values[field.name] ?? ""}
+                  onChange={(event) =>
+                    setValues((v) => ({ ...v, [field.name]: event.target.value }))
+                  }
+                />
+              )}
+            </div>
+          ))}
+          <DialogFooter>
+            <Button type="button" variant="ghost" onClick={() => onOpenChange(false)}>
+              Cancel
+            </Button>
+            <Button type="submit" disabled={!canSubmit}>
+              {busy ? "Saving…" : submitLabel}
+            </Button>
+          </DialogFooter>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}

package/templates/helpdesk/components/sidebar.tsx

@@ -0,0 +1,111 @@
+import React from "react";
+import { Link } from "@pylonsync/react";
+import { Command, Inbox, LogOut, Users } from "lucide-react";
+import { cn } from "@/lib/utils";
+import { Avatar } from "@/components/avatar";
+import { Kbd } from "@/components/kbd";
+
+export interface NavItem {
+  href: string;
+  label: string;
+  icon: React.ReactNode;
+  count?: number;
+}
+
+export const NAV: Array<Omit<NavItem, "count">> = [
+  { href: "/", label: "Inbox", icon: <Inbox /> },
+  { href: "/customers", label: "Customers", icon: <Users /> },
+];
+
+/**
+ * The fixed left rail. Presentational: the active path, the counts, and the
+ * sign-out handler all arrive as props, so it renders identically in a test.
+ */
+export function Sidebar({
+  workspace,
+  email,
+  pathname,
+  counts,
+  onOpenCommand,
+  onSignOut,
+}: {
+  workspace: string;
+  email: string;
+  pathname: string;
+  counts?: Record<string, number>;
+  onOpenCommand: () => void;
+  onSignOut: () => void;
+}) {
+  return (
+    <aside className="flex w-[224px] shrink-0 flex-col border-r border-border bg-surface-1">
+      <div className="flex h-12 items-center gap-2 px-3">
+        <span className="flex size-6 shrink-0 items-center justify-center rounded-md bg-primary text-[11px] font-bold text-primary-foreground">
+          {workspace.slice(0, 1).toUpperCase()}
+        </span>
+        <span className="truncate text-[13px] font-semibold">{workspace}</span>
+      </div>
+
+      <div className="px-2 pb-2">
+        <button
+          type="button"
+          onClick={onOpenCommand}
+          className={cn(
+            "flex w-full items-center gap-2 rounded-md border border-border bg-background px-2 py-1.5",
+            "text-[12px] text-muted-foreground transition-colors hover:border-ring/40 hover:text-foreground",
+          )}
+        >
+          <Command className="size-3.5" />
+          <span className="flex-1 text-left">Search…</span>
+          <Kbd>⌘K</Kbd>
+        </button>
+      </div>
+
+      <nav className="flex-1 space-y-0.5 px-2" aria-label="Main">
+        {NAV.map((item) => {
+          const active =
+            item.href === "/" ? pathname === "/" : pathname.startsWith(item.href);
+          return (
+            <Link
+              key={item.href}
+              href={item.href}
+              aria-current={active ? "page" : undefined}
+              className={cn(
+                "flex h-7 items-center gap-2 rounded-md px-2 text-[13px] transition-colors",
+                "[&_svg]:size-3.5 [&_svg]:shrink-0",
+                active
+                  ? "bg-surface-2 font-medium text-foreground"
+                  : "text-muted-foreground hover:bg-surface-2/60 hover:text-foreground",
+              )}
+            >
+              {item.icon}
+              <span className="flex-1 truncate">{item.label}</span>
+              {counts?.[item.href] ? (
+                <span className="tabular text-[11px] text-muted-foreground">
+                  {counts[item.href]}
+                </span>
+              ) : null}
+            </Link>
+          );
+        })}
+      </nav>
+
+      <div className="border-t border-border p-2">
+        <div className="flex items-center gap-2 rounded-md px-1.5 py-1">
+          <Avatar name={email} size="sm" />
+          <span className="min-w-0 flex-1 truncate text-[12px] text-muted-foreground">
+            {email}
+          </span>
+          <button
+            type="button"
+            onClick={onSignOut}
+            title="Sign out"
+            aria-label="Sign out"
+            className="rounded p-1 text-muted-foreground transition-colors hover:bg-surface-2 hover:text-foreground"
+          >
+            <LogOut className="size-3.5" />
+          </button>
+        </div>
+      </div>
+    </aside>
+  );
+}

package/templates/helpdesk/components/sla-indicator.tsx

@@ -0,0 +1,47 @@
+import React from "react";
+import { cn } from "@/lib/utils";
+import { duration } from "@/lib/format";
+import { minutesToBreach, slaState, type Ticket } from "@/lib/tickets";
+
+/**
+ * How long is left to reply, or how long we're already late.
+ *
+ * Renders nothing once a ticket has been answered or closed — a queue where
+ * every row carries a badge is a queue where none of them mean anything.
+ */
+export function SlaIndicator({
+  ticket,
+  now,
+  className,
+}: {
+  ticket: Ticket;
+  /** Injectable so the value is deterministic in a test. */
+  now?: number;
+  className?: string;
+}) {
+  const state = slaState(ticket, now);
+  if (state === "none" || state === "met") return null;
+
+  const minutes = minutesToBreach(ticket, now);
+  if (minutes === null) return null;
+
+  const breached = state === "breached";
+  return (
+    <span
+      title={breached ? "First response overdue" : "First response due"}
+      className={cn(
+        "tabular inline-flex items-center gap-1 text-[11px] whitespace-nowrap",
+        breached ? "text-destructive" : "text-muted-foreground",
+        className,
+      )}
+    >
+      <span
+        className={cn(
+          "size-1.5 rounded-full",
+          breached ? "bg-destructive" : "bg-muted-foreground/60",
+        )}
+      />
+      {breached ? `${duration(minutes)} over` : `${duration(minutes)} left`}
+    </span>
+  );
+}

package/templates/helpdesk/components/thread.tsx

@@ -0,0 +1,143 @@
+import React, { useState } from "react";
+import { Lock } from "lucide-react";
+import { cn } from "@/lib/utils";
+import { Avatar } from "@/components/avatar";
+import { Button } from "@/components/ui/button";
+import { Textarea } from "@/components/ui/textarea";
+import { relativeTime } from "@/lib/format";
+
+export interface MessageRow {
+  id: string;
+  body: string;
+  fromCustomer?: boolean | null;
+  internal?: boolean | null;
+  authorId?: string | null;
+  createdAt?: string | null;
+}
+
+/**
+ * The conversation, oldest first, with the reply box pinned at the bottom.
+ *
+ * Internal notes are visually distinct because sending one to the customer by
+ * mistake is the expensive error in a helpdesk — the composer says which mode
+ * it's in, and the note keeps that marking in the thread forever.
+ */
+export function Thread({
+  messages,
+  authorName,
+  customerName,
+  now,
+  onSend,
+}: {
+  messages: MessageRow[];
+  authorName: (id: string | null | undefined) => string | null;
+  customerName: string | null;
+  now?: number;
+  onSend: (body: string, internal: boolean) => void | Promise<void>;
+}) {
+  const [body, setBody] = useState("");
+  const [internal, setInternal] = useState(false);
+  const [busy, setBusy] = useState(false);
+
+  const ordered = [...messages].sort((a, b) =>
+    (a.createdAt ?? "").localeCompare(b.createdAt ?? ""),
+  );
+
+  async function submit(event: React.FormEvent) {
+    event.preventDefault();
+    const text = body.trim();
+    if (!text || busy) return;
+    setBusy(true);
+    try {
+      await onSend(text, internal);
+      setBody("");
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  return (
+    <div className="flex min-h-0 flex-1 flex-col">
+      <div className="min-h-0 flex-1 space-y-4 overflow-y-auto px-6 py-5">
+        {ordered.length === 0 ? (
+          <p className="py-8 text-center text-[12px] text-muted-foreground">
+            No messages on this ticket yet.
+          </p>
+        ) : (
+          ordered.map((message) => {
+            const who = message.fromCustomer
+              ? customerName
+              : authorName(message.authorId);
+            return (
+              <article
+                key={message.id}
+                className={cn(
+                  "rounded-lg border p-3",
+                  message.internal
+                    ? "border-stage-proposal/30 bg-stage-proposal/5"
+                    : message.fromCustomer
+                      ? "border-border bg-surface-1"
+                      : "border-border bg-card",
+                )}
+              >
+                <div className="mb-1.5 flex items-center gap-2 text-[11px] text-muted-foreground">
+                  <Avatar name={who ?? "?"} size="sm" />
+                  <span className="font-medium text-foreground">{who ?? "Unknown"}</span>
+                  {message.internal ? (
+                    <span className="inline-flex items-center gap-1 text-stage-proposal">
+                      <Lock className="size-3" />
+                      Internal note
+                    </span>
+                  ) : null}
+                  <time
+                    className="ml-auto"
+                    dateTime={message.createdAt ?? undefined}
+                  >
+                    {relativeTime(message.createdAt, now)}
+                  </time>
+                </div>
+                <p className="whitespace-pre-wrap text-[13px] leading-6">
+                  {message.body}
+                </p>
+              </article>
+            );
+          })
+        )}
+      </div>
+
+      <form
+        onSubmit={submit}
+        className={cn(
+          "shrink-0 border-t p-3 transition-colors",
+          internal ? "border-stage-proposal/40 bg-stage-proposal/5" : "border-border",
+        )}
+      >
+        <Textarea
+          value={body}
+          rows={3}
+          placeholder={internal ? "Internal note — the customer won't see this…" : "Reply to the customer…"}
+          aria-label={internal ? "Internal note" : "Reply"}
+          onChange={(event) => setBody(event.target.value)}
+          onKeyDown={(event) => {
+            if (event.key === "Enter" && (event.metaKey || event.ctrlKey)) submit(event);
+          }}
+          className="min-h-20 resize-none"
+        />
+        <div className="mt-2 flex items-center justify-between gap-2">
+          <label className="flex items-center gap-2 text-[12px] text-muted-foreground">
+            <input
+              type="checkbox"
+              checked={internal}
+              onChange={(event) => setInternal(event.target.checked)}
+              className="size-3.5 accent-[var(--stage-proposal)]"
+            />
+            Internal note
+          </label>
+          <Button type="submit" size="sm" disabled={!body.trim() || busy}>
+            {busy ? "Sending…" : internal ? "Add note" : "Send reply"}
+          </Button>
+        </div>
+      </form>
+    </div>
+  );
+}