prisma-generator-express 1.49.0 → 1.50.0

package/README.md

@@ -13,6 +13,7 @@ Running `npx prisma generate` produces:
 - Router generator with middleware support (before/after hooks per operation)
 - POST read endpoints for all read operations (for complex queries exceeding URL length limits)
 - Express-only progressive read streaming over Server-Sent Events (SSE), using manual stages or auto-include splitting for single-record relation reads
+- Express-only standalone materialized view router for read-only access to registered PostgreSQL materialized views
 - OpenAPI 3.1 spec (JSON and YAML endpoints registered automatically per router)
 - Documentation helpers for contract view and Scalar UI (require manual mounting)
 - Client-side query parameter encoder
@@ -34,6 +35,7 @@ Supports **Express**, **Fastify**, and **Hono** targets via the `target` configu
 - [Request body format](#request-body-format)
 - [Query encoding (client side)](#query-encoding-client-side)
 - [POST read endpoints](#post-read-endpoints)
+- [Materialized views router (Express)](#materialized-views-router-express)
 - [Progressive Endpoint Composition (Express SSE)](#progressive-endpoint-composition-express-sse)
 - [Response shaping: select, include, omit](#response-shaping-select-include-omit)
 - [BigInt and Decimal handling](#bigint-and-decimal-handling)
@@ -1327,6 +1329,220 @@ app.use('/', UserRouter({
 }))
 ```
 
+## Materialized views router (Express)
+
+The Express target includes a standalone helper for read-only access to PostgreSQL materialized views.
+
+Materialized views are not Prisma models and do not have Prisma delegates, so they are not generated as normal per-model routers. Instead, mount one standalone router and provide an explicit registry of allowed views.
+
+This feature is **Express-only**.
+
+### Usage
+
+```ts
+import express from 'express'
+import { PrismaClient } from '@prisma/client'
+import { materializedViewsRouter } from './generated/materializedRouter'
+
+const prisma = new PrismaClient()
+const app = express()
+
+app.use('/api', materializedViewsRouter({
+  prisma,
+  basePath: '/materialized',
+  views: {
+    jobAdStats: {
+      relation: 'mv_jobad_stats',
+      orderBy: {
+        field: 'updatedAt',
+        direction: 'desc',
+      },
+    },
+    companyStats: {
+      relation: 'mv_company_stats',
+    },
+  },
+}))
+
+app.listen(3000)
+```
+
+This registers:
+
+```http
+GET /api/materialized/jobAdStats?take=50&skip=0
+GET /api/materialized/companyStats?take=50
+```
+
+### View registry
+
+Each key in `views` is the public API name. The `relation` value is the actual database relation name.
+
+```ts
+views: {
+  jobAdStats: {
+    relation: 'mv_jobad_stats',
+    schema: 'public',
+    defaultLimit: 50,
+    maxLimit: 500,
+    orderBy: {
+      field: 'updatedAt',
+      direction: 'desc',
+      nulls: 'last',
+    },
+  },
+}
+```
+
+Supported view options:
+
+| Option | Type | Description |
+| ------ | ---- | ----------- |
+| `relation` | `string` | Database materialized view name |
+| `schema` | `string` | Optional schema name |
+| `defaultLimit` | `number` | Default page size for this view |
+| `maxLimit` | `number` | Maximum page size for this view |
+| `orderBy` | `string \| object` | Deterministic sort column |
+| `authorize` | `function` | Optional per-view authorization hook |
+
+`orderBy` can be a string:
+
+```ts
+orderBy: 'updatedAt'
+```
+
+Or an object:
+
+```ts
+orderBy: {
+  field: 'updatedAt',
+  direction: 'desc',
+  nulls: 'last',
+}
+```
+
+### Router options
+
+```ts
+materializedViewsRouter({
+  prisma,
+  basePath: '/materialized',
+  defaultLimit: 50,
+  maxLimit: 1000,
+  before: [authMiddleware],
+  after: [auditMiddleware],
+  views: {
+    jobAdStats: { relation: 'mv_jobad_stats' },
+  },
+})
+```
+
+Supported router options:
+
+| Option | Type | Description |
+| ------ | ---- | ----------- |
+| `prisma` | Prisma client-like object | Must expose `$queryRawUnsafe` |
+| `views` | `Record<string, ViewDef>` | Registry of allowed materialized views |
+| `basePath` | `string` | Path inside this router, default `''` |
+| `defaultLimit` | `number` | Global default page size, default `50` |
+| `maxLimit` | `number` | Global max page size, default `1000` |
+| `before` | `RequestHandler[]` | Express middleware before the query |
+| `after` | `RequestHandler[]` | Express middleware after the query |
+
+### Authorization
+
+Use `before` for shared middleware and `authorize` for per-view checks.
+
+```ts
+const forbidden = (message: string) => Object.assign(new Error(message), { status: 403 })
+
+app.use('/api', materializedViewsRouter({
+  prisma,
+  basePath: '/materialized',
+  before: [requireAuth],
+  views: {
+    publicStats: {
+      relation: 'mv_public_stats',
+    },
+    adminStats: {
+      relation: 'mv_admin_stats',
+      authorize: (req) => {
+        if (req.user?.role !== 'admin') {
+          throw forbidden('Forbidden')
+        }
+      },
+    },
+  },
+}))
+```
+
+If a view is not in the registry, the router returns:
+
+```json
+{ "message": "unknown view" }
+```
+
+### Pagination
+
+The router supports `take` and `skip` query parameters:
+
+```http
+GET /materialized/jobAdStats?take=100&skip=200
+```
+
+`take` is clamped to the configured max limit. `skip` is clamped to zero or greater.
+
+When `skip > 0`, the view must define `orderBy`. This prevents unstable offset pagination.
+
+```ts
+views: {
+  jobAdStats: {
+    relation: 'mv_jobad_stats',
+    orderBy: {
+      field: 'updatedAt',
+      direction: 'desc',
+    },
+  },
+}
+```
+
+### Identifier safety
+
+Only registered view names can be queried. Database identifiers such as `schema`, `relation`, and `orderBy.field` must match this pattern:
+
+```txt
+^[A-Za-z_][A-Za-z0-9_]*$
+```
+
+Identifiers are double-quoted before being used in SQL.
+
+This means camel-case database columns must exist as quoted identifiers. For example, `orderBy: 'updatedAt'` queries `"updatedAt"`. If the materialized view was created without a quoted alias, PostgreSQL stores the column as `updatedat`.
+
+### Response serialization
+
+Responses use the same serialization behavior as generated routers:
+
+- `BigInt` values become strings
+- `Decimal` values become strings
+- `Buffer` and `Uint8Array` values become base64 strings
+- `DateTime` values become ISO 8601 strings
+
+### Limitations
+
+The materialized views router is intentionally small and read-only.
+
+It does not support:
+
+- Prisma `where`
+- Prisma `select`
+- Prisma `include`
+- Prisma guard shapes
+- OpenAPI generation
+- Fastify or Hono targets
+- refreshing materialized views
+
+Use it for explicit read-only endpoints over known materialized views. For normal Prisma models, use the generated model routers.
+
 ## Progressive Endpoint Composition (Express SSE)
 
 Progressive Endpoint Composition lets an Express read endpoint stream partial response fields over Server-Sent Events while still ending with a final result event.

package/dist/utils/copyFiles.js

@@ -49,6 +49,7 @@ const SHARED_FILES = [
 const EXPRESS_ONLY_FILES = [
     'autoIncludePlanner.ts',
     'autoIncludeRuntime.ts',
+    'materializedRouter.ts',
 ];
 function resolveTemplateDir(subpath) {
     const fromSrc = path.join(__dirname, '..', '..', 'src', subpath);

package/dist/utils/copyFiles.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "prisma-generator-express",
   "description": "Prisma generator for Express, Fastify, and Hono CRUD APIs with OpenAPI documentation",
-  "version": "1.49.0",
+  "version": "1.50.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "license": "MIT",

package/src/copy/materializedRouter.ts

@@ -1,5 +1,11 @@
 import express from 'express'
-import type { NextFunction, Request, RequestHandler, Response, Router } from 'express'
+import type {
+  NextFunction,
+  Request,
+  RequestHandler,
+  Response,
+  Router,
+} from 'express'
 import { HttpError, mapError, transformResult } from './operationRuntime'
 
 type SortDirection = 'asc' | 'desc'
@@ -7,11 +13,7 @@ type NullsOrder = 'first' | 'last'
 
 type OrderByDef =
   | string
-  | {
-      field: string
-      direction?: SortDirection
-      nulls?: NullsOrder
-    }
+  | { field: string; direction?: SortDirection; nulls?: NullsOrder }
 
 type ViewDef = {
   relation: string
@@ -19,11 +21,18 @@ type ViewDef = {
   defaultLimit?: number
   maxLimit?: number
   orderBy?: OrderByDef
-  authorize?: (req: Request, viewName: string, def: ViewDef) => void | Promise<void>
+  authorize?: (
+    req: Request,
+    viewName: string,
+    def: ViewDef,
+  ) => void | Promise<void>
 }
 
 type PrismaRawClient = {
-  $queryRawUnsafe: <T = unknown>(sql: string, ...values: unknown[]) => Promise<T>
+  $queryRawUnsafe: <T = unknown>(
+    sql: string,
+    ...values: unknown[]
+  ) => Promise<T>
 }
 
 type MaterializedRouterOptions = {
@@ -39,7 +48,8 @@ type MaterializedRouterOptions = {
 const IDENT_RE = /^[A-Za-z_][A-Za-z0-9_]*$/
 
 const quoteIdent = (name: string): string => {
-  if (!IDENT_RE.test(name)) throw new Error('invalid identifier: ' + name)
+  if (!IDENT_RE.test(name))
+    throw new HttpError(400, 'invalid identifier: ' + name)
   return '"' + name.replace(/"/g, '""') + '"'
 }
 
@@ -54,7 +64,12 @@ const buildFqn = (def: ViewDef): string =>
     ? quoteIdent(def.schema) + '.' + quoteIdent(def.relation)
     : quoteIdent(def.relation)
 
-const clampInt = (v: unknown, fallback: number, min: number, max: number): number => {
+const clampInt = (
+  v: unknown,
+  fallback: number,
+  min: number,
+  max: number,
+): number => {
   const n = Number(v ?? fallback)
   if (!Number.isFinite(n)) return fallback
   return Math.min(Math.max(Math.trunc(n), min), max)
@@ -63,23 +78,21 @@ const clampInt = (v: unknown, fallback: number, min: number, max: number): numbe
 const normalizeDirection = (value: unknown): 'ASC' | 'DESC' => {
   if (value === undefined || value === 'asc' || value === 'ASC') return 'ASC'
   if (value === 'desc' || value === 'DESC') return 'DESC'
-  throw new Error('invalid sort direction')
+  throw new HttpError(400, 'invalid sort direction')
 }
 
-const normalizeNulls = (value: unknown): '' | ' NULLS FIRST' | ' NULLS LAST' => {
+const normalizeNulls = (
+  value: unknown,
+): '' | ' NULLS FIRST' | ' NULLS LAST' => {
   if (value === undefined) return ''
   if (value === 'first' || value === 'FIRST') return ' NULLS FIRST'
   if (value === 'last' || value === 'LAST') return ' NULLS LAST'
-  throw new Error('invalid nulls order')
+  throw new HttpError(400, 'invalid nulls order')
 }
 
 const buildOrderBy = (orderBy?: OrderByDef): string => {
   if (!orderBy) return ''
-
-  if (typeof orderBy === 'string') {
-    return ' ORDER BY ' + quoteIdent(orderBy)
-  }
-
+  if (typeof orderBy === 'string') return ' ORDER BY ' + quoteIdent(orderBy)
   return (
     ' ORDER BY ' +
     quoteIdent(orderBy.field) +
@@ -89,7 +102,9 @@ const buildOrderBy = (orderBy?: OrderByDef): string => {
   )
 }
 
-export const materializedViewsRouter = (opts: MaterializedRouterOptions): Router => {
+export const materializedViewsRouter = (
+  opts: MaterializedRouterOptions,
+): Router => {
   const router = express.Router()
   const basePath = normalizeBasePath(opts.basePath)
   const defaultLimit = opts.defaultLimit ?? 50
@@ -104,14 +119,8 @@ export const materializedViewsRouter = (opts: MaterializedRouterOptions): Router
       try {
         const viewName = req.params.viewName
         const def = opts.views[viewName]
-
-        if (!def) {
-          throw new HttpError(404, 'unknown view')
-        }
-
-        if (def.authorize) {
-          await def.authorize(req, viewName, def)
-        }
+        if (!def) throw new HttpError(404, 'unknown view')
+        if (def.authorize) await def.authorize(req, viewName, def)
 
         const take = clampInt(
           req.query.take,
@@ -119,11 +128,13 @@ export const materializedViewsRouter = (opts: MaterializedRouterOptions): Router
           1,
           def.maxLimit ?? maxLimit,
         )
-
         const skip = clampInt(req.query.skip, 0, 0, Number.MAX_SAFE_INTEGER)
 
         if (skip > 0 && !def.orderBy) {
-          throw new HttpError(400, 'skip requires orderBy for deterministic pagination')
+          throw new HttpError(
+            400,
+            'skip requires orderBy for deterministic pagination',
+          )
         }
 
         const sql =
@@ -132,8 +143,11 @@ export const materializedViewsRouter = (opts: MaterializedRouterOptions): Router
           buildOrderBy(def.orderBy) +
           ' LIMIT $1 OFFSET $2'
 
-        const rows = await opts.prisma.$queryRawUnsafe<unknown[]>(sql, take, skip)
-
+        const rows = await opts.prisma.$queryRawUnsafe<unknown[]>(
+          sql,
+          take,
+          skip,
+        )
         res.locals.data = transformResult(rows)
         next()
       } catch (err) {
@@ -146,23 +160,28 @@ export const materializedViewsRouter = (opts: MaterializedRouterOptions): Router
     },
   )
 
-  router.use((err: unknown, _req: Request, res: Response, next: NextFunction) => {
-    const httpError =
-      err instanceof HttpError
-        ? err
-        : err && typeof err === 'object' && typeof (err as { status?: number }).status === 'number'
-          ? new HttpError(
-              (err as { status: number }).status,
-              (err as { message?: string }).message || 'Internal server error',
-            )
-          : mapError(err)
-
-    if (!res.headersSent) {
-      return res.status(httpError.status).json({ message: httpError.message })
-    }
+  router.use(
+    (err: unknown, _req: Request, res: Response, next: NextFunction) => {
+      const httpError =
+        err instanceof HttpError
+          ? err
+          : err &&
+              typeof err === 'object' &&
+              typeof (err as { status?: number }).status === 'number'
+            ? new HttpError(
+                (err as { status: number }).status,
+                (err as { message?: string }).message ||
+                  'Internal server error',
+              )
+            : mapError(err)
+
+      if (!res.headersSent) {
+        return res.status(httpError.status).json({ message: httpError.message })
+      }
 
-    next(err)
-  })
+      next(err)
+    },
+  )
 
   return router
-}
+}

package/src/utils/copyFiles.ts

@@ -18,6 +18,7 @@ const SHARED_FILES = [
 const EXPRESS_ONLY_FILES = [
   'autoIncludePlanner.ts',
   'autoIncludeRuntime.ts',
+  'materializedRouter.ts',
 ]
 
 interface CopyFileOptions {