@t8/serve 0.1.36 → 0.1.38

package/dist/index.cjs

@@ -0,0 +1,120 @@
+let node_fs = require("node:fs");
+let node_http = require("node:http");
+let node_path = require("node:path");
+let node_fs_promises = require("node:fs/promises");
+let esbuild = require("esbuild");
+
+async function bundle({ path = "", bundle: options, watch, minify } = {}) {
+  if (!options) return;
+  let normalizedOptions;
+  if (typeof options === "boolean") normalizedOptions = {};
+  else if (typeof options === "string") normalizedOptions = { input: options };
+  else normalizedOptions = options;
+  let dir = normalizedOptions.dir ?? "dist";
+  let inputFile = (0, node_path.join)(path, normalizedOptions.input ?? "index.ts");
+  await (0, node_fs_promises.rm)((0, node_path.join)(path, dir), {
+    recursive: true,
+    force: true
+  });
+  let buildOptions = {
+    entryPoints: [inputFile],
+    bundle: true,
+    format: "esm",
+    platform: "browser",
+    logLevel: "warning",
+    minify
+  };
+  if (normalizedOptions.output) buildOptions.outfile = (0, node_path.join)(path, dir, normalizedOptions.output);
+  else {
+    buildOptions.outdir = (0, node_path.join)(path, dir);
+    buildOptions.splitting = true;
+  }
+  if (watch) {
+    let ctx = await (0, esbuild.context)(buildOptions);
+    await ctx.watch();
+    return async () => {
+      await ctx.dispose();
+    };
+  }
+  await (0, esbuild.build)(buildOptions);
+}
+
+async function isValidFilePath(filePath, dirPath) {
+  if (!filePath.startsWith(dirPath)) return false;
+  try {
+    await (0, node_fs_promises.access)(filePath);
+    return !(await (0, node_fs_promises.lstat)(filePath)).isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+const cwd = process.cwd();
+async function getFilePath(url = "", { path = "", dirs = [], spa }) {
+  let urlPath = url.replace(/[?#].*$/, "");
+  for (let dir of dirs.length === 0 ? [""] : dirs) {
+    let dirPath = (0, node_path.join)(cwd, path, dir);
+    let filePath = (0, node_path.join)(dirPath, urlPath);
+    if (!urlPath.endsWith("/") && await isValidFilePath(filePath, dirPath)) return filePath;
+    filePath = (0, node_path.join)(dirPath, spa ? "" : urlPath, "index.html");
+    if (await isValidFilePath(filePath, dirPath)) return filePath;
+  }
+}
+
+const defaultHost = "localhost";
+const defaultPort = 3e3;
+function getTarget(config = {}) {
+  let { host, port, url } = config;
+  let [, , urlHost, , urlPort] = url?.match(/^(https?:\/\/)?([^:/]+)(:(\d+))?\/?/) ?? [];
+  if (!urlPort && /^\d+$/.test(urlHost)) {
+    urlPort = urlHost;
+    urlHost = "";
+  }
+  return {
+    port: port || Number(urlPort) || defaultPort,
+    host: host || urlHost || defaultHost
+  };
+}
+
+const mimeTypes = {
+  html: "text/html; charset=utf-8",
+  js: "text/javascript",
+  json: "application/json",
+  css: "text/css",
+  svg: "image/svg+xml",
+  png: "image/png",
+  jpg: "image/jpeg",
+  gif: "image/gif",
+  ico: "image/x-icon",
+  txt: "text/plain",
+  md: "text/markdown"
+};
+
+async function serve(config = {}) {
+  let stop = await bundle(config);
+  return new Promise((resolve) => {
+    let server = (0, node_http.createServer)(async (req, res) => {
+      await config.onRequest?.(req, res);
+      if (res.headersSent) return;
+      let filePath = await getFilePath(req.url, config);
+      if (filePath === void 0) {
+        res.writeHead(404, { "content-type": "text/plain" });
+        res.end("Not found");
+        return;
+      }
+      let mimeType = mimeTypes[(0, node_path.extname)(filePath).slice(1).toLowerCase()] ?? "application/octet-stream";
+      res.writeHead(200, { "content-type": mimeType });
+      (0, node_fs.createReadStream)(filePath).pipe(res);
+    });
+    if (stop) server.on("close", async () => {
+      await stop();
+    });
+    let { host, port } = getTarget(config);
+    server.listen(port, host, () => {
+      if (config.log) console.log(`Server running at http://${host}:${port}`);
+      resolve(server);
+    });
+  });
+}
+
+exports.serve = serve;

package/dist/index.d.ts

@@ -1,3 +1,73 @@
-export * from "./src/BundleConfig.ts";
-export * from "./src/Config.ts";
-export * from "./src/serve.ts";
+import { IncomingMessage, ServerResponse, createServer } from "node:http";
+
+type BundleConfig = {
+  /**
+   * Output directory path relative to the server config `path`.
+   *
+   * @defaultValue "dist"
+   */
+  dir?: string | undefined;
+  /**
+   * Input path relative to the server config `path`.
+   *
+   * @defaultValue "index.ts"
+   */
+  input?: string | undefined;
+  /**
+   * Output path relative to the bundle config `dir`.
+   *
+   * @defaultValue "index.js"
+   */
+  output?: string | undefined;
+};
+
+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 rebuild whenever the bundled files change. */
+  watch?: boolean;
+  /** Whether the bundle should be minified. */
+  minify?: boolean;
+  /** Whether to log to the console. */
+  log?: boolean;
+  /**
+   * 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;
+  /** Custom request handler. */
+  onRequest?: (req?: IncomingMessage, res?: ServerResponse<IncomingMessage>) => void | Promise<void>;
+};
+
+type Server = ReturnType<typeof createServer>;
+declare function serve(config?: Config): Promise<Server>;
+
+export { BundleConfig, Config, Server, serve };

package/dist/{index.js → index.mjs}

@@ -1,29 +1,21 @@
-// src/serve.ts
 import { createReadStream } from "node:fs";
 import { createServer } from "node:http";
-import { extname } from "node:path";
-
-// src/bundle.ts
-import { rm } from "node:fs/promises";
-import { join } from "node:path";
+import { extname, join } from "node:path";
+import { access, lstat, rm } from "node:fs/promises";
 import { build, context } from "esbuild";
-async function bundle({
-  path = "",
-  bundle: options,
-  watch,
-  minify
-} = {}) {
+
+async function bundle({ path = "", bundle: options, watch, minify } = {}) {
   if (!options) return;
   let normalizedOptions;
   if (typeof options === "boolean") normalizedOptions = {};
-  else if (typeof options === "string")
-    normalizedOptions = {
-      input: options
-    };
+  else if (typeof options === "string") normalizedOptions = { input: options };
   else normalizedOptions = options;
   let dir = normalizedOptions.dir ?? "dist";
   let inputFile = join(path, normalizedOptions.input ?? "index.ts");
-  await rm(join(path, dir), { recursive: true, force: true });
+  await rm(join(path, dir), {
+    recursive: true,
+    force: true
+  });
   let buildOptions = {
     entryPoints: [inputFile],
     bundle: true,
@@ -32,8 +24,7 @@ async function bundle({
     logLevel: "warning",
     minify
   };
-  if (normalizedOptions.output)
-    buildOptions.outfile = join(path, dir, normalizedOptions.output);
+  if (normalizedOptions.output) buildOptions.outfile = join(path, dir, normalizedOptions.output);
   else {
     buildOptions.outdir = join(path, dir);
     buildOptions.splitting = true;
@@ -48,11 +39,6 @@ async function bundle({
   await build(buildOptions);
 }
 
-// src/getFilePath.ts
-import { join as join2 } from "node:path";
-
-// src/isValidFilePath.ts
-import { access, lstat } from "node:fs/promises";
 async function isValidFilePath(filePath, dirPath) {
   if (!filePath.startsWith(dirPath)) return false;
   try {
@@ -63,23 +49,20 @@ async function isValidFilePath(filePath, dirPath) {
   }
 }
 
-// src/getFilePath.ts
-var cwd = process.cwd();
+const cwd = process.cwd();
 async function getFilePath(url = "", { path = "", dirs = [], spa }) {
   let urlPath = url.replace(/[?#].*$/, "");
   for (let dir of dirs.length === 0 ? [""] : dirs) {
-    let dirPath = join2(cwd, path, dir);
-    let filePath = join2(dirPath, urlPath);
-    if (!urlPath.endsWith("/") && await isValidFilePath(filePath, dirPath))
-      return filePath;
-    filePath = join2(dirPath, spa ? "" : urlPath, "index.html");
+    let dirPath = join(cwd, path, dir);
+    let filePath = join(dirPath, urlPath);
+    if (!urlPath.endsWith("/") && await isValidFilePath(filePath, dirPath)) return filePath;
+    filePath = join(dirPath, spa ? "" : urlPath, "index.html");
     if (await isValidFilePath(filePath, dirPath)) return filePath;
   }
 }
 
-// src/getTarget.ts
-var defaultHost = "localhost";
-var defaultPort = 3e3;
+const defaultHost = "localhost";
+const defaultPort = 3e3;
 function getTarget(config = {}) {
   let { host, port, url } = config;
   let [, , urlHost, , urlPort] = url?.match(/^(https?:\/\/)?([^:/]+)(:(\d+))?\/?/) ?? [];
@@ -93,8 +76,7 @@ function getTarget(config = {}) {
   };
 }
 
-// src/mimeTypes.ts
-var mimeTypes = {
+const mimeTypes = {
   html: "text/html; charset=utf-8",
   js: "text/javascript",
   json: "application/json",
@@ -108,7 +90,6 @@ var mimeTypes = {
   md: "text/markdown"
 };
 
-// src/serve.ts
 async function serve(config = {}) {
   let stop = await bundle(config);
   return new Promise((resolve) => {
@@ -121,16 +102,13 @@ async function serve(config = {}) {
         res.end("Not found");
         return;
       }
-      let ext = extname(filePath).slice(1).toLowerCase();
-      let mimeType = mimeTypes[ext] ?? "application/octet-stream";
+      let mimeType = mimeTypes[extname(filePath).slice(1).toLowerCase()] ?? "application/octet-stream";
       res.writeHead(200, { "content-type": mimeType });
       createReadStream(filePath).pipe(res);
     });
-    if (stop) {
-      server.on("close", async () => {
-        await stop();
-      });
-    }
+    if (stop) server.on("close", async () => {
+      await stop();
+    });
     let { host, port } = getTarget(config);
     server.listen(port, host, () => {
       if (config.log) console.log(`Server running at http://${host}:${port}`);
@@ -138,6 +116,5 @@ async function serve(config = {}) {
     });
   });
 }
-export {
-  serve
-};
+
+export { serve };

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@t8/serve",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "Simple static file server + bundler, primarily for demo apps and tests, manual or automated",
   "keywords": [
     "node",
     "server",
-    "static"
+    "static server",
+    "bundler"
   ],
   "bin": {
     "serve": "dist/run.mjs"
@@ -17,25 +18,18 @@
   "license": "MIT",
   "author": "axtk",
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "npx npm-run-all clean -p compile compile-mjs-bin compile-cjs-bin -s types",
-    "clean": "node -e \"require('node:fs').rmSync('dist', { force: true, recursive: true });\"",
-    "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",
-    "typecheck": "tsc --noEmit",
-    "types": "tsc --emitDeclarationOnly"
+    "compile-bin": "npx esbuild src/run.ts --bundle --outfile=dist/run.mjs --platform=node --format=esm --external:esbuild",
+    "preversion": "npx npm-run-all shape compile-bin",
+    "shape": "npx codeshape"
   },
   "devDependencies": {
-    "@types/node": "^24.5.2",
-    "typescript": "^5.9.2"
+    "@types/node": "^24.5.2"
   },
   "dependencies": {
-    "esbuild": "^0.27.0"
+    "esbuild": "^0.27.1"
   }
 }

package/tsconfig.json

@@ -1,5 +1,5 @@
 {
-  "include": ["index.ts", "src"],
+  "include": ["./index.ts", "./src"],
   "compilerOptions": {
     "declaration": true,
     "emitDeclarationOnly": true,

package/dist/run.cjs

@@ -1,190 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-
-// src/serve.ts
-var import_node_fs = require("node:fs");
-var import_node_http = require("node:http");
-var import_node_path3 = require("node:path");
-
-// src/bundle.ts
-var import_promises = require("node:fs/promises");
-var import_node_path = require("node:path");
-var import_esbuild = require("esbuild");
-async function bundle({
-  path = "",
-  bundle: options,
-  watch,
-  minify
-} = {}) {
-  if (!options) return;
-  let normalizedOptions;
-  if (typeof options === "boolean") normalizedOptions = {};
-  else if (typeof options === "string")
-    normalizedOptions = {
-      input: options
-    };
-  else normalizedOptions = options;
-  let dir = normalizedOptions.dir ?? "dist";
-  let inputFile = (0, import_node_path.join)(path, normalizedOptions.input ?? "index.ts");
-  await (0, import_promises.rm)((0, import_node_path.join)(path, dir), { recursive: true, force: true });
-  let buildOptions = {
-    entryPoints: [inputFile],
-    bundle: true,
-    format: "esm",
-    platform: "browser",
-    logLevel: "warning",
-    minify
-  };
-  if (normalizedOptions.output)
-    buildOptions.outfile = (0, import_node_path.join)(path, dir, normalizedOptions.output);
-  else {
-    buildOptions.outdir = (0, import_node_path.join)(path, dir);
-    buildOptions.splitting = true;
-  }
-  if (watch) {
-    let ctx = await (0, import_esbuild.context)(buildOptions);
-    await ctx.watch();
-    return async () => {
-      await ctx.dispose();
-    };
-  }
-  await (0, import_esbuild.build)(buildOptions);
-}
-
-// src/getFilePath.ts
-var import_node_path2 = require("node:path");
-
-// src/isValidFilePath.ts
-var import_promises2 = require("node:fs/promises");
-async function isValidFilePath(filePath, dirPath) {
-  if (!filePath.startsWith(dirPath)) return false;
-  try {
-    await (0, import_promises2.access)(filePath);
-    return !(await (0, import_promises2.lstat)(filePath)).isDirectory();
-  } catch {
-    return false;
-  }
-}
-
-// src/getFilePath.ts
-var cwd = process.cwd();
-async function getFilePath(url = "", { path = "", dirs = [], spa }) {
-  let urlPath = url.replace(/[?#].*$/, "");
-  for (let dir of dirs.length === 0 ? [""] : dirs) {
-    let dirPath = (0, import_node_path2.join)(cwd, path, dir);
-    let filePath = (0, import_node_path2.join)(dirPath, urlPath);
-    if (!urlPath.endsWith("/") && await isValidFilePath(filePath, dirPath))
-      return filePath;
-    filePath = (0, import_node_path2.join)(dirPath, spa ? "" : urlPath, "index.html");
-    if (await isValidFilePath(filePath, dirPath)) return filePath;
-  }
-}
-
-// src/getTarget.ts
-var defaultHost = "localhost";
-var defaultPort = 3e3;
-function getTarget(config = {}) {
-  let { host, port, url } = config;
-  let [, , urlHost, , urlPort] = url?.match(/^(https?:\/\/)?([^:/]+)(:(\d+))?\/?/) ?? [];
-  if (!urlPort && /^\d+$/.test(urlHost)) {
-    urlPort = urlHost;
-    urlHost = "";
-  }
-  return {
-    port: port || Number(urlPort) || defaultPort,
-    host: host || urlHost || defaultHost
-  };
-}
-
-// src/mimeTypes.ts
-var mimeTypes = {
-  html: "text/html; charset=utf-8",
-  js: "text/javascript",
-  json: "application/json",
-  css: "text/css",
-  svg: "image/svg+xml",
-  png: "image/png",
-  jpg: "image/jpeg",
-  gif: "image/gif",
-  ico: "image/x-icon",
-  txt: "text/plain",
-  md: "text/markdown"
-};
-
-// src/serve.ts
-async function serve(config = {}) {
-  let stop = await bundle(config);
-  return new Promise((resolve) => {
-    let server = (0, import_node_http.createServer)(async (req, res) => {
-      await config.onRequest?.(req, res);
-      if (res.headersSent) return;
-      let filePath = await getFilePath(req.url, config);
-      if (filePath === void 0) {
-        res.writeHead(404, { "content-type": "text/plain" });
-        res.end("Not found");
-        return;
-      }
-      let ext = (0, import_node_path3.extname)(filePath).slice(1).toLowerCase();
-      let mimeType = mimeTypes[ext] ?? "application/octet-stream";
-      res.writeHead(200, { "content-type": mimeType });
-      (0, import_node_fs.createReadStream)(filePath).pipe(res);
-    });
-    if (stop) {
-      server.on("close", async () => {
-        await stop();
-      });
-    }
-    let { host, port } = getTarget(config);
-    server.listen(port, host, () => {
-      if (config.log) console.log(`Server running at http://${host}:${port}`);
-      resolve(server);
-    });
-  });
-}
-
-// src/run.ts
-async function run() {
-  let [url, ...args] = process.argv.slice(2);
-  let spa = false;
-  let watch = false;
-  let minify = false;
-  if (args[0] === "*") {
-    spa = true;
-    args.shift();
-  }
-  while (args.at(-1)?.startsWith("--")) {
-    let arg = args.pop();
-    switch (arg) {
-      case "--watch":
-        watch = true;
-        break;
-      case "--minify":
-        minify = true;
-        break;
-    }
-  }
-  let bundleFlagIndex = args.indexOf("-b");
-  let path = args[0];
-  let dirs;
-  let bundle2;
-  if (bundleFlagIndex === -1) dirs = args.slice(1);
-  else {
-    dirs = args.slice(1, bundleFlagIndex);
-    bundle2 = {
-      input: args[bundleFlagIndex + 1] || void 0,
-      output: args[bundleFlagIndex + 2] || void 0,
-      dir: args[bundleFlagIndex + 3] || void 0
-    };
-  }
-  await serve({
-    url,
-    path,
-    dirs,
-    spa,
-    bundle: bundle2,
-    log: true,
-    watch,
-    minify
-  });
-}
-run();

package/dist/src/BundleConfig.d.ts

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

package/dist/src/Config.d.ts

@@ -1,47 +0,0 @@
-import type { IncomingMessage, ServerResponse } from "node:http";
-import type { BundleConfig } from "./BundleConfig.ts";
-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 rebuild whenever the bundled files change. */
-    watch?: boolean;
-    /** Whether the bundle should be minified. */
-    minify?: boolean;
-    /** Whether to log to the console. */
-    log?: boolean;
-    /**
-     * 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;
-    /** Custom request handler. */
-    onRequest?: (req?: IncomingMessage, res?: ServerResponse<IncomingMessage>) => void | Promise<void>;
-};

package/dist/src/bundle.d.ts

@@ -1,2 +0,0 @@
-import type { Config } from "./Config.ts";
-export declare function bundle({ path, bundle: options, watch, minify, }?: Config): Promise<(() => Promise<void>) | undefined>;

package/dist/src/getFilePath.d.ts

@@ -1,2 +0,0 @@
-import type { Config } from "./Config.ts";
-export declare function getFilePath(url: string | undefined, { path, dirs, spa }: Config): Promise<string | undefined>;

package/dist/src/getTarget.d.ts

@@ -1,5 +0,0 @@
-import type { Config } from "./Config.ts";
-export declare function getTarget(config?: Config): {
-    port: number;
-    host: string;
-};

package/dist/src/isValidFilePath.d.ts

@@ -1 +0,0 @@
-export declare function isValidFilePath(filePath: string, dirPath: string): Promise<boolean>;

package/dist/src/mimeTypes.d.ts

@@ -1 +0,0 @@
-export declare const mimeTypes: Record<string, string>;

package/dist/src/run.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/src/serve.d.ts

@@ -1,4 +0,0 @@
-import { createServer } from "node:http";
-import type { Config } from "./Config.ts";
-export type Server = ReturnType<typeof createServer>;
-export declare function serve(config?: Config): Promise<Server>;