@module-federation/treeshake-server 0.0.0-chore-bump-node-22-20260710161714

package/README.md

@@ -0,0 +1,65 @@
+# Treeshake Server
+
+An adapter-driven build service for shared treeshaking. The CLI runs in **local filesystem mode only** and embeds the treeshake UI automatically. When importing the package, you can register your own adapters, middlewares, and optional frontend UI.
+
+## CLI (embedded UI, local-only)
+
+```bash
+pnpm --filter @module-federation/treeshake-server dev
+# or
+pnpm --filter @module-federation/treeshake-server start
+```
+
+Defaults:
+
+- API: `http://localhost:3000/tree-shaking-shared`
+- UI: `http://localhost:3000/tree-shaking`
+- Storage: local filesystem (`LOCAL_STORE_DIR`, default `./log/static`)
+
+The CLI **ignores** `ADAPTER_ID` and always uses the local filesystem adapter.
+
+### Frontend env overrides (CLI)
+
+The CLI always embeds the UI. You can only override where it is served from:
+
+- `TREESHAKE_FRONTEND_DIST=/path/to/dist`
+- `TREESHAKE_FRONTEND_BASE_PATH=/tree-shaking`
+- `TREESHAKE_FRONTEND_SPA_FALLBACK=0`
+
+## Library usage (custom adapters + middlewares)
+
+```ts
+import { createAdapterRegistry, createAdapterDeps, createApp, createServer, LocalAdapter } from '@module-federation/treeshake-server';
+import { createTreeshakeFrontendAdapter } from '@module-federation/treeshake-frontend/adapter';
+
+const registry = createAdapterRegistry([
+  new LocalAdapter(),
+  // new MyCustomAdapter(),
+]);
+
+const deps = await createAdapterDeps({
+  registry,
+  adapterId: 'local', // or your custom adapter id
+});
+
+const app = createApp(deps, {
+  appExtensions: [
+    (appInstance) => {
+      appInstance.use('*', async (c, next) => {
+        c.res.headers.set('x-treeshake', 'true');
+        await next();
+      });
+    },
+  ],
+  frontendAdapters: [
+    createTreeshakeFrontendAdapter({
+      basePath: '/tree-shaking',
+      distDir: '/path/to/treeshake-frontend/dist',
+    }),
+  ],
+});
+
+createServer({ app, port: 3000, hostname: '0.0.0.0' });
+```
+
+In library mode you control the adapter registry, middleware, and frontend embedding.

package/bin/treeshake-server.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * Wrapper entry for the CLI.
+ *
+ * pnpm creates workspace bins during install. If the target is a build artifact
+ * (e.g. dist/server.js) and the package hasn't been built yet, install fails
+ * with ENOENT. This wrapper keeps installs clean, and still runs the built
+ * server when it's available.
+ */
+
+const path = require('path');
+
+const entry = path.join(__dirname, '..', 'dist', 'server.js');
+
+try {
+  // eslint-disable-next-line import/no-dynamic-require, global-require
+  require(entry);
+} catch (err) {
+  // If dist hasn't been built yet, show a helpful message and exit.
+  if (err && (err.code === 'MODULE_NOT_FOUND' || err.code === 'ENOENT')) {
+    // eslint-disable-next-line no-console
+    console.error(
+      [
+        'treeshake-server: missing build output at dist/server.js.',
+        '',
+        'Run:',
+        '  pnpm exec turbo run build --filter=@module-federation/treeshake-server',
+        '',
+      ].join('\n'),
+    );
+    process.exit(1);
+  }
+
+  throw err;
+}