@andrew_l/graceful 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2024 Andrew L. <andrew.io.dev@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# Description
+
+Gracefully shuts down the application using dependencies.
+
+[Documentation](https://men232.github.io/toolkit/reference/@andrew_l/graceful/)
+
+# Usage
+
+```js
+import { onShutdown } from '@andrew_l/graceful';
+
+onShutdown('mongoose', ['http-server'], async () => {
+  console.info('Graceful: mongodb connection.');
+  await mongoose.disconnect();
+});
+
+onShutdown('http-server', async () => {
+  console.info('Graceful: http server.');
+  await httpServer.close();
+});
+```

package/dist/index.cjs

@@ -0,0 +1,156 @@
+'use strict';
+
+const toolkit = require('@andrew_l/toolkit');
+
+const log = toolkit.logger("Graceful Shutdown");
+const HANDLED_EVENTS = Object.freeze(["SIGINT", "SIGTERM", "SIGQUIT"]);
+const DEPENDENCY_TREE = /* @__PURE__ */ new Map();
+const DEPENDENCY_MAP = /* @__PURE__ */ new WeakMap();
+const HANDLERS_MAP = /* @__PURE__ */ new Map();
+const SHUTDOWN_ERROR_HANDLERS = [];
+let shuttingDown = false;
+function onShutdown(...args) {
+  const [_name, _dependencies, _handler] = args;
+  const handler = toolkit.isFunction(_name) ? _name : toolkit.isFunction(_dependencies) ? _dependencies : _handler;
+  const dependencies = Array.isArray(_name) ? _name : Array.isArray(_dependencies) ? _dependencies : [];
+  const name = toolkit.isString(_name) ? _name : Math.random().toString(36);
+  if (shuttingDown) {
+    log.warn(
+      "Warn! Attempt to register handler while processing terminating: %s",
+      name
+    );
+    return toolkit.noop;
+  }
+  if (dependencies.reduce((acc, dep) => acc || testForCycles(dep), false)) {
+    throw new Error(
+      `Adding shutdown handler "${name}" will create a dependency loop: aborting`
+    );
+  }
+  log.debug("Register handler: %s", name);
+  DEPENDENCY_TREE.set(
+    name,
+    /* @__PURE__ */ new Set([...DEPENDENCY_TREE.get(name) || [], ...dependencies])
+  );
+  DEPENDENCY_MAP.set(handler, dependencies);
+  if (!HANDLERS_MAP.has(name)) {
+    HANDLERS_MAP.set(name, []);
+  }
+  HANDLERS_MAP.get(name).push(handler);
+  return () => {
+    const handlersList = (HANDLERS_MAP.get(name) ?? []).filter(
+      (v) => v !== handler
+    );
+    if (!handlersList.length) {
+      HANDLERS_MAP.delete(name);
+    }
+    const renewDependencies = new Set(
+      handlersList.map((v) => DEPENDENCY_MAP.get(v)).flat().filter(toolkit.isString)
+    );
+    if (renewDependencies.size) {
+      DEPENDENCY_TREE.set(name, renewDependencies);
+    } else {
+      DEPENDENCY_TREE.delete(name);
+    }
+    DEPENDENCY_MAP.delete(handler);
+  };
+}
+function onShutdownError(callback) {
+  SHUTDOWN_ERROR_HANDLERS.push(callback);
+  return () => {
+    const idx = SHUTDOWN_ERROR_HANDLERS.indexOf(callback);
+    if (idx > -1) {
+      SHUTDOWN_ERROR_HANDLERS.splice(idx, 1);
+    }
+  };
+}
+function processGraceful(signal = "SIGTERM") {
+  log.warn("Force with signal: %s", signal);
+  process.emit("SIGTERM", signal);
+}
+async function shutdown(name, promisesMap) {
+  if (promisesMap.has(name)) {
+    return promisesMap.get(name);
+  }
+  const q = toolkit.defer();
+  promisesMap.set(name, q.promise);
+  let lastError;
+  try {
+    const dependencies = DEPENDENCY_TREE.get(name);
+    if (dependencies) {
+      await Promise.all(
+        Array.from(dependencies).map(
+          (dep) => shutdown(dep, promisesMap).catch((err) => lastError = err)
+        )
+      );
+    }
+    const allHandlers = HANDLERS_MAP.get(name);
+    if (allHandlers?.length) {
+      const timeoutInterval = setInterval(() => {
+        log.warn("Long shutdown %s", name);
+      }, 3e3);
+      await toolkit.asyncForEach(
+        allHandlers,
+        async (fn) => {
+          try {
+            await fn();
+          } catch (err) {
+            lastError = err;
+          }
+        },
+        { concurrency: 10 }
+      );
+      clearTimeout(timeoutInterval);
+    }
+  } catch (err) {
+    lastError = err;
+  }
+  if (lastError) {
+    q.reject(lastError);
+  } else {
+    q.resolve();
+  }
+  return q.promise;
+}
+for (const eventName of HANDLED_EVENTS) {
+  process.removeAllListeners(eventName).addListener(eventName, () => {
+    log.debug("Received signal: %s", eventName);
+    onShutdownEvent();
+  });
+}
+function onShutdownEvent() {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  const unreferencedNames = getAllUnreferencedNames();
+  const visited = /* @__PURE__ */ new Map();
+  Promise.all(unreferencedNames.map((name) => shutdown(name, visited))).then(() => exit(0)).catch((e) => {
+    Promise.all(SHUTDOWN_ERROR_HANDLERS.map((f) => f(e))).then(() => exit(42759)).catch(() => exit(42758));
+  });
+}
+function testForCycles(name, visitedSet = /* @__PURE__ */ new Set()) {
+  if (visitedSet.has(name)) return true;
+  visitedSet.add(name);
+  const dependencies = DEPENDENCY_TREE.get(name);
+  if (!dependencies) return false;
+  for (const dependencyName of dependencies.values()) {
+    if (testForCycles(dependencyName, visitedSet)) return true;
+  }
+  return false;
+}
+function getAllUnreferencedNames() {
+  const result = new Set(Array.from(DEPENDENCY_TREE.keys()));
+  for (const dependencies of DEPENDENCY_TREE.values()) {
+    for (const dependencyName of dependencies.values()) {
+      result.delete(dependencyName);
+    }
+  }
+  return Array.from(result);
+}
+function exit(code) {
+  log.info("Shutdown with code: %d", code ?? 0);
+  process.exit(code);
+}
+
+exports.onShutdown = onShutdown;
+exports.onShutdownError = onShutdownError;
+exports.processGraceful = processGraceful;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["import {\n  type AnyFunction,\n  asyncForEach,\n  defer,\n  isFunction,\n  isString,\n  logger,\n  noop,\n} from '@andrew_l/toolkit';\n\ntype HandlerError = (err: Error) => void;\ntype Handler<returnType = unknown> = () => Promise<returnType> | returnType;\ntype CancelCallback = () => void;\n\nconst log = logger('Graceful Shutdown');\n\nconst HANDLED_EVENTS = Object.freeze(['SIGINT', 'SIGTERM', 'SIGQUIT'] as const);\n\nconst DEPENDENCY_TREE = new Map<string, Set<string>>();\nconst DEPENDENCY_MAP = new WeakMap<AnyFunction, string[]>();\nconst HANDLERS_MAP = new Map<string, AnyFunction[]>();\nconst SHUTDOWN_ERROR_HANDLERS: HandlerError[] = [];\n\nlet shuttingDown = false;\n\n/**\n * Gracefully terminate application's modules on shutdown.\n * @param handler - Async or sync function which handles shutdown.\n */\nexport function onShutdown(handler: Handler): CancelCallback;\n\n/**\n * Gracefully terminate application's modules on shutdown.\n * @param name - Name of the handler.\n * @param handler - Async or sync function which handles shutdown.\n */\nexport function onShutdown(name: string, handler: Handler): CancelCallback;\n\n/**\n * Gracefully terminate application's modules on shutdown.\n * @param dependencies - Which handlers should be processed first.\n * @param handler - Async or sync function which handles shutdown.\n */\nexport function onShutdown(\n  dependencies: string[],\n  handler: Handler,\n): CancelCallback;\n\n/**\n * Gracefully terminate application's modules on shutdown.\n * @param name - Name of the handler.\n * @param dependencies - Which handlers should be processed first.\n * @param handler - Async or sync function which handles shutdown.\n *\n * @example\n * // This will called after http server close\n * onShutdown('mongoose', ['http-server'], async () => {\n *   console.info('Graceful: mongodb connection.');\n *   await mongoose.disconnect();\n * });\n *\n * onShutdown('http-server', async () => {\n *   console.info('Graceful: http server.');\n *   await httpServer.close();\n * });\n *\n * @group Main\n */\nexport function onShutdown(\n  name: string,\n  dependencies: string[],\n  handler: Handler,\n): CancelCallback;\n\nexport function onShutdown(...args: any[]): CancelCallback {\n  const [_name, _dependencies, _handler] = args;\n\n  const handler = isFunction(_name)\n    ? _name\n    : isFunction(_dependencies)\n      ? _dependencies\n      : _handler;\n\n  const dependencies = Array.isArray(_name)\n    ? _name\n    : Array.isArray(_dependencies)\n      ? _dependencies\n      : [];\n\n  const name = isString(_name) ? _name : Math.random().toString(36);\n\n  if (shuttingDown) {\n    log.warn(\n      'Warn! Attempt to register handler while processing terminating: %s',\n      name,\n    );\n\n    return noop;\n  }\n\n  if (dependencies.reduce((acc, dep) => acc || testForCycles(dep), false)) {\n    throw new Error(\n      `Adding shutdown handler \"${name}\" will create a dependency loop: aborting`,\n    );\n  }\n\n  log.debug('Register handler: %s', name);\n\n  DEPENDENCY_TREE.set(\n    name,\n    new Set([...(DEPENDENCY_TREE.get(name) || []), ...dependencies]),\n  );\n\n  DEPENDENCY_MAP.set(handler, dependencies);\n\n  if (!HANDLERS_MAP.has(name)) {\n    HANDLERS_MAP.set(name, []);\n  }\n\n  HANDLERS_MAP.get(name)!.push(handler);\n\n  return () => {\n    const handlersList = (HANDLERS_MAP.get(name) ?? []).filter(\n      v => v !== handler,\n    );\n\n    if (!handlersList.length) {\n      HANDLERS_MAP.delete(name);\n    }\n\n    const renewDependencies = new Set(\n      handlersList\n        .map(v => DEPENDENCY_MAP.get(v))\n        .flat()\n        .filter(isString),\n    );\n\n    if (renewDependencies.size) {\n      DEPENDENCY_TREE.set(name, renewDependencies);\n    } else {\n      DEPENDENCY_TREE.delete(name);\n    }\n\n    DEPENDENCY_MAP.delete(handler);\n  };\n}\n\n/**\n * Optional export to handle shutdown errors.\n */\nexport function onShutdownError(callback: HandlerError): CancelCallback {\n  SHUTDOWN_ERROR_HANDLERS.push(callback);\n\n  return () => {\n    const idx = SHUTDOWN_ERROR_HANDLERS.indexOf(callback);\n    if (idx > -1) {\n      SHUTDOWN_ERROR_HANDLERS.splice(idx, 1);\n    }\n  };\n}\n\nexport function processGraceful(signal: NodeJS.Signals = 'SIGTERM') {\n  log.warn('Force with signal: %s', signal);\n  process.emit('SIGTERM', signal);\n}\n\nasync function shutdown(name: string, promisesMap: Map<string, Promise<any>>) {\n  if (promisesMap.has(name)) {\n    return promisesMap.get(name);\n  }\n\n  const q = defer<void>();\n\n  promisesMap.set(name, q.promise);\n\n  let lastError: unknown;\n\n  try {\n    const dependencies = DEPENDENCY_TREE.get(name);\n\n    // Wait for all dependencies to shut down.\n    if (dependencies) {\n      await Promise.all(\n        Array.from(dependencies).map(dep =>\n          shutdown(dep, promisesMap).catch(err => (lastError = err)),\n        ),\n      );\n    }\n\n    // Shutdown this item.\n    const allHandlers = HANDLERS_MAP.get(name);\n\n    if (allHandlers?.length) {\n      const timeoutInterval = setInterval(() => {\n        log.warn('Long shutdown %s', name);\n      }, 3000);\n\n      await asyncForEach(\n        allHandlers,\n        async fn => {\n          try {\n            await fn();\n          } catch (err) {\n            lastError = err;\n          }\n        },\n        { concurrency: 10 },\n      );\n\n      clearTimeout(timeoutInterval);\n    }\n  } catch (err) {\n    lastError = err;\n  }\n\n  if (lastError) {\n    q.reject(lastError);\n  } else {\n    q.resolve();\n  }\n\n  return q.promise;\n}\n\nfor (const eventName of HANDLED_EVENTS) {\n  process.removeAllListeners(eventName).addListener(eventName, () => {\n    log.debug('Received signal: %s', eventName);\n    onShutdownEvent();\n  });\n}\n\nfunction onShutdownEvent() {\n  if (shuttingDown) return;\n  shuttingDown = true;\n\n  // Get all unreferenced nodes.\n  const unreferencedNames = getAllUnreferencedNames();\n\n  const visited = new Map();\n  Promise.all(unreferencedNames.map(name => shutdown(name, visited)))\n    .then(() => exit(0))\n    .catch(e => {\n      Promise.all(SHUTDOWN_ERROR_HANDLERS.map(f => f(e)))\n        .then(() => exit(42759))\n        .catch(() => exit(42758));\n    });\n}\n\nfunction testForCycles(name: string, visitedSet = new Set()): boolean {\n  // Return true if the cycle is found.\n  if (visitedSet.has(name)) return true;\n\n  visitedSet.add(name);\n\n  // If any of the cycles found in dependencies, return true.\n  const dependencies = DEPENDENCY_TREE.get(name);\n\n  if (!dependencies) return false;\n\n  for (const dependencyName of dependencies.values()) {\n    if (testForCycles(dependencyName, visitedSet)) return true;\n  }\n\n  return false;\n}\n\nfunction getAllUnreferencedNames(): string[] {\n  const result = new Set(Array.from(DEPENDENCY_TREE.keys()));\n\n  for (const dependencies of DEPENDENCY_TREE.values()) {\n    for (const dependencyName of dependencies.values()) {\n      result.delete(dependencyName);\n    }\n  }\n\n  return Array.from(result);\n}\n\nfunction exit(code?: number): void {\n  log.info('Shutdown with code: %d', code ?? 0);\n  process.exit(code);\n}\n"],"names":["logger","isFunction","isString","noop","defer","asyncForEach"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,48 @@
+type HandlerError = (err: Error) => void;
+type Handler<returnType = unknown> = () => Promise<returnType> | returnType;
+type CancelCallback = () => void;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param handler - Async or sync function which handles shutdown.
+ */
+declare function onShutdown(handler: Handler): CancelCallback;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param name - Name of the handler.
+ * @param handler - Async or sync function which handles shutdown.
+ */
+declare function onShutdown(name: string, handler: Handler): CancelCallback;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param dependencies - Which handlers should be processed first.
+ * @param handler - Async or sync function which handles shutdown.
+ */
+declare function onShutdown(dependencies: string[], handler: Handler): CancelCallback;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param name - Name of the handler.
+ * @param dependencies - Which handlers should be processed first.
+ * @param handler - Async or sync function which handles shutdown.
+ *
+ * @example
+ * // This will called after http server close
+ * onShutdown('mongoose', ['http-server'], async () => {
+ *   console.info('Graceful: mongodb connection.');
+ *   await mongoose.disconnect();
+ * });
+ *
+ * onShutdown('http-server', async () => {
+ *   console.info('Graceful: http server.');
+ *   await httpServer.close();
+ * });
+ *
+ * @group Main
+ */
+declare function onShutdown(name: string, dependencies: string[], handler: Handler): CancelCallback;
+/**
+ * Optional export to handle shutdown errors.
+ */
+declare function onShutdownError(callback: HandlerError): CancelCallback;
+declare function processGraceful(signal?: NodeJS.Signals): void;
+
+export { onShutdown, onShutdownError, processGraceful };

package/dist/index.d.mts

@@ -0,0 +1,48 @@
+type HandlerError = (err: Error) => void;
+type Handler<returnType = unknown> = () => Promise<returnType> | returnType;
+type CancelCallback = () => void;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param handler - Async or sync function which handles shutdown.
+ */
+declare function onShutdown(handler: Handler): CancelCallback;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param name - Name of the handler.
+ * @param handler - Async or sync function which handles shutdown.
+ */
+declare function onShutdown(name: string, handler: Handler): CancelCallback;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param dependencies - Which handlers should be processed first.
+ * @param handler - Async or sync function which handles shutdown.
+ */
+declare function onShutdown(dependencies: string[], handler: Handler): CancelCallback;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param name - Name of the handler.
+ * @param dependencies - Which handlers should be processed first.
+ * @param handler - Async or sync function which handles shutdown.
+ *
+ * @example
+ * // This will called after http server close
+ * onShutdown('mongoose', ['http-server'], async () => {
+ *   console.info('Graceful: mongodb connection.');
+ *   await mongoose.disconnect();
+ * });
+ *
+ * onShutdown('http-server', async () => {
+ *   console.info('Graceful: http server.');
+ *   await httpServer.close();
+ * });
+ *
+ * @group Main
+ */
+declare function onShutdown(name: string, dependencies: string[], handler: Handler): CancelCallback;
+/**
+ * Optional export to handle shutdown errors.
+ */
+declare function onShutdownError(callback: HandlerError): CancelCallback;
+declare function processGraceful(signal?: NodeJS.Signals): void;
+
+export { onShutdown, onShutdownError, processGraceful };

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+type HandlerError = (err: Error) => void;
+type Handler<returnType = unknown> = () => Promise<returnType> | returnType;
+type CancelCallback = () => void;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param handler - Async or sync function which handles shutdown.
+ */
+declare function onShutdown(handler: Handler): CancelCallback;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param name - Name of the handler.
+ * @param handler - Async or sync function which handles shutdown.
+ */
+declare function onShutdown(name: string, handler: Handler): CancelCallback;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param dependencies - Which handlers should be processed first.
+ * @param handler - Async or sync function which handles shutdown.
+ */
+declare function onShutdown(dependencies: string[], handler: Handler): CancelCallback;
+/**
+ * Gracefully terminate application's modules on shutdown.
+ * @param name - Name of the handler.
+ * @param dependencies - Which handlers should be processed first.
+ * @param handler - Async or sync function which handles shutdown.
+ *
+ * @example
+ * // This will called after http server close
+ * onShutdown('mongoose', ['http-server'], async () => {
+ *   console.info('Graceful: mongodb connection.');
+ *   await mongoose.disconnect();
+ * });
+ *
+ * onShutdown('http-server', async () => {
+ *   console.info('Graceful: http server.');
+ *   await httpServer.close();
+ * });
+ *
+ * @group Main
+ */
+declare function onShutdown(name: string, dependencies: string[], handler: Handler): CancelCallback;
+/**
+ * Optional export to handle shutdown errors.
+ */
+declare function onShutdownError(callback: HandlerError): CancelCallback;
+declare function processGraceful(signal?: NodeJS.Signals): void;
+
+export { onShutdown, onShutdownError, processGraceful };

package/dist/index.mjs

@@ -0,0 +1,152 @@
+import { logger, isFunction, isString, noop, defer, asyncForEach } from '@andrew_l/toolkit';
+
+const log = logger("Graceful Shutdown");
+const HANDLED_EVENTS = Object.freeze(["SIGINT", "SIGTERM", "SIGQUIT"]);
+const DEPENDENCY_TREE = /* @__PURE__ */ new Map();
+const DEPENDENCY_MAP = /* @__PURE__ */ new WeakMap();
+const HANDLERS_MAP = /* @__PURE__ */ new Map();
+const SHUTDOWN_ERROR_HANDLERS = [];
+let shuttingDown = false;
+function onShutdown(...args) {
+  const [_name, _dependencies, _handler] = args;
+  const handler = isFunction(_name) ? _name : isFunction(_dependencies) ? _dependencies : _handler;
+  const dependencies = Array.isArray(_name) ? _name : Array.isArray(_dependencies) ? _dependencies : [];
+  const name = isString(_name) ? _name : Math.random().toString(36);
+  if (shuttingDown) {
+    log.warn(
+      "Warn! Attempt to register handler while processing terminating: %s",
+      name
+    );
+    return noop;
+  }
+  if (dependencies.reduce((acc, dep) => acc || testForCycles(dep), false)) {
+    throw new Error(
+      `Adding shutdown handler "${name}" will create a dependency loop: aborting`
+    );
+  }
+  log.debug("Register handler: %s", name);
+  DEPENDENCY_TREE.set(
+    name,
+    /* @__PURE__ */ new Set([...DEPENDENCY_TREE.get(name) || [], ...dependencies])
+  );
+  DEPENDENCY_MAP.set(handler, dependencies);
+  if (!HANDLERS_MAP.has(name)) {
+    HANDLERS_MAP.set(name, []);
+  }
+  HANDLERS_MAP.get(name).push(handler);
+  return () => {
+    const handlersList = (HANDLERS_MAP.get(name) ?? []).filter(
+      (v) => v !== handler
+    );
+    if (!handlersList.length) {
+      HANDLERS_MAP.delete(name);
+    }
+    const renewDependencies = new Set(
+      handlersList.map((v) => DEPENDENCY_MAP.get(v)).flat().filter(isString)
+    );
+    if (renewDependencies.size) {
+      DEPENDENCY_TREE.set(name, renewDependencies);
+    } else {
+      DEPENDENCY_TREE.delete(name);
+    }
+    DEPENDENCY_MAP.delete(handler);
+  };
+}
+function onShutdownError(callback) {
+  SHUTDOWN_ERROR_HANDLERS.push(callback);
+  return () => {
+    const idx = SHUTDOWN_ERROR_HANDLERS.indexOf(callback);
+    if (idx > -1) {
+      SHUTDOWN_ERROR_HANDLERS.splice(idx, 1);
+    }
+  };
+}
+function processGraceful(signal = "SIGTERM") {
+  log.warn("Force with signal: %s", signal);
+  process.emit("SIGTERM", signal);
+}
+async function shutdown(name, promisesMap) {
+  if (promisesMap.has(name)) {
+    return promisesMap.get(name);
+  }
+  const q = defer();
+  promisesMap.set(name, q.promise);
+  let lastError;
+  try {
+    const dependencies = DEPENDENCY_TREE.get(name);
+    if (dependencies) {
+      await Promise.all(
+        Array.from(dependencies).map(
+          (dep) => shutdown(dep, promisesMap).catch((err) => lastError = err)
+        )
+      );
+    }
+    const allHandlers = HANDLERS_MAP.get(name);
+    if (allHandlers?.length) {
+      const timeoutInterval = setInterval(() => {
+        log.warn("Long shutdown %s", name);
+      }, 3e3);
+      await asyncForEach(
+        allHandlers,
+        async (fn) => {
+          try {
+            await fn();
+          } catch (err) {
+            lastError = err;
+          }
+        },
+        { concurrency: 10 }
+      );
+      clearTimeout(timeoutInterval);
+    }
+  } catch (err) {
+    lastError = err;
+  }
+  if (lastError) {
+    q.reject(lastError);
+  } else {
+    q.resolve();
+  }
+  return q.promise;
+}
+for (const eventName of HANDLED_EVENTS) {
+  process.removeAllListeners(eventName).addListener(eventName, () => {
+    log.debug("Received signal: %s", eventName);
+    onShutdownEvent();
+  });
+}
+function onShutdownEvent() {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  const unreferencedNames = getAllUnreferencedNames();
+  const visited = /* @__PURE__ */ new Map();
+  Promise.all(unreferencedNames.map((name) => shutdown(name, visited))).then(() => exit(0)).catch((e) => {
+    Promise.all(SHUTDOWN_ERROR_HANDLERS.map((f) => f(e))).then(() => exit(42759)).catch(() => exit(42758));
+  });
+}
+function testForCycles(name, visitedSet = /* @__PURE__ */ new Set()) {
+  if (visitedSet.has(name)) return true;
+  visitedSet.add(name);
+  const dependencies = DEPENDENCY_TREE.get(name);
+  if (!dependencies) return false;
+  for (const dependencyName of dependencies.values()) {
+    if (testForCycles(dependencyName, visitedSet)) return true;
+  }
+  return false;
+}
+function getAllUnreferencedNames() {
+  const result = new Set(Array.from(DEPENDENCY_TREE.keys()));
+  for (const dependencies of DEPENDENCY_TREE.values()) {
+    for (const dependencyName of dependencies.values()) {
+      result.delete(dependencyName);
+    }
+  }
+  return Array.from(result);
+}
+function exit(code) {
+  log.info("Shutdown with code: %d", code ?? 0);
+  process.exit(code);
+}
+
+export { onShutdown, onShutdownError, processGraceful };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":["import {\n  type AnyFunction,\n  asyncForEach,\n  defer,\n  isFunction,\n  isString,\n  logger,\n  noop,\n} from '@andrew_l/toolkit';\n\ntype HandlerError = (err: Error) => void;\ntype Handler<returnType = unknown> = () => Promise<returnType> | returnType;\ntype CancelCallback = () => void;\n\nconst log = logger('Graceful Shutdown');\n\nconst HANDLED_EVENTS = Object.freeze(['SIGINT', 'SIGTERM', 'SIGQUIT'] as const);\n\nconst DEPENDENCY_TREE = new Map<string, Set<string>>();\nconst DEPENDENCY_MAP = new WeakMap<AnyFunction, string[]>();\nconst HANDLERS_MAP = new Map<string, AnyFunction[]>();\nconst SHUTDOWN_ERROR_HANDLERS: HandlerError[] = [];\n\nlet shuttingDown = false;\n\n/**\n * Gracefully terminate application's modules on shutdown.\n * @param handler - Async or sync function which handles shutdown.\n */\nexport function onShutdown(handler: Handler): CancelCallback;\n\n/**\n * Gracefully terminate application's modules on shutdown.\n * @param name - Name of the handler.\n * @param handler - Async or sync function which handles shutdown.\n */\nexport function onShutdown(name: string, handler: Handler): CancelCallback;\n\n/**\n * Gracefully terminate application's modules on shutdown.\n * @param dependencies - Which handlers should be processed first.\n * @param handler - Async or sync function which handles shutdown.\n */\nexport function onShutdown(\n  dependencies: string[],\n  handler: Handler,\n): CancelCallback;\n\n/**\n * Gracefully terminate application's modules on shutdown.\n * @param name - Name of the handler.\n * @param dependencies - Which handlers should be processed first.\n * @param handler - Async or sync function which handles shutdown.\n *\n * @example\n * // This will called after http server close\n * onShutdown('mongoose', ['http-server'], async () => {\n *   console.info('Graceful: mongodb connection.');\n *   await mongoose.disconnect();\n * });\n *\n * onShutdown('http-server', async () => {\n *   console.info('Graceful: http server.');\n *   await httpServer.close();\n * });\n *\n * @group Main\n */\nexport function onShutdown(\n  name: string,\n  dependencies: string[],\n  handler: Handler,\n): CancelCallback;\n\nexport function onShutdown(...args: any[]): CancelCallback {\n  const [_name, _dependencies, _handler] = args;\n\n  const handler = isFunction(_name)\n    ? _name\n    : isFunction(_dependencies)\n      ? _dependencies\n      : _handler;\n\n  const dependencies = Array.isArray(_name)\n    ? _name\n    : Array.isArray(_dependencies)\n      ? _dependencies\n      : [];\n\n  const name = isString(_name) ? _name : Math.random().toString(36);\n\n  if (shuttingDown) {\n    log.warn(\n      'Warn! Attempt to register handler while processing terminating: %s',\n      name,\n    );\n\n    return noop;\n  }\n\n  if (dependencies.reduce((acc, dep) => acc || testForCycles(dep), false)) {\n    throw new Error(\n      `Adding shutdown handler \"${name}\" will create a dependency loop: aborting`,\n    );\n  }\n\n  log.debug('Register handler: %s', name);\n\n  DEPENDENCY_TREE.set(\n    name,\n    new Set([...(DEPENDENCY_TREE.get(name) || []), ...dependencies]),\n  );\n\n  DEPENDENCY_MAP.set(handler, dependencies);\n\n  if (!HANDLERS_MAP.has(name)) {\n    HANDLERS_MAP.set(name, []);\n  }\n\n  HANDLERS_MAP.get(name)!.push(handler);\n\n  return () => {\n    const handlersList = (HANDLERS_MAP.get(name) ?? []).filter(\n      v => v !== handler,\n    );\n\n    if (!handlersList.length) {\n      HANDLERS_MAP.delete(name);\n    }\n\n    const renewDependencies = new Set(\n      handlersList\n        .map(v => DEPENDENCY_MAP.get(v))\n        .flat()\n        .filter(isString),\n    );\n\n    if (renewDependencies.size) {\n      DEPENDENCY_TREE.set(name, renewDependencies);\n    } else {\n      DEPENDENCY_TREE.delete(name);\n    }\n\n    DEPENDENCY_MAP.delete(handler);\n  };\n}\n\n/**\n * Optional export to handle shutdown errors.\n */\nexport function onShutdownError(callback: HandlerError): CancelCallback {\n  SHUTDOWN_ERROR_HANDLERS.push(callback);\n\n  return () => {\n    const idx = SHUTDOWN_ERROR_HANDLERS.indexOf(callback);\n    if (idx > -1) {\n      SHUTDOWN_ERROR_HANDLERS.splice(idx, 1);\n    }\n  };\n}\n\nexport function processGraceful(signal: NodeJS.Signals = 'SIGTERM') {\n  log.warn('Force with signal: %s', signal);\n  process.emit('SIGTERM', signal);\n}\n\nasync function shutdown(name: string, promisesMap: Map<string, Promise<any>>) {\n  if (promisesMap.has(name)) {\n    return promisesMap.get(name);\n  }\n\n  const q = defer<void>();\n\n  promisesMap.set(name, q.promise);\n\n  let lastError: unknown;\n\n  try {\n    const dependencies = DEPENDENCY_TREE.get(name);\n\n    // Wait for all dependencies to shut down.\n    if (dependencies) {\n      await Promise.all(\n        Array.from(dependencies).map(dep =>\n          shutdown(dep, promisesMap).catch(err => (lastError = err)),\n        ),\n      );\n    }\n\n    // Shutdown this item.\n    const allHandlers = HANDLERS_MAP.get(name);\n\n    if (allHandlers?.length) {\n      const timeoutInterval = setInterval(() => {\n        log.warn('Long shutdown %s', name);\n      }, 3000);\n\n      await asyncForEach(\n        allHandlers,\n        async fn => {\n          try {\n            await fn();\n          } catch (err) {\n            lastError = err;\n          }\n        },\n        { concurrency: 10 },\n      );\n\n      clearTimeout(timeoutInterval);\n    }\n  } catch (err) {\n    lastError = err;\n  }\n\n  if (lastError) {\n    q.reject(lastError);\n  } else {\n    q.resolve();\n  }\n\n  return q.promise;\n}\n\nfor (const eventName of HANDLED_EVENTS) {\n  process.removeAllListeners(eventName).addListener(eventName, () => {\n    log.debug('Received signal: %s', eventName);\n    onShutdownEvent();\n  });\n}\n\nfunction onShutdownEvent() {\n  if (shuttingDown) return;\n  shuttingDown = true;\n\n  // Get all unreferenced nodes.\n  const unreferencedNames = getAllUnreferencedNames();\n\n  const visited = new Map();\n  Promise.all(unreferencedNames.map(name => shutdown(name, visited)))\n    .then(() => exit(0))\n    .catch(e => {\n      Promise.all(SHUTDOWN_ERROR_HANDLERS.map(f => f(e)))\n        .then(() => exit(42759))\n        .catch(() => exit(42758));\n    });\n}\n\nfunction testForCycles(name: string, visitedSet = new Set()): boolean {\n  // Return true if the cycle is found.\n  if (visitedSet.has(name)) return true;\n\n  visitedSet.add(name);\n\n  // If any of the cycles found in dependencies, return true.\n  const dependencies = DEPENDENCY_TREE.get(name);\n\n  if (!dependencies) return false;\n\n  for (const dependencyName of dependencies.values()) {\n    if (testForCycles(dependencyName, visitedSet)) return true;\n  }\n\n  return false;\n}\n\nfunction getAllUnreferencedNames(): string[] {\n  const result = new Set(Array.from(DEPENDENCY_TREE.keys()));\n\n  for (const dependencies of DEPENDENCY_TREE.values()) {\n    for (const dependencyName of dependencies.values()) {\n      result.delete(dependencyName);\n    }\n  }\n\n  return Array.from(result);\n}\n\nfunction exit(code?: number): void {\n  log.info('Shutdown with code: %d', code ?? 0);\n  process.exit(code);\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@andrew_l/graceful",
+  "version": "0.0.1",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/men232/toolkit.git",
+    "directory": "packages/graceful"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "unbuild": "3.0.0-rc.11",
+    "@types/node": "^20.16.10",
+    "typescript": "~5.6.2",
+    "vitest": "^2.1.3"
+  },
+  "dependencies": {
+    "@andrew_l/toolkit": "0.0.1"
+  },
+  "scripts": {
+    "build": "unbuild",
+    "test": "vitest run --typecheck",
+    "test:watch": "vitest watch --typecheck"
+  }
+}