@clipboard-health/oxlint-plugin 1.0.0

package/src/lib/rules/require-contract-response-parse/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Require contract-package response schemas before response-shape assertions.
+ *
+ * Migration playbook:
+ * 1. Find the endpoint in its `@clipboard-health/contract-*` package and use the schema for the
+ *    asserted status code, commonly `contract.endpoint.responses[status]` or an exported
+ *    `XResponseSchema`.
+ * 2. Parse before shape assertions with `parseBody(response, schema)` or
+ *    `schema.parse(response.parsedBody)`, then assert on the parsed value.
+ * 3. If the contract package has no response schema, file a contract-gap ticket and add the schema
+ *    there. An inline permissive schema or ESLint exemption is not a contract oracle.
+ *
+ * Warn-to-error ratchet:
+ * Enable the rule as a warning across the migration scope. Migrate one directory at a time and add
+ * an error-level override for each completed directory. CI may suppress the warning backlog with
+ * `--quiet`, making every error-level directory a blocking ratchet. Once the full scope is migrated,
+ * replace the overrides with one error-level setting and restore the zero-warning budget.
+ */
+import type { Rule } from "@oxlint/plugins";
+declare const rule: Rule;
+export default rule;

package/src/lib/rules/require-contract-response-parse/index.js

@@ -0,0 +1,368 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const findVariable_1 = require("../../internal/findVariable");
+const CONTRACT_PACKAGE_PREFIX = "@clipboard-health/contract-";
+const ANY_SCHEMA_METHODS = new Set(["any", "unknown"]);
+const SCHEMA_PARSE_METHODS = new Set(["parse", "parseAsync"]);
+const MATCHER_MODIFIERS = new Set(["not", "rejects", "resolves"]);
+const CONTROL_FLOW_TYPES = new Set([
+    "CatchClause",
+    "ConditionalExpression",
+    "DoWhileStatement",
+    "ForInStatement",
+    "ForOfStatement",
+    "ForStatement",
+    "IfStatement",
+    "LogicalExpression",
+    "SwitchCase",
+    "SwitchStatement",
+    "TryStatement",
+    "WhileStatement",
+]);
+function unwrap(node) {
+    let current = node;
+    while (current?.type === "ChainExpression" ||
+        current?.type === "TSAsExpression" ||
+        current?.type === "TSInstantiationExpression" ||
+        current?.type === "TSNonNullExpression" ||
+        current?.type === "TSSatisfiesExpression" ||
+        current?.type === "TSTypeAssertion") {
+        current = current.expression;
+    }
+    return current;
+}
+function memberPropertyName(node) {
+    if (!node.computed && node.property.type === "Identifier") {
+        return node.property.name;
+    }
+    if (node.computed && node.property.type === "Literal") {
+        return typeof node.property.value === "string" ? node.property.value : undefined;
+    }
+    return undefined;
+}
+function containingFunction(node) {
+    let current = node.parent;
+    while (current) {
+        if (current.type === "ArrowFunctionExpression" ||
+            current.type === "FunctionDeclaration" ||
+            current.type === "FunctionExpression") {
+            return current;
+        }
+        current = current.parent;
+    }
+    return undefined;
+}
+function addEvidence(collection, key, node) {
+    const nodes = collection.get(key) ?? [];
+    nodes.push(node);
+    collection.set(key, nodes);
+}
+function isAncestor(ancestor, node) {
+    let current = node;
+    while (current) {
+        if (current === ancestor) {
+            return true;
+        }
+        current = current.parent;
+    }
+    return false;
+}
+function directChild(ancestor, node) {
+    let current = node;
+    while (current?.parent && current.parent !== ancestor) {
+        current = current.parent;
+    }
+    return current?.parent === ancestor ? current : undefined;
+}
+function objectContainsParsedBodyProperty(node) {
+    if (node?.type !== "ObjectExpression") {
+        return false;
+    }
+    return node.properties.some((property) => {
+        if (property.type !== "Property") {
+            return false;
+        }
+        const propertyName = property.key.type === "Identifier"
+            ? property.key.name
+            : property.key.type === "Literal"
+                ? property.key.value
+                : undefined;
+        return propertyName === "parsedBody" || objectContainsParsedBodyProperty(property.value);
+    });
+}
+function isParsedBodyPropertyPath(node) {
+    if (node?.type === "Literal" && typeof node.value === "string") {
+        return /^parsedBody(?:\.|\[|$)/u.test(node.value);
+    }
+    return (node?.type === "ArrayExpression" &&
+        node.elements[0]?.type === "Literal" &&
+        node.elements[0].value === "parsedBody");
+}
+const rule = {
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Require response assertions to use contract-package schemas",
+            url: "https://github.com/ClipboardHealth/core-utils/tree/main/packages/eslint-plugin/src/lib/rules/require-contract-response-parse",
+        },
+        schema: [],
+        messages: {
+            inlineAnySchema: "Inline z.{{method}}() schemas are not contract oracles. Use the endpoint response schema from a @clipboard-health/contract-* package.",
+            missingContractParse: "Parse this response body with its @clipboard-health/contract-* response schema before asserting its shape.",
+            nonContractSchema: "This schema is not a contract oracle. Use the endpoint response schema from a @clipboard-health/contract-* package.",
+        },
+    },
+    create(context) {
+        const contractBindings = new Set();
+        const zodBindings = new Set();
+        const functionStates = new Map();
+        const topLevelState = {
+            parses: new Map(),
+            writes: new Map(),
+        };
+        const validatedParsedBodyAccesses = new WeakSet();
+        function rootIdentifier(node) {
+            let current = unwrap(node);
+            while (current?.type === "MemberExpression") {
+                current = unwrap(current.object);
+            }
+            return current?.type === "Identifier" ? current : undefined;
+        }
+        function parsedBodyAccess(node) {
+            let current = unwrap(node);
+            while (current?.type === "MemberExpression") {
+                if (memberPropertyName(current) === "parsedBody") {
+                    return current;
+                }
+                current = unwrap(current.object);
+            }
+            return undefined;
+        }
+        function findVariable(node) {
+            return (0, findVariable_1.findVariable)(context.sourceCode, node);
+        }
+        function responseKey(node) {
+            const current = unwrap(node);
+            if (current?.type === "Identifier") {
+                return findVariable(current) ?? current.name;
+            }
+            if (current?.type === "MemberExpression") {
+                return context.sourceCode.getText(current);
+            }
+            return undefined;
+        }
+        function isContractSchema(node) {
+            const identifier = rootIdentifier(node);
+            if (!identifier) {
+                return false;
+            }
+            const variable = findVariable(identifier);
+            return variable !== undefined && contractBindings.has(variable);
+        }
+        function stateFor(node) {
+            const functionNode = containingFunction(node);
+            if (!functionNode) {
+                return topLevelState;
+            }
+            const existingState = functionStates.get(functionNode);
+            if (existingState) {
+                return existingState;
+            }
+            const state = { parses: new Map(), writes: new Map() };
+            functionStates.set(functionNode, state);
+            return state;
+        }
+        function parseDominatesAssertion(parseNode, assertionNode) {
+            if (containingFunction(parseNode) !== containingFunction(assertionNode) ||
+                parseNode.range[0] >= assertionNode.range[0]) {
+                return false;
+            }
+            let current = parseNode.parent;
+            const functionNode = containingFunction(parseNode);
+            while (current && current !== functionNode) {
+                if (CONTROL_FLOW_TYPES.has(current.type) &&
+                    (!isAncestor(current, assertionNode) ||
+                        directChild(current, parseNode) !== directChild(current, assertionNode))) {
+                    return false;
+                }
+                current = current.parent;
+            }
+            return true;
+        }
+        function hasContractParse(node, key) {
+            const state = stateFor(node);
+            const parses = state.parses.get(key) ?? [];
+            const writes = state.writes.get(key) ?? [];
+            return parses.some((parseNode) => parseDominatesAssertion(parseNode, node) &&
+                !writes.some((writeNode) => writeNode.range[0] > parseNode.range[1] && writeNode.range[0] < node.range[0]));
+        }
+        function recordResponseWrite(node, expression) {
+            const key = responseKey(expression);
+            if (key !== undefined) {
+                addEvidence(stateFor(node).writes, key, node);
+            }
+        }
+        function checkParseBody(node) {
+            if (node.callee.type !== "Identifier" || node.callee.name !== "parseBody") {
+                return;
+            }
+            const [response, schema] = node.arguments;
+            if (!response || !schema) {
+                return;
+            }
+            if (!isContractSchema(schema)) {
+                context.report({ node: schema, messageId: "nonContractSchema" });
+                return;
+            }
+            const key = responseKey(response);
+            if (key !== undefined) {
+                addEvidence(stateFor(node).parses, key, node);
+            }
+        }
+        function checkSchemaParse(node) {
+            if (node.callee.type !== "MemberExpression" ||
+                !SCHEMA_PARSE_METHODS.has(memberPropertyName(node.callee) ?? "") ||
+                !isContractSchema(node.callee.object)) {
+                return;
+            }
+            const argument = unwrap(node.arguments[0]);
+            const access = parsedBodyAccess(argument);
+            if (!access || argument !== access) {
+                return;
+            }
+            validatedParsedBodyAccesses.add(access);
+            const key = responseKey(access.object);
+            if (key !== undefined) {
+                addEvidence(stateFor(node).parses, key, node);
+            }
+        }
+        function checkParsedBodyAccess(node) {
+            if (memberPropertyName(node) !== "parsedBody" || validatedParsedBodyAccesses.has(node)) {
+                return;
+            }
+            const key = responseKey(node.object);
+            if (key === undefined || !hasContractParse(node, key)) {
+                context.report({ node, messageId: "missingContractParse" });
+            }
+        }
+        function expectCall(node) {
+            if (node.callee.type !== "MemberExpression") {
+                return undefined;
+            }
+            let matcherTarget = node.callee.object;
+            while (matcherTarget.type === "MemberExpression" &&
+                MATCHER_MODIFIERS.has(memberPropertyName(matcherTarget) ?? "")) {
+                matcherTarget = matcherTarget.object;
+            }
+            if (matcherTarget.type !== "CallExpression" ||
+                matcherTarget.callee.type !== "Identifier" ||
+                matcherTarget.callee.name !== "expect") {
+                return undefined;
+            }
+            return matcherTarget;
+        }
+        function checkWholeResponseAssertion(node) {
+            const expectation = expectCall(node);
+            if (!expectation) {
+                return;
+            }
+            const assertsParsedBodyProperty = node.arguments.some((argument) => objectContainsParsedBodyProperty(argument));
+            const matcherName = node.callee.type === "MemberExpression" ? memberPropertyName(node.callee) : undefined;
+            const assertsParsedBodyPath = matcherName === "toHaveProperty" && isParsedBodyPropertyPath(node.arguments[0]);
+            if (!assertsParsedBodyProperty && !assertsParsedBodyPath) {
+                return;
+            }
+            const key = responseKey(expectation.arguments[0]);
+            if (key !== undefined && !hasContractParse(node, key)) {
+                context.report({
+                    node: expectation,
+                    messageId: "missingContractParse",
+                });
+            }
+        }
+        function checkParsedBodyDestructuring(node) {
+            if (node.id.type !== "ObjectPattern") {
+                return;
+            }
+            const parsedBodyProperty = node.id.properties.find((property) => {
+                if (property.type !== "Property") {
+                    return false;
+                }
+                return ((property.key.type === "Identifier" && property.key.name === "parsedBody") ||
+                    (property.key.type === "Literal" && property.key.value === "parsedBody"));
+            });
+            if (!parsedBodyProperty) {
+                return;
+            }
+            const key = responseKey(node.init ?? undefined);
+            if (key === undefined || !hasContractParse(node, key)) {
+                context.report({
+                    node: parsedBodyProperty,
+                    messageId: "missingContractParse",
+                });
+            }
+        }
+        function checkInlineAnySchema(node) {
+            if (node.callee.type !== "MemberExpression") {
+                return;
+            }
+            const method = memberPropertyName(node.callee);
+            const identifier = rootIdentifier(node.callee.object);
+            if (!method || !ANY_SCHEMA_METHODS.has(method) || !identifier) {
+                return;
+            }
+            const variable = findVariable(identifier);
+            if (variable !== undefined && zodBindings.has(variable)) {
+                context.report({
+                    node,
+                    messageId: "inlineAnySchema",
+                    data: { method },
+                });
+            }
+        }
+        return {
+            ImportDeclaration(node) {
+                if (node.source.value.startsWith(CONTRACT_PACKAGE_PREFIX)) {
+                    for (const specifier of node.specifiers) {
+                        const [variable] = context.sourceCode.getDeclaredVariables(specifier);
+                        if (variable) {
+                            contractBindings.add(variable);
+                        }
+                    }
+                }
+                if (node.source.value === "zod") {
+                    for (const specifier of node.specifiers) {
+                        const importsZodNamespace = specifier.type === "ImportNamespaceSpecifier";
+                        const importsZodDefault = specifier.type === "ImportDefaultSpecifier";
+                        const importsZodBinding = specifier.type === "ImportSpecifier" &&
+                            specifier.imported.type === "Identifier" &&
+                            specifier.imported.name === "z";
+                        if (!importsZodNamespace && !importsZodDefault && !importsZodBinding) {
+                            continue;
+                        }
+                        const [variable] = context.sourceCode.getDeclaredVariables(specifier);
+                        if (variable) {
+                            zodBindings.add(variable);
+                        }
+                    }
+                }
+            },
+            CallExpression(node) {
+                checkInlineAnySchema(node);
+                checkParseBody(node);
+                checkSchemaParse(node);
+                checkWholeResponseAssertion(node);
+            },
+            MemberExpression: checkParsedBodyAccess,
+            VariableDeclarator: checkParsedBodyDestructuring,
+            AssignmentExpression(node) {
+                recordResponseWrite(node, node.left);
+            },
+            UpdateExpression(node) {
+                recordResponseWrite(node, node.argument);
+            },
+        };
+    },
+};
+exports.default = rule;
+//# sourceMappingURL=index.js.map

package/src/lib/rules/require-contract-response-parse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/oxlint-plugin/src/lib/rules/require-contract-response-parse/index.ts"],"names":[],"mappings":"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"}

package/src/lib/rules/require-http-module-factory/index.d.ts

@@ -0,0 +1,2 @@
+declare const rule: import("@oxlint/plugins").Rule;
+export default rule;

package/src/lib/rules/require-http-module-factory/index.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @fileoverview Rule to require HttpModule to use registerAsync factory to avoid shared axios client issues
+ */
+const plugins_1 = require("@oxlint/plugins");
+function isHttpModuleImport(specifier) {
+    return (specifier.type === "ImportSpecifier" &&
+        specifier.imported.type === "Identifier" &&
+        specifier.imported.name === "HttpModule");
+}
+function isImportsArray(node) {
+    const { parent } = node;
+    return (parent?.type === "Property" &&
+        parent.key.type === "Identifier" &&
+        parent.key.name === "imports" &&
+        parent.value === node);
+}
+const rule = (0, plugins_1.defineRule)({
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Require HttpModule to use registerAsync factory to avoid shared axios client issues",
+            url: "https://github.com/ClipboardHealth/core-utils/tree/main/packages/eslint-plugin/src/lib/rules/require-http-module-factory",
+        },
+        schema: [],
+        messages: {
+            requireFactory: "HttpModule must use .registerAsync() with a custom factory to create a new axios client instance. Direct HttpModule imports share the global axios client and can cause interceptor conflicts.",
+            wrongPackage: "HttpModule must be imported from '@nestjs/axios' package. Using HttpModule from other packages may not provide the expected factory methods.",
+            noImport: "HttpModule is used but not imported from '@nestjs/axios'. Import HttpModule and use .registerAsync() with a custom factory.",
+        },
+    },
+    create(context) {
+        let httpModuleImportedCorrectly = false;
+        let httpModuleImportName;
+        function checkHttpModuleUsage(element) {
+            if (element?.type !== "Identifier") {
+                return;
+            }
+            const isDirectHttpModule = element.name === "HttpModule";
+            const isAliasedHttpModule = httpModuleImportedCorrectly && element.name === httpModuleImportName;
+            if (isDirectHttpModule) {
+                const messageId = httpModuleImportedCorrectly ? "requireFactory" : "noImport";
+                context.report({ node: element, messageId });
+            }
+            else if (isAliasedHttpModule) {
+                context.report({ node: element, messageId: "requireFactory" });
+            }
+        }
+        return {
+            ImportDeclaration(node) {
+                if (node.source.value !== "@nestjs/axios") {
+                    return;
+                }
+                for (const specifier of node.specifiers) {
+                    if (isHttpModuleImport(specifier)) {
+                        httpModuleImportedCorrectly = true;
+                        httpModuleImportName = specifier.local.name;
+                    }
+                }
+            },
+            ArrayExpression(node) {
+                if (!isImportsArray(node)) {
+                    return;
+                }
+                for (const element of node.elements) {
+                    checkHttpModuleUsage(element);
+                }
+            },
+        };
+    },
+});
+exports.default = rule;
+//# sourceMappingURL=index.js.map

package/src/lib/rules/require-http-module-factory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/oxlint-plugin/src/lib/rules/require-http-module-factory/index.ts"],"names":[],"mappings":";;AAAA;;GAEG;AACH,6CAA0D;AAE1D,SAAS,kBAAkB,CAAC,SAA4C;IACtE,OAAO,CACL,SAAS,CAAC,IAAI,KAAK,iBAAiB;QACpC,SAAS,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY;QACxC,SAAS,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY,CACzC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAA4B;IAClD,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,OAAO,CACL,MAAM,EAAE,IAAI,KAAK,UAAU;QAC3B,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY;QAChC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS;QAC7B,MAAM,CAAC,KAAK,KAAK,IAAI,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,IAAI,GAAG,IAAA,oBAAU,EAAC;IACtB,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EACT,qFAAqF;YACvF,GAAG,EAAE,0HAA0H;SAChI;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,cAAc,EACZ,gMAAgM;YAClM,YAAY,EACV,8IAA8I;YAChJ,QAAQ,EACN,6HAA6H;SAChI;KACF;IACD,MAAM,CAAC,OAAO;QACZ,IAAI,2BAA2B,GAAG,KAAK,CAAC;QACxC,IAAI,oBAAwC,CAAC;QAE7C,SAAS,oBAAoB,CAAC,OAAsC;YAClE,IAAI,OAAO,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;gBACnC,OAAO;YACT,CAAC;YAED,MAAM,kBAAkB,GAAG,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC;YACzD,MAAM,mBAAmB,GACvB,2BAA2B,IAAI,OAAO,CAAC,IAAI,KAAK,oBAAoB,CAAC;YAEvE,IAAI,kBAAkB,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,2BAA2B,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC;gBAC9E,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YAC/C,CAAC;iBAAM,IAAI,mBAAmB,EAAE,CAAC;gBAC/B,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,OAAO;YACL,iBAAiB,CAAC,IAAI;gBACpB,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,eAAe,EAAE,CAAC;oBAC1C,OAAO;gBACT,CAAC;gBAED,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACxC,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;wBAClC,2BAA2B,GAAG,IAAI,CAAC;wBACnC,oBAAoB,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;oBAC9C,CAAC;gBACH,CAAC;YACH,CAAC;YAED,eAAe,CAAC,IAAI;gBAClB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1B,OAAO;gBACT,CAAC;gBAED,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACpC,oBAAoB,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;kBAEY,IAAI"}

package/src/lib/rules/require-run-validators-with-upsert/index.d.ts

@@ -0,0 +1,2 @@
+declare const rule: import("@oxlint/plugins").Rule;
+export default rule;

package/src/lib/rules/require-run-validators-with-upsert/index.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @fileoverview Rule to require runValidators: true when upsert: true is used in Mongoose operations
+ */
+const plugins_1 = require("@oxlint/plugins");
+const UPSERT_METHODS = new Set([
+    "updateOne",
+    "updateMany",
+    "findOneAndUpdate",
+    "findByIdAndUpdate",
+    "findOneAndReplace",
+    "replaceOne",
+]);
+function hasPropertyWithValue(property, name, value) {
+    return (property.type === "Property" &&
+        property.key.type === "Identifier" &&
+        property.key.name === name &&
+        property.value.type === "Literal" &&
+        property.value.value === value);
+}
+function findProperty(objectExpression, name) {
+    for (const property of objectExpression.properties) {
+        if (property.type === "Property" &&
+            property.key.type === "Identifier" &&
+            property.key.name === name) {
+            return property;
+        }
+    }
+    return undefined;
+}
+function hasUpsertTrue(objectExpression) {
+    return objectExpression.properties.some((property) => hasPropertyWithValue(property, "upsert", true));
+}
+function hasRunValidatorsTrue(objectExpression) {
+    return objectExpression.properties.some((property) => hasPropertyWithValue(property, "runValidators", true));
+}
+function hasRunValidatorsFalse(objectExpression) {
+    return objectExpression.properties.some((property) => hasPropertyWithValue(property, "runValidators", false));
+}
+function hasRunValidatorsProperty(objectExpression) {
+    return objectExpression.properties.some((property) => property.type === "Property" &&
+        property.key.type === "Identifier" &&
+        property.key.name === "runValidators");
+}
+const rule = (0, plugins_1.defineRule)({
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Require runValidators: true when upsert: true is used in Mongoose update operations",
+            url: "https://github.com/ClipboardHealth/core-utils/tree/main/packages/eslint-plugin/src/lib/rules/require-run-validators-with-upsert",
+        },
+        schema: [],
+        messages: {
+            missingRunValidators: "Mongoose upsert operations must include 'runValidators: true' to ensure schema validation on inserted documents. Add 'runValidators: true' to the options object.",
+            runValidatorsFalse: "Mongoose upsert operations should not have 'runValidators: false'. Schema validation should be enabled for upserts to ensure data integrity.",
+        },
+    },
+    create(context) {
+        return {
+            CallExpression(node) {
+                if (node.callee.type !== "MemberExpression") {
+                    return;
+                }
+                const { property } = node.callee;
+                if (property.type !== "Identifier") {
+                    return;
+                }
+                if (!UPSERT_METHODS.has(property.name)) {
+                    return;
+                }
+                for (const argument of node.arguments) {
+                    if (argument.type !== "ObjectExpression") {
+                        continue;
+                    }
+                    if (!hasUpsertTrue(argument)) {
+                        continue;
+                    }
+                    if (hasRunValidatorsTrue(argument)) {
+                        continue;
+                    }
+                    if (hasRunValidatorsFalse(argument)) {
+                        const runValidatorsProperty = findProperty(argument, "runValidators");
+                        if (runValidatorsProperty) {
+                            context.report({
+                                node: runValidatorsProperty,
+                                messageId: "runValidatorsFalse",
+                            });
+                        }
+                        continue;
+                    }
+                    // If runValidators is present with a non-literal value (e.g., a variable),
+                    // we consider it valid since the developer is explicitly setting it.
+                    if (hasRunValidatorsProperty(argument)) {
+                        continue;
+                    }
+                    const upsertProperty = findProperty(argument, "upsert");
+                    if (upsertProperty) {
+                        context.report({
+                            node: upsertProperty,
+                            messageId: "missingRunValidators",
+                        });
+                    }
+                }
+            },
+        };
+    },
+});
+exports.default = rule;
+//# sourceMappingURL=index.js.map

package/src/lib/rules/require-run-validators-with-upsert/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/oxlint-plugin/src/lib/rules/require-run-validators-with-upsert/index.ts"],"names":[],"mappings":"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"}

package/src/lib/rules/require-zod-import-in-contracts/index.d.ts

@@ -0,0 +1,2 @@
+declare const rule: import("@oxlint/plugins").Rule;
+export default rule;