@t8/serve 0.1.18 → 0.1.20

package/README.md

@@ -32,7 +32,7 @@ npx @t8/serve 3000 app public dist -b src/index.ts
 /playground
   - index.css
   - index.html
-     + <script src="/dist/index.js"></script>
+    + <script src="/dist/index.js"></script>
   - index.ts
 ```
 
@@ -63,8 +63,8 @@ import { serve } from "@t8/serve";
 let server = await serve({
   port: 3000,
   path: "app",
+  bundle: true, // or `{ input, output }`, or `input` path
   spa: true,
-  bundle: true,
 });
 
 // Stop
@@ -78,7 +78,7 @@ server.close();
 /playground
   - index.css
   - index.html
-     + <script src="/dist/index.js"></script>
+    + <script src="/dist/index.js"></script>
   - index.ts
 ```
 
@@ -92,8 +92,8 @@ let server: Server;
 test.beforeAll(async () => {
   server = await serve({
     path: "playground",
+    bundle: "src/index.tsx",
     spa: true,
-    bundle: true,
   });
 });
 

package/dist/index.js

@@ -4,11 +4,9 @@ import { createServer } from "node:http";
 import { extname } from "node:path";
 
 // src/bundle.ts
-import { exec as originalExec } from "node:child_process";
 import { rm } from "node:fs/promises";
 import { join } from "node:path";
-import { promisify } from "node:util";
-var exec = promisify(originalExec);
+import { build } from "esbuild";
 async function bundle({ path = "", bundle: options } = {}) {
   if (!options) return;
   let normalizedOptions;
@@ -18,12 +16,17 @@ async function bundle({ path = "", bundle: options } = {}) {
       input: options
     };
   else normalizedOptions = options;
+  let dir = normalizedOptions.dir ?? "dist";
   let inputFile = join(path, normalizedOptions.input ?? "index.ts");
-  let outputFile = join(path, "dist", normalizedOptions.output ?? "index.js");
-  await rm(join(path, "dist"), { recursive: true, force: true });
-  await exec(
-    `npx esbuild ${inputFile} --outfile=${outputFile} --bundle --platform=browser --log-level=warning`
-  );
+  let outputFile = join(path, dir, normalizedOptions.output ?? "index.js");
+  await rm(join(path, dir), { recursive: true, force: true });
+  await build({
+    entryPoints: [inputFile],
+    outfile: outputFile,
+    bundle: true,
+    platform: "browser",
+    logLevel: "warning"
+  });
 }
 
 // src/getFilePath.ts

package/dist/run.cjs

@@ -7,11 +7,9 @@ var import_node_http = require("node:http");
 var import_node_path3 = require("node:path");
 
 // src/bundle.ts
-var import_node_child_process = require("node:child_process");
 var import_promises = require("node:fs/promises");
 var import_node_path = require("node:path");
-var import_node_util = require("node:util");
-var exec = (0, import_node_util.promisify)(import_node_child_process.exec);
+var import_esbuild = require("esbuild");
 async function bundle({ path = "", bundle: options } = {}) {
   if (!options) return;
   let normalizedOptions;
@@ -21,12 +19,17 @@ async function bundle({ path = "", bundle: options } = {}) {
       input: options
     };
   else normalizedOptions = options;
+  let dir = normalizedOptions.dir ?? "dist";
   let inputFile = (0, import_node_path.join)(path, normalizedOptions.input ?? "index.ts");
-  let outputFile = (0, import_node_path.join)(path, "dist", normalizedOptions.output ?? "index.js");
-  await (0, import_promises.rm)((0, import_node_path.join)(path, "dist"), { recursive: true, force: true });
-  await exec(
-    `npx esbuild ${inputFile} --outfile=${outputFile} --bundle --platform=browser --log-level=warning`
-  );
+  let outputFile = (0, import_node_path.join)(path, dir, normalizedOptions.output ?? "index.js");
+  await (0, import_promises.rm)((0, import_node_path.join)(path, dir), { recursive: true, force: true });
+  await (0, import_esbuild.build)({
+    entryPoints: [inputFile],
+    outfile: outputFile,
+    bundle: true,
+    platform: "browser",
+    logLevel: "warning"
+  });
 }
 
 // src/getFilePath.ts

package/dist/run.mjs

@@ -6,11 +6,9 @@ import { createServer } from "node:http";
 import { extname } from "node:path";
 
 // src/bundle.ts
-import { exec as originalExec } from "node:child_process";
 import { rm } from "node:fs/promises";
 import { join } from "node:path";
-import { promisify } from "node:util";
-var exec = promisify(originalExec);
+import { build } from "esbuild";
 async function bundle({ path = "", bundle: options } = {}) {
   if (!options) return;
   let normalizedOptions;
@@ -20,12 +18,17 @@ async function bundle({ path = "", bundle: options } = {}) {
       input: options
     };
   else normalizedOptions = options;
+  let dir = normalizedOptions.dir ?? "dist";
   let inputFile = join(path, normalizedOptions.input ?? "index.ts");
-  let outputFile = join(path, "dist", normalizedOptions.output ?? "index.js");
-  await rm(join(path, "dist"), { recursive: true, force: true });
-  await exec(
-    `npx esbuild ${inputFile} --outfile=${outputFile} --bundle --platform=browser --log-level=warning`
-  );
+  let outputFile = join(path, dir, normalizedOptions.output ?? "index.js");
+  await rm(join(path, dir), { recursive: true, force: true });
+  await build({
+    entryPoints: [inputFile],
+    outfile: outputFile,
+    bundle: true,
+    platform: "browser",
+    logLevel: "warning"
+  });
 }
 
 // src/getFilePath.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t8/serve",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "",
   "keywords": [
     "node",
@@ -21,9 +21,9 @@
   "scripts": {
     "build": "npx npm-run-all clean -p compile compile-mjs-bin compile-cjs-bin",
     "clean": "node -e \"require('node:fs').rmSync('dist', {force: true, recursive: true});\"",
-    "compile": "npx esbuild index.ts --bundle --outdir=dist --platform=node --format=esm",
-    "compile-mjs-bin": "npx esbuild src/run.ts --bundle --outfile=dist/run.mjs --platform=node --format=esm",
-    "compile-cjs-bin": "npx esbuild src/run.ts --bundle --outfile=dist/run.cjs --platform=node --format=cjs",
+    "compile": "npx esbuild index.ts --bundle --outdir=dist --platform=node --format=esm --external:esbuild",
+    "compile-mjs-bin": "npx esbuild src/run.ts --bundle --outfile=dist/run.mjs --platform=node --format=esm --external:esbuild",
+    "compile-cjs-bin": "npx esbuild src/run.ts --bundle --outfile=dist/run.cjs --platform=node --format=cjs --external:esbuild",
     "prepublishOnly": "npm run build",
     "preversion": "npx npm-run-all typecheck shape build",
     "shape": "npx codeshape",
@@ -32,5 +32,8 @@
   "devDependencies": {
     "@types/node": "^24.5.2",
     "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "esbuild": "^0.25.10"
   }
 }

package/src/BundleConfig.ts

@@ -1,4 +1,20 @@
 export type BundleConfig = {
+  /**
+   * Output directory path relative to the server config `path`.
+   *
+   * @defaultValue "dist"
+   */
+  dir?: string;
+  /**
+   * Input path relative to the server config `path`.
+   *
+   * @defaultValue "index.ts"
+   */
   input?: string;
+  /**
+   * Output path relative to the bundle config `dir`.
+   *
+   * @defaultValue "index.js"
+   */
   output?: string;
 };

package/src/Config.ts

@@ -1,12 +1,41 @@
 import type { BundleConfig } from "./BundleConfig";
 
 export type Config = {
+  /** Server URL. */
   url?: string;
+  /**
+   * Server host.
+   *
+   * @defaultValue "localhost"
+   */
   host?: string;
+  /**
+   * Server port.
+   *
+   * @defaultValue 3000
+   */
   port?: number;
+  /** Application path. */
   path?: string;
+  /**
+   * Public assets directories. If not provided, the application
+   * `path` is served as a public assets directory.
+   */
   dirs?: string[];
+  /**
+   * Enables single-page application (SPA) mode. If `true`, all
+   * unmatched URLs are served as "/".
+   */
   spa?: boolean;
+  /** Whether to log to the console. */
   log?: boolean;
-  bundle?: boolean | string | BundleConfig;
+  /**
+   * Bundle config.
+   *
+   * If `undefined`, bundling is skipped.
+   * Otherwise, its type is `BundleConfig`, with the following shorthand options:
+   * If `true`, it's equivalent to `{ input: "index.ts", output: "index.js" }`.
+   * If `string`, it's equivalent to `input` in `{ input, ouput: "index.js" }`.
+   */
+  bundle?: boolean | string | BundleConfig | undefined;
 };

package/src/bundle.ts

@@ -1,12 +1,9 @@
-import { exec as originalExec } from "node:child_process";
 import { rm } from "node:fs/promises";
 import { join } from "node:path";
-import { promisify } from "node:util";
+import { build } from "esbuild";
 import type { BundleConfig } from "./BundleConfig";
 import type { Config } from "./Config";
 
-const exec = promisify(originalExec);
-
 export async function bundle({ path = "", bundle: options }: Config = {}) {
   if (!options) return;
 
@@ -19,11 +16,17 @@ export async function bundle({ path = "", bundle: options }: Config = {}) {
     };
   else normalizedOptions = options;
 
+  let dir = normalizedOptions.dir ?? "dist";
   let inputFile = join(path, normalizedOptions.input ?? "index.ts");
-  let outputFile = join(path, "dist", normalizedOptions.output ?? "index.js");
+  let outputFile = join(path, dir, normalizedOptions.output ?? "index.js");
+
+  await rm(join(path, dir), { recursive: true, force: true });
 
-  await rm(join(path, "dist"), { recursive: true, force: true });
-  await exec(
-    `npx esbuild ${inputFile} --outfile=${outputFile} --bundle --platform=browser --log-level=warning`,
-  );
+  await build({
+    entryPoints: [inputFile],
+    outfile: outputFile,
+    bundle: true,
+    platform: "browser",
+    logLevel: "warning",
+  });
 }