メニュー
Install and configure Zodipus Prisma generator. Use when installing zodipus, setting up generator options, configuring output paths, choosing date formats, or integrating with Next.js/Express/Fastify/tRPC.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/bratsos/zodipus --skill zodipus-setupコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
| name | zodipus-setup |
| description | Install and configure Zodipus Prisma generator. Use when installing zodipus, setting up generator options, configuring output paths, choosing date formats, or integrating with Next.js/Express/Fastify/tRPC. |
| license | MIT |
| metadata | {"author":"zodipus","version":"1.0.0"} |
Complete guide for installing and configuring Zodipus.
# npm
npm install zodipus zod
# pnpm
pnpm add zodipus zod
# yarn
yarn add zodipus zod
Requirements:
Add to your schema.prisma:
generator client {
provider = "prisma-client-js"
}
generator zodipus {
provider = "zodipus"
output = "./generated"
}
model User {
id String @id @default(cuid())
email String @unique
name String?
role Role @default(USER)
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt
posts Post[]
}
model Post {
id String @id @default(cuid())
title String
content String?
published Boolean @default(false)
author User @relation(fields: [authorId], references: [id])
authorId String
}
enum Role {
USER
ADMIN
}
npx prisma generate
This creates:
generated/
├── enums.ts # RoleSchema
├── models.ts # UserSchema, PostSchema
├── custom-schemas.ts # Placeholder for @zodSchema
├── generated-relations.ts
└── generated-index.ts
| Option | Type | Default | Description |
|---|---|---|---|
provider | string | Required | Must be "zodipus" |
output | string | Required | Output directory for generated files |
relationDepth | string | "5" | Maximum depth for nested relation extraction |
dateFormat | string | "coerce" | DateTime handling: "coerce" or "string" |
passthroughEnabled | string | "false" | Allow unknown keys in objects |
debug | string | "false" | Enable verbose debug logging |
zodImport | string | "zod" | Custom Zod import path |
dateFormat = "coerce" (Default)Accepts multiple input types, converts to Date:
// All valid inputs:
UserSchema.parse({ createdAt: new Date() }); // Date object
UserSchema.parse({ createdAt: '2024-01-15T10:30:00Z' }); // ISO string
UserSchema.parse({ createdAt: 1705315800000 }); // Timestamp
Use when: Receiving data from various sources (APIs, databases, user input).
dateFormat = "string"Requires strict ISO 8601 format:
// Only ISO strings accepted:
UserSchema.parse({ createdAt: '2024-01-15T10:30:00.000Z' }); // OK
UserSchema.parse({ createdAt: new Date() }); // Error!
Use when: Building strict APIs, need consistent date format.
passthroughEnabled = "false" (Default)Unknown keys are stripped:
const data = { id: '1', email: 'a@b.com', unknownField: 'ignored' };
const user = UserSchema.parse(data);
// user = { id: '1', email: 'a@b.com' } - unknownField removed
Use when: Sanitizing input, preventing data leakage.
passthroughEnabled = "true"Unknown keys are preserved:
const data = { id: '1', email: 'a@b.com', extra: 'kept' };
const user = UserSchema.parse(data);
// user = { id: '1', email: 'a@b.com', extra: 'kept' }
Use when: Transforming data, need to preserve extra fields.
Controls how deeply nested relations are extracted for the Query Engine:
generator zodipus {
relationDepth = "10" # Allow queries 10 levels deep
}
Default: 5 - Sufficient for most apps. Increase if you have deeply nested queries.
Best for REST/GraphQL APIs with strict validation:
generator zodipus {
provider = "zodipus"
output = "./src/generated/zodipus"
passthroughEnabled = "false"
dateFormat = "string"
relationDepth = "5"
}
Best for ETL, migrations, or internal tools:
generator zodipus {
provider = "zodipus"
output = "./generated"
passthroughEnabled = "true"
dateFormat = "coerce"
relationDepth = "8"
}
Quick start with sensible defaults:
generator zodipus {
provider = "zodipus"
output = "./generated"
}
// app/api/users/route.ts
import { NextRequest, NextResponse } from 'next/server';
import { UserSchema } from '@/generated';
import { prisma } from '@/lib/prisma';
export async function POST(request: NextRequest) {
const body = await request.json();
const result = UserSchema.omit({ id: true, createdAt: true, updatedAt: true })
.safeParse(body);
if (!result.success) {
return NextResponse.json({ errors: result.error.flatten() }, { status: 400 });
}
const user = await prisma.user.create({ data: result.data });
return NextResponse.json(UserSchema.parse(user));
}
// routes/users.ts
import { Router } from 'express';
import { UserSchema } from '../generated';
import { prisma } from '../lib/prisma';
const router = Router();
router.post('/', async (req, res) => {
const CreateUserSchema = UserSchema.omit({ id: true, createdAt: true, updatedAt: true });
const result = CreateUserSchema.safeParse(req.body);
if (!result.success) {
return res.status(400).json({ errors: result.error.flatten() });
}
const user = await prisma.user.create({ data: result.data });
res.json(UserSchema.parse(user));
});
export default router;
// server/routers/user.ts
import { router, publicProcedure } from '../trpc';
import { UserSchema } from '../../generated';
import { prisma } from '../../lib/prisma';
export const userRouter = router({
create: publicProcedure
.input(UserSchema.omit({ id: true, createdAt: true, updatedAt: true }))
.mutation(async ({ input }) => {
const user = await prisma.user.create({ data: input });
return UserSchema.parse(user);
}),
getById: publicProcedure
.input(z.object({ id: z.string() }))
.query(async ({ input }) => {
const user = await prisma.user.findUnique({ where: { id: input.id } });
return user ? UserSchema.parse(user) : null;
}),
});
After setup, verify everything works:
// test-setup.ts
import { UserSchema, RoleSchema } from './generated';
import { createRegistry } from 'zodipus/queryEngine';
import { models, modelRelations } from './generated/generated-index';
// Test schema parsing
const user = UserSchema.parse({
id: 'test-id',
email: 'test@example.com',
name: null,
role: 'USER',
createdAt: new Date(),
updatedAt: new Date(),
});
console.log('Schema validation:', user);
// Test Query Engine
const registry = createRegistry({ models, relations: modelRelations });
const userQuery = registry.createQuery('user');
console.log('Query Engine:', userQuery({ select: { id: true } }).query);
Run npx prisma generate after adding the generator.
Ensure your tsconfig includes the output directory:
{
"include": ["src/**/*", "generated/**/*"]
}
Zodipus outputs CommonJS. If using ESM, ensure your bundler handles the conversion.
For detailed options, see references/GENERATOR-OPTIONS.md.
SOC 職業分類に基づく
Define custom Zod schemas for Prisma JSON fields using @zodSchema annotations. Use when working with typed JSON, metadata fields, settings objects, complex JSON structures in Prisma, or custom-schemas.ts.
Migrate to Zodipus from other Prisma-Zod generators like prisma-zod-generator, zod-prisma, zod-prisma-types, or zmodel. Use when switching from another Prisma validation library.
Build type-safe, composable Prisma queries with automatic Zod validation. Use when working with createRegistry, query builders, select/include patterns, validated database queries, findMany validation, or type-safe Prisma results.