vivth 1.0.5 → 1.1.0

package/README.md

@@ -1051,6 +1051,15 @@ npm i vivth
 /**
  * @param {Object} options 	 
  * @param {ExitEventNames} options.exitEventNames 	 
+ * @param {()=>void} options.exitCallback 	 
+ * - standard node/bun: 	 
+ * ```js 	 
+ * () => process.exit(0), 	 
+ * ``` 	 
+ * - Deno: 	 
+ * ```js 	 
+ * () => Deno.exit(0), 	 
+ * ``` 	 
  * @param {(eventName:string)=>void} [options.exitCallbackListeners] 	 
  * - default value 	 
  * ```js 	 
@@ -1070,7 +1079,9 @@ npm i vivth
  	 
  new SafeExit({ 	 
  	// exitEventNames are blank by default, you need to manually name them all; 	 
+ 	// 'exit' will be omited, as it might cause async callbacks failed to execute; 	 
  	exitEventNames: ['SIGINT', 'SIGTERM', ...otherExitEventNames], 	 
+ 	exitCallback = () => process.exit(0), // OR on deno () => Deno.exit(0), 	 
  	// optional deno example 	 
  	exitCallbackListeners = (eventName) => { 	 
  		const sig = Deno.signal(eventName); 	 

package/dev/index.mjs

@@ -12,6 +12,7 @@ new paths({
 
 new safeExit({
 	exitEventNames: ['SIGINT', 'SIGTERM', 'exit'],
+	exitCallback: () => process.exit(0),
 	exitCallbackListeners: (eventName) => {
 		process.once(eventName, function () {
 			safeExit.instance.exiting.correction(true);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "vivth",
-	"version": "1.0.5",
+	"version": "1.1.0",
 	"description": "extremely simple signal as library primitives",
 	"main": "index.mjs",
 	"types": "./types/index.d.mts",

package/src/class/SafeExit.mjs

@@ -28,6 +28,15 @@ export class SafeExit {
 	 * @description
 	 * @param {Object} options
 	 * @param {ExitEventNames} options.exitEventNames
+	 * @param {()=>void} options.exitCallback
+	 * - standard node/bun:
+	 * ```js
+	 * () => process.exit(0),
+	 * ```
+	 * - Deno:
+	 * ```js
+	 * () => Deno.exit(0),
+	 * ```
 	 * @param {(eventName:string)=>void} [options.exitCallbackListeners]
 	 * - default value
 	 * ```js
@@ -44,7 +53,9 @@ export class SafeExit {
 	 *
 	 * new SafeExit({
 	 * 	// exitEventNames are blank by default, you need to manually name them all;
+	 * 	// 'exit' will be omited, as it might cause async callbacks failed to execute;
 	 * 	exitEventNames: ['SIGINT', 'SIGTERM', ...otherExitEventNames],
+	 * 	exitCallback = () => process.exit(0), // OR on deno () => Deno.exit(0),
 	 * 	// optional deno example
 	 * 	exitCallbackListeners = (eventName) => {
 	 * 		const sig = Deno.signal(eventName);
@@ -56,11 +67,12 @@ export class SafeExit {
 	 * 	}
 	 * });
 	 */
-	constructor({ exitEventNames, exitCallbackListeners = undefined }) {
+	constructor({ exitEventNames, exitCallback, exitCallbackListeners = undefined }) {
 		if (SafeExit.instance) {
 			return SafeExit.instance;
 		}
 		SafeExit.instance = this;
+		this.#exit = exitCallback;
 		if (exitCallbackListeners) {
 			this.#exitCallbackListeners = exitCallbackListeners;
 		}
@@ -79,6 +91,9 @@ export class SafeExit {
 	 */
 	#register = (exitEventNames) => {
 		exitEventNames.forEach((eventName) => {
+			if (eventName == 'exit') {
+				return;
+			}
 			this.#exitCallbackListeners(eventName);
 		});
 	};
@@ -107,6 +122,10 @@ export class SafeExit {
 	addCallback = (cb) => {
 		safeCleanUpCBs.add(cb);
 	};
+	/**
+	 * @type {()=>void}
+	 */
+	#exit;
 	#autoCleanUp = new Effect(async ({ subscribe }) => {
 		if (!subscribe(this.exiting.env).value) {
 			return;
@@ -117,15 +136,15 @@ export class SafeExit {
 		setOfEffects.forEach((effect) => {
 			effect.options.removeEffect();
 		});
-		safeCleanUpCBs.forEach((cleanup) => {
-			TryAsync(async () => {
+		for await (const cleanup of safeCleanUpCBs) {
+			const [_, error] = await TryAsync(async () => {
 				await cleanup();
-			}).then(([_, error]) => {
-				if (!error) {
-					return;
-				}
-				Console.error(error);
 			});
-		});
+			if (!error) {
+				continue;
+			}
+			Console.error(error);
+		}
+		this.#exit();
 	});
 }

package/src/doc/JSautoDOC.mjs

@@ -257,6 +257,7 @@ export class JSautoDOC {
 				path: { relative: relativePath },
 				baseName: { noExt },
 			} = (await this.#parsedFilesRef.get(path_)).value;
+			const hasNoAutoDoc = /\/\*\*[\s\*]*?@noautodoc[\s\*]*?\*\//.test(await content.string());
 			if (hasValidExportObject) {
 				mjsMain.push(
 					`export { ${noExt} } from '${
@@ -275,7 +276,7 @@ export class JSautoDOC {
 			});
 			if (!error && typedefString) {
 				mjsTypes.push(typedefString.module);
-				if (!/\/\*\*[\s\*]*?@noautodoc[\s\*]*?\*\//.test(await content.string())) {
+				if (!hasNoAutoDoc) {
 					const nameVarID = noExt.toLowerCase();
 					tableOfContent.push(`[${noExt}](#${nameVarID})`);
 					apiDocuments.push(
@@ -285,19 +286,19 @@ export class JSautoDOC {
 					);
 				}
 			}
-			readme.forEach((ref) => {
-				const {
-					// fullDescription,
-					// instanceOrStatic,
-					// namedVar,
-					// typeOfVar,
-					parsedFullDescription,
-					reference,
-				} = ref;
-				const { description, jsPreview } = parsedFullDescription;
-				currentDescription.push(`\n#### reference:${reference}\n${description}\n${jsPreview}`);
-			});
-			if (hasValidExportObject) {
+			if (!hasNoAutoDoc && hasValidExportObject) {
+				readme.forEach((ref) => {
+					const {
+						// fullDescription,
+						// instanceOrStatic,
+						// namedVar,
+						// typeOfVar,
+						parsedFullDescription,
+						reference,
+					} = ref;
+					const { description, jsPreview } = parsedFullDescription;
+					currentDescription.push(`\n#### reference:${reference}\n${description}\n${jsPreview}`);
+				});
 				const nameVarID = noExt.toLowerCase();
 				tableOfContent.push(`[${noExt}](#${noExt.toLowerCase()})`);
 				apiDocuments.push(

package/types/src/class/SafeExit.d.mts

@@ -19,6 +19,15 @@ export class SafeExit<ExitEventNames extends [string, ...string[]]> {
      * @description
      * @param {Object} options
      * @param {ExitEventNames} options.exitEventNames
+     * @param {()=>void} options.exitCallback
+     * - standard node/bun:
+     * ```js
+     * () => process.exit(0),
+     * ```
+     * - Deno:
+     * ```js
+     * () => Deno.exit(0),
+     * ```
      * @param {(eventName:string)=>void} [options.exitCallbackListeners]
      * - default value
      * ```js
@@ -35,7 +44,9 @@ export class SafeExit<ExitEventNames extends [string, ...string[]]> {
      *
      * new SafeExit({
      * 	// exitEventNames are blank by default, you need to manually name them all;
+     * 	// 'exit' will be omited, as it might cause async callbacks failed to execute;
      * 	exitEventNames: ['SIGINT', 'SIGTERM', ...otherExitEventNames],
+     * 	exitCallback = () => process.exit(0), // OR on deno () => Deno.exit(0),
      * 	// optional deno example
      * 	exitCallbackListeners = (eventName) => {
      * 		const sig = Deno.signal(eventName);
@@ -47,8 +58,9 @@ export class SafeExit<ExitEventNames extends [string, ...string[]]> {
      * 	}
      * });
      */
-    constructor({ exitEventNames, exitCallbackListeners }: {
+    constructor({ exitEventNames, exitCallback, exitCallbackListeners }: {
         exitEventNames: ExitEventNames;
+        exitCallback: () => void;
         exitCallbackListeners?: (eventName: string) => void;
     });
     /**