Skip to content

fix(extract): keep decorators separated by a comment#1097

Open
JhohanBustamante wants to merge 1 commit into
DeusData:mainfrom
JhohanBustamante:fix/decorator-comment-drop
Open

fix(extract): keep decorators separated by a comment#1097
JhohanBustamante wants to merge 1 commit into
DeusData:mainfrom
JhohanBustamante:fix/decorator-comment-drop

Conversation

@JhohanBustamante

Copy link
Copy Markdown

Fixes #1095.

A comment between decorators drops every decorator above it

extract_decorators() walks prev-siblings and breaks on the first NAMED node.
Comments are named nodes in tree-sitter, so a comment interleaved in a
decorator run ends the walk:

@Post('login')                     // <-- dropped
@HttpCode(HttpStatus.OK)           // <-- dropped
// throttled per IP and per account
@Throttle({ default: { ttl: 900_000, limit: 5 } })   // <-- kept
async login(dto: LoginDto) { ... }

The route then has no @Post, so it vanishes from any decorator-based query:
documenting a decorator removes the endpoint from the graph. On the backend I was
indexing, exactly 1 of 95 HTTP endpoints was missing — the one whose throttle
policy carried an explanatory comment.

Comments are now transparent to the walk, the same way the anonymous tokens
(e.g. TS export) already were. Reuses the existing is_comment_node() helper.

Test

  • tests/test_extraction.c: extract_ts_decorators_survive_interleaved_comment

test-runner extraction → 214 passed (ASan + UBSan build).


Split out of #1075 per review, as one focused PR linked to its issue. The Cypher
composite-property fix is now #1096 / its own PR.

Comments are NAMED tree-sitter nodes, so the prev-sibling walk in
extract_decorators() stopped at one — silently dropping every decorator ABOVE
an interleaved comment:

    @post('login')                 <-- dropped
    @httpcode(HttpStatus.OK)       <-- dropped
    // throttled per IP and account
    @Throttle({ ... })             <-- kept
    async login(...)

The route then vanished from decorator/route queries, so documenting a
decorator made the endpoint disappear from the graph. Real-world impact: on a
NestJS backend, 1 of 95 HTTP endpoints was missing — the one whose throttle
policy carried an explanatory comment.

Comments are now transparent to the walk, the same way anonymous tokens
(e.g. TS `export`) already were. Reuses the existing is_comment_node() helper.

Signed-off-by: KolisCode <jhohantma@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

TS/JS extraction: a comment interleaved in a decorator run drops every decorator above it

1 participant