@andrew_l/graceful 0.3.6 → 0.3.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -9,6 +9,9 @@ const DEPENDENCY_MAP = /* @__PURE__ */ new WeakMap();
9
9
  const HANDLERS_MAP = /* @__PURE__ */ new Map();
10
10
  const SHUTDOWN_ERROR_HANDLERS = [];
11
11
  let shuttingDown = false;
12
+ function isShuttingDown() {
13
+ return shuttingDown;
14
+ }
12
15
  function onShutdown(...args) {
13
16
  const [_name, _dependencies, _handler] = args;
14
17
  const handler = toolkit.isFunction(_name) ? _name : toolkit.isFunction(_dependencies) ? _dependencies : _handler;
@@ -150,6 +153,7 @@ function exit(code) {
150
153
  process.exit(code);
151
154
  }
152
155
 
156
+ exports.isShuttingDown = isShuttingDown;
153
157
  exports.onShutdown = onShutdown;
154
158
  exports.onShutdownError = onShutdownError;
155
159
  exports.processGraceful = processGraceful;
@@ -1 +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.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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"}
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 * Returns true when process received shutdown signal\n * @group Main\n */\nexport function isShuttingDown(): boolean {\n return shuttingDown;\n}\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.d.cts CHANGED
@@ -1,6 +1,11 @@
1
1
  type HandlerError = (err: Error) => void;
2
2
  type Handler<returnType = unknown> = () => Promise<returnType> | returnType;
3
3
  type CancelCallback = () => void;
4
+ /**
5
+ * Returns true when process received shutdown signal
6
+ * @group Main
7
+ */
8
+ declare function isShuttingDown(): boolean;
4
9
  /**
5
10
  * Gracefully terminate application's modules on shutdown.
6
11
  * @param handler - Async or sync function which handles shutdown.
@@ -45,4 +50,4 @@ declare function onShutdown(name: string, dependencies: string[], handler: Handl
45
50
  declare function onShutdownError(callback: HandlerError): CancelCallback;
46
51
  declare function processGraceful(signal?: NodeJS.Signals): void;
47
52
 
48
- export { onShutdown, onShutdownError, processGraceful };
53
+ export { isShuttingDown, onShutdown, onShutdownError, processGraceful };
package/dist/index.d.mts CHANGED
@@ -1,6 +1,11 @@
1
1
  type HandlerError = (err: Error) => void;
2
2
  type Handler<returnType = unknown> = () => Promise<returnType> | returnType;
3
3
  type CancelCallback = () => void;
4
+ /**
5
+ * Returns true when process received shutdown signal
6
+ * @group Main
7
+ */
8
+ declare function isShuttingDown(): boolean;
4
9
  /**
5
10
  * Gracefully terminate application's modules on shutdown.
6
11
  * @param handler - Async or sync function which handles shutdown.
@@ -45,4 +50,4 @@ declare function onShutdown(name: string, dependencies: string[], handler: Handl
45
50
  declare function onShutdownError(callback: HandlerError): CancelCallback;
46
51
  declare function processGraceful(signal?: NodeJS.Signals): void;
47
52
 
48
- export { onShutdown, onShutdownError, processGraceful };
53
+ export { isShuttingDown, onShutdown, onShutdownError, processGraceful };
package/dist/index.d.ts CHANGED
@@ -1,6 +1,11 @@
1
1
  type HandlerError = (err: Error) => void;
2
2
  type Handler<returnType = unknown> = () => Promise<returnType> | returnType;
3
3
  type CancelCallback = () => void;
4
+ /**
5
+ * Returns true when process received shutdown signal
6
+ * @group Main
7
+ */
8
+ declare function isShuttingDown(): boolean;
4
9
  /**
5
10
  * Gracefully terminate application's modules on shutdown.
6
11
  * @param handler - Async or sync function which handles shutdown.
@@ -45,4 +50,4 @@ declare function onShutdown(name: string, dependencies: string[], handler: Handl
45
50
  declare function onShutdownError(callback: HandlerError): CancelCallback;
46
51
  declare function processGraceful(signal?: NodeJS.Signals): void;
47
52
 
48
- export { onShutdown, onShutdownError, processGraceful };
53
+ export { isShuttingDown, onShutdown, onShutdownError, processGraceful };
package/dist/index.mjs CHANGED
@@ -7,6 +7,9 @@ const DEPENDENCY_MAP = /* @__PURE__ */ new WeakMap();
7
7
  const HANDLERS_MAP = /* @__PURE__ */ new Map();
8
8
  const SHUTDOWN_ERROR_HANDLERS = [];
9
9
  let shuttingDown = false;
10
+ function isShuttingDown() {
11
+ return shuttingDown;
12
+ }
10
13
  function onShutdown(...args) {
11
14
  const [_name, _dependencies, _handler] = args;
12
15
  const handler = isFunction(_name) ? _name : isFunction(_dependencies) ? _dependencies : _handler;
@@ -148,5 +151,5 @@ function exit(code) {
148
151
  process.exit(code);
149
152
  }
150
153
 
151
- export { onShutdown, onShutdownError, processGraceful };
154
+ export { isShuttingDown, onShutdown, onShutdownError, processGraceful };
152
155
  //# sourceMappingURL=index.mjs.map
@@ -1 +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.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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"}
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 * Returns true when process received shutdown signal\n * @group Main\n */\nexport function isShuttingDown(): boolean {\n return shuttingDown;\n}\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":";;AAcA,MAAM,GAAA,GAAM,OAAO,mBAAmB,CAAA;AAEtC,MAAM,iBAAiB,MAAA,CAAO,MAAA,CAAO,CAAC,QAAA,EAAU,SAAA,EAAW,SAAS,CAAU,CAAA;AAE9E,MAAM,eAAA,uBAAsB,GAAA,EAAyB;AACrD,MAAM,cAAA,uBAAqB,OAAA,EAA+B;AAC1D,MAAM,YAAA,uBAAmB,GAAA,EAA2B;AACpD,MAAM,0BAA0C,EAAC;AAEjD,IAAI,YAAA,GAAe,KAAA;AAMZ,SAAS,cAAA,GAA0B;AACxC,EAAA,OAAO,YAAA;AACT;AAmDO,SAAS,cAAc,IAAA,EAA6B;AACzD,EAAA,MAAM,CAAC,KAAA,EAAO,aAAA,EAAe,QAAQ,CAAA,GAAI,IAAA;AAEzC,EAAA,MAAM,OAAA,GAAU,WAAW,KAAK,CAAA,GAC5B,QACA,UAAA,CAAW,aAAa,IACtB,aAAA,GACA,QAAA;AAEN,EAAA,MAAM,YAAA,GAAe,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GACpC,KAAA,GACA,KAAA,CAAM,OAAA,CAAQ,aAAa,CAAA,GACzB,aAAA,GACA,EAAC;AAEP,EAAA,MAAM,IAAA,GAAO,SAAS,KAAK,CAAA,GAAI,QAAQ,IAAA,CAAK,MAAA,EAAO,CAAE,QAAA,CAAS,EAAE,CAAA;AAEhE,EAAA,IAAI,YAAA,EAAc;AAChB,IAAA,GAAA,CAAI,IAAA;AAAA,MACF,oEAAA;AAAA,MACA;AAAA,KACF;AAEA,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,IAAI,YAAA,CAAa,MAAA,CAAO,CAAC,GAAA,EAAK,GAAA,KAAQ,OAAO,aAAA,CAAc,GAAG,CAAA,EAAG,KAAK,CAAA,EAAG;AACvE,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,4BAA4B,IAAI,CAAA,yCAAA;AAAA,KAClC;AAAA,EACF;AAEA,EAAA,GAAA,CAAI,KAAA,CAAM,wBAAwB,IAAI,CAAA;AAEtC,EAAA,eAAA,CAAgB,GAAA;AAAA,IACd,IAAA;AAAA,oBACA,IAAI,GAAA,CAAI,CAAC,GAAI,eAAA,CAAgB,GAAA,CAAI,IAAI,CAAA,IAAK,EAAC,EAAI,GAAG,YAAY,CAAC;AAAA,GACjE;AAEA,EAAA,cAAA,CAAe,GAAA,CAAI,SAAS,YAAY,CAAA;AAExC,EAAA,IAAI,CAAC,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA,EAAG;AAC3B,IAAA,YAAA,CAAa,GAAA,CAAI,IAAA,EAAM,EAAE,CAAA;AAAA,EAC3B;AAEA,EAAA,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA,CAAG,IAAA,CAAK,OAAO,CAAA;AAEpC,EAAA,OAAO,MAAM;AACX,IAAA,MAAM,gBAAgB,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA,IAAK,EAAC,EAAG,MAAA;AAAA,MAClD,OAAK,CAAA,KAAM;AAAA,KACb;AAEA,IAAA,IAAI,CAAC,aAAa,MAAA,EAAQ;AACxB,MAAA,YAAA,CAAa,OAAO,IAAI,CAAA;AAAA,IAC1B;AAEA,IAAA,MAAM,oBAAoB,IAAI,GAAA;AAAA,MAC5B,YAAA,CACG,GAAA,CAAI,CAAA,CAAA,KAAK,cAAA,CAAe,GAAA,CAAI,CAAC,CAAC,CAAA,CAC9B,IAAA,EAAK,CACL,MAAA,CAAO,QAAQ;AAAA,KACpB;AAEA,IAAA,IAAI,kBAAkB,IAAA,EAAM;AAC1B,MAAA,eAAA,CAAgB,GAAA,CAAI,MAAM,iBAAiB,CAAA;AAAA,IAC7C,CAAA,MAAO;AACL,MAAA,eAAA,CAAgB,OAAO,IAAI,CAAA;AAAA,IAC7B;AAEA,IAAA,cAAA,CAAe,OAAO,OAAO,CAAA;AAAA,EAC/B,CAAA;AACF;AAKO,SAAS,gBAAgB,QAAA,EAAwC;AACtE,EAAA,uBAAA,CAAwB,KAAK,QAAQ,CAAA;AAErC,EAAA,OAAO,MAAM;AACX,IAAA,MAAM,GAAA,GAAM,uBAAA,CAAwB,OAAA,CAAQ,QAAQ,CAAA;AACpD,IAAA,IAAI,MAAM,EAAA,EAAI;AACZ,MAAA,uBAAA,CAAwB,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,IACvC;AAAA,EACF,CAAA;AACF;AAEO,SAAS,eAAA,CAAgB,SAAyB,SAAA,EAAW;AAClE,EAAA,GAAA,CAAI,KAAA,CAAM,yBAAyB,MAAM,CAAA;AACzC,EAAA,OAAA,CAAQ,IAAA,CAAK,WAAW,MAAM,CAAA;AAChC;AAEA,eAAe,QAAA,CAAS,MAAc,WAAA,EAAwC;AAC5E,EAAA,IAAI,WAAA,CAAY,GAAA,CAAI,IAAI,CAAA,EAAG;AACzB,IAAA,OAAO,WAAA,CAAY,IAAI,IAAI,CAAA;AAAA,EAC7B;AAEA,EAAA,MAAM,IAAI,KAAA,EAAY;AAEtB,EAAA,WAAA,CAAY,GAAA,CAAI,IAAA,EAAM,CAAA,CAAE,OAAO,CAAA;AAE/B,EAAA,IAAI,SAAA;AAEJ,EAAA,IAAI;AACF,IAAA,MAAM,YAAA,GAAe,eAAA,CAAgB,GAAA,CAAI,IAAI,CAAA;AAG7C,IAAA,IAAI,YAAA,EAAc;AAChB,MAAA,MAAM,OAAA,CAAQ,GAAA;AAAA,QACZ,KAAA,CAAM,IAAA,CAAK,YAAY,CAAA,CAAE,GAAA;AAAA,UAAI,CAAA,GAAA,KAC3B,SAAS,GAAA,EAAK,WAAW,EAAE,KAAA,CAAM,CAAA,GAAA,KAAQ,YAAY,GAAI;AAAA;AAC3D,OACF;AAAA,IACF;AAGA,IAAA,MAAM,WAAA,GAAc,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA;AAEzC,IAAA,IAAI,aAAa,MAAA,EAAQ;AACvB,MAAA,MAAM,eAAA,GAAkB,YAAY,MAAM;AACxC,QAAA,GAAA,CAAI,IAAA,CAAK,oBAAoB,IAAI,CAAA;AAAA,MACnC,GAAG,GAAI,CAAA;AAEP,MAAA,MAAM,YAAA;AAAA,QACJ,WAAA;AAAA,QACA,OAAM,EAAA,KAAM;AACV,UAAA,IAAI;AACF,YAAA,MAAM,EAAA,EAAG;AAAA,UACX,SAAS,GAAA,EAAK;AACZ,YAAA,SAAA,GAAY,GAAA;AAAA,UACd;AAAA,QACF,CAAA;AAAA,QACA,EAAE,aAAa,EAAA;AAAG,OACpB;AAEA,MAAA,YAAA,CAAa,eAAe,CAAA;AAAA,IAC9B;AAAA,EACF,SAAS,GAAA,EAAK;AACZ,IAAA,SAAA,GAAY,GAAA;AAAA,EACd;AAEA,EAAA,IAAI,SAAA,EAAW;AACb,IAAA,CAAA,CAAE,OAAO,SAAS,CAAA;AAAA,EACpB,CAAA,MAAO;AACL,IAAA,CAAA,CAAE,OAAA,EAAQ;AAAA,EACZ;AAEA,EAAA,OAAO,CAAA,CAAE,OAAA;AACX;AAEA,KAAA,MAAW,aAAa,cAAA,EAAgB;AACtC,EAAA,OAAA,CAAQ,kBAAA,CAAmB,SAAS,CAAA,CAAE,WAAA,CAAY,WAAW,MAAM;AACjE,IAAA,GAAA,CAAI,KAAA,CAAM,uBAAuB,SAAS,CAAA;AAC1C,IAAA,eAAA,EAAgB;AAAA,EAClB,CAAC,CAAA;AACH;AAEA,SAAS,eAAA,GAAkB;AACzB,EAAA,IAAI,YAAA,EAAc;AAClB,EAAA,YAAA,GAAe,IAAA;AAGf,EAAA,MAAM,oBAAoB,uBAAA,EAAwB;AAElD,EAAA,MAAM,OAAA,uBAAc,GAAA,EAAI;AACxB,EAAA,OAAA,CAAQ,IAAI,iBAAA,CAAkB,GAAA,CAAI,CAAA,IAAA,KAAQ,QAAA,CAAS,MAAM,OAAO,CAAC,CAAC,CAAA,CAC/D,KAAK,MAAM,IAAA,CAAK,CAAC,CAAC,CAAA,CAClB,MAAM,CAAA,CAAA,KAAK;AACV,IAAA,OAAA,CAAQ,IAAI,uBAAA,CAAwB,GAAA,CAAI,OAAK,CAAA,CAAE,CAAC,CAAC,CAAC,CAAA,CAC/C,KAAK,MAAM,IAAA,CAAK,KAAK,CAAC,CAAA,CACtB,MAAM,MAAM,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA,EAC5B,CAAC,CAAA;AACL;AAEA,SAAS,aAAA,CAAc,IAAA,EAAc,UAAA,mBAAa,IAAI,KAAI,EAAY;AAEpE,EAAA,IAAI,UAAA,CAAW,GAAA,CAAI,IAAI,CAAA,EAAG,OAAO,IAAA;AAEjC,EAAA,UAAA,CAAW,IAAI,IAAI,CAAA;AAGnB,EAAA,MAAM,YAAA,GAAe,eAAA,CAAgB,GAAA,CAAI,IAAI,CAAA;AAE7C,EAAA,IAAI,CAAC,cAAc,OAAO,KAAA;AAE1B,EAAA,KAAA,MAAW,cAAA,IAAkB,YAAA,CAAa,MAAA,EAAO,EAAG;AAClD,IAAA,IAAI,aAAA,CAAc,cAAA,EAAgB,UAAU,CAAA,EAAG,OAAO,IAAA;AAAA,EACxD;AAEA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,uBAAA,GAAoC;AAC3C,EAAA,MAAM,MAAA,GAAS,IAAI,GAAA,CAAI,KAAA,CAAM,KAAK,eAAA,CAAgB,IAAA,EAAM,CAAC,CAAA;AAEzD,EAAA,KAAA,MAAW,YAAA,IAAgB,eAAA,CAAgB,MAAA,EAAO,EAAG;AACnD,IAAA,KAAA,MAAW,cAAA,IAAkB,YAAA,CAAa,MAAA,EAAO,EAAG;AAClD,MAAA,MAAA,CAAO,OAAO,cAAc,CAAA;AAAA,IAC9B;AAAA,EACF;AAEA,EAAA,OAAO,KAAA,CAAM,KAAK,MAAM,CAAA;AAC1B;AAEA,SAAS,KAAK,IAAA,EAAqB;AACjC,EAAA,GAAA,CAAI,IAAA,CAAK,wBAAA,EAA0B,IAAA,IAAQ,CAAC,CAAA;AAC5C,EAAA,OAAA,CAAQ,KAAK,IAAI,CAAA;AACnB;;;;"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@andrew_l/graceful",
3
- "version": "0.3.6",
3
+ "version": "0.3.7",
4
4
  "description": "Utility to manage application shutdown.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -31,7 +31,7 @@
31
31
  "vitest": "^3.2.4"
32
32
  },
33
33
  "dependencies": {
34
- "@andrew_l/toolkit": "0.3.6"
34
+ "@andrew_l/toolkit": "0.3.7"
35
35
  },
36
36
  "scripts": {
37
37
  "check-types": "tsc --noEmit",