feat(http): add a method hook when http/s server is attached to the app, update deps

Author: djMax

package.json

@@ -59,50 +59,50 @@
   "homepage": "https://github.com/openapi-typescript-infra/service#readme",
   "dependencies": {
     "@godaddy/terminus": "^4.12.1",
-    "@opentelemetry/api": "^1.8.0",
-    "@opentelemetry/exporter-prometheus": "^0.51.0",
-    "@opentelemetry/instrumentation-dns": "^0.36.0",
-    "@opentelemetry/instrumentation-express": "^0.38.0",
-    "@opentelemetry/instrumentation-generic-pool": "^0.36.0",
-    "@opentelemetry/instrumentation-graphql": "^0.40.0",
-    "@opentelemetry/instrumentation-http": "^0.51.0",
-    "@opentelemetry/instrumentation-ioredis": "^0.40.0",
-    "@opentelemetry/instrumentation-net": "^0.36.0",
-    "@opentelemetry/instrumentation-pg": "^0.41.0",
-    "@opentelemetry/instrumentation-pino": "^0.38.0",
-    "@opentelemetry/instrumentation-undici": "^0.2.0",
-    "@opentelemetry/resource-detector-container": "^0.3.9",
-    "@opentelemetry/resource-detector-gcp": "^0.29.9",
-    "@opentelemetry/sdk-node": "^0.51.0",
-    "@opentelemetry/semantic-conventions": "^1.24.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-prometheus": "^0.52.0",
+    "@opentelemetry/instrumentation-dns": "^0.37.0",
+    "@opentelemetry/instrumentation-express": "^0.40.0",
+    "@opentelemetry/instrumentation-generic-pool": "^0.37.0",
+    "@opentelemetry/instrumentation-graphql": "^0.41.0",
+    "@opentelemetry/instrumentation-http": "^0.52.0",
+    "@opentelemetry/instrumentation-ioredis": "^0.41.0",
+    "@opentelemetry/instrumentation-net": "^0.37.0",
+    "@opentelemetry/instrumentation-pg": "^0.42.0",
+    "@opentelemetry/instrumentation-pino": "^0.40.0",
+    "@opentelemetry/instrumentation-undici": "^0.3.0",
+    "@opentelemetry/resource-detector-container": "^0.3.10",
+    "@opentelemetry/resource-detector-gcp": "^0.29.10",
+    "@opentelemetry/sdk-node": "^0.52.0",
+    "@opentelemetry/semantic-conventions": "^1.25.0",
     "@sesamecare-oss/confit": "^2.2.1",
     "@sesamecare-oss/opentelemetry-node-metrics": "^1.0.1",
-    "ajv": "^8.12.0",
+    "ajv": "^8.16.0",
     "cookie-parser": "^1.4.6",
     "dotenv": "^16.4.5",
     "express": "^5.0.0-beta.3",
-    "express-openapi-validator": "^5.1.6",
+    "express-openapi-validator": "^5.2.0",
     "glob": "^8.1.0",
     "lodash": "^4.17.21",
     "minimist": "^1.2.8",
-    "pino": "^9.0.0",
+    "pino": "^9.1.0",
     "read-pkg-up": "^7.0.1",
     "request-ip": "^3.3.0"
   },
   "devDependencies": {
     "@commitlint/cli": "^19.3.0",
     "@commitlint/config-conventional": "^19.2.2",
     "@openapi-typescript-infra/coconfig": "^4.4.0",
-    "@semantic-release/commit-analyzer": "^12.0.0",
+    "@semantic-release/commit-analyzer": "^13.0.0",
     "@semantic-release/exec": "^6.0.3",
-    "@semantic-release/github": "^10.0.3",
-    "@semantic-release/release-notes-generator": "^13.0.0",
+    "@semantic-release/github": "^10.0.6",
+    "@semantic-release/release-notes-generator": "^14.0.0",
     "@types/cookie-parser": "^1.4.7",
     "@types/express": "^4.17.21",
     "@types/glob": "^8.1.0",
-    "@types/lodash": "^4.17.0",
+    "@types/lodash": "^4.17.5",
     "@types/minimist": "^1.2.5",
-    "@types/node": "^20.12.7",
+    "@types/node": "^20.14.2",
     "@types/request-ip": "^0.0.41",
     "@types/supertest": "^6.0.2",
     "@typescript-eslint/eslint-plugin": "^6.21.0",
@@ -111,13 +111,13 @@
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-import": "^2.29.1",
-    "pino-pretty": "^11.0.0",
+    "pino-pretty": "^11.1.0",
     "pinst": "^3.0.0",
     "supertest": "^7.0.0",
     "ts-node": "^10.9.2",
     "tsconfig-paths": "^4.2.0",
     "typescript": "^5.4.5",
-    "vitest": "^1.5.2"
+    "vitest": "^1.6.0"
   },
   "resolutions": {
     "qs": "^6.11.0"

src/express-app/app.ts

@@ -303,6 +303,8 @@ export async function listen<SLocals extends AnyServiceLocals = ServiceLocals<Co
 
   const { service, logger } = app.locals;
   const server = httpServer(app, config);
+  await app.locals.service.attachServer?.(server);
+
   let shutdownInProgress = false;
   createTerminus(server, {
     timeout: 15000,

src/types.ts

@@ -76,6 +76,9 @@ export interface Service<
   // that are needed during route setup
   attach?: (app: ServiceExpress<SLocals>) => void | Promise<void>;
 
+  // Called after a server is created but before the server starts listening
+  attachServer?: (server: Server) => void | Promise<void>;
+
   start(app: ServiceExpress<SLocals>): void | Promise<void>;
 
   stop?: (app: ServiceExpress<SLocals>) => void | Promise<void>;