@t8/serve 0.1.26 → 0.1.28

package/README.md

@@ -111,6 +111,13 @@ let server = await serve({
   path: "app",
   bundle: true, // or input path, or `{ input, output, dir }`
   spa: true,
+  // Optional custom request handler (e.g. for simple APIs or API mocks)
+  onRequest(req, res) {
+    if (req.url === "/items") {
+      res.writeHead(200, { "content-type": "application/json" });
+      res.end(JSON.stringify(["apple", "lemon", "cherry"]));
+    }
+  },
 });
 
 // Stop
@@ -170,7 +177,7 @@ test.afterAll(() => {
 ```ts
 // tests/x/index.test.ts
 import { test } from "@playwright/test";
-import { serve, type Server } from "@t8/serve";
+import { type Server, serve } from "@t8/serve";
 
 let server: Server;
 

package/dist/index.js

@@ -94,6 +94,8 @@ async function serve(config = {}) {
   await bundle(config);
   return new Promise((resolve) => {
     let server = 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" });

package/dist/run.cjs

@@ -97,6 +97,8 @@ async function serve(config = {}) {
   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" });

package/dist/run.mjs

@@ -96,6 +96,8 @@ async function serve(config = {}) {
   await bundle(config);
   return new Promise((resolve) => {
     let server = 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" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t8/serve",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "description": "Simple static file server + bundler, primarily for demo apps and tests, manual or automated",
   "keywords": [
     "node",

package/src/Config.ts

@@ -1,3 +1,4 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
 import type { BundleConfig } from "./BundleConfig";
 
 export type Config = {
@@ -38,4 +39,9 @@ export type Config = {
    * 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/src/serve.ts

@@ -14,6 +14,10 @@ export async function serve(config: Config = {}): Promise<Server> {
 
   return new Promise((resolve) => {
     let server = createServer(async (req, res) => {
+      await config.onRequest?.(req, res);
+
+      if (res.headersSent) return;
+
       let filePath = await getFilePath(req.url, config);
 
       if (filePath === undefined) {