@opensip-cli/checks-typescript 0.1.9 → 0.1.11

package/dist/checks/quality/patterns/throws-documentation-analyze.js

@@ -0,0 +1,352 @@
+// @fitness-ignore-file throws-documentation -- Functions throw self-documenting typed errors
+/**
+ * AST analysis helpers for the throws-documentation check.
+ */
+import * as ts from 'typescript';
+import { isSelfDocumentingError } from './throws-documentation-constants.js';
+function isFunctionLikeNode(n) {
+    return (ts.isFunctionDeclaration(n) ||
+        ts.isFunctionExpression(n) ||
+        ts.isArrowFunction(n) ||
+        ts.isMethodDeclaration(n));
+}
+function findThrowStatements(node) {
+    const throws = [];
+    const visit = (n) => {
+        if (isFunctionLikeNode(n) && n !== node) {
+            return;
+        }
+        if (ts.isThrowStatement(n)) {
+            throws.push(n);
+        }
+        ts.forEachChild(n, visit);
+    };
+    visit(node);
+    return throws;
+}
+function commentRangesIncludeThrows(fullText, pos) {
+    const comments = ts.getLeadingCommentRanges(fullText, pos);
+    if (!comments)
+        return false;
+    for (const comment of comments) {
+        const commentText = fullText.slice(comment.pos, comment.end);
+        if (commentText.includes('@throws')) {
+            return true;
+        }
+    }
+    return false;
+}
+function hasThrowsJSDoc(node, sourceFile) {
+    return commentRangesIncludeThrows(sourceFile.getFullText(), node.getFullStart());
+}
+function hasPropertyAssignmentThrowsJSDoc(arrow, sourceFile) {
+    const parent = arrow.parent;
+    if (!ts.isPropertyAssignment(parent))
+        return false;
+    return commentRangesIncludeThrows(sourceFile.getFullText(), parent.name.getFullStart());
+}
+function isReturnedClosure(node) {
+    const parent = node.parent;
+    if (ts.isReturnStatement(parent))
+        return true;
+    if (ts.isPropertyAssignment(parent)) {
+        let current = parent.parent;
+        while (current) {
+            if (ts.isReturnStatement(current))
+                return true;
+            if (isFunctionLikeNode(current))
+                return false;
+            current = current.parent;
+        }
+    }
+    return false;
+}
+function isFactoryBodyConstArrow(node) {
+    const parent = node.parent;
+    if (!ts.isVariableDeclaration(parent) || parent.initializer !== node)
+        return false;
+    const stmt = parent.parent.parent;
+    if (!ts.isVariableStatement(stmt))
+        return false;
+    let current = stmt.parent;
+    while (current) {
+        if (isFunctionLikeNode(current))
+            return true;
+        if (ts.isSourceFile(current))
+            return false;
+        current = current.parent;
+    }
+    return false;
+}
+function hasEnclosingFactoryThrowsJSDoc(node, sourceFile) {
+    if (!isReturnedClosure(node) && !isFactoryBodyConstArrow(node))
+        return false;
+    let current = node.parent;
+    while (current) {
+        if ((ts.isFunctionDeclaration(current) ||
+            ts.isFunctionExpression(current) ||
+            ts.isMethodDeclaration(current)) &&
+            hasThrowsJSDoc(current, sourceFile))
+            return true;
+        current = current.parent;
+    }
+    return false;
+}
+function getFunctionBody(node) {
+    if (ts.isMethodDeclaration(node) || ts.isFunctionDeclaration(node)) {
+        return node.body ?? undefined;
+    }
+    return node.body;
+}
+function isInsideTopLevelTry(throwStmt, fnNode) {
+    const body = getFunctionBody(fnNode);
+    if (!body || !ts.isBlock(body))
+        return false;
+    let current = throwStmt.parent;
+    while (current && current !== fnNode) {
+        if (isFunctionLikeNode(current) && current !== fnNode)
+            return false;
+        if (ts.isTryStatement(current) && body.statements.includes(current)) {
+            return true;
+        }
+        current = current.parent;
+    }
+    return false;
+}
+function catchClauseContainsThrow(n) {
+    if (ts.isThrowStatement(n))
+        return true;
+    if (isFunctionLikeNode(n))
+        return false;
+    let found = false;
+    ts.forEachChild(n, (child) => {
+        if (catchClauseContainsThrow(child))
+            found = true;
+    });
+    return found;
+}
+function topLevelTryCatchRethrows(fnNode) {
+    const body = getFunctionBody(fnNode);
+    if (!body || !ts.isBlock(body))
+        return false;
+    for (const stmt of body.statements) {
+        if (!ts.isTryStatement(stmt))
+            continue;
+        if (stmt.catchClause && catchClauseContainsThrow(stmt.catchClause))
+            return true;
+    }
+    return false;
+}
+function neverPropagatesThrows(node) {
+    const throwStatements = findThrowStatements(node);
+    if (throwStatements.length === 0)
+        return false;
+    if (!throwStatements.every((stmt) => isInsideTopLevelTry(stmt, node)))
+        return false;
+    return !topLevelTryCatchRethrows(node);
+}
+const ANONYMOUS_FUNCTION_NAME = '<anonymous>';
+function getNameFromFunctionDeclaration(node) {
+    return node.name?.text ?? ANONYMOUS_FUNCTION_NAME;
+}
+function getNameFromMethodDeclaration(node) {
+    return ts.isIdentifier(node.name) ? node.name.text : ANONYMOUS_FUNCTION_NAME;
+}
+function getNameFromArrowFunction(node) {
+    const parent = node.parent;
+    if (ts.isVariableDeclaration(parent) && ts.isIdentifier(parent.name)) {
+        return parent.name.text;
+    }
+    return ANONYMOUS_FUNCTION_NAME;
+}
+// @fitness-ignore-next-line duplicate-utility-functions -- Check-specific helper for FunctionLikeNode
+function getFunctionName(node) {
+    if (ts.isFunctionDeclaration(node)) {
+        return getNameFromFunctionDeclaration(node);
+    }
+    if (ts.isMethodDeclaration(node)) {
+        return getNameFromMethodDeclaration(node);
+    }
+    return getNameFromArrowFunction(node);
+}
+function isAnonymousCallback(node) {
+    const parent = node.parent;
+    return ts.isCallExpression(parent) || ts.isCallExpression(parent.parent);
+}
+function extractThrownType(throwStmt, sourceFile) {
+    const text = throwStmt.expression.getText(sourceFile);
+    // @fitness-ignore-next-line sonarjs-backend -- Safe regex with fixed tokens for extracting error class name
+    const typeMatch = /new\s+(\w+)/.exec(text);
+    return typeMatch?.[1] ?? 'Error';
+}
+function getUniqueThrowTypes(throwStatements, sourceFile) {
+    if (!Array.isArray(throwStatements)) {
+        return [];
+    }
+    const thrownTypes = throwStatements.map((t) => extractThrownType(t, sourceFile));
+    return [...new Set(thrownTypes)];
+}
+function createMissingThrowsViolation(node, funcName, throwStatements, ctx) {
+    if (!Array.isArray(throwStatements)) {
+        throw new TypeError('throwStatements must be an array');
+    }
+    const { line, character } = ctx.sourceFile.getLineAndCharacterOfPosition(node.getStart());
+    const lineNum = line + 1;
+    const uniqueTypes = getUniqueThrowTypes(throwStatements, ctx.sourceFile);
+    return {
+        line: lineNum,
+        column: character + 1,
+        message: `Function '${funcName}' throws but lacks @throws JSDoc`,
+        severity: 'warning',
+        suggestion: `Add @throws JSDoc above the function: /** @throws {${uniqueTypes.join(' | ')}} Description of when this error is thrown */`,
+        match: funcName,
+    };
+}
+function shouldAnalyzeFunction(node, funcName) {
+    if (funcName === '<anonymous>' && ts.isArrowFunction(node)) {
+        return !isAnonymousCallback(node);
+    }
+    return true;
+}
+function allThrowsSelfDocumenting(throwStatements, sourceFile, suffixes) {
+    if (!Array.isArray(throwStatements) || throwStatements.length === 0) {
+        return false;
+    }
+    return throwStatements.every((stmt) => {
+        const errorType = extractThrownType(stmt, sourceFile);
+        return isSelfDocumentingError(errorType, suffixes);
+    });
+}
+const ERROR_FIELD_NAME_PATTERN = /^(error|err|cause|innerError|originalError)$/i;
+const ERROR_VAR_NAME_PATTERN = /^(error|err|e|ex|exception)$/i;
+function collectCaughtErrorNames(fnNode) {
+    const names = new Set();
+    const visit = (n) => {
+        if (isFunctionLikeNode(n) && n !== fnNode) {
+            return;
+        }
+        if (ts.isCatchClause(n) && n.variableDeclaration) {
+            const decl = n.variableDeclaration;
+            if (ts.isIdentifier(decl.name)) {
+                names.add(decl.name.text);
+            }
+        }
+        ts.forEachChild(n, visit);
+    };
+    visit(fnNode);
+    return names;
+}
+// eslint-disable-next-line sonarjs/cognitive-complexity -- rethrow heuristic AST shapes
+function isRethrow(throwStmt, sourceFile, caughtNames) {
+    const expr = throwStmt.expression;
+    const text = expr.getText(sourceFile).trim();
+    if (ts.isNewExpression(expr))
+        return false;
+    if (ts.isIdentifier(expr)) {
+        if (caughtNames?.has(expr.text))
+            return true;
+        return ERROR_VAR_NAME_PATTERN.test(expr.text);
+    }
+    if (ts.isPropertyAccessExpression(expr) &&
+        expr.expression.kind === ts.SyntaxKind.ThisKeyword &&
+        ts.isIdentifier(expr.name) &&
+        ERROR_FIELD_NAME_PATTERN.test(expr.name.text)) {
+        return true;
+    }
+    if (ts.isCallExpression(expr) && ts.isPropertyAccessExpression(expr.expression)) {
+        const methodName = ts.isIdentifier(expr.expression.name) ? expr.expression.name.text : '';
+        if (methodName === 'unwrapErr' || methodName === 'unwrap') {
+            return true;
+        }
+        const root = expr.expression.expression;
+        if (ts.isIdentifier(root) && caughtNames?.has(root.text)) {
+            return true;
+        }
+    }
+    if (ts.isCallExpression(expr) && expr.arguments.length === 1) {
+        const arg = expr.arguments[0];
+        if (arg && ts.isIdentifier(arg)) {
+            if (caughtNames?.has(arg.text))
+                return true;
+            if (!caughtNames && ERROR_VAR_NAME_PATTERN.test(arg.text))
+                return true;
+        }
+    }
+    return !text.includes('new ') && ERROR_VAR_NAME_PATTERN.test(text);
+}
+function matchesInstanceofGuard(cond, thrown, sourceFile) {
+    if (!ts.isIdentifier(thrown))
+        return false;
+    if (!ts.isBinaryExpression(cond) || cond.operatorToken.kind !== ts.SyntaxKind.InstanceOfKeyword) {
+        return false;
+    }
+    return cond.left.getText(sourceFile) === thrown.text;
+}
+function isInstanceofGuardedRethrow(throwStmt, sourceFile) {
+    const parent = throwStmt.parent;
+    const thrown = throwStmt.expression;
+    if (ts.isIfStatement(parent)) {
+        return matchesInstanceofGuard(parent.expression, thrown, sourceFile);
+    }
+    if (!ts.isBlock(parent))
+        return false;
+    const siblings = parent.statements;
+    const idx = siblings.indexOf(throwStmt);
+    if (idx <= 0)
+        return false;
+    const prev = siblings[idx - 1];
+    if (!ts.isIfStatement(prev))
+        return false;
+    return matchesInstanceofGuard(prev.expression, thrown, sourceFile);
+}
+function analyzeFunctionNode(node, ctx) {
+    const funcName = getFunctionName(node);
+    if (!shouldAnalyzeFunction(node, funcName)) {
+        return null;
+    }
+    const throwStatements = findThrowStatements(node);
+    if (throwStatements.length === 0) {
+        return null;
+    }
+    if (hasThrowsJSDoc(node, ctx.sourceFile)) {
+        return null;
+    }
+    if (ts.isArrowFunction(node)) {
+        if (hasPropertyAssignmentThrowsJSDoc(node, ctx.sourceFile)) {
+            return null;
+        }
+        if (hasEnclosingFactoryThrowsJSDoc(node, ctx.sourceFile)) {
+            return null;
+        }
+    }
+    if (neverPropagatesThrows(node)) {
+        return null;
+    }
+    if (allThrowsSelfDocumenting(throwStatements, ctx.sourceFile, ctx.selfDocumentingSuffixes)) {
+        return null;
+    }
+    const caughtNames = collectCaughtErrorNames(node);
+    if (throwStatements.every((stmt) => isRethrow(stmt, ctx.sourceFile, caughtNames) ||
+        isInstanceofGuardedRethrow(stmt, ctx.sourceFile))) {
+        return null;
+    }
+    return createMissingThrowsViolation(node, funcName, throwStatements, ctx);
+}
+/** Analyze a file for missing @throws documentation. */
+export function analyzeFile(ctx) {
+    const violations = [];
+    const visit = (node) => {
+        if (ts.isFunctionDeclaration(node) ||
+            ts.isMethodDeclaration(node) ||
+            ts.isArrowFunction(node)) {
+            const violation = analyzeFunctionNode(node, ctx);
+            if (violation) {
+                violations.push(violation);
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(ctx.sourceFile);
+    return violations;
+}
+//# sourceMappingURL=throws-documentation-analyze.js.map

package/dist/checks/quality/patterns/throws-documentation-analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throws-documentation-analyze.js","sourceRoot":"","sources":["../../../../src/checks/quality/patterns/throws-documentation-analyze.ts"],"names":[],"mappings":"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"}

package/dist/checks/quality/patterns/throws-documentation-constants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Self-documenting error allowlists for the throws-documentation check.
+ */
+/**
+ * Recipe-config shape for throws-documentation. Project-specific typed-error
+ * suffixes belong in a recipe's `checks.config['throws-documentation']` block.
+ */
+export interface ThrowsDocConfig extends Record<string, unknown> {
+    /** Class-name suffixes that mark a thrown error as self-documenting. */
+    additionalSelfDocumentingSuffixes?: readonly string[];
+}
+export declare const SELF_DOCUMENTING_SUFFIXES: string[];
+export declare function buildEffectiveSuffixes(): readonly string[];
+export declare function isSelfDocumentingError(errorType: string, suffixes: readonly string[]): boolean;
+//# sourceMappingURL=throws-documentation-constants.d.ts.map

package/dist/checks/quality/patterns/throws-documentation-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throws-documentation-constants.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/patterns/throws-documentation-constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,wEAAwE;IACxE,iCAAiC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvD;AA8CD,eAAO,MAAM,yBAAyB,UAmCrC,CAAC;AAEF,wBAAgB,sBAAsB,IAAI,SAAS,MAAM,EAAE,CAG1D;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAK9F"}

package/dist/checks/quality/patterns/throws-documentation-constants.js

@@ -0,0 +1,94 @@
+/**
+ * Self-documenting error allowlists for the throws-documentation check.
+ */
+import { getCheckConfig } from '@opensip-cli/fitness';
+/** Typed error classes that are self-documenting without @throws JSDoc. */
+const SELF_DOCUMENTING_ERROR_NAMES = [
+    'ValidationError',
+    'AuthorizationError',
+    'NotFoundError',
+    'ConflictError',
+    'DomainError',
+    'SystemError',
+    'ConfigurationError',
+    'InfrastructureError',
+    'ExternalServiceError',
+    'DatabaseError',
+    'CacheError',
+    'NetworkError',
+    'ApplicationError',
+    'OperationError',
+    'StateError',
+    'IntegrationError',
+    'BadRequestError',
+    'UnauthorizedError',
+    'ForbiddenError',
+    'MethodNotAllowedError',
+    'NotAcceptableError',
+    'RequestTimeoutError',
+    'GoneError',
+    'PayloadTooLargeError',
+    'UnsupportedMediaTypeError',
+    'UnprocessableEntityError',
+    'TooManyRequestsError',
+    'InternalServerError',
+    'NotImplementedError',
+    'BadGatewayError',
+    'ServiceUnavailableError',
+    'GatewayTimeoutError',
+    'InputValidationError',
+    'BusinessRuleError',
+    'AuthenticationError',
+    'PermissionError',
+    'ResourceNotFoundError',
+    'DuplicateResourceError',
+    'DataIntegrityError',
+    'ToolError',
+];
+export const SELF_DOCUMENTING_SUFFIXES = [
+    'ValidationError',
+    'NotFoundError',
+    'AuthorizationError',
+    'SystemError',
+    'DomainError',
+    'ConfigurationError',
+    'SecurityError',
+    'TimeoutError',
+    'LockError',
+    'LimitError',
+    'InfrastructureError',
+    'ApplicationError',
+    'OperationError',
+    'ErrorBuilder',
+    'NetworkError',
+    'ExecutionError',
+    'LoadError',
+    'VerifyError',
+    'ApiError',
+    'ParseError',
+    'EncodingError',
+    'DecodingError',
+    'StateError',
+    'SyncError',
+    'CaptureError',
+    'IntegrationError',
+    'PermissionError',
+    'AccessError',
+    'AuthenticationError',
+    'ResourceNotFoundError',
+    'DuplicateResourceError',
+    'DataIntegrityError',
+    'BusinessRuleError',
+    'InputValidationError',
+];
+export function buildEffectiveSuffixes() {
+    const cfg = getCheckConfig('throws-documentation');
+    return [...SELF_DOCUMENTING_SUFFIXES, ...(cfg.additionalSelfDocumentingSuffixes ?? [])];
+}
+export function isSelfDocumentingError(errorType, suffixes) {
+    if (SELF_DOCUMENTING_ERROR_NAMES.includes(errorType)) {
+        return true;
+    }
+    return suffixes.some((suffix) => errorType.endsWith(suffix));
+}
+//# sourceMappingURL=throws-documentation-constants.js.map

package/dist/checks/quality/patterns/throws-documentation-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throws-documentation-constants.js","sourceRoot":"","sources":["../../../../src/checks/quality/patterns/throws-documentation-constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAWtD,2EAA2E;AAC3E,MAAM,4BAA4B,GAAG;IACnC,iBAAiB;IACjB,oBAAoB;IACpB,eAAe;IACf,eAAe;IACf,aAAa;IACb,aAAa;IACb,oBAAoB;IACpB,qBAAqB;IACrB,sBAAsB;IACtB,eAAe;IACf,YAAY;IACZ,cAAc;IACd,kBAAkB;IAClB,gBAAgB;IAChB,YAAY;IACZ,kBAAkB;IAClB,iBAAiB;IACjB,mBAAmB;IACnB,gBAAgB;IAChB,uBAAuB;IACvB,oBAAoB;IACpB,qBAAqB;IACrB,WAAW;IACX,sBAAsB;IACtB,2BAA2B;IAC3B,0BAA0B;IAC1B,sBAAsB;IACtB,qBAAqB;IACrB,qBAAqB;IACrB,iBAAiB;IACjB,yBAAyB;IACzB,qBAAqB;IACrB,sBAAsB;IACtB,mBAAmB;IACnB,qBAAqB;IACrB,iBAAiB;IACjB,uBAAuB;IACvB,wBAAwB;IACxB,oBAAoB;IACpB,WAAW;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,iBAAiB;IACjB,eAAe;IACf,oBAAoB;IACpB,aAAa;IACb,aAAa;IACb,oBAAoB;IACpB,eAAe;IACf,cAAc;IACd,WAAW;IACX,YAAY;IACZ,qBAAqB;IACrB,kBAAkB;IAClB,gBAAgB;IAChB,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,WAAW;IACX,aAAa;IACb,UAAU;IACV,YAAY;IACZ,eAAe;IACf,eAAe;IACf,YAAY;IACZ,WAAW;IACX,cAAc;IACd,kBAAkB;IAClB,iBAAiB;IACjB,aAAa;IACb,qBAAqB;IACrB,uBAAuB;IACvB,wBAAwB;IACxB,oBAAoB;IACpB,mBAAmB;IACnB,sBAAsB;CACvB,CAAC;AAEF,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,cAAc,CAAkB,sBAAsB,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,yBAAyB,EAAE,GAAG,CAAC,GAAG,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,QAA2B;IACnF,IAAK,4BAAkD,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/checks/quality/patterns/throws-documentation.d.ts

@@ -2,22 +2,12 @@
  * @fileoverview Missing @throws JSDoc Detection Check
  *
  * Detects functions that contain throw statements but lack @throws JSDoc documentation.
- *
- */
-/**
- * Recipe-config shape for throws-documentation. Project-specific typed-error
- * suffixes (e.g. opensip's `CompositionError`, `CanonicalizationError`)
- * belong in a recipe's `checks.config['throws-documentation']` block, not
- * in built-in defaults.
  */
-export interface ThrowsDocConfig extends Record<string, unknown> {
-    /** Class-name suffixes that mark a thrown error as self-documenting. */
-    additionalSelfDocumentingSuffixes?: readonly string[];
-}
 /**
  * Check: quality/throws-documentation
  *
  * Detects functions with throw statements but no @throws JSDoc.
  */
 export declare const throwsDocumentation: import("@opensip-cli/fitness").Check;
+export { type ThrowsDocConfig } from './throws-documentation-constants.js';
 //# sourceMappingURL=throws-documentation.d.ts.map

package/dist/checks/quality/patterns/throws-documentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"throws-documentation.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/patterns/throws-documentation.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAMH;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,wEAAwE;IACxE,iCAAiC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvD;AAmiBD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,sCAwC9B,CAAC"}
+{"version":3,"file":"throws-documentation.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/patterns/throws-documentation.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAQH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,sCAoC9B,CAAC;AAEH,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC"}