invar-tools 1.17.2__py3-none-any.whl → 1.17.3__py3-none-any.whl

invar/node_tools/eslint-plugin/rules/require-complete-validation.js

@@ -0,0 +1,104 @@
+/**
+ * Rule: require-complete-validation
+ *
+ * Detect functions where some parameters have Zod schema validation but others don't.
+ * Either all parameters should be validated, or none should be.
+ *
+ * Detects:
+ * - Functions with mixed z.infer<typeof Schema> and plain types
+ */
+/**
+ * Check if a parameter type is a Zod inferred type
+ * Looks for: z.infer<typeof SchemaName>
+ */
+function isZodInferType(typeAnnotation) {
+    if (!typeAnnotation || typeAnnotation.type !== 'TSTypeReference') {
+        return false;
+    }
+    const typeRef = typeAnnotation;
+    // Check for z.infer type
+    if (typeRef.typeName.type === 'TSQualifiedName' &&
+        typeRef.typeName.left.type === 'Identifier' &&
+        typeRef.typeName.left.name === 'z' &&
+        typeRef.typeName.right.type === 'Identifier' &&
+        typeRef.typeName.right.name === 'infer') {
+        return true;
+    }
+    // Also check for direct TypeOf reference: typeof SchemaName
+    if (typeRef.typeParameters && typeRef.typeParameters.params.length > 0) {
+        const firstParam = typeRef.typeParameters.params[0];
+        if (firstParam.type === 'TSTypeQuery') {
+            return true;
+        }
+    }
+    return false;
+}
+export const requireCompleteValidation = {
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Require all function parameters to be validated, or none',
+            recommended: true,
+        },
+        schema: [],
+        messages: {
+            partialValidation: 'Function has {{validated}} parameter(s) with Zod schema validation but {{unvalidated}} without. ' +
+                'Either validate all parameters or use plain TypeScript types for all.',
+        },
+    },
+    create(context) {
+        function checkFunction(node) {
+            const params = node.params;
+            if (params.length === 0) {
+                return; // No parameters to check
+            }
+            let validatedCount = 0;
+            let unvalidatedCount = 0;
+            for (const param of params) {
+                if (param.type === 'Identifier' && param.typeAnnotation) {
+                    const typeAnnotation = param.typeAnnotation.typeAnnotation;
+                    if (isZodInferType(typeAnnotation)) {
+                        validatedCount++;
+                    }
+                    else {
+                        unvalidatedCount++;
+                    }
+                }
+                else if (param.type === 'AssignmentPattern') {
+                    // Handle default parameters: param: Type = defaultValue
+                    if (param.left.type === 'Identifier' && param.left.typeAnnotation) {
+                        const typeAnnotation = param.left.typeAnnotation.typeAnnotation;
+                        if (isZodInferType(typeAnnotation)) {
+                            validatedCount++;
+                        }
+                        else {
+                            unvalidatedCount++;
+                        }
+                    }
+                }
+                else {
+                    // Other parameter types (rest, destructuring) count as unvalidated
+                    unvalidatedCount++;
+                }
+            }
+            // Report if we have a mix of validated and unvalidated parameters
+            if (validatedCount > 0 && unvalidatedCount > 0) {
+                context.report({
+                    node: node,
+                    messageId: 'partialValidation',
+                    data: {
+                        validated: String(validatedCount),
+                        unvalidated: String(unvalidatedCount),
+                    },
+                });
+            }
+        }
+        return {
+            FunctionDeclaration: checkFunction,
+            FunctionExpression: checkFunction,
+            ArrowFunctionExpression: checkFunction,
+        };
+    },
+};
+export default requireCompleteValidation;
+//# sourceMappingURL=require-complete-validation.js.map

invar/node_tools/eslint-plugin/rules/require-complete-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-complete-validation.js","sourceRoot":"","sources":["../../src/rules/require-complete-validation.ts"],"names":[],"mappings":"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"}

invar/node_tools/eslint-plugin/rules/require-jsdoc-example.js

@@ -0,0 +1,81 @@
+/**
+ * Rule: require-jsdoc-example
+ *
+ * Exported functions must have @example in JSDoc.
+ * Examples serve as documentation and can be used for doctest-style testing.
+ */
+function isExported(node) {
+    const parent = node.parent;
+    if (!parent)
+        return false;
+    if (parent.type === 'ExportNamedDeclaration')
+        return true;
+    if (parent.type === 'ExportDefaultDeclaration')
+        return true;
+    return false;
+}
+export const requireJsdocExample = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Exported functions must have @example in JSDoc',
+            recommended: true,
+        },
+        schema: [],
+        messages: {
+            missingExample: 'Exported function "{{name}}" must have @example in JSDoc (required for doctest)',
+        },
+    },
+    create(context) {
+        function checkFunction(node, name, skipExportCheck = false) {
+            if (!name)
+                return;
+            // Only check export status if not already verified by selector
+            if (!skipExportCheck && !isExported(node))
+                return;
+            // Check for @example in leading comments
+            const sourceCode = context.sourceCode || context.getSourceCode();
+            const comments = sourceCode.getCommentsBefore(node);
+            const hasExample = comments.some(comment => comment.type === 'Block' &&
+                comment.value.includes('@example'));
+            if (!hasExample) {
+                context.report({
+                    node,
+                    messageId: 'missingExample',
+                    data: { name },
+                });
+            }
+        }
+        return {
+            FunctionDeclaration(node) {
+                checkFunction(node, node.id?.name || null);
+            },
+            // Also check arrow functions assigned to exported variables
+            // Selector guarantees this is already exported, so skipExportCheck=true
+            'ExportNamedDeclaration > VariableDeclaration > VariableDeclarator > ArrowFunctionExpression'(node) {
+                const anyNode = node;
+                const name = anyNode.parent?.id?.name || null;
+                if (!name)
+                    return;
+                // For exported variables, the JSDoc is typically before the ExportNamedDeclaration,
+                // not before the ArrowFunctionExpression
+                const sourceCode = context.sourceCode || context.getSourceCode();
+                const exportDeclaration = anyNode.parent?.parent?.parent;
+                const comments = exportDeclaration?.type === 'ExportNamedDeclaration'
+                    ? sourceCode.getCommentsBefore(exportDeclaration)
+                    : sourceCode.getCommentsBefore(node);
+                const hasExample = comments.some((comment) => comment.type === 'Block' &&
+                    comment.value.includes('@example'));
+                if (!hasExample) {
+                    context.report({
+                        node,
+                        messageId: 'missingExample',
+                        data: { name },
+                    });
+                }
+            },
+        };
+    },
+};
+export default requireJsdocExample;
+//# sourceMappingURL=require-jsdoc-example.js.map

invar/node_tools/eslint-plugin/rules/require-jsdoc-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-jsdoc-example.js","sourceRoot":"","sources":["../../src/rules/require-jsdoc-example.ts"],"names":[],"mappings":"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"}

invar/node_tools/eslint-plugin/rules/require-schema-validation.js

@@ -0,0 +1,308 @@
+/**
+ * Rule: require-schema-validation
+ *
+ * Zod-typed parameters must have a corresponding .parse() or .safeParse() call.
+ *
+ * Supports three modes:
+ * - recommended: Warn on missing validation (default)
+ * - strict: Error on missing validation
+ * - risk-based: Error only for high-risk functions (payment, auth, etc.)
+ */
+const ZOD_TYPE_PATTERNS = [
+    /^z\./,
+    /ZodType/,
+    /z\.infer/,
+    /Schema$/,
+];
+// High-risk keywords for risk-based mode
+const RISK_KEYWORDS = [
+    'payment',
+    'pay',
+    'auth',
+    'authenticate',
+    'login',
+    'token',
+    'validate',
+    'verify',
+    'encrypt',
+    'decrypt',
+    'password',
+    'credential',
+    'secret',
+];
+/**
+ * Check if a function name or path contains high-risk keywords
+ */
+function isHighRiskFunction(functionName, filePath) {
+    const combined = `${functionName} ${filePath}`.toLowerCase();
+    return RISK_KEYWORDS.some(keyword => combined.includes(keyword));
+}
+/**
+ * Check if file path matches any of the enforceFor patterns.
+ * Supports glob-like patterns with wildcards.
+ * Protected against ReDoS attacks with pattern length limits.
+ */
+function matchesEnforcePattern(filePath, patterns) {
+    if (patterns.length === 0)
+        return false;
+    const normalizedPath = filePath.replace(/\\/g, '/').toLowerCase();
+    for (const pattern of patterns) {
+        // Protect against ReDoS: limit pattern length
+        if (pattern.length > 200) {
+            continue; // Skip overly long patterns
+        }
+        const normalizedPattern = pattern.replace(/\\/g, '/').toLowerCase();
+        // Escape special regex characters except glob wildcards
+        const escaped = normalizedPattern.replace(/[.+^${}()|[\]]/g, '\\$&');
+        // Convert glob pattern to regex with safe replacements
+        // ** matches any directory depth (use reluctant quantifier)
+        // * matches any characters except / (use reluctant quantifier)
+        const regexPattern = escaped
+            .replace(/\\\*\\\*/g, '.*?') // ** → .*? (reluctant)
+            .replace(/\\\*/g, '[^/]*?') // * → [^/]*? (reluctant)
+            .replace(/\\\?/g, '.'); // ? → .
+        try {
+            const regex = new RegExp(`^${regexPattern}$`);
+            if (regex.test(normalizedPath)) {
+                return true;
+            }
+        }
+        catch (e) {
+            // Invalid regex from pattern - skip
+            continue;
+        }
+    }
+    return false;
+}
+function isZodType(typeAnnotation) {
+    return ZOD_TYPE_PATTERNS.some(pattern => pattern.test(typeAnnotation));
+}
+function hasParseCall(body, paramName) {
+    if (!body)
+        return false;
+    let found = false;
+    const MAX_DEPTH = 50; // Prevent stack overflow on deeply nested types
+    const visit = (node, depth = 0) => {
+        if (found)
+            return;
+        if (depth > MAX_DEPTH)
+            return; // Depth limit to prevent stack overflow
+        if (node.type === 'CallExpression') {
+            const callee = node.callee;
+            if (callee.type === 'MemberExpression') {
+                const property = callee.property;
+                if (property.type === 'Identifier' &&
+                    (property.name === 'parse' || property.name === 'safeParse')) {
+                    // Check if argument is our param
+                    if (node.arguments.some(arg => arg.type === 'Identifier' && arg.name === paramName)) {
+                        found = true;
+                        return;
+                    }
+                }
+            }
+        }
+        // Recursively visit children with depth tracking
+        for (const key of Object.keys(node)) {
+            const value = node[key];
+            if (value && typeof value === 'object') {
+                if (Array.isArray(value)) {
+                    for (const item of value) {
+                        if (item && typeof item === 'object' && 'type' in item) {
+                            visit(item, depth + 1);
+                        }
+                    }
+                }
+                else if ('type' in value) {
+                    visit(value, depth + 1);
+                }
+            }
+        }
+    };
+    visit(body);
+    return found;
+}
+export const requireSchemaValidation = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Require .parse() call for Zod-typed parameters',
+            recommended: true,
+        },
+        hasSuggestions: true,
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    mode: {
+                        type: 'string',
+                        enum: ['recommended', 'strict', 'risk-based'],
+                        default: 'recommended',
+                    },
+                    enforceFor: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                        },
+                        default: [],
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+        messages: {
+            missingValidation: 'Parameter "{{name}}" has Zod type but no .parse() or .safeParse() call',
+            missingValidationRisk: 'High-risk function "{{functionName}}": Parameter "{{name}}" has Zod type but no .parse() or .safeParse() call',
+            addParseCall: 'Add .parse() validation for "{{name}}"',
+        },
+    },
+    create(context) {
+        const sourceCode = context.sourceCode || context.getSourceCode();
+        const options = context.options[0] || {};
+        const mode = options.mode || 'recommended';
+        const enforceFor = options.enforceFor || [];
+        const filename = context.filename || context.getFilename();
+        /**
+         * Get the text of a type annotation from source code.
+         * Strips the leading ": " to return just the type.
+         */
+        function getTypeAnnotationText(param) {
+            const typedParam = param;
+            if (!typedParam.typeAnnotation)
+                return null;
+            const text = sourceCode.getText(typedParam.typeAnnotation);
+            // Strip leading ": " from type annotation
+            return text.replace(/^:\s*/, '');
+        }
+        /**
+         * Get function name from node
+         */
+        function getFunctionName(node) {
+            if (node.type === 'FunctionDeclaration' && node.id) {
+                return node.id.name;
+            }
+            // For arrow functions, try to get name from parent variable declarator
+            return 'anonymous';
+        }
+        /**
+         * Determine if this function should be checked based on mode and options
+         */
+        function shouldCheck(functionName) {
+            if (mode === 'strict') {
+                return true; // Always check in strict mode
+            }
+            if (mode === 'risk-based') {
+                // Check if function is high-risk by name/path
+                if (isHighRiskFunction(functionName, filename)) {
+                    return true;
+                }
+                // Check if file path matches enforceFor patterns
+                if (matchesEnforcePattern(filename, enforceFor)) {
+                    return true;
+                }
+                return false;
+            }
+            // recommended mode - always check (but will warn instead of error)
+            return true;
+        }
+        function checkFunction(node, params) {
+            const functionName = getFunctionName(node);
+            // Skip if shouldn't check based on mode
+            if (!shouldCheck(functionName)) {
+                return;
+            }
+            const body = 'body' in node ? node.body : null;
+            const isRiskFunction = isHighRiskFunction(functionName, filename);
+            for (const param of params) {
+                if (param.typeAnnotation && isZodType(param.typeAnnotation)) {
+                    if (!hasParseCall(body, param.name)) {
+                        // Extract schema name from type annotation (e.g., "z.infer<typeof UserSchema>" -> "UserSchema")
+                        const schemaMatch = param.typeAnnotation.match(/typeof\s+(\w+)/);
+                        const schemaName = schemaMatch ? schemaMatch[1] : 'Schema';
+                        const validatedVarName = `validated${param.name.charAt(0).toUpperCase()}${param.name.slice(1)}`;
+                        context.report({
+                            node: node,
+                            messageId: isRiskFunction ? 'missingValidationRisk' : 'missingValidation',
+                            data: {
+                                name: param.name,
+                                functionName: functionName,
+                            },
+                            suggest: [
+                                {
+                                    messageId: 'addParseCall',
+                                    data: { name: param.name },
+                                    fix(fixer) {
+                                        // Find the opening brace of the function body
+                                        if (!body || body.type !== 'BlockStatement')
+                                            return null;
+                                        const blockBody = body;
+                                        if (!blockBody.body || blockBody.body.length === 0)
+                                            return null;
+                                        const firstStatement = blockBody.body[0];
+                                        // Detect indentation from the first statement
+                                        const firstStatementStart = firstStatement.loc?.start.column ?? 2;
+                                        const indent = ' '.repeat(firstStatementStart);
+                                        const parseCode = `const ${validatedVarName} = ${schemaName}.parse(${param.name});\n${indent}`;
+                                        return fixer.insertTextBefore(firstStatement, parseCode);
+                                    },
+                                },
+                            ],
+                        });
+                    }
+                }
+            }
+        }
+        /**
+         * Extract param name and type annotation from various param patterns.
+         */
+        function extractParamInfo(param) {
+            if (param.type === 'Identifier') {
+                return {
+                    name: param.name,
+                    typeAnnotation: getTypeAnnotationText(param),
+                };
+            }
+            // Handle destructuring patterns: { a, b }: ZodSchema
+            if (param.type === 'ObjectPattern' || param.type === 'ArrayPattern') {
+                // For destructuring, we use a placeholder name and check the pattern's type
+                const patternName = param.type === 'ObjectPattern' ? '{...}' : '[...]';
+                return {
+                    name: patternName,
+                    typeAnnotation: getTypeAnnotationText(param),
+                };
+            }
+            // Handle rest parameters: ...args: ZodSchema[]
+            if (param.type === 'RestElement') {
+                const restParam = param;
+                const name = restParam.argument?.name || '...rest';
+                return {
+                    name,
+                    typeAnnotation: getTypeAnnotationText(param),
+                };
+            }
+            // Handle assignment patterns: param = default
+            if (param.type === 'AssignmentPattern') {
+                const assignParam = param;
+                if (assignParam.left) {
+                    return extractParamInfo(assignParam.left);
+                }
+            }
+            return null;
+        }
+        return {
+            FunctionDeclaration(node) {
+                const params = node.params
+                    .map(p => extractParamInfo(p))
+                    .filter((p) => p !== null);
+                checkFunction(node, params);
+            },
+            ArrowFunctionExpression(node) {
+                const params = node.params
+                    .map(p => extractParamInfo(p))
+                    .filter((p) => p !== null);
+                checkFunction(node, params);
+            },
+        };
+    },
+};
+export default requireSchemaValidation;
+//# sourceMappingURL=require-schema-validation.js.map

invar/node_tools/eslint-plugin/rules/require-schema-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-schema-validation.js","sourceRoot":"","sources":["../../src/rules/require-schema-validation.ts"],"names":[],"mappings":"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"}