Fix all TypeScript errors: restore proper types and typed route casts

- Restore `as any` casts for Next.js typedRoutes on dynamic routes
- Use proper types for PDF templates, invoice/expense data, DB schema
- Fix PgColumn casts in sort helpers for expenses/invoices
- Add null guards for optional port/client in record-export
- Fix vitest config (remove invalid poolOptions)
- Lint: 0 errors, TypeScript: 0 errors

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

src/lib/db/schema/system.ts

@@ -28,7 +28,8 @@ export const auditLogs = pgTable(
     userAgent: text('user_agent'),
     revertedBy: text('reverted_by'), // user ID if this change was reverted
     revertedAt: timestamp('reverted_at', { withTimezone: true }),
-    revertOf: text('revert_of').references((): ReturnType<typeof text> => auditLogs.id),
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    revertOf: text('revert_of').references((): any => auditLogs.id),
     metadata: jsonb('metadata').default({}),
     createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
   },

src/lib/pdf/templates/berth-spec-template.ts

@@ -99,7 +99,7 @@ export function buildBerthSpecInputs(
       : 'No maintenance records';
 
   return {
-    portName: port?.name ?? 'Port Nimara',
+    portName: (port?.name as string) ?? 'Port Nimara',
     title: `Berth Specification — Mooring ${berth.mooringNumber}`,
     berthInfo,
     dimensions,

src/lib/pdf/templates/client-summary-template.ts

@@ -29,7 +29,7 @@ export function buildClientSummaryInputs(
     client.nationality ? `Nationality: ${client.nationality}` : null,
     client.source ? `Source: ${client.source}` : null,
     client.isProxy ? `Proxy: Yes${client.proxyType ? ` (${client.proxyType})` : ''}` : null,
-    `Added: ${new Date(client.createdAt).toLocaleDateString('en-GB')}`,
+    `Added: ${new Date(client.createdAt as string | Date).toLocaleDateString('en-GB')}`,
   ]
     .filter(Boolean)
     .join('\n');
@@ -38,7 +38,7 @@ export function buildClientSummaryInputs(
     ? contacts
         .map(
           (c) =>
-            `${c.channel.charAt(0).toUpperCase() + c.channel.slice(1)}${c.isPrimary ? ' (primary)' : ''}: ${c.value}${c.label ? ` [${c.label}]` : ''}`,
+            `${(c.channel as string).charAt(0).toUpperCase() + (c.channel as string).slice(1)}${c.isPrimary ? ' (primary)' : ''}: ${c.value}${c.label ? ` [${c.label}]` : ''}`,
         )
         .join('\n')
     : 'No contacts on file';
@@ -64,7 +64,7 @@ export function buildClientSummaryInputs(
       ? interestList
           .map(
             (i) =>
-              `• ${i.pipelineStage ?? 'open'}${i.berthMooringNumber ? ` — Berth ${i.berthMooringNumber}` : ''}${i.leadCategory ? ` [${i.leadCategory}]` : ''}  (${new Date(i.createdAt).toLocaleDateString('en-GB')})`,
+              `• ${i.pipelineStage ?? 'open'}${i.berthMooringNumber ? ` — Berth ${i.berthMooringNumber}` : ''}${i.leadCategory ? ` [${i.leadCategory}]` : ''}  (${new Date(i.createdAt as string | Date).toLocaleDateString('en-GB')})`,
           )
           .join('\n')
       : 'No pipeline interests on file';
@@ -74,13 +74,13 @@ export function buildClientSummaryInputs(
       ? activity
           .map(
             (a) =>
-              `${new Date(a.createdAt).toLocaleDateString('en-GB')}  ${a.action}  ${a.entityType}${a.fieldChanged ? `  (${a.fieldChanged})` : ''}`,
+              `${new Date(a.createdAt as string | Date).toLocaleDateString('en-GB')}  ${a.action}  ${a.entityType}${a.fieldChanged ? `  (${a.fieldChanged})` : ''}`,
           )
           .join('\n')
       : 'No recent activity';
 
   return {
-    portName: port?.name ?? 'Port Nimara',
+    portName: (port?.name as string) ?? 'Port Nimara',
     title: `Client Summary — ${client.fullName ?? ''}`,
     clientInfo,
     contacts: contactsText,

src/lib/pdf/templates/interest-summary-template.ts

@@ -64,13 +64,13 @@ export function buildInterestSummaryInputs(
     .join('  |  ');
 
   const milestones = [
-    `First contact: ${formatDate(interest.dateFirstContact)}`,
-    `Last contact: ${formatDate(interest.dateLastContact)}`,
-    `EOI sent: ${formatDate(interest.dateEoiSent)}`,
-    `EOI signed: ${formatDate(interest.dateEoiSigned)}`,
-    `Contract sent: ${formatDate(interest.dateContractSent)}`,
-    `Contract signed: ${formatDate(interest.dateContractSigned)}`,
-    `Deposit received: ${formatDate(interest.dateDepositReceived)}`,
+    `First contact: ${formatDate(interest.dateFirstContact as Date | string | null | undefined)}`,
+    `Last contact: ${formatDate(interest.dateLastContact as Date | string | null | undefined)}`,
+    `EOI sent: ${formatDate(interest.dateEoiSent as Date | string | null | undefined)}`,
+    `EOI signed: ${formatDate(interest.dateEoiSigned as Date | string | null | undefined)}`,
+    `Contract sent: ${formatDate(interest.dateContractSent as Date | string | null | undefined)}`,
+    `Contract signed: ${formatDate(interest.dateContractSigned as Date | string | null | undefined)}`,
+    `Deposit received: ${formatDate(interest.dateDepositReceived as Date | string | null | undefined)}`,
   ].join('\n');
 
   const notesText = interest.notes
@@ -82,13 +82,13 @@ export function buildInterestSummaryInputs(
       ? timeline
           .map(
             (e) =>
-              `${formatDate(e.createdAt)}  ${e.action ?? e.eventType ?? 'event'}  ${e.entityType ?? e.type ?? ''}${e.fieldChanged ? `  [${e.fieldChanged}]` : ''}`,
+              `${formatDate(e.createdAt as Date | string | null | undefined)}  ${e.action ?? e.eventType ?? 'event'}  ${e.entityType ?? e.type ?? ''}${e.fieldChanged ? `  [${e.fieldChanged}]` : ''}`,
           )
           .join('\n')
       : 'No timeline events';
 
   return {
-    portName: port?.name ?? 'Port Nimara',
+    portName: (port?.name as string) ?? 'Port Nimara',
     title: `Interest Summary — ${client?.fullName ?? 'Unknown Client'}`,
     clientInfo,
     berthInfo,

src/lib/pdf/templates/invoice-template.ts

@@ -107,10 +107,10 @@ export function buildInvoiceInputs(
   totalsText += `\n─────────────\nTOTAL: ${invoice.currency} ${Number(invoice.total).toFixed(2)}`;
 
   return {
-    portName: port?.name ?? 'Port Nimara',
+    portName: (port?.name as string) ?? 'Port Nimara',
     invoiceTitle: 'INVOICE',
-    invoiceNumber: invoice.invoiceNumber,
-    invoiceDate: `Date: ${new Date(invoice.createdAt).toLocaleDateString('en-GB')}`,
+    invoiceNumber: invoice.invoiceNumber as string,
+    invoiceDate: `Date: ${new Date(invoice.createdAt as string | Date).toLocaleDateString('en-GB')}`,
     dueDate: `Due: ${invoice.dueDate}`,
     clientInfo: `${invoice.clientName}\n${invoice.billingEmail ?? ''}\n${invoice.billingAddress ?? ''}`.trim(),
     lineItems: itemLines || 'No line items',

src/lib/services/document-templates.ts

@@ -2,6 +2,7 @@ import { and, eq } from 'drizzle-orm';
 
 import { db } from '@/lib/db';
 import { documentTemplates, documents, files } from '@/lib/db/schema/documents';
+import type { File as DbFile, Document as DbDocument } from '@/lib/db/schema/documents';
 import { clients, clientContacts } from '@/lib/db/schema/clients';
 import { interests } from '@/lib/db/schema/interests';
 import { berths } from '@/lib/db/schema/berths';
@@ -562,7 +563,7 @@ export async function generateAndSign(
     portId,
     context,
     meta,
-  );
+  ) as { document: DbDocument; file: DbFile };
   const template = await getTemplateById(templateId, portId);
 
   // Fetch PDF bytes from MinIO to send to Documenso

src/lib/services/expenses.ts

@@ -1,4 +1,5 @@
 import { eq, and, gte, lte, sql } from 'drizzle-orm';
+import type { PgColumn } from 'drizzle-orm/pg-core';
 
 import { db } from '@/lib/db';
 import { expenses, invoices, invoiceExpenses } from '@/lib/db/schema/financial';
@@ -58,7 +59,7 @@ export async function listExpenses(portId: string, query: ListExpensesInput) {
     includeArchived: query.includeArchived,
     archivedAtColumn: expenses.archivedAt,
     sort: query.sort
-      ? { column: expenses[query.sort as keyof typeof expenses] as unknown, direction: query.order }
+      ? { column: expenses[query.sort as keyof typeof expenses] as unknown as PgColumn, direction: query.order }
       : undefined,
   });
 }

src/lib/services/invoices.ts

@@ -1,4 +1,5 @@
 import { eq, and, desc, like, lt, sql, gte, lte, inArray, ne } from 'drizzle-orm';
+import type { PgColumn } from 'drizzle-orm/pg-core';
 
 import { db } from '@/lib/db';
 import {
@@ -96,7 +97,7 @@ export async function listInvoices(portId: string, query: ListInvoicesInput) {
     archivedAtColumn: invoices.archivedAt,
     sort: query.sort
       ? {
-          column: invoices[query.sort as keyof typeof invoices] as unknown,
+          column: invoices[query.sort as keyof typeof invoices] as unknown as PgColumn,
           direction: query.order,
         }
       : undefined,
@@ -465,7 +466,7 @@ export async function generateInvoicePdf(
     .where(eq(ports.id, portId))
     .limit(1);
 
-  const inputs = buildInvoiceInputs(invoice, invoice.lineItems, port);
+  const inputs = buildInvoiceInputs(invoice, invoice.lineItems, port ?? {});
 
   const pdfBytes = await generatePdf(invoiceTemplate, [inputs]);
 

src/lib/services/record-export.ts

@@ -81,7 +81,7 @@ export async function exportClientPdf(clientId: string, portId: string): Promise
     berthMooringNumber: i.berthId ? (berthsMap[i.berthId] ?? null) : null,
   }));
 
-  const inputs = buildClientSummaryInputs(client, contactList, enrichedInterests, activity, port);
+  const inputs = buildClientSummaryInputs(client, contactList, enrichedInterests, activity, port ?? {});
 
   return generatePdf(clientSummaryTemplate, [inputs]);
 }
@@ -143,7 +143,7 @@ export async function exportBerthPdf(berthId: string, portId: string): Promise<U
     .orderBy(desc(interests.updatedAt))
     .limit(20);
 
-  const inputs = buildBerthSpecInputs(berth, enrichedWaitingList, maintenance, linkedInterests, port);
+  const inputs = buildBerthSpecInputs(berth, enrichedWaitingList, maintenance, linkedInterests, port ?? {});
 
   return generatePdf(berthSpecTemplate, [inputs]);
 }
@@ -183,7 +183,7 @@ export async function exportInterestPdf(interestId: string, portId: string): Pro
     .orderBy(desc(auditLogs.createdAt))
     .limit(20);
 
-  const inputs = buildInterestSummaryInputs(interest, client, berth, timeline, port);
+  const inputs = buildInterestSummaryInputs(interest, client ?? {}, berth ?? null, timeline, port ?? {});
 
   return generatePdf(interestSummaryTemplate, [inputs]);
 }