All files / src/lib/api/middleware types.ts

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
/**
 * API Middleware Types
 *
 * Type definitions for the middleware layer.
 */

import { NextRequest, NextResponse } from 'next/server';
import { Session } from 'next-auth';

/**
 * Route context with params (optional to match Next.js patterns)
 */
export interface RouteContext {
  params?: Promise<Record<string, string>>;
}

/**
 * Standard route handler type
 * Uses NextRequest for full Next.js request functionality (nextUrl, cookies, etc.)
 */
export type RouteHandler<T = unknown> = (
  request: NextRequest,
  context?: RouteContext
) => Promise<NextResponse<T>>;

/**
 * Authenticated handler with session
 * Uses NextRequest for full Next.js request functionality
 */
export type AuthenticatedHandler<T = unknown> = (
  request: NextRequest,
  context: RouteContext | undefined,
  session: Session
) => Promise<NextResponse<T>>;

/**
 * Authenticated handler with user data
 */
export type AuthenticatedUserHandler<T = unknown> = (
  request: NextRequest,
  context: RouteContext | undefined,
  session: Session,
  user: AuthenticatedUser
) => Promise<NextResponse<T>>;

/**
 * Authenticated user data from database
 */
export interface AuthenticatedUser {
  id: number;
  email: string;
  name: string | null;
  role: string;
}

/**
 * Validated handler with parsed and validated request body
 */
export type ValidatedHandler<T, V = unknown> = (
  request: NextRequest,
  context: RouteContext | undefined,
  data: V
) => Promise<NextResponse<T>>;

/**
 * Handler with both auth and validation
 */
export type AuthValidatedHandler<T, V = unknown> = (
  request: NextRequest,
  context: RouteContext | undefined,
  session: Session,
  user: AuthenticatedUser,
  data: V
) => Promise<NextResponse<T>>;

/**
 * Middleware function type
 */
export type Middleware = <T>(handler: RouteHandler<T>) => RouteHandler<T>;