@aurelienbbn/eslint-plugin-gadget

16 ESLint rules for Gadget action files. Validates options, params, timeout configuration, enqueue calls, and runtime patterns before they reach production.

This is a community package, not published or endorsed by Gadget. It complements Gadget's own framework linter with additional static checks.

Install

pnpm add -D @aurelienbbn/eslint-plugin-gadget eslint

Requires Node >=18.18, ESLint >=9, and flat config (eslint.config.js).

Quick start

// eslint.config.js
import gadget from "@aurelienbbn/eslint-plugin-gadget";

export default [gadget.configs.recommended];

Two presets are available:

• recommended - three critical rules at error, the rest at warn.
• strict - every rule at error.

Rules

| Category | Rules | What they catch | | ------------------ | ------- | ------------------------------------------------------------------------------------- | | Options and params | 9 rules | Invalid options values, unsupported param types, timeout limits, missing return types | | Runtime safety | 5 rules | Empty handlers, missing type annotations, transaction timeout patterns | | Enqueue safety | 2 rules | Concurrency limits, implicit retry defaults |

8 rules provide auto-fixes.

Documentation

Full documentation with code examples, severity matrices, and configuration guides:

gadget.aurelienbbn.com

• Installation
• Quick start
• How rules apply
• Configurations reference
• All rules

Contributing

• Open an issue to report bugs or request rules.
• Start a discussion for broader ideas.

License

MIT