vite-elysia-forge 1.0.3 → 1.0.4

package/README.md

@@ -18,7 +18,7 @@ bun install vite-elysia-forge
 
 ### 2.1 Create Your API Handler
 
-Place your Elysia handler at `src/server/api.ts` (default path):
+Place your Elysia handler at `server/api.ts` (default path):
 
 ```ts
 import { Elysia } from "elysia";
@@ -43,7 +43,7 @@ import elysiaPlugin from "vite-elysia-forge";
 export default defineConfig({
   plugins: [
     elysiaPlugin({
-      serverFile: "./src/server/api.ts",
+      serverFile: "./server/api.ts",
     }),
   ],
 });
@@ -126,7 +126,7 @@ To enable WebSocket support, set `ws: true`:
 
 ```ts
 elysiaPlugin({
-  serverFile: "./src/server/api.ts",
+  serverFile: "./server/api.ts",
   ws: true, // Enable WebSocket support
   backendPort: 3001, // API runs on this port (default: 3001)
 });
@@ -176,27 +176,18 @@ const app = new Elysia().use(
 
 ## 7. Production Deployment
 
-The CLI provides build commands for separate frontend and backend deployment. Frontend and backend are **always built separately** for independent deployment.
+The CLI provides a `build` command for building your Elysia API server. Frontend assets should be built separately using Vite's standard build process (`vite build`).
 
-By default, the CLI looks for your API at `src/server/api.ts`. You can specify a custom path with the `--api` flag:
+By default, the CLI looks for your API at `server/api.ts`. You can specify a custom path with the `--entry` flag.
 
-```bash
-vite-elysia-forge build-static
-vite-elysia-forge build-server --api server/api.ts
-```
-
-### 7.1 Frontend Build (`build-static`)
+### 7.1 Frontend Build
 
-Build the frontend static assets.
+Build your frontend using Vite directly:
 
 ```bash
-vite-elysia-forge build-static
+vite build
 ```
 
-**What it does:**
-
-1. Runs `vite build` to compile your frontend to `dist/`
-
 **Output:**
 
 ```
@@ -207,89 +198,97 @@ dist/
 
 Deploy to any static host (Cloudflare Pages, Netlify, Vercel, etc.)
 
-### 7.2 Server Build (`build-server`)
+### 7.2 Server Build (`--outDir`)
 
 Build the Elysia API server into a standalone JavaScript bundle.
 
 ```bash
-vite-elysia-forge build-server
+vite-elysia-forge build --outDir dist
 ```
 
 **What it does:**
 
 1. Generates a production entry file that imports your API
-2. Bundles the server into `build/server.js` (default)
+2. Bundles the server into `dist/server.js`
 
 **package.json:**
 
 ```json
 {
   "scripts": {
-    "build:server": "vite-elysia-forge build-server",
-    "start": "bun build/server.js"
+    "build:server": "vite-elysia-forge build --outDir dist",
+    "start": "bun dist/server.js"
   }
 }
 ```
 
-**Custom output directory:**
+**With custom entry and target:**
 
 ```bash
-vite-elysia-forge build-server --server .output
+vite-elysia-forge build --entry src/my-api.ts --outDir .output --target node
 ```
 
-### 7.3 Compiled Binary (`build-compile`)
+### 7.3 Compiled Binary (`--outFile`)
 
-Build the server and compile it into a **standalone executable** (no Bun runtime required).
+Build and compile the server into a **standalone executable** (no Bun runtime required).
 
 ```bash
-vite-elysia-forge build-compile
+vite-elysia-forge build --outFile server
 ```
 
 **What it does:**
 
-1. Performs the server build
-2. Compiles `build/server.js` into a native binary at `build/server`
+1. Bundles the server code
+2. Compiles into a native binary at the specified path
 
 **package.json:**
 
 ```json
 {
   "scripts": {
-    "build:server": "vite-elysia-forge build-compile",
-    "start": "./build/server"
+    "build:server": "vite-elysia-forge build --outFile dist/server",
+    "start": "./dist/server"
   }
 }
 ```
 
 ### 7.4 CLI Reference
 
-| Command         | Description                                   |
-| :-------------- | :-------------------------------------------- |
-| `build-static`  | Build frontend static assets only             |
-| `build-server`  | Build API server bundle (JavaScript)          |
-| `build-compile` | Build and compile server to native executable |
+**Command:**
+
+```bash
+vite-elysia-forge build [options]
+```
 
 **Options:**
 
-| Option           | Short | Default             | Description                 |
-| :--------------- | :---: | :------------------ | :-------------------------- |
-| `--api <path>`   | `-a`  | `src/server/api.ts` | Path to API entry file      |
-| `--server <dir>` | `-o`  | `build`             | Output directory for server |
+| Option              | Short | Default         | Description                                |
+| :------------------ | :---: | :-------------- | :----------------------------------------- |
+| `--entry <path>`    | `-e`  | `server/api.ts` | Path to API entry file                     |
+| `--outDir <dir>`    | `-d`  | `dist`          | Output directory for bundled `server.js`   |
+| `--outFile <file>`  | `-o`  | —               | Output path for compiled standalone binary |
+| `--target <target>` | `-t`  | `bun`           | Build target: `bun`, `node`, or `browser`  |
+| `--no-minify`       |   —   | —               | Disable minification                       |
+
+> **Note:** `--outDir` and `--outFile` are mutually exclusive. Use `--outDir` for a bundled JS file, or `--outFile` for a compiled binary.
 
 **Examples:**
 
 ```bash
-# Build frontend
-vite-elysia-forge build-static
+# Bundle server to dist/server.js
+vite-elysia-forge build --outDir dist
+
+# Bundle with node target
+vite-elysia-forge build --outDir dist --target node
 
-# Build server with custom API path
-vite-elysia-forge build-server --api src/my-api.ts
+# Compile to standalone binary
+vite-elysia-forge build --outFile server
 
-# Build server to custom directory
-vite-elysia-forge build-server --server .output
+# Compile with custom entry
+vite-elysia-forge build --entry src/api/index.ts --outFile myserver
 
-# Build compiled binary
-vite-elysia-forge build-compile --server dist
+# Bundle without minification
+vite-elysia-forge build --outDir dist --no-minify
 ```
 
 ### 7.5 Deployment Architecture
@@ -301,20 +300,20 @@ vite-elysia-forge build-compile --server dist
 │  Static Host    │         │   API Server     │
 │  (CDN/Pages)    │◄────────┤   (VPS/Cloud)    │
 │                 │  CORS   │                  │
-│  dist/          │         │  build/server.js │
+│  dist/          │         │  dist/server.js  │
 └─────────────────┘         └──────────────────┘
 ```
 
-- Frontend: Deploy `dist/` to Cloudflare Pages, Netlify, Vercel, etc.
-- Backend: Deploy `build/server.js` to any server with Bun installed, or use the compiled binary
+- Frontend: Build with `vite build` and deploy to Cloudflare Pages, Netlify, Vercel, etc.
+- Backend: Build with `vite-elysia-forge build --outDir dist` and deploy to any server with Bun installed, or use the compiled binary
 
 **API-only deployment:**
 
 If you have no frontend, just build and deploy the server:
 
 ```bash
-vite-elysia-forge build-server
-bun build/server.js
+vite-elysia-forge build --outDir dist
+bun dist/server.js
 ```
 
 ## 8. Troubleshooting
@@ -355,7 +354,7 @@ If you see `Current adapter doesn't support WebSocket`, you need to enable WS mo
 
 ```ts
 elysiaPlugin({
-  serverFile: "./src/server/api.ts",
+  serverFile: "./server/api.ts",
   ws: true,
 });
 ```

package/dist/cli.d.ts

@@ -1,39 +1,38 @@
 #!/usr/bin/env bun
 /**
- * Build options for customizing output directories.
+ * Bun build target options.
+ */
+type BuildTarget = "bun" | "node" | "browser";
+/**
+ * Build options for the server bundle.
  */
 interface BuildOptions {
     /**
      * Path to the API entry file.
-     * @default "src/server/api.ts"
+     * @default "server/api.ts"
      */
-    apiEntry?: string;
+    entry?: string;
     /**
-     * Output directory for the Vite/frontend static assets.
-     * @default "dist"
+     * Output directory for the server bundle (used with --outDir).
+     * Mutually exclusive with outFile.
      */
-    staticDir?: string;
+    outDir?: string;
     /**
-     * Output directory for the Elysia server bundle.
-     * When set to a different value than staticDir, the server and static assets
-     * will be built to separate directories.
-     * @default "dist" (same as staticDir)
+     * Output file path for compiled standalone binary (used with --outFile).
+     * Mutually exclusive with outDir.
      */
-    serverDir?: string;
+    outFile?: string;
     /**
-     * Whether to skip the Vite frontend build.
-     * Useful when you only want to rebuild the server.
-     * @default false
+     * Build target for Bun.build.
+     * @default "bun"
      */
-    skipVite?: boolean;
+    target?: BuildTarget;
     /**
-     * Whether to skip the server build.
-     * Useful when you only want to rebuild the frontend.
-     * @default false
+     * Whether to minify the output.
+     * @default true
      */
-    skipServer?: boolean;
+    minify?: boolean;
 }
-declare function build(options?: BuildOptions | string): Promise<void>;
-declare function buildCompile(options?: BuildOptions | string): Promise<void>;
+declare function build(options?: BuildOptions): Promise<void>;
 
-export { type BuildOptions, build, buildCompile };
+export { type BuildOptions, type BuildTarget, build };

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env bun
-import {spawnSync}from'child_process';import {existsSync,mkdirSync,writeFileSync,unlinkSync,rmSync}from'fs';import {resolve,relative,sep}from'path';async function f(r={}){let e=typeof r=="string"?{apiEntry:r}:r,o=e.apiEntry||"src/server/api.ts",s=e.staticDir||"dist",t=e.serverDir||s,p=e.skipVite||false,v=e.skipServer||false,h=s!==t,g=resolve(process.cwd(),o);if(!v&&!existsSync(g)&&(console.error(`\u274C API entry file "${o}" not found.`),console.error('   By default, vite-elysia-forge looks for "src/server/api.ts".'),console.error("   If your API is located elsewhere, please specify the path:"),console.error("   $ vite-elysia-forge build --api <path-to-your-api-file>"),process.exit(1)),!p){console.log(`\u{1F4E6} Building frontend to "${s}"...`);let i=spawnSync("bun",["x","vite","build","--outDir",s],{stdio:"inherit",env:{...process.env,NODE_ENV:"production"}});i.status!==0&&(console.error("\u274C Vite build failed"),process.exit(i.status||1)),console.log(`\u2705 Frontend built to "${s}"`);}if(v){console.log("\u23ED\uFE0F  Skipping server build (--skip-server)");return}let n=resolve(process.cwd(),".output");existsSync(n)||mkdirSync(n,{recursive:true});let u=resolve(n,".temp-prod.ts"),l=relative(n,g);l=l.split(sep).join("/"),l.startsWith(".")||(l="./"+l);let k=`
+import {spawnSync}from'child_process';import {existsSync,mkdirSync,writeFileSync,unlinkSync,rmSync}from'fs';import {resolve,relative,sep,dirname}from'path';async function w(t={}){let o=t.entry||"server/api.ts",r=t.target||"bun",n=t.minify!==false,e=resolve(process.cwd(),o);existsSync(e)||(console.error(`\u274C API entry file "${o}" not found.`),console.error('   By default, vite-elysia-forge looks for "server/api.ts".'),console.error("   If your API is located elsewhere, please specify the path:"),console.error("   $ vite-elysia-forge build --entry <path-to-your-api-file>"),process.exit(1));let s=resolve(process.cwd(),".vef-temp");existsSync(s)||mkdirSync(s,{recursive:true});let i=resolve(s,".temp-prod.ts"),l=relative(s,e);l=l.split(sep).join("/"),l.startsWith(".")||(l="./"+l);let p=`
 import { Elysia } from "elysia";
 import { api } from ${JSON.stringify(l)};
 
@@ -9,7 +9,7 @@ if (api) app.use(api);
 const port = process.env.PORT ? parseInt(process.env.PORT) : 3000;
 app.listen(port);
 
-console.log(\`Production server running at http://localhost:\${port}\`);
-`;writeFileSync(u,k);let y=resolve(process.cwd(),t);existsSync(y)||mkdirSync(y,{recursive:true}),console.log(`\u{1F4E6} Building server to "${t}"...`);try{let i=await Bun.build({entrypoints:[u],outdir:t,target:"bun",minify:!0,naming:"server.js"});if(!i.success){console.error("\u274C Server build failed");for(let S of i.logs)console.error(S);process.exit(1);}console.log(`\u2705 Server built to "${t}/server.js"`);}catch(i){console.error("\u274C Failed to build server. Ensure you are running this command with Bun."),console.error(i),process.exit(1);}finally{existsSync(u)&&unlinkSync(u),existsSync(n)&&rmSync(n,{recursive:true,force:true});}h&&(console.log(`
-\u{1F4C1} Output structure:`),console.log(`   Static assets: ${s}/`),console.log(`   Server bundle: ${t}/server.js`),console.log(`
-\u{1F4A1} To run: cd ${t} && bun server.js`),console.log("   Or set STATIC_DIR to override the static assets path"));}async function P(r={}){let e=typeof r=="string"?{apiEntry:r}:r,o=e.serverDir||e.staticDir||"dist";await f(e),console.log("\u{1F527} Compiling server to standalone binary...");let s=resolve(process.cwd(),o,"server.js"),t=resolve(process.cwd(),o,"server"),p=spawnSync("bun",["build","--compile",s,"--outfile",t],{stdio:"inherit",env:{...process.env,NODE_ENV:"production"}});p.status!==0&&(console.error("\u274C Bun compile failed"),process.exit(p.status||1)),console.log(`\u2705 Compiled standalone binary: ${o}/server`);}function d(r){let e={};for(let o=0;o<r.length;o++){let s=r[o],t=r[o+1];switch(s){case "--api":case "-a":t&&!t.startsWith("-")&&(e.apiEntry=t,o++);break;case "--static":case "-s":t&&!t.startsWith("-")&&(e.staticDir=t,o++);break;case "--server":case "-o":t&&!t.startsWith("-")&&(e.serverDir=t,o++);break;case "--skip-vite":e.skipVite=true;break;case "--skip-server":e.skipServer=true;break;default:s&&!s.startsWith("-")&&!e.apiEntry&&(e.apiEntry=s);}}return e}if(import.meta.main){let r=process.argv.slice(2),e=r[0],o=r.slice(1);if(e==="build"){let s=d(o);f(s);}else if(e==="build-compile"){let s=d(o);P(s);}else if(e==="build-static"){let s=d(o);s.skipServer=true,f(s);}else if(e==="build-server"){let s=d(o);s.skipVite=true,f(s);}else console.log("Usage: vite-elysia-forge <command> [options]"),console.log(""),console.log("Commands:"),console.log("  build          Build frontend + bundle server"),console.log("  build-compile  Build and compile a standalone server binary"),console.log("  build-static   Build only the frontend (skip server)"),console.log("  build-server   Build only the server (skip frontend)"),console.log(""),console.log("Options:"),console.log("  --api, -a <path>     Path to API entry file (default: src/server/api.ts)"),console.log("  --static, -s <dir>   Output directory for static assets (default: dist)"),console.log("  --server, -o <dir>   Output directory for server bundle (default: same as --static)"),console.log("  --skip-vite          Skip the Vite frontend build"),console.log("  --skip-server        Skip the server build"),console.log(""),console.log("Examples:"),console.log("  # Build everything to 'dist/' (default)"),console.log("  vite-elysia-forge build"),console.log(""),console.log("  # Build with separate output directories"),console.log("  vite-elysia-forge build --static dist --server .output"),console.log(""),console.log("  # Build only the frontend"),console.log("  vite-elysia-forge build-static --static public"),console.log(""),console.log("  # Build only the server to a separate folder"),console.log("  vite-elysia-forge build-server --server .output --static dist");}export{f as build,P as buildCompile};
+console.log(\`Production server running at http://\${app?.server?.hostname}:\${app?.server?.port}\`);
+`;writeFileSync(i,p);try{if(t.outFile)await D(i,t.outFile,r,n);else {let u=t.outDir||"dist";await x(i,u,r,n);}}finally{existsSync(i)&&unlinkSync(i),existsSync(s)&&rmSync(s,{recursive:true,force:true});}}async function x(t,o,r,n){let e=resolve(process.cwd(),o);existsSync(e)||mkdirSync(e,{recursive:true}),console.log(`\u{1F4E6} Building server to "${o}/" (target: ${r})...`);try{let s=await Bun.build({entrypoints:[t],outdir:e,target:r,minify:n,naming:"server.js"});if(!s.success){console.error("\u274C Server build failed");for(let i of s.logs)console.error(i);process.exit(1);}console.log(`\u2705 Server built to "${o}/server.js"`),console.log(`
+\u{1F4A1} To run: bun ${o}/server.js`);}catch(s){console.error("\u274C Failed to build server. Ensure you are running this command with Bun."),console.error(s),process.exit(1);}}async function D(t,o,r,n){let e=resolve(process.cwd(),o),s=dirname(e);existsSync(s)||mkdirSync(s,{recursive:true});let i=resolve(process.cwd(),".vef-temp-bundle");existsSync(i)||mkdirSync(i,{recursive:true}),console.log(`\u{1F4E6} Building and compiling server to "${o}" (target: ${r})...`);try{let l=await Bun.build({entrypoints:[t],outdir:i,target:r,minify:n,naming:"server.js"});if(!l.success){console.error("\u274C Server build failed");for(let f of l.logs)console.error(f);process.exit(1);}let p=resolve(i,"server.js"),u=spawnSync("bun",["build","--compile",p,"--outfile",e],{stdio:"inherit",env:{...process.env,NODE_ENV:"production"}});u.status!==0&&(console.error("\u274C Bun compile failed"),process.exit(u.status||1)),console.log(`\u2705 Compiled standalone binary: ${o}`),console.log(`
+\u{1F4A1} To run: ./${o}`);}catch(l){console.error("\u274C Failed to compile server. Ensure you are running this command with Bun."),console.error(l),process.exit(1);}finally{existsSync(i)&&rmSync(i,{recursive:true,force:true});}}function O(t){let o={};for(let r=0;r<t.length;r++){let n=t[r],e=t[r+1];switch(n){case "--entry":case "-e":e&&!e.startsWith("-")&&(o.entry=e,r++);break;case "--outDir":case "-d":e&&!e.startsWith("-")&&(o.outDir=e,r++);break;case "--outFile":case "-o":e&&!e.startsWith("-")&&(o.outFile=e,r++);break;case "--target":case "-t":e&&!e.startsWith("-")&&(o.target=e,r++);break;case "--no-minify":o.minify=false;break}}return o}if(import.meta.main){let t=process.argv.slice(2),o=t[0],r=t.slice(1);if(o==="build"){let n=O(r);n.outDir&&n.outFile&&(console.error("\u274C Cannot use both --outDir and --outFile. Choose one."),process.exit(1)),w(n);}else console.log("Usage: vite-elysia-forge build [options]"),console.log(""),console.log("Build the Elysia server for production."),console.log(""),console.log("Options:"),console.log("  --entry, -e <path>    Path to API entry file (default: server/api.ts)"),console.log("  --outDir, -d <dir>    Output directory for bundled server.js"),console.log("  --outFile, -o <file>  Output path for compiled standalone binary"),console.log("  --target, -t <target> Build target: bun, node, browser (default: bun)"),console.log("  --no-minify           Disable minification"),console.log(""),console.log("Examples:"),console.log("  # Bundle server to dist/server.js"),console.log("  vite-elysia-forge build --outDir dist"),console.log(""),console.log("  # Bundle with node target"),console.log("  vite-elysia-forge build --outDir dist --target node"),console.log(""),console.log("  # Compile to standalone binary"),console.log("  vite-elysia-forge build --outFile server"),console.log(""),console.log("  # Compile with custom entry"),console.log("  vite-elysia-forge build --entry src/api/index.ts --outFile myserver");}export{w as build};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-elysia-forge",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "A Vite plugin to seamlessly integrate ElysiaJS for full-stack development with Bun runtime.",
   "type": "module",
   "main": "dist/index.cjs",