@haibun/web-server-express 1.26.1 → 1.26.2

package/build/defs.d.ts

@@ -0,0 +1,15 @@
+export declare const WEBSERVER = "webserver";
+export declare const CHECK_LISTENER = "CHECK_LISTENER";
+import * as express from 'express';
+export interface IWebServer {
+    addStaticFolder(subdir: string, loc: string): void;
+    addKnownStaticFolder(subdir: string, mountAt?: string): void;
+    listen(): Promise<unknown>;
+    close(): Promise<void>;
+    addRoute(type: TRouteTypes, path: string, route: TRequestHandler): void;
+    use(middleware: express.RequestHandler): void;
+}
+export type TRouteTypes = 'get' | 'post';
+export type IRequest = typeof express.request;
+export type IResponse = typeof express.response;
+export type TRequestHandler = (req: IRequest, res: IResponse) => void;

package/build/defs.js

@@ -0,0 +1,3 @@
+export const WEBSERVER = 'webserver';
+export const CHECK_LISTENER = 'CHECK_LISTENER';
+//# sourceMappingURL=defs.js.map

package/build/defs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defs.js","sourceRoot":"","sources":["../src/defs.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC"}

package/build/server-express.d.ts

@@ -0,0 +1,28 @@
+/// <reference types="node" resolution-mode="require"/>
+import http from 'http';
+import { RequestHandler } from 'express';
+import { IWebServer, TRouteTypes } from './defs.js';
+import { ILogger } from '@haibun/core/build/lib/interfaces/logger.js';
+export declare const DEFAULT_PORT = 8123;
+export declare class ServerExpress implements IWebServer {
+    logger: ILogger;
+    static listening: boolean;
+    listener?: http.Server;
+    app: import("express-serve-static-core").Express;
+    static mounted: {
+        get: {};
+        post: {};
+    };
+    base: string;
+    port: number;
+    constructor(logger: ILogger, base: string, port?: number);
+    use(middleware: RequestHandler): void;
+    listen(): Promise<unknown>;
+    addRoute(type: TRouteTypes, path: string, route: RequestHandler): void;
+    private addMounted;
+    addStaticFolder(relativeFolder: string, mountAt?: string): void;
+    addKnownStaticFolder(folder: string, mountAt?: string): void;
+    private doAddStaticFolder;
+    checkMountBadOrMounted(type: string, loc: string, what: string): void;
+    close(): Promise<void>;
+}

package/build/server-express.js

@@ -0,0 +1,99 @@
+import { statSync, existsSync } from 'fs';
+import express from 'express';
+import cookieParser from 'cookie-parser';
+export const DEFAULT_PORT = 8123;
+export class ServerExpress {
+    logger;
+    static listening = false;
+    listener;
+    app = express();
+    static mounted = { get: {}, post: {} };
+    base;
+    port;
+    constructor(logger, base, port = DEFAULT_PORT) {
+        this.logger = logger;
+        this.base = base;
+        this.port = port;
+        this.app.use(cookieParser());
+        this.app.use(express.json({ limit: '50mb' }));
+    }
+    use(middleware) {
+        this.app.use(middleware);
+    }
+    listen() {
+        return new Promise((resolve, reject) => {
+            if (!ServerExpress.listening) {
+                try {
+                    this.listener = this.app.listen(this.port, () => {
+                        this.logger.log(`Server listening on port: ${this.port}`);
+                        ServerExpress.listening = true;
+                        this.logger.log('express listening');
+                        resolve('started');
+                    });
+                }
+                catch (e) {
+                    console.error(e);
+                    reject(e);
+                }
+            }
+            else {
+                this.logger.log('express already listening');
+                resolve('already listening');
+            }
+        });
+    }
+    addRoute(type, path, route) {
+        if (type !== 'get' && type !== 'post') {
+            throw Error(`invalid route type ${type}`);
+        }
+        this.checkMountBadOrMounted(type, path, route.toString());
+        this.logger.log(`adding ${type} route from ${path}`);
+        this.app[type](path, route);
+        this.addMounted(type, path, route.toString());
+    }
+    async addMounted(type, path, what) {
+        ServerExpress.mounted[type][path] = what;
+        if (!this.listener) {
+            await this.listen();
+        }
+    }
+    // add a static folder restricted to relative paths from files
+    addStaticFolder(relativeFolder, mountAt = '/') {
+        const folder = [this.base, relativeFolder].join('/');
+        this.doAddStaticFolder(folder, mountAt);
+    }
+    // add a static folder at any path
+    addKnownStaticFolder(folder, mountAt = '/') {
+        this.doAddStaticFolder(folder, mountAt);
+    }
+    doAddStaticFolder(folder, mountAt = '/') {
+        this.checkMountBadOrMounted('get', mountAt, folder);
+        if (!existsSync(folder)) {
+            throw Error(`"${folder}" doesn't exist`);
+        }
+        const stat = statSync(folder);
+        if (!stat.isDirectory()) {
+            throw Error(`"${folder}" is not a directory`);
+        }
+        this.app.use(mountAt, express.static(folder));
+        this.addMounted('get', mountAt, folder);
+        this.logger.info(`serving files from ${folder} at ${mountAt}`);
+        return;
+    }
+    checkMountBadOrMounted(type, loc, what) {
+        if (loc !== loc.replace(/[^a-zA-Z-0-9/-_]/g, '')) {
+            throw Error(`mount folder ${loc} has illegal characters`);
+        }
+        const alreadyMounted = ServerExpress.mounted[type][loc] || Object.keys(ServerExpress.mounted[type]).find((m) => m.startsWith(`${loc}/`));
+        if (alreadyMounted) {
+            throw Error(`cannot mount ${type} ${what} at ${loc}, ${alreadyMounted} is already mounted}`);
+        }
+    }
+    async close() {
+        this.logger.info('closing server');
+        this.listener?.close();
+        ServerExpress.mounted = { get: {}, post: {} };
+        ServerExpress.listening = false;
+    }
+}
+//# sourceMappingURL=server-express.js.map

package/build/server-express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-express.js","sourceRoot":"","sources":["../src/server-express.ts"],"names":[],"mappings":"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"}

package/build/server-express.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/server-express.test.js

@@ -0,0 +1,17 @@
+import { ServerExpress } from "./server-express.js";
+import TestLogger from '@haibun/core/build/lib/TestLogger.js';
+describe('mounts', () => {
+    it('mounts a route', () => {
+        const tl = new TestLogger();
+        const se = new ServerExpress(tl, '/', 8999);
+        se.listen = async () => 'started';
+        expect(() => se.addRoute('get', '/', () => undefined)).not.toThrow();
+    });
+    it('fails to double mount a route', () => {
+        const tl = new TestLogger();
+        const se = new ServerExpress(tl, '/', 8999);
+        se.listen = async () => 'started';
+        expect(() => se.addRoute('get', '/', () => undefined)).toThrow();
+    });
+});
+//# sourceMappingURL=server-express.test.js.map

package/build/server-express.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-express.test.js","sourceRoot":"","sources":["../src/server-express.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,UAAU,MAAM,sCAAsC,CAAC;AAE9D,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACpB,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;QACtB,MAAM,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5C,EAAE,CAAC,MAAM,GAAG,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC;QAClC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACzE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5C,EAAE,CAAC,MAAM,GAAG,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC;QAClC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/build/web-server-stepper-route.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/web-server-stepper-route.test.js

@@ -0,0 +1,35 @@
+import WebHttp from '@haibun/web-http/build/web-http.js';
+import { actionOK, getFromRuntime, getStepperOptionName } from '@haibun/core/build/lib/util/index.js';
+import { DEFAULT_DEST } from '@haibun/core/build/lib/defs.js';
+import { WEBSERVER } from './defs.js';
+import Server from './web-server-stepper.js';
+import { AStepper } from '@haibun/core/build/lib/defs.js';
+import { testWithDefaults } from '@haibun/core/build/lib/test/lib.js';
+import WebServerStepper from './web-server-stepper.js';
+describe('route mount', () => {
+    it.skip('mounts a route', async () => {
+        const TestRoute = class TestRoute extends AStepper {
+            steps = {
+                addRoute: {
+                    gwta: 'serve test route to {loc}',
+                    action: async ({ loc }) => {
+                        const route = (req, res) => res.status(200).send('ok');
+                        const webserver = await getFromRuntime(this.getWorld().runtime, WEBSERVER);
+                        await webserver.addRoute('get', loc, route);
+                        return actionOK();
+                    },
+                },
+            };
+        };
+        const wss = new WebServerStepper();
+        const feature = { path: '/features/test.feature', content: `serve test route to /test\nwebserver is listening\nfetch from http://localhost:8124/test is "ok"` };
+        const result = await testWithDefaults([feature], [Server, TestRoute, WebHttp], {
+            options: { DEST: DEFAULT_DEST, },
+            extraOptions: {
+                [getStepperOptionName(wss, 'PORT')]: '8124',
+            },
+        });
+        expect(result.ok).toBe(true);
+    });
+});
+//# sourceMappingURL=web-server-stepper-route.test.js.map

package/build/web-server-stepper-route.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-server-stepper-route.test.js","sourceRoot":"","sources":["../src/web-server-stepper-route.test.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,oCAAoC,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAmC,SAAS,EAAE,MAAM,WAAW,CAAC;AAEvE,OAAO,MAAM,MAAM,yBAAyB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAU,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,gBAAgB,MAAM,yBAAyB,CAAC;AAEvD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,SAAS,GAAG,MAAM,SAAU,SAAQ,QAAQ;YAChD,KAAK,GAAG;gBACN,QAAQ,EAAE;oBACR,IAAI,EAAE,2BAA2B;oBACjC,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAU,EAAE,EAAE;wBAChC,MAAM,KAAK,GAAG,CAAC,GAAa,EAAE,GAAc,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAC5E,MAAM,SAAS,GAAe,MAAM,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;wBACvF,MAAM,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;wBAC5C,OAAO,QAAQ,EAAE,CAAC;oBACpB,CAAC;iBACF;aACF,CAAC;SACH,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,kGAAkG,EAAE,CAAC;QAChK,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;YAC7E,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG;YAChC,YAAY,EAAE;gBACZ,CAAC,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM;aAC5C;SACF,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/web-server-stepper.d.ts

@@ -0,0 +1,59 @@
+import { TWorld, TNamed, TOptions, AStepper, TVStep } from '@haibun/core/build/lib/defs.js';
+import { IWebServer } from './defs.js';
+import { ServerExpress } from './server-express.js';
+declare const WebServerStepper: {
+    new (): {
+        webserver: ServerExpress | undefined;
+        options: {
+            PORT: {
+                desc: string;
+                parse: (port: string) => {
+                    error: string;
+                    result?: undefined;
+                } | {
+                    result: number;
+                    error?: undefined;
+                };
+            };
+        };
+        setWorld(world: TWorld, steppers: AStepper[]): void;
+        close(): Promise<void>;
+        steps: {
+            thisURI: {
+                gwta: string;
+                action: ({ where }: TNamed, vstep: TVStep) => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult>;
+            };
+            webpage: {
+                gwta: string;
+                action: ({ name, location }: TNamed, vsteps: TVStep) => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult>;
+            };
+            isListening: {
+                gwta: string;
+                action: () => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult>;
+            };
+            showMounts: {
+                gwta: string;
+                action: () => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult>;
+            };
+            serveFilesAt: {
+                gwta: string;
+                action: ({ where, loc }: TNamed) => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult | import("@haibun/core/build/lib/defs.js").TNotOKActionResult>;
+            };
+            serveFiles: {
+                gwta: string;
+                action: ({ loc }: TNamed) => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult | import("@haibun/core/build/lib/defs.js").TNotOKActionResult>;
+            };
+        };
+        doServeFiles(where: any, loc: any): import("@haibun/core/build/lib/defs.js").TOKActionResult | import("@haibun/core/build/lib/defs.js").TNotOKActionResult;
+        world?: TWorld;
+        endFeature?(): void;
+        onFailure?(result: import("@haibun/core/build/lib/defs.js").TStepResult): void;
+        getWorld(): TWorld;
+    };
+};
+export default WebServerStepper;
+export type ICheckListener = (options: TOptions, webserver: IWebServer) => void;
+export interface IWebServerStepper {
+    webserver: IWebServer;
+    close: () => void;
+}

package/build/web-server-stepper.js

@@ -0,0 +1,112 @@
+import { OK, AStepper } from '@haibun/core/build/lib/defs.js';
+import { actionNotOK, getFromRuntime, getStepperOption, intOrError } from '@haibun/core/build/lib/util/index.js';
+import { WEBSERVER, } from './defs.js';
+import { ServerExpress, DEFAULT_PORT } from './server-express.js';
+import { WEB_PAGE } from '@haibun/domain-webpage/build/domain-webpage.js';
+const WebServerStepper = class WebServerStepper extends AStepper {
+    webserver;
+    options = {
+        PORT: {
+            desc: `change web server port from ${DEFAULT_PORT}`,
+            parse: (port) => intOrError(port)
+        },
+    };
+    setWorld(world, steppers) {
+        super.setWorld(world, steppers);
+        // this.world.runtime[CHECK_LISTENER] = WebServerStepper.checkListener;
+        const port = parseInt(getStepperOption(this, 'PORT', world.extraOptions)) || DEFAULT_PORT;
+        this.webserver = new ServerExpress(world.logger, [process.cwd(), 'files'].join('/'), port);
+        world.runtime[WEBSERVER] = this.webserver;
+    }
+    async close() {
+        await this.webserver?.close();
+    }
+    steps = {
+        thisURI: {
+            gwta: `a ${WEB_PAGE} at {where}`,
+            action: async ({ where }, vstep) => {
+                const page = vstep.source.name;
+                const webserver = getFromRuntime(this.getWorld().runtime, WEBSERVER);
+                webserver.addStaticFolder(page, where);
+                console.debug('added page', page);
+                return OK;
+            },
+        },
+        /// generator
+        webpage: {
+            gwta: `A ${WEB_PAGE} {name} hosted at {location}`,
+            action: async ({ name, location }, vsteps) => {
+                const page = vsteps.source.name;
+                const webserver = getFromRuntime(this.getWorld().runtime, WEBSERVER);
+                // TODO mount the page
+                return OK;
+            },
+            /*
+            build: async ({ location }: TNamed, { source }: TVStep, workspace: WorkspaceContext) => {
+              if (location !== location.replace(/[^a-zA-Z-0-9.]/g, '')) {
+                throw Error(`${WEB_PAGE} location ${location} has illegal characters`);
+              }
+              const subdir = this.getWorld().shared.get('file_location');
+              if (!subdir) {
+                throw Error(`must declare a file_location`);
+              }
+              const folder = `files/${subdir}`;
+              workspace.addBuilder(new WebPageBuilder(source.name, this.getWorld().logger, location, folder));
+              return { ...OK, finalize: this.finalize };
+            },
+            */
+        },
+        isListening: {
+            gwta: 'webserver is listening',
+            action: async () => {
+                await this.webserver.listen();
+                return OK;
+            },
+        },
+        showMounts: {
+            gwta: 'show mounts',
+            action: async () => {
+                const mounts = ServerExpress.mounted;
+                this.getWorld().logger.info(`mounts: ${JSON.stringify(mounts)}`);
+                return OK;
+            },
+        },
+        serveFilesAt: {
+            gwta: 'serve files at {where} from {loc}',
+            action: async ({ where, loc }) => {
+                return this.doServeFiles(where, loc);
+            },
+            /*
+            build: async ({ loc }: TNamed) => {
+              this.getWorld().shared.set('file_location', loc);
+              return OK;
+            }
+            */
+        },
+        serveFiles: {
+            gwta: 'serve files from {loc}',
+            action: async ({ loc }) => {
+                return this.doServeFiles('/', loc);
+            },
+            /*
+            build: async ({ loc }: TNamed) => {
+              this.getWorld().shared.set('file_location', loc);
+              return OK;
+            }
+            */
+        },
+    };
+    doServeFiles(where, loc) {
+        const ws = getFromRuntime(this.getWorld().runtime, WEBSERVER);
+        try {
+            ws.addStaticFolder(loc, where);
+            this.getWorld().shared.set('file_location', loc);
+            return OK;
+        }
+        catch (error) {
+            return actionNotOK(error);
+        }
+    }
+};
+export default WebServerStepper;
+//# sourceMappingURL=web-server-stepper.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@haibun/web-server-express",
   "type": "module",
-  "version": "1.26.1",
+  "version": "1.26.2",
   "description": "",
   "main": "build/web-server-stepper.js",
   "files": [
@@ -31,4 +31,4 @@
     "@types/express": "^4.17.15"
   },
   "gitHead": "7cf9680bd922fb622fb59f1e6bf5b65284cb8fd5"
-}
+}