prisma-generator-express 1.65.1 → 1.66.0

package/README.md

@@ -1,15 +1,25 @@
-# Prisma Generator Express
-
-[![npm version](https://badge.fury.io/js/prisma-generator-express.svg)](https://badge.fury.io/js/prisma-generator-express)
-[![npm](https://img.shields.io/npm/dt/prisma-generator-express.svg)](https://www.npmjs.com/package/prisma-generator-express)
-[![Coverage](https://img.shields.io/codecov/c/github/multipliedtwice/prisma-generator-express/main.svg)](https://codecov.io/gh/multipliedtwice/prisma-generator-express)
-[![npm](https://img.shields.io/npm/l/prisma-generator-express.svg)](LICENSE)
-
-Prisma generator that creates Express, Fastify, or Hono CRUD API routes with OpenAPI documentation from your Prisma schema.
-
-**Guides:** [Prisma Generator Express Series](https://multipliedtwice.github.io/prisma-generator-express/) — verified tutorials, deep dives, and troubleshooting references.
-
-**Article evidence:** [guard lab](article-labs/guard/) and [HTTP/PostgreSQL lab](article-labs/http/).
+<p align="center">
+  <img src="docs/assets/favicon.svg" width="88" height="88" alt="Prisma Generator Express logo">
+</p>
+
+<h1 align="center">Prisma Generator Express</h1>
+
+<p align="center"><strong>Ship Prisma APIs faster by generating Express, Fastify, or Hono CRUD routes, OpenAPI, pagination, hooks, and guard integration directly from your schema.</strong></p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/prisma-generator-express"><img src="https://badge.fury.io/js/prisma-generator-express.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/prisma-generator-express"><img src="https://img.shields.io/npm/dt/prisma-generator-express.svg" alt="npm downloads"></a>
+  <a href="https://codecov.io/gh/multipliedtwice/prisma-generator-express"><img src="https://img.shields.io/codecov/c/github/multipliedtwice/prisma-generator-express/master.svg" alt="Coverage"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/npm/l/prisma-generator-express.svg" alt="License"></a>
+</p>
+
+<p align="center">
+  <a href="https://multipliedtwice.github.io/prisma-generator-express/">Field Guide</a> ·
+  <a href="https://www.npmjs.com/package/prisma-generator-express">npm</a> ·
+  <a href="article-labs/guard/">Guard Evidence</a> ·
+  <a href="article-labs/http/">HTTP/PostgreSQL Evidence</a> ·
+  <a href="#documentation-endpoints">API Documentation</a>
+</p>
 
 Running `npx prisma generate` produces:
 

package/dist/generators/generateQueryBuilderHelper.d.ts

@@ -1,2 +1,2 @@
 import { GeneratorOptions } from '@prisma/generator-helper';
-export declare function generateQueryBuilderHelper(options: Pick<GeneratorOptions, 'schemaPath'>): string;
+export declare function generateQueryBuilderHelper(_options?: Partial<Pick<GeneratorOptions, 'schemaPath'>>): string;

package/dist/generators/generateQueryBuilderHelper.js

@@ -1,10 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateQueryBuilderHelper = generateQueryBuilderHelper;
-function generateQueryBuilderHelper(options) {
-    const schemaPath = options.schemaPath
-        ? JSON.stringify(options.schemaPath)
-        : "resolve(process.cwd(), 'prisma/schema.prisma')";
+function generateQueryBuilderHelper(_options) {
+    const schemaPath = "resolve(process.cwd(), 'prisma/schema.prisma')";
     return `import { spawn } from 'child_process'
 import { resolve, join, dirname } from 'path'
 import { existsSync, readFileSync } from 'fs'

package/dist/generators/generateQueryBuilderHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateQueryBuilderHelper.js","sourceRoot":"","sources":["../../src/generators/generateQueryBuilderHelper.ts"],"names":[],"mappings":";;AAEA,gEAmKC;AAnKD,SAAgB,0BAA0B,CACxC,OAA6C;IAE7C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU;QACnC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC;QACpC,CAAC,CAAC,gDAAgD,CAAA;IAEpD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CA+DsC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FxD,CAAA;AACD,CAAC"}
+{"version":3,"file":"generateQueryBuilderHelper.js","sourceRoot":"","sources":["../../src/generators/generateQueryBuilderHelper.ts"],"names":[],"mappings":";;AAoBA,gEAiKC;AAjKD,SAAgB,0BAA0B,CACxC,QAAwD;IAExD,MAAM,UAAU,GAAG,gDAAgD,CAAA;IAEnE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CA+DsC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FxD,CAAA;AACD,CAAC"}

package/dist/generators/generateRouterHono.js

@@ -131,13 +131,15 @@ const _env = getEnv()
 // which is upstream behaviour. See generateRouterHono.ts.
 const DROP_GUARD = ${dropGuard}
 
-type JsonLike =
-  | string
-  | number
-  | boolean
-  | null
-  | JsonLike[]
-  | { [k: string]: JsonLike }
+/**
+ * DELIBERATELY NOT RECURSIVE.
+ *
+ * A self-referential JSON type sent through \`c.json()\` makes Hono's response
+ * inference instantiate without a fixed point, and TypeScript answers
+ * "type instantiation is excessively deep" — in the emitted file, for every
+ * consumer. One level is all this needs: the value is serialised, not walked.
+ */
+type JsonLike = string | number | boolean | null | unknown[] | Record<string, unknown>
 
 type OperationConfigLike<TEnv extends HonoEnvBase> = {
   before?: HonoBeforeHook<TEnv>[]
@@ -230,17 +232,30 @@ function makeShapeMiddleware<TCtx, TPrisma, TEnv extends HonoEnvBase>(
   const dropGuard = DROP_GUARD || (policy.allowE2EGuardBypass && _env.E2E === 'true')
 
   return async (c: Context<GeneratedHonoEnv<TEnv>>): Promise<void> => {
+    /**
+     * INTERNAL REQUEST STATE IS SET THROUGH A CONCRETE CONTEXT.
+     *
+     * \`GeneratedHonoEnv<TEnv>['Variables']\` is \`HonoInternalVariables & TEnv['Variables']\`,
+     * and inside this generic function TypeScript cannot know that the consumer's
+     * half does not also declare \`routeConfig\` — so setting that key straight
+     * onto \`c\` is unassignable to the intersection and the emitted router does not
+     * typecheck under \`strict\` for ANY consumer. These keys belong to this
+     * router, so they are written through the internal shape they were declared
+     * in.
+     */
+    const vars = c as unknown as HandlerContext
+
     const merged = mergePaginationConfig(config.pagination, opConfig.pagination)
-    if (merged) c.set('routeConfig', { pagination: merged })
+    if (merged) vars.set('routeConfig', { pagination: merged })
 
     const headerName = config.guard?.variantHeader || 'x-api-variant'
     const headerValue = c.req.header(headerName)
     const caller = config.guard?.resolveVariant?.(c) ?? headerValue ?? undefined
-    if (typeof caller === 'string') c.set('guardCaller', caller)
+    if (typeof caller === 'string') vars.set('guardCaller', caller)
 
     const resolution = resolveOperationVariantKey(opConfig.guardRouting, caller)
     if (!resolution.ok) {
-      c.set('guardVariantFailure', resolution)
+      vars.set('guardVariantFailure', resolution)
       return
     }
 
@@ -248,11 +263,11 @@ function makeShapeMiddleware<TCtx, TPrisma, TEnv extends HonoEnvBase>(
       opConfig.guardRouting.kind === 'named'
         ? resolution.key
         : undefined
-    if (resolvedKey !== undefined) c.set('guardVariantKey', resolvedKey)
+    if (resolvedKey !== undefined) vars.set('guardVariantKey', resolvedKey)
 
     if (opConfig.guardShape) {
       const resolveCtx = typeof config.resolveContext === 'function'
-        ? () => (config.resolveContext as (ctx: Context<GeneratedHonoEnv<TEnv>>) => unknown | Promise<unknown>)(c)
+        ? () => (config.resolveContext as unknown as (ctx: Context<GeneratedHonoEnv<TEnv>>) => unknown | Promise<unknown>)(c)
         : undefined
 
       /**
@@ -265,18 +280,20 @@ function makeShapeMiddleware<TCtx, TPrisma, TEnv extends HonoEnvBase>(
        * behaviour: it is resolved at the point of use, and a function returning
        * something unusable is not this router's business to refuse.
        */
-      let effectiveShape: unknown = opConfig.guardShape
+      let effectiveShape: Record<string, unknown> | undefined = opConfig.guardShape
       if (policy.validateResolvedShapes) {
         const resolution = await resolveGuardShapeOnce(opConfig.guardShape, resolvedKey, resolveCtx)
         if (!resolution.ok) {
-          c.set('guardShapeFailure', resolution.problem)
+          vars.set('guardShapeFailure', resolution.problem)
           return
         }
-        effectiveShape = resolution.shape
+        // \`ok\` means the resolved value is a shape object; the fallback keeps the
+        // declared shape rather than storing something the context cannot hold.
+        effectiveShape = isPlainObject(resolution.shape) ? resolution.shape : opConfig.guardShape
       }
 
       if (!dropGuard) {
-        c.set('guardShape', effectiveShape)
+        vars.set('guardShape', effectiveShape)
       } else {
         await applyDroppedGuard(
           effectiveShape,
@@ -284,24 +301,24 @@ function makeShapeMiddleware<TCtx, TPrisma, TEnv extends HonoEnvBase>(
           resolveCtx,
           opKind,
           {
-            readQuery: c.get('parsedQuery'),
-            writeBody: isPlainObject(c.get('body'))
-              ? (c.get('body') as Record<string, unknown>)
+            readQuery: vars.get('parsedQuery'),
+            writeBody: isPlainObject(vars.get('body'))
+              ? (vars.get('body') as Record<string, unknown>)
               : undefined,
           },
           () => {
-            let target = c.get('parsedQuery')
+            let target = vars.get('parsedQuery')
             if (!target) {
               target = {}
-              c.set('parsedQuery', target)
+              vars.set('parsedQuery', target)
             }
             return target
           },
           () => {
-            let target = c.get('body')
+            let target = vars.get('body')
             if (!isPlainObject(target)) {
               target = {}
-              c.set('body', target)
+              vars.set('body', target)
             }
             return target as Record<string, unknown>
           },
@@ -380,7 +397,7 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
         '${modelName}',
         MODEL_FIELDS as unknown as Parameters<typeof buildModelOpenApi>[1],
         MODEL_ENUMS as unknown as Parameters<typeof buildModelOpenApi>[2],
-        config as RouteConfig,
+        config as unknown as Parameters<typeof buildModelOpenApi>[3],
         { format: 'json', writeStrategy: '${writeStrategy}' },
       )
     }
@@ -393,14 +410,14 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
         '${modelName}',
         MODEL_FIELDS as unknown as Parameters<typeof buildModelOpenApi>[1],
         MODEL_ENUMS as unknown as Parameters<typeof buildModelOpenApi>[2],
-        config as RouteConfig,
+        config as unknown as Parameters<typeof buildModelOpenApi>[3],
         { format: 'yaml', writeStrategy: '${writeStrategy}' },
       ) as string
     }
     return _openApiYamlCache
   }
 
-  if (config.queryBuilder && config.queryBuilder !== false && _env.NODE_ENV !== 'production') {
+  if (config.queryBuilder && _env.NODE_ENV !== 'production') {
     console.warn(
       '[${modelName}Router] queryBuilder config is present but Hono target does not auto-start it. ' +
       'Run \`npx prisma-query-builder-ui\` in a separate process.',
@@ -408,7 +425,7 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
   }
 
   app.onError((err, c) => {
-    return sendError(c as HandlerContext, err)
+    return sendError(c as unknown as HandlerContext, err)
   })
 
   if (!openApiDisabled) {
@@ -438,14 +455,15 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
    * that branch is inert rather than merely unreached when it is off.
    */
   const settleGuard = (c: Context<GeneratedHonoEnv<TEnv>>): void => {
-    const failure = c.get('guardVariantFailure')
+    const vars = c as unknown as HandlerContext
+    const failure = vars.get('guardVariantFailure')
     if (failure) {
       throw new HTTPException(400, {
         message: formatGuardVariantResolutionError(failure),
       })
     }
 
-    const shapeFailure = c.get('guardShapeFailure')
+    const shapeFailure = vars.get('guardShapeFailure')
     if (shapeFailure) {
       throw new HTTPException(500, {
         message: 'guard shape could not be resolved: ' + shapeFailure,
@@ -472,7 +490,7 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
       // Upstream order: hooks first, guard failure after.
       if (!SETTLE_BEFORE_HOOKS) settleGuard(c)
 
-      const key = c.get('guardVariantKey')
+      const key = (c as unknown as HandlerContext).get('guardVariantKey')
       const variantHooks =
         key !== undefined ? opConfig.variantHooks[key] : undefined
 
@@ -507,7 +525,7 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
       // Upstream order: hooks first, guard failure after.
       if (!SETTLE_BEFORE_HOOKS) settleGuard(c)
 
-      const key = c.get('guardVariantKey')
+      const key = (c as unknown as HandlerContext).get('guardVariantKey')
       const variantHooks =
         key !== undefined ? opConfig.variantHooks[key] : undefined
 

package/dist/generators/generateRouterHono.js.map

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

package/package.json

@@ -1,9 +1,20 @@
 {
   "name": "prisma-generator-express",
   "description": "Prisma generator for Express, Fastify, and Hono CRUD APIs with OpenAPI documentation",
-  "version": "1.65.1",
+  "version": "1.66.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./guard-options": {
+      "types": "./dist/guardOptions.d.ts",
+      "default": "./dist/guardOptions.js"
+    },
+    "./package.json": "./package.json"
+  },
   "license": "MIT",
   "bin": "dist/bin.js",
   "engines": {

package/src/copy/routeConfig.hono.ts

@@ -38,6 +38,13 @@ export type HonoInternalVariables = {
   guardCaller?: string
   guardVariantKey?: string
   guardVariantFailure?: Extract<GuardVariantResolution, { ok: false }>
+  /**
+   * Set when `validateResolvedShapes` refuses what a shape function returned.
+   *
+   * It was written by the router and never declared here, so the emitted router
+   * failed to typecheck at exactly the line that implements the control.
+   */
+  guardShapeFailure?: string
   resultData?: unknown
   resultStatus?: number
 }

package/src/generators/generateQueryBuilderHelper.ts

@@ -1,11 +1,27 @@
 import { GeneratorOptions } from '@prisma/generator-helper'
 
+/**
+ * THE EMITTED DEFAULT IS THE CONSUMER'S OWN SCHEMA, NEVER THE GENERATOR'S.
+ *
+ * This baked `options.schemaPath` — an ABSOLUTE path on the machine that ran
+ * `prisma generate` — into the generated helper as its runtime default. For a
+ * consumer that generates and runs in the same checkout that is invisible; for
+ * anyone else it is a path that does not exist, and for a generated artifact
+ * built in a staging directory it is worse than that: the directory is renamed
+ * away at adoption, so the shipped fallback can never resolve on ANY machine,
+ * including the one that produced it.
+ *
+ * `resolve(process.cwd(), 'prisma/schema.prisma')` — Prisma's own convention,
+ * relative to wherever the consumer's process runs — was already written here as
+ * the no-schemaPath branch. It is now the only default.
+ *
+ * THE EXPLICIT OVERRIDE IS UNTOUCHED: `startQueryBuilder({ schemaPath })` still
+ * wins, which is how a consumer with a different layout says so.
+ */
 export function generateQueryBuilderHelper(
-  options: Pick<GeneratorOptions, 'schemaPath'>,
+  _options?: Partial<Pick<GeneratorOptions, 'schemaPath'>>,
 ): string {
-  const schemaPath = options.schemaPath
-    ? JSON.stringify(options.schemaPath)
-    : "resolve(process.cwd(), 'prisma/schema.prisma')"
+  const schemaPath = "resolve(process.cwd(), 'prisma/schema.prisma')"
 
   return `import { spawn } from 'child_process'
 import { resolve, join, dirname } from 'path'

package/src/generators/generateRouterHono.ts

@@ -205,13 +205,15 @@ const _env = getEnv()
 // which is upstream behaviour. See generateRouterHono.ts.
 const DROP_GUARD = ${dropGuard}
 
-type JsonLike =
-  | string
-  | number
-  | boolean
-  | null
-  | JsonLike[]
-  | { [k: string]: JsonLike }
+/**
+ * DELIBERATELY NOT RECURSIVE.
+ *
+ * A self-referential JSON type sent through \`c.json()\` makes Hono's response
+ * inference instantiate without a fixed point, and TypeScript answers
+ * "type instantiation is excessively deep" — in the emitted file, for every
+ * consumer. One level is all this needs: the value is serialised, not walked.
+ */
+type JsonLike = string | number | boolean | null | unknown[] | Record<string, unknown>
 
 type OperationConfigLike<TEnv extends HonoEnvBase> = {
   before?: HonoBeforeHook<TEnv>[]
@@ -304,17 +306,30 @@ function makeShapeMiddleware<TCtx, TPrisma, TEnv extends HonoEnvBase>(
   const dropGuard = DROP_GUARD || (policy.allowE2EGuardBypass && _env.E2E === 'true')
 
   return async (c: Context<GeneratedHonoEnv<TEnv>>): Promise<void> => {
+    /**
+     * INTERNAL REQUEST STATE IS SET THROUGH A CONCRETE CONTEXT.
+     *
+     * \`GeneratedHonoEnv<TEnv>['Variables']\` is \`HonoInternalVariables & TEnv['Variables']\`,
+     * and inside this generic function TypeScript cannot know that the consumer's
+     * half does not also declare \`routeConfig\` — so setting that key straight
+     * onto \`c\` is unassignable to the intersection and the emitted router does not
+     * typecheck under \`strict\` for ANY consumer. These keys belong to this
+     * router, so they are written through the internal shape they were declared
+     * in.
+     */
+    const vars = c as unknown as HandlerContext
+
     const merged = mergePaginationConfig(config.pagination, opConfig.pagination)
-    if (merged) c.set('routeConfig', { pagination: merged })
+    if (merged) vars.set('routeConfig', { pagination: merged })
 
     const headerName = config.guard?.variantHeader || 'x-api-variant'
     const headerValue = c.req.header(headerName)
     const caller = config.guard?.resolveVariant?.(c) ?? headerValue ?? undefined
-    if (typeof caller === 'string') c.set('guardCaller', caller)
+    if (typeof caller === 'string') vars.set('guardCaller', caller)
 
     const resolution = resolveOperationVariantKey(opConfig.guardRouting, caller)
     if (!resolution.ok) {
-      c.set('guardVariantFailure', resolution)
+      vars.set('guardVariantFailure', resolution)
       return
     }
 
@@ -322,11 +337,11 @@ function makeShapeMiddleware<TCtx, TPrisma, TEnv extends HonoEnvBase>(
       opConfig.guardRouting.kind === 'named'
         ? resolution.key
         : undefined
-    if (resolvedKey !== undefined) c.set('guardVariantKey', resolvedKey)
+    if (resolvedKey !== undefined) vars.set('guardVariantKey', resolvedKey)
 
     if (opConfig.guardShape) {
       const resolveCtx = typeof config.resolveContext === 'function'
-        ? () => (config.resolveContext as (ctx: Context<GeneratedHonoEnv<TEnv>>) => unknown | Promise<unknown>)(c)
+        ? () => (config.resolveContext as unknown as (ctx: Context<GeneratedHonoEnv<TEnv>>) => unknown | Promise<unknown>)(c)
         : undefined
 
       /**
@@ -339,18 +354,20 @@ function makeShapeMiddleware<TCtx, TPrisma, TEnv extends HonoEnvBase>(
        * behaviour: it is resolved at the point of use, and a function returning
        * something unusable is not this router's business to refuse.
        */
-      let effectiveShape: unknown = opConfig.guardShape
+      let effectiveShape: Record<string, unknown> | undefined = opConfig.guardShape
       if (policy.validateResolvedShapes) {
         const resolution = await resolveGuardShapeOnce(opConfig.guardShape, resolvedKey, resolveCtx)
         if (!resolution.ok) {
-          c.set('guardShapeFailure', resolution.problem)
+          vars.set('guardShapeFailure', resolution.problem)
           return
         }
-        effectiveShape = resolution.shape
+        // \`ok\` means the resolved value is a shape object; the fallback keeps the
+        // declared shape rather than storing something the context cannot hold.
+        effectiveShape = isPlainObject(resolution.shape) ? resolution.shape : opConfig.guardShape
       }
 
       if (!dropGuard) {
-        c.set('guardShape', effectiveShape)
+        vars.set('guardShape', effectiveShape)
       } else {
         await applyDroppedGuard(
           effectiveShape,
@@ -358,24 +375,24 @@ function makeShapeMiddleware<TCtx, TPrisma, TEnv extends HonoEnvBase>(
           resolveCtx,
           opKind,
           {
-            readQuery: c.get('parsedQuery'),
-            writeBody: isPlainObject(c.get('body'))
-              ? (c.get('body') as Record<string, unknown>)
+            readQuery: vars.get('parsedQuery'),
+            writeBody: isPlainObject(vars.get('body'))
+              ? (vars.get('body') as Record<string, unknown>)
               : undefined,
           },
           () => {
-            let target = c.get('parsedQuery')
+            let target = vars.get('parsedQuery')
             if (!target) {
               target = {}
-              c.set('parsedQuery', target)
+              vars.set('parsedQuery', target)
             }
             return target
           },
           () => {
-            let target = c.get('body')
+            let target = vars.get('body')
             if (!isPlainObject(target)) {
               target = {}
-              c.set('body', target)
+              vars.set('body', target)
             }
             return target as Record<string, unknown>
           },
@@ -454,7 +471,7 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
         '${modelName}',
         MODEL_FIELDS as unknown as Parameters<typeof buildModelOpenApi>[1],
         MODEL_ENUMS as unknown as Parameters<typeof buildModelOpenApi>[2],
-        config as RouteConfig,
+        config as unknown as Parameters<typeof buildModelOpenApi>[3],
         { format: 'json', writeStrategy: '${writeStrategy}' },
       )
     }
@@ -467,14 +484,14 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
         '${modelName}',
         MODEL_FIELDS as unknown as Parameters<typeof buildModelOpenApi>[1],
         MODEL_ENUMS as unknown as Parameters<typeof buildModelOpenApi>[2],
-        config as RouteConfig,
+        config as unknown as Parameters<typeof buildModelOpenApi>[3],
         { format: 'yaml', writeStrategy: '${writeStrategy}' },
       ) as string
     }
     return _openApiYamlCache
   }
 
-  if (config.queryBuilder && config.queryBuilder !== false && _env.NODE_ENV !== 'production') {
+  if (config.queryBuilder && _env.NODE_ENV !== 'production') {
     console.warn(
       '[${modelName}Router] queryBuilder config is present but Hono target does not auto-start it. ' +
       'Run \`npx prisma-query-builder-ui\` in a separate process.',
@@ -482,7 +499,7 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
   }
 
   app.onError((err, c) => {
-    return sendError(c as HandlerContext, err)
+    return sendError(c as unknown as HandlerContext, err)
   })
 
   if (!openApiDisabled) {
@@ -512,14 +529,15 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
    * that branch is inert rather than merely unreached when it is off.
    */
   const settleGuard = (c: Context<GeneratedHonoEnv<TEnv>>): void => {
-    const failure = c.get('guardVariantFailure')
+    const vars = c as unknown as HandlerContext
+    const failure = vars.get('guardVariantFailure')
     if (failure) {
       throw new HTTPException(400, {
         message: formatGuardVariantResolutionError(failure),
       })
     }
 
-    const shapeFailure = c.get('guardShapeFailure')
+    const shapeFailure = vars.get('guardShapeFailure')
     if (shapeFailure) {
       throw new HTTPException(500, {
         message: 'guard shape could not be resolved: ' + shapeFailure,
@@ -546,7 +564,7 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
       // Upstream order: hooks first, guard failure after.
       if (!SETTLE_BEFORE_HOOKS) settleGuard(c)
 
-      const key = c.get('guardVariantKey')
+      const key = (c as unknown as HandlerContext).get('guardVariantKey')
       const variantHooks =
         key !== undefined ? opConfig.variantHooks[key] : undefined
 
@@ -581,7 +599,7 @@ export function ${routerFunctionName}<TCtx = unknown, TPrisma = any, TEnv extend
       // Upstream order: hooks first, guard failure after.
       if (!SETTLE_BEFORE_HOOKS) settleGuard(c)
 
-      const key = c.get('guardVariantKey')
+      const key = (c as unknown as HandlerContext).get('guardVariantKey')
       const variantHooks =
         key !== undefined ? opConfig.variantHooks[key] : undefined