# prisma-generator-flavoured-ids

> Generate strongly typed IDs for Prisma Client

Latest version **2.3.1** (published 2026-05-20) · MIT license · 0 weekly downloads

## Install

```sh
npm install prisma-generator-flavoured-ids
pnpm add prisma-generator-flavoured-ids
yarn add prisma-generator-flavoured-ids
bun add prisma-generator-flavoured-ids
```

Provides the command `prisma-generator-flavoured-ids`.

## Health

**Score 50/100 (C)** — status: active.

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 2.3.1 |
| Published | 2026-05-20 |
| First published | 2023-10-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=24.0 |
| Dependencies | 2 |
| Unpacked size | 76.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 11 |
| Author | Vladyslav Zavalykhatko |
| Maintainers | vladhatko |
| Keywords | prisma, prisma2, generator |

## Links

- npm: https://www.npmjs.com/package/prisma-generator-flavoured-ids
- Repository: https://github.com/Hatko/prisma-generator-flavoured-ids
- Issues: https://github.com/Hatko/prisma-generator-flavoured-ids/issues
- npm.io page: https://npm.io/package/prisma-generator-flavoured-ids

## Dependencies (2)

- [@prisma/internals](https://npm.io/package/@prisma/internals.md) ^6.19.0 || ^7.0.0
- [@prisma/generator-helper](https://npm.io/package/@prisma/generator-helper.md) ^6.19.0 || ^7.0.0

## Alternatives

- [@oh-my-pi/pi-natives](https://npm.io/package/@oh-my-pi/pi-natives.md) — 51.8K weekly downloads
- [@capgo/capacitor-light-sensor](https://npm.io/package/@capgo/capacitor-light-sensor.md) — 3.0K weekly downloads
- [@heyhuynhgiabuu/pi-diff](https://npm.io/package/@heyhuynhgiabuu/pi-diff.md) — 492 weekly downloads
- [@lotsa/verdant-lang-asm](https://npm.io/package/@lotsa/verdant-lang-asm.md) — 38 weekly downloads
- [new-era-syntax](https://npm.io/package/new-era-syntax.md) — 20 weekly downloads

## Recent versions

- 2.3.1 (latest) — 2026-05-20
- 2.3.0 — 2026-05-20
- 2.2.0 — 2026-01-25
- 2.1.0 — 2026-01-02
- 2.0.0 — 2024-12-18
- 1.1.0 — 2023-11-14
- 1.0.1 — 2023-10-29
- 1.0.0 — 2023-10-26

## README

# prisma-generator-flavoured-ids

[![npm](https://img.shields.io/npm/v/prisma-generator-flavoured-ids.svg)](https://www.npmjs.com/package/prisma-generator-flavoured-ids)

This generator intends to mitigate the issue with weakly-typed IDs on Prisma Schema entities.

## Motivation

The following Prisma Schema:

```prisma
model User {
  id    String  @id @default(uuid())
  name  String
  email String? @unique

  Blogposts Blogpost[]
}

model Blogpost {
  id String @id @default(cuid())

  content String

  Author   User?   @relation(fields: [authorId], references: [id])
  authorId String?
}
```

will generate the model and methods related to user with `id` being of type `string`. This is not ideal, as it is easy to pass the wrong type of ID to the generated methods, e.g.:

```typescript
// The called of the method passes `userId`
const deleteBlogpostsForUser = async (id: string) => {
  // From within the method, typescript doesn't prevent from using `userId` as a `blogpostId`
  await prisma.blogpost.deleteMany({
    where: { id },
  });
}
```

[A related Prisma issue](https://github.com/prisma/prisma/issues/9853)

## Solution

To resolve the problem, the generator will overwrite the resulting types with the following:

1. Add a branded type for each model ID, e.g.

  ```typescript
  export interface Flavoring<FlavorT> {
    _type?: FlavorT
  }
  export type Flavor<T, FlavorT> = T & Flavoring<FlavorT>

  export type UserId = Flavor<string, 'UserId'>
  export type BlogpostId = Flavor<string, 'BlogpostId'>
  ```

2. Change the methods to use the branded type, e.g.

  ```typescript
  export type UserWhereUniqueInput = Prisma.AtLeast<{
    id?: UserId
    /// ...
  }>

  export type UserWhereInput = Prisma.AtLeast<{
    id?: StringFilter<"User"> | UserId
    /// ...
  }>

  // and others
  ```

3. **Automatically handle foreign key fields** - The generator also replaces foreign key field types with the appropriate branded types:

  ```typescript
  // Before
  export type BlogpostPayload = {
    id: BlogpostId
    authorId: string | null  // ❌ weakly typed
  }

  // After
  export type BlogpostPayload = {
    id: BlogpostId
    authorId: UserId | null  // ✅ strongly typed
  }
  ```

  This applies to all foreign key fields that reference models with `@id` fields.

4. **Strongly type input types** - The generator updates all Prisma input types to use branded IDs:

  ```typescript
  // Before
  export type UserCreateInput = {
    id?: string
    blogposts?: BlogpostCreateNestedManyWithoutAuthorInput
  }

  export type BlogpostCreateWithoutAuthorInput = {
    id?: string
    authorId?: string | null
  }

  // After
  export type UserCreateInput = {
    id?: UserId  // ✅ strongly typed
    blogposts?: BlogpostCreateNestedManyWithoutAuthorInput
  }

  export type BlogpostCreateWithoutAuthorInput = {
    id?: BlogpostId  // ✅ strongly typed
    authorId?: UserId | null  // ✅ strongly typed foreign key
  }
  ```

  This applies to all input types including `CreateInput`, `UpdateInput`, `CreateWithout*Input`, `UpdateWithout*Input`, `UncheckedCreateInput`, `UncheckedUpdateInput`, and their variants.

In result, the example from above will be prevented by typescript:

```typescript
import { UserId } from '@prisma/client'

const deleteBlogpostsForUser = async (id: UserId) => {
  await prisma.blogpost.deleteMany({
    // Typescript will show an error here
    where: { id },
  });
}
```

### Disclaimer

1. Ideally, Prisma needs to add native support for branded types. If you find this solution useful, please up-vote the [Prisma issue](https://github.com/prisma/prisma/issues/9853)

2. This is a dirty approach, as it relies on the generated code. This library has been used for several months and had to be changed significantly based on the changes Prisma made to its client

## Installation and usage

```sh
# inside your project's working tree
npm i prisma-generator-flavoured-ids
```

```prisma
generator flavoured_ids {
  provider = "prisma-generator-flavoured-ids"
  // A path to the generated client - can vary on your setup
  output   = "node_modules/.prisma/client/index.d.ts"
}
```

## Configuration Options

### `strictFlavours`

By default, flavoured types accept any string value (backward compatible behavior). You can enable strict mode to require exact branded types:

```prisma
generator flavoured_ids {
  provider       = "prisma-generator-flavoured-ids"
  output         = "node_modules/.prisma/client/index.d.ts"
  strictFlavours = "true"
}
```

**Default behavior (strictFlavours = false):**
```typescript
// Any string is accepted
const userId: UserId = "some-string" // ✅ OK
const anotherUserId: UserId = blogpostId // ❌ Error: different flavour
```

**Strict mode (strictFlavours = true):**
```typescript
// Only properly branded types are accepted
const userId: UserId = "some-string" // ❌ Error: string is not assignable
const userId: UserId = "some-string" as UserId // ✅ OK: explicit branding required
const anotherUserId: UserId = blogpostId // ❌ Error: different flavour
```

---
_Source: https://npm.io/package/prisma-generator-flavoured-ids · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._