@devmoods/express-extras 0.28.0 → 0.28.1

package/README.md

@@ -35,19 +35,3 @@ _Extremely opinionated_ set of utilities for cranking out production-ready Node.
 ## Configure
 
 Put environment variables in `.env` at the application will automatically read those on startup. For test configuration in unit and integrations tests, use `.env.test`.
-
-```bash
-NODE_ENV=development
-PORT=3000
-READINESS_PROBE_MS=
-FORCE_EXIT_TIMEOUT=
-
-AUTH_JWT_SECRET=123456
-
-POSTGRES_URL=postgresql://user:pass@localhost:5432/my_database
-REDIS_URL=
-
-SLACK_WEBHOOK_URL=
-SENTRY_DSN=
-SLACK_WEBHOOK_URL=
-```

package/dist/listen.d.ts

@@ -11,7 +11,7 @@ interface ExpressServerOptions {
     healthCheck?(): Promise<unknown>;
 }
 export declare function createExpressServer(app: Application, options?: ExpressServerOptions): {
-    start(): void;
+    start(): Promise<void>;
     stop(): Promise<boolean>;
     terminate(): Promise<void>;
     readonly port: number;

package/dist/listen.js

@@ -4,8 +4,8 @@ import { getLogger } from './logger.js';
 import { route } from './middleware.js';
 import { envPort, readEnv } from './utils.js';
 const logger = getLogger('http');
-const READINESS_PERIOD_MS = readEnv.number('READINESS_PERIOD_MS', 0);
-const FORCE_EXIT_TIMEOUT = readEnv.number('FORCE_EXIT_TIMEOUT', 5000);
+const READINESS_PERIOD = readEnv.number('READINESS_PERIOD_MS', 0);
+const GRACE_PERIOD = readEnv.number('GRACE_PERIOD_MS', 20000);
 export function stoppable(server, grace = Infinity) {
     let stopped = false;
     let gracefully = true;
@@ -69,7 +69,7 @@ export function stoppable(server, grace = Infinity) {
     return server;
 }
 export function createExpressServer(app, options = {}) {
-    const server = stoppable(http.createServer(app), FORCE_EXIT_TIMEOUT);
+    const server = stoppable(http.createServer(app), GRACE_PERIOD);
     let stopping = false;
     async function onSignal(signal) {
         if (stopping) {
@@ -78,7 +78,7 @@ export function createExpressServer(app, options = {}) {
         stopping = true;
         try {
             logger.info(`app shutting down due to ${signal}`);
-            await delay(READINESS_PERIOD_MS + 1000);
+            await delay(READINESS_PERIOD + 1000);
             await server.stop();
             await options.onShutdown?.();
             logger.info('app shut down');
@@ -108,8 +108,11 @@ export function createExpressServer(app, options = {}) {
     return {
         start() {
             const port = app.get('port') ?? envPort(0);
-            server.listen(port, () => {
-                logger.info('app listening', { port: this.port });
+            return new Promise((resolve) => {
+                server.listen(port, () => {
+                    logger.info('app listening', { port: this.port });
+                    resolve();
+                });
             });
         },
         stop() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devmoods/express-extras",
-  "version": "0.28.0",
+  "version": "0.28.1",
   "description": "Kubernetes-ready utilities for rapid Node.js application development",
   "type": "module",
   "main": "./dist/index.js",