@drunkcod/express-kit 0.0.5

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+import type express from 'express';
+export * from '@drunkcod/express-async';
+export * from './loggable';
+export declare function onceAsync<T>(fn: () => Promise<T>): () => Promise<T>;
+type ExpressServer = ReturnType<express.Application['listen']>;
+export declare function registerShutdown<Server extends ExpressServer = ExpressServer>(server: Server, shutdown?: () => Promise<void>): void;

package/lib/index.js

@@ -0,0 +1,47 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onceAsync = onceAsync;
+exports.registerShutdown = registerShutdown;
+__exportStar(require("@drunkcod/express-async"), exports);
+__exportStar(require("./loggable"), exports);
+function onceAsync(fn) {
+    let p;
+    return () => {
+        if (p)
+            return p;
+        p = fn();
+        fn = () => p;
+        return p;
+    };
+}
+const closeAsync = (server) => (new Promise((resolve, reject) => {
+    server.close((err) => {
+        if (err)
+            reject(err);
+        else
+            resolve();
+    });
+}));
+function registerShutdown(server, shutdown) {
+    shutdown = onceAsync(async () => {
+        await closeAsync(server);
+        if (shutdown)
+            await shutdown();
+    });
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}

package/lib/loggable.d.ts

@@ -0,0 +1,2 @@
+export declare function at(message?: string): string;
+export declare function asLoggableError(error: unknown): object;

package/lib/loggable.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.at = at;
+exports.asLoggableError = asLoggableError;
+const argis_1 = require("@drunkcod/argis");
+function at(message) {
+    const old = Error.stackTraceLimit;
+    try {
+        const r = { stack: '' };
+        Error.stackTraceLimit = 1;
+        Error.captureStackTrace(r, at);
+        message = message ? `${message} ` : '';
+        return message + r.stack.substring(10);
+    }
+    finally {
+        Error.stackTraceLimit = old;
+    }
+}
+function asLoggableCause(cause) {
+    if (cause == null || typeof cause !== 'object')
+        return cause;
+    if (cause instanceof Error) {
+        const { message, stack, cause: innerCause, ...rest } = cause;
+        return innerCause
+            ? { message, stack, cause: asLoggableCause(innerCause), ...rest }
+            : { message, stack, ...rest };
+    }
+    if ((0, argis_1.hasOwn)(cause, 'cause')) {
+        const { cause: innerCause, ...rest } = cause;
+        return { ...rest, cause: asLoggableCause(innerCause) };
+    }
+    return { ...cause };
+}
+function asLoggableError(error) {
+    if (error instanceof Error)
+        return asLoggableCause(error);
+    const r = (error && typeof error === 'object') ? asLoggableCause(error) : { message: error };
+    Error.captureStackTrace(r, asLoggableError);
+    return Object.defineProperty(r, 'stack', { enumerable: true });
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@drunkcod/express-kit",
+  "version": "0.0.5",
+  "description": "Express4 utility things",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib/**/*",
+    "!lib/**/*.spec.*"
+  ],
+  "scripts": {
+    "test": "jest",
+    "build": "rimraf lib && tsc"
+  },
+  "keywords": [
+    "express"
+  ],
+  "author": "Tobbe Gyllebring",
+  "license": "MIT",
+  "workspaces": [
+    "express-async"
+  ],
+  "dependencies": {
+    "@drunkcod/argis": "^0.0.2"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.7.0",
+    "@types/node": "^22.5.4",
+    "jest": "^29.7.0",
+    "rimraf": "^5.0.10",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.5.4"
+  }
+}