eslint-plugin-suitescript-governance

Custom ESLint rules for SuiteScript 2.x to detect potential NetSuite governance point violations.

🚀 Features

• no-api-call-in-loop: Prevents calling SuiteScript API methods that consume governance points (e.g., record.load, record.save) within loops.
• governance-limit-check: Analyzes function scopes to estimate total governance point usage and warns if it exceeds 80% of the limit for the detected script type.
• require-script-type: Ensures every SuiteScript file has a @NScriptType JSDoc tag in the header, which is essential for accurate point limit mapping.

📦 Installation

npm install eslint-plugin-suitescript-governance --save-dev

🛠️ Usage

Add suitescript-governance to the plugins section of your .eslintrc or eslint.config.js configuration file.

ESLint Legacy (CommonJS)

{
    "plugins": ["suitescript-governance"],
    "extends": ["plugin:suitescript-governance/recommended"]
}

ESLint Flat Config (Modern)

import suitescriptGovernance from "eslint-plugin-suitescript-governance";

export default [
    {
        plugins: {
            "suitescript-governance": suitescriptGovernance
        },
        rules: {
            ...suitescriptGovernance.configs.recommended.rules
        }
    }
];

📊 Governance Point Mapping

The plugin uses a built-in dictionary based on official NetSuite documentation for:

• N/record
• N/search
• N/file
• N/email
• N/http / N/https

⚖️ License

MIT