@duplojs/utils 1.4.46 → 1.4.47

package/dist/dataParser/base.cjs

@@ -42,6 +42,7 @@ function dataParserInit(kind, definition, exec, specificOverrideHandler) {
         : {
             sync: exec,
             async: exec,
+            isAsynchronous: () => false,
         };
     function middleExec(data, error$1) {
         let result = formattedExec.sync(data, error$1, self);
@@ -163,6 +164,9 @@ function dataParserInit(kind, definition, exec, specificOverrideHandler) {
             }
             return result;
         },
+        isAsynchronous() {
+            return formattedExec.isAsynchronous(self);
+        },
     }, (value) => dataParserKind.setTo(value, null), kind.setTo, (value) => dataParserInit.overrideHandler.apply(value), (value) => specificOverrideHandler.apply(value));
     return self;
 }

package/dist/dataParser/base.d.ts

@@ -204,10 +204,44 @@ export interface DataParser<GenericDefinition extends DataParserDefinition = Dat
      * 
      */
     asyncParseOrThrow(data: unknown): Promise<GenericOutput>;
+    /**
+     * The isAsynchronous() method tells whether a data parser requires async execution.
+     * 
+     * **Supported call styles:**
+     * - Method: `dataParser.isAsynchronous()` -> returns a boolean
+     * 
+     * It checks the parser definition (and nested parsers when relevant) and does not run any parsing.
+     * 
+     * ```ts
+     * const syncParser = DDataParser.string();
+     * syncParser.isAsynchronous(); // false
+     * 
+     * const asyncTransform = DDataParser.transform(
+     * 	DDataParser.number(),
+     * 	async(value) => {
+     * 		const result = await Promise.resolve(value);
+     * 
+     * 		return result;
+     * 	},
+     * );
+     * asyncTransform.isAsynchronous(); // true
+     * 
+     * const asyncArray = DDataParser.array(asyncTransform);
+     * asyncArray.isAsynchronous(); // true
+     * 
+     * ```
+     * 
+     * @see https://utils.duplojs.dev/en/v1/api/dataParser/isAsynchronous
+     * 
+     * @namespace DP
+     * 
+     */
+    isAsynchronous(): boolean;
 }
 interface DataParserInitExecParams<GenericDataParser extends DataParser> {
     sync(...args: [...Parameters<GenericDataParser["exec"]>, self: GenericDataParser]): (GetKindValue<typeof dataParserKind, GenericDataParser>["output"] | SymbolDataParserErrorIssue | SymbolDataParserErrorPromiseIssue);
     async(...args: [...Parameters<GenericDataParser["exec"]>, self: GenericDataParser]): Promise<GetKindValue<typeof dataParserKind, GenericDataParser>["output"] | SymbolDataParserErrorIssue | SymbolDataParserErrorPromiseIssue>;
+    isAsynchronous(self: GenericDataParser): boolean;
 }
 declare const DataParserThrowError_base: new (params: {
     "@DuplojsUtilsError/dataParserThrowError"?: unknown;

package/dist/dataParser/base.mjs

@@ -40,6 +40,7 @@ function dataParserInit(kind, definition, exec, specificOverrideHandler) {
         : {
             sync: exec,
             async: exec,
+            isAsynchronous: () => false,
         };
     function middleExec(data, error) {
         let result = formattedExec.sync(data, error, self);
@@ -161,6 +162,9 @@ function dataParserInit(kind, definition, exec, specificOverrideHandler) {
             }
             return result;
         },
+        isAsynchronous() {
+            return formattedExec.isAsynchronous(self);
+        },
     }, (value) => dataParserKind.setTo(value, null), kind.setTo, (value) => dataParserInit.overrideHandler.apply(value), (value) => specificOverrideHandler.apply(value));
     return self;
 }

package/dist/dataParser/parsers/array/index.cjs

@@ -59,6 +59,7 @@ function array(element, definition) {
             void (data.length && error.popErrorPath(error$1));
             return output;
         },
+        isAsynchronous: (self) => self.definition.element.isAsynchronous(),
     }, array.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/array/index.mjs

@@ -57,6 +57,7 @@ function array(element, definition) {
             void (data.length && popErrorPath(error));
             return output;
         },
+        isAsynchronous: (self) => self.definition.element.isAsynchronous(),
     }, array.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/lazy.cjs

@@ -17,6 +17,7 @@ function lazy(getter, definition) {
     }, {
         sync: (data, _error, self) => self.definition.getter.value.exec(data, _error),
         async: (data, _error, self) => self.definition.getter.value.asyncExec(data, _error),
+        isAsynchronous: (self) => self.definition.getter.value.isAsynchronous(),
     }, lazy.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/lazy.mjs

@@ -15,6 +15,7 @@ function lazy(getter, definition) {
     }, {
         sync: (data, _error, self) => self.definition.getter.value.exec(data, _error),
         async: (data, _error, self) => self.definition.getter.value.asyncExec(data, _error),
+        isAsynchronous: (self) => self.definition.getter.value.isAsynchronous(),
     }, lazy.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/nullable.cjs

@@ -27,6 +27,7 @@ function nullable(inner, definition) {
             }
             return self.definition.inner.asyncExec(data, error);
         },
+        isAsynchronous: (self) => self.definition.inner.isAsynchronous(),
     }, nullable.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/nullable.mjs

@@ -25,6 +25,7 @@ function nullable(inner, definition) {
             }
             return self.definition.inner.asyncExec(data, error);
         },
+        isAsynchronous: (self) => self.definition.inner.isAsynchronous(),
     }, nullable.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/object/index.cjs

@@ -4,6 +4,7 @@ var base = require('../../base.cjs');
 var error = require('../../error.cjs');
 var kind = require('../../kind.cjs');
 var memo = require('../../../common/memo.cjs');
+var some = require('../../../array/some.cjs');
 var pipe = require('../../../common/pipe.cjs');
 var map = require('../../../array/map.cjs');
 var filter = require('../../../array/filter.cjs');
@@ -69,6 +70,7 @@ function object(shape, definition) {
             void (self.definition.optimizedShape.value.length && error.popErrorPath(error$1));
             return output;
         },
+        isAsynchronous: (self) => some.some(self.definition.optimizedShape.value, (element) => element.value.isAsynchronous()),
     }, object.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/object/index.mjs

@@ -2,6 +2,7 @@ import { dataParserInit, SymbolDataParserError, dataParserKind } from '../../bas
 import { SymbolDataParserErrorIssue, setErrorPath, popErrorPath } from '../../error.mjs';
 import { createDataParserKind } from '../../kind.mjs';
 import { memo } from '../../../common/memo.mjs';
+import { some } from '../../../array/some.mjs';
 import { pipe } from '../../../common/pipe.mjs';
 import { map } from '../../../array/map.mjs';
 import { filter } from '../../../array/filter.mjs';
@@ -67,6 +68,7 @@ function object(shape, definition) {
             void (self.definition.optimizedShape.value.length && popErrorPath(error));
             return output;
         },
+        isAsynchronous: (self) => some(self.definition.optimizedShape.value, (element) => element.value.isAsynchronous()),
     }, object.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/optional.cjs

@@ -27,6 +27,7 @@ function optional(inner, definition) {
             }
             return self.definition.inner.asyncExec(data, error);
         },
+        isAsynchronous: (self) => self.definition.inner.isAsynchronous(),
     }, optional.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/optional.mjs

@@ -25,6 +25,7 @@ function optional(inner, definition) {
             }
             return self.definition.inner.asyncExec(data, error);
         },
+        isAsynchronous: (self) => self.definition.inner.isAsynchronous(),
     }, optional.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/pipe.cjs

@@ -29,6 +29,7 @@ function pipe(input, output, definition) {
             }
             return self.definition.output.asyncExec(result, error);
         },
+        isAsynchronous: (self) => self.definition.input.isAsynchronous() || self.definition.output.isAsynchronous(),
     }, pipe.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/pipe.mjs

@@ -27,6 +27,7 @@ function pipe(input, output, definition) {
             }
             return self.definition.output.asyncExec(result, error);
         },
+        isAsynchronous: (self) => self.definition.input.isAsynchronous() || self.definition.output.isAsynchronous(),
     }, pipe.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/record/index.cjs

@@ -94,6 +94,7 @@ function record(key, value, definition) {
             }
             return output;
         },
+        isAsynchronous: (self) => self.definition.value.isAsynchronous(),
     }, record.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/record/index.mjs

@@ -93,6 +93,7 @@ function record(key, value, definition) {
             }
             return output;
         },
+        isAsynchronous: (self) => self.definition.value.isAsynchronous(),
     }, record.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/recover.cjs

@@ -27,6 +27,7 @@ function recover(inner, recoveredValue, definition) {
                 ? self.definition.recoveredValue
                 : result;
         },
+        isAsynchronous: (self) => self.definition.inner.isAsynchronous(),
     }, recover.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/recover.mjs

@@ -25,6 +25,7 @@ function recover(inner, recoveredValue, definition) {
                 ? self.definition.recoveredValue
                 : result;
         },
+        isAsynchronous: (self) => self.definition.inner.isAsynchronous(),
     }, recover.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/transform.cjs

@@ -38,6 +38,7 @@ function transform(inner, theFunction, definition) {
             }
             return result;
         },
+        isAsynchronous: (self) => self.definition.theFunction.constructor.name === "AsyncFunction",
     }, transform.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/transform.mjs

@@ -36,6 +36,7 @@ function transform(inner, theFunction, definition) {
             }
             return result;
         },
+        isAsynchronous: (self) => self.definition.theFunction.constructor.name === "AsyncFunction",
     }, transform.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/tuple.cjs

@@ -3,6 +3,7 @@
 var base = require('../base.cjs');
 var error = require('../error.cjs');
 var kind = require('../kind.cjs');
+var some = require('../../array/some.cjs');
 var override = require('../../common/override.cjs');
 
 const tupleKind = kind.createDataParserKind("tuple");
@@ -78,6 +79,7 @@ function tuple(shape, definition) {
             void (self.definition.shape.length && error.popErrorPath(error$1));
             return output;
         },
+        isAsynchronous: (self) => some.some(self.definition.shape, (element) => element.isAsynchronous()) || !!self.definition.rest?.isAsynchronous(),
     }, tuple.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/tuple.mjs

@@ -1,6 +1,7 @@
 import { dataParserInit, SymbolDataParserError } from '../base.mjs';
 import { SymbolDataParserErrorIssue, setErrorPath, popErrorPath } from '../error.mjs';
 import { createDataParserKind } from '../kind.mjs';
+import { some } from '../../array/some.mjs';
 import { createOverride } from '../../common/override.mjs';
 
 const tupleKind = createDataParserKind("tuple");
@@ -76,6 +77,7 @@ function tuple(shape, definition) {
             void (self.definition.shape.length && popErrorPath(error));
             return output;
         },
+        isAsynchronous: (self) => some(self.definition.shape, (element) => element.isAsynchronous()) || !!self.definition.rest?.isAsynchronous(),
     }, tuple.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/union.cjs

@@ -3,6 +3,7 @@
 var base = require('../base.cjs');
 var error = require('../error.cjs');
 var kind = require('../kind.cjs');
+var some = require('../../array/some.cjs');
 var override = require('../../common/override.cjs');
 
 const unionKind = kind.createDataParserKind("union");
@@ -33,6 +34,7 @@ function union(options, definition) {
             }
             return error.SymbolDataParserErrorIssue;
         },
+        isAsynchronous: (self) => some.some(self.definition.options, (element) => element.isAsynchronous()),
     }, union.overrideHandler);
     return self;
 }

package/dist/dataParser/parsers/union.mjs

@@ -1,6 +1,7 @@
 import { dataParserInit, SymbolDataParserError } from '../base.mjs';
 import { SymbolDataParserErrorIssue } from '../error.mjs';
 import { createDataParserKind } from '../kind.mjs';
+import { some } from '../../array/some.mjs';
 import { createOverride } from '../../common/override.mjs';
 
 const unionKind = createDataParserKind("union");
@@ -31,6 +32,7 @@ function union(options, definition) {
             }
             return SymbolDataParserErrorIssue;
         },
+        isAsynchronous: (self) => some(self.definition.options, (element) => element.isAsynchronous()),
     }, union.overrideHandler);
     return self;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duplojs/utils",
-  "version": "1.4.46",
+  "version": "1.4.47",
   "author": {
     "name": "mathcovax",
     "url": "https://github.com/mathcovax"