@routepact/express 0.1.6

package/README.md

@@ -0,0 +1,257 @@
+# @routepact/express
+
+Express adapter for `@routepact/core` pacts. Provides type-safe endpoint builders, request/response validation middleware, and a versioned router factory.
+
+## Installation
+
+```bash
+npm install @routepact/express @routepact/core express zod
+npm install -D @types/express
+```
+
+## Core concepts
+
+### `defineEndpoint`
+
+Wraps a handler with a pact, giving the `req` and `res` objects types inferred directly from the pact's Zod schemas.
+
+```ts
+import { defineEndpoint } from "@routepact/express";
+import { PostPacts } from "../shared/pacts/post.pact";
+
+const createPost = defineEndpoint({
+  pact: PostPacts.create,
+  handler: async (req, res) => {
+    // req.body is typed as { title: string; body: string }
+    const { title, body } = req.body;
+
+    const post = await db.posts.insert({ title, body });
+
+    // res.json only accepts the shape defined by PostPacts.create.response
+    res.status(201).json(post);
+  },
+});
+```
+
+If the pact path has parameters, `req.parsedParams` is automatically populated from `req.params` and typed from the path string. If the pact has a `query` Zod schema, the validated value is available as `req.parsedQueries`:
+
+```ts
+const getPostById = defineEndpoint({
+  pact: PostPacts.getById, // path: "/posts/:id"
+  handler: (req, res) => {
+    // req.parsedParams is typed as { id: string }
+    const { id } = req.parsedParams;
+    // ...
+  },
+});
+
+const listPosts = defineEndpoint({
+  pact: PostPacts.list, // has query: z.object({ page: z.string().optional() })
+  handler: (req, res) => {
+    // req.parsedQueries is typed as { page?: string }
+    const { page } = req.parsedQueries;
+    // ...
+  },
+});
+```
+
+### `createRouter`
+
+Takes a config with a `basePath` and route groups and returns an Express router mounted at that path.
+
+```ts
+import { createRouter } from "@routepact/express";
+import {
+  createPost,
+  getPostById,
+  listPosts,
+  updatePost,
+  deletePost,
+} from "./post.endpoints";
+
+export const postRouter = createRouter({
+  basePath: "/api/v1",
+  routeGroups: [
+    {
+      description: "Posts",
+      endpoints: [listPosts, getPostById, createPost, updatePost, deletePost],
+    },
+  ],
+});
+
+// Mount in your Express app
+app.use(postRouter);
+// Routes are now available at /api/v1/posts, /api/v1/posts/:id, etc.
+```
+
+**Options:**
+
+```ts
+createRouter(config, {
+  logger: myLogger, // default: console — must have an `error` method
+});
+```
+
+The router detects and throws on duplicate route registrations (`[method] path` pairs) at startup rather than silently shadowing them.
+
+### `defineRouteGroup`
+
+Helper to define a route group with full type checking before passing it to `createRouter`:
+
+```ts
+import { defineRouteGroup } from "@routepact/express";
+
+const publicRoutes = defineRouteGroup({
+  description: "Public routes",
+  endpoints: [listPosts, getPostById],
+});
+```
+
+## Middleware
+
+### Group middleware
+
+Apply Express middleware to every endpoint in a route group. Common use case: protecting a group of routes with an auth check.
+
+```ts
+import { createRouter } from "@routepact/express";
+import { requireAuth } from "./middlewares/auth";
+import { listPosts, createPost } from "./post.endpoints";
+
+const router = createRouter({
+  basePath: "/api/v1",
+  routeGroups: [
+    {
+      description: "Public routes",
+      endpoints: [listPosts],
+    },
+    {
+      description: "Protected routes",
+      middlewares: [requireAuth],
+      endpoints: [createPost],
+    },
+  ],
+});
+```
+
+### Endpoint middleware (`createEndpointMiddleware`)
+
+Type-safe middleware that augments the `req` object. The properties it returns are merged into the request type seen by the handler.
+
+```ts
+import { createEndpointMiddleware, defineEndpoint } from "@routepact/express";
+import { PostPacts } from "../shared/pacts/post.pact";
+import { getSessionFromRequest } from "./auth";
+
+// Declare what this middleware adds to req
+const withUser = createEndpointMiddleware(async (req) => {
+  const session = await getSessionFromRequest(req);
+  if (!session) throw new Error("Unauthorized");
+  return { user: session.user }; // TypeScript infers { user: User }
+});
+
+const createPost = defineEndpoint({
+  pact: PostPacts.create,
+  middlewares: [withUser] as const, // `as const` needed to preserve tuple type
+  handler: async (req, res) => {
+    // req.user is now typed as User — no casting needed
+    const post = await db.posts.insert({
+      ...req.body.resource,
+      authorId: req.user.id,
+    });
+    res.status(201).json({ post });
+  },
+});
+```
+
+Multiple middlewares are supported and their added types are merged:
+
+```ts
+const getPost = defineEndpoint({
+  pact: PostPacts.getById,
+  middlewares: [withUser, withRateLimit] as const,
+  handler: async (req, res) => {
+    // req has both .user (from withUser) and .rateLimit (from withRateLimit)
+  },
+});
+```
+
+## Validation middleware
+
+Request and response validation is applied automatically when a pact has the corresponding Zod schemas. You don't need to call these manually unless you want to use them outside of `createRouter`.
+
+```ts
+import {
+  createRequestValidationMiddleware,
+  createResponseValidationMiddleware,
+} from "@routepact/express";
+import { z } from "zod";
+
+// Validates req.body against the schema
+app.use(createRequestValidationMiddleware(z.object({ name: z.string() })));
+
+// Validates res.json(...) before sending
+app.use(
+  createResponseValidationMiddleware(
+    z.object({ id: z.string(), name: z.string() }),
+  ),
+);
+```
+
+### Validation errors
+
+When validation fails, the middleware calls `next(error)` with one of these:
+
+| Error class               | Status | When                                               |
+| ------------------------- | ------ | -------------------------------------------------- |
+| `RequestValidationError`  | 400    | `req.body` or `req.query` fails validation         |
+| `ResponseValidationError` | 500    | `res.json({ resource })` fails the response schema |
+
+Both expose a `cause` property with the raw `ZodError`. Register an error handler in your Express app to format them:
+
+```ts
+import {
+  ValidationError,
+  RequestValidationError,
+  ResponseValidationError,
+} from "@routepact/express";
+
+app.use((err, req, res, next) => {
+  if (err instanceof RequestValidationError) {
+    return res
+      .status(400)
+      .json({ message: "Invalid request", errors: err.cause.errors });
+  }
+  if (err instanceof ResponseValidationError) {
+    console.error("Response validation failed:", err.cause.errors);
+    return res.status(500).json({ message: "Internal server error" });
+  }
+  // Or catch any validation error regardless of type:
+  if (err instanceof ValidationError) {
+    return res.status(err.status).json({ message: err.message });
+  }
+  next(err);
+});
+```
+
+## Type reference
+
+| Export                                                 | Description                                                                |
+| ------------------------------------------------------ | -------------------------------------------------------------------------- |
+| `defineEndpoint(config)`                               | Creates a typed endpoint from a pact + handler                             |
+| `defineRouteGroup(group)`                              | Creates a typed route group                                                |
+| `createEndpointMiddleware(handler)`                    | Creates a type-augmenting middleware                                       |
+| `createRouter(config, options?)`                       | Builds a versioned Express router                                          |
+| `createRequestValidationMiddleware(schema)`            | Validates `req.body.resource`                                              |
+| `createResponseValidationMiddleware(resource?, meta?)` | Validates `res.json(...)` output                                           |
+| `ValidationError`                                      | Base class for all validation errors — has `status` and `cause: ZodError`  |
+| `RequestValidationError`                               | Extends `ValidationError` — thrown on bad request, params, or query (400)  |
+| `ResponseValidationError`                              | Extends `ValidationError` — thrown on bad response body (status 500)       |
+| `BaseRequest<T>`                                       | Express `Request` with typed `body`, `parsedParams`, `parsedQueries`       |
+| `BackendApiResponse<TRes, TMeta>`                      | Express `Response` with typed `json()`                                     |
+| `EndpointMiddleware<TAdds>`                            | A middleware that augments `req` with `TAdds`                              |
+| `RouteEndpoint<TPact, TMiddlewares>`                   | Full endpoint type including handler and middlewares                       |
+| `RouteGroup`                                           | A group of endpoints with optional shared middleware                       |
+| `RouterConfig`                                         | Config passed to `createRouter`                                            |
+| `RouterOptions`                                        | Options passed to `createRouter` — `logger`                                |
+| `Logger`                                               | `Pick<Console, "error">` — the logger interface expected by `createRouter` |

package/dist/endpoint.utils.d.ts

@@ -0,0 +1,42 @@
+import type { AnyRoutePact } from "@routepact/core";
+import type { EndpointMiddleware, EndpointMiddlewareHandler, RouteEndpoint, RouteGroup } from "./types.js";
+/**
+ * Defines a type-safe route endpoint with a pact, optional middlewares, and
+ * a handler whose request/response types are inferred from the pact schemas.
+ *
+ * @example
+ * const getUser = createEndpoint({
+ *   pact: UserPacts.getById,
+ *   handler: (req, res) => { res.json({ req.body }); },
+ * });
+ */
+export declare function defineEndpoint<TPact extends AnyRoutePact, TMiddlewares extends readonly EndpointMiddleware<object>[] = []>(config: RouteEndpoint<TPact, TMiddlewares>): RouteEndpoint<TPact, TMiddlewares>;
+/**
+ * Defines a type-safe route group with endpoints and optional middlewares
+ *
+ * @example
+ * const userRouteGroup = defineRouteGroup({
+ *  description: "User management routes",
+ *  middlewares: [] as const,
+ *  endpoints: [
+ *    createEndpoint({
+ *      pact: UserPacts.getById,
+ *      handler: (req, res) => { res.json({ req.body.resource }); }
+ *    })
+ * });
+ */
+export declare function defineRouteGroup(group: RouteGroup): RouteGroup;
+/**
+ * Creates a type-safe augmenting middleware that adds properties to the request object.
+ *
+ * The middleware function must return the properties it adds to the request.
+ * TypeScript enforces that the return type matches the declared type parameter.
+ *
+ * @example
+ * const authMiddleware = createEndpointMiddleware(async (req) => {
+ *   const session = await getSession(req);
+ *   return { user: session.user };
+ * });
+ */
+export declare function createEndpointMiddleware<TAdds extends object>(handler: EndpointMiddlewareHandler<TAdds>): EndpointMiddleware<TAdds>;
+//# sourceMappingURL=endpoint.utils.d.ts.map

package/dist/endpoint.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.utils.d.ts","sourceRoot":"","sources":["../src/endpoint.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EACzB,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,KAAK,SAAS,YAAY,EAC1B,YAAY,SAAS,SAAS,kBAAkB,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,EAE/D,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,GACzC,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,CAEpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAE9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,MAAM,EAC3D,OAAO,EAAE,yBAAyB,CAAC,KAAK,CAAC,GACxC,kBAAkB,CAAC,KAAK,CAAC,CAe3B"}

package/dist/endpoint.utils.js

@@ -0,0 +1,60 @@
+/**
+ * Defines a type-safe route endpoint with a pact, optional middlewares, and
+ * a handler whose request/response types are inferred from the pact schemas.
+ *
+ * @example
+ * const getUser = createEndpoint({
+ *   pact: UserPacts.getById,
+ *   handler: (req, res) => { res.json({ req.body }); },
+ * });
+ */
+export function defineEndpoint(config) {
+    return config;
+}
+/**
+ * Defines a type-safe route group with endpoints and optional middlewares
+ *
+ * @example
+ * const userRouteGroup = defineRouteGroup({
+ *  description: "User management routes",
+ *  middlewares: [] as const,
+ *  endpoints: [
+ *    createEndpoint({
+ *      pact: UserPacts.getById,
+ *      handler: (req, res) => { res.json({ req.body.resource }); }
+ *    })
+ * });
+ */
+export function defineRouteGroup(group) {
+    return group;
+}
+/**
+ * Creates a type-safe augmenting middleware that adds properties to the request object.
+ *
+ * The middleware function must return the properties it adds to the request.
+ * TypeScript enforces that the return type matches the declared type parameter.
+ *
+ * @example
+ * const authMiddleware = createEndpointMiddleware(async (req) => {
+ *   const session = await getSession(req);
+ *   return { user: session.user };
+ * });
+ */
+export function createEndpointMiddleware(handler) {
+    return {
+        _type: "endpoint",
+        handler: async (req, res, next) => {
+            try {
+                const additions = await handler(req, res, next);
+                if (additions) {
+                    Object.assign(req, additions);
+                }
+                next();
+            }
+            catch (error) {
+                next(error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=endpoint.utils.js.map

package/dist/endpoint.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.utils.js","sourceRoot":"","sources":["../src/endpoint.utils.ts"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAI5B,MAA0C;IAE1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAyC;IAEzC,OAAO;QACL,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YAChC,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;gBAChD,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBAChC,CAAC;gBACD,IAAI,EAAE,CAAC;YACT,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+import type z from "zod/v4";
+export declare class ValidationError extends Error {
+    readonly status: number;
+    readonly cause: z.ZodError;
+    constructor(message: string, status: number, cause: z.ZodError);
+}
+export declare class RequestValidationError extends ValidationError {
+    constructor(cause: z.ZodError);
+}
+export declare class ResponseValidationError extends ValidationError {
+    constructor(cause: z.ZodError);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,SAAkB,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ;CAM/D;AAED,qBAAa,sBAAuB,SAAQ,eAAe;gBAC7C,KAAK,EAAE,CAAC,CAAC,QAAQ;CAI9B;AAED,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,KAAK,EAAE,CAAC,CAAC,QAAQ;CAI9B"}

package/dist/errors.js

@@ -0,0 +1,23 @@
+export class ValidationError extends Error {
+    status;
+    cause;
+    constructor(message, status, cause) {
+        super(message);
+        this.name = "ValidationError";
+        this.status = status;
+        this.cause = cause;
+    }
+}
+export class RequestValidationError extends ValidationError {
+    constructor(cause) {
+        super("Request validation failed", 400, cause);
+        this.name = "RequestValidationError";
+    }
+}
+export class ResponseValidationError extends ValidationError {
+    constructor(cause) {
+        super("Response validation failed", 500, cause);
+        this.name = "ResponseValidationError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,MAAM,CAAS;IACN,KAAK,CAAa;IAEpC,YAAY,OAAe,EAAE,MAAc,EAAE,KAAiB;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,eAAe;IACzD,YAAY,KAAiB;QAC3B,KAAK,CAAC,2BAA2B,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,YAAY,KAAiB;QAC3B,KAAK,CAAC,4BAA4B,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./endpoint.utils.js";
+export * from "./errors.js";
+export * from "./router.utils.js";
+export * from "./types.js";
+export * from "./validation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./endpoint.utils.js";
+export * from "./errors.js";
+export * from "./router.utils.js";
+export * from "./types.js";
+export * from "./validation.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/router.utils.d.ts

@@ -0,0 +1,11 @@
+import express from "express";
+import type { RouterConfig, RouterOptions } from "./types.js";
+/**
+ * Sets up API routes based on the provided configuration.
+ *
+ * @param config - Router configuration containing basePath and route groups
+ * @param options - Optional configuration: logger (default: console)
+ * @returns Express router with all configured routes mounted at `config.basePath`
+ */
+export declare function createRouter(config: RouterConfig, options?: RouterOptions): express.Router;
+//# sourceMappingURL=router.utils.d.ts.map

package/dist/router.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.utils.d.ts","sourceRoot":"","sources":["../src/router.utils.ts"],"names":[],"mappings":"AACA,OAAO,OAA6C,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAIV,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAkJpB;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAyBhB"}

package/dist/router.utils.js

@@ -0,0 +1,127 @@
+import { exhaustiveGuard } from "@routepact/core";
+import express from "express";
+import { createParamsValidationMiddleware, createQueryValidationMiddleware, createRequestValidationMiddleware, createResponseValidationMiddleware, } from "./validation.js";
+function validateRouteConfig(config) {
+    if (!config.basePath || !config.basePath.startsWith("/")) {
+        throw new Error("Router configuration must have a basePath starting with '/'");
+    }
+    if (!config.routeGroups || config.routeGroups.length === 0) {
+        throw new Error("Router configuration must have at least one route group");
+    }
+}
+function isEndpointMiddleware(middleware) {
+    return (typeof middleware === "object" &&
+        middleware !== null &&
+        "_type" in middleware &&
+        middleware._type === "endpoint" &&
+        "handler" in middleware);
+}
+function buildMiddlewareChain(endpoint) {
+    const middlewares = [];
+    for (const middleware of endpoint.middlewares ?? []) {
+        if (isEndpointMiddleware(middleware)) {
+            middlewares.push(middleware.handler);
+        }
+        else {
+            middlewares.push(middleware);
+        }
+    }
+    if (endpoint.pact?.params) {
+        middlewares.push(createParamsValidationMiddleware(endpoint.pact.params));
+    }
+    else {
+        middlewares.push((req, _res, next) => {
+            req.parsedParams = { ...req.params };
+            next();
+        });
+    }
+    if (endpoint.pact?.query) {
+        middlewares.push(createQueryValidationMiddleware(endpoint.pact.query));
+    }
+    if (endpoint.pact?.request) {
+        middlewares.push(createRequestValidationMiddleware(endpoint.pact.request));
+    }
+    if (endpoint.pact?.response) {
+        middlewares.push(createResponseValidationMiddleware(endpoint.pact.response));
+    }
+    return middlewares;
+}
+function registerHttpMethod(router, path, method, middlewares, handler) {
+    switch (method) {
+        case "get":
+            router.get(path, ...middlewares, handler);
+            break;
+        case "post":
+            router.post(path, ...middlewares, handler);
+            break;
+        case "put":
+            router.put(path, ...middlewares, handler);
+            break;
+        case "patch":
+            router.patch(path, ...middlewares, handler);
+            break;
+        case "delete":
+            router.delete(path, ...middlewares, handler);
+            break;
+        default:
+            exhaustiveGuard(method);
+    }
+}
+function processEndpoint(endpoint, router, registeredRoutes, groupMiddlewares = []) {
+    const path = endpoint.pact.path;
+    const method = endpoint.pact.method.toLowerCase();
+    const routeKey = `${path}:${method}`;
+    if (registeredRoutes.has(routeKey)) {
+        throw new Error(`Duplicate route detected: [${method.toUpperCase()}] ${path}. ` +
+            `Each endpoint must have a unique combination of path and HTTP method.`);
+    }
+    registeredRoutes.add(routeKey);
+    const middlewareChain = [
+        ...groupMiddlewares,
+        ...buildMiddlewareChain(endpoint),
+    ];
+    try {
+        registerHttpMethod(router, path, method, middlewareChain, endpoint.handler);
+    }
+    catch (error) {
+        throw new Error(`Failed to register endpoint [${method.toUpperCase()}] ${path}`, { cause: error });
+    }
+}
+function processRouteGroup(group, router, registeredRoutes) {
+    const groupMiddlewares = group.middlewares ?? [];
+    for (const endpoint of group.endpoints ?? []) {
+        try {
+            processEndpoint(endpoint, router, registeredRoutes, groupMiddlewares);
+        }
+        catch (error) {
+            throw new Error("Error processing endpoint", { cause: error });
+        }
+    }
+}
+/**
+ * Sets up API routes based on the provided configuration.
+ *
+ * @param config - Router configuration containing basePath and route groups
+ * @param options - Optional configuration: logger (default: console)
+ * @returns Express router with all configured routes mounted at `config.basePath`
+ */
+export function createRouter(config, options = {}) {
+    const { logger = console } = options;
+    validateRouteConfig(config);
+    const apiRouter = express.Router();
+    const versionPath = config.basePath;
+    const versionRouter = express.Router();
+    const registeredRoutes = new Set();
+    try {
+        for (const group of config.routeGroups) {
+            processRouteGroup(group, versionRouter, registeredRoutes);
+        }
+        apiRouter.use(versionPath, versionRouter);
+        return apiRouter;
+    }
+    catch (error) {
+        logger.error(`Failed to setup API routes: ${error instanceof Error ? error.message : String(error)}`);
+        throw new Error("API Router Setup Failed", { cause: error });
+    }
+}
+//# sourceMappingURL=router.utils.js.map

package/dist/router.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.utils.js","sourceRoot":"","sources":["../src/router.utils.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+import type { AnyRoutePact, ExpectedParams, HasParams } from "@routepact/core";
+import type { NextFunction, Request, RequestHandler, Response } from "express";
+import type z from "zod/v4";
+export interface AnyServerRequest<TBody = unknown> extends Request {
+    body: TBody;
+    parsedParams?: Record<string, unknown>;
+    parsedQueries?: Record<string, unknown>;
+}
+type PactParamsField<TPact extends AnyRoutePact> = TPact["params"] extends z.ZodType<infer TParams> ? {
+    parsedParams: Omit<ExpectedParams<TPact["path"]>, keyof TParams> & TParams;
+} : HasParams<TPact["path"]> extends true ? {
+    parsedParams: ExpectedParams<TPact["path"]>;
+} : {
+    parsedParams?: never;
+};
+type PactQueriesField<TPact extends AnyRoutePact> = TPact["query"] extends z.ZodType<infer TQuery> ? {
+    parsedQueries: TQuery;
+} : {
+    parsedQueries?: never;
+};
+export type PactServerRequest<TPact extends AnyRoutePact> = Omit<AnyServerRequest<TPact["request"] extends z.ZodType<unknown> ? z.infer<TPact["request"]> : null>, "parsedParams" | "parsedQueries"> & PactParamsField<TPact> & PactQueriesField<TPact>;
+export interface AnyServerResponse<TBody = unknown> extends Response {
+    json: (body: TBody) => this;
+}
+export type PactServerResponse<TPact extends AnyRoutePact> = AnyServerResponse<TPact extends {
+    response: z.ZodType<unknown>;
+} ? z.infer<TPact["response"]> : null>;
+export interface EndpointMiddleware<TAdds extends object = object> {
+    _type: "endpoint";
+    _adds?: TAdds;
+    handler: RequestHandler;
+}
+export type MergeMiddlewares<T extends readonly EndpointMiddleware<object>[]> = T extends readonly [infer First, ...infer Rest] ? First extends EndpointMiddleware<infer Adds> ? Rest extends readonly EndpointMiddleware<object>[] ? Adds & MergeMiddlewares<Rest> : Adds : {} : {};
+export type EndpointMiddlewareHandler<TAdds extends object> = (req: AnyServerRequest, res: AnyServerResponse, next: NextFunction) => Promise<TAdds | undefined> | TAdds | undefined;
+export type RouteEndpoint<TPact extends AnyRoutePact, TMiddlewares extends readonly EndpointMiddleware<object>[] = []> = {
+    pact: TPact;
+    middlewares?: TMiddlewares;
+    handler: (req: PactServerRequest<TPact> & MergeMiddlewares<TMiddlewares>, res: PactServerResponse<TPact>, next: () => void) => void | Promise<void>;
+};
+export type AnyRouteEndpoint = RouteEndpoint<AnyRoutePact, readonly EndpointMiddleware<object>[]>;
+export interface RouteGroup {
+    description?: string;
+    middlewares?: RequestHandler[];
+    endpoints?: RouteEndpoint<AnyRoutePact, readonly EndpointMiddleware<object>[]>[];
+}
+export interface RouterConfig {
+    basePath: string;
+    routeGroups: RouteGroup[];
+}
+export type Logger = Pick<Console, "error">;
+export interface RouterOptions {
+    logger?: Logger;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,8 @@
+import type { NextFunction, Request, Response } from "express";
+import z from "zod/v4";
+import type { AnyServerRequest, PactServerResponse } from "./types.js";
+export declare function createRequestValidationMiddleware(schema: z.ZodType): (req: AnyServerRequest, _res: Response, next: NextFunction) => Promise<void>;
+export declare function createParamsValidationMiddleware(schema: z.ZodType<Record<string, unknown>>): (req: AnyServerRequest, _res: Response, next: NextFunction) => Promise<void>;
+export declare function createQueryValidationMiddleware(schema: z.ZodType<Record<string, unknown>>): (req: AnyServerRequest, _res: Response, next: NextFunction) => Promise<void>;
+export declare function createResponseValidationMiddleware(schema?: z.ZodType): (_req: Request, res: PactServerResponse<any>, next: NextFunction) => Promise<void>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvE,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,IAE/D,KAAK,gBAAgB,EACrB,MAAM,QAAQ,EACd,MAAM,YAAY,KACjB,OAAO,CAAC,IAAI,CAAC,CAYjB;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAGxC,KAAK,gBAAgB,EACrB,MAAM,QAAQ,EACd,MAAM,YAAY,KACjB,OAAO,CAAC,IAAI,CAAC,CAYjB;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAGxC,KAAK,gBAAgB,EACrB,MAAM,QAAQ,EACd,MAAM,YAAY,KACjB,OAAO,CAAC,IAAI,CAAC,CAYjB;AAED,wBAAgB,kCAAkC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,IAEjE,MAAM,OAAO,EAEb,KAAK,kBAAkB,CAAC,GAAG,CAAC,EAC5B,MAAM,YAAY,KACjB,OAAO,CAAC,IAAI,CAAC,CAwBjB"}

package/dist/validation.js

@@ -0,0 +1,77 @@
+import z from "zod/v4";
+import { RequestValidationError, ResponseValidationError } from "./errors.js";
+export function createRequestValidationMiddleware(schema) {
+    return async (req, _res, next) => {
+        try {
+            req.body = schema.parse(req.body);
+            next();
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                next(new RequestValidationError(error));
+            }
+            else {
+                next(error);
+            }
+        }
+    };
+}
+export function createParamsValidationMiddleware(schema) {
+    return async (req, _res, next) => {
+        try {
+            req.parsedParams = { ...req.params, ...schema.parse(req.params) };
+            next();
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                next(new RequestValidationError(error));
+            }
+            else {
+                next(error);
+            }
+        }
+    };
+}
+export function createQueryValidationMiddleware(schema) {
+    return async (req, _res, next) => {
+        try {
+            req.parsedQueries = schema.parse(req.query);
+            next();
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                next(new RequestValidationError(error));
+            }
+            else {
+                next(error);
+            }
+        }
+    };
+}
+export function createResponseValidationMiddleware(schema) {
+    return async (_req, 
+    // biome-ignore lint/suspicious/noExplicitAny: response type not known
+    res, next) => {
+        const originalJson = res.json;
+        res.json = function (body) {
+            if (this.statusCode >= 400) {
+                return originalJson.call(this, body);
+            }
+            try {
+                const validated = schema ? schema.parse(body) : body;
+                return originalJson.call(this, validated);
+            }
+            catch (error) {
+                if (error instanceof z.ZodError) {
+                    next(new ResponseValidationError(error));
+                }
+                else {
+                    next(error);
+                }
+                return originalJson(body);
+            }
+        };
+        next();
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@routepact/express",
+  "version": "0.1.6",
+  "description": "Express adapter for type-safe route pacts — endpoint builders, request/response validation middleware, and router setup",
+  "type": "module",
+  "repository": "gitlab:mr5k/routepact",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch"
+  },
+  "dependencies": {
+    "@routepact/core": "^0.1.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "express": ">=4.0.0",
+    "zod": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "5.0.3",
+    "express": "5.2.1",
+    "zod": "4.1.7"
+  },
+  "keywords": [
+    "routes",
+    "typesafe",
+    "express",
+    "zod",
+    "middleware"
+  ],
+  "license": "MIT"
+}