Refactor: Rewrite in TypeScript, use bun as runtime

[glensc]

Why?

The original version was written in 2002:

• af53d6c

At that time, it was better alternative than shell scripting and awk, and there weren't really other options out there.

Currently this has become a problem. The app does not work properly in docker container:

• Add dockerfile based on alpine #19 (comment)

The ecosystem is also unknown to me, and the syntax and language glitches are already getting forgotten.

This is also barrier for contributions, for unknown language and difficult to test people don't submit contributions.

Also sending emails from local linux box has become an issue in 2024, you need to set up MARC, DKIM, and SPF? etc for emails not to end up in Spam. So instead of that, use some provider like sendgird of gmail smtp.

tasks

• Setup bun project #22
• framework for scrapers: Add Scraper class with helper methods for Scrapers #23
• one example scraper: Feature: Add Scrapers #24
• download scraper images: Feature: Add AttachmentBuilder class #26
• compose rich email: Feature: Add mail functionality #25
• send email using gmail smtp: Feature: Add mail functionality #25
• env support for secrets: Feature: Add mail functionality #25
• command line interface to specify recipients
• http client: Add HttpClient class #27
• Feature: Add ScrapeRunner class #31
• caching http requests: Feature: Update HttpClient to use NodeFetchCache #28
• keep track of sent comics (do not send again if site has not uploaded new comic)
• create scraper for other comics that still have them on site
  • Wumo: Feature: Add Scrapers #24
  • Turnoff: Feature: Add Scrapers #24
  • Oglaf: Feature: Add Scrapers #24
  • Xkcd: Feature: Add Scrapers #24
  • ...

Bun facts

• https://bun.sh/docs/install/lockfile
• https://bun.sh/docs/api/html-rewriter
• https://bun.sh/docs/cli/bun-create

Bun shortcomings

• no "bun outdated" command: Request: outdated CLI command oven-sh/bun#1223
• no "bun update" command: bun update: update all dependencies to latest version oven-sh/bun#1372
• fetch random errors (lack of http2 support?) Malformed_HTTP_Response: fetch() failed on amazon cloudfront 302 responses oven-sh/bun#8599
• no windows version: Windows Support oven-sh/bun#43

Mail sending

Sendgrid:

• https://docs.sendgrid.com/for-developers/sending-email/quickstart-nodejs

Gmail:

• https://blog.logrocket.com/sending-emails-node-js-nodemailer/

Create App password:

• https://myaccount.google.com/apppasswords

DOM parsing

• Incorporating JSDOM into V3 Chrome Extension Service Worker jsdom/jsdom#3315
• The MV3 migration guide recommends jsdom, but it cannot be used in browsers out of the box GoogleChrome/developer.chrome.com#2290
• JSDOM Support in the Browser? jsdom/jsdom#245 (comment)

[glensc]

Extracted things logically (as possible) and leaving just main.ts change here. Further changes will be done in normal flow.