vivth 1.4.1 → 1.4.3

package/README.md

@@ -95,8 +95,6 @@ npm i vivth
 - [Timeout](#timeout)
 - [Tries](#tries)
 - [TryAsync](#tryasync)
-- [TryAsyncCall](#tryasynccall)
-- [TryCall](#trycall)
 - [TryNew](#trynew)
 - [TrySync](#trysync)
 - [TsToMjs](#tstomjs)
@@ -3399,70 +3397,6 @@ let [res, error] = await TryAsync(async () => {
 
 \*) <sub>[go to list of exported API and typehelpers](#list-of-exported-api-and-typehelpers)</sub>
 
-<h2 id="tryasynccall">TryAsyncCall</h2>
-
-#### reference:`TryAsyncCall`
-
-- function helper to turn unsafe callback into safe one without tryCatch block;
-- usefull to flatten your source code;
-
-```js
-/**
- * @template {(...param:any[])=>Promise<any>} UNSAFEASYNCCALLBACK
- * @param {UNSAFEASYNCCALLBACK} unsafeAsyncCallback
- * @returns {(...param:Parameters<UNSAFEASYNCCALLBACK>)=> Promise<
- * [Awaited<ReturnType<UNSAFEASYNCCALLBACK>>,undefined]|
- * [undefined,Error]>}
- */
-```
-
-- <i>example</i>:
-
-```js
-import { TryAsyncCall } from "vivth";
-
-(async () => {
-  const [result, error] = await TryAsyncCall(unsafeAsyncCallback)(
-    ...unsafeAsyncCallbackParameters,
-  );
-  if (!error) {
-    // do something with result
-  }
-})();
-```
-
-\*) <sub>[go to list of exported API and typehelpers](#list-of-exported-api-and-typehelpers)</sub>
-
-<h2 id="trycall">TryCall</h2>
-
-#### reference:`TryCall`
-
-- function helper to turn unsafe callback into safe one without tryCatch block;
-- usefull to flatten your source code;
-
-```js
-/**
- * @template {(...param:any[])=>any} UNSAFECALLBACK
- * @param {UNSAFECALLBACK} unsafeCallback
- * @returns {(...param:Parameters<UNSAFECALLBACK>)=>
- * [ReturnType<UNSAFECALLBACK>,undefined]|
- * [undefined,Error]}
- */
-```
-
-- <i>example</i>:
-
-```js
-import { TryCall } from "vivth";
-
-const [result, error] = TryCall(unsafeCallback)(...unsafeCallbackParameters);
-if (!error) {
-  // do something with result
-}
-```
-
-\*) <sub>[go to list of exported API and typehelpers](#list-of-exported-api-and-typehelpers)</sub>
-
 <h2 id="trynew">TryNew</h2>
 
 #### reference:`TryNew`
@@ -3474,8 +3408,8 @@ if (!error) {
 /**
  * @template {new (...args: any[]) => any} CLASSREF
  * @param {CLASSREF} classReference
- * @returns {(...args: ConstructorParameters<CLASSREF>) =>
- * [InstanceType<CLASSREF>, undefined]|
+ * @param {ConstructorParameters<CLASSREF>} params
+ * @returns {[InstanceType<CLASSREF>, undefined]|
  * [undefined, Error]}
  */
 ```
@@ -3485,9 +3419,9 @@ if (!error) {
 ```js
 import { TryNew } from "vivth";
 
-const [instance, error] = TryNew(ClassReference)(...classConstructorParameters);
+const [instance, error] = TryNew(ClassReference, ...classConstructorParameters);
 if (!error) {
-  // do something with instance
+  // do something with instance safely;
 }
 ```
 
@@ -3512,7 +3446,7 @@ if (!error) {
 - <i>example</i>:
 
 ```js
-import { readFileSync } from "fs";
+import { readFileSync } from "node:fs";
 import { TrySync } from "./yourModule.js";
 
 const [data, error] = TrySync(() => {

package/index.mjs

@@ -48,8 +48,6 @@ export { LazyFactory } from './src/function/LazyFactory.mjs';
 export { Timeout } from './src/function/Timeout.mjs';
 export { Tries } from './src/function/Tries.mjs';
 export { TryAsync } from './src/function/TryAsync.mjs';
-export { TryAsyncCall } from './src/function/TryAsyncCall.mjs';
-export { TryCall } from './src/function/TryCall.mjs';
 export { TryNew } from './src/function/TryNew.mjs';
 export { TrySync } from './src/function/TrySync.mjs';
 export { TsToMjs } from './src/function/TsToMjs.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "vivth",
-	"version": "1.4.1",
+	"version": "1.4.3",
 	"description": "library primitives",
 	"main": "index.mjs",
 	"types": "./types/index.d.mts",

package/src/function/TryAsync.mjs

@@ -1,5 +1,7 @@
 // @ts-check
 
+import { resolveErrorArray } from './resolveErrorArray.mjs';
+
 /**
  * @description
  * - function for error as value for asynchronous operation;
@@ -26,7 +28,6 @@ export async function TryAsync(asyncFunction_) {
 		const result = await asyncFunction_();
 		return [result, undefined];
 	} catch (error) {
-		// @ts-expect-error
-		return [undefined, error];
+		return resolveErrorArray(error);
 	}
 }

package/src/function/TryNew.mjs

@@ -1,29 +1,28 @@
 // @ts-check
 
+import { resolveErrorArray } from './resolveErrorArray.mjs';
+
 /**
  * @description
  * - function helper to turn unsafe constructor call of classReference into safe one without tryCatch block;
  * - usefull to flatten your source code;
  * @template {new (...args: any[]) => any} CLASSREF
  * @param {CLASSREF} classReference
- * @returns {(...args: ConstructorParameters<CLASSREF>) =>
- * [InstanceType<CLASSREF>, undefined]|
+ * @param {ConstructorParameters<CLASSREF>} params
+ * @returns {[InstanceType<CLASSREF>, undefined]|
  * [undefined, Error]}
  * @example
  * import { TryNew } from 'vivth';
  *
- * const [instance, error] = TryNew(ClassReference)(...classConstructorParameters)
+ * const [instance, error] = TryNew(ClassReference, ...classConstructorParameters)
  * if(!error) {
- *  // do something with instance
+ *   // do something with instance safely;
  * }
  */
-export function TryNew(classReference) {
-	// @ts-expect-error
-	return (...params) => {
-		try {
-			return [new classReference(...params), undefined];
-		} catch (err) {
-			return [undefined, err];
-		}
-	};
+export function TryNew(classReference, ...params) {
+	try {
+		return [new classReference(...params), undefined];
+	} catch (error) {
+		return resolveErrorArray(error);
+	}
 }

package/src/function/TrySync.mjs

@@ -1,5 +1,7 @@
 // @ts-check
 
+import { resolveErrorArray } from './resolveErrorArray.mjs';
+
 /**
  * @description
  * - function for error as value for synchronous operation;
@@ -9,7 +11,7 @@
  * @returns {[RESULT,undefined]|
  * [undefined,Error]}
  * @example
- * import { readFileSync } from 'fs';
+ * import { readFileSync } from 'node:fs';
  * import { TrySync } from './yourModule.js';
  *
  * const [data, error] = TrySync(() => {
@@ -21,7 +23,6 @@ export function TrySync(function_) {
 		const result = function_();
 		return [result, undefined];
 	} catch (error) {
-		// @ts-expect-error
-		return [undefined, error];
+		return resolveErrorArray(error);
 	}
 }

package/src/function/resolveErrorArray.mjs

@@ -0,0 +1,9 @@
+// @ts-check
+
+/**
+ * @param {unknown} unknown
+ * @returns {[undefined, Error]}
+ */
+export const resolveErrorArray = (unknown) => {
+	return [undefined, unknown instanceof Error ? unknown : new Error(String(unknown))];
+};

package/types/index.d.mts

@@ -40,8 +40,6 @@ export { LazyFactory } from "./src/function/LazyFactory.mjs";
 export { Timeout } from "./src/function/Timeout.mjs";
 export { Tries } from "./src/function/Tries.mjs";
 export { TryAsync } from "./src/function/TryAsync.mjs";
-export { TryAsyncCall } from "./src/function/TryAsyncCall.mjs";
-export { TryCall } from "./src/function/TryCall.mjs";
 export { TryNew } from "./src/function/TryNew.mjs";
 export { TrySync } from "./src/function/TrySync.mjs";
 export { TsToMjs } from "./src/function/TsToMjs.mjs";

package/types/src/function/TryNew.d.mts

@@ -4,15 +4,15 @@
  * - usefull to flatten your source code;
  * @template {new (...args: any[]) => any} CLASSREF
  * @param {CLASSREF} classReference
- * @returns {(...args: ConstructorParameters<CLASSREF>) =>
- * [InstanceType<CLASSREF>, undefined]|
+ * @param {ConstructorParameters<CLASSREF>} params
+ * @returns {[InstanceType<CLASSREF>, undefined]|
  * [undefined, Error]}
  * @example
  * import { TryNew } from 'vivth';
  *
- * const [instance, error] = TryNew(ClassReference)(...classConstructorParameters)
+ * const [instance, error] = TryNew(ClassReference, ...classConstructorParameters)
  * if(!error) {
- *  // do something with instance
+ *   // do something with instance safely;
  * }
  */
-export function TryNew<CLASSREF extends new (...args: any[]) => any>(classReference: CLASSREF): (...args: ConstructorParameters<CLASSREF>) => [InstanceType<CLASSREF>, undefined] | [undefined, Error];
+export function TryNew<CLASSREF extends new (...args: any[]) => any>(classReference: CLASSREF, ...params: ConstructorParameters<CLASSREF>): [InstanceType<CLASSREF>, undefined] | [undefined, Error];

package/types/src/function/TrySync.d.mts

@@ -7,7 +7,7 @@
  * @returns {[RESULT,undefined]|
  * [undefined,Error]}
  * @example
- * import { readFileSync } from 'fs';
+ * import { readFileSync } from 'node:fs';
  * import { TrySync } from './yourModule.js';
  *
  * const [data, error] = TrySync(() => {

package/types/src/function/resolveErrorArray.d.mts

@@ -0,0 +1 @@
+export function resolveErrorArray(unknown: unknown): [undefined, Error];

package/src/function/TryAsyncCall.mjs

@@ -1,31 +0,0 @@
-// @ts-check
-
-/**
- * @description
- * - function helper to turn unsafe callback into safe one without tryCatch block;
- * - usefull to flatten your source code;
- * @template {(...param:any[])=>Promise<any>} UNSAFEASYNCCALLBACK
- * @param {UNSAFEASYNCCALLBACK} unsafeAsyncCallback
- * @returns {(...param:Parameters<UNSAFEASYNCCALLBACK>)=> Promise<
- * [Awaited<ReturnType<UNSAFEASYNCCALLBACK>>,undefined]|
- * [undefined,Error]>}
- * @example
- * import { TryAsyncCall } from 'vivth';
- *
- * (async() => {
- *  const [result, error] = await TryAsyncCall(unsafeAsyncCallback)(...unsafeAsyncCallbackParameters);
- *  if (!error) {
- *   // do something with result
- *  }
- * })()
- */
-export function TryAsyncCall(unsafeAsyncCallback) {
-	// @ts-expect-error
-	return async (...params) => {
-		try {
-			return [await unsafeAsyncCallback(...params), undefined];
-		} catch (err) {
-			return [undefined, err];
-		}
-	};
-}

package/src/function/TryCall.mjs

@@ -1,29 +0,0 @@
-// @ts-check
-
-/**
- * @description
- * - function helper to turn unsafe callback into safe one without tryCatch block;
- * - usefull to flatten your source code;
- * @template {(...param:any[])=>any} UNSAFECALLBACK
- * @param {UNSAFECALLBACK} unsafeCallback
- * @returns {(...param:Parameters<UNSAFECALLBACK>)=>
- * [ReturnType<UNSAFECALLBACK>,undefined]|
- * [undefined,Error]}
- * @example
- * import { TryCall } from 'vivth';
- *
- * const [result, error] = TryCall(unsafeCallback)(...unsafeCallbackParameters);
- * if (!error) {
- *  // do something with result
- * }
- */
-export function TryCall(unsafeCallback) {
-	// @ts-expect-error
-	return (...params) => {
-		try {
-			return [unsafeCallback(...params), undefined];
-		} catch (err) {
-			return [undefined, err];
-		}
-	};
-}

package/types/src/function/TryAsyncCall.d.mts

@@ -1,20 +0,0 @@
-/**
- * @description
- * - function helper to turn unsafe callback into safe one without tryCatch block;
- * - usefull to flatten your source code;
- * @template {(...param:any[])=>Promise<any>} UNSAFEASYNCCALLBACK
- * @param {UNSAFEASYNCCALLBACK} unsafeAsyncCallback
- * @returns {(...param:Parameters<UNSAFEASYNCCALLBACK>)=> Promise<
- * [Awaited<ReturnType<UNSAFEASYNCCALLBACK>>,undefined]|
- * [undefined,Error]>}
- * @example
- * import { TryAsyncCall } from 'vivth';
- *
- * (async() => {
- *  const [result, error] = await TryAsyncCall(unsafeAsyncCallback)(...unsafeAsyncCallbackParameters);
- *  if (!error) {
- *   // do something with result
- *  }
- * })()
- */
-export function TryAsyncCall<UNSAFEASYNCCALLBACK extends (...param: any[]) => Promise<any>>(unsafeAsyncCallback: UNSAFEASYNCCALLBACK): (...param: Parameters<UNSAFEASYNCCALLBACK>) => Promise<[Awaited<ReturnType<UNSAFEASYNCCALLBACK>>, undefined] | [undefined, Error]>;

package/types/src/function/TryCall.d.mts

@@ -1,18 +0,0 @@
-/**
- * @description
- * - function helper to turn unsafe callback into safe one without tryCatch block;
- * - usefull to flatten your source code;
- * @template {(...param:any[])=>any} UNSAFECALLBACK
- * @param {UNSAFECALLBACK} unsafeCallback
- * @returns {(...param:Parameters<UNSAFECALLBACK>)=>
- * [ReturnType<UNSAFECALLBACK>,undefined]|
- * [undefined,Error]}
- * @example
- * import { TryCall } from 'vivth';
- *
- * const [result, error] = TryCall(unsafeCallback)(...unsafeCallbackParameters);
- * if (!error) {
- *  // do something with result
- * }
- */
-export function TryCall<UNSAFECALLBACK extends (...param: any[]) => any>(unsafeCallback: UNSAFECALLBACK): (...param: Parameters<UNSAFECALLBACK>) => [ReturnType<UNSAFECALLBACK>, undefined] | [undefined, Error];