eslint-plugin-reliability 3.1.9 → 3.1.11

package/src/rules/reliability/no-jsdoc-terminator-in-example.js

@@ -1,109 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.noJsdocTerminatorInExample = void 0;
-exports.findTerminatorsInExamples = findTerminatorsInExamples;
-const eslint_devkit_1 = require("@interlace/eslint-devkit");
-function findTerminatorsInExamples(commentText) {
-    const lines = commentText.split('\n');
-    let inExample = false;
-    const offsets = [];
-    let currentOffset = 0;
-    for (const line of lines) {
-        const stripped = line.replace(/^\s*\*?\s?/, '');
-        if (/^\s*@example\b/i.test(stripped)) {
-            inExample = true;
-            currentOffset += line.length + 1;
-            continue;
-        }
-        if (/^\s*@\w+/.test(stripped) && !stripped.startsWith('@example')) {
-            inExample = false;
-            currentOffset += line.length + 1;
-            continue;
-        }
-        if (inExample) {
-            let searchStart = 0;
-            while (searchStart < line.length) {
-                const idx = line.indexOf('*/', searchStart);
-                if (idx === -1)
-                    break;
-                const absoluteOffset = currentOffset + idx;
-                const remaining = commentText.substring(absoluteOffset + 2).trim();
-                if (remaining.length > 0) {
-                    offsets.push(absoluteOffset);
-                }
-                searchStart = idx + 2;
-            }
-        }
-        currentOffset += line.length + 1;
-    }
-    return offsets;
-}
-exports.noJsdocTerminatorInExample = (0, eslint_devkit_1.createRule)({
-    name: 'no-jsdoc-terminator-in-example',
-    meta: {
-        type: 'problem',
-        docs: {
-            url: 'https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-reliability/docs/rules/no-jsdoc-terminator-in-example.md',
-            description: 'Detects `*/` sequences inside JSDoc @example blocks that prematurely close the comment',
-        },
-        hasSuggestions: true,
-        messages: {
-            jsdocTerminatorInExample: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.WARNING,
-                issueName: 'JSDoc Terminator in @example',
-                description: 'The `*/` sequence inside an @example block will prematurely close the JSDoc comment, causing compilation errors. Wrap the pattern in quotes or use an alternative representation.',
-                severity: 'HIGH',
-                fix: "Wrap the pattern containing `*/` in quotes, e.g. `'*/*'` instead of `*/*`",
-                documentationLink: 'https://jsdoc.app/tags-example',
-            }),
-            wrapInQuotes: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.INFO,
-                issueName: 'Wrap Pattern in Quotes',
-                description: "Wrap the `*/` pattern in single quotes to prevent premature JSDoc termination",
-                severity: 'LOW',
-                fix: "Replace `*/` with `'*/'` (single-quoted) inside the @example block",
-                documentationLink: 'https://jsdoc.app/tags-example',
-            }),
-        },
-        schema: [],
-    },
-    defaultOptions: [],
-    create(context) {
-        const sourceCode = context.sourceCode;
-        return {
-            Program() {
-                const comments = sourceCode.getAllComments();
-                for (const comment of comments) {
-                    if (comment.type !== 'Block') {
-                        continue;
-                    }
-                    const commentText = comment.value;
-                    if (!/@example\b/i.test(commentText) ||
-                        !commentText.includes('*/')) {
-                        continue;
-                    }
-                    const offsets = findTerminatorsInExamples(commentText);
-                    for (const offset of offsets) {
-                        const absoluteStart = comment.range[0] + 2 + offset;
-                        const absoluteEnd = absoluteStart + 2;
-                        context.report({
-                            loc: {
-                                start: sourceCode.getLocFromIndex(absoluteStart),
-                                end: sourceCode.getLocFromIndex(absoluteEnd),
-                            },
-                            messageId: 'jsdocTerminatorInExample',
-                            suggest: [
-                                {
-                                    messageId: 'wrapInQuotes',
-                                    fix: (fixer) => {
-                                        return fixer.replaceTextRange([absoluteStart, absoluteEnd], "'*/'");
-                                    },
-                                },
-                            ],
-                        });
-                    }
-                }
-            },
-        };
-    },
-});
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noJsdocTerminatorInExample=void 0;exports.findTerminatorsInExamples=findTerminatorsInExamples;const eslint_devkit_1=require("@interlace/eslint-devkit");function findTerminatorsInExamples(commentText){const lines=commentText.split("\n");let inExample=false;const offsets=[];let currentOffset=0;for(const line of lines){const stripped=line.replace(/^\s*\*?\s?/,"");if(/^\s*@example\b/i.test(stripped)){inExample=true;currentOffset+=line.length+1;continue}if(/^\s*@\w+/.test(stripped)&&!stripped.startsWith("@example")){inExample=false;currentOffset+=line.length+1;continue}if(inExample){let searchStart=0;while(searchStart<line.length){const idx=line.indexOf("*/",searchStart);if(idx===-1)break;const absoluteOffset=currentOffset+idx;const remaining=commentText.substring(absoluteOffset+2).trim();if(remaining.length>0){offsets.push(absoluteOffset)}searchStart=idx+2}}currentOffset+=line.length+1}return offsets}exports.noJsdocTerminatorInExample=(0,eslint_devkit_1.createRule)({name:"no-jsdoc-terminator-in-example",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-reliability/docs/rules/no-jsdoc-terminator-in-example.md",description:"Detects `*/` sequences inside JSDoc @example blocks that prematurely close the comment"},hasSuggestions:true,messages:{jsdocTerminatorInExample:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.WARNING,issueName:"JSDoc Terminator in @example",description:"The `*/` sequence inside an @example block will prematurely close the JSDoc comment, causing compilation errors. Wrap the pattern in quotes or use an alternative representation.",severity:"HIGH",fix:"Wrap the pattern containing `*/` in quotes, e.g. `'*/*'` instead of `*/*`",documentationLink:"https://jsdoc.app/tags-example"}),wrapInQuotes:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Wrap Pattern in Quotes",description:"Wrap the `*/` pattern in single quotes to prevent premature JSDoc termination",severity:"LOW",fix:"Replace `*/` with `'*/'` (single-quoted) inside the @example block",documentationLink:"https://jsdoc.app/tags-example"})},schema:[]},defaultOptions:[],create(context){const sourceCode=context.sourceCode;return{Program(){const comments=sourceCode.getAllComments();for(const comment of comments){if(comment.type!=="Block"){continue}const commentText=comment.value;if(!/@example\b/i.test(commentText)||!commentText.includes("*/")){continue}const offsets=findTerminatorsInExamples(commentText);for(const offset of offsets){const absoluteStart=comment.range[0]+2+offset;const absoluteEnd=absoluteStart+2;context.report({loc:{start:sourceCode.getLocFromIndex(absoluteStart),end:sourceCode.getLocFromIndex(absoluteEnd)},messageId:"jsdocTerminatorInExample",suggest:[{messageId:"wrapInQuotes",fix:fixer=>{return fixer.replaceTextRange([absoluteStart,absoluteEnd],"'*/'")}}]})}}}}}});

package/src/rules/reliability/no-missing-null-checks.js

@@ -1,413 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.noMissingNullChecks = void 0;
-exports.hasNullCheck = hasNullCheck;
-const eslint_devkit_1 = require("@interlace/eslint-devkit");
-const eslint_devkit_2 = require("@interlace/eslint-devkit");
-const NEVER_NULL_GLOBALS = new Set([
-    'console', 'process', 'Buffer', '__dirname', '__filename', 'module', 'exports', 'require',
-    'navigator', 'location', 'history',
-    'Math', 'JSON', 'Object', 'Array', 'Number', 'String', 'Boolean', 'Date',
-    'RegExp', 'Promise', 'Symbol', 'Map', 'Set', 'WeakMap', 'WeakSet',
-    'Proxy', 'Reflect', 'Intl', 'BigInt', 'WebAssembly', 'Atomics',
-    'URL', 'URLSearchParams', 'TextEncoder', 'TextDecoder',
-    'AbortController', 'AbortSignal', 'EventTarget', 'Event', 'CustomEvent',
-    'FormData', 'Blob', 'File', 'FileReader', 'Headers', 'Request', 'Response',
-    'Error', 'TypeError', 'RangeError', 'SyntaxError', 'URIError',
-    'EvalError', 'ReferenceError', 'AggregateError',
-    'fetch', 'crypto', 'performance', 'queueMicrotask',
-    'setTimeout', 'clearTimeout', 'setInterval', 'clearInterval',
-    'setImmediate', 'clearImmediate', 'requestAnimationFrame', 'cancelAnimationFrame',
-    'logger', 'log', 'winston', 'pino', 'bunyan',
-]);
-function isProvablyNonNullableIdentifier(ident, scope) {
-    if (NEVER_NULL_GLOBALS.has(ident.name))
-        return true;
-    let s = scope;
-    while (s) {
-        const variable = s.variables.find((v) => v.name === ident.name);
-        if (variable) {
-            for (const def of variable.defs) {
-                if (def.type === 'CatchClause')
-                    return true;
-                if (def.type === 'ImportBinding')
-                    return true;
-                if (def.type === 'Variable' && def.node?.type === 'VariableDeclarator') {
-                    const init = def.node.init;
-                    if (!init)
-                        continue;
-                    if (init.type === 'NewExpression')
-                        return true;
-                    if (init.type === 'ArrayExpression')
-                        return true;
-                    if (init.type === 'ObjectExpression')
-                        return true;
-                    if (init.type === 'TemplateLiteral')
-                        return true;
-                    if (init.type === 'ClassExpression')
-                        return true;
-                    if (init.type === 'Literal' && init.value !== null)
-                        return true;
-                    if (init.type === 'AwaitExpression' &&
-                        init.argument.type === 'CallExpression' &&
-                        init.argument.callee.type === 'Identifier' &&
-                        init.argument.callee.name === 'fetch')
-                        return true;
-                    if (init.type === 'CallExpression' &&
-                        init.callee.type === 'MemberExpression' &&
-                        init.callee.object.type === 'Identifier' &&
-                        (init.callee.object.name === 'Object' || init.callee.object.name === 'Array' ||
-                            init.callee.object.name === 'JSON'))
-                        return true;
-                }
-                if (def.type === 'FunctionName')
-                    return true;
-                if (def.type === 'ClassName')
-                    return true;
-                if (def.type === 'Parameter')
-                    return true;
-            }
-            return false;
-        }
-        s = s.upper;
-    }
-    return false;
-}
-function hasNullCheck(node, sourceCode) {
-    if (node.optional) {
-        return true;
-    }
-    const parent = node.parent;
-    if (parent && parent.type === 'ChainExpression') {
-        return true;
-    }
-    if (usesNullishCoalescing(node)) {
-        return true;
-    }
-    const objectText = sourceCode.getText(node.object);
-    const immediateParent = parent;
-    const nodeOrCall = immediateParent?.type === 'CallExpression' &&
-        immediateParent.callee === node
-        ? immediateParent
-        : node;
-    const andParent = nodeOrCall
-        .parent;
-    if (andParent?.type === 'LogicalExpression' &&
-        andParent.operator === '&&' &&
-        andParent.right === nodeOrCall) {
-        const leftText = sourceCode.getText(andParent.left);
-        if (leftText === objectText || leftText.endsWith(objectText))
-            return true;
-    }
-    let cur = node;
-    for (let depth = 0; depth < 8; depth++) {
-        const p = cur.parent;
-        if (!p)
-            break;
-        if (p.type === 'ConditionalExpression' &&
-            p.consequent === cur) {
-            if (sourceCode.getText(p.test) === objectText) {
-                return true;
-            }
-        }
-        cur = p;
-    }
-    if (hasExplicitNullCheck(node, sourceCode)) {
-        return true;
-    }
-    return false;
-}
-function hasExplicitNullCheck(node, sourceCode) {
-    let current = node;
-    let depth = 0;
-    const maxDepth = 10;
-    while (current && depth < maxDepth) {
-        const parent = current
-            .parent;
-        if (parent && parent.type === 'IfStatement') {
-            const test = parent.test;
-            if (isNullCheckForObject(test, node.object, sourceCode)) {
-                return true;
-            }
-        }
-        current = parent;
-        depth++;
-    }
-    return false;
-}
-function isNullCheckForObject(test, object, sourceCode) {
-    const objectText = sourceCode.getText(object);
-    if (test.type === 'Identifier' || test.type === 'MemberExpression') {
-        const testText = sourceCode.getText(test);
-        if (testText === objectText || objectText.startsWith(testText + '.')) {
-            return true;
-        }
-    }
-    if (test.type === 'BinaryExpression') {
-        const { left, right, operator } = test;
-        if (operator === '!==' ||
-            operator === '!=' ||
-            operator === '===' ||
-            operator === '==') {
-            const leftText = sourceCode.getText(left);
-            const rightText = sourceCode.getText(right);
-            if ((leftText === objectText &&
-                (rightText === 'null' || rightText === 'undefined')) ||
-                (rightText === objectText &&
-                    (leftText === 'null' || leftText === 'undefined'))) {
-                return true;
-            }
-        }
-    }
-    if (test.type === 'LogicalExpression') {
-        return (isNullCheckForObject(test.left, object, sourceCode) ||
-            isNullCheckForObject(test.right, object, sourceCode));
-    }
-    return false;
-}
-function usesNullishCoalescing(node) {
-    let current = node;
-    let depth = 0;
-    const maxDepth = 5;
-    while (current && depth < maxDepth) {
-        const parent = current
-            .parent;
-        if (parent &&
-            parent.type === 'LogicalExpression' &&
-            parent.operator === '??') {
-            return true;
-        }
-        current = parent;
-        depth++;
-    }
-    return false;
-}
-exports.noMissingNullChecks = (0, eslint_devkit_2.createRule)({
-    name: 'no-missing-null-checks',
-    meta: {
-        type: 'problem',
-        docs: {
-            url: 'https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-reliability/docs/rules/no-missing-null-checks.md',
-            description: 'Detects potential null pointer dereferences',
-            cwe: 'CWE-476',
-            cvss: 7.5,
-        },
-        hasSuggestions: true,
-        messages: {
-            missingNullCheck: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.WARNING,
-                issueName: 'Missing null check',
-                cwe: 'CWE-476',
-                description: 'Potential null/undefined dereference detected',
-                severity: 'HIGH',
-                fix: 'Use optional chaining (?.) or add explicit null check',
-                documentationLink: 'https://rules.sonarsource.com/javascript/RSPEC-2259/',
-            }),
-            useOptionalChaining: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.INFO,
-                issueName: 'Use Optional Chaining',
-                description: 'Use optional chaining operator',
-                severity: 'LOW',
-                fix: 'obj?.property?.method()',
-                documentationLink: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Optional_chaining',
-            }),
-            useNullishCoalescing: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.INFO,
-                issueName: 'Use Nullish Coalescing',
-                description: 'Use nullish coalescing operator',
-                severity: 'LOW',
-                fix: 'value ?? defaultValue',
-                documentationLink: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing',
-            }),
-            addExplicitCheck: (0, eslint_devkit_1.formatLLMMessage)({
-                icon: eslint_devkit_1.MessageIcons.INFO,
-                issueName: 'Add Explicit Check',
-                description: 'Add explicit null check',
-                severity: 'LOW',
-                fix: 'if (obj !== null) { obj.property }',
-                documentationLink: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/null',
-            }),
-        },
-        schema: [
-            {
-                type: 'object',
-                properties: {
-                    ignoreInTests: {
-                        type: 'boolean',
-                        default: true,
-                        description: 'Ignore in test files',
-                    },
-                    requireExplicitChecks: {
-                        type: 'boolean',
-                        default: false,
-                        description: 'Require explicit null checks',
-                    },
-                },
-                additionalProperties: false,
-            },
-        ],
-    },
-    defaultOptions: [
-        {
-            ignoreInTests: true,
-            requireExplicitChecks: false,
-        },
-    ],
-    create(context, [options = {}]) {
-        const { ignoreInTests = true, } = options || {};
-        const filename = context.filename;
-        const isTestFile = ignoreInTests && /\.(test|spec)\.(ts|tsx|js|jsx)$/.test(filename);
-        if (isTestFile) {
-            return {};
-        }
-        const sourceCode = context.sourceCode;
-        const reportedMemberExpressions = new Set();
-        function getMemberExpressionKey(node) {
-            if (node.range && Array.isArray(node.range) && node.range.length >= 2) {
-                return `me-${node.range[0]}-${node.range[1]}`;
-            }
-            const loc = node
-                .loc;
-            if (loc && loc.start) {
-                return `me-${loc.start.line}-${loc.start.column}-${loc.end?.line || loc.start.line}-${loc.end?.column || loc.start.column}`;
-            }
-            return `me-${JSON.stringify(node).slice(0, 50)}`;
-        }
-        function checkMemberExpression(node) {
-            if (node.optional) {
-                return;
-            }
-            const parent = node
-                .parent;
-            if (parent && parent.type === 'ChainExpression') {
-                return;
-            }
-            if (parent &&
-                parent.type === 'MemberExpression' &&
-                parent.object === node) {
-                return;
-            }
-            const objectNode = node.object;
-            let shouldCheck = false;
-            if (objectNode.type === 'Identifier') {
-                if (isProvablyNonNullableIdentifier(objectNode, sourceCode.getScope(node))) {
-                    return;
-                }
-                shouldCheck = true;
-            }
-            else if (objectNode.type === 'MemberExpression') {
-                let base = objectNode;
-                while (base.type === 'MemberExpression') {
-                    base = base.object;
-                }
-                if (base.type === 'ThisExpression')
-                    return;
-                if (base.type === 'Identifier' &&
-                    isProvablyNonNullableIdentifier(base, sourceCode.getScope(node))) {
-                    return;
-                }
-                shouldCheck = true;
-            }
-            if (shouldCheck && !hasNullCheck(node, sourceCode)) {
-                const nodeKey = getMemberExpressionKey(node);
-                if (reportedMemberExpressions.has(nodeKey)) {
-                    return;
-                }
-                try {
-                    reportedMemberExpressions.add(nodeKey);
-                    context.report({
-                        node,
-                        messageId: 'missingNullCheck',
-                        suggest: [
-                            {
-                                messageId: 'useOptionalChaining',
-                                fix: () => null,
-                            },
-                            {
-                                messageId: 'useNullishCoalescing',
-                                fix: () => null,
-                            },
-                            {
-                                messageId: 'addExplicitCheck',
-                                fix: () => null,
-                            },
-                        ],
-                    });
-                }
-                catch {
-                    return;
-                }
-            }
-        }
-        function checkCallExpression(node) {
-            if (node.type !== 'CallExpression') {
-                return;
-            }
-            if (node.callee.type === 'MemberExpression') {
-                const memberExpr = node.callee;
-                if (memberExpr.optional) {
-                    return;
-                }
-                const parent = memberExpr.parent;
-                if (parent && parent.type === 'ChainExpression') {
-                    return;
-                }
-                const objectNode = memberExpr.object;
-                let shouldCheck = false;
-                if (objectNode.type === 'Identifier') {
-                    if (isProvablyNonNullableIdentifier(objectNode, sourceCode.getScope(memberExpr))) {
-                        return;
-                    }
-                    shouldCheck = true;
-                }
-                else if (objectNode.type === 'MemberExpression') {
-                    let base = objectNode;
-                    while (base.type === 'MemberExpression') {
-                        base = base.object;
-                    }
-                    if (base.type === 'ThisExpression')
-                        return;
-                    if (base.type === 'Identifier' &&
-                        isProvablyNonNullableIdentifier(base, sourceCode.getScope(memberExpr))) {
-                        return;
-                    }
-                    shouldCheck = true;
-                }
-                if (shouldCheck && !hasNullCheck(memberExpr, sourceCode)) {
-                    const nodeKey = getMemberExpressionKey(memberExpr);
-                    if (reportedMemberExpressions.has(nodeKey)) {
-                        return;
-                    }
-                    try {
-                        reportedMemberExpressions.add(nodeKey);
-                        context.report({
-                            node: memberExpr,
-                            messageId: 'missingNullCheck',
-                            suggest: [
-                                {
-                                    messageId: 'useOptionalChaining',
-                                    fix: () => null,
-                                },
-                                {
-                                    messageId: 'useNullishCoalescing',
-                                    fix: () => null,
-                                },
-                                {
-                                    messageId: 'addExplicitCheck',
-                                    fix: () => null,
-                                },
-                            ],
-                        });
-                    }
-                    catch {
-                        return;
-                    }
-                }
-            }
-        }
-        return {
-            MemberExpression: checkMemberExpression,
-            CallExpression: checkCallExpression,
-        };
-    },
-});
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noMissingNullChecks=void 0;exports.hasNullCheck=hasNullCheck;const eslint_devkit_1=require("@interlace/eslint-devkit");const eslint_devkit_2=require("@interlace/eslint-devkit");const NEVER_NULL_GLOBALS=new Set(["console","process","Buffer","__dirname","__filename","module","exports","require","navigator","location","history","Math","JSON","Object","Array","Number","String","Boolean","Date","RegExp","Promise","Symbol","Map","Set","WeakMap","WeakSet","Proxy","Reflect","Intl","BigInt","WebAssembly","Atomics","URL","URLSearchParams","TextEncoder","TextDecoder","AbortController","AbortSignal","EventTarget","Event","CustomEvent","FormData","Blob","File","FileReader","Headers","Request","Response","Error","TypeError","RangeError","SyntaxError","URIError","EvalError","ReferenceError","AggregateError","fetch","crypto","performance","queueMicrotask","setTimeout","clearTimeout","setInterval","clearInterval","setImmediate","clearImmediate","requestAnimationFrame","cancelAnimationFrame","logger","log","winston","pino","bunyan"]);function isProvablyNonNullableIdentifier(ident,scope){if(NEVER_NULL_GLOBALS.has(ident.name))return true;let s=scope;while(s){const variable=s.variables.find(v=>v.name===ident.name);if(variable){for(const def of variable.defs){if(def.type==="CatchClause")return true;if(def.type==="ImportBinding")return true;if(def.type==="Variable"&&def.node?.type==="VariableDeclarator"){const init=def.node.init;if(!init)continue;if(init.type==="NewExpression")return true;if(init.type==="ArrayExpression")return true;if(init.type==="ObjectExpression")return true;if(init.type==="TemplateLiteral")return true;if(init.type==="ClassExpression")return true;if(init.type==="Literal"&&init.value!==null)return true;if(init.type==="AwaitExpression"&&init.argument.type==="CallExpression"&&init.argument.callee.type==="Identifier"&&init.argument.callee.name==="fetch")return true;if(init.type==="CallExpression"&&init.callee.type==="MemberExpression"&&init.callee.object.type==="Identifier"&&(init.callee.object.name==="Object"||init.callee.object.name==="Array"||init.callee.object.name==="JSON"))return true}if(def.type==="FunctionName")return true;if(def.type==="ClassName")return true;if(def.type==="Parameter")return true}return false}s=s.upper}return false}function hasNullCheck(node,sourceCode){if(node.optional){return true}const parent=node.parent;if(parent&&parent.type==="ChainExpression"){return true}if(usesNullishCoalescing(node)){return true}const objectText=sourceCode.getText(node.object);const immediateParent=parent;const nodeOrCall=immediateParent?.type==="CallExpression"&&immediateParent.callee===node?immediateParent:node;const andParent=nodeOrCall.parent;if(andParent?.type==="LogicalExpression"&&andParent.operator==="&&"&&andParent.right===nodeOrCall){const leftText=sourceCode.getText(andParent.left);if(leftText===objectText||leftText.endsWith(objectText))return true}let cur=node;for(let depth=0;depth<8;depth++){const p=cur.parent;if(!p)break;if(p.type==="ConditionalExpression"&&p.consequent===cur){if(sourceCode.getText(p.test)===objectText){return true}}cur=p}if(hasExplicitNullCheck(node,sourceCode)){return true}return false}function hasExplicitNullCheck(node,sourceCode){let current=node;let depth=0;const maxDepth=10;while(current&&depth<maxDepth){const parent=current.parent;if(parent&&parent.type==="IfStatement"){const test=parent.test;if(isNullCheckForObject(test,node.object,sourceCode)){return true}}current=parent;depth++}return false}function isNullCheckForObject(test,object,sourceCode){const objectText=sourceCode.getText(object);if(test.type==="Identifier"||test.type==="MemberExpression"){const testText=sourceCode.getText(test);if(testText===objectText||objectText.startsWith(testText+".")){return true}}if(test.type==="BinaryExpression"){const{left,right,operator}=test;if(operator==="!=="||operator==="!="||operator==="==="||operator==="=="){const leftText=sourceCode.getText(left);const rightText=sourceCode.getText(right);if(leftText===objectText&&(rightText==="null"||rightText==="undefined")||rightText===objectText&&(leftText==="null"||leftText==="undefined")){return true}}}if(test.type==="LogicalExpression"){return isNullCheckForObject(test.left,object,sourceCode)||isNullCheckForObject(test.right,object,sourceCode)}return false}function usesNullishCoalescing(node){let current=node;let depth=0;const maxDepth=5;while(current&&depth<maxDepth){const parent=current.parent;if(parent&&parent.type==="LogicalExpression"&&parent.operator==="??"){return true}current=parent;depth++}return false}exports.noMissingNullChecks=(0,eslint_devkit_2.createRule)({name:"no-missing-null-checks",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-reliability/docs/rules/no-missing-null-checks.md",description:"Detects potential null pointer dereferences",cwe:"CWE-476",cvss:7.5},hasSuggestions:true,messages:{missingNullCheck:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.WARNING,issueName:"Missing null check",cwe:"CWE-476",description:"Potential null/undefined dereference detected",severity:"HIGH",fix:"Use optional chaining (?.) or add explicit null check",documentationLink:"https://rules.sonarsource.com/javascript/RSPEC-2259/"}),useOptionalChaining:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use Optional Chaining",description:"Use optional chaining operator",severity:"LOW",fix:"obj?.property?.method()",documentationLink:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Optional_chaining"}),useNullishCoalescing:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use Nullish Coalescing",description:"Use nullish coalescing operator",severity:"LOW",fix:"value ?? defaultValue",documentationLink:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing"}),addExplicitCheck:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Add Explicit Check",description:"Add explicit null check",severity:"LOW",fix:"if (obj !== null) { obj.property }",documentationLink:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/null"})},schema:[{type:"object",properties:{ignoreInTests:{type:"boolean",default:true,description:"Ignore in test files"},requireExplicitChecks:{type:"boolean",default:false,description:"Require explicit null checks"}},additionalProperties:false}]},defaultOptions:[{ignoreInTests:true,requireExplicitChecks:false}],create(context,[options={}]){const{ignoreInTests=true}=options||{};const filename=context.filename;const isTestFile=ignoreInTests&&/\.(test|spec)\.(ts|tsx|js|jsx)$/.test(filename);if(isTestFile){return{}}const sourceCode=context.sourceCode;const reportedMemberExpressions=new Set;function getMemberExpressionKey(node){if(node.range&&Array.isArray(node.range)&&node.range.length>=2){return`me-${node.range[0]}-${node.range[1]}`}const loc=node.loc;if(loc&&loc.start){return`me-${loc.start.line}-${loc.start.column}-${loc.end?.line||loc.start.line}-${loc.end?.column||loc.start.column}`}return`me-${JSON.stringify(node).slice(0,50)}`}function checkMemberExpression(node){if(node.optional){return}const parent=node.parent;if(parent&&parent.type==="ChainExpression"){return}if(parent&&parent.type==="MemberExpression"&&parent.object===node){return}const objectNode=node.object;let shouldCheck=false;if(objectNode.type==="Identifier"){if(isProvablyNonNullableIdentifier(objectNode,sourceCode.getScope(node))){return}shouldCheck=true}else if(objectNode.type==="MemberExpression"){let base=objectNode;while(base.type==="MemberExpression"){base=base.object}if(base.type==="ThisExpression")return;if(base.type==="Identifier"&&isProvablyNonNullableIdentifier(base,sourceCode.getScope(node))){return}shouldCheck=true}if(shouldCheck&&!hasNullCheck(node,sourceCode)){const nodeKey=getMemberExpressionKey(node);if(reportedMemberExpressions.has(nodeKey)){return}try{reportedMemberExpressions.add(nodeKey);context.report({node,messageId:"missingNullCheck",suggest:[{messageId:"useOptionalChaining",fix:()=>null},{messageId:"useNullishCoalescing",fix:()=>null},{messageId:"addExplicitCheck",fix:()=>null}]})}catch{return}}}function checkCallExpression(node){if(node.type!=="CallExpression"){return}if(node.callee.type==="MemberExpression"){const memberExpr=node.callee;if(memberExpr.optional){return}const parent=memberExpr.parent;if(parent&&parent.type==="ChainExpression"){return}const objectNode=memberExpr.object;let shouldCheck=false;if(objectNode.type==="Identifier"){if(isProvablyNonNullableIdentifier(objectNode,sourceCode.getScope(memberExpr))){return}shouldCheck=true}else if(objectNode.type==="MemberExpression"){let base=objectNode;while(base.type==="MemberExpression"){base=base.object}if(base.type==="ThisExpression")return;if(base.type==="Identifier"&&isProvablyNonNullableIdentifier(base,sourceCode.getScope(memberExpr))){return}shouldCheck=true}if(shouldCheck&&!hasNullCheck(memberExpr,sourceCode)){const nodeKey=getMemberExpressionKey(memberExpr);if(reportedMemberExpressions.has(nodeKey)){return}try{reportedMemberExpressions.add(nodeKey);context.report({node:memberExpr,messageId:"missingNullCheck",suggest:[{messageId:"useOptionalChaining",fix:()=>null},{messageId:"useNullishCoalescing",fix:()=>null},{messageId:"addExplicitCheck",fix:()=>null}]})}catch{return}}}}return{MemberExpression:checkMemberExpression,CallExpression:checkCallExpression}}});