Initial commit: Port Nimara CRM (Layers 0-4)

Full CRM rebuild with Next.js 15, TypeScript, Tailwind, Drizzle ORM,
PostgreSQL, Redis, BullMQ, MinIO, and Socket.io. Includes 461 source
files covering clients, berths, interests/pipeline, documents/EOI,
expenses/invoices, email, notifications, dashboard, admin, and
client portal. CI/CD via Gitea Actions with Docker builds.

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

src/lib/api/route-helpers.ts

@@ -0,0 +1,43 @@
+import { NextRequest } from 'next/server';
+import { z, ZodSchema } from 'zod';
+
+/**
+ * Base list query schema shared by all paginated list endpoints.
+ */
+export const baseListQuerySchema = z.object({
+  page: z.coerce.number().int().min(1).default(1),
+  limit: z.coerce.number().int().min(1).max(100).default(25),
+  sort: z.string().optional(),
+  order: z.enum(['asc', 'desc']).default('desc'),
+  search: z.string().optional(),
+  includeArchived: z
+    .enum(['true', 'false'])
+    .transform((v) => v === 'true')
+    .default('false'),
+});
+
+export type BaseListQuery = z.infer<typeof baseListQuerySchema>;
+
+/**
+ * Parses URL search params against a Zod schema.
+ * Throws a ZodError on validation failure (caught by `errorResponse`).
+ */
+export function parseQuery<T extends ZodSchema>(
+  req: NextRequest,
+  schema: T,
+): z.infer<T> {
+  const params = Object.fromEntries(req.nextUrl.searchParams.entries());
+  return schema.parse(params);
+}
+
+/**
+ * Parses the JSON request body against a Zod schema.
+ * Throws a ZodError on validation failure (caught by `errorResponse`).
+ */
+export async function parseBody<T extends ZodSchema>(
+  req: NextRequest,
+  schema: T,
+): Promise<z.infer<T>> {
+  const body = await req.json();
+  return schema.parse(body);
+}