用途:把 Prisma Next 接入项目构建系统,使用合适的构建工具插件,在编辑契约源时自动重发契约产物。当前仅支持 Vite 7 与 Vite 8,对应插件为 @prisma-next/vite-plugin-contract-emit。
主要能力:插件负责契约 emit,按打包器已知的节奏运行;运行时不关心谁来 emit,应用照常读取 contract.json 与 contract.d.ts。支持配置 debounceMs(默认 150)与 logLevel(silent/info/debug,默认 info)。插件仅在 vite dev 中运行,vite build/生产环境不运行。
使用方式:安装 pnpm add -D @prisma-next/vite-plugin-contract-emit;在 vite.config.ts 中引入 prismaVitePlugin 并传 prisma-next.config.ts 的路径(相对 Vite root),不是 schema.psl 或 contract.ts 的路径。CI/生产构建需在 prebuild 脚本中运行 prisma-next contract emit。与 @react-router/dev/vite 兼容,两者在 vite.config.ts 中并列,无顺序约束。
适用场景:项目使用 Vite 且运行时消费契约;用户询问如何接入 Vite;询问 Next.js/Webpack 等集成(回答暂无,给出变通方案)。
限制:仅支持 Vite 7/8,Vite 6 及更早不在支持矩阵。没有官方 Next.js、Webpack、esbuild、Rollup、Turbopack 插件;这些场景的变通方式是从 prebuild 脚本运行 prisma-next contract emit,或在开发时手动/用 tsx --watch 调用 CLI。自定义插件应调用 executeContractEmit,不要重新实现 load → emit → publish;原子重命名与每输出 FIFO 队列位于 @prisma-next/cli/control-api。插件找不到 loader 解析的输入时会警告并只监听配置文件,导致契约编辑不再重发,需先修复配置错误并确认契约源路径在 Vite root 内。emit 出错通过 Vite 错误覆盖层显示。不要臆造不存在的打包器插件。
其他:未提供收费、价格或效果数据。