improvement(gmail): replace custom html-to-text regex with library

[waleedlatif1]

Summary

• Replaces the custom regex-based `htmlToPlainText` in `apps/sim/tools/gmail/utils.ts` with the `html-to-text` npm package
• Resolves 4 CodeQL alerts from fix(gmail): send emails as multipart/alternative so they render full-width #4611 (incomplete tag/entity handling, regex backtracking)
• `html-to-text` is already a dependency used by the outlook polling trigger and the mail/send route — no new deps

Type of Change

• Improvement

Testing

• 18 existing tests in `utils.test.ts` pass (2 updated for the library's whitespace handling)

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		May 15, 2026 2:44am

[cursor]

PR Summary

Medium Risk
Changes the plain-text fallback generation for HTML Gmail messages, which can subtly affect formatting/whitespace and link rendering in outgoing emails. Risk is mitigated by targeted selector configuration and updated unit tests but still impacts user-visible email content.

Overview
Replaces the custom regex-based htmlToPlainText implementation in apps/sim/tools/gmail/utils.ts with html-to-text’s convert() for more robust HTML stripping and entity decoding.

Configures conversion behavior (no word-wrapping, skip img/script/style, and suppress redundant anchor URLs / bare # anchors) and updates utils.test.ts expectations to match the library’s newline and NBSP handling, adding coverage for link elision and   fidelity.

^{Reviewed by Cursor Bugbot for commit 7cbf02a. Configure here.}

[greptile-apps]

Greptile Summary

Replaces the custom regex-based htmlToPlainText in apps/sim/tools/gmail/utils.ts with the html-to-text npm package (already a repo dependency), resolving CodeQL alerts around incomplete entity handling and regex backtracking.

• utils.ts: Swaps 12 lines of chained .replace() calls for a single convert() call with a selectors config that matches the pattern already used in outlook.ts (suppress link URLs, skip img/script/style).
• utils.test.ts: Updates two assertions to match the library's paragraph-separation behavior, adds explicit coverage for   preservation as U+00A0, and adds anchor-URL-elision assertions.

Confidence Score: 5/5

Safe to merge — the change is a straightforward library substitution with no new dependencies, matching an existing pattern in the repo.

The swap touches only one function in one file, reuses a library and configuration already proven elsewhere in the codebase, and is backed by an updated test suite that covers the behavioral differences introduced by the library (paragraph spacing,   handling, anchor URL suppression).

No files require special attention.

Important Files Changed

Filename	Overview
apps/sim/tools/gmail/utils.ts	Replaces regex-based htmlToPlainText with html-to-text's convert(); configuration mirrors the existing outlook.ts usage with anchor/img/script/style selectors.
apps/sim/tools/gmail/utils.test.ts	Two assertions updated for library whitespace semantics; new tests added for   preservation and anchor URL suppression.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["htmlToPlainText(html)"] --> B["convert(html, options)\nhtml-to-text library"]
    B --> C["wordwrap: false"]
    B --> D["selectors config"]
    D --> E["a: hideLinkHrefIfSameAsText\n+ noAnchorUrl"]
    D --> F["img: skip"]
    D --> G["script: skip"]
    D --> H["style: skip"]
    B --> I["Plain-text string\n(trimmed, entities decoded)"]

Loading

_{Reviews (2): Last reviewed commit: "improvement(gmail): match outlook select..." | Re-trigger Greptile}

[waleedlatif1]

@greptile

[waleedlatif1]

@cursor review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 7cbf02a. Configure here.}