@t8/serve 0.1.34 → 0.1.35

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./src/BundleConfig.ts";
+export * from "./src/Config.ts";
+export * from "./src/serve.ts";

package/dist/src/BundleConfig.d.ts

@@ -0,0 +1,20 @@
+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

@@ -0,0 +1,47 @@
+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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1,2 @@
+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

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

package/dist/src/isValidFilePath.d.ts

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

package/dist/src/mimeTypes.d.ts

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

package/dist/src/run.d.ts

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

package/dist/src/serve.d.ts

@@ -0,0 +1,4 @@
+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>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t8/serve",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "description": "Simple static file server + bundler, primarily for demo apps and tests, manual or automated",
   "keywords": [
     "node",
@@ -18,8 +18,9 @@
   "author": "axtk",
   "type": "module",
   "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "scripts": {
-    "build": "npx npm-run-all clean -p compile compile-mjs-bin compile-cjs-bin",
+    "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",
@@ -27,7 +28,8 @@
     "prepublishOnly": "npm run build",
     "preversion": "npx npm-run-all typecheck shape build",
     "shape": "npx codeshape",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "types": "tsc --emitDeclarationOnly"
   },
   "devDependencies": {
     "@types/node": "^24.5.2",

package/src/serve.ts

@@ -9,7 +9,7 @@ import { mimeTypes } from "./mimeTypes.ts";
 
 export type Server = ReturnType<typeof createServer>;
 
-export async function serve(config: Config = {}) {
+export async function serve(config: Config = {}): Promise<Server> {
   let stop = await bundle(config);
 
   return new Promise<Server>((resolve) => {

package/tsconfig.json

@@ -1,7 +1,8 @@
 {
   "include": ["index.ts", "src"],
   "compilerOptions": {
-    "noEmit": true,
+    "declaration": true,
+    "emitDeclarationOnly": true,
     "lib": ["ESNext", "DOM", "DOM.Iterable"],
     "target": "esnext",
     "outDir": "dist",