@sourceregistry/node-webserver 1.0.0

package/dist/types/server.d.ts

@@ -0,0 +1,84 @@
+import { ServerOptions } from 'http';
+import { ServerOptions as HttpsServerOptions } from 'https';
+import { RequestMethod, RequestEvent, Router } from './';
+import { ListenOptions } from 'net';
+type HostMatcher = string | RegExp | ((host: string) => boolean);
+export type SecurityConfig = {
+    /**
+     * Trust the incoming Host header when constructing event.url/request.url.
+     * Disabled by default to avoid host header poisoning in absolute URL generation.
+     */
+    trustHostHeader?: boolean;
+    /**
+     * Restrict trusted Host values when trustHostHeader is enabled.
+     */
+    allowedHosts?: HostMatcher | HostMatcher[];
+    /**
+     * Restrict accepted WebSocket Origin values.
+     * When omitted, Origin is not enforced by default.
+     */
+    allowedWebSocketOrigins?: HostMatcher | HostMatcher[];
+    /**
+     * Maximum accepted request body size based on Content-Length.
+     * Requests above the limit are rejected before the body is read.
+     */
+    maxRequestBodySize?: number;
+    /**
+     * Maximum accepted WebSocket message size in bytes.
+     * Passed to ws as maxPayload.
+     */
+    maxWebSocketPayload?: number;
+};
+export type HttpServerConfig = {
+    type: 'http';
+    options?: ServerOptions;
+    security?: SecurityConfig;
+};
+export type HttpsServerConfig = {
+    type: 'https';
+    options: HttpsServerOptions;
+    security?: SecurityConfig;
+};
+export type ServerConfig = {
+    locals?: (event: RequestEvent) => App.Locals | Record<string, any>;
+    platform?: (event: RequestEvent) => App.Platform | Record<string, any>;
+} & (HttpServerConfig | HttpsServerConfig);
+export declare class WebServer<TServerConfig extends ServerConfig = ServerConfig> {
+    private _server;
+    private readonly config;
+    readonly router: Router;
+    private upgradeHandlerInstalled;
+    private readonly wss;
+    constructor(config?: TServerConfig);
+    private get server();
+    discard(path_or_prefix: string, method?: RequestMethod): this;
+    listen(port?: number, hostname?: string, backlog?: number, listeningListener?: () => void): this;
+    listen(port?: number, hostname?: string, listeningListener?: () => void): this;
+    listen(port?: number, backlog?: number, listeningListener?: () => void): this;
+    listen(port?: number, listeningListener?: () => void): this;
+    listen(path: string, backlog?: number, listeningListener?: () => void): this;
+    listen(path: string, listeningListener?: () => void): this;
+    listen(options: ListenOptions, listeningListener?: () => void): this;
+    listen(handle: any, backlog?: number, listeningListener?: () => void): this;
+    listen(handle: any, listeningListener?: () => void): this;
+    private installUpgradeHandler;
+    close(callback?: (err?: Error) => void): void;
+    address(): string | import('net').AddressInfo | null;
+    get listening(): boolean;
+    private handleRequest;
+    private toWebRequest;
+    private toRequest;
+    private wrapRequestBody;
+    private toURL;
+    private resolveAuthority;
+    private normalizeTrustedHost;
+    private matchesValue;
+    private toHeaders;
+    private isRequestBodyAllowed;
+    private handleError;
+    private sendWebResponse;
+    private shouldOmitResponseBody;
+    private isAllowedWebSocketOrigin;
+    private toRequestEvent;
+}
+export {};

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function isHttpError(err: unknown): err is Response;
+export declare function isRedirect(err: unknown): err is Response;

package/examples/simple.ts

@@ -0,0 +1,11 @@
+import {WebServer} from "../src";
+
+const server = new WebServer();
+
+server.router.pre(({request}) => console.log(`[${request.method}] ${request.url}`));
+
+server.router.GET('/', () => new Response('Hello world!'))
+
+server.listen(3000, () => {
+    console.log("Server listening on port 3000");
+})

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@sourceregistry/node-webserver",
+  "version": "1.0.0",
+  "description": "TypeScript web server for Node.js with web-standard Request and Response APIs",
+  "type": "module",
+  "main": "./dist/index.cjs.js",
+  "module": "./dist/index.es.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.cjs.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc && vite build",
+    "test": "vitest run",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "docs:build": "typedoc src/index.ts --out generated/docs --name \"node-webserver\" --excludePrivate --excludeProtected",
+    "examples/simple": "tsx examples/simple.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SourceRegistry/node-webserver.git"
+  },
+  "keywords": [
+    "webserver",
+    "http",
+    "https",
+    "router",
+    "middleware",
+    "websocket",
+    "fetch",
+    "request",
+    "response",
+    "typescript",
+    "node",
+    "nodejs",
+    "web-standard"
+  ],
+  "author": "Alexander Slaa",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/SourceRegistry/node-webserver/issues"
+  },
+  "homepage": "https://sourceregistry.github.io/node-webserver/",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "cookie": "^1.0.2",
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/npm": "^13.1.3",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@types/node": "^24.3.0",
+    "@vitest/coverage-v8": "^4.0.16",
+    "@vitest/ui": "^4.0.16",
+    "tsx": "^4.21.0",
+    "typedoc": "^0.28.15",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.0",
+    "vite-plugin-dts": "^4.5.4",
+    "@types/ws": "^8.18.1",
+    "vitest": "^4.0.16"
+  },
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/changelog",
+      "@semantic-release/npm",
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "package.json",
+            "CHANGELOG.md"
+          ],
+          "message": "node-webserver(release): ${nextRelease.version}\n\n${nextRelease.notes}"
+        }
+      ]
+    ]
+  }
+}