prisma-generator-express 1.48.0 → 1.49.0

package/dist/generators/generateRouter.js

@@ -463,7 +463,7 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any>(config: ${m
   if (config.updateEach) {
     const opConfig: OperationConfigLike = (config.updateEach as OperationConfigLike | undefined) ?? defaultOpConfig
     const { before = [], after = [] } = opConfig
-    const path = basePath ? \`\${basePath}/updateEach\` : '/updateEach'
+    const path = basePath ? \`\${basePath}/each\` : '/each'
     router.post(
       path,
       setShape(opConfig),

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.48.0",
+  "version": "1.49.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "license": "MIT",

package/src/copy/materializedRouter.ts

@@ -0,0 +1,168 @@
+import express from 'express'
+import type { NextFunction, Request, RequestHandler, Response, Router } from 'express'
+import { HttpError, mapError, transformResult } from './operationRuntime'
+
+type SortDirection = 'asc' | 'desc'
+type NullsOrder = 'first' | 'last'
+
+type OrderByDef =
+  | string
+  | {
+      field: string
+      direction?: SortDirection
+      nulls?: NullsOrder
+    }
+
+type ViewDef = {
+  relation: string
+  schema?: string
+  defaultLimit?: number
+  maxLimit?: number
+  orderBy?: OrderByDef
+  authorize?: (req: Request, viewName: string, def: ViewDef) => void | Promise<void>
+}
+
+type PrismaRawClient = {
+  $queryRawUnsafe: <T = unknown>(sql: string, ...values: unknown[]) => Promise<T>
+}
+
+type MaterializedRouterOptions = {
+  prisma: PrismaRawClient
+  views: Record<string, ViewDef>
+  basePath?: string
+  defaultLimit?: number
+  maxLimit?: number
+  before?: RequestHandler[]
+  after?: RequestHandler[]
+}
+
+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)
+  return '"' + name.replace(/"/g, '""') + '"'
+}
+
+const normalizeBasePath = (value?: string): string => {
+  if (!value || value === '/') return ''
+  const prefixed = value.startsWith('/') ? value : '/' + value
+  return prefixed.replace(/\/+$/, '')
+}
+
+const buildFqn = (def: ViewDef): string =>
+  def.schema
+    ? quoteIdent(def.schema) + '.' + quoteIdent(def.relation)
+    : quoteIdent(def.relation)
+
+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)
+}
+
+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')
+}
+
+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')
+}
+
+const buildOrderBy = (orderBy?: OrderByDef): string => {
+  if (!orderBy) return ''
+
+  if (typeof orderBy === 'string') {
+    return ' ORDER BY ' + quoteIdent(orderBy)
+  }
+
+  return (
+    ' ORDER BY ' +
+    quoteIdent(orderBy.field) +
+    ' ' +
+    normalizeDirection(orderBy.direction) +
+    normalizeNulls(orderBy.nulls)
+  )
+}
+
+export const materializedViewsRouter = (opts: MaterializedRouterOptions): Router => {
+  const router = express.Router()
+  const basePath = normalizeBasePath(opts.basePath)
+  const defaultLimit = opts.defaultLimit ?? 50
+  const maxLimit = opts.maxLimit ?? 1000
+  const before = opts.before ?? []
+  const after = opts.after ?? []
+
+  router.get(
+    basePath + '/:viewName',
+    ...before,
+    async (req: Request, res: Response, next: NextFunction) => {
+      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)
+        }
+
+        const take = clampInt(
+          req.query.take,
+          def.defaultLimit ?? defaultLimit,
+          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')
+        }
+
+        const sql =
+          'SELECT * FROM ' +
+          buildFqn(def) +
+          buildOrderBy(def.orderBy) +
+          ' LIMIT $1 OFFSET $2'
+
+        const rows = await opts.prisma.$queryRawUnsafe<unknown[]>(sql, take, skip)
+
+        res.locals.data = transformResult(rows)
+        next()
+      } catch (err) {
+        next(mapError(err))
+      }
+    },
+    ...after,
+    (_req: Request, res: Response) => {
+      res.json(res.locals.data)
+    },
+  )
+
+  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)
+  })
+
+  return router
+}

package/src/generators/generateRouter.ts

@@ -479,7 +479,7 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any>(config: ${m
   if (config.updateEach) {
     const opConfig: OperationConfigLike = (config.updateEach as OperationConfigLike | undefined) ?? defaultOpConfig
     const { before = [], after = [] } = opConfig
-    const path = basePath ? \`\${basePath}/updateEach\` : '/updateEach'
+    const path = basePath ? \`\${basePath}/each\` : '/each'
     router.post(
       path,
       setShape(opConfig),