prisma-generator-express 1.66.0 → 1.68.0

package/src/utils/copyFiles.ts

@@ -1,168 +1,235 @@
-import { GeneratorOptions } from '@prisma/generator-helper'
-import * as fs from 'fs'
-import * as path from 'path'
-import { Target } from '../constants'
-import { ImportStyle } from './resolveImportStyle'
-import { importExt } from './importExt'
-
-const SHARED_FILES = [
-  'parseQueryParams.ts',
-  'buildModelOpenApi.ts',
-  'operationDefinitions.ts',
-  'misc.ts',
-  'routeConfig.ts',
-  'docsRenderer.ts',
-  'operationRuntime.ts',
-  'errorMapper.ts',
-  'sse.ts',
-  'pagination.ts',
-  'materializedCount.ts',
-  'guardHelpers.ts',
-  'scalarTypes.ts',
-  'concurrency.ts',
-  'projectionDefaults.ts',
-  'guardVariantRouting.ts',
-  'guardVariantError.ts',
-]
-
-const EXPRESS_ONLY_FILES = [
-  'autoIncludePlanner.ts',
-  'autoIncludePlannerGuarded.ts',
-  'autoIncludeRuntime.ts',
-  'autoIncludeRuntimeGuarded.ts',
-  'materializedRouter.ts',
-]
-
-interface CopyFileOptions {
-  required?: boolean
-  importRewrites?: Array<{ from: string; to: string }>
-  destFilename?: string
-}
-
-function resolveTemplateDir(subpath: string): string {
-  const fromSrc = path.join(__dirname, '..', '..', 'src', subpath)
-  if (fs.existsSync(fromSrc)) return fromSrc
-  const fromDist = path.join(__dirname, '..', subpath)
-  if (fs.existsSync(fromDist)) return fromDist
-  throw new Error(
-    'Template directory "' + subpath + '" not found.\n  Searched:\n    ' +
-    fromSrc + '\n    ' + fromDist + '\n  __dirname: ' + __dirname,
-  )
-}
-
-function escapeRegex(str: string): string {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-}
-
-const RELATIVE_IMPORT_RE =
-  /(\b(?:import|export)\b[^'";]*?\bfrom\s+|\bimport\s+|\bimport\s*\(\s*)(['"])(\.{1,2}\/[^'"\n]+)\2/g
-
-const SKIP_EXTENSION_RE = /\.(m?[jt]sx?|json|css|svg|png|jpe?g|gif|webp|wasm)$/i
-
-function applyExtension(content: string, style: ImportStyle): string {
-  if (style === 'none') return content
-  const ext = importExt(style)
-  if (!ext) return content
-  return content.replace(RELATIVE_IMPORT_RE, (_match, prefix, quote, spec) => {
-    if (SKIP_EXTENSION_RE.test(spec)) return prefix + quote + spec + quote
-    return prefix + quote + spec + ext + quote
-  })
-}
-
-function copyFileSync(
-  srcDir: string,
-  destDir: string,
-  filename: string,
-  importStyle: ImportStyle,
-  options?: CopyFileOptions,
-): string | null {
-  const srcPath = path.join(srcDir, filename)
-  const destFilename = options?.destFilename || filename
-  const destPath = path.join(destDir, destFilename)
-
-  if (!fs.existsSync(srcPath)) {
-    if (options?.required) return 'Required file not found: ' + srcPath
-    return null
-  }
-
-  const destDirPath = path.dirname(destPath)
-  if (!fs.existsSync(destDirPath)) fs.mkdirSync(destDirPath, { recursive: true })
-
-  let content = fs.readFileSync(srcPath, 'utf-8')
-
-  if (options?.importRewrites) {
-    for (const rewrite of options.importRewrites) {
-      if (rewrite.from === rewrite.to) continue
-      content = content.replace(
-        new RegExp('from [\'"]' + escapeRegex(rewrite.from) + '[\'"]', 'g'),
-        "from '" + rewrite.to + "'",
-      )
-    }
-  }
-
-  const header =
-    '/**\n' +
-    ' * Auto-generated by prisma-generator-express\n' +
-    ' * DO NOT EDIT MANUALLY\n' +
-    ' */\n\n'
-
-  if (!content.startsWith('/**')) content = header + content
-
-  content = applyExtension(content, importStyle)
-
-  fs.writeFileSync(destPath, content)
-  return null
-}
-
-export async function copyFiles(
-  options: GeneratorOptions,
-  target: Target,
-  importStyle: ImportStyle,
-): Promise<void> {
-  const outputPath = options.generator.output?.value
-  if (!outputPath) return
-
-  const copyBase = resolveTemplateDir('copy')
-  const errors: string[] = []
-
-  console.log('  Copying utility files to: ' + outputPath + ' (target: ' + target + ')')
-
-  for (const file of SHARED_FILES) {
-    const err = copyFileSync(copyBase, outputPath, file, importStyle, { required: true })
-    if (err) errors.push(err)
-  }
-
-  if (target === 'express') {
-    for (const file of EXPRESS_ONLY_FILES) {
-      const err = copyFileSync(copyBase, outputPath, file, importStyle, { required: true })
-      if (err) errors.push(err)
-    }
-  }
-
-  const targetConfigFile = 'routeConfig.' + target + '.ts'
-  const err = copyFileSync(copyBase, outputPath, targetConfigFile, importStyle, {
-    required: true,
-    destFilename: 'routeConfig.target.ts',
-  })
-  if (err) errors.push(err)
-
-  const clientDir = path.join(outputPath, 'client')
-  if (!fs.existsSync(clientDir)) fs.mkdirSync(clientDir, { recursive: true })
-
-  const clientSrcDir = resolveTemplateDir('client')
-  const clientErr = copyFileSync(clientSrcDir, clientDir, 'encodeQueryParams.ts', importStyle, {
-    required: true,
-    importRewrites: [{ from: '../copy/misc', to: '../misc' }],
-  })
-  if (clientErr) errors.push(clientErr)
-
-  if (errors.length > 0) {
-    throw new Error(
-      'Failed to copy ' + errors.length + ' required file(s):\n' +
-      errors.map((e) => '  - ' + e).join('\n') +
-      '\n  copyBase: ' + copyBase + '\n  __dirname: ' + __dirname,
-    )
-  }
-
-  console.log('  ✓ Utility files copied successfully')
-}
+import { GeneratorOptions } from '@prisma/generator-helper'
+import * as fs from 'fs'
+import * as path from 'path'
+import { Target } from '../constants'
+import { ImportStyle } from './resolveImportStyle'
+import { importExt } from './importExt'
+
+const SHARED_FILES = [
+  'parseQueryParams.ts',
+  'buildModelOpenApi.ts',
+  'operationDefinitions.ts',
+  'operationSchemas.ts',
+  'misc.ts',
+  'routeConfig.ts',
+  'docsRenderer.ts',
+  'operationRuntime.ts',
+  'operationPipeline.ts',
+  'errorMapper.ts',
+  'sse.ts',
+  'pagination.ts',
+  'materializedCount.ts',
+  'guardHelpers.ts',
+  'scalarTypes.ts',
+  'concurrency.ts',
+  'projectionDefaults.ts',
+  'guardVariantRouting.ts',
+  'guardVariantError.ts',
+]
+
+const EXPRESS_ONLY_FILES = [
+  'autoIncludePlanner.ts',
+  'autoIncludePlannerGuarded.ts',
+  'autoIncludeRuntime.ts',
+  'autoIncludeRuntimeGuarded.ts',
+  'materializedRouter.ts',
+  'ndjson.ts',
+]
+
+interface CopyFileOptions {
+  required?: boolean
+  importRewrites?: Array<{ from: string; to: string }>
+  destFilename?: string
+}
+
+function resolveTemplateDir(subpath: string): string {
+  const fromSrc = path.join(__dirname, '..', '..', 'src', subpath)
+  if (fs.existsSync(fromSrc)) return fromSrc
+  const fromDist = path.join(__dirname, '..', subpath)
+  if (fs.existsSync(fromDist)) return fromDist
+  throw new Error(
+    'Template directory "' +
+      subpath +
+      '" not found.\n  Searched:\n    ' +
+      fromSrc +
+      '\n    ' +
+      fromDist +
+      '\n  __dirname: ' +
+      __dirname,
+  )
+}
+
+function escapeRegex(str: string): string {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+const RELATIVE_IMPORT_RE =
+  /(\b(?:import|export)\b[^'";]*?\bfrom\s+|\bimport\s+|\bimport\s*\(\s*)(['"])(\.{1,2}\/[^'"\n]+)\2/g
+
+const SKIP_EXTENSION_RE = /\.(m?[jt]sx?|json|css|svg|png|jpe?g|gif|webp|wasm)$/i
+
+function applyExtension(content: string, style: ImportStyle): string {
+  if (style === 'none') return content
+  const ext = importExt(style)
+  if (!ext) return content
+  return content.replace(RELATIVE_IMPORT_RE, (_match, prefix, quote, spec) => {
+    if (SKIP_EXTENSION_RE.test(spec)) return prefix + quote + spec + quote
+    return prefix + quote + spec + ext + quote
+  })
+}
+
+function copyFileSync(
+  srcDir: string,
+  destDir: string,
+  filename: string,
+  importStyle: ImportStyle,
+  options?: CopyFileOptions,
+): string | null {
+  const srcPath = path.join(srcDir, filename)
+  const destFilename = options?.destFilename || filename
+  const destPath = path.join(destDir, destFilename)
+
+  if (!fs.existsSync(srcPath)) {
+    if (options?.required) return 'Required file not found: ' + srcPath
+    return null
+  }
+
+  const destDirPath = path.dirname(destPath)
+  if (!fs.existsSync(destDirPath))
+    fs.mkdirSync(destDirPath, { recursive: true })
+
+  let content = fs.readFileSync(srcPath, 'utf-8')
+
+  if (options?.importRewrites) {
+    for (const rewrite of options.importRewrites) {
+      if (rewrite.from === rewrite.to) continue
+      content = content.replace(
+        new RegExp('from [\'"]' + escapeRegex(rewrite.from) + '[\'"]', 'g'),
+        "from '" + rewrite.to + "'",
+      )
+    }
+  }
+
+  const header =
+    '/**\n' +
+    ' * Auto-generated by prisma-generator-express\n' +
+    ' * DO NOT EDIT MANUALLY\n' +
+    ' */\n\n'
+
+  if (!content.startsWith('/**')) content = header + content
+
+  content = applyExtension(content, importStyle)
+
+  fs.writeFileSync(destPath, content)
+  return null
+}
+
+export async function copyFiles(
+  options: GeneratorOptions,
+  target: Target,
+  importStyle: ImportStyle,
+  mcp = false,
+): Promise<void> {
+  const outputPath = options.generator.output?.value
+  if (!outputPath) return
+
+  const copyBase = resolveTemplateDir('copy')
+  const errors: string[] = []
+
+  console.log(
+    '  Copying utility files to: ' + outputPath + ' (target: ' + target + ')',
+  )
+
+  for (const file of SHARED_FILES) {
+    const err = copyFileSync(copyBase, outputPath, file, importStyle, {
+      required: true,
+    })
+    if (err) errors.push(err)
+  }
+
+  if (target === 'express') {
+    for (const file of EXPRESS_ONLY_FILES) {
+      const err = copyFileSync(copyBase, outputPath, file, importStyle, {
+        required: true,
+      })
+      if (err) errors.push(err)
+    }
+  }
+
+  if (target === 'hono') {
+    // The phase 9 assembly boundary. Imports the Hono route-config types by
+    // their source name; emitted as routeConfig.target.ts like every target.
+    const err = copyFileSync(
+      copyBase,
+      outputPath,
+      'routerParts.ts',
+      importStyle,
+      {
+        required: true,
+        importRewrites: [
+          { from: './routeConfig.hono', to: './routeConfig.target' },
+        ],
+      },
+    )
+    if (err) errors.push(err)
+  }
+
+  if (mcp) {
+    // MCP runtime is copied ONLY for mcp=true generations: an mcp=false
+    // output contains no MCP files, imports or dependencies at all.
+    const err = copyFileSync(
+      copyBase,
+      outputPath,
+      'mcpRuntime.ts',
+      importStyle,
+      {
+        required: true,
+      },
+    )
+    if (err) errors.push(err)
+  }
+
+  const targetConfigFile = 'routeConfig.' + target + '.ts'
+  const err = copyFileSync(
+    copyBase,
+    outputPath,
+    targetConfigFile,
+    importStyle,
+    {
+      required: true,
+      destFilename: 'routeConfig.target.ts',
+    },
+  )
+  if (err) errors.push(err)
+
+  const clientDir = path.join(outputPath, 'client')
+  if (!fs.existsSync(clientDir)) fs.mkdirSync(clientDir, { recursive: true })
+
+  const clientSrcDir = resolveTemplateDir('client')
+  const clientErr = copyFileSync(
+    clientSrcDir,
+    clientDir,
+    'encodeQueryParams.ts',
+    importStyle,
+    {
+      required: true,
+      importRewrites: [{ from: '../copy/misc', to: '../misc' }],
+    },
+  )
+  if (clientErr) errors.push(clientErr)
+
+  if (errors.length > 0) {
+    throw new Error(
+      'Failed to copy ' +
+        errors.length +
+        ' required file(s):\n' +
+        errors.map((e) => '  - ' + e).join('\n') +
+        '\n  copyBase: ' +
+        copyBase +
+        '\n  __dirname: ' +
+        __dirname,
+    )
+  }
+
+  console.log('  ✓ Utility files copied successfully')
+}

package/src/utils/importExt.ts

@@ -1,7 +1,7 @@
-import { ImportStyle } from './resolveImportStyle'
+import type { ImportStyle } from './resolveImportStyle'
 
 export function importExt(style: ImportStyle): string {
   if (style === 'js') return '.js'
   if (style === 'ts') return '.ts'
   return ''
-}
+}

package/src/utils/mcpGate.ts

@@ -0,0 +1,157 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+/**
+ * MCP is fail-closed at GENERATION time: a guard-dropped artifact must not
+ * carry MCP support, because every MCP tool enforces a guard shape and a
+ * dropped guard would turn reads and writes into unguarded operations.
+ *
+ * MCP tool schemas are built against prisma-guard 1.33 semantics (unique
+ * selectors, operator configs, forced-value merging). A consumer running an
+ * older guard would accept shapes the tool schemas misrepresent, so an
+ * mcp=true generation REFUSES to emit MCP support unless prisma-guard
+ * >= 1.33.0 is resolvable from the schema's project.
+ */
+export function assertMcpGuardCompatibility(
+  mcp: boolean,
+  dropGuard: boolean,
+): void {
+  if (mcp && dropGuard) {
+    throw new Error(
+      'Generator option mcp=true cannot be combined with dropGuard=true. ' +
+        'MCP is fail-closed: every tool enforces a guard shape, so a ' +
+        'guard-dropped generation refuses to emit MCP support.',
+    )
+  }
+}
+
+const MCP_MIN_GUARD = '1.33.0'
+
+type Semver = {
+  core: [number, number, number]
+  pre: string[]
+}
+
+/** Semver 2.0.0 ordering, including prerelease precedence. */
+export function parseSemver(v: string): Semver | null {
+  // strict semver 2.0.0: no leading-zero numeric identifiers, no empty
+  // dot-separated prerelease/build identifiers; build metadata is parsed
+  // and ignored for precedence
+  const numeric = '0|[1-9]' + '\\d*'
+  const ident = '[0-9A-Za-z-]+'
+  const dotted = ident + '(?:\\.' + ident + ')*'
+  const m = new RegExp(
+    `^(${numeric})\\.(${numeric})\\.(${numeric})(?:-(${dotted}))?(?:\\+(${dotted}))?$`,
+  ).exec(v.trim())
+  if (!m) return null
+  const pre = m[4] ? m[4].split('.') : []
+  // semver 2.0.0: numeric PRERELEASE identifiers must not carry leading
+  // zeros (build-metadata identifiers are exempt)
+  for (const ident of pre) {
+    if (/^[0-9]+$/.test(ident) && ident.length > 1 && ident.startsWith('0')) {
+      return null
+    }
+  }
+  return {
+    core: [Number(m[1]), Number(m[2]), Number(m[3])],
+    pre,
+  }
+}
+
+/** `a < b` returns negative, `a > b` positive, equal 0 (semver 2.0.0). */
+export function compareSemver(a: string, b: string): number {
+  const va = parseSemver(a)
+  const vb = parseSemver(b)
+  if (!va || !vb) {
+    // unparsable strings sort last so they never satisfy a minimum
+    return va ? 1 : vb ? -1 : 0
+  }
+  for (let i = 0; i < 3; i++) {
+    if (va.core[i] !== vb.core[i]) return va.core[i] - vb.core[i]
+  }
+  // no prerelease > any prerelease
+  if (va.pre.length === 0 && vb.pre.length === 0) return 0
+  if (va.pre.length === 0) return 1
+  if (vb.pre.length === 0) return -1
+  const len = Math.max(va.pre.length, vb.pre.length)
+  for (let i = 0; i < len; i++) {
+    const x = va.pre[i]
+    const y = vb.pre[i]
+    if (x === undefined) return -1 // shorter set is lower
+    if (y === undefined) return 1
+    const xn = /^\d+$/.test(x)
+    const yn = /^\d+$/.test(y)
+    if (xn && yn) {
+      if (Number(x) !== Number(y)) return Number(x) - Number(y)
+    } else if (xn)
+      return -1 // numeric identifiers are lower
+    else if (yn) return 1
+    else if (x !== y) return x < y ? -1 : 1
+  }
+  return 0
+}
+
+/**
+ * Resolve prisma-guard's installed version the way Node resolves it for the
+ * generated artifact: walk UP from the schema's directory, checking
+ * `<ancestor>/node_modules/prisma-guard` at each level, and stop at the
+ * FIRST hit. Returns null when no ancestor carries an install.
+ */
+export function resolveInstalledGuardVersion(
+  schemaPath: string,
+): string | null {
+  const schemaDir = path.dirname(path.resolve(schemaPath))
+  let dir: string | undefined = schemaDir
+  while (dir) {
+    const pkgPath = path.join(
+      dir,
+      'node_modules',
+      'prisma-guard',
+      'package.json',
+    )
+    try {
+      const version = (
+        JSON.parse(fs.readFileSync(pkgPath, 'utf8')) as {
+          version?: string
+        }
+      ).version
+      if (typeof version === 'string') return version
+    } catch {
+      // not installed at this ancestor — keep walking
+    }
+    const parent = path.dirname(dir)
+    dir = parent !== dir ? parent : undefined
+  }
+  return null
+}
+
+export function assertMcpGuardVersion(
+  mcp: boolean,
+  schemaPath: string,
+  resolve: (schemaPath: string) => string | null = resolveInstalledGuardVersion,
+): void {
+  if (!mcp) return
+  const version = resolve(schemaPath)
+  if (version === null) {
+    throw new Error(
+      'mcp=true requires prisma-guard >= ' +
+        MCP_MIN_GUARD +
+        ', but prisma-guard could not be resolved from the schema project. ' +
+        'Install it (npm install prisma-guard@^' +
+        MCP_MIN_GUARD +
+        ') or turn mcp off.',
+    )
+  }
+  if (compareSemver(version, MCP_MIN_GUARD) < 0) {
+    throw new Error(
+      'mcp=true requires prisma-guard >= ' +
+        MCP_MIN_GUARD +
+        ' (MCP tool schemas mirror 1.33 semantics: unique-selector where, ' +
+        'operator configs, forced-value merging). Found prisma-guard ' +
+        version +
+        '. Upgrade it (npm install prisma-guard@^' +
+        MCP_MIN_GUARD +
+        ') or turn mcp off.',
+    )
+  }
+}

package/src/utils/pathCasing.ts

@@ -0,0 +1,42 @@
+export type PathCase = 'lower' | 'kebab' | 'raw'
+
+export function parsePathCase(raw: unknown): PathCase {
+  const value = String(raw ?? 'lower').toLowerCase()
+  if (value === 'lower' || value === 'kebab' || value === 'raw') return value
+  throw new Error(
+    `Invalid pathCase "${String(raw)}". Expected "lower", "kebab", or "raw".`,
+  )
+}
+
+export function toKebabCase(name: string): string {
+  let out = ''
+  for (let i = 0; i < name.length; i++) {
+    const ch = name[i]
+    const prev = i > 0 ? name[i - 1] : undefined
+    const next = name[i + 1]
+    const isUpper = ch >= 'A' && ch <= 'Z'
+    const prevIsLower = prev !== undefined && prev >= 'a' && prev <= 'z'
+    const prevIsDigit = prev !== undefined && prev >= '0' && prev <= '9'
+    const nextIsLower = next !== undefined && next >= 'a' && next <= 'z'
+    if (
+      isUpper &&
+      i > 0 &&
+      (prevIsLower ||
+        prevIsDigit ||
+        (prev !== undefined && prev >= 'A' && prev <= 'Z' && nextIsLower))
+    ) {
+      out += '-'
+    }
+    out += ch.toLowerCase()
+  }
+  return out
+}
+
+export function modelPathSegment(
+  modelName: string,
+  pathCase: PathCase,
+): string {
+  if (pathCase === 'raw') return modelName
+  if (pathCase === 'kebab') return toKebabCase(modelName)
+  return modelName.toLowerCase()
+}