@evjs/webpack-plugin

Webpack adapter for the ev framework. Thin wrapper over @evjs/build-tools that connects bundler-agnostic build logic to Webpack's plugin and loader APIs.

Installation

npm install @evjs/webpack-plugin

Exports

| Export | Description | |--------|-------------| | EvWebpackPlugin | Plugin that auto-discovers "use server" files and manages server builds | | server-fn-loader | Loader that transforms "use server" files for client/server |

How It Works

EvWebpackPlugin

1. Scans client modules for "use server" files via detectUseServer() from build-tools.
2. Generates a server entry via generateServerEntry() — produces a virtual data-URI module.
3. Spawns a child compiler targeting Node.js — builds the server bundle alongside the client.
4. Emits manifest.json mapping function IDs to their module and export names.

server-fn-loader

Auto-detects whether it's running in the client or server compiler and delegates to transformServerFile():

• Client compiler → replaces function bodies with RPC stubs.
• Server compiler → keeps original source, appends registrations, and reports to the manifest.

Usage

const { EvWebpackPlugin } = require("@evjs/webpack-plugin");

module.exports = {
  plugins: [
    new EvWebpackPlugin({
      server: {
        // App factory (default: "@evjs/runtime/server#createApp")
        appFactory: "@evjs/runtime/server#createApp",
        // Runner — bake into bundle for self-starting dev server
        runner: process.env.NODE_ENV === "development"
          ? "@evjs/runtime/server#serve"
          : undefined,
        // Extra imports (middleware, config, etc.)
        setup: [],
      },
    }),
  ],
  module: {
    rules: [
      {
        test: /\.tsx?$/,
        exclude: /node_modules/,
        use: [
          { loader: "swc-loader" },
          { loader: "@evjs/webpack-plugin/server-fn-loader" },
        ],
      },
    ],
  },
};

Plugin Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | server.appFactory | string | "@evjs/runtime/server#createApp" | Module ref for app factory | | server.runner | string? | undefined | Module ref for auto-starting the server | | server.setup | string[] | [] | Extra imports to prepend to server entry |