feature/issue 1323 support for Bun

[thescientist13]

Related Issue

related to #1323

See example / demo repos here:

• https://github.com/thescientist13/greenwood-bun
• [demo] Bun thescientist13/greenwood-lit-ssr#31
• https://github.com/thescientist13/bun-node-compat-tests

Summary of Changes

1. Add GitHub Actions for Bun
2. Had to alter import for node-html-parser

Documentation

1. Add a PR to the website (home page, hosting, etc) (assuming all actions pass)
   • callout needing trustedDependencies to support postinstall scripts with Bun, like for the puppeteer plugin
   • make sure to run bun with --bun flag for NPM scripts
   • Decorators not supported? (Bun and Amaro) - support typescript@5 decorator oven-sh/bun#4122 (comment)

TODO

1. Actually use bun for npm scripts / github actions 🤦‍♂️
2. Some test cases are failing
   • e.g., images coming back as text/javascript
3. Validate / support custom loaders equivalent - see [demo] Bun thescientist13/greenwood-lit-ssr#31
4. Upgrade to latest node-html-parser (standalone issue / PR) - https://github.com/thescientist13/bun-node-compat-tests?tab=readme-ov-file#-node-html-parser
5. Upgrade to apollo/server v4 (standalone issue / PR) - https://github.com/thescientist13/bun-node-compat-tests?tab=readme-ov-file#%EF%B8%8F-apollo-graphql-server-playground

Upstreams / Issues

1. node-html-parser import - giving this one a pass for now - https://github.com/thescientist13/bun-node-compat-tests?tab=readme-ov-file#node-html-parser

      TypeError: htmlparser.parse is not a function. (In 'htmlparser.parse(html, {
        script: !0,
        style: !0
      })', 'htmlparser.parse' is undefined)
          at /Users/owenbuckley/Workspace/github/greenwood-bun/node_modules/@greenwood/cli/src/lib/resource-utils.js:116:27
          at trackResourcesForRoute (/Users/owenbuckley/Workspace/github/greenwood-bun/node_modules/@greenwood/cli/src/lib/resource-utils.js:114:39)
          at /Users/owenbuckley/Workspace/github/greenwood-bun/node_modules/@greenwood/cli/src/lifecycles/prerender.js:168:11
      

2. Had to check for an unexpected URL coming from Rollup - can't reproduce?

       {
          id: "\u0000commonjsHelpers.js",
          idUrl: URL {
            href: "file://commonjshelpers.js/",
            origin: "null",
            protocol: "file:",
            username: "",
            password: "",
            host: "commonjshelpers.js",
            hostname: "commonjshelpers.js",
            port: "",
            pathname: "/",
            hash: "",
            search: "",
            searchParams: URLSearchParams {},
            toJSON: [Function: toJSON],
            toString: [Function: toString],
          },
        }
      

3. Lit SSR - can not reproduce

        building from local sources...
        200 |   #onClose(e) {
        201 |     this.#onExitPromise = e.code, this.emit("exit", e.code);
        202 |   }
        203 |   #onError(event) {
        204 |     let error = event?.error;
        205 |       error = new Error(event.message, { cause: event });
                            ^
        error: 1 | /**
        2 |  * @license
        3 |  * Copyright 2017 Google LLC
        4 |  * SPDX-License-Identifier: BSD-3-Clause
        5 |  */
        6 | const t=globalThis,i=t.trustedTypes,s=i?i.createPolicy("lit-html",{createHTML:t=>t}):void 0,e="$lit$",h=`lit$${Math.random().toFixed(9).slice(2)}$`,o="?"+h,n=`<${o}>`,r=void 0===t.document?{createTreeWalker:()=>({})}:document,l=()=>r.createComment(""),c=t=>null===t||"object"!=typeof t&&"function"!=typeof t,a=Array.isArray,u=t=>a(t)||"function"==typeof t?.[Symbol.iterator],d="[ \t\n\f\r]",f=/<(?:(!--|\/[^a-zA-Z])|(\/?[a-zA-Z][^>\s]*)|(\/?$))/g,v=/-->/g,_=/>/g,m=RegExp(`>|${d}(?:([^\\s"'>=/]+)(${d}*=${d}*(?:[^ \t\n\f\r"'\`<>=]|("|')|))|$)`,"g"),p=/'/g,g=/"/g,$=/^(?:script|style|textarea|title)$/i,y=t=>(i,...s)=>({_$litType$:t,strings:i,values:s}),x=y(1),T=y(2),b=y(3),w=Symbol.for("lit-noChange"),E=Symbol.for("lit-nothing"),A=new WeakMap,C=r.createTreeWalker(r,129);function P(t,i){if(!a(t)||!t.hasOwnProperty("raw"))throw Error("invalid template strings array");return void 0!==s?s.createHTML(i):i}const V=(t,i)=>{const s=t.length-1,o=[];let r,l=2===i?"":3===i?"":"",c=f;for(let i=0;i TypeError: r.createTreeWalker is not a function. (In 'r.createTreeWalker(r, 129)', 'r.createTreeWalker' is undefined)
          at /Users/owenbuckley/Workspace/github/greenwood-lit-ssr/node_modules/lit-html/node/lit-html.js:6:750
    
          at #onError (node:worker_threads:205:15)
    
    Bun v1.2.2 (macOS arm64)
    error: script "build" exited with code 1
   

4. GraphQL failing - looks like we just need to upgrade to @apollo/server v4 - https://github.com/thescientist13/bun-node-compat-tests?tab=readme-ov-file#%EF%B8%8F-apollo-graphql-server-playground

      OPTIONS - /graphql failed
      30 |         }
      31 |         var connectionHandler = (function (socket, request) {
      32 |             socket.upgradeReq = request;
      33 |             if (socket.protocol === undefined ||
      34 |                 (socket.protocol.indexOf(protocol_1.GRAPHQL_WS) === -1 && socket.protocol.indexOf(protocol_1.GRAPHQL_SUBSCRIPTIONS) === -1)) {
      35 |                 socket.close(1002);
                                  ^
      TypeError: socket.close is not a function. (In 'socket.close(1002)', 'socket.close' is undefined)
            at connectionHandler (/Users/owenbuckley/Workspace/project-evergreen/greenwood/node_modules/subscriptions-transport-ws/dist/server.js:35:24)
      

5. Mocha test cases seem to run foreveeeeeer, since failing tests cases pass when run individually - Investigate why mocha is very slow oven-sh/bun#13087