@duplojs/utils 1.5.4 → 1.5.5

package/dist/common/index.d.ts

@@ -77,3 +77,4 @@ export * from "./asserts";
 export * from "./path";
 export * from "./transformer";
 export * from "./toRegExp";
+export * from "./justExec";

package/dist/common/justExec.cjs

@@ -0,0 +1,10 @@
+'use strict';
+
+/**
+ * {@include common/justExec/index.md}
+ */
+function justExec(theFunction) {
+    return theFunction();
+}
+
+exports.justExec = justExec;

package/dist/common/justExec.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The justExec() function executes a callback immediately and returns the callback result.
+ * 
+ * **Supported call styles:**
+ * - Classic: `justExec(theFunction)` -> executes `theFunction` and returns its output
+ * - Curried: not available for this function
+ * 
+ * The callback is called once per invocation. The function itself does not transform the callback output.
+ * 
+ * ```ts
+ * const numberResult = justExec(
+ * 	() => 42 as const,
+ * );
+ * // type: 42
+ * 
+ * const objectResult = justExec(
+ * 	() => ({
+ * 		id: 1,
+ * 		name: "ZeRiix",
+ * 	}),
+ * );
+ * // type: { id: number; name: string; }
+ * ```
+ * 
+ * @see https://utils.duplojs.dev/en/v1/api/common/justExec
+ * 
+ */
+export declare function justExec<GenericOutput extends unknown>(theFunction: () => GenericOutput): GenericOutput;

package/dist/common/justExec.mjs

@@ -0,0 +1,8 @@
+/**
+ * {@include common/justExec/index.md}
+ */
+function justExec(theFunction) {
+    return theFunction();
+}
+
+export { justExec };

package/dist/common/stringToBytes.cjs

@@ -12,7 +12,7 @@ class InvalidBytesInStringError extends kind.kindHeritage("invalid-bytes-in-stri
         this.input = input;
     }
 }
-const parseRegExp = /(?<rawValue>[0-9.]+)(?<unit>b|kb|mb|gb|tb|pd)/;
+const parseRegExp = /(?<rawValue>[0-9.]+)(?<unit>b|kb|mb|gb|tb|pb)/;
 const unitMapper = {
     b: 1,
     kb: 1 << 10,

package/dist/common/stringToBytes.mjs

@@ -10,7 +10,7 @@ class InvalidBytesInStringError extends kindHeritage("invalid-bytes-in-string-er
         this.input = input;
     }
 }
-const parseRegExp = /(?<rawValue>[0-9.]+)(?<unit>b|kb|mb|gb|tb|pd)/;
+const parseRegExp = /(?<rawValue>[0-9.]+)(?<unit>b|kb|mb|gb|tb|pb)/;
 const unitMapper = {
     b: 1,
     kb: 1 << 10,

package/dist/dataParser/baseExtended.cjs

@@ -62,6 +62,9 @@ function dataParserExtendedInit(dataParser, rest, specificOverrideHandler) {
         contract() {
             return self;
         },
+        contractExtended() {
+            return self;
+        },
     }, extendedKind.setTo, dataParserExtendedInit.overrideHandler.apply, specificOverrideHandler.apply);
     return self;
 }

package/dist/dataParser/baseExtended.d.ts

@@ -1,4 +1,4 @@
-import { type Kind, type NeverCoalescing, type AnyFunction, type SimplifyTopLevel, type AnyValue, type OverrideHandler, type GetKind, type RemoveKind } from "../common";
+import { type Kind, type NeverCoalescing, type AnyFunction, type SimplifyTopLevel, type AnyValue, type OverrideHandler, type GetKind, type RemoveKind, type IsEqual } from "../common";
 import { type MergeDefinition } from "./types";
 import { type Output, type DataParser, type DataParserDefinition } from "./base";
 import type * as DEither from "../either";
@@ -7,6 +7,7 @@ import * as dataParsersExtended from "./extended";
 import { type DataParserError } from "./error";
 export declare const extendedKind: import("../common").KindHandler<import("../common").KindDefinition<"@DuplojsUtilsDataParser/extended", unknown>>;
 type _DataParserExtended<GenericDefinition extends DataParserDefinition, GenericOutput extends unknown, GenericInput extends unknown> = (DataParser<GenericDefinition, GenericOutput, GenericInput> & Kind<typeof extendedKind.definition>);
+declare const SymbolContractExtendedError: unique symbol;
 export interface DataParserExtended<GenericDefinition extends DataParserDefinition = DataParserDefinition, GenericOutput extends unknown = unknown, GenericInput extends unknown = GenericOutput> extends _DataParserExtended<GenericDefinition, GenericOutput, GenericInput> {
     /**
      * The parse() method runs an extended data parser synchronously and returns an Either with the parsed value or a DataParserError.
@@ -149,6 +150,9 @@ export interface DataParserExtended<GenericDefinition extends DataParserDefiniti
      * 
      */
     clone(): this;
+    contractExtended<GenericValue extends unknown>(...args: IsEqual<Output<this>, GenericValue> extends true ? [] : [] & {
+        [SymbolContractExtendedError]: "ContractExtended error.";
+    }): ContractExtended<GenericValue>;
     /**
      * Creates an array parser from the current parser.
      * 

package/dist/dataParser/baseExtended.mjs

@@ -60,6 +60,9 @@ function dataParserExtendedInit(dataParser, rest, specificOverrideHandler) {
         contract() {
             return self;
         },
+        contractExtended() {
+            return self;
+        },
     }, extendedKind.setTo, dataParserExtendedInit.overrideHandler.apply, specificOverrideHandler.apply);
     return self;
 }

package/dist/index.cjs

@@ -65,6 +65,7 @@ var asserts = require('./common/asserts.cjs');
 var path = require('./common/path.cjs');
 var transformer = require('./common/transformer.cjs');
 var toRegExp = require('./common/toRegExp.cjs');
+var justExec = require('./common/justExec.cjs');
 
 
 
@@ -165,3 +166,4 @@ exports.toJSON = transformer.toJSON;
 exports.toNative = transformer.toNative;
 exports.transformer = transformer.transformer;
 exports.toRegExp = toRegExp.toRegExp;
+exports.justExec = justExec.justExec;

package/dist/index.mjs

@@ -87,3 +87,4 @@ export { AssertsError, asserts } from './common/asserts.mjs';
 export { Path } from './common/path.mjs';
 export { createTransformer, toJSON, toNative, transformer } from './common/transformer.mjs';
 export { toRegExp } from './common/toRegExp.mjs';
+export { justExec } from './common/justExec.mjs';

package/dist/metadata.json

@@ -1415,6 +1415,15 @@
         {
           "name": "isType.mjs"
         },
+        {
+          "name": "justExec.cjs"
+        },
+        {
+          "name": "justExec.d.ts"
+        },
+        {
+          "name": "justExec.mjs"
+        },
         {
           "name": "justReturn.cjs"
         },

package/package.json

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