Skip to main content
ESLint Interlace
Plugin: pg

Overview

PostgreSQL security and best practices for the pg driver

Live from GitHub

This content is fetched directly from README.md on GitHub and cached for 1 hour.

AI-Optimized Security

Every rule includes CWE, OWASP, and CVSS metadata for AI assistants to provide precise, context-aware fixes.


Live README from GitHubfrom eslint-plugin-pg/README.md, cached for 1 hour.Edit on GitHub
ESLint Interlace Logo

Security rules for PostgreSQL interaction in Node.js (SQL injection prevention).

NPM VersionNPM DownloadsPackage LicenseCodecovSince Dec 2025

⭐ If this plugin caught a real bug for you, star the repo — it's the signal that keeps these rules maintained.

Description

This plugin provides Security rules for PostgreSQL interaction in Node.js (SQL injection prevention).

Why pg-specific?

A generic SQL injection linter can flag string concatenation wherever it appears, but it cannot know the parameterization convention for each database client. The pg (node-postgres) driver uses $1, $2, … positional placeholders with a second-argument array — a pattern no generic rule encodes. eslint-plugin-pg knows this contract: it only fires on .query() calls, it stays silent when a second argument (the values array) is present, and it tracks variable taint across assignment statements so that a split-line pattern like const sql = "SELECT..." + id; client.query(sql) is flagged even though the concatenation and the query call are on separate lines. The result is a rule with near-zero false positives on legitimate parameterized queries and reliable detection on the patterns that actually lead to SQL injection.

Philosophy

Interlace fosters strength through integration. Instead of stacking isolated rules, we interlace security directly into your workflow to create a resilient fabric of code. We believe tools should guide rather than gatekeep, providing educational feedback that strengthens the developer with every interaction.

Getting Started

npm install eslint-plugin-pg --save-dev

⚙️ Configuration Presets

PresetDescription
recommendedRecommended preset - balanced security for most projects
strictStrict preset - all rules as errors

📚 Supported Libraries

LibrarynpmDownloadsDetection
pg (node-postgres)npmdownloadsSQL Injection, Connection Leaks

Custom Configuration

import pg from 'eslint-plugin-pg';

export default [
  {
    plugins: { pg },
    rules: {
      'pg/no-unsafe-query': 'error',
      'pg/no-select-all': 'off', // Disable if needed
    },
  },
];

💡 What You Get

  • PostgreSQL-specific rules: Catches pg driver anti-patterns that generic linters miss
  • LLM-optimized messages: Structured 2-line errors with CWE + fixes that AI assistants can apply
  • Connection safety: Prevents leaks, double releases, and transaction race conditions
  • SQL security: SQL injection, search_path hijacking, file access via COPY
  • Performance patterns: N+1 queries, SELECT *, bulk operation suggestions

Every rule produces a structured error message:

src/db.ts
  42:15  error  🔒 CWE-89 OWASP:A03-Injection CVSS:9.8 | Unsafe query detected | CRITICAL
                    Fix: Use parameterized query: client.query('SELECT * FROM users WHERE id = $1', [userId])

📦 Compatibility

PackageVersion
ESLint^8.0.0 || ^9.0.0 || ^10.0.0
Node.js>=18.0.0

See the ESLint Version Support Policy — current ecosystem share data, the 20% gate, and the forward-looking exception that covers v10.

Rules

Legend

IconDescription
💼Recommended: Included in the recommended preset.
⚠️Warns: Set to warn in recommended preset.
🔧Auto-fixable: Automatically fixable by the --fix CLI option.
💡Suggestions: Providing code suggestions in IDE.
🚫Deprecated: This rule is deprecated.
🟢Type-unaware: AST-only, runs in oxlint JS-plugin tier.
🟡Type-aware (refining): pure-AST primary path; types refine precision.
🟠Type-aware (graceful): requires TS program; silent without it.
RuleCWEOWASPCVSSDescription🧠💼⚠️🔧💡🚫
check-query-paramsCWE-89Ensures the number of placeholders in SQL queries matches the provided parameters.🟢⚠️
no-batch-insert-loopCWE-400Prevents INSERT/UPDATE/DELETE queries inside loops (N+1 query anti-pattern).🟢⚠️
no-floating-queryCWE-252Ensures query promises are awaited or handled.🟢💼
no-hardcoded-credentialsCWE-798Prevents hardcoded passwords and connection strings in PostgreSQL client initialization.🟢💼
no-insecure-sslCWE-295Prevents disabling SSL certificate validation in PostgreSQL connections.🟢💼
no-missing-client-releaseCWE-772Ensures acquired pool clients are released back to the pool.🟢💼
no-select-allCWE-693Discourages SELECT in favor of explicit column lists.🟢⚠️
no-transaction-on-poolCWE-362Prevents running transaction commands directly on pool (must use dedicated client).🟢💼
no-unsafe-copy-fromCWE-73A03:2021Prevents COPY FROM with file paths (should use STDIN for safe client-side data loading).🟢💼
no-unsafe-queryCWE-89SQL injection is one of the most critical security vulnerabilities🟢💼
no-unsafe-search-pathCWE-426Prevents dynamic SET searchpath queries that could enable schema hijacking.🟢💼
prefer-pool-queryCWE-693Suggests using pool.query() for single-shot queries instead of manual connect/release.🟢⚠️
prevent-double-releaseCWE-415Prevents calling client.release() multiple times on the same client.🟢💼

Part of the Interlace ESLint Ecosystem — AI-native security plugins with LLM-optimized error messages:

PluginDownloadsDescription
eslint-plugin-secure-codingdownloadsGeneral security rules & OWASP guidelines.
eslint-plugin-pgdownloadsPostgreSQL security & best practices.
eslint-plugin-node-securitydownloadsNode.js core-module security (fs, child_process, vm, crypto, Buffer).
eslint-plugin-jwtdownloadsJWT security & best practices.
eslint-plugin-browser-securitydownloadsBrowser-specific security & XSS prevention.
eslint-plugin-express-securitydownloadsExpress.js security hardening rules.
eslint-plugin-lambda-securitydownloadsAWS Lambda security best practices.
eslint-plugin-nestjs-securitydownloadsNestJS security rules & patterns.
eslint-plugin-mongodb-securitydownloadsMongoDB security best practices.
eslint-plugin-vercel-ai-securitydownloadsVercel AI SDK security hardening.
eslint-plugin-import-nextdownloadsNext-gen import sorting & architecture.

⭐ Support & follow

If this plugin caught a real bug for you, star the repo — stars are the signal that keeps the Interlace ESLint ecosystem maintained — and follow the writeups on Dev.to for the benchmarks and security research behind these rules.

GitHub stars

📄 License

MIT © Ofri Peretz

ESLint Interlace Plugin

View README.md on GitHub →

On this page

No Headings