@evjs/webpack-plugin 0.0.1-rc.15 → 0.0.1-rc.17

package/README.md

@@ -41,8 +41,8 @@ module.exports = {
       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"
+        // Backend — bake into bundle for self-starting dev server
+        backend: process.env.NODE_ENV === "development"
           ? "@evjs/runtime/server#serve"
           : undefined,
         // Extra imports (middleware, config, etc.)
@@ -70,5 +70,5 @@ module.exports = {
 | 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.backend` | `string?` | `undefined` | Module ref for auto-starting the server |
 | `server.setup` | `string[]` | `[]` | Extra imports to prepend to server entry |

package/esm/server-fn-loader.d.ts

@@ -1,5 +1,6 @@
 import type { Compiler } from "webpack";
 interface LoaderContext {
+    async(): (err: Error | null, result?: string, sourceMap?: unknown) => void;
     getOptions(): {
         isServer?: boolean;
     };
@@ -18,6 +19,6 @@ interface LoaderContext {
  * Webpack loader for "use server" files.
  * Thin wrapper that delegates to @evjs/build-tools for the actual transformation.
  */
-export default function serverFnLoader(this: LoaderContext, source: string): Promise<string>;
+export default function serverFnLoader(this: LoaderContext, source: string): Promise<void>;
 export {};
 //# sourceMappingURL=server-fn-loader.d.ts.map

package/esm/server-fn-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-fn-loader.d.ts","sourceRoot":"","sources":["../src/server-fn-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,UAAU,aAAa;IACrB,UAAU,IAAI;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,QAAQ,GAAG;QACrB,sBAAsB,CAAC,EAAE;YACvB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAC;SAC3E,CAAC;KACH,CAAC;CACH;AAED;;;GAGG;AACH,wBAA8B,cAAc,CAC1C,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAmBjB"}
+{"version":3,"file":"server-fn-loader.d.ts","sourceRoot":"","sources":["../src/server-fn-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,UAAU,aAAa;IACrB,KAAK,IAAI,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3E,UAAU,IAAI;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,QAAQ,GAAG;QACrB,sBAAsB,CAAC,EAAE;YACvB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAC;SAC3E,CAAC;KACH,CAAC;CACH;AAED;;;GAGG;AACH,wBAA8B,cAAc,CAC1C,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/esm/server-fn-loader.js

@@ -4,21 +4,29 @@ import { transformServerFile } from "@evjs/build-tools";
  * Thin wrapper that delegates to @evjs/build-tools for the actual transformation.
  */
 export default async function serverFnLoader(source) {
-    const explicitOptions = this.getOptions() || {};
-    let isServer = explicitOptions.isServer;
-    if (typeof isServer === "undefined") {
-        const compilerName = this._compiler?.name;
-        const target = this._compiler?.options?.target;
-        isServer = compilerName === "evServer" || target === "node";
+    const callback = this.async();
+    try {
+        const explicitOptions = this.getOptions() || {};
+        let isServer = explicitOptions.isServer;
+        if (typeof isServer === "undefined") {
+            const compilerName = this._compiler?.name;
+            const target = this._compiler?.options?.target;
+            isServer = compilerName === "evServer" || target === "node";
+        }
+        const manifestCollector = this._compiler?._ev_manifest_collector;
+        const result = await transformServerFile(source, {
+            resourcePath: this.resourcePath,
+            rootContext: this.rootContext,
+            isServer: !!isServer,
+            onServerFn: manifestCollector
+                ? (fnId, meta) => manifestCollector.addServerFn(fnId, meta)
+                : undefined,
+        });
+        const map = result.map ? JSON.parse(result.map) : undefined;
+        callback(null, result.code, map);
+    }
+    catch (err) {
+        callback(err);
     }
-    const manifestCollector = this._compiler?._ev_manifest_collector;
-    return transformServerFile(source, {
-        resourcePath: this.resourcePath,
-        rootContext: this.rootContext,
-        isServer: !!isServer,
-        onServerFn: manifestCollector
-            ? (fnId, meta) => manifestCollector.addServerFn(fnId, meta)
-            : undefined,
-    });
 }
 //# sourceMappingURL=server-fn-loader.js.map

package/esm/server-fn-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-fn-loader.js","sourceRoot":"","sources":["../src/server-fn-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAcxD;;;GAGG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,cAAc,CAE1C,MAAc;IAEd,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAChD,IAAI,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC;IACxC,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;QAC/C,QAAQ,GAAG,YAAY,KAAK,UAAU,IAAI,MAAM,KAAK,MAAM,CAAC;IAC9D,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAEjE,OAAO,mBAAmB,CAAC,MAAM,EAAE;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,UAAU,EAAE,iBAAiB;YAC3B,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;YAC3D,CAAC,CAAC,SAAS;KACd,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"server-fn-loader.js","sourceRoot":"","sources":["../src/server-fn-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAexD;;;GAGG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,cAAc,CAE1C,MAAc;IAEd,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;QAChD,IAAI,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC;QACxC,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YACpC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;YAC/C,QAAQ,GAAG,YAAY,KAAK,UAAU,IAAI,MAAM,KAAK,MAAM,CAAC;QAC9D,CAAC;QAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC;QAEjE,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE;YAC/C,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,UAAU,EAAE,iBAAiB;gBAC3B,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;gBAC3D,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,GAAY,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evjs/webpack-plugin",
-  "version": "0.0.1-rc.15",
+  "version": "0.0.1-rc.17",
   "description": "Webpack plugin and loaders for the ev framework",
   "type": "module",
   "publishConfig": {
@@ -23,8 +23,7 @@
     "check-types": "tsc --noEmit"
   },
   "files": [
-    "esm",
-    "AGENT.md"
+    "esm"
   ],
   "keywords": [
     "evjs",
@@ -36,10 +35,11 @@
   "author": "xusd320",
   "license": "MIT",
   "dependencies": {
-    "@evjs/build-tools": "0.0.1-rc.15",
-    "@evjs/manifest": "0.0.1-rc.15"
+    "@evjs/build-tools": "*",
+    "@evjs/manifest": "*"
   },
   "devDependencies": {
+    "@types/node": "^22.13.5",
     "typescript": "^5.7.3",
     "webpack": "^5.105.4"
   },

package/AGENT.md

@@ -1,104 +0,0 @@
-# @evjs/webpack-plugin — Agent Guide
-
-> AI-agent reference for the `@evjs/webpack-plugin` package. This is an internal package used by `@evjs/cli` — application developers don't configure it directly.
-
-## Overview
-
-Webpack adapter wrapping `@evjs/build-tools`. Provides:
-1. **`EvWebpackPlugin`** — webpack plugin for server function discovery + child compilation
-2. **`server-fn-loader`** — webpack loader for `"use server"` file transforms
-
-## EvWebpackPlugin
-
-Auto-discovers `"use server"` files, generates server entry, spawns a server-targeted child compiler, and emits `dist/manifest.json`.
-
-```js
-const { EvWebpackPlugin } = require("@evjs/webpack-plugin");
-
-new EvWebpackPlugin({
-  server: {
-    appFactory: "@evjs/runtime/server#createApp",       // default
-    runner: "@evjs/runtime/server#serve",                // for self-starting servers
-    middleware: ["./src/middleware/auth#default"],        // middleware imports
-  },
-});
-```
-
-### Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `server.appFactory` | `string` | `"@evjs/runtime/server#createApp"` | Hono app factory module ref |
-| `server.runner` | `string?` | `undefined` | Runner module ref (e.g., `"@evjs/runtime/server#serve"`) |
-| `server.middleware` | `string[]` | `[]` | Middleware module refs prepended to server entry |
-
-### What It Does (Build Pipeline)
-
-1. **Discovery** — globs for `*.server.{ts,js,tsx,jsx}` in source tree
-2. **Client transform** — `server-fn-loader` replaces function bodies with `__fn_call` stubs
-3. **Server entry generation** — calls `generateServerEntry()` from `@evjs/build-tools`
-4. **Child compiler** — spawns a webpack child compilation targeting `node` with the server entry
-   - **Externals**: all third-party `node_modules` are externalized (essential for native addons like `better-sqlite3`); `@evjs/*` packages are bundled into the CJS output
-5. **Manifest emission** — writes `dist/manifest.json` via `processAssets` hook
-
-### Output
-
-```
-dist/
-├── client/              # client webpack output
-│   ├── main.[hash].js
-│   └── index.html
-├── manifest.json        # unified manifest (server + client)
-└── server/
-    └── main.[hash].js   # server bundle (Node.js)
-```
-
-### Manifest Format
-
-```json
-{
-  "version": 1,
-  "server": {
-    "entry": "main.a1b2c3d4.js",
-    "fns": {
-      "abc123:getUsers": {
-        "moduleId": "./api/users.server",
-        "export": "getUsers"
-      }
-    }
-  }
-}
-```
-
-## server-fn-loader
-
-Webpack loader for `"use server"` files. Automatically detects whether it's running in the client or server compiler and applies the appropriate transform.
-
-```js
-{
-  test: /\.server\.(ts|tsx|js|jsx)$/,
-  use: [
-    { loader: "swc-loader" },
-    { loader: "@evjs/webpack-plugin/server-fn-loader" },
-  ],
-}
-```
-
-**Client compiler** → replaces function bodies with `__fn_call` RPC stubs
-**Server compiler** → preserves function bodies, appends `registerServerFn()` calls
-
-## Key Files
-
-| File | Purpose |
-|------|---------|
-| `src/index.ts` | `EvWebpackPlugin` — main plugin |
-| `src/server-fn-loader.ts` | Webpack loader for `"use server"` transforms |
-
-## Integration with @evjs/cli
-
-`@evjs/cli` creates the webpack config in `create-webpack-config.ts`:
-
-1. Adds `EvWebpackPlugin` to plugins
-2. Adds `server-fn-loader` to module rules (before `swc-loader`)
-3. Configures dev server proxy for `/api/fn` → API server
-4. In dev mode, sets `runner` to `"@evjs/runtime/server#serve"` for auto-start