vite-elysia-forge 1.0.2 → 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)
 });
@@ -144,7 +144,7 @@ This ensures full Bun runtime support for WebSockets, even if Vite itself runs u
 
 ### 5.2 Production
 
-In production, the built server (`dist/server.js` or the compiled binary) runs your Elysia app directly with full WebSocket support—no proxy needed.
+In production, the built server (`build/server.js` or the compiled binary) runs your Elysia app directly with full WebSocket support—no proxy needed.
 
 ## 6. Integration with @elysiajs/openapi
 
@@ -176,139 +176,144 @@ const app = new Elysia().use(
 
 ## 7. Production Deployment
 
-The CLI provides several build commands to bundle your frontend and Elysia backend for production.
+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.
+
+### 7.1 Frontend Build
+
+Build your frontend using Vite directly:
 
 ```bash
-vite-elysia-forge build --api server/api.ts
+vite build
+```
+
+**Output:**
+
+```
+dist/
+├── index.html
+└── assets/
 ```
 
-### 7.1 Standard Build (`build`)
+Deploy to any static host (Cloudflare Pages, Netlify, Vercel, etc.)
 
-Builds the frontend with Vite and bundles the Elysia server into a single JavaScript file.
+### 7.2 Server Build (`--outDir`)
+
+Build the Elysia API server into a standalone JavaScript bundle.
 
 ```bash
-vite-elysia-forge build
+vite-elysia-forge build --outDir dist
 ```
 
 **What it does:**
 
-1. Runs `vite build` to compile your frontend to `dist/`
-2. Generates a production entry file that imports your API
-3. Bundles the server into `dist/server.js`
+1. Generates a production entry file that imports your API
+2. Bundles the server into `dist/server.js`
 
 **package.json:**
 
 ```json
 {
   "scripts": {
-    "build": "vite-elysia-forge build",
+    "build:server": "vite-elysia-forge build --outDir dist",
     "start": "bun dist/server.js"
   }
 }
 ```
 
-### 7.2 Compiled Binary (`build-compile`)
+**With custom entry and target:**
 
-Builds everything and compiles the server into a **standalone executable** (no Bun runtime required on the target machine).
+```bash
+vite-elysia-forge build --entry src/my-api.ts --outDir .output --target node
+```
+
+### 7.3 Compiled Binary (`--outFile`)
+
+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 standard build
-2. Compiles `dist/server.js` into a native binary at `dist/server`
+1. Bundles the server code
+2. Compiles into a native binary at the specified path
 
 **package.json:**
 
 ```json
 {
   "scripts": {
-    "build": "vite-elysia-forge build-compile",
+    "build:server": "vite-elysia-forge build --outFile dist/server",
     "start": "./dist/server"
   }
 }
 ```
 
-### 7.3 Separate Outputs (`--static` / `--server`)
+### 7.4 CLI Reference
 
-Build the frontend and backend to **separate directories** for independent deployment (e.g., static assets to a CDN, server to a VPS).
+**Command:**
 
 ```bash
-vite-elysia-forge build --static dist --server .output
-```
-
-**Output structure:**
-
-```
-project/
-├── dist/           # Static assets (deploy to CDN)
-│   ├── index.html
-│   └── assets/
-└── .output/        # Server bundle (deploy to server)
-    └── server.js
+vite-elysia-forge build [options]
 ```
 
-**Use cases:**
+**Options:**
 
-- Deploying static assets to Cloudflare Pages, Netlify, Vercel, etc.
-- Running the Elysia server on a separate VPS or Docker container
-- CI/CD pipelines that deploy frontend and backend independently
+| 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                       |
 
-**package.json:**
-
-```json
-{
-  "scripts": {
-    "build": "vite-elysia-forge build --static dist --server .output",
-    "start": "bun .output/server.js"
-  }
-}
-```
+> **Note:** `--outDir` and `--outFile` are mutually exclusive. Use `--outDir` for a bundled JS file, or `--outFile` for a compiled binary.
 
-Override the static assets path at runtime:
+**Examples:**
 
 ```bash
-STATIC_DIR=/path/to/static bun .output/server.js
-```
+# Bundle server to dist/server.js
+vite-elysia-forge build --outDir dist
 
-### 7.4 Frontend Only (`build-static`)
+# Bundle with node target
+vite-elysia-forge build --outDir dist --target node
 
-Build only the frontend, skipping the server bundle.
+# Compile to standalone binary
+vite-elysia-forge build --outFile server
 
-```bash
-vite-elysia-forge build-static
-```
+# Compile with custom entry
+vite-elysia-forge build --entry src/api/index.ts --outFile myserver
 
-Useful for rebuilding just the frontend without touching the server.
+# Bundle without minification
+vite-elysia-forge build --outDir dist --no-minify
+```
 
-### 7.5 Server Only (`build-server`)
+### 7.5 Deployment Architecture
 
-Build only the server bundle, skipping the Vite frontend build.
+**Separate deployment (recommended):**
 
-```bash
-vite-elysia-forge build-server --server .output --static dist
+```
+┌─────────────────┐         ┌──────────────────┐
+│  Static Host    │         │   API Server     │
+│  (CDN/Pages)    │◄────────┤   (VPS/Cloud)    │
+│                 │  CORS   │                  │
+│  dist/          │         │  dist/server.js  │
+└─────────────────┘         └──────────────────┘
 ```
 
-Useful when the frontend is already built or deployed separately.
-
-### 7.6 CLI Reference
+- 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
 
-| Option           | Short | Default             | Description                                 |
-| :--------------- | :---: | :------------------ | :------------------------------------------ |
-| `--api <path>`   | `-a`  | `src/server/api.ts` | Path to API entry file                      |
-| `--static <dir>` | `-s`  | `dist`              | Output directory for static frontend assets |
-| `--server <dir>` | `-o`  | Same as `--static`  | Output directory for server bundle          |
-| `--skip-vite`    |       | `false`             | Skip the Vite frontend build                |
-| `--skip-server`  |       | `false`             | Skip the server build                       |
+**API-only deployment:**
 
-**Example with custom API path:**
+If you have no frontend, just build and deploy the server:
 
 ```bash
-vite-elysia-forge build --api src/my-api.ts
+vite-elysia-forge build --outDir dist
+bun dist/server.js
 ```
 
 ## 8. Troubleshooting
@@ -349,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,13 +1,15 @@
 #!/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 v(r={}){let s=typeof r=="string"?{apiEntry:r}:r,t=s.apiEntry||"src/server/api.ts",e=s.staticDir||"dist",o=s.serverDir||e,u=s.skipVite||false,y=s.skipServer||false,b=e!==o,m=resolve(process.cwd(),t);if(!y&&!existsSync(m)&&(console.error(`\u274C API entry file "${t}" 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)),!u){console.log(`\u{1F4E6} Building frontend to "${e}"...`);let i=spawnSync("bun",["x","vite","build","--outDir",e],{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 "${e}"`);}if(y){console.log("\u23ED\uFE0F  Skipping server build (--skip-server)");return}let c=resolve(process.cwd(),".output");existsSync(c)||mkdirSync(c,{recursive:true});let d=resolve(c,".temp-prod.ts"),a=relative(c,m);a=a.split(sep).join("/"),a.startsWith(".")||(a="./"+a);let n;if(b){let i=resolve(process.cwd(),o),g=resolve(process.cwd(),e);n=relative(i,g),n.startsWith(".")||(n="./"+n),n=n.split(sep).join("/");}else n=".";let O=`
-import { startServer } from "vite-elysia-forge/production";
-import { api } from ${JSON.stringify(a)};
+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)};
 
-startServer({
-  api,
-  port: process.env.PORT ? parseInt(process.env.PORT) : 3000,
-  distDir: process.env.STATIC_DIR || ${JSON.stringify(n)},
-});
-`;writeFileSync(d,O);let h=resolve(process.cwd(),o);existsSync(h)||mkdirSync(h,{recursive:true}),console.log(`\u{1F4E6} Building server to "${o}"...`);try{let i=await Bun.build({entrypoints:[d],outdir:o,target:"bun",minify:!0,naming:"server.js"});if(!i.success){console.error("\u274C Server build failed");for(let g of i.logs)console.error(g);process.exit(1);}console.log(`\u2705 Server built to "${o}/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(d)&&unlinkSync(d),existsSync(c)&&rmSync(c,{recursive:true,force:true});}b&&(console.log(`
-\u{1F4C1} Output structure:`),console.log(`   Static assets: ${e}/`),console.log(`   Server bundle: ${o}/server.js`),console.log(`
-\u{1F4A1} To run: cd ${o} && bun server.js`),console.log("   Or set STATIC_DIR to override the static assets path"));}async function x(r={}){let s=typeof r=="string"?{apiEntry:r}:r,t=s.serverDir||s.staticDir||"dist";await v(s),console.log("\u{1F527} Compiling server to standalone binary...");let e=resolve(process.cwd(),t,"server.js"),o=resolve(process.cwd(),t,"server"),u=spawnSync("bun",["build","--compile",e,"--outfile",o],{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: ${t}/server`);}function f(r){let s={};for(let t=0;t<r.length;t++){let e=r[t],o=r[t+1];switch(e){case "--api":case "-a":o&&!o.startsWith("-")&&(s.apiEntry=o,t++);break;case "--static":case "-s":o&&!o.startsWith("-")&&(s.staticDir=o,t++);break;case "--server":case "-o":o&&!o.startsWith("-")&&(s.serverDir=o,t++);break;case "--skip-vite":s.skipVite=true;break;case "--skip-server":s.skipServer=true;break;default:e&&!e.startsWith("-")&&!s.apiEntry&&(s.apiEntry=e);}}return s}if(import.meta.main){let r=process.argv.slice(2),s=r[0],t=r.slice(1);if(s==="build"){let e=f(t);v(e);}else if(s==="build-compile"){let e=f(t);x(e);}else if(s==="build-static"){let e=f(t);e.skipServer=true,v(e);}else if(s==="build-server"){let e=f(t);e.skipVite=true,v(e);}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{v as build,x as buildCompile};
+const app = new Elysia();
+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://\${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.2",
+  "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",
@@ -36,10 +36,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
-    },
-    "./production": {
-      "types": "./dist/production.d.ts",
-      "import": "./dist/production.js"
     }
   },
   "files": [

package/dist/production.d.ts

@@ -1,43 +0,0 @@
-/**
- * Options for starting the production server.
- */
-interface ProductionOptions {
-    /**
-     * The port to listen on.
-     * @default 3000
-     */
-    port?: number;
-    /**
-     * The directory containing the built frontend assets.
-     * @default "dist"
-     */
-    distDir?: string;
-    /**
-     * The name of the HTML entry file.
-     * @default "index.html"
-     */
-    htmlFile?: string;
-    /**
-     * The prefix for API routes. Requests starting with this prefix will be handled by the Elysia app.
-     * @default "/api"
-     */
-    apiPrefix?: string;
-    /**
-     * The Elysia app instance or an object with a `handle` method.
-     */
-    api: {
-        handle: (request: Request) => Promise<Response>;
-    } | any;
-}
-/**
- * Starts a production server using Bun.serve.
- *
- * This function serves the static frontend assets from the distribution directory
- * and handles API requests using the provided Elysia app instance.
- *
- * @param options - Configuration options for the production server.
- * @throws {Error} If not running in a Bun environment.
- */
-declare const startServer: (options: ProductionOptions) => void;
-
-export { type ProductionOptions, startServer };