@andrew_l/graceful 0.2.21 → 0.3.1

package/dist/index.cjs

@@ -64,7 +64,7 @@ function onShutdownError(callback) {
   };
 }
 function processGraceful(signal = "SIGTERM") {
-  log.warn("Force with signal: %s", signal);
+  log.debug("Force with signal: %s", signal);
   process.emit("SIGTERM", signal);
 }
 async function shutdown(name, promisesMap) {

package/dist/index.cjs.map

@@ -1 +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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"}
+{"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.debug('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.mjs

@@ -1,4 +1,4 @@
-import { logger, isFunction, isString, noop, defer, asyncForEach } from '@andrew_l/toolkit';
+import { logger, defer, asyncForEach, isFunction, isString, noop } from '@andrew_l/toolkit';
 
 const log = logger("Graceful Shutdown");
 const HANDLED_EVENTS = Object.freeze(["SIGINT", "SIGTERM", "SIGQUIT"]);
@@ -62,7 +62,7 @@ function onShutdownError(callback) {
   };
 }
 function processGraceful(signal = "SIGTERM") {
-  log.warn("Force with signal: %s", signal);
+  log.debug("Force with signal: %s", signal);
   process.emit("SIGTERM", signal);
 }
 async function shutdown(name, promisesMap) {

package/dist/index.mjs.map

@@ -1 +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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"}
+{"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.debug('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

@@ -1,6 +1,6 @@
 {
   "name": "@andrew_l/graceful",
-  "version": "0.2.21",
+  "version": "0.3.1",
   "description": "Utility to manage application shutdown.",
   "license": "MIT",
   "type": "module",
@@ -26,14 +26,15 @@
   ],
   "devDependencies": {
     "@types/node": "22.10.5",
-    "typescript": "~5.6.2",
-    "unbuild": "3.0.0-rc.11",
-    "vitest": "^2.1.3"
+    "typescript": "~5.8.3",
+    "unbuild": "3.5.0",
+    "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@andrew_l/toolkit": "0.2.21"
+    "@andrew_l/toolkit": "0.3.1"
   },
   "scripts": {
+    "check-types": "tsc --noEmit",
     "build": "unbuild",
     "test": "echo todo",
     "test:watch": "vitest watch --typecheck"