node-last-wish 1.0.0

package/README.md

@@ -0,0 +1,52 @@
+# node-last-wish
+
+A tiny NestJS utility that registers process signal handlers for graceful shutdown.
+
+## Install
+
+```bash
+npm install node-last-wish
+```
+
+Requires `@nestjs/common` ≥ 9 as a peer dependency.
+
+## Usage
+
+```ts
+import { registerCrashHandlers } from 'node-last-wish';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  await app.listen(3000);
+
+  registerCrashHandlers(app, {
+    onShutdown: async () => {
+      // close DB connections, flush logs, etc.
+    },
+  });
+}
+
+bootstrap();
+```
+
+## API
+
+### `registerCrashHandlers(app, opts?)`
+
+Registers handlers for `uncaughtException`, `unhandledRejection`, and `SIGTERM`.
+On any of these events the process will:
+1. Run the optional `onShutdown` hook.
+2. Close the NestJS application (`app.close()`).
+3. Exit with code `1` (errors) or `0` (SIGTERM).
+
+| Parameter | Type | Description |
+|---|---|---|
+| `app` | `INestApplication` | The NestJS application instance. |
+| `opts.logger` | `{ error(...) }` | Custom logger. Defaults to `console`. |
+| `opts.onShutdown` | `() => Promise<void>` | Optional cleanup hook run before closing the app. |
+
+## Build
+
+```bash
+npm run build
+```

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { INestApplication } from "@nestjs/common";
+export interface GracefulShutdownOptions {
+    logger?: {
+        error: (msg: string, ...args: any[]) => void;
+    };
+    onShutdown?: () => Promise<void>;
+}
+export declare function registerCrashHandlers(app: INestApplication, opts?: GracefulShutdownOptions): void;

package/dist/index.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCrashHandlers = registerCrashHandlers;
+async function gracefulShutdown(app, opts) {
+    var _a;
+    const log = (_a = opts === null || opts === void 0 ? void 0 : opts.logger) !== null && _a !== void 0 ? _a : console;
+    try {
+        if (opts === null || opts === void 0 ? void 0 : opts.onShutdown)
+            await opts.onShutdown();
+        await app.close();
+    }
+    catch (e) {
+        log.error("Error during graceful shutdown", e);
+    }
+}
+function registerCrashHandlers(app, opts) {
+    var _a;
+    const log = (_a = opts === null || opts === void 0 ? void 0 : opts.logger) !== null && _a !== void 0 ? _a : console;
+    process.on("uncaughtException", async (err) => {
+        log.error("uncaughtException", err);
+        await gracefulShutdown(app, opts);
+        process.exit(1);
+    });
+    process.on("unhandledRejection", async (reason) => {
+        log.error("unhandledRejection", reason);
+        await gracefulShutdown(app, opts);
+        process.exit(1);
+    });
+    process.on("SIGTERM", async () => {
+        log.error("SIGTERM received");
+        await gracefulShutdown(app, opts);
+        process.exit(0);
+    });
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "node-last-wish",
+  "version": "1.0.0",
+  "description": "Graceful shutdown handlers for NestJS — catches uncaughtException, unhandledRejection, and SIGTERM",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "nestjs",
+    "graceful-shutdown",
+    "shutdown",
+    "sigterm",
+    "crash-handler"
+  ],
+  "author": "Nil Golan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Nil9711/node-last-wish.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Nil9711/node-last-wish/issues"
+  },
+  "homepage": "https://github.com/Nil9711/node-last-wish#readme",
+  "scripts": {
+    "build": "tsc"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=9.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^9.0.0",
+    "@types/node": "^25.2.3",
+    "typescript": "^5.9.3"
+  }
+}