@recranet/astro-workers-for-platforms-adapter 1.0.2 → 1.1.0

package/README.md

@@ -1 +1,43 @@
 # astro-workers-for-platforms-adapter
+
+Custom Astro adapter for Cloudflare Workers for Platforms.
+
+## How it works
+
+```
+Request → Dispatch Worker → User Worker (worker-entry.mjs) → env.ASSETS.fetch()
+```
+
+This adapter ensures Astro always emits a worker entry, even for fully static sites. While static assets could be uploaded to R2 and served by the dispatch worker.
+Workers for Platforms supports a native Static Assets binding (`env.ASSETS`) that serves files from the edge with per-tenant isolation — no R2 needed.
+
+Running `astro build` produces two outputs: a bundled worker at `dist/server/entry.mjs` and static assets in `dist/client/`. The adapter sets `ssr.noExternal: true` so Vite inlines all dependencies into a single file with no external imports.
+
+Deployment uses the Workers for Platforms asset upload API in three steps: create session, upload asset buckets, then deploy the worker with a completion token.
+
+## Why not `@astrojs/cloudflare`?
+
+The official `@astrojs/cloudflare` adapter cannot be used here because:
+
+- It requires wrangler as a peer dependency (we deploy programmatically via the API, not with wrangler)
+- As of Astro 6, it deletes `_worker.js` for fully static sites — Workers for Platforms always needs a worker entry
+
+## Getting started
+
+```bash
+npm install @recranet/astro-workers-for-platforms-adapter
+```
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import astroWorkersForPlatformsAdapter from '@recranet/astro-workers-for-platforms-adapter';
+
+export default defineConfig({
+  adapter: astroWorkersForPlatformsAdapter(),
+});
+```
+
+## References
+
+- [Cloudflare VibeSDK](https://github.com/cloudflare/vibesdk/blob/27b7a9bf9e8fcced21e28f7c97d9134c120614f3/worker/agents/core/codingAgent.ts#L729)

package/adapter.mjs

@@ -1,29 +1,5 @@
-// Custom Astro adapter for Cloudflare Workers for Platforms.
-//
-// Architecture:
-//   Request → Dispatch Worker → User Worker (worker-entry.mjs) → env.ASSETS.fetch()
-//
-// This adapter ensures Astro always emits a worker entry, even for fully static sites.
-// While static assets could be uploaded to R2 and served by the dispatch worker,
-// Workers for Platforms supports a native Static Assets binding (env.ASSETS) that
-// serves files from the edge with per-tenant isolation — no R2 needed.
-//
-// The official @astrojs/cloudflare adapter cannot be used here because:
-//   - It requires wrangler as a peer dependency (we deploy via the CF API directly)
-//   - As of Astro 6 (PR #15478), it deletes the _worker.js output for fully static
-//     sites, which is the opposite of what Workers for Platforms needs
-//   - Its worker entrypoint is designed for Pages/Workers, not the dispatch namespace
-//     API with env.ASSETS binding and run_worker_first config
-//
-// Build flow:
-//   `astro build` triggers this adapter, which sets `ssr.noExternal: true` so Vite
-//   bundles all dependencies (including hono/utils/mime used in worker-entry.mjs)
-//   into a single dist/server/entry.mjs with no external imports. Static assets
-//   are prerendered into dist/client/.
-//
-// The build output (entry.mjs + static assets) is deployed using the Workers for
-// Platforms 3-step asset upload API (create session → upload buckets → deploy
-// worker with completion token).
+import purgeAssets from './vite-plugin-purge-assets.mjs';
+
 export default function astroWorkersForPlatformsAdapter() {
   return {
     name: '@recranet/astro-workers-for-platforms-adapter',
@@ -31,6 +7,7 @@ export default function astroWorkersForPlatformsAdapter() {
       'astro:config:setup': ({ updateConfig }) => {
         updateConfig({
           vite: {
+            plugins: [purgeAssets()],
             ssr: {
               // Bundle all dependencies into the server entry (no external imports)
               noExternal: true,
@@ -53,6 +30,9 @@ export default function astroWorkersForPlatformsAdapter() {
           },
         });
       },
+      'astro:build:done': ({ logger }) => {
+        logger.info('Build complete');
+      },
     },
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recranet/astro-workers-for-platforms-adapter",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "type": "module",
   "exports": {
     ".": {
@@ -13,15 +13,13 @@
     "adapter.d.mts",
     "worker-entry.mjs",
     "preview-entry.mjs",
-    "vite-plugin-astro-preview.mjs"
+    "vite-plugin-astro-preview.mjs",
+    "vite-plugin-purge-assets.mjs"
   ],
   "peerDependencies": {
     "astro": "^6.0.0"
   },
   "dependencies": {
     "hono": "^4.12.7"
-  },
-  "scripts": {
-    "publish": "npm publish . --access public"
   }
 }

package/vite-plugin-purge-assets.mjs

@@ -0,0 +1,60 @@
+/**
+ * Vite plugin that removes unreferenced assets from the bundle.
+ *
+ * Uses Rollup's `generateBundle` hook to inspect all emitted chunks and assets.
+ * Any asset not referenced by a chunk or another asset is deleted from the
+ * bundle before it is written to disk.
+ */
+export default function purgeAssets() {
+  return {
+    name: 'purge-assets',
+    apply: 'build',
+    enforce: 'post',
+    generateBundle(_, bundle) {
+      // Collect all asset filenames
+      const assetFiles = new Set();
+      for (const [fileName, item] of Object.entries(bundle)) {
+        if (item.type === 'asset') {
+          assetFiles.add(fileName);
+        }
+      }
+
+      // Collect references from chunks (JS/CSS) and HTML assets
+      const referenced = new Set();
+      for (const item of Object.values(bundle)) {
+        let source;
+        if (item.type === 'chunk') {
+          source = item.code;
+        } else if (
+          item.type === 'asset' &&
+          typeof item.source === 'string'
+        ) {
+          source = item.source;
+        }
+        if (!source) continue;
+
+        for (const assetFile of assetFiles) {
+          if (referenced.has(assetFile)) continue;
+          // Match the asset's basename — handles both relative and absolute references
+          const baseName = assetFile.split('/').pop();
+          if (source.includes(baseName)) {
+            referenced.add(assetFile);
+          }
+        }
+      }
+
+      // Delete unreferenced assets
+      let purged = 0;
+      for (const assetFile of assetFiles) {
+        if (!referenced.has(assetFile)) {
+          delete bundle[assetFile];
+          purged++;
+        }
+      }
+
+      if (purged > 0) {
+        this.info(`Purged ${purged} unreferenced asset(s)`);
+      }
+    },
+  };
+}