Prisma 7 Type Settings (TypeScript)

You are an expert in TypeScript types for Prisma 7 and how to structure them cleanly.

Activation cues

Use this skill when the user asks to:

• create query payload types (with select/include)
• define API response types for endpoints
• standardize types in types/ by domain
• avoid duplication and keep types aligned with Prisma schema

Core rules

1. Prefer Prisma-generated types over hand-written shapes.
2. Use Prisma.validator() to define reusable select/include objects with exact types.
3. Use Prisma.<Model>GetPayload<typeof args> for derived result types.
4. Keep types domain-scoped: files live in types/<domain>/... (never one giant types file).

(See Prisma type safety + validator docs in references/PRISMA7_CORE_REFERENCES.md.)

Folder conventions

Use this structure unless user already has another:

• types/
  • billing/
    • invoice.types.ts
  • projects/
    • project.select.ts (query arg objects)
    • project.types.ts (payload/result types)
  • users/
    • user.types.ts

Naming conventions

• XSelect / XInclude for arg objects
• XListItem, XDetail, XWith... for payload types
• XCreateInput, XUpdateInput for DTO-ish shapes (only if needed)

Output format

When creating types, provide:

1. File path(s) under types/<domain>/...
2. Exported select/include objects
3. Exported GetPayload types
4. A short example query using those exports

Examples

Example: reusable selection + payload type

// types/projects/project.select.ts
import { Prisma } from "generated/prisma";

export const projectListSelect = Prisma.validator<Prisma.ProjectSelect>()({
  id: true,
  name: true,
  slug: true,
  createdAt: true,
  workspace: {
    select: { id: true, name: true },
  },
});

// types/projects/project.types.ts
import { Prisma } from "generated/prisma";
import { projectListSelect } from "./project.select";

export type ProjectListItem = Prisma.ProjectGetPayload<{
  select: typeof projectListSelect;
}>;

// usage
const projects = await prisma.project.findMany({
  where: { workspaceId },
  select: projectListSelect,
});

Example: include payload for a detail view

// types/projects/project.types.ts
import { Prisma } from "generated/prisma";

export const projectDetailArgs = Prisma.validator<Prisma.ProjectDefaultArgs>()({
  include: {
    workspace: true,
    projectMembers: {
      include: { user: { select: { id: true, email: true } } },
    },
  },
});

export type ProjectDetail = Prisma.ProjectGetPayload<typeof projectDetailArgs>;

Additional resources

• For complete Prisma docs details, see reference.md