@rainbow-o23/n1 1.0.49 → 1.0.51

package/README.md

@@ -125,7 +125,8 @@ Pipeline steps provide rich function support, and all the following functions or
 | $logger                                                                  | Get logger instance.                                                                                                                                                                                                 |
 | $date.now()                                                              | Get current datetime, as string.                                                                                                                                                                                     |
 | $date.dayjs                                                              | Get [Day.js](https://day.js.org/).                                                                                                                                                                                   |
-| $math                                                                    | Get [Math.js](https://mathjs.org)                                                                                                                                                                                    |
+| $math                                                                    | Get [Math.js](https://mathjs.org).                                                                                                                                                                                   |
+| $decimal(value: string \| number \| Decimal.value)                       | Create a decimal value by [Decimal.js](https://mikemcl.github.io/decimal.js/).                                                                                                                                       |
 | $nano(size?: number)                                                     | Create a nano string.                                                                                                                                                                                                |
 | $ascii(size?: number)                                                    | Create a nano string, only contains ascii characters (0-9, a-z, A-Z, _).                                                                                                                                             |
 | $error(options: PipelineStepErrorOptions)                                | Throw an exposed uncatchable error.                                                                                                                                                                                  |
@@ -138,11 +139,14 @@ Pipeline steps provide rich function support, and all the following functions or
 | $errors.isUncatchable(e: any)                                            | Check if given is an uncatchable error.                                                                                                                                                                              |
 | $file(options: PipelineStepFileOptions) => PipelineStepFile              | Create a file instance by given options.                                                                                                                                                                             |
 | $clearContextData()                                                      | If the pipeline step does not return anything or returns null or undefined, the context will continue to be used without any modifications.<br>So returning this semaphore indicates clearing the step content data. |
-| isEmpty: (value: any)                                                    | Check if given value is empty or not. Empty includes null value, empty string, array and array likes, map, set and object without keys.                                                                              |
-| isNotEmpty: (value: any)                                                 | Check if given value is not empty or not.                                                                                                                                                                            |
-| isBlank: (value: any)                                                    | Check if given value is blank or not. Blank means null value or a string has no length after trimming.                                                                                                               |
-| isNotBlank: (value: any)                                                 | Check if given value is not blank or not.                                                                                                                                                                            |
-| trim: (value: any)                                                       | Try to trim a string, it's null safe, returns empty string when given value is null. Make sure given value is null or a string, otherwise an exception raised.                                                       |
+| isEmpty: (value: any)                                                    | **@deprecated**, Use `touch` chain instead.                                                                                                                                                                          |
+| isNotEmpty: (value: any)                                                 | **@deprecated**, Use `touch` chain instead.                                                                                                                                                                          |
+| isBlank: (value: any)                                                    | **@deprecated**, Use `touch` chain instead.                                                                                                                                                                          |
+| isNotBlank: (value: any)                                                 | **@deprecated**, Use `touch` chain instead.                                                                                                                                                                          |
+| trim: (value: any)                                                       | **@deprecated**, Use `touch` chain instead.                                                                                                                                                                          |
+| touch: (value: any): IValueOperator                                      | Operate given value, do test, transform.                                                                                                                                                                             |                                                                  
+| noop: () => void                                                         | Noop function.                                                                                                                                                                                                       |
+| asyncNoop: () => Promise<void>                                           | Async noop function.                                                                                                                                                                                                 |
 
 For example:
 
@@ -248,3 +252,37 @@ includes an additional field called `status`, which represents the HTTP response
 | `format.datetime`                  | string  | YYYY-MM-DD HH:mm:ss | Default datetime format, follows [Day.js](https://day.js.org/)                                                                                                                |
 | `pipeline.debug.log.enabled`       | boolean | false               | Enable the pipeline debug log.                                                                                                                                                |
 | `pipeline.performance.log.enabled` | boolean | false               | Enable the pipeline performance log, spent time of pipeline and pipeline step.<br>Translation: If `pipeline.debug.log.enabled` is true, this log output will also be enabled. |
+
+## Value Operator
+
+`o23/n1` provides a value operator to operate given value, do test, transform. The value operator is a chainable operation. For example,
+
+```ts
+// chainable operation, do test, transform, or default value
+$.touch('abc').isNotBlank().orUseDefault('default').value();                        // 'abc'
+$.touch('').isNotBlank.withDefault('default').value();                              // 'default'
+$.touch('123').isNumber().toFixed(2).value();                                       // '123.00'
+$.touch(void 0).isNumber.useDefault(100).value();                                   // 100       
+$.touch(123).isInt.toFixed2.value();                                                // '123.00' 
+$.touch('123.45').within({min: 100, max: 200}).toFixed3().orElse(150).value();      // '123.450'
+
+// success and failure callback
+$.touch(123).isPositive                                                             // isPositive 123
+	.success((value: number) => console.log('isPositive', value))
+	.failure((value: number) => console.log('isNotPositive', value));
+$.touch(-123).isPositive                                                            // isNotPositive -123
+	.success((value: number) => console.log('isPositive', value))
+	.failure((value: number) => console.log('isNotPositive', value));
+
+// check
+$.touch(123).isPositive.ok();                                                       // true
+$.touch(-123).isPositive.ok();                                                      // false
+
+// promisify
+try {
+	const v = await $.touch(123).isPositive.toNumber.promise();                     // resolved 123
+	await VO.of(-123).isPositive.promise();                                         // rejected, -123 can be caught in catch block
+} catch (v) {
+	console.log(v);	                                                                // -123
+}
+```

package/index.cjs

@@ -1,36 +1,10 @@
 'use strict';
 
-var dayjs = require('dayjs');
-var ArraySupport = require('dayjs/plugin/arraySupport.js');
-var CustomParseFormat = require('dayjs/plugin/customParseFormat.js');
-var Duration = require('dayjs/plugin/duration.js');
-var IsToday = require('dayjs/plugin/isToday.js');
-var ObjectSupport = require('dayjs/plugin/objectSupport.js');
-var QuarterOfYear = require('dayjs/plugin/quarterOfYear.js');
-var RelativeTime = require('dayjs/plugin/relativeTime.js');
-var UTC = require('dayjs/plugin/utc.js');
-var WeekOfYear = require('dayjs/plugin/weekOfYear.js');
+var n1 = require('@rainbow-n19/n1');
 var nanoid = require('nanoid');
-var math = require('mathjs');
-
-function _interopNamespaceDefault(e) {
-	var n = Object.create(null);
-	if (e) {
-		Object.keys(e).forEach(function (k) {
-			if (k !== 'default') {
-				var d = Object.getOwnPropertyDescriptor(e, k);
-				Object.defineProperty(n, k, d.get ? d : {
-					enumerable: true,
-					get: function () { return e[k]; }
-				});
-			}
-		});
-	}
-	n.default = e;
-	return Object.freeze(n);
-}
-
-var math__namespace = /*#__PURE__*/_interopNamespaceDefault(math);
+var dayjs = require('dayjs');
+var Decimal = require('decimal.js');
+var mathjs$1 = require('mathjs');
 
 const ERR_PIPELINE_NOT_FOUND = 'O01-00001';
 const ERR_TRIM_NON_STRING = 'O01-00002';
@@ -410,28 +384,53 @@ const createConfig = (logger) => {
     return new Config(logger ?? createLogger());
 };
 
-dayjs.extend(WeekOfYear);
-dayjs.extend(QuarterOfYear);
-dayjs.extend(Duration);
-dayjs.extend(IsToday);
-dayjs.extend(RelativeTime);
-dayjs.extend(ArraySupport);
-dayjs.extend(ObjectSupport);
-dayjs.extend(CustomParseFormat);
-dayjs.extend(UTC);
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol */
+
+
+function __decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+const StaticImplements = () => {
+    return (_constructor) => {
+    };
+};
 
+var StepHelpersUtils_1;
 const PIPELINE_STEP_FILE_SYMBOL = Symbol();
 const PIPELINE_STEP_RETURN_NULL = Symbol();
-class StepHelpersUtils {
+exports.StepHelpersUtils = class StepHelpersUtils {
+    static { StepHelpersUtils_1 = this; }
     static asciiNanoId = nanoid.customAlphabet('1234567890abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_', 32);
-    static OBJECT_PROTOTYPE = Object.prototype;
     constructor() {
     }
     static $nano(size) {
         return nanoid.nanoid(size);
     }
     static $ascii(size) {
-        return StepHelpersUtils.asciiNanoId(size);
+        return StepHelpersUtils_1.asciiNanoId(size);
     }
     static createCatchableError = (options) => {
         throw new CatchableError(options.code, options.reason);
@@ -452,14 +451,14 @@ class StepHelpersUtils {
         return e != null && e instanceof UncatchableError;
     };
     static $errors = {
-        catchable: StepHelpersUtils.createCatchableError,
-        isCatchable: StepHelpersUtils.isCatchableError,
-        exposed: StepHelpersUtils.createExposedUncatchableError,
-        isExposed: StepHelpersUtils.isExposedUncatchableError,
-        uncatchable: StepHelpersUtils.createUncatchableError,
-        isUncatchable: StepHelpersUtils.isUncatchableError
+        catchable: StepHelpersUtils_1.createCatchableError,
+        isCatchable: StepHelpersUtils_1.isCatchableError,
+        exposed: StepHelpersUtils_1.createExposedUncatchableError,
+        isExposed: StepHelpersUtils_1.isExposedUncatchableError,
+        uncatchable: StepHelpersUtils_1.createUncatchableError,
+        isUncatchable: StepHelpersUtils_1.isUncatchableError
     };
-    static createFile(options) {
+    static $file(options) {
         return {
             $file: PIPELINE_STEP_FILE_SYMBOL,
             name: options.name, type: options.type,
@@ -470,48 +469,25 @@ class StepHelpersUtils {
         return PIPELINE_STEP_RETURN_NULL;
     }
     static isPrototype(value) {
-        const Ctor = value && value.constructor;
-        const proto = (typeof Ctor === 'function' && Ctor.prototype) || StepHelpersUtils.OBJECT_PROTOTYPE;
-        return value === proto;
+        return n1.isPrototype(value);
     }
     static isLength(value) {
-        return typeof value === 'number' && value > -1 && value % 1 === 0 && value <= Number.MAX_SAFE_INTEGER;
+        return n1.isLength(value);
     }
     static isArrayLike(value) {
-        return value != null && typeof value !== 'function' && StepHelpersUtils.isLength(value.length);
+        return n1.isArrayLike(value);
     }
     static isEmpty(value) {
-        if (value == null) {
-            return true;
-        }
-        if (StepHelpersUtils.isArrayLike(value) && (Array.isArray(value) || typeof value === 'string')) {
-            return value.length === 0;
-        }
-        else if (value instanceof Map) {
-            return value.size === 0;
-        }
-        else if (value instanceof Set) {
-            return value.size === 0;
-        }
-        else if (StepHelpersUtils.isPrototype(value)) {
-            return Object.keys(value).length === 0;
-        }
-        return false;
+        return n1.ValueOperator.of(value).isEmpty().ok();
     }
     static isNotEmpty(value) {
-        return !StepHelpersUtils.isEmpty(value);
+        return n1.ValueOperator.of(value).isNotEmpty().ok();
     }
     static isBlank(value) {
-        if (value == null) {
-            return true;
-        }
-        if (typeof value !== 'string') {
-            return false;
-        }
-        return value.trim().length === 0;
+        return n1.ValueOperator.of(value).isBlank().ok();
     }
     static isNotBlank(value) {
-        return !StepHelpersUtils.isBlank(value);
+        return n1.ValueOperator.of(value).isNotBlank().ok();
     }
     static trim(value) {
         if (value == null) {
@@ -522,7 +498,17 @@ class StepHelpersUtils {
         }
         throw new UncatchableError(ERR_TRIM_NON_STRING, `Cannot apply trim to non-string object[type=${typeof value}, value=${value}].`);
     }
-}
+    static touch(value) {
+        return n1.ValueOperator.of(value);
+    }
+    static noop() {
+    }
+    static async asyncNoop() {
+    }
+};
+exports.StepHelpersUtils = StepHelpersUtils_1 = __decorate([
+    StaticImplements()
+], exports.StepHelpersUtils);
 
 class PerformanceExecution {
     options;
@@ -636,22 +622,31 @@ const RegisteredHelpers = { helpers: {} };
 const registerToStepHelpers = (helpers) => {
     RegisteredHelpers.helpers = helpers ?? {};
 };
+const mathjs = mathjs$1.create(mathjs$1.all, { number: 'BigNumber', precision: 32 });
 const createStepHelpers = (config, logger) => {
-    return {
+    const helpers = {
         ...RegisteredHelpers.helpers,
         $config: config, $logger: logger,
         $date: new PipelineStepDateHelper(config),
-        $math: math__namespace,
-        $nano: StepHelpersUtils.$nano, $ascii: StepHelpersUtils.$ascii,
-        $error: StepHelpersUtils.createExposedUncatchableError,
+        $math: mathjs,
+        $decimal: (value) => new Decimal(value),
+        $nano: exports.StepHelpersUtils.$nano, $ascii: exports.StepHelpersUtils.$ascii,
+        $error: exports.StepHelpersUtils.createExposedUncatchableError,
         $errorCodes: ErrorCodes,
-        $errors: StepHelpersUtils.$errors,
-        $file: StepHelpersUtils.createFile,
-        $clearContextData: StepHelpersUtils.$clearContextData,
-        isEmpty: StepHelpersUtils.isEmpty, isNotEmpty: StepHelpersUtils.isNotEmpty,
-        isBlank: StepHelpersUtils.isBlank, isNotBlank: StepHelpersUtils.isNotBlank,
-        trim: StepHelpersUtils.trim
+        $errors: exports.StepHelpersUtils.$errors,
+        $file: exports.StepHelpersUtils.$file,
+        $clearContextData: exports.StepHelpersUtils.$clearContextData,
+        isEmpty: exports.StepHelpersUtils.isEmpty, isNotEmpty: exports.StepHelpersUtils.isNotEmpty,
+        isBlank: exports.StepHelpersUtils.isBlank, isNotBlank: exports.StepHelpersUtils.isNotBlank,
+        trim: exports.StepHelpersUtils.trim,
+        touch: exports.StepHelpersUtils.touch,
+        noop: exports.StepHelpersUtils.noop, asyncNoop: exports.StepHelpersUtils.asyncNoop
     };
+    return new Proxy(helpers, {
+        set(_target, _p, _value, _receiver) {
+            return false;
+        }
+    });
 };
 
 class AbstractPipelineStep extends AbstractPipelineExecution {
@@ -811,7 +806,6 @@ exports.PIPELINE_STEP_RETURN_NULL = PIPELINE_STEP_RETURN_NULL;
 exports.PerformanceExecution = PerformanceExecution;
 exports.PipelineRepository = PipelineRepository;
 exports.PipelineStepDateHelper = PipelineStepDateHelper;
-exports.StepHelpersUtils = StepHelpersUtils;
 exports.UncatchableError = UncatchableError;
 exports.createConfig = createConfig;
 exports.createLogger = createLogger;

package/index.d.ts

@@ -1,3 +1,4 @@
+import './lib/envs';
 export * from './lib/utils';
 export * from './lib/pipeline';
 export * from './lib/repo';

package/index.js

@@ -1,15 +1,8 @@
-import dayjs from 'dayjs';
-import ArraySupport from 'dayjs/plugin/arraySupport.js';
-import CustomParseFormat from 'dayjs/plugin/customParseFormat.js';
-import Duration from 'dayjs/plugin/duration.js';
-import IsToday from 'dayjs/plugin/isToday.js';
-import ObjectSupport from 'dayjs/plugin/objectSupport.js';
-import QuarterOfYear from 'dayjs/plugin/quarterOfYear.js';
-import RelativeTime from 'dayjs/plugin/relativeTime.js';
-import UTC from 'dayjs/plugin/utc.js';
-import WeekOfYear from 'dayjs/plugin/weekOfYear.js';
+import { isPrototype, isLength, isArrayLike, ValueOperator } from '@rainbow-n19/n1';
 import { customAlphabet, nanoid } from 'nanoid';
-import * as math from 'mathjs';
+import dayjs from 'dayjs';
+import Decimal from 'decimal.js';
+import { create, all } from 'mathjs';
 
 const ERR_PIPELINE_NOT_FOUND = 'O01-00001';
 const ERR_TRIM_NON_STRING = 'O01-00002';
@@ -389,28 +382,53 @@ const createConfig = (logger) => {
     return new Config(logger ?? createLogger());
 };
 
-dayjs.extend(WeekOfYear);
-dayjs.extend(QuarterOfYear);
-dayjs.extend(Duration);
-dayjs.extend(IsToday);
-dayjs.extend(RelativeTime);
-dayjs.extend(ArraySupport);
-dayjs.extend(ObjectSupport);
-dayjs.extend(CustomParseFormat);
-dayjs.extend(UTC);
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol */
+
+
+function __decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
 
+const StaticImplements = () => {
+    return (_constructor) => {
+    };
+};
+
+var StepHelpersUtils_1;
 const PIPELINE_STEP_FILE_SYMBOL = Symbol();
 const PIPELINE_STEP_RETURN_NULL = Symbol();
-class StepHelpersUtils {
+let StepHelpersUtils = class StepHelpersUtils {
+    static { StepHelpersUtils_1 = this; }
     static asciiNanoId = customAlphabet('1234567890abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_', 32);
-    static OBJECT_PROTOTYPE = Object.prototype;
     constructor() {
     }
     static $nano(size) {
         return nanoid(size);
     }
     static $ascii(size) {
-        return StepHelpersUtils.asciiNanoId(size);
+        return StepHelpersUtils_1.asciiNanoId(size);
     }
     static createCatchableError = (options) => {
         throw new CatchableError(options.code, options.reason);
@@ -431,14 +449,14 @@ class StepHelpersUtils {
         return e != null && e instanceof UncatchableError;
     };
     static $errors = {
-        catchable: StepHelpersUtils.createCatchableError,
-        isCatchable: StepHelpersUtils.isCatchableError,
-        exposed: StepHelpersUtils.createExposedUncatchableError,
-        isExposed: StepHelpersUtils.isExposedUncatchableError,
-        uncatchable: StepHelpersUtils.createUncatchableError,
-        isUncatchable: StepHelpersUtils.isUncatchableError
+        catchable: StepHelpersUtils_1.createCatchableError,
+        isCatchable: StepHelpersUtils_1.isCatchableError,
+        exposed: StepHelpersUtils_1.createExposedUncatchableError,
+        isExposed: StepHelpersUtils_1.isExposedUncatchableError,
+        uncatchable: StepHelpersUtils_1.createUncatchableError,
+        isUncatchable: StepHelpersUtils_1.isUncatchableError
     };
-    static createFile(options) {
+    static $file(options) {
         return {
             $file: PIPELINE_STEP_FILE_SYMBOL,
             name: options.name, type: options.type,
@@ -449,48 +467,25 @@ class StepHelpersUtils {
         return PIPELINE_STEP_RETURN_NULL;
     }
     static isPrototype(value) {
-        const Ctor = value && value.constructor;
-        const proto = (typeof Ctor === 'function' && Ctor.prototype) || StepHelpersUtils.OBJECT_PROTOTYPE;
-        return value === proto;
+        return isPrototype(value);
     }
     static isLength(value) {
-        return typeof value === 'number' && value > -1 && value % 1 === 0 && value <= Number.MAX_SAFE_INTEGER;
+        return isLength(value);
     }
     static isArrayLike(value) {
-        return value != null && typeof value !== 'function' && StepHelpersUtils.isLength(value.length);
+        return isArrayLike(value);
     }
     static isEmpty(value) {
-        if (value == null) {
-            return true;
-        }
-        if (StepHelpersUtils.isArrayLike(value) && (Array.isArray(value) || typeof value === 'string')) {
-            return value.length === 0;
-        }
-        else if (value instanceof Map) {
-            return value.size === 0;
-        }
-        else if (value instanceof Set) {
-            return value.size === 0;
-        }
-        else if (StepHelpersUtils.isPrototype(value)) {
-            return Object.keys(value).length === 0;
-        }
-        return false;
+        return ValueOperator.of(value).isEmpty().ok();
     }
     static isNotEmpty(value) {
-        return !StepHelpersUtils.isEmpty(value);
+        return ValueOperator.of(value).isNotEmpty().ok();
     }
     static isBlank(value) {
-        if (value == null) {
-            return true;
-        }
-        if (typeof value !== 'string') {
-            return false;
-        }
-        return value.trim().length === 0;
+        return ValueOperator.of(value).isBlank().ok();
     }
     static isNotBlank(value) {
-        return !StepHelpersUtils.isBlank(value);
+        return ValueOperator.of(value).isNotBlank().ok();
     }
     static trim(value) {
         if (value == null) {
@@ -501,7 +496,17 @@ class StepHelpersUtils {
         }
         throw new UncatchableError(ERR_TRIM_NON_STRING, `Cannot apply trim to non-string object[type=${typeof value}, value=${value}].`);
     }
-}
+    static touch(value) {
+        return ValueOperator.of(value);
+    }
+    static noop() {
+    }
+    static async asyncNoop() {
+    }
+};
+StepHelpersUtils = StepHelpersUtils_1 = __decorate([
+    StaticImplements()
+], StepHelpersUtils);
 
 class PerformanceExecution {
     options;
@@ -615,22 +620,31 @@ const RegisteredHelpers = { helpers: {} };
 const registerToStepHelpers = (helpers) => {
     RegisteredHelpers.helpers = helpers ?? {};
 };
+const mathjs = create(all, { number: 'BigNumber', precision: 32 });
 const createStepHelpers = (config, logger) => {
-    return {
+    const helpers = {
         ...RegisteredHelpers.helpers,
         $config: config, $logger: logger,
         $date: new PipelineStepDateHelper(config),
-        $math: math,
+        $math: mathjs,
+        $decimal: (value) => new Decimal(value),
         $nano: StepHelpersUtils.$nano, $ascii: StepHelpersUtils.$ascii,
         $error: StepHelpersUtils.createExposedUncatchableError,
         $errorCodes: ErrorCodes,
         $errors: StepHelpersUtils.$errors,
-        $file: StepHelpersUtils.createFile,
+        $file: StepHelpersUtils.$file,
         $clearContextData: StepHelpersUtils.$clearContextData,
         isEmpty: StepHelpersUtils.isEmpty, isNotEmpty: StepHelpersUtils.isNotEmpty,
         isBlank: StepHelpersUtils.isBlank, isNotBlank: StepHelpersUtils.isNotBlank,
-        trim: StepHelpersUtils.trim
+        trim: StepHelpersUtils.trim,
+        touch: StepHelpersUtils.touch,
+        noop: StepHelpersUtils.noop, asyncNoop: StepHelpersUtils.asyncNoop
     };
+    return new Proxy(helpers, {
+        set(_target, _p, _value, _receiver) {
+            return false;
+        }
+    });
 };
 
 class AbstractPipelineStep extends AbstractPipelineExecution {

package/lib/envs.d.ts

@@ -0,0 +1 @@
+import '@rainbow-n19/n1';

package/lib/pipeline/index.d.ts

@@ -1,4 +1,3 @@
-export * from './envs';
 export * from './pipeline-execution';
 export * from './pipeline-step';
 export * from './pipeline';

package/lib/pipeline/step-helpers-utils.d.ts

@@ -1,5 +1,6 @@
+import { IValueOperator } from '@rainbow-n19/n1';
 import { CatchableError, ExposedUncatchableError, UncatchableError } from '../utils';
-import { PipelineStepHelpers } from './index';
+import { PipelineStepHelpers } from './step-helpers';
 export interface PipelineStepErrorOptions {
     status: number;
     code: string;
@@ -18,9 +19,30 @@ export interface PipelineStepFile {
     type?: string;
     content: Buffer;
 }
+export interface IStepHelpersUtils {
+    $nano: (size?: number) => string;
+    $ascii: (size?: number) => string;
+    $errors: {
+        catchable: (options: Omit<PipelineStepErrorOptions, 'status'>) => never;
+        isCatchable: (e: any) => e is CatchableError;
+        exposed: (options: PipelineStepErrorOptions) => never;
+        isExposed: (e: any) => e is ExposedUncatchableError;
+        uncatchable: (options: Omit<PipelineStepErrorOptions, 'status'>) => never;
+        isUncatchable: (e: any) => e is UncatchableError;
+    };
+    $file: (options: PipelineStepFileOptions) => PipelineStepFile;
+    $clearContextData: () => typeof PIPELINE_STEP_RETURN_NULL;
+    isEmpty: (value: any) => boolean;
+    isNotEmpty: (value: any) => boolean;
+    isBlank: (value: any) => boolean;
+    isNotBlank: (value: any) => boolean;
+    trim: (value: any) => string;
+    touch: (value: any) => IValueOperator;
+    noop: (value: any) => void;
+    asyncNoop: (value: any) => Promise<void>;
+}
 export declare class StepHelpersUtils {
     private static asciiNanoId;
-    private static OBJECT_PROTOTYPE;
     private constructor();
     static $nano(size?: number): string;
     static $ascii(size?: number): string;
@@ -31,7 +53,7 @@ export declare class StepHelpersUtils {
     static createUncatchableError: (options: Omit<PipelineStepErrorOptions, "status">) => never;
     static isUncatchableError: (e: any) => e is UncatchableError;
     static readonly $errors: PipelineStepHelpers['$errors'];
-    static createFile(options: PipelineStepFileOptions): PipelineStepFile;
+    static $file(options: PipelineStepFileOptions): PipelineStepFile;
     static $clearContextData(): typeof PIPELINE_STEP_RETURN_NULL;
     static isPrototype(value: any): boolean;
     static isLength(value: any): boolean;
@@ -41,4 +63,7 @@ export declare class StepHelpersUtils {
     static isBlank(value: any): boolean;
     static isNotBlank(value: any): boolean;
     static trim(value: any): string;
+    static touch(value: any): IValueOperator;
+    static noop(): void;
+    static asyncNoop(): Promise<void>;
 }

package/lib/pipeline/step-helpers.d.ts

@@ -1,7 +1,8 @@
 import dayjs from 'dayjs';
-import * as math from 'mathjs';
-import { CatchableError, Config, DateTime, ExposedUncatchableError, Logger, UncatchableError } from '../utils';
-import { PIPELINE_STEP_RETURN_NULL, PipelineStepErrorOptions, PipelineStepFile, PipelineStepFileOptions } from './step-helpers-utils';
+import Decimal from 'decimal.js';
+import { MathJsInstance } from 'mathjs';
+import { Config, DateTime, Logger } from '../utils';
+import { IStepHelpersUtils, PipelineStepErrorOptions } from './step-helpers-utils';
 export declare class PipelineStepDateHelper {
     private readonly _dateTimeFormat;
     constructor(config: Config);
@@ -9,32 +10,17 @@ export declare class PipelineStepDateHelper {
     now(): DateTime;
     get dayjs(): typeof dayjs;
 }
-export type PipelineStepMathHelper = typeof math;
-export interface PipelineStepHelpers {
+export type PipelineStepMathHelper = MathJsInstance;
+export type PipelineStepDecimalHelper = (value: Decimal.Value) => Decimal;
+export interface PipelineStepHelpers extends IStepHelpersUtils {
     $config?: Config;
     $logger?: Logger;
     $date: PipelineStepDateHelper;
     $math: PipelineStepMathHelper;
-    $nano: (size?: number) => string;
-    $ascii: (size?: number) => string;
+    $decimal: PipelineStepDecimalHelper;
     $error: (options: PipelineStepErrorOptions) => never;
     $errorCodes: Readonly<Record<string, string>>;
-    $errors: {
-        catchable: (options: Omit<PipelineStepErrorOptions, 'status'>) => never;
-        isCatchable: (e: any) => e is CatchableError;
-        exposed: (options: PipelineStepErrorOptions) => never;
-        isExposed: (e: any) => e is ExposedUncatchableError;
-        uncatchable: (options: Omit<PipelineStepErrorOptions, 'status'>) => never;
-        isUncatchable: (e: any) => e is UncatchableError;
-    };
-    $file: (options: PipelineStepFileOptions) => PipelineStepFile;
-    $clearContextData: () => typeof PIPELINE_STEP_RETURN_NULL;
-    isEmpty: (value: any) => boolean;
-    isNotEmpty: (value: any) => boolean;
-    isBlank: (value: any) => boolean;
-    isNotBlank: (value: any) => boolean;
-    trim: (value: any) => string;
     [key: string]: any;
 }
 export declare const registerToStepHelpers: (helpers: Record<string, any>) => void;
-export declare const createStepHelpers: (config: Config, logger: Logger) => PipelineStepHelpers;
+export declare const createStepHelpers: (config: Config, logger: Logger) => Readonly<PipelineStepHelpers>;

package/lib/pipeline/types.d.ts

@@ -0,0 +1 @@
+export declare const StaticImplements: <T>() => <U extends T>(_constructor: U) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rainbow-o23/n1",
-	"version": "1.0.49",
+	"version": "1.0.51",
 	"description": "o23 interfaces",
 	"main": "index.cjs",
 	"module": "index.js",
@@ -9,7 +9,7 @@
 	"scripts": {
 		"build": "rollup -c",
 		"build:ci": "rollup -c rollup.config.ci.js",
-		"test": "echo \"Error: no test specified\" && exit 1"
+		"test": "jest"
 	},
 	"repository": {
 		"type": "git",
@@ -21,7 +21,9 @@
 		"url": "https://github.com/InsureMO/rainbow-o23/issues"
 	},
 	"dependencies": {
+		"@rainbow-n19/n1": "latest",
 		"dayjs": "^1.11.13",
+		"decimal.js": "^10.4.3",
 		"mathjs": "^13.2.1",
 		"nanoid": "3.3.7"
 	},
@@ -37,11 +39,32 @@
 		"@typescript-eslint/parser": "^8.13.0",
 		"eslint": "^9.8.0",
 		"rollup": "^3.29.5",
-		"rollup-plugin-tslint": "^0.2.2",
 		"rollup-plugin-typescript2": "^0.34.1",
 		"tslib": "^2.4.1",
 		"typescript": "5.5.4"
 	},
+	"jest": {
+		"moduleFileExtensions": [
+			"js",
+			"json",
+			"ts"
+		],
+		"testRegex": "(/test/.*\\.(test|spec))\\.[tj]sx?$",
+		"testPathIgnorePatterns": [
+			"/node_modules/"
+		],
+		"transform": {
+			"^.+\\.(t|j)s$": "ts-jest"
+		},
+		"collectCoverageFrom": [
+			"src/**/*.(t|j)s"
+		],
+		"coverageDirectory": "./coverage",
+		"coverageReporters": [
+			"html"
+		],
+		"testEnvironment": "node"
+	},
 	"volta": {
 		"extends": "../package.json"
 	}

package/rollup.config.base.js

@@ -18,13 +18,15 @@ export const buildConfig = (lint) => {
 		],
 		plugins: [
 			lint ? eslint({exclude: ['../node_modules/**', 'node_modules/**']}) : null,
-			// lint ? tslint({exclude: ['../node_modules/**', 'node_modules/**']}) : null,
 			typescript({clean: true}),
 			babel({babelHelpers: 'bundled'})
 		].filter(x => x != null),
 		external(id) {
 			return ["dayjs/plugin/"].some(scope => id.startsWith(scope))
-				|| ['nanoid', 'dayjs', 'mathjs'].includes(id);
+				|| [
+					'@rainbow-n19/n1',
+					'nanoid', 'dayjs', 'mathjs', 'decimal.js'
+				].includes(id);
 		}
 	};
 };

package/src/index.ts

@@ -1,3 +1,6 @@
+// make sure it is the first one
+import './lib/envs';
+
 export * from './lib/utils';
 
 export * from './lib/pipeline';

package/src/lib/envs.ts

@@ -0,0 +1,2 @@
+// initial dayjs and decimal.js
+import '@rainbow-n19/n1';

package/src/lib/pipeline/index.ts

@@ -1,4 +1,3 @@
-export * from './envs';
 export * from './pipeline-execution';
 export * from './pipeline-step';
 export * from './pipeline';

package/src/lib/pipeline/step-helpers-utils.ts

@@ -1,6 +1,8 @@
+import {isArrayLike, isLength, isPrototype, IValueOperator, ValueOperator} from '@rainbow-n19/n1';
 import {customAlphabet, nanoid} from 'nanoid';
 import {CatchableError, ERR_TRIM_NON_STRING, ExposedUncatchableError, UncatchableError} from '../utils';
-import {PipelineStepHelpers} from './index';
+import {PipelineStepHelpers} from './step-helpers';
+import {StaticImplements} from './types';
 
 export interface PipelineStepErrorOptions {
 	// exactly same as http status
@@ -25,10 +27,51 @@ export interface PipelineStepFile {
 	content: Buffer;
 }
 
+export interface IStepHelpersUtils {
+	$nano: (size?: number) => string;
+	$ascii: (size?: number) => string;
+	$errors: {
+		catchable: (options: Omit<PipelineStepErrorOptions, 'status'>) => never;
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
+		isCatchable: (e: any) => e is CatchableError;
+		exposed: (options: PipelineStepErrorOptions) => never;
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
+		isExposed: (e: any) => e is ExposedUncatchableError;
+		uncatchable: (options: Omit<PipelineStepErrorOptions, 'status'>) => never;
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
+		isUncatchable: (e: any) => e is UncatchableError;
+	};
+	/** create a file */
+	$file: (options: PipelineStepFileOptions) => PipelineStepFile;
+	$clearContextData: () => typeof PIPELINE_STEP_RETURN_NULL;
+	/** @deprecated */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	isEmpty: (value: any) => boolean;
+	/** @deprecated */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	isNotEmpty: (value: any) => boolean;
+	/** @deprecated */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	isBlank: (value: any) => boolean;
+	/** @deprecated */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	isNotBlank: (value: any) => boolean;
+	/** @deprecated */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	trim: (value: any) => string;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	touch: (value: any) => IValueOperator;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	noop: (value: any) => void;
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	asyncNoop: (value: any) => Promise<void>;
+}
+
+@StaticImplements<IStepHelpersUtils>()
 export class StepHelpersUtils {
 	private static asciiNanoId = customAlphabet('1234567890abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_', 32);
-	private static OBJECT_PROTOTYPE = Object.prototype;
 
+	// noinspection JSUnusedLocalSymbols
 	private constructor() {
 		// avoid extend
 	}
@@ -75,7 +118,7 @@ export class StepHelpersUtils {
 	};
 
 	// file
-	public static createFile(options: PipelineStepFileOptions): PipelineStepFile {
+	public static $file(options: PipelineStepFileOptions): PipelineStepFile {
 		return {
 			$file: PIPELINE_STEP_FILE_SYMBOL,
 			name: options.name, type: options.type,
@@ -91,61 +134,71 @@ export class StepHelpersUtils {
 	// utils
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	public static isPrototype(value: any): boolean {
-		const Ctor = value && value.constructor;
-		const proto = (typeof Ctor === 'function' && Ctor.prototype) || StepHelpersUtils.OBJECT_PROTOTYPE;
-
-		return value === proto;
+		return isPrototype(value);
 	}
 
+	/**
+	 * return true when given value is an integral number, and greater than or equals 0
+	 */
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	public static isLength(value: any): boolean {
-		return typeof value === 'number' && value > -1 && value % 1 === 0 && value <= Number.MAX_SAFE_INTEGER;
+		return isLength(value);
 	}
 
+	/**
+	 * return true when given value is not null, not undefined, not function and has length property.
+	 */
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	public static isArrayLike(value: any): boolean {
-		return value != null && typeof value !== 'function' && StepHelpersUtils.isLength(value.length);
+		return isArrayLike(value);
 	}
 
+	/**
+	 * return true when given value
+	 * 1. is null or undefined
+	 * 2. is array like, array or string, and length is 0
+	 * 3. is map, and size is 0
+	 * 4. is set, and size is 0
+	 * 5. is object, and has no own enumerable property
+	 * @deprecated use {@link touch} instead
+	 */
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	public static isEmpty(value: any): boolean {
-		if (value == null) {
-			return true;
-		}
-		if (StepHelpersUtils.isArrayLike(value) && (Array.isArray(value) || typeof value === 'string')) {
-			return value.length === 0;
-		} else if (value instanceof Map) {
-			return value.size === 0;
-		} else if (value instanceof Set) {
-			return value.size === 0;
-		} else if (StepHelpersUtils.isPrototype(value)) {
-			return Object.keys(value).length === 0;
-		}
-
-		return false;
+		return ValueOperator.of(value).isEmpty().ok();
 	}
 
+	/**
+	 * return true when given value is not {@link isEmpty}
+	 * @deprecated use {@link touch} instead
+	 */
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	public static isNotEmpty(value: any): boolean {
-		return !StepHelpersUtils.isEmpty(value);
+		return ValueOperator.of(value).isNotEmpty().ok();
 	}
 
+	/**
+	 * return true when given value is null, undefined or blank string.
+	 * @deprecated use {@link touch} instead
+	 */
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	public static isBlank(value: any): boolean {
-		if (value == null) {
-			return true;
-		}
-		if (typeof value !== 'string') {
-			return false;
-		}
-		return value.trim().length === 0;
+		return ValueOperator.of(value).isBlank().ok();
 	}
 
+	/**
+	 * return true when given value is not {@link isBlank}
+	 * @deprecated use {@link touch} instead
+	 */
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	public static isNotBlank(value: any): boolean {
-		return !StepHelpersUtils.isBlank(value);
+		return ValueOperator.of(value).isNotBlank().ok();
 	}
 
+	/**
+	 * return trimmed string, or empty string when given value is null or undefined.
+	 * or throw exception when given value is not null, not undefined, and not a string
+	 * @deprecated use {@link touch} instead
+	 */
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	public static trim(value: any): string {
 		if (value == null) {
@@ -156,4 +209,23 @@ export class StepHelpersUtils {
 		}
 		throw new UncatchableError(ERR_TRIM_NON_STRING, `Cannot apply trim to non-string object[type=${typeof value}, value=${value}].`);
 	}
+
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	public static touch(value: any): IValueOperator {
+		return ValueOperator.of(value);
+	}
+
+	/**
+	 * do nothing
+	 */
+	public static noop(): void {
+		// do nothing
+	}
+
+	/**
+	 * do nothing
+	 */
+	public static async asyncNoop(): Promise<void> {
+		// do nothing
+	}
 }

package/src/lib/pipeline/step-helpers.ts

@@ -1,21 +1,8 @@
 import dayjs from 'dayjs';
-import * as math from 'mathjs';
-import {
-	CatchableError,
-	Config,
-	DateTime,
-	ErrorCodes,
-	ExposedUncatchableError,
-	Logger,
-	UncatchableError
-} from '../utils';
-import {
-	PIPELINE_STEP_RETURN_NULL,
-	PipelineStepErrorOptions,
-	PipelineStepFile,
-	PipelineStepFileOptions,
-	StepHelpersUtils
-} from './step-helpers-utils';
+import Decimal from 'decimal.js';
+import {all, create, MathJsInstance} from 'mathjs';
+import {Config, DateTime, ErrorCodes, Logger} from '../utils';
+import {IStepHelpersUtils, PipelineStepErrorOptions, StepHelpersUtils} from './step-helpers-utils';
 
 export class PipelineStepDateHelper {
 	private readonly _dateTimeFormat: string;
@@ -37,42 +24,19 @@ export class PipelineStepDateHelper {
 	}
 }
 
-export type PipelineStepMathHelper = typeof math;
+export type PipelineStepMathHelper = MathJsInstance;
+export type PipelineStepDecimalHelper = (value: Decimal.Value) => Decimal;
 
-export interface PipelineStepHelpers {
+export interface PipelineStepHelpers extends IStepHelpersUtils {
 	$config?: Config;
 	$logger?: Logger;
 	$date: PipelineStepDateHelper;
 	$math: PipelineStepMathHelper;
-	$nano: (size?: number) => string;
-	$ascii: (size?: number) => string;
+	$decimal: PipelineStepDecimalHelper;
+
 	/** create an exposed uncatchable error*/
 	$error: (options: PipelineStepErrorOptions) => never;
 	$errorCodes: Readonly<Record<string, string>>;
-	$errors: {
-		catchable: (options: Omit<PipelineStepErrorOptions, 'status'>) => never;
-		// eslint-disable-next-line @typescript-eslint/no-explicit-any
-		isCatchable: (e: any) => e is CatchableError;
-		exposed: (options: PipelineStepErrorOptions) => never;
-		// eslint-disable-next-line @typescript-eslint/no-explicit-any
-		isExposed: (e: any) => e is ExposedUncatchableError;
-		uncatchable: (options: Omit<PipelineStepErrorOptions, 'status'>) => never;
-		// eslint-disable-next-line @typescript-eslint/no-explicit-any
-		isUncatchable: (e: any) => e is UncatchableError;
-	};
-	/** create a file */
-	$file: (options: PipelineStepFileOptions) => PipelineStepFile;
-	$clearContextData: () => typeof PIPELINE_STEP_RETURN_NULL;
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	isEmpty: (value: any) => boolean;
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	isNotEmpty: (value: any) => boolean;
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	isBlank: (value: any) => boolean;
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	isNotBlank: (value: any) => boolean;
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	trim: (value: any) => string;
 
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	[key: string]: any;
@@ -84,13 +48,15 @@ export const registerToStepHelpers = (helpers: Record<string, any>) => {
 	RegisteredHelpers.helpers = helpers ?? {};
 };
 
-export const createStepHelpers = (config: Config, logger: Logger): PipelineStepHelpers => {
-	return {
+const mathjs = create(all, {number: 'BigNumber', precision: 32});
+export const createStepHelpers = (config: Config, logger: Logger): Readonly<PipelineStepHelpers> => {
+	const helpers: PipelineStepHelpers = {
 		...RegisteredHelpers.helpers,
 		$config: config, $logger: logger,
 		// date
 		$date: new PipelineStepDateHelper(config),
-		$math: math,
+		$math: mathjs,
+		$decimal: (value: Decimal.Value) => new Decimal(value),
 		// nano
 		$nano: StepHelpersUtils.$nano, $ascii: StepHelpersUtils.$ascii,
 		// errors
@@ -98,12 +64,20 @@ export const createStepHelpers = (config: Config, logger: Logger): PipelineStepH
 		$errorCodes: ErrorCodes,
 		$errors: StepHelpersUtils.$errors,
 		// file
-		$file: StepHelpersUtils.createFile,
+		$file: StepHelpersUtils.$file,
 		// semaphore
 		$clearContextData: StepHelpersUtils.$clearContextData,
 		// utilities
 		isEmpty: StepHelpersUtils.isEmpty, isNotEmpty: StepHelpersUtils.isNotEmpty,
 		isBlank: StepHelpersUtils.isBlank, isNotBlank: StepHelpersUtils.isNotBlank,
-		trim: StepHelpersUtils.trim
+		trim: StepHelpersUtils.trim,
+		touch: StepHelpersUtils.touch,
+		noop: StepHelpersUtils.noop, asyncNoop: StepHelpersUtils.asyncNoop
 	};
+	return new Proxy(helpers, {
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unused-vars
+		set(_target: PipelineStepHelpers, _p: string | symbol, _value: any, _receiver: any): boolean {
+			return false;
+		}
+	});
 };

package/src/lib/pipeline/types.ts

@@ -0,0 +1,7 @@
+export const StaticImplements = <T>() => {
+	// eslint-disable-next-line @typescript-eslint/no-unused-vars
+	return <U extends T>(_constructor: U) => {
+		// since only one static method, no need to execute constructor anymore
+		// constructor;
+	};
+};

package/test/value-test.test.ts

@@ -0,0 +1,55 @@
+// noinspection ES6PreferShortImport
+
+import Decimal from 'decimal.js';
+import * as math from 'mathjs';
+import {ValueOperator as VO} from '../src/lib/pipeline/step-helpers-value-operator';
+
+describe('Value test chain', () => {
+	test('Test 1', async () => {
+		expect(VO.from('abc').isNotBlank().orUseDefault('default').value()).toEqual('abc');
+		expect(VO.from('').isNotBlank.withDefault('default').value()).toEqual('default');
+		expect(VO.from('123').isNumber().toFixed(2).value()).toEqual('123.00');
+		expect(VO.from(void 0).isNumber.useDefault(100).value()).toEqual(100);
+		expect(VO.with(123).isInt.toFixed2.value()).toEqual('123.00');
+		expect(VO.of('123.45').within({min: 100, max: 200}).toFixed3().orElse(150).value()).toEqual('123.450');
+		console.log({
+			'math: number, 5.0000000000000001': math.isInteger(5.0000000000000001),
+			'math: string, 5.0000000000000001': math.isInteger('5.0000000000000001' as any),
+			'decimal: number, 5.0000000000000001': new Decimal(5.0000000000000001).isInteger(),
+			'decimal: string, 5.0000000000000001': new Decimal('5.0000000000000001').isInteger(),
+			'math: 0.1 + 0.2': math.chain(0.1).add(0.2).done(),
+			'math: add("0.1 + 0.2")': math.evaluate('0.1 + 0.2'),
+			'decimal: 0.1 + 0.2': new Decimal(0.1).add(0.2).toNumber()
+		});
+
+		VO.of(123).isPositive
+			.success((value: number) => console.log('isPositive', value))
+			.failure((value: number) => console.log('isNotPositive', value));
+		VO.of(-123).isPositive
+			.success((value: number) => console.log('isPositive', value))
+			.failure((value: number) => console.log('isNotPositive', value));
+		expect(VO.of(123).isPositive.ok()).toEqual(true);
+		expect(VO.of(-123).isPositive.ok()).toEqual(false);
+		try {
+			const v = await VO.of(123).isPositive.toNumber.promise();
+			expect(v).toEqual(123);
+			await VO.of(-123).isPositive.promise();
+		} catch (v) {
+			expect(v).toEqual(-123);
+		}
+
+		// console.log(new Decimal({} as any).isInteger());
+		interface AskImportConfigRequest {
+			type?: string;
+			pageSize?: number;
+			pageNumber?: number;
+		}
+
+		const {type, pageSize, pageNumber} = {} as AskImportConfigRequest;
+		const criteria: AskImportConfigRequest = {type};
+		criteria.pageSize = VO.of(pageSize).isPositive.toFixed0.toNumber.orUseDefault(20).value();
+		criteria.pageNumber = VO.of(pageNumber).isPositive.toFixed0.toNumber.orUseDefault(1).value();
+	});
+
+	afterAll((done) => done());
+});

package/lib/pipeline/envs.d.ts

@@ -1 +0,0 @@
-export {};

package/src/lib/pipeline/envs.ts

@@ -1,20 +0,0 @@
-import dayjs from 'dayjs';
-import ArraySupport from 'dayjs/plugin/arraySupport.js';
-import CustomParseFormat from 'dayjs/plugin/customParseFormat.js';
-import Duration from 'dayjs/plugin/duration.js';
-import IsToday from 'dayjs/plugin/isToday.js';
-import ObjectSupport from 'dayjs/plugin/objectSupport.js';
-import QuarterOfYear from 'dayjs/plugin/quarterOfYear.js';
-import RelativeTime from 'dayjs/plugin/relativeTime.js';
-import UTC from 'dayjs/plugin/utc.js';
-import WeekOfYear from 'dayjs/plugin/weekOfYear.js';
-
-dayjs.extend(WeekOfYear);
-dayjs.extend(QuarterOfYear);
-dayjs.extend(Duration);
-dayjs.extend(IsToday);
-dayjs.extend(RelativeTime);
-dayjs.extend(ArraySupport);
-dayjs.extend(ObjectSupport);
-dayjs.extend(CustomParseFormat);
-dayjs.extend(UTC);