@openapi-typescript-infra/service 1.0.0

package/build/bootstrap.js

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bootstrap = void 0;
+const path_1 = __importDefault(require("path"));
+const dotenv_1 = __importDefault(require("dotenv"));
+const read_pkg_up_1 = __importDefault(require("read-pkg-up"));
+const env_1 = require("./env");
+const index_1 = require("./telemetry/index");
+function resolveMain(packageJson) {
+    if (typeof packageJson.main === 'string') {
+        return packageJson.main;
+    }
+    return undefined;
+}
+async function getServiceDetails(argv = {}) {
+    if (argv.name && argv.root) {
+        return {
+            rootDirectory: argv.root,
+            name: argv.name,
+            main: argv.main || ((0, env_1.isDev)() && !argv.built ? 'src/index.ts' : 'build/index.js'),
+        };
+    }
+    const cwd = argv.packageDir ? path_1.default.resolve(argv.packageDir) : process.cwd();
+    const pkg = await (0, read_pkg_up_1.default)({ cwd });
+    if (!pkg) {
+        throw new Error(`Unable to find package.json in ${cwd} to get main module. Make sure you are running from the package root directory.`);
+    }
+    const main = resolveMain(pkg.packageJson);
+    const parts = pkg.packageJson.name.split('/');
+    return {
+        main,
+        rootDirectory: path_1.default.dirname(pkg.path),
+        name: parts[parts.length - 1],
+    };
+}
+// Automagically start your app by using common patterns
+// to find your implementation and settings. This is most useful
+// for jobs or other scripts that need service infra but are
+// not simply the service
+async function bootstrap(argv) {
+    const { main, rootDirectory, name } = await getServiceDetails(argv);
+    let entrypoint;
+    let codepath = 'build';
+    if ((0, env_1.isDev)() && argv?.built !== true) {
+        // eslint-disable-next-line import/no-extraneous-dependencies
+        const { register } = await import('ts-node');
+        register();
+        if (main) {
+            entrypoint = main.replace(/^(\.?\/?)build\//, '$1src/').replace(/\.js$/, '.ts');
+        }
+        else {
+            entrypoint = './src/index.ts';
+        }
+        codepath = 'src';
+    }
+    else if (main) {
+        entrypoint = main;
+    }
+    else {
+        entrypoint = './build/index.js';
+    }
+    dotenv_1.default.config();
+    const absoluteEntrypoint = path_1.default.resolve(rootDirectory, entrypoint);
+    if (argv?.telemetry) {
+        return (0, index_1.startWithTelemetry)({
+            name,
+            rootDirectory,
+            service: absoluteEntrypoint,
+        });
+    }
+    // This needs to be required for TS on-the-fly to work
+    // eslint-disable-next-line global-require, import/no-dynamic-require, @typescript-eslint/no-var-requires
+    const impl = require(absoluteEntrypoint);
+    const opts = {
+        name,
+        rootDirectory,
+        service: impl.default || impl.service,
+        codepath,
+    };
+    // eslint-disable-next-line import/no-unresolved
+    const { startApp, listen } = await import('./express-app/app.js');
+    const app = await startApp(opts);
+    const server = argv?.nobind ? undefined : await listen(app);
+    return { server, app };
+}
+exports.bootstrap = bootstrap;
+//# sourceMappingURL=bootstrap.js.map

package/build/bootstrap.js.map

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

package/build/config/index.d.ts

@@ -0,0 +1,10 @@
+import type { ConfigStore } from './types';
+export interface ServiceConfigurationSpec {
+    rootDirectory: string;
+    configurationDirectories: string[];
+    name: string;
+}
+export declare function loadConfiguration({ name, configurationDirectories: dirs, rootDirectory, }: ServiceConfigurationSpec): Promise<ConfigStore>;
+export declare function insertConfigurationBefore(configDirs: string[] | undefined, insert: string, before: string): string[];
+export * from './schema';
+export * from './types';

package/build/config/index.js

@@ -0,0 +1,98 @@
+"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);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.insertConfigurationBefore = exports.loadConfiguration = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const confit_1 = __importDefault(require("@gasbuddy/confit"));
+const shortstops_1 = require("./shortstops");
+// Order matters here.
+const ENVIRONMENTS = ['production', 'staging', 'test', 'development'];
+async function pathExists(f) {
+    return new Promise((accept, reject) => {
+        fs_1.default.stat(f, (err) => {
+            if (!err) {
+                accept(true);
+            }
+            else if (err.code === 'ENOENT') {
+                accept(false);
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+}
+async function addDefaultConfiguration(configFactory, directory, envConfit) {
+    const addIfEnv = async (e) => {
+        const c = path_1.default.join(directory, `${e}.json`);
+        if (envConfit.get(`env:${e}`) && (await pathExists(c))) {
+            configFactory.addDefault(c);
+            return true;
+        }
+        return false;
+    };
+    await ENVIRONMENTS.reduce((runningPromise, environment) => runningPromise.then((prev) => prev || addIfEnv(environment)), Promise.resolve(false));
+    const baseConfig = path_1.default.join(directory, 'config.json');
+    if (await pathExists(baseConfig)) {
+        configFactory.addDefault(baseConfig);
+    }
+}
+async function loadConfiguration({ name, configurationDirectories: dirs, rootDirectory, }) {
+    const defaultProtocols = (0, shortstops_1.shortstops)({ name }, rootDirectory);
+    const specificConfig = dirs[dirs.length - 1];
+    // This confit version just gets us environment info
+    const envConfit = await new Promise((accept, reject) => {
+        (0, confit_1.default)(specificConfig).create((err, config) => (err ? reject(err) : accept(config)));
+    });
+    const configFactory = (0, confit_1.default)({
+        basedir: specificConfig,
+        protocols: defaultProtocols,
+    });
+    /**
+     * Note that in confit, when using addDefault,
+     * the FIRST addDefault takes precendence over the next (and so on), so
+     * if you override this method, you should register your defaults first.
+     */
+    const defaultOrder = dirs.slice(0, dirs.length - 1).reverse();
+    defaultOrder.push(path_1.default.join(__dirname, '../..', 'config'));
+    await defaultOrder.reduce((promise, dir) => promise.then(() => addDefaultConfiguration(configFactory, dir, envConfit)), Promise.resolve());
+    const loaded = await new Promise((accept, reject) => {
+        configFactory.create((err, config) => (err ? reject(err) : accept(config)));
+    });
+    // TODO init other stuff based on config here, such as key management or
+    // other cloud-aware shortstop handlers
+    return loaded;
+}
+exports.loadConfiguration = loadConfiguration;
+function insertConfigurationBefore(configDirs, insert, before) {
+    const copy = [...(configDirs || [])];
+    const index = copy.indexOf(before);
+    if (index === -1) {
+        copy.push(insert, before);
+    }
+    else {
+        copy.splice(index, 0, insert);
+    }
+    return copy;
+}
+exports.insertConfigurationBefore = insertConfigurationBefore;
+__exportStar(require("./schema"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/build/config/index.js.map

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

package/build/config/schema.d.ts

@@ -0,0 +1,48 @@
+import type { Level } from 'pino';
+export interface ServiceConfiguration {
+    protocol?: string;
+    port?: number;
+    host?: string;
+    basePath?: string;
+    proxy?: string | false;
+}
+export interface ConfigurationItemEnabled {
+    enabled?: boolean;
+}
+export interface ConfigurationSchema extends Record<string, unknown> {
+    trustProxy?: string[];
+    logging?: {
+        level?: Level;
+        logHttpRequests?: boolean;
+        logRequestBody?: boolean;
+        logResponseBody?: boolean;
+    };
+    routing?: {
+        openapi?: boolean;
+        routes?: string;
+        freezeQuery?: boolean;
+        etag?: boolean;
+        cookieParser?: boolean;
+        bodyParsers?: {
+            json?: boolean;
+            form?: boolean;
+        };
+        static?: ConfigurationItemEnabled & {
+            path?: string;
+            mountPath?: string;
+        };
+        finalHandlers: {
+            notFound?: boolean;
+            errors?: ConfigurationItemEnabled & {
+                render?: boolean;
+                unnest: boolean;
+            };
+        };
+    };
+    server?: {
+        internalPort?: number;
+        port?: number;
+        metrics: ConfigurationItemEnabled;
+    };
+    connections: Record<string, ServiceConfiguration>;
+}

package/build/config/schema.js

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

package/build/config/schema.js.map

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

package/build/config/shortstops.d.ts

@@ -0,0 +1,31 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import os from 'os';
+import { ProtocolFn } from '@gasbuddy/confit';
+declare const osMethods: {
+    hostname: typeof os.hostname;
+    platform: typeof os.platform;
+    type: typeof os.type;
+    version: typeof os.version;
+};
+export declare function shortstops(service: {
+    name: string;
+}, sourcedir: string): {
+    env: (envVarName: string) => string | undefined;
+    env_switch(v: string): boolean;
+    base64: (blob: string) => Buffer;
+    regex(v: string): RegExp;
+    path: (relativePath: string) => string;
+    sourcepath: (relativePath: string) => string;
+    file: (relativePath: string) => string | Buffer;
+    sourcefile: (relativePath: string) => string | Buffer;
+    require: (v: string) => any;
+    sourcerequire: (v: string) => any;
+    yaml: ProtocolFn<any>;
+    servicetype: (v: string) => boolean;
+    servicename: (v: string) => string;
+    os(p: keyof typeof osMethods): string;
+    dns: ProtocolFn<string>;
+    literal(v: string): string;
+};
+export {};

package/build/config/shortstops.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shortstops = void 0;
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const shortstop_handlers_1 = __importDefault(require("shortstop-handlers"));
+const shortstop_yaml_1 = __importDefault(require("shortstop-yaml"));
+const shortstop_dns_1 = __importDefault(require("shortstop-dns"));
+/**
+ * Default shortstop handlers for GasBuddy service configuration
+ */
+/**
+ * A require: shortstop that will dig and find a named function
+ * with a url-like hash pattern
+ */
+function betterRequire(basepath) {
+    const baseRequire = shortstop_handlers_1.default.require(basepath);
+    return function hashRequire(v) {
+        const [moduleName, func] = v.split('#');
+        const module = baseRequire(moduleName);
+        if (func) {
+            if (module[func]) {
+                return module[func];
+            }
+            return baseRequire(v);
+        }
+        return module;
+    };
+}
+/**
+ * Our convention is that service names end with:
+ *  -serv - a back end service not callable by the outside world and where no authorization occurs
+ *  -api - a non-UI front end service that exposes swagger and sometimes non-swagger APIs
+ *  -web - a UI front end service
+ *  -worker - a scheduled job or queue processor
+ *
+ * This shortstop will take a CSV of service types and tell you if this service is
+ * of that type, or if the first character after serviceType: is an exclamation point,
+ * whether it's NOT of any of the specified types
+ */
+function serviceTypeFactory(name) {
+    const type = name.split('-').pop();
+    return function serviceType(v) {
+        let checkValue = v;
+        let matchIsGood = true;
+        if (checkValue[0] === '!') {
+            matchIsGood = false;
+            checkValue = checkValue.substring(1);
+        }
+        const values = checkValue.split(',');
+        // Welp, there's no XOR so here we are.
+        return type && values.includes(type) ? matchIsGood : !matchIsGood;
+    };
+}
+const osMethods = {
+    hostname: os_1.default.hostname,
+    platform: os_1.default.platform,
+    type: os_1.default.type,
+    version: os_1.default.version,
+};
+function shortstops(service, sourcedir) {
+    /**
+     * Since we use transpiled sources a lot,
+     * basedir and sourcedir are meaningfully different reference points.
+     */
+    const basedir = path_1.default.join(sourcedir, '..');
+    const env = shortstop_handlers_1.default.env();
+    return {
+        env,
+        // A version of env that can default to false
+        env_switch(v) {
+            if (v && v[0] === '!') {
+                const bval = env(`${v.substring(1)}|b`);
+                return !bval;
+            }
+            return !!env(v);
+        },
+        base64: shortstop_handlers_1.default.base64(),
+        regex(v) {
+            const [, pattern, flags] = v.match(/^\/(.*)\/([a-z]*)/) || [];
+            return new RegExp(pattern, flags);
+        },
+        // handle source and base directory intelligently
+        path: shortstop_handlers_1.default.path(basedir),
+        sourcepath: shortstop_handlers_1.default.path(sourcedir),
+        file: shortstop_handlers_1.default.file(basedir),
+        sourcefile: shortstop_handlers_1.default.file(sourcedir),
+        require: betterRequire(basedir),
+        sourcerequire: betterRequire(sourcedir),
+        // Sometimes yaml is more pleasant for configuration
+        yaml: (0, shortstop_yaml_1.default)(basedir),
+        // Switch on service type
+        servicetype: serviceTypeFactory(service.name),
+        servicename: (v) => v.replace(/\$\{name\}/g, service.name),
+        os(p) {
+            return osMethods[p]();
+        },
+        dns: (0, shortstop_dns_1.default)(),
+        // No-op in case you have values that start with a shortstop handler name (and colon)
+        literal(v) {
+            return v;
+        },
+    };
+}
+exports.shortstops = shortstops;
+//# sourceMappingURL=shortstops.js.map

package/build/config/shortstops.js.map

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

package/build/config/types.d.ts

@@ -0,0 +1,3 @@
+export interface ConfigStore {
+    get<T>(name: string): T | undefined;
+}

package/build/config/types.js

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

package/build/config/types.js.map

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

package/build/development/port-finder.d.ts

@@ -0,0 +1 @@
+export declare function findPort(start: number): Promise<number | null>;

package/build/development/port-finder.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPort = void 0;
+const net_1 = __importDefault(require("net"));
+// Inspired by https://github.com/kessler/find-port/blob/master/lib/findPort.js
+async function isAvailable(port) {
+    return new Promise((accept, reject) => {
+        const server = net_1.default.createServer().listen(port);
+        const timeoutRef = setTimeout(() => {
+            accept(false);
+        }, 2000);
+        timeoutRef.unref();
+        server.once('listening', () => {
+            clearTimeout(timeoutRef);
+            server.close();
+            accept(true);
+        });
+        server.once('error', (err) => {
+            clearTimeout(timeoutRef);
+            if (err.code === 'EADDRINUSE') {
+                accept(false);
+                return;
+            }
+            reject(err);
+        });
+    });
+}
+async function findPort(start) {
+    for (let p = start; p < start + 1000; p += 1) {
+        // eslint-disable-next-line no-await-in-loop
+        if (await isAvailable(p)) {
+            return p;
+        }
+    }
+    return null;
+}
+exports.findPort = findPort;
+//# sourceMappingURL=port-finder.js.map

package/build/development/port-finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-finder.js","sourceRoot":"","sources":["../../src/development/port-finder.ts"],"names":[],"mappings":";;;;;;AAAA,8CAAsB;AAEtB,+EAA+E;AAC/E,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,aAAG,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE/C,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,EAAE,IAAI,CAAC,CAAC;QAET,UAAU,CAAC,KAAK,EAAE,CAAC;QAEnB,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,YAAY,CAAC,UAAU,CAAC,CAAC;YACzB,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC3B,YAAY,CAAC,UAAU,CAAC,CAAC;YAEzB,IAAK,GAA0B,CAAC,IAAI,KAAK,YAAY,EAAE;gBACrD,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,OAAO;aACR;YAED,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAEM,KAAK,UAAU,QAAQ,CAAC,KAAa;IAC1C,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE;QAC5C,4CAA4C;QAC5C,IAAI,MAAM,WAAW,CAAC,CAAC,CAAC,EAAE;YACxB,OAAO,CAAC,CAAC;SACV;KACF;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AARD,4BAQC"}

package/build/development/repl.d.ts

@@ -0,0 +1,2 @@
+import { ServiceExpress } from '../types';
+export declare function serviceRepl(app: ServiceExpress, onExit: () => void): void;

package/build/development/repl.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serviceRepl = void 0;
+const repl_1 = __importDefault(require("repl"));
+const path_1 = __importDefault(require("path"));
+function serviceRepl(app, onExit) {
+    const rl = repl_1.default.start({
+        prompt: '> ',
+    });
+    Object.assign(rl.context, app.locals, {
+        app,
+        dump(o) {
+            // eslint-disable-next-line no-console
+            console.log(JSON.stringify(o, null, '\t'));
+        },
+    });
+    rl.setupHistory(path_1.default.resolve('.node_repl_history'), (err) => {
+        if (err) {
+            // eslint-disable-next-line no-console
+            console.error('History setup failed', err);
+        }
+    });
+    rl.on('exit', onExit);
+}
+exports.serviceRepl = serviceRepl;
+//# sourceMappingURL=repl.js.map

package/build/development/repl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.js","sourceRoot":"","sources":["../../src/development/repl.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,gDAAwB;AAIxB,SAAgB,WAAW,CAAC,GAAmB,EAAE,MAAkB;IACjE,MAAM,EAAE,GAAG,cAAI,CAAC,KAAK,CAAC;QACpB,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QACpC,GAAG;QACH,IAAI,CAAC,CAAU;YACb,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC,CAAC;IACH,EAAE,CAAC,YAAY,CAAC,cAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;QAC1D,IAAI,GAAG,EAAE;YACP,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;SAC5C;IACH,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxB,CAAC;AAlBD,kCAkBC"}

package/build/env.d.ts

@@ -0,0 +1,2 @@
+export declare function getNodeEnv(): string | undefined;
+export declare function isDev(): boolean;

package/build/env.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDev = exports.getNodeEnv = void 0;
+function getNodeEnv() {
+    switch (process.env.APP_ENV || process.env.NODE_ENV) {
+        case 'production':
+        case 'staging':
+        case 'test':
+            return process.env.APP_ENV || process.env.NODE_ENV;
+        default:
+            return 'development';
+    }
+}
+exports.getNodeEnv = getNodeEnv;
+function isDev() {
+    return getNodeEnv() === 'development';
+}
+exports.isDev = isDev;
+//# sourceMappingURL=env.js.map

package/build/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":";;;AAAA,SAAgB,UAAU;IACxB,QAAQ,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE;QACnD,KAAK,YAAY,CAAC;QAClB,KAAK,SAAS,CAAC;QACf,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QACrD;YACE,OAAO,aAAa,CAAC;KACxB;AACH,CAAC;AATD,gCASC;AAED,SAAgB,KAAK;IACnB,OAAO,UAAU,EAAE,KAAK,aAAa,CAAC;AACxC,CAAC;AAFD,sBAEC"}

package/build/error.d.ts

@@ -0,0 +1,25 @@
+import type { ServiceLike, ServiceLocals } from './types';
+export interface ServiceErrorSpec {
+    status?: number;
+    code?: string;
+    domain?: string;
+    display_message?: string;
+    log_stack?: boolean;
+    expected_error?: boolean;
+}
+/**
+ * An error that gives more structured information to callers. Throw inside a handler as
+ *
+ *   throw new Error(req, 'Something broke', { code: 'SomethingBroke', status: 400 });
+ *
+ * You can also include a display_message which is intended to be viewed by the end user
+ */
+export declare class ServiceError extends Error {
+    status: number | undefined;
+    code?: string;
+    domain: string;
+    display_message?: string;
+    log_stack?: boolean;
+    expected_error?: boolean;
+    constructor(app: ServiceLike<ServiceLocals>, message: string, spec?: ServiceErrorSpec);
+}

package/build/error.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceError = void 0;
+/**
+ * An error that gives more structured information to callers. Throw inside a handler as
+ *
+ *   throw new Error(req, 'Something broke', { code: 'SomethingBroke', status: 400 });
+ *
+ * You can also include a display_message which is intended to be viewed by the end user
+ */
+class ServiceError extends Error {
+    status;
+    code;
+    domain;
+    display_message;
+    log_stack;
+    // If true, this shouldn't be logged as an error, but as an info log.
+    // This is common when the error needs to go to the client, but should not
+    // take up the valuable mental space of an error log.
+    expected_error;
+    constructor(app, message, spec) {
+        super(message);
+        this.domain = app.locals.name;
+        Object.assign(this, spec);
+    }
+}
+exports.ServiceError = ServiceError;
+//# sourceMappingURL=error.js.map

package/build/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":";;;AAWA;;;;;;GAMG;AACH,MAAa,YAAa,SAAQ,KAAK;IAC9B,MAAM,CAAqB;IAE3B,IAAI,CAAU;IAEd,MAAM,CAAS;IAEf,eAAe,CAAU;IAEzB,SAAS,CAAW;IAE3B,qEAAqE;IACrE,0EAA0E;IAC1E,qDAAqD;IAC9C,cAAc,CAAW;IAEhC,YACE,GAA+B,EAC/B,OAAe,EACf,IAAuB;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF;AAzBD,oCAyBC"}

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

@@ -0,0 +1,6 @@
+/// <reference types="node" />
+import http from 'http';
+import type { RequestLocals, ServiceExpress, ServiceLocals, ServiceStartOptions } from '../types';
+export declare function startApp<SLocals extends ServiceLocals = ServiceLocals, RLocals extends RequestLocals = RequestLocals>(startOptions: ServiceStartOptions<SLocals, RLocals>): Promise<ServiceExpress<SLocals>>;
+export declare function shutdownApp(app: ServiceExpress): Promise<void>;
+export declare function listen<SLocals extends ServiceLocals = ServiceLocals>(app: ServiceExpress<SLocals>, shutdownHandler?: () => Promise<void>): Promise<http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>>;