ESLint

better-drizzle/eslint is the static surface for Better Drizzle guardrails. It mirrors the directly-checkable subset of better-drizzle/rules and is meant for editor feedback and CI, not runtime enforcement.

Install

npm install -D eslint @typescript-eslint/parser better-drizzle

pnpm add -D eslint @typescript-eslint/parser better-drizzle

yarn add -D eslint @typescript-eslint/parser better-drizzle

bun add -d eslint @typescript-eslint/parser better-drizzle

Flat Config

import parser from '@typescript-eslint/parser';
import betterDrizzle from 'better-drizzle/eslint';

export default [
	{
		files: ['**/*.{ts,tsx,mts,cts}'],
		languageOptions: {
			parser,
			sourceType: 'module',
		},
		plugins: {
			'better-drizzle': betterDrizzle,
		},
		rules: {
			...betterDrizzle.configs.recommended[0].rules,
		},
	},
];

The package also exports safe, recommended, and strict flat-config arrays.

What It Checks

The ESLint plugin only analyzes direct and obvious Better Drizzle call sites such as:

• client.users.findMany(...)
• client.repository('users').updateMany(...)
• client.$rawUnsafe(...)
• client.users.$withoutPlugins().findMany(...)

It does not try to infer transaction state, runtime meta, dialect-specific behavior, or complex wrapper functions.

Rules

Rule IDs use the better-drizzle/ prefix. The preset columns show the level each preset sets, with its options where they matter.

Destructive writes

Reads and pagination

Includes and locks

Raw SQL

Sensitive fields and plugin bypass

The sensitive field list is fixed: apiKey, apiKeys, password, passwordHash, secret, secrets, ssn, token, tokens. Only literal true values in an inline select object are matched.

Configuring rules

In an ESLint rules block, use standard ESLint severities: 'off', 'warn', 'error' (or 0, 1, 2), or [severity, options]. The true / false and { level } shorthands belong to the runtime better-drizzle/rules plugin and do not work here.

import betterDrizzle from 'better-drizzle/eslint';

export default [
	...betterDrizzle.configs.recommended,
	{
		rules: {
			'better-drizzle/no-without-plugins': 'off',
			'better-drizzle/max-limit': ['error', { value: 200 }],
			'better-drizzle/no-raw-mutation': ['warn', { allow: ['refresh materialized view'] }],
		},
	},
];

Rule options:

The other rules take no options.

Presets

safe, recommended, and strict are flat-config arrays, also available as configs.safe, configs.recommended, and configs.strict. Each one sets the TypeScript parser for **/*.{ts,tsx,mts,cts}, registers the plugin, and enables the levels above.

They are generated from the runtime presets of better-drizzle/rules, limited to the statically checkable rules. Runtime-only rules such as tenant context, transaction state, and dialect handling stay in better-drizzle/rules.

Example

import { recommended } from 'better-drizzle/eslint';

export default [
	...recommended,
];

Boundary

Use better-drizzle/eslint when you want immediate feedback in Zed, VS Code, or CI. Use better-drizzle/rules when you need runtime enforcement inside the actual Better Drizzle client.