@t8/serve 0.1.35 → 0.1.37

package/README.md

@@ -1,4 +1,4 @@
-# @t8/serve
+# T8 Serve
 
 Simple static file server + bundler, primarily for demo apps and tests, manual or automated
 

package/dist/index.d.ts

@@ -1,3 +1,71 @@
-export * from "./src/BundleConfig.ts";
-export * from "./src/Config.ts";
-export * from "./src/serve.ts";
+import type { IncomingMessage, ServerResponse, createServer } from "node:http";
+
+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;
+};
+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>;
+};
+export type Server = ReturnType<typeof createServer>;
+export declare function serve(config?: Config): Promise<Server>;
+
+export {};

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@t8/serve",
-  "version": "0.1.35",
+  "version": "0.1.37",
   "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"
+    "serve": "dist/run.js"
   },
   "repository": {
     "type": "git",
@@ -20,22 +21,16 @@
   "main": "dist/index.js",
   "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.js --platform=node --format=esm --external:esbuild",
+    "preversion": "npx npm-run-all clean shape -p compile compile-bin",
+    "shape": "npx codeshape --typecheck --emit-types"
   },
   "devDependencies": {
-    "@types/node": "^24.5.2",
-    "typescript": "^5.9.2"
+    "@types/node": "^24.5.2"
   },
   "dependencies": {
-    "esbuild": "^0.25.11"
+    "esbuild": "^0.27.1"
   }
 }

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>;