@openapi-typescript-infra/service 1.0.0

package/build/express-app/app.js

@@ -0,0 +1,327 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listen = exports.shutdownApp = exports.startApp = void 0;
+const assert_1 = __importDefault(require("assert"));
+const http_1 = __importDefault(require("http"));
+const path_1 = __importDefault(require("path"));
+const express_1 = __importDefault(require("express"));
+const pino_1 = require("pino");
+const cookie_parser_1 = __importDefault(require("cookie-parser"));
+const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
+const api_metrics_1 = require("@opentelemetry/api-metrics");
+const exporter_prometheus_1 = require("@opentelemetry/exporter-prometheus");
+const terminus_1 = require("@godaddy/terminus");
+const index_1 = require("../config/index");
+const port_finder_1 = require("../development/port-finder");
+const openapi_1 = require("../openapi");
+const requestLogger_1 = require("../telemetry/requestLogger");
+const env_1 = require("../env");
+const route_loader_1 = require("./route-loader");
+const internal_server_1 = require("./internal-server");
+const METRICS_KEY = Symbol('PrometheusMetricsInfo');
+async function enableMetrics(app, name) {
+    const meterProvider = new sdk_metrics_1.MeterProvider();
+    api_metrics_1.metrics.setGlobalMeterProvider(meterProvider);
+    app.locals.meter = meterProvider.getMeter(name);
+    const metricsConfig = app.locals.config.get('server:metrics');
+    const value = { meterProvider };
+    if (metricsConfig?.enabled) {
+        const finalConfig = {
+            ...metricsConfig,
+            preventServerStart: true,
+        };
+        // There is what I would consider a bug in OpenTelemetry metrics
+        // wherein adding metrics BEFORE the metricReader is added results
+        // in those metrics screaming into the void. So, we need to add
+        // this up front and then just tie it to the internal express
+        // app if and when "listen" is called.
+        const exporter = new exporter_prometheus_1.PrometheusExporter(finalConfig);
+        meterProvider.addMetricReader(exporter);
+        value.exporter = exporter;
+    }
+    else {
+        app.locals.logger.info('No metrics will be exported');
+    }
+    // Squirrel it away for later
+    Object.defineProperty(app.locals, METRICS_KEY, {
+        value,
+        enumerable: false,
+        configurable: true,
+    });
+}
+async function endMetrics(app) {
+    const { internalApp, logger } = app.locals;
+    const meterProvider = internalApp?.locals.meterProvider;
+    await meterProvider?.shutdown();
+    logger.info('Metrics shutdown');
+}
+async function startApp(startOptions) {
+    const { service, rootDirectory, codepath = 'build', name, } = startOptions;
+    const shouldPrettyPrint = (0, env_1.isDev)() && !process.env.NO_PRETTY_LOGS;
+    const destination = pino_1.pino.destination({
+        dest: process.env.LOG_TO_FILE || process.stdout.fd,
+        minLength: process.env.LOG_BUFFER ? Number(process.env.LOG_BUFFER) : undefined,
+    });
+    const logger = shouldPrettyPrint
+        ? (0, pino_1.pino)({
+            transport: {
+                destination,
+                target: 'pino-pretty',
+                options: {
+                    colorize: true,
+                },
+            },
+        })
+        : (0, pino_1.pino)({
+            formatters: {
+                level(label) {
+                    return { level: label };
+                },
+            },
+        }, destination);
+    const serviceImpl = service();
+    (0, assert_1.default)(serviceImpl?.start, 'Service function did not return a conforming object');
+    const baseOptions = {
+        configurationDirectories: [path_1.default.resolve(rootDirectory, './config')],
+    };
+    const options = serviceImpl.configure?.(startOptions, baseOptions) || baseOptions;
+    const config = await (0, index_1.loadConfiguration)({
+        name,
+        configurationDirectories: options.configurationDirectories,
+        rootDirectory,
+    });
+    const logging = config.get('logging');
+    logger.level = logging?.level || 'info';
+    // Concentrate the Typescript ugliness...
+    const app = (0, express_1.default)();
+    const routing = config.get('routing');
+    app.disable('x-powered-by');
+    if (routing?.etag !== true) {
+        app.disable('etag');
+    }
+    Object.assign(app.locals, { services: {} }, startOptions.locals, {
+        service: serviceImpl,
+        logger,
+        config,
+        name,
+    });
+    try {
+        await enableMetrics(app, name);
+    }
+    catch (error) {
+        logger.error(error, 'Could not enable metrics.');
+        throw error;
+    }
+    if (config.get('trustProxy')) {
+        app.set('trust proxy', config.get('trustProxy'));
+    }
+    app.use((0, requestLogger_1.loggerMiddleware)(app, logging?.logRequestBody, logging?.logResponseBody));
+    // Allow the service to add locals, etc. We put this before the body parsers
+    // so that the req can decide whether to save the raw request body or not.
+    const attachServiceLocals = (req, res, next) => {
+        res.locals.logger = logger;
+        let maybePromise;
+        try {
+            maybePromise = serviceImpl.onRequest?.(req, res);
+        }
+        catch (error) {
+            next(error);
+        }
+        if (maybePromise) {
+            maybePromise.catch(next).then(next);
+        }
+        else {
+            next();
+        }
+    };
+    app.use(attachServiceLocals);
+    if (routing?.cookieParser) {
+        app.use((0, cookie_parser_1.default)());
+    }
+    if (routing?.bodyParsers?.json) {
+        app.use(express_1.default.json({
+            verify(req, res, buf) {
+                const locals = res.locals;
+                if (locals?.rawBody === true) {
+                    locals.rawBody = buf;
+                }
+            },
+        }));
+    }
+    if (routing?.bodyParsers?.form) {
+        app.use(express_1.default.urlencoded());
+    }
+    if (serviceImpl.authorize) {
+        const authorize = (req, res, next) => {
+            let maybePromise;
+            try {
+                maybePromise = serviceImpl.authorize?.(req, res);
+            }
+            catch (error) {
+                next(error);
+            }
+            if (maybePromise && typeof maybePromise !== 'boolean') {
+                maybePromise
+                    .then((val) => {
+                    if (val === false) {
+                        return;
+                    }
+                    next();
+                })
+                    .catch(next);
+            }
+            else if (maybePromise !== false) {
+                next();
+            }
+        };
+        app.use(authorize);
+    }
+    if (routing?.static?.enabled) {
+        const localdir = path_1.default.resolve(rootDirectory, routing?.static?.path || 'public');
+        if (routing.static.mountPath) {
+            app.use(routing.static.mountPath, express_1.default.static(localdir));
+        }
+        else {
+            app.use(express_1.default.static(localdir));
+        }
+    }
+    if (routing?.freezeQuery) {
+        app.use((req, res, next) => {
+            // Express 5 re-parses the query string every time. This causes problems with
+            // various libraries, namely the express OpenAPI parser. So we "freeze it" in place
+            // here, which runs right before the routing validation logic does. Note that this
+            // means the app middleware will see the unfrozen one, which is intentional. If the
+            // app wants to modify or freeze the query itself, this shouldn't get in the way.
+            const { query } = req;
+            if (query) {
+                Object.defineProperty(req, 'query', {
+                    configurable: true,
+                    enumerable: true,
+                    value: query,
+                });
+            }
+            next();
+        });
+    }
+    if (routing?.routes) {
+        await (0, route_loader_1.loadRoutes)(app, path_1.default.resolve(rootDirectory, codepath, config.get('routing:routes') || 'routes'), codepath === 'build' ? '**/*.js' : '**/*.ts');
+    }
+    if (routing?.openapi) {
+        app.use((0, openapi_1.openApi)(app, rootDirectory, codepath, options.openApiOptions));
+    }
+    // Putting this here allows more flexible middleware insertion
+    await serviceImpl.start(app);
+    const { notFound, errors } = routing?.finalHandlers || {};
+    if (notFound) {
+        app.use((0, requestLogger_1.notFoundMiddleware)());
+    }
+    if (errors?.enabled) {
+        app.use((0, requestLogger_1.errorHandlerMiddleware)(app, errors?.unnest, errors?.render));
+    }
+    return app;
+}
+exports.startApp = startApp;
+async function shutdownApp(app) {
+    const { logger } = app.locals;
+    try {
+        await app.locals.service.stop?.(app);
+        await endMetrics(app);
+        logger.info('App shutdown complete');
+    }
+    catch (error) {
+        logger.warn(error, 'Shutdown failed');
+    }
+    logger.flush?.();
+}
+exports.shutdownApp = shutdownApp;
+async function listen(app, shutdownHandler) {
+    let port = app.locals.config.get('server:port');
+    if (port === 0) {
+        port = await (0, port_finder_1.findPort)(8001);
+    }
+    const { service, logger } = app.locals;
+    const server = http_1.default.createServer(app);
+    let shutdownInProgress = false;
+    (0, terminus_1.createTerminus)(server, {
+        timeout: 15000,
+        useExit0: true,
+        // https://github.com/godaddy/terminus#how-to-set-terminus-up-with-kubernetes
+        beforeShutdown() {
+            if (shutdownInProgress) {
+                return Promise.resolve();
+            }
+            shutdownInProgress = true;
+            if (app.locals.internalApp) {
+                app.locals.internalApp.locals.server?.close();
+            }
+            logger.info('Graceful shutdown beginning');
+            return new Promise((accept) => {
+                setTimeout(accept, 10000);
+            });
+        },
+        onShutdown() {
+            return Promise.resolve()
+                .then(() => service.stop?.(app))
+                .then(() => endMetrics(app))
+                .then(shutdownHandler || Promise.resolve)
+                .then(() => logger.info('Graceful shutdown complete'))
+                .catch((error) => logger.error(error, 'Error terminating tracing'))
+                .then(() => logger.flush?.());
+        },
+        logger: (msg, e) => {
+            logger.error(e, msg);
+        },
+    });
+    server.on('close', () => {
+        if (!shutdownInProgress) {
+            shutdownInProgress = true;
+            app.locals.logger.info('Shutdown requested');
+            if (app.locals.internalApp) {
+                app.locals.internalApp.locals.server?.close();
+            }
+            shutdownApp(app);
+        }
+    });
+    const metricInfo = app.locals[METRICS_KEY];
+    delete app.locals[METRICS_KEY];
+    // TODO handle rejection/error?
+    const listenPromise = new Promise((accept) => {
+        server.listen(port, () => {
+            const { locals } = app;
+            locals.logger.info({ port, service: locals.name }, 'express listening');
+            const serverConfig = locals.config.get('server');
+            // Ok now start the internal port if we have one.
+            if (serverConfig?.internalPort) {
+                (0, internal_server_1.startInternalApp)(app, serverConfig.internalPort)
+                    .then((internalApp) => {
+                    locals.internalApp = internalApp;
+                    internalApp.locals.meterProvider = metricInfo.meterProvider;
+                    locals.logger.info({ port: serverConfig.internalPort }, 'Internal metadata server started');
+                })
+                    .then(() => {
+                    if (metricInfo.exporter) {
+                        locals.internalApp.get('/metrics', metricInfo.exporter.getMetricsRequestHandler.bind(metricInfo.exporter));
+                        locals.logger.info('Metrics exporter started');
+                    }
+                    else {
+                        locals.logger.info('No metrics will be exported');
+                    }
+                    accept();
+                })
+                    .catch((error) => {
+                    locals.logger.warn(error, 'Failed to start internal metadata app');
+                });
+            }
+            else {
+                accept();
+            }
+        });
+    });
+    await listenPromise;
+    return server;
+}
+exports.listen = listen;
+//# sourceMappingURL=app.js.map

package/build/express-app/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/express-app/app.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAC5B,gDAAwB;AACxB,gDAAwB;AAExB,sDAA8B;AAC9B,+BAA4B;AAC5B,kEAAyC;AACzC,4DAA2D;AAC3D,4DAAqD;AACrD,4EAAwE;AACxE,gDAAmD;AAGnD,2CAAoD;AACpD,4DAAsD;AACtD,wCAAqC;AACrC,8DAIoC;AAUpC,gCAA+B;AAE/B,iDAA4C;AAC5C,uDAAqD;AAErD,MAAM,WAAW,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AASpD,KAAK,UAAU,aAAa,CAC1B,GAA4B,EAC5B,IAAY;IAEZ,MAAM,aAAa,GAAG,IAAI,2BAAa,EAAE,CAAC;IAC1C,qBAAO,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;IAC9C,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEhD,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAA2B,gBAAgB,CAAC,CAAC;IACxF,MAAM,KAAK,GAAwB,EAAE,aAAa,EAAE,CAAC;IACrD,IAAI,aAAa,EAAE,OAAO,EAAE;QAC1B,MAAM,WAAW,GAAG;YAClB,GAAG,aAAa;YAChB,kBAAkB,EAAE,IAAI;SACzB,CAAC;QACF,gEAAgE;QAChE,kEAAkE;QAClE,+DAA+D;QAC/D,6DAA6D;QAC7D,sCAAsC;QACtC,MAAM,QAAQ,GAAG,IAAI,wCAAkB,CAAC,WAAW,CAAC,CAAC;QACrD,aAAa,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;KAC3B;SAAM;QACL,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;KACvD;IACD,6BAA6B;IAC7B,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE;QAC7C,KAAK;QACL,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,GAA4B;IAE5B,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAC3C,MAAM,aAAa,GAAG,WAAW,EAAE,MAAM,CAAC,aAA0C,CAAC;IACrF,MAAM,aAAa,EAAE,QAAQ,EAAE,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;AAClC,CAAC;AAEM,KAAK,UAAU,QAAQ,CAG5B,YAAmD;IACnD,MAAM,EACJ,OAAO,EAAE,aAAa,EAAE,QAAQ,GAAG,OAAO,EAAE,IAAI,GACjD,GAAG,YAAY,CAAC;IACjB,MAAM,iBAAiB,GAAG,IAAA,WAAK,GAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACjE,MAAM,WAAW,GAAG,WAAI,CAAC,WAAW,CAAC;QACnC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE;QAClD,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;KAC/E,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,iBAAiB;QAC9B,CAAC,CAAC,IAAA,WAAI,EAAC;YACL,SAAS,EAAE;gBACT,WAAW;gBACX,MAAM,EAAE,aAAa;gBACrB,OAAO,EAAE;oBACP,QAAQ,EAAE,IAAI;iBACf;aACF;SACF,CAAC;QACF,CAAC,CAAC,IAAA,WAAI,EACJ;YACE,UAAU,EAAE;gBACV,KAAK,CAAC,KAAK;oBACT,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;gBAC1B,CAAC;aACF;SACF,EACD,WAAW,CACZ,CAAC;IAEJ,MAAM,WAAW,GAAG,OAAO,EAAE,CAAC;IAC9B,IAAA,gBAAM,EAAC,WAAW,EAAE,KAAK,EAAE,qDAAqD,CAAC,CAAC;IAElF,MAAM,WAAW,GAAmB;QAClC,wBAAwB,EAAE,CAAC,cAAI,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;KACpE,CAAC;IACF,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC,IAAI,WAAW,CAAC;IAElF,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAiB,EAAC;QACrC,IAAI;QACJ,wBAAwB,EAAE,OAAO,CAAC,wBAAwB;QAC1D,aAAa;KACd,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAmC,CAAC;IACxE,MAAM,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,MAAM,CAAC;IAExC,yCAAyC;IACzC,MAAM,GAAG,GAAG,IAAA,iBAAO,GAAwC,CAAC;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAmC,CAAC;IAExE,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5B,IAAI,OAAO,EAAE,IAAI,KAAK,IAAI,EAAE;QAC1B,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;KACrB;IAED,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,YAAY,CAAC,MAAM,EAAE;QAC/D,OAAO,EAAE,WAAW;QACpB,MAAM;QACN,MAAM;QACN,IAAI;KACL,CAAC,CAAC;IAEH,IAAI;QACF,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;KAChC;IAAC,OAAO,KAAK,EAAE;QACd,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC;KACb;IAED,IAAI,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE;QAC5B,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;KAClD;IAED,GAAG,CAAC,GAAG,CAAC,IAAA,gCAAgB,EAAC,GAAG,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IAElF,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,mBAAmB,GAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7D,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QAC3B,IAAI,YAAkC,CAAC;QACvC,IAAI;YACF,YAAY,GAAG,WAAW,CAAC,SAAS,EAAE,CACpC,GAA8B,EAC9B,GAAiC,CAClC,CAAC;SACH;QAAC,OAAO,KAAK,EAAE;YACd,IAAI,CAAC,KAAK,CAAC,CAAC;SACb;QACD,IAAI,YAAY,EAAE;YAChB,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACrC;aAAM;YACL,IAAI,EAAE,CAAC;SACR;IACH,CAAC,CAAC;IACF,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAE7B,IAAI,OAAO,EAAE,YAAY,EAAE;QACzB,GAAG,CAAC,GAAG,CAAC,IAAA,uBAAY,GAAE,CAAC,CAAC;KACzB;IAED,IAAI,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE;QAC9B,GAAG,CAAC,GAAG,CACL,iBAAO,CAAC,IAAI,CAAC;YACX,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG;gBAClB,MAAM,MAAM,GAAI,GAAgB,CAAC,MAAuB,CAAC;gBACzD,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE;oBAC5B,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;iBACtB;YACH,CAAC;SACF,CAAC,CACH,CAAC;KACH;IACD,IAAI,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE;QAC9B,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,UAAU,EAAE,CAAC,CAAC;KAC/B;IAED,IAAI,WAAW,CAAC,SAAS,EAAE;QACzB,MAAM,SAAS,GAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YACnD,IAAI,YAAoD,CAAC;YACzD,IAAI;gBACF,YAAY,GAAG,WAAW,CAAC,SAAS,EAAE,CACpC,GAA8B,EAC9B,GAAiC,CAClC,CAAC;aACH;YAAC,OAAO,KAAK,EAAE;gBACd,IAAI,CAAC,KAAK,CAAC,CAAC;aACb;YACD,IAAI,YAAY,IAAI,OAAO,YAAY,KAAK,SAAS,EAAE;gBACrD,YAAY;qBACT,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;oBACZ,IAAI,GAAG,KAAK,KAAK,EAAE;wBACjB,OAAO;qBACR;oBACD,IAAI,EAAE,CAAC;gBACT,CAAC,CAAC;qBACD,KAAK,CAAC,IAAI,CAAC,CAAC;aAChB;iBAAM,IAAI,YAAY,KAAK,KAAK,EAAE;gBACjC,IAAI,EAAE,CAAC;aACR;QACH,CAAC,CAAC;QACF,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;KACpB;IAED,IAAI,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAC5B,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,IAAI,QAAQ,CAAC,CAAC;QAChF,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE;YAC5B,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,iBAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;SAC7D;aAAM;YACL,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;SACnC;KACF;IAED,IAAI,OAAO,EAAE,WAAW,EAAE;QACxB,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YACzB,6EAA6E;YAC7E,mFAAmF;YACnF,kFAAkF;YAClF,mFAAmF;YACnF,iFAAiF;YACjF,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;YACtB,IAAI,KAAK,EAAE;gBACT,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE;oBAClC,YAAY,EAAE,IAAI;oBAClB,UAAU,EAAE,IAAI;oBAChB,KAAK,EAAE,KAAK;iBACb,CAAC,CAAC;aACJ;YACD,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;KACJ;IAED,IAAI,OAAO,EAAE,MAAM,EAAE;QACnB,MAAM,IAAA,yBAAU,EACd,GAAG,EACH,cAAI,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAS,gBAAgB,CAAC,IAAI,QAAQ,CAAC,EACvF,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAC7C,CAAC;KACH;IACD,IAAI,OAAO,EAAE,OAAO,EAAE;QACpB,GAAG,CAAC,GAAG,CAAC,IAAA,iBAAO,EAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;KACxE;IAED,8DAA8D;IAC9D,MAAM,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE7B,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,aAAa,IAAI,EAAE,CAAC;IAC1D,IAAI,QAAQ,EAAE;QACZ,GAAG,CAAC,GAAG,CAAC,IAAA,kCAAkB,GAAE,CAAC,CAAC;KAC/B;IACD,IAAI,MAAM,EAAE,OAAO,EAAE;QACnB,GAAG,CAAC,GAAG,CAAC,IAAA,sCAAsB,EAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KACtE;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAtMD,4BAsMC;AAEM,KAAK,UAAU,WAAW,CAAC,GAAmB;IACnD,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAC9B,IAAI;QACF,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;KACtC;IAAC,OAAO,KAAK,EAAE;QACd,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;KACvC;IACA,MAAsB,CAAC,KAAK,EAAE,EAAE,CAAC;AACpC,CAAC;AAVD,kCAUC;AAEM,KAAK,UAAU,MAAM,CAC1B,GAA4B,EAC5B,eAAqC;IAErC,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAEhD,IAAI,IAAI,KAAK,CAAC,EAAE;QACd,IAAI,GAAG,MAAM,IAAA,sBAAQ,EAAC,IAAI,CAAC,CAAC;KAC7B;IAED,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IACvC,MAAM,MAAM,GAAG,cAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAA,yBAAc,EAAC,MAAM,EAAE;QACrB,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,IAAI;QACd,6EAA6E;QAC7E,cAAc;YACZ,IAAI,kBAAkB,EAAE;gBACtB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;aAC1B;YACD,kBAAkB,GAAG,IAAI,CAAC;YAC1B,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE;gBAC1B,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;aAC/C;YACD,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC5B,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC5B,CAAC,CAAC,CAAC;QACL,CAAC;QACD,UAAU;YACR,OAAO,OAAO,CAAC,OAAO,EAAE;iBACrB,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;iBAC/B,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;iBAC3B,IAAI,CAAC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;iBACxC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;iBACrD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC;iBAClE,IAAI,CAAC,GAAG,EAAE,CAAE,MAAsB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACjB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACtB,IAAI,CAAC,kBAAkB,EAAE;YACvB,kBAAkB,GAAG,IAAI,CAAC;YAC1B,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC7C,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE;gBAC1B,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;aAC/C;YACD,WAAW,CAAC,GAAG,CAAC,CAAC;SAClB;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAI,GAAG,CAAC,MAAyB,CAAC,WAAW,CAAwB,CAAC;IACtF,OAAQ,GAAG,CAAC,MAAyB,CAAC,WAAW,CAAC,CAAC;IAEnD,+BAA+B;IAC/B,MAAM,aAAa,GAAG,IAAI,OAAO,CAAO,CAAC,MAAM,EAAE,EAAE;QACjD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YACvB,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;YACvB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,mBAAmB,CAAC,CAAC;YAExE,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAkC,CAAC;YAClF,iDAAiD;YACjD,IAAI,YAAY,EAAE,YAAY,EAAE;gBAC9B,IAAA,kCAAgB,EAAC,GAAG,EAAE,YAAY,CAAC,YAAY,CAAC;qBAC7C,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;oBACpB,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;oBACjC,WAAW,CAAC,MAAM,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC;oBAC5D,MAAM,CAAC,MAAM,CAAC,IAAI,CAChB,EAAE,IAAI,EAAE,YAAY,CAAC,YAAY,EAAE,EACnC,kCAAkC,CACnC,CAAC;gBACJ,CAAC,CAAC;qBACD,IAAI,CAAC,GAAG,EAAE;oBACT,IAAI,UAAU,CAAC,QAAQ,EAAE;wBACvB,MAAM,CAAC,WAAW,CAAC,GAAG,CACpB,UAAU,EACV,UAAU,CAAC,QAAQ,CAAC,wBAAwB,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CACvE,CAAC;wBACF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;qBAChD;yBAAM;wBACL,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;qBACnD;oBACD,MAAM,EAAE,CAAC;gBACX,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,uCAAuC,CAAC,CAAC;gBACrE,CAAC,CAAC,CAAC;aACN;iBAAM;gBACL,MAAM,EAAE,CAAC;aACV;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,aAAa,CAAC;IACpB,OAAO,MAAM,CAAC;AAChB,CAAC;AAnGD,wBAmGC"}

package/build/express-app/index.d.ts

@@ -0,0 +1,2 @@
+export * from './app';
+export * from './types';

package/build/express-app/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./app"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/build/express-app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/express-app/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,0CAAwB"}

package/build/express-app/internal-server.d.ts

@@ -0,0 +1,3 @@
+import type { Application } from 'express-serve-static-core';
+import { InternalLocals, ServiceExpress } from '../types';
+export declare function startInternalApp(mainApp: ServiceExpress, port: number): Promise<Application<InternalLocals>>;

package/build/express-app/internal-server.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startInternalApp = void 0;
+const express_1 = __importDefault(require("express"));
+async function startInternalApp(mainApp, port) {
+    const app = (0, express_1.default)();
+    app.locals.mainApp = mainApp;
+    app.get('/health', async (req, res) => {
+        if (mainApp.locals.service?.healthy) {
+            try {
+                const ok = await mainApp.locals.service.healthy(mainApp);
+                res.sendStatus(ok ? 204 : 500);
+            }
+            catch (error) {
+                mainApp.locals.logger.error(error, 'Health check failed');
+            }
+        }
+        else {
+            res.sendStatus(204);
+        }
+    });
+    const listenPromise = new Promise((accept) => {
+        app.locals.server = app.listen(port, () => {
+            accept();
+        });
+    });
+    await listenPromise;
+    return app;
+}
+exports.startInternalApp = startInternalApp;
+//# sourceMappingURL=internal-server.js.map

package/build/express-app/internal-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-server.js","sourceRoot":"","sources":["../../src/express-app/internal-server.ts"],"names":[],"mappings":";;;;;;AAAA,sDAA8B;AAKvB,KAAK,UAAU,gBAAgB,CAAC,OAAuB,EAAE,IAAY;IAC1E,MAAM,GAAG,GAAG,IAAA,iBAAO,GAA4C,CAAC;IAChE,GAAG,CAAC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACpC,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE;YACnC,IAAI;gBACF,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACzD,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;aAChC;YAAC,OAAO,KAAK,EAAE;gBACd,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;aAC3D;SACF;aAAM;YACL,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SACrB;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,IAAI,OAAO,CAAO,CAAC,MAAM,EAAE,EAAE;QACjD,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YACxC,MAAM,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,aAAa,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC;AAzBD,4CAyBC"}

package/build/express-app/route-loader.d.ts

@@ -0,0 +1,2 @@
+import type { ServiceExpress } from '../types';
+export declare function loadRoutes(app: ServiceExpress, routingDir: string, pattern: string): Promise<void>;

package/build/express-app/route-loader.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadRoutes = void 0;
+const path_1 = __importDefault(require("path"));
+const glob_1 = require("glob");
+const express_1 = __importDefault(require("express"));
+async function loadRoutes(app, routingDir, pattern) {
+    const files = await new Promise((accept, reject) => {
+        (0, glob_1.glob)(pattern, {
+            nodir: true,
+            strict: true,
+            cwd: routingDir,
+        }, (error, matches) => (error ? reject(error) : accept(matches)));
+    });
+    await Promise.all(files.map(async (filename) => {
+        const routeBase = path_1.default.dirname(filename);
+        const modulePath = path_1.default.resolve(routingDir, filename);
+        // Need to use require for loading .ts files
+        // eslint-disable-next-line import/no-dynamic-require, global-require, @typescript-eslint/no-var-requires
+        const module = require(modulePath);
+        const mounter = module.default || module.route;
+        if (typeof mounter === 'function') {
+            const childRouter = express_1.default.Router();
+            mounter(childRouter, app);
+            const pathParts = [''];
+            if (routeBase !== '.') {
+                pathParts.push(routeBase);
+            }
+            const fn = path_1.default.parse(path_1.default.basename(filename)).name;
+            if (fn.toLowerCase() !== 'index') {
+                pathParts.push(fn);
+            }
+            const finalPath = pathParts.join('/') || '/';
+            app.locals.logger.debug({ path: finalPath, source: filename }, 'Registering route');
+            app.use(finalPath, childRouter);
+        }
+        else {
+            app.locals.logger.warn({ filename }, 'Route file had no default export');
+        }
+    }));
+}
+exports.loadRoutes = loadRoutes;
+//# sourceMappingURL=route-loader.js.map

package/build/express-app/route-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-loader.js","sourceRoot":"","sources":["../../src/express-app/route-loader.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AAExB,+BAA4B;AAC5B,sDAA8B;AAIvB,KAAK,UAAU,UAAU,CAAC,GAAmB,EAAE,UAAkB,EAAE,OAAe;IACvF,MAAM,KAAK,GAAa,MAAM,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QAC3D,IAAA,WAAI,EACF,OAAO,EACP;YACE,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,UAAU;SAChB,EACD,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAC9D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC3B,MAAM,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,cAAI,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACtD,4CAA4C;QAC5C,yGAAyG;QACzG,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC;QAC/C,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE;YACjC,MAAM,WAAW,GAAG,iBAAO,CAAC,MAAM,EAAE,CAAC;YACrC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YAC1B,MAAM,SAAS,GAAG,CAAC,EAAE,CAAC,CAAC;YACvB,IAAI,SAAS,KAAK,GAAG,EAAE;gBACrB,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;aAC3B;YACD,MAAM,EAAE,GAAG,cAAI,CAAC,KAAK,CAAC,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;YACpD,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE;gBAChC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;aACpB;YACD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;YAC7C,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,mBAAmB,CAAC,CAAC;YACpF,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;SACjC;aAAM;YACL,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,kCAAkC,CAAC,CAAC;SAC1E;IACH,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAxCD,gCAwCC"}

package/build/express-app/types.d.ts

@@ -0,0 +1,14 @@
+import type { NextFunction, Response } from 'express';
+import type { RequestLocals, RequestWithApp, ServiceLocals } from '../types';
+export type ServiceHandler<SLocals extends ServiceLocals = ServiceLocals, RLocals extends RequestLocals = RequestLocals, ResBody = unknown, RetType = unknown> = (req: RequestWithApp<SLocals>, res: Response<ResBody, RLocals>, next: NextFunction) => RetType | Promise<RetType>;
+export interface ServiceRouter<SLocals extends ServiceLocals = ServiceLocals, RLocals extends RequestLocals = RequestLocals> {
+    all(path: string, ...handlers: ServiceHandler<SLocals, RLocals>[]): void;
+    get(path: string, ...handlers: ServiceHandler<SLocals, RLocals>[]): void;
+    post(path: string, ...handlers: ServiceHandler<SLocals, RLocals>[]): void;
+    put(path: string, ...handlers: ServiceHandler<SLocals, RLocals>[]): void;
+    delete(path: string, ...handlers: ServiceHandler<SLocals, RLocals>[]): void;
+    patch(path: string, ...handlers: ServiceHandler<SLocals, RLocals>[]): void;
+    options(path: string, ...handlers: ServiceHandler<SLocals, RLocals>[]): void;
+    head(path: string, ...handlers: ServiceHandler<SLocals, RLocals>[]): void;
+    use(...handlers: ServiceHandler<SLocals, RLocals>[]): void;
+}

package/build/express-app/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/express-app/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/express-app/types.ts"],"names":[],"mappings":""}

package/build/index.d.ts

@@ -0,0 +1,8 @@
+export * from './telemetry';
+export * from './service-calls';
+export * from './express-app';
+export * from './types';
+export * from './env';
+export * from './config';
+export * from './error';
+export * from './bootstrap';

package/build/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./telemetry"), exports);
+__exportStar(require("./service-calls"), exports);
+__exportStar(require("./express-app"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./env"), exports);
+__exportStar(require("./config"), exports);
+__exportStar(require("./error"), exports);
+__exportStar(require("./bootstrap"), exports);
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B;AAC9B,0CAAwB;AACxB,wCAAsB;AACtB,2CAAyB;AACzB,0CAAwB;AACxB,8CAA4B"}

package/build/openapi.d.ts

@@ -0,0 +1,5 @@
+import * as OpenApiValidator from 'express-openapi-validator';
+import type { ServiceExpress } from './types';
+type OAPIOpts = Parameters<typeof OpenApiValidator.middleware>[0];
+export declare function openApi(app: ServiceExpress, rootDirectory: string, codepath: string, openApiOptions?: Partial<OAPIOpts>): import("express-openapi-validator/dist/framework/types").OpenApiRequestHandler[];
+export {};

package/build/openapi.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openApi = void 0;
+const path_1 = __importDefault(require("path"));
+const lodash_1 = __importDefault(require("lodash"));
+const OpenApiValidator = __importStar(require("express-openapi-validator"));
+const notImplementedHandler = (req, res) => {
+    res.status(501).json({
+        code: 'NotImplemented',
+        domain: 'http',
+        message: 'This method is not yet implemented',
+    });
+};
+function openApi(app, rootDirectory, codepath, openApiOptions) {
+    const apiSpec = path_1.default.resolve(rootDirectory, `./api/${app.locals.name}.yaml`);
+    app.locals.logger.debug({ apiSpec, codepath }, 'Serving OpenAPI');
+    const defaultOptions = {
+        apiSpec,
+        ignoreUndocumented: true,
+        validateRequests: {
+            allowUnknownQueryParameters: true,
+            coerceTypes: 'array',
+        },
+        operationHandlers: {
+            basePath: path_1.default.resolve(rootDirectory, `${codepath}/handlers`),
+            resolver(basePath, route) {
+                const pathKey = route.openApiRoute.substring(route.basePath.length);
+                const modulePath = path_1.default.join(basePath, pathKey);
+                try {
+                    // eslint-disable-next-line import/no-dynamic-require, global-require, @typescript-eslint/no-var-requires
+                    const module = require(modulePath);
+                    const method = Object.keys(module).find((m) => m.toUpperCase() === route.method);
+                    if (!method) {
+                        throw new Error(`Could not find a [${route.method}] function in ${modulePath} when trying to route [${route.method} ${route.expressRoute}].`);
+                    }
+                    return module[method];
+                }
+                catch (error) {
+                    app.locals.logger.error({
+                        error: error.message,
+                        pathKey,
+                        modulePath: path_1.default.relative(rootDirectory, modulePath),
+                    }, 'Failed to load API method handler');
+                    return notImplementedHandler;
+                }
+            },
+        },
+    };
+    return OpenApiValidator.middleware(lodash_1.default.defaultsDeep(defaultOptions, openApiOptions || {}));
+}
+exports.openApi = openApi;
+//# sourceMappingURL=openapi.js.map

package/build/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAwB;AAExB,oDAAuB;AACvB,4EAA8D;AAK9D,MAAM,qBAAqB,GAAY,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IAClD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,oCAAoC;KAC9C,CAAC,CAAC;AACL,CAAC,CAAC;AAIF,SAAgB,OAAO,CACrB,GAAmB,EACnB,aAAqB,EACrB,QAAgB,EAChB,cAAkC;IAElC,MAAM,OAAO,GAAG,cAAI,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC;IAC7E,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,iBAAiB,CAAC,CAAC;IAElE,MAAM,cAAc,GAAa;QAC/B,OAAO;QACP,kBAAkB,EAAE,IAAI;QACxB,gBAAgB,EAAE;YAChB,2BAA2B,EAAE,IAAI;YACjC,WAAW,EAAE,OAAO;SACrB;QACD,iBAAiB,EAAE;YACjB,QAAQ,EAAE,cAAI,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,QAAQ,WAAW,CAAC;YAC7D,QAAQ,CAAC,QAAgB,EAAE,KAAuE;gBAChG,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACpE,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAEhD,IAAI;oBACF,yGAAyG;oBACzG,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;oBACnC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC;oBACjF,IAAI,CAAC,MAAM,EAAE;wBACX,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,CAAC,MAAM,iBAAiB,UAAU,0BAA0B,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAC7H,CAAC;qBACH;oBACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;iBACvB;gBAAC,OAAO,KAAK,EAAE;oBACd,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CACrB;wBACE,KAAK,EAAG,KAAe,CAAC,OAAO;wBAC/B,OAAO;wBACP,UAAU,EAAE,cAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;qBACrD,EACD,mCAAmC,CACpC,CAAC;oBACF,OAAO,qBAAqB,CAAC;iBAC9B;YACH,CAAC;SACF;KACF,CAAC;IAEF,OAAO,gBAAgB,CAAC,UAAU,CAAC,gBAAC,CAAC,YAAY,CAAC,cAAc,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3F,CAAC;AAhDD,0BAgDC"}

package/build/service-calls/index.d.ts

@@ -0,0 +1,16 @@
+import type { FetchConfig, RestApiResponse } from 'rest-api-support';
+import { ServiceErrorSpec } from '../error';
+import type { ServiceExpress, ServiceLike, ServiceLocals } from '../types';
+/**
+ * Return a factory that will make instances of an OpenAPI/Swagger client for each request
+ */
+export declare function createServiceInterface<ServiceType>(service: ServiceExpress, name: string, Implementation: {
+    new (c: FetchConfig): ServiceType;
+}): ServiceType;
+interface SpecWithMessage extends ServiceErrorSpec {
+    message?: string;
+}
+export declare function throwOrGetResponse<SLocals extends ServiceLocals, AppType extends ServiceLike<SLocals>, ResType extends RestApiResponse<number, SuccessResponseType>, SuccessResponseType>(app: AppType, exec: () => Promise<ResType>, errorSpec?: SpecWithMessage): Promise<Extract<ResType, {
+    responseType: 'response';
+}>>;
+export {};