Callback Guard Linter

Enforces error-first callback handling for default and custom callback identifiers using linting.

Capabilities

Flags literal error arguments

• Calling the default callback identifiers (callback, cb) with string, boolean, or numeric literals as the first argument is reported; null, undefined, variables, or Error instances are accepted. @test

Supports custom callback allowlist

• When additional callback identifiers are provided in configuration, literal first arguments on those callbacks are reported while non-literal arguments pass. @test

Ignores non-callback functions

• Functions not listed as callbacks are left untouched even when invoked with literal first arguments. @test

Implementation

@generates

API

const { lintCallbacks } = require('./src/callbackLinter')

/**
 * Lints provided source text for invalid first arguments on configured callback names.
 * @param {string} source - JavaScript source to lint.
 * @param {string[]} [extraCallbackNames] - Optional additional identifiers treated as callbacks in addition to defaults.
 * @returns {Promise<{ errors: Array<{ line: number, column: number, message: string }> }>} Accumulated lint errors.
 */
function lintCallbacks(source, extraCallbackNames) {}

Dependencies { .dependencies }

eslint-plugin-standard { .dependency }

Provides lint rules that enforce error-first callback semantics with configurable callback identifiers.

eslint { .dependency }

Runs linting with plugin configuration support.