@openapi-typescript-infra/service 4.1.0 → 4.2.0

package/build/types.d.ts

@@ -17,6 +17,7 @@ export type ServiceLogger = pino.BaseLogger & Pick<pino.Logger, 'isLevelEnabled'
 export interface ServiceLocals<Config extends ConfigurationSchema = ConfigurationSchema> {
     service: Service;
     name: string;
+    version: string;
     logger: ServiceLogger;
     config: Config;
     meter: Meter;
@@ -53,6 +54,7 @@ export interface Service<SLocals extends AnyServiceLocals = ServiceLocals<Config
 export type ServiceFactory<SLocals extends AnyServiceLocals = ServiceLocals<ConfigurationSchema>, RLocals extends RequestLocals = RequestLocals> = () => Service<SLocals, RLocals>;
 export interface ServiceStartOptions<SLocals extends AnyServiceLocals = ServiceLocals<ConfigurationSchema>, RLocals extends RequestLocals = RequestLocals> {
     name: string;
+    version: string;
     rootDirectory: string;
     codepath?: 'build' | 'src' | 'dist';
     locals?: Partial<SLocals>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openapi-typescript-infra/service",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "An opinionated framework for building configuration driven services - web, api, or  ob. Uses OpenAPI, pino logging, express, confit, Typescript and vitest.",
   "main": "build/index.js",
   "scripts": {
@@ -80,7 +80,7 @@
     "@opentelemetry/sdk-node": "^0.43.0",
     "@opentelemetry/sdk-trace-base": "^1.17.1",
     "@opentelemetry/semantic-conventions": "^1.17.1",
-    "@sesamecare-oss/confit": "^2.0.0",
+    "@sesamecare-oss/confit": "^2.0.1",
     "@sesamecare-oss/opentelemetry-node-metrics": "^1.0.1",
     "cookie-parser": "^1.4.6",
     "dotenv": "^16.3.1",
@@ -96,7 +96,7 @@
   "devDependencies": {
     "@commitlint/cli": "^17.8.0",
     "@commitlint/config-conventional": "^17.8.0",
-    "@openapi-typescript-infra/coconfig": "^4.2.1",
+    "@openapi-typescript-infra/coconfig": "^4.2.2",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^11.0.0",
     "@semantic-release/exec": "^6.0.3",
@@ -108,7 +108,7 @@
     "@types/lodash": "^4.14.200",
     "@types/minimist": "^1.2.4",
     "@types/node": "^20.8.7",
-    "@types/supertest": "^2.0.14",
+    "@types/supertest": "^2.0.15",
     "@typescript-eslint/eslint-plugin": "^6.8.0",
     "@typescript-eslint/parser": "^6.8.0",
     "coconfig": "^1.0.0",

package/src/bootstrap.ts

@@ -25,6 +25,8 @@ interface BootstrapArguments {
   telemetry?: boolean;
   // Don't bind to http port or expose metrics
   nobind?: boolean;
+  // The version of the app, else discovered via read-pkg-up
+  version?: string;
 }
 
 function resolveMain(packageJson: NormalizedPackageJson) {
@@ -39,6 +41,7 @@ async function getServiceDetails(argv: BootstrapArguments = {}) {
     return {
       rootDirectory: argv.root,
       name: argv.name,
+      version: argv.version || '0.0.0',
       main: argv.main || (isDev() && !argv.built ? 'src/index.ts' : 'build/index.js'),
     };
   }
@@ -55,6 +58,7 @@ async function getServiceDetails(argv: BootstrapArguments = {}) {
     main,
     rootDirectory: path.dirname(pkg.path),
     name: parts[parts.length - 1],
+    version: pkg.packageJson.version,
   };
 }
 
@@ -72,7 +76,7 @@ export async function bootstrap<
   SLocals extends AnyServiceLocals = ServiceLocals<ConfigurationSchema>,
   RLocals extends RequestLocals = RequestLocals,
 >(argv?: BootstrapArguments) {
-  const { main, rootDirectory, name } = await getServiceDetails(argv);
+  const { main, rootDirectory, name, version } = await getServiceDetails(argv);
 
   let entrypoint: string;
   let codepath: 'build' | 'dist' | 'src' = 'build';
@@ -107,6 +111,7 @@ export async function bootstrap<
       rootDirectory,
       service: absoluteEntrypoint,
       codepath,
+      version,
     });
   }
 
@@ -115,6 +120,7 @@ export async function bootstrap<
   const impl = require(absoluteEntrypoint);
   const opts: ServiceStartOptions<SLocals, RLocals> = {
     name,
+    version,
     rootDirectory,
     service: impl.default || impl.service,
     codepath,

package/src/express-app/app.ts

@@ -45,7 +45,7 @@ export async function startApp<
   SLocals extends AnyServiceLocals = ServiceLocals<ConfigurationSchema>,
   RLocals extends RequestLocals = RequestLocals,
 >(startOptions: ServiceStartOptions<SLocals, RLocals>): Promise<ServiceExpress<SLocals>> {
-  const { service, rootDirectory, codepath = 'build', name } = startOptions;
+  const { service, rootDirectory, codepath = 'build', name, version } = startOptions;
   const shouldPrettyPrint = isDev() && !process.env.NO_PRETTY_LOGS;
   const destination = pino.destination({
     sync: isSyncLogging(),
@@ -99,11 +99,12 @@ export async function startApp<
     app.disable('etag');
   }
 
-  Object.assign(app.locals, { services: {} }, startOptions.locals, {
+  Object.assign(app.locals, startOptions.locals, {
     service: serviceImpl,
     logger,
     config,
     name,
+    version,
   });
 
   if (serviceImpl.attach) {

package/src/types.ts

@@ -24,6 +24,7 @@ export type ServiceLogger = pino.BaseLogger & Pick<pino.Logger, 'isLevelEnabled'
 export interface ServiceLocals<Config extends ConfigurationSchema = ConfigurationSchema> {
   service: Service;
   name: string;
+  version: string;
   logger: ServiceLogger;
   config: Config;
   meter: Meter;
@@ -115,6 +116,7 @@ export interface ServiceStartOptions<
   RLocals extends RequestLocals = RequestLocals,
 > {
   name: string;
+  version: string;
   rootDirectory: string;
 
   // Defaults to "build", but can be set to "src" to run off non-built source