create-crm-starter 0.1.0

package/template/extras/estimates-invoices/drizzle/src/app/api/stripe/webhook/route.ts

@@ -0,0 +1,87 @@
+import type { NextRequest } from 'next/server';
+import { NextResponse } from 'next/server';
+import type Stripe from 'stripe';
+import { stripe } from '@/lib/stripe';
+import { recordInvoicePayment } from '@/lib/invoices/actions';
+
+/**
+ * Stripe webhook endpoint with invoice reconciliation.
+ *
+ * This file is the estimates-invoices module's upgrade of the
+ * payments-stripe webhook stub: it dispatches checkout.session.completed
+ * events to the invoices.recordInvoicePayment server action so paid
+ * invoices automatically transition to 'paid' status with the payment row.
+ *
+ * Set STRIPE_WEBHOOK_SECRET in .env.local. For local dev:
+ *   stripe listen --forward-to localhost:3000/api/stripe/webhook
+ */
+export async function POST(req: NextRequest) {
+  const secret = process.env.STRIPE_WEBHOOK_SECRET;
+  if (!secret) {
+    return NextResponse.json({ error: 'STRIPE_WEBHOOK_SECRET not set' }, { status: 500 });
+  }
+
+  const signature = req.headers.get('stripe-signature');
+  if (!signature) {
+    return NextResponse.json({ error: 'Missing signature' }, { status: 400 });
+  }
+
+  const body = await req.text();
+  let event: Stripe.Event;
+  try {
+    event = stripe.webhooks.constructEvent(body, signature, secret);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : 'Signature verification failed';
+    return NextResponse.json({ error: message }, { status: 400 });
+  }
+
+  switch (event.type) {
+    case 'checkout.session.completed': {
+      const session = event.data.object as Stripe.Checkout.Session;
+      const invoiceId = session.metadata?.invoiceId;
+      const amount = session.amount_total;
+      const paymentIntentId =
+        typeof session.payment_intent === 'string' ? session.payment_intent : null;
+
+      if (invoiceId && amount && amount > 0) {
+        try {
+          await recordInvoicePayment({
+            invoiceId,
+            amount,
+            method: 'stripe',
+            stripeSessionId: session.id,
+            stripePaymentIntentId: paymentIntentId ?? undefined,
+            note: 'Stripe Checkout',
+          });
+          console.log(
+            `[stripe] reconciled invoice ${invoiceId} +${amount}¢ (session ${session.id})`,
+          );
+        } catch (err) {
+          console.error(`[stripe] failed to record payment for invoice ${invoiceId}:`, err);
+          // Return 500 so Stripe retries the webhook.
+          return NextResponse.json({ error: 'payment recording failed' }, { status: 500 });
+        }
+      } else {
+        // No invoiceId in metadata — likely a demo checkout or non-invoice
+        // payment. Log so we don't lose money silently.
+        console.log(
+          '[stripe] checkout.session.completed (no invoiceId metadata)',
+          session.id,
+          session.amount_total,
+          session.metadata,
+        );
+      }
+      break;
+    }
+    case 'payment_intent.succeeded':
+    case 'payment_intent.payment_failed':
+      // Stripe Checkout's session.completed event covers the success path;
+      // these are useful if you take payments via PaymentIntents directly.
+      break;
+    default:
+      // Acknowledge unhandled events so Stripe doesn't keep retrying them.
+      break;
+  }
+
+  return NextResponse.json({ received: true });
+}

package/template/extras/estimates-invoices/drizzle/src/app/i/[token]/page.tsx

@@ -0,0 +1,148 @@
+import { notFound } from 'next/navigation';
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
+import { Badge } from '@/components/ui/badge';
+import { business } from '@/lib/business';
+import { getInvoiceByPublicToken } from '@/lib/invoices/data';
+import { INVOICE_STATUS_LABEL, INVOICE_STATUS_VARIANT } from '@/lib/invoices/types';
+import { PublicPayButton } from '@/components/invoices/public-pay-button';
+import { formatCurrency, formatDate } from '@/lib/utils';
+
+interface PageProps { params: Promise<{ token: string }>; }
+
+export default async function PublicInvoicePage({ params }: PageProps) {
+  const { token } = await params;
+  const invoice = await getInvoiceByPublicToken(token);
+  if (!invoice) notFound();
+
+  const isPaid = invoice.amountDue <= 0;
+  const overdueDays =
+    invoice.dueDate && invoice.amountDue > 0 && new Date(invoice.dueDate) < new Date()
+      ? Math.floor((Date.now() - new Date(invoice.dueDate).getTime()) / 86_400_000)
+      : 0;
+
+  return (
+    <main className="bg-muted/30 min-h-screen">
+      <header className="bg-background border-border border-b">
+        <div className="mx-auto max-w-2xl px-6 py-6">
+          <div className="flex items-center gap-3">
+            {business.brand.logoSrc && (
+              // eslint-disable-next-line @next/next/no-img-element
+              <img src={business.brand.logoSrc} alt={business.name} className="h-10 w-auto" />
+            )}
+            <div>
+              <h1 className="text-xl font-bold">{business.name}</h1>
+              {business.phone && (
+                <p className="text-muted-foreground text-sm">
+                  Questions? <a href={`tel:${business.phone}`} className="hover:underline">{business.phone}</a>
+                </p>
+              )}
+            </div>
+          </div>
+        </div>
+      </header>
+      <div className="mx-auto max-w-2xl space-y-6 px-6 py-8">
+        <div className="flex items-center justify-between">
+          <div>
+            <p className="text-muted-foreground text-sm">Invoice</p>
+            <h2 className="font-mono text-2xl font-bold">{invoice.invoiceNumber}</h2>
+          </div>
+          <Badge variant={INVOICE_STATUS_VARIANT[invoice.status]} className="text-base">
+            {INVOICE_STATUS_LABEL[invoice.status]}
+          </Badge>
+        </div>
+
+        <Card>
+          <CardHeader className="flex flex-row items-center justify-between space-y-0 pb-3">
+            <CardTitle className="text-base">Amount due</CardTitle>
+            <span className="text-3xl font-bold">{formatCurrency(invoice.amountDue)}</span>
+          </CardHeader>
+          <CardContent className="pt-0">
+            <div className="text-muted-foreground text-sm">
+              of {formatCurrency(invoice.total)} total
+              {invoice.amountPaid > 0 && (
+                <span className="text-emerald-600 ml-2">
+                  · {formatCurrency(invoice.amountPaid)} paid
+                </span>
+              )}
+            </div>
+            {overdueDays > 0 && (
+              <div className="text-destructive mt-2 text-sm font-bold">
+                {overdueDays} day{overdueDays === 1 ? '' : 's'} overdue
+              </div>
+            )}
+            {invoice.dueDate && !isPaid && (
+              <div className="text-muted-foreground mt-2 text-xs">
+                Due {formatDate(invoice.dueDate)}
+              </div>
+            )}
+            {!isPaid && (
+              <div className="mt-4">
+                <PublicPayButton token={token} amountDue={invoice.amountDue} />
+              </div>
+            )}
+            {isPaid && (
+              <p className="text-emerald-600 mt-3 text-sm font-medium">✓ Thank you — this invoice is paid in full.</p>
+            )}
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardHeader><CardTitle>Line items</CardTitle></CardHeader>
+          <CardContent className="p-0">
+            <table className="w-full text-sm">
+              <thead className="text-muted-foreground bg-muted/50 text-xs uppercase">
+                <tr>
+                  <th className="px-4 py-3 text-left font-medium">Description</th>
+                  <th className="px-4 py-3 text-right font-medium">Qty</th>
+                  <th className="px-4 py-3 text-right font-medium">Unit price</th>
+                  <th className="px-4 py-3 text-right font-medium">Subtotal</th>
+                </tr>
+              </thead>
+              <tbody className="divide-border divide-y">
+                {invoice.lineItems.map((li, i) => (
+                  <tr key={i}>
+                    <td className="px-4 py-3">{li.description}</td>
+                    <td className="px-4 py-3 text-right">{li.qty}</td>
+                    <td className="px-4 py-3 text-right">{formatCurrency(li.unitPrice)}</td>
+                    <td className="px-4 py-3 text-right font-medium">{formatCurrency(li.qty * li.unitPrice)}</td>
+                  </tr>
+                ))}
+              </tbody>
+              <tfoot className="bg-muted/30">
+                <tr>
+                  <td colSpan={3} className="px-4 py-3 text-right text-muted-foreground">Total</td>
+                  <td className="px-4 py-3 text-right font-bold">{formatCurrency(invoice.total)}</td>
+                </tr>
+              </tfoot>
+            </table>
+          </CardContent>
+        </Card>
+
+        {invoice.payments.length > 0 && (
+          <Card>
+            <CardHeader><CardTitle>Payments</CardTitle></CardHeader>
+            <CardContent className="text-sm space-y-2">
+              {invoice.payments.map((p) => (
+                <div key={p.id} className="flex justify-between border-b pb-2 last:border-b-0">
+                  <span className="text-muted-foreground">{formatDate(p.recordedAt)} · {p.method}</span>
+                  <span className="font-medium">{formatCurrency(p.amount)}</span>
+                </div>
+              ))}
+            </CardContent>
+          </Card>
+        )}
+
+        {invoice.notes && (
+          <Card>
+            <CardHeader><CardTitle>Notes</CardTitle></CardHeader>
+            <CardContent className="text-sm whitespace-pre-wrap">{invoice.notes}</CardContent>
+          </Card>
+        )}
+
+        <footer className="text-muted-foreground py-4 text-center text-xs">
+          {business.legalName} · {business.address || ''}
+        </footer>
+      </div>
+    </main>
+  );
+}

package/template/extras/estimates-invoices/drizzle/src/components/estimates/convert-to-job-button.tsx

@@ -0,0 +1,18 @@
+'use client';
+
+import { useTransition } from 'react';
+import { Button } from '@/components/ui/button';
+import { convertEstimateToJob } from '@/lib/estimates/actions';
+
+export function ConvertToJobButton({ estimateId }: { estimateId: string }) {
+  const [pending, start] = useTransition();
+  return (
+    <Button
+      size="sm"
+      disabled={pending}
+      onClick={() => start(() => convertEstimateToJob(estimateId))}
+    >
+      {pending ? 'Converting...' : '→ Convert to job'}
+    </Button>
+  );
+}

package/template/extras/estimates-invoices/drizzle/src/components/estimates/new-estimate-form.tsx

@@ -0,0 +1,261 @@
+'use client';
+
+import { useMemo, useState, useTransition } from 'react';
+import Link from 'next/link';
+import { Button } from '@/components/ui/button';
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';
+import { Input } from '@/components/ui/input';
+import { Label } from '@/components/ui/label';
+import { createEstimate } from '@/lib/estimates/actions';
+import { ESTIMATE_STATUSES, ESTIMATE_STATUS_LABEL, type EstimateLineItem, type EstimateStatus } from '@/lib/estimates/types';
+import { PriceBookItemPicker } from '@/components/price-book/item-picker';
+import { formatCurrency } from '@/lib/utils';
+
+interface CustomerOption {
+  id: string;
+  name: string;
+}
+
+interface DraftLine extends EstimateLineItem {
+  key: string;
+}
+
+const NEW_LINE = (): DraftLine => ({
+  key: crypto.randomUUID(),
+  description: '',
+  qty: 1,
+  unitPrice: 0,
+  unitCost: 0,
+  taxable: true,
+});
+
+export function NewEstimateForm({ customers }: { customers: CustomerOption[] }) {
+  const [pending, start] = useTransition();
+  const [error, setError] = useState<string | null>(null);
+
+  const [customerId, setCustomerId] = useState(customers[0]?.id ?? '');
+  const [status, setStatus] = useState<EstimateStatus>('draft');
+  const [validUntil, setValidUntil] = useState(() => {
+    // 30 days from now, formatted as YYYY-MM-DD for <input type="date">
+    const d = new Date();
+    d.setDate(d.getDate() + 30);
+    return d.toISOString().slice(0, 10);
+  });
+  const [notes, setNotes] = useState('');
+  const [lines, setLines] = useState<DraftLine[]>([NEW_LINE()]);
+
+  const totals = useMemo(() => {
+    const subtotal = lines.reduce((acc, li) => acc + li.qty * li.unitPrice, 0);
+    const totalCost = lines.reduce((acc, li) => acc + li.qty * (li.unitCost ?? 0), 0);
+    const margin = subtotal - totalCost;
+    const marginPct = subtotal > 0 ? Math.round((margin / subtotal) * 100) : 0;
+    return { subtotal, totalCost, margin, marginPct };
+  }, [lines]);
+
+  function updateLine(key: string, patch: Partial<EstimateLineItem>) {
+    setLines((prev) => prev.map((li) => (li.key === key ? { ...li, ...patch } : li)));
+  }
+  function removeLine(key: string) {
+    setLines((prev) => (prev.length === 1 ? prev : prev.filter((li) => li.key !== key)));
+  }
+  function addLine() {
+    setLines((prev) => [...prev, NEW_LINE()]);
+  }
+
+  function handleSubmit(e: React.FormEvent) {
+    e.preventDefault();
+    setError(null);
+    if (!customerId) {
+      setError('Pick a customer (create one first if none exist).');
+      return;
+    }
+    start(() =>
+      createEstimate({
+        customerId,
+        status,
+        validUntil: validUntil ? new Date(validUntil + 'T23:59:59').toISOString() : null,
+        notes: notes || null,
+        lineItems: lines
+          .filter((li) => li.description.trim() !== '')
+          .map(({ key: _key, ...rest }) => rest),
+      }),
+    );
+  }
+
+  const marginColor =
+    totals.marginPct < 0
+      ? 'text-destructive'
+      : totals.marginPct < 25
+      ? 'text-yellow-600'
+      : 'text-emerald-600';
+
+  return (
+    <form onSubmit={handleSubmit} className="space-y-6">
+      <Card>
+        <CardHeader>
+          <CardTitle>Customer & options</CardTitle>
+          <CardDescription>Pick a customer and set the estimate-wide options.</CardDescription>
+        </CardHeader>
+        <CardContent className="space-y-4">
+          <div className="space-y-2">
+            <Label htmlFor="customerId">Customer *</Label>
+            {customers.length === 0 ? (
+              <p className="text-destructive text-sm">
+                No customers yet. <Link href="/customers/new" className="underline">Create one</Link> first.
+              </p>
+            ) : (
+              <select
+                id="customerId"
+                required
+                value={customerId}
+                onChange={(e) => setCustomerId(e.target.value)}
+                className="border-input bg-background h-10 w-full rounded-md border px-3 text-sm"
+              >
+                {customers.map((c) => (
+                  <option key={c.id} value={c.id}>{c.name}</option>
+                ))}
+              </select>
+            )}
+          </div>
+          <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">
+            <div className="space-y-2">
+              <Label htmlFor="status">Initial status</Label>
+              <select
+                id="status"
+                value={status}
+                onChange={(e) => setStatus(e.target.value as EstimateStatus)}
+                className="border-input bg-background h-10 w-full rounded-md border px-3 text-sm"
+              >
+                {ESTIMATE_STATUSES.filter((s) => !['converted', 'expired'].includes(s)).map((s) => (
+                  <option key={s} value={s}>{ESTIMATE_STATUS_LABEL[s]}</option>
+                ))}
+              </select>
+            </div>
+            <div className="space-y-2">
+              <Label htmlFor="validUntil">Valid until</Label>
+              <Input
+                id="validUntil"
+                type="date"
+                value={validUntil}
+                onChange={(e) => setValidUntil(e.target.value)}
+              />
+            </div>
+          </div>
+        </CardContent>
+      </Card>
+
+      <Card>
+        <CardHeader className="flex flex-row items-start justify-between space-y-0">
+          <div>
+            <CardTitle>Line items</CardTitle>
+            <CardDescription>
+              Prices + costs in cents. e.g. <code>12500</code> = $125.00.
+              Unit cost drives margin tracking — leave 0 to skip.
+            </CardDescription>
+          </div>
+          <div className="text-right">
+            <div className="text-muted-foreground text-xs uppercase">Total</div>
+            <div className="text-2xl font-bold">{formatCurrency(totals.subtotal)}</div>
+            <div className={`text-xs font-medium ${marginColor}`}>
+              Margin: {formatCurrency(totals.margin)} ({totals.marginPct}%)
+            </div>
+          </div>
+        </CardHeader>
+        <CardContent className="space-y-3">
+          {lines.map((li) => (
+            <div key={li.key} className="grid grid-cols-[1fr_3.5rem_5.5rem_5.5rem_2.5rem] items-end gap-2">
+              <div className="space-y-1">
+                <Label htmlFor={`desc-${li.key}`} className="text-xs">Description</Label>
+                <PriceBookItemPicker
+                  id={`desc-${li.key}`}
+                  value={li.description}
+                  onTextChange={(v) => updateLine(li.key, { description: v })}
+                  onPick={(item) =>
+                    updateLine(li.key, {
+                      description: item.name,
+                      qty: item.defaultQty,
+                      unitPrice: item.unitPrice,
+                      unitCost: item.unitCost,
+                      taxable: item.taxable,
+                    })
+                  }
+                  placeholder="Search Price Book or type free-text…"
+                />
+              </div>
+              <div className="space-y-1">
+                <Label htmlFor={`qty-${li.key}`} className="text-xs">Qty</Label>
+                <Input
+                  id={`qty-${li.key}`}
+                  type="number"
+                  min={0}
+                  step={1}
+                  value={li.qty}
+                  onChange={(e) => updateLine(li.key, { qty: Number(e.target.value) || 0 })}
+                />
+              </div>
+              <div className="space-y-1">
+                <Label htmlFor={`cost-${li.key}`} className="text-xs">Unit cost (¢)</Label>
+                <Input
+                  id={`cost-${li.key}`}
+                  type="number"
+                  min={0}
+                  step={1}
+                  value={li.unitCost ?? 0}
+                  onChange={(e) => updateLine(li.key, { unitCost: Number(e.target.value) || 0 })}
+                />
+              </div>
+              <div className="space-y-1">
+                <Label htmlFor={`price-${li.key}`} className="text-xs">Unit price (¢)</Label>
+                <Input
+                  id={`price-${li.key}`}
+                  type="number"
+                  min={0}
+                  step={1}
+                  value={li.unitPrice}
+                  onChange={(e) => updateLine(li.key, { unitPrice: Number(e.target.value) || 0 })}
+                />
+              </div>
+              <Button
+                type="button"
+                variant="ghost"
+                size="icon"
+                onClick={() => removeLine(li.key)}
+                disabled={lines.length === 1}
+                aria-label="Remove line"
+              >
+                ✕
+              </Button>
+            </div>
+          ))}
+          <Button type="button" variant="outline" size="sm" onClick={addLine}>
+            + Add line item
+          </Button>
+        </CardContent>
+      </Card>
+
+      <Card>
+        <CardHeader><CardTitle>Customer-facing notes</CardTitle></CardHeader>
+        <CardContent>
+          <textarea
+            rows={3}
+            value={notes}
+            onChange={(e) => setNotes(e.target.value)}
+            placeholder="Anything the customer should see — scope, exclusions, warranty terms..."
+            className="border-input bg-background focus-visible:ring-ring flex w-full rounded-md border px-3 py-2 text-sm focus-visible:outline-none focus-visible:ring-2"
+          />
+        </CardContent>
+      </Card>
+
+      {error && <p className="text-destructive text-sm">{error}</p>}
+
+      <div className="flex justify-end gap-3">
+        <Button type="button" variant="outline" asChild>
+          <Link href="/estimates">Cancel</Link>
+        </Button>
+        <Button type="submit" disabled={pending || customers.length === 0}>
+          {pending ? 'Creating...' : 'Create estimate'}
+        </Button>
+      </div>
+    </form>
+  );
+}

package/template/extras/estimates-invoices/drizzle/src/components/invoices/pay-invoice-button.tsx

@@ -0,0 +1,19 @@
+'use client';
+
+import { useTransition } from 'react';
+import { Button } from '@/components/ui/button';
+import { createCheckoutForInvoice } from '@/lib/invoices/actions';
+import { formatCurrency } from '@/lib/utils';
+
+export function PayInvoiceButton({ invoiceId, amountDue }: { invoiceId: string; amountDue: number }) {
+  const [pending, start] = useTransition();
+  return (
+    <Button
+      size="sm"
+      disabled={pending || amountDue <= 0}
+      onClick={() => start(() => createCheckoutForInvoice(invoiceId))}
+    >
+      {pending ? 'Redirecting...' : `Pay ${formatCurrency(amountDue)}`}
+    </Button>
+  );
+}

package/template/extras/estimates-invoices/drizzle/src/components/invoices/public-pay-button.tsx

@@ -0,0 +1,20 @@
+'use client';
+
+import { useTransition } from 'react';
+import { Button } from '@/components/ui/button';
+import { payByPublicToken } from '@/lib/invoices/actions';
+import { formatCurrency } from '@/lib/utils';
+
+export function PublicPayButton({ token, amountDue }: { token: string; amountDue: number }) {
+  const [pending, start] = useTransition();
+  return (
+    <Button
+      size="lg"
+      className="w-full"
+      disabled={pending || amountDue <= 0}
+      onClick={() => start(() => payByPublicToken(token))}
+    >
+      {pending ? 'Redirecting to Stripe...' : `Pay ${formatCurrency(amountDue)}`}
+    </Button>
+  );
+}

package/template/extras/estimates-invoices/drizzle/src/components/invoices/send-invoice-email-button.tsx

@@ -0,0 +1,37 @@
+'use client';
+
+import { useState, useTransition } from 'react';
+import { Button } from '@/components/ui/button';
+import { sendInvoiceEmail } from '@/lib/invoices/email-actions';
+
+export function SendInvoiceEmailButton({ invoiceId }: { invoiceId: string }) {
+  const [pending, start] = useTransition();
+  const [status, setStatus] = useState<'idle' | 'sent' | 'error'>('idle');
+  const [errorMsg, setErrorMsg] = useState<string | null>(null);
+
+  return (
+    <div className="flex flex-col items-end gap-1">
+      <Button
+        size="sm"
+        variant="outline"
+        disabled={pending}
+        onClick={() =>
+          start(async () => {
+            setStatus('idle');
+            setErrorMsg(null);
+            try {
+              await sendInvoiceEmail(invoiceId);
+              setStatus('sent');
+            } catch (err) {
+              setStatus('error');
+              setErrorMsg((err as Error).message);
+            }
+          })
+        }
+      >
+        {pending ? 'Sending…' : status === 'sent' ? '✓ Email sent' : 'Email invoice'}
+      </Button>
+      {errorMsg && <p className="text-destructive text-xs max-w-xs text-right">{errorMsg}</p>}
+    </div>
+  );
+}

package/template/extras/estimates-invoices/drizzle/src/components/jobs/generate-invoice-button.tsx

@@ -0,0 +1,23 @@
+'use client';
+
+import { useTransition } from 'react';
+import { Button } from '@/components/ui/button';
+import { createInvoiceFromJob } from '@/lib/invoices/actions';
+
+/**
+ * Renders only when the job is in a finishable state. Server action
+ * generates an invoice from the job's line items and redirects to it.
+ */
+export function GenerateInvoiceButton({ jobId }: { jobId: string }) {
+  const [pending, start] = useTransition();
+  return (
+    <Button
+      size="sm"
+      variant="outline"
+      disabled={pending}
+      onClick={() => start(() => createInvoiceFromJob({ jobId }))}
+    >
+      {pending ? 'Generating...' : 'Generate invoice'}
+    </Button>
+  );
+}

package/template/extras/estimates-invoices/drizzle/src/db/schema/estimates.ts

@@ -0,0 +1,41 @@
+import { integer, jsonb, pgEnum, pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core';
+import { customers } from './customers';
+
+export const estimateStatus = pgEnum('estimate_status', [
+  'draft', 'sent', 'viewed', 'approved', 'declined', 'expired', 'converted',
+]);
+
+interface LineItemJson {
+  description: string;
+  qty: number;
+  unitPrice: number;  // cents
+  unitCost?: number;  // cents (for margin)
+  taxable?: boolean;
+}
+
+export const estimates = pgTable('estimates', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  customerId: uuid('customer_id').notNull().references(() => customers.id, { onDelete: 'restrict' }),
+  status: estimateStatus('status').notNull().default('draft'),
+  lineItems: jsonb('line_items').$type<LineItemJson[]>().notNull().default([]),
+  subtotal: integer('subtotal').notNull().default(0),  // cents
+  total: integer('total').notNull().default(0),         // cents (subtotal +/- adjustments)
+  totalCost: integer('total_cost').notNull().default(0), // cents
+  notes: text('notes'),
+  validUntil: timestamp('valid_until'),
+  sentAt: timestamp('sent_at'),
+  approvedAt: timestamp('approved_at'),
+  /** Customer-typed full name captured at approval as legal acknowledgment. */
+  approvedSignerName: text('approved_signer_name'),
+  /** Drawn signature as data: URL (PNG). For real production, swap to R2 storage. */
+  approvedSignatureDataUrl: text('approved_signature_data_url'),
+  /** Optional decline reason supplied by the customer. */
+  declinedReason: text('declined_reason'),
+  declinedAt: timestamp('declined_at'),
+  convertedJobId: uuid('converted_job_id'),
+  createdAt: timestamp('created_at').notNull().defaultNow(),
+  updatedAt: timestamp('updated_at').notNull().defaultNow(),
+});
+
+export type EstimateRow = typeof estimates.$inferSelect;
+export type NewEstimate = typeof estimates.$inferInsert;