@opensip-cli/checks-typescript 0.1.9 → 0.1.11

package/dist/checks/quality/patterns/async-waterfall-analysis.d.ts

@@ -0,0 +1,17 @@
+import * as ts from 'typescript';
+import type { CheckViolation } from '@opensip-cli/fitness';
+export declare const MAX_LINE_GAP = 1;
+export interface AwaitInfo {
+    line: number;
+    column: number;
+    assignedVariable: string | null;
+    destructuredBindings: readonly string[];
+    expressionText: string;
+    isDynamicImport: boolean;
+    branchKey: string | null;
+    node: ts.AwaitExpression;
+}
+export declare function collectAwaitExpressions(node: ts.Node, sourceFile: ts.SourceFile): AwaitInfo[];
+export declare function detectWaterfalls(awaitInfos: AwaitInfo[]): CheckViolation[];
+export declare function analyzeFile(absolutePath: string, content: string): CheckViolation[];
+//# sourceMappingURL=async-waterfall-analysis.d.ts.map

package/dist/checks/quality/patterns/async-waterfall-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-waterfall-analysis.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/patterns/async-waterfall-analysis.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAIjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC;CAC1B;AAgHD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,SAAS,EAAE,CAgC7F;AA6ED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CA2B1E;AAED,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAiBnF"}

package/dist/checks/quality/patterns/async-waterfall-analysis.js

@@ -0,0 +1,215 @@
+// @fitness-ignore-file null-safety -- null checks are intentional guards
+import { getSharedSourceFile, isAsync } from '@opensip-cli/lang-typescript';
+import * as ts from 'typescript';
+import { getBranchKey } from './async-waterfall-branch-keys.js';
+export const MAX_LINE_GAP = 1;
+const SLEEP_DELAY_NAMES = new Set([
+    'sleep',
+    'delay',
+    'wait',
+    'setTimeout',
+    'pause',
+    'backoff',
+    'yieldToEventLoop',
+    'yield',
+    'nextTick',
+]);
+const LOCK_ACQUIRE_NAMES = new Set(['acquire', 'lock', 'runExclusive', 'withLock']);
+/** Last identifier before `(` on an awaited call expression text. */
+function getCalleeName(expressionText) {
+    const afterAwait = expressionText.replace(/^await\s+/, '').trim();
+    const dotted = /\.(\w+)\s*\([^)]*\)\s*$/.exec(afterAwait);
+    if (dotted?.[1] !== undefined) {
+        return dotted[1];
+    }
+    const direct = /^(\w+)\s*\(/.exec(afterAwait);
+    return direct?.[1] ?? null;
+}
+const SETUP_THEN_RUN_FIRST = /^(?:ensure|load|maybeShow|save|check)/i;
+const SETUP_THEN_RUN_SECOND = /^(?:build|emit|render|deliver|maybeShow)/i;
+const SEQUENTIAL_SCAN_FIRST = /^collect/i;
+const SEQUENTIAL_SCAN_SECOND = /^count/i;
+function isAsyncFunction(node) {
+    if (ts.isFunctionDeclaration(node) ||
+        ts.isMethodDeclaration(node) ||
+        ts.isArrowFunction(node) ||
+        ts.isFunctionExpression(node)) {
+        return isAsync(node);
+    }
+    return false;
+}
+function extractDestructuredBindings(pattern, sourceFile) {
+    const names = [];
+    for (const element of pattern.elements) {
+        if (ts.isBindingElement(element)) {
+            if (ts.isIdentifier(element.name)) {
+                names.push(element.name.getText(sourceFile));
+            }
+            else if (ts.isObjectBindingPattern(element.name) ||
+                ts.isArrayBindingPattern(element.name)) {
+                names.push(...extractDestructuredBindings(element.name, sourceFile));
+            }
+        }
+    }
+    return names;
+}
+function getAssignedVariable(awaitNode, sourceFile) {
+    const parent = awaitNode.parent;
+    if (ts.isVariableDeclaration(parent) && ts.isIdentifier(parent.name)) {
+        return parent.name.getText(sourceFile);
+    }
+    if (ts.isVariableDeclaration(parent) &&
+        (ts.isObjectBindingPattern(parent.name) || ts.isArrayBindingPattern(parent.name))) {
+        return parent.name.getText(sourceFile);
+    }
+    if (ts.isBinaryExpression(parent) &&
+        parent.operatorToken.kind === ts.SyntaxKind.EqualsToken &&
+        ts.isIdentifier(parent.left)) {
+        return parent.left.getText(sourceFile);
+    }
+    return null;
+}
+function getDestructuredBindings(awaitNode, sourceFile) {
+    const parent = awaitNode.parent;
+    if (ts.isVariableDeclaration(parent) &&
+        (ts.isObjectBindingPattern(parent.name) || ts.isArrayBindingPattern(parent.name))) {
+        return extractDestructuredBindings(parent.name, sourceFile);
+    }
+    return [];
+}
+function isDynamicImportExpression(awaitNode) {
+    const expr = awaitNode.expression;
+    return ts.isCallExpression(expr) && expr.expression.kind === ts.SyntaxKind.ImportKeyword;
+}
+export function collectAwaitExpressions(node, sourceFile) {
+    const awaitInfos = [];
+    const visit = (n) => {
+        if (n !== node && isAsyncFunction(n)) {
+            return;
+        }
+        if (ts.isAwaitExpression(n)) {
+            const { line, character } = sourceFile.getLineAndCharacterOfPosition(n.getStart());
+            const assignedVariable = getAssignedVariable(n, sourceFile);
+            const destructuredBindings = getDestructuredBindings(n, sourceFile);
+            const isDynamicImport = isDynamicImportExpression(n);
+            const branchKey = getBranchKey(n, sourceFile, node);
+            awaitInfos.push({
+                line: line + 1,
+                column: character + 1,
+                assignedVariable,
+                destructuredBindings,
+                expressionText: n.getText(sourceFile),
+                isDynamicImport,
+                branchKey,
+                node: n,
+            });
+        }
+        ts.forEachChild(n, visit);
+    };
+    ts.forEachChild(node, visit);
+    return awaitInfos;
+}
+function isSleepOrDelay(expressionText) {
+    const callee = getCalleeName(expressionText);
+    return callee !== null && SLEEP_DELAY_NAMES.has(callee);
+}
+function isLockAcquire(expressionText) {
+    const callee = getCalleeName(expressionText);
+    return callee !== null && LOCK_ACQUIRE_NAMES.has(callee);
+}
+function isSequentialOrchestration(current, next) {
+    const first = getCalleeName(current.expressionText);
+    const second = getCalleeName(next.expressionText);
+    if (first === null || second === null) {
+        return false;
+    }
+    if (SETUP_THEN_RUN_FIRST.test(first) && SETUP_THEN_RUN_SECOND.test(second)) {
+        return true;
+    }
+    // Post-emit auth/cache cleanup must run after the sink attempt, not in parallel.
+    if (first === 'emit' && second.startsWith('invalidate')) {
+        return true;
+    }
+    return SEQUENTIAL_SCAN_FIRST.test(first) && SEQUENTIAL_SCAN_SECOND.test(second);
+}
+function nextUsesDestructuredBindings(current, next) {
+    if (current.destructuredBindings.length === 0) {
+        return false;
+    }
+    return current.destructuredBindings.some((binding) => next.expressionText.includes(binding));
+}
+function isAwaitingFunctionCall(expressionText) {
+    const afterAwait = expressionText.replace(/^await\s+/, '');
+    // eslint-disable-next-line sonarjs/slow-regex -- trailing call parens on a single await expression; bounded slice
+    return /\([^)]*\)\s*$/.test(afterAwait);
+}
+function shouldSkipAwaitPair(current, next) {
+    if (next.line - current.line > MAX_LINE_GAP + 1)
+        return true;
+    if (current.branchKey !== null &&
+        next.branchKey !== null &&
+        // @fitness-ignore-next-line unsafe-secret-comparison -- Comparing AST branch identifiers, not cryptographic keys
+        current.branchKey !== next.branchKey) {
+        return true;
+    }
+    if (isSleepOrDelay(current.expressionText) || isSleepOrDelay(next.expressionText))
+        return true;
+    if (isLockAcquire(current.expressionText))
+        return true;
+    if (isSequentialOrchestration(current, next))
+        return true;
+    if (current.assignedVariable !== null && next.expressionText.includes(current.assignedVariable)) {
+        return true;
+    }
+    if (nextUsesDestructuredBindings(current, next))
+        return true;
+    if (current.isDynamicImport)
+        return true;
+    if (!isAwaitingFunctionCall(current.expressionText) ||
+        !isAwaitingFunctionCall(next.expressionText)) {
+        return true;
+    }
+    return false;
+}
+export function detectWaterfalls(awaitInfos) {
+    const violations = [];
+    const sorted = [...awaitInfos].sort((a, b) => a.line - b.line);
+    for (let i = 0; i < sorted.length - 1; i++) {
+        const current = sorted[i];
+        const next = sorted[i + 1];
+        if (current === undefined || next === undefined)
+            continue;
+        if (shouldSkipAwaitPair(current, next))
+            continue;
+        violations.push({
+            line: current.line,
+            column: current.column,
+            message: 'Sequential await statements may be parallelizable with Promise.all()',
+            severity: 'warning',
+            suggestion: 'Consider using Promise.all() to parallelize independent async operations. ' +
+                'Example: const [result1, result2] = await Promise.all([asyncOp1(), asyncOp2()]);',
+            type: 'async-waterfall',
+            match: `${current.expressionText} followed by ${next.expressionText}`,
+        });
+        i++;
+    }
+    return violations;
+}
+export function analyzeFile(absolutePath, content) {
+    const violations = [];
+    const sourceFile = getSharedSourceFile(absolutePath, content);
+    if (!sourceFile)
+        return [];
+    const visit = (node) => {
+        if (isAsyncFunction(node)) {
+            const asyncNode = node;
+            const awaitInfos = collectAwaitExpressions(asyncNode, sourceFile);
+            const newViolations = detectWaterfalls(awaitInfos);
+            violations.push(...newViolations);
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return violations;
+}
+//# sourceMappingURL=async-waterfall-analysis.js.map

package/dist/checks/quality/patterns/async-waterfall-analysis.js.map

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

package/dist/checks/quality/patterns/async-waterfall-branch-keys.d.ts

@@ -0,0 +1,6 @@
+import * as ts from 'typescript';
+export declare function getIfElseBranchKey(current: ts.Node, sourceFile: ts.SourceFile): string | null;
+export declare function getTernaryBranchKey(current: ts.Node, sourceFile: ts.SourceFile): string | null;
+export declare function getSwitchBranchKey(current: ts.Node, sourceFile: ts.SourceFile): string | null;
+export declare function getBranchKey(node: ts.Node, sourceFile: ts.SourceFile, functionNode: ts.Node): string | null;
+//# sourceMappingURL=async-waterfall-branch-keys.d.ts.map

package/dist/checks/quality/patterns/async-waterfall-branch-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-waterfall-branch-keys.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/patterns/async-waterfall-branch-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAQ7F;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAQ9F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAa7F;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,YAAY,EAAE,EAAE,CAAC,IAAI,GACpB,MAAM,GAAG,IAAI,CAiBf"}

package/dist/checks/quality/patterns/async-waterfall-branch-keys.js

@@ -0,0 +1,54 @@
+import * as ts from 'typescript';
+export function getIfElseBranchKey(current, sourceFile) {
+    const parentNode = current.parent;
+    if (!ts.isIfStatement(parentNode))
+        return null;
+    const ifLine = sourceFile.getLineAndCharacterOfPosition(parentNode.getStart()).line;
+    if (current === parentNode.thenStatement)
+        return `if@L${ifLine}`;
+    if (current === parentNode.elseStatement)
+        return `else@L${ifLine}`;
+    return null;
+}
+export function getTernaryBranchKey(current, sourceFile) {
+    const parentNode = current.parent;
+    if (!ts.isConditionalExpression(parentNode))
+        return null;
+    const condLine = sourceFile.getLineAndCharacterOfPosition(parentNode.getStart()).line;
+    if (current === parentNode.whenTrue)
+        return `ternary-true@L${condLine}`;
+    if (current === parentNode.whenFalse)
+        return `ternary-false@L${condLine}`;
+    return null;
+}
+export function getSwitchBranchKey(current, sourceFile) {
+    if (!ts.isCaseClause(current) && !ts.isDefaultClause(current))
+        return null;
+    // @fitness-ignore-next-line null-safety -- CaseClause/DefaultClause parent is CaseBlock, grandparent is SwitchStatement per TS AST spec
+    const switchStmt = current.parent.parent;
+    if (!ts.isSwitchStatement(switchStmt))
+        return null;
+    const switchLine = sourceFile.getLineAndCharacterOfPosition(switchStmt.getStart()).line;
+    if (ts.isCaseClause(current)) {
+        const caseText = current.expression.getText(sourceFile);
+        return `case-${caseText}@L${switchLine}`;
+    }
+    return `default@L${switchLine}`;
+}
+export function getBranchKey(node, sourceFile, functionNode) {
+    let current = node;
+    while (current !== functionNode) {
+        const ifElseKey = getIfElseBranchKey(current, sourceFile);
+        if (ifElseKey)
+            return ifElseKey;
+        const ternaryKey = getTernaryBranchKey(current, sourceFile);
+        if (ternaryKey)
+            return ternaryKey;
+        const switchKey = getSwitchBranchKey(current, sourceFile);
+        if (switchKey)
+            return switchKey;
+        current = current.parent;
+    }
+    return null;
+}
+//# sourceMappingURL=async-waterfall-branch-keys.js.map

package/dist/checks/quality/patterns/async-waterfall-branch-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-waterfall-branch-keys.js","sourceRoot":"","sources":["../../../../src/checks/quality/patterns/async-waterfall-branch-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,UAAyB;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAClC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/C,MAAM,MAAM,GAAG,UAAU,CAAC,6BAA6B,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;IACpF,IAAI,OAAO,KAAK,UAAU,CAAC,aAAa;QAAE,OAAO,OAAO,MAAM,EAAE,CAAC;IACjE,IAAI,OAAO,KAAK,UAAU,CAAC,aAAa;QAAE,OAAO,SAAS,MAAM,EAAE,CAAC;IACnE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,UAAyB;IAC7E,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAClC,IAAI,CAAC,EAAE,CAAC,uBAAuB,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzD,MAAM,QAAQ,GAAG,UAAU,CAAC,6BAA6B,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;IACtF,IAAI,OAAO,KAAK,UAAU,CAAC,QAAQ;QAAE,OAAO,iBAAiB,QAAQ,EAAE,CAAC;IACxE,IAAI,OAAO,KAAK,UAAU,CAAC,SAAS;QAAE,OAAO,kBAAkB,QAAQ,EAAE,CAAC;IAC1E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,UAAyB;IAC5E,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3E,wIAAwI;IACxI,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;IACzC,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnD,MAAM,UAAU,GAAG,UAAU,CAAC,6BAA6B,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;IACxF,IAAI,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxD,OAAO,QAAQ,QAAQ,KAAK,UAAU,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,YAAY,UAAU,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,IAAa,EACb,UAAyB,EACzB,YAAqB;IAErB,IAAI,OAAO,GAAY,IAAI,CAAC;IAE5B,OAAO,OAAO,KAAK,YAAY,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC1D,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAEhC,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC5D,IAAI,UAAU;YAAE,OAAO,UAAU,CAAC;QAElC,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC1D,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAEhC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/checks/quality/patterns/async-waterfall-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async-waterfall-detection.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/patterns/async-waterfall-detection.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAybH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,sCAsClC,CAAC"}
+{"version":3,"file":"async-waterfall-detection.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/patterns/async-waterfall-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,sCAoClC,CAAC"}