fix(dev): alias debug -> obug shim so astro dev runs on cloudflare v13

astro dev 500s on every request with "module is not defined" when the
@cloudflare/vite-plugin runner loads a component whose dep graph
includes the CJS `debug` package: it references `module.exports`, and
`module` is not a global in the workerd runner.

Astro core already replaced `debug` with `obug` (ESM fork) in
withastro/astro#15565, but integrations like expressive-code still
pull `debug` via their markdown/rehype pipelines
(expressive-code/expressive-code#439 tracks the same error).

`obug` only exposes named exports, so a raw alias breaks consumers
that do `import debug from "debug"`. Add `src/shims/debug.js` which
re-exports obug and re-exposes a default, then wire it in via
vite.resolve.alias. Install obug as a direct dependency so the shim
resolves in the Workers runner (it's only a transitive dep of astro
otherwise).

Also add .wrangler to .gitignore - the new dev mode writes local
state there.

Verified: all routes (/, /blog/, /posts/..., /about/, /archive/,
/projects/) return 200 under pnpm dev; pnpm check and pnpm build stay
green.

Author: nathanredblur

.gitignore

@@ -33,3 +33,6 @@ yarn.lock
 
 # generated resume PDFs (see scripts/generate-resume.ts)
 public/resume/*.pdf
+
+# wrangler configuration
+.wrangler

astro.config.mjs

@@ -157,6 +157,18 @@ export default defineConfig({
 
   vite: {
     plugins: [tailwindcss()],
+    resolve: {
+      alias: {
+        // Workaround for "module is not defined" in astro dev under
+        // @cloudflare/vite-plugin. The CJS `debug` package references
+        // `module.exports`, which fails in the Workers runner. The
+        // shim forwards to `obug` (ESM fork) and re-exposes a default
+        // export so consumers that do `import debug from "debug"`
+        // keep working. See withastro/astro#15565 and
+        // expressive-code/expressive-code#439.
+        debug: new URL("./src/shims/debug.js", import.meta.url).pathname,
+      },
+    },
     build: {
       rollupOptions: {
         onwarn(warning, warn) {

package.json

@@ -44,6 +44,7 @@
     "katex": "^0.16.37",
     "markdown-it": "^14.1.1",
     "mdast-util-to-string": "^4.0.0",
+    "obug": "^2.1.1",
     "overlayscrollbars": "^2.14.0",
     "pagefind": "^1.4.0",
     "photoswipe": "^5.4.4",

pnpm-lock.yaml

@@ -0,0 +1,10 @@
+// Drop-in ESM shim for the CJS `debug` package. The real `debug`
+// references `module.exports`, which throws "module is not defined"
+// when astro dev runs under @cloudflare/vite-plugin's workerd runner.
+// `obug` is a fork that is ESM-native but exports only named bindings;
+// most consumers do `import debug from "debug"` or `require("debug")`
+// and then call `debug("ns")`, so we re-expose a compatible default.
+import { createDebug, disable, enable, enabled, namespaces } from "obug";
+
+export default createDebug;
+export { createDebug, disable, enable, enabled, namespaces };