@agrozyme/numeric 1.0.24 → 1.0.25

package/README.md

@@ -46,6 +46,33 @@ Same as [Etehreum Constants](https://www.npmjs.com/package/@ethersproject/consta
 
 ## Helper Functions
 
+- tryParse: try parse value to Numeric
+
+```ts
+const test = tryParse('test');
+//  test is false
+```
+
+- isRange: test value range
+
+```ts
+const test = isRange(0, -10n, '10');
+```
+
+- isInteger: test value is a integer
+
+```ts
+const test = isInteger('0.1');
+```
+
+- isUnsignedIntegerBits: test value is a unsigned integer that has significant bits
+- isSignedIntegerBits: test value is a signed integer that has significant bits
+
+```ts
+const test1 = isUnsignedIntegerBits(8n, '256');
+const test2 = isSignedIntegerBits(8n, '256');
+```
+
 - createArrayCompareFunction: create a simple array compare function
 
 ```ts
@@ -53,6 +80,8 @@ const ascending = createArrayCompareFunction(true);
 const descending = createArrayCompareFunction(false);
 ```
 
+## Format Functions
+
 - formatValue: use [format-number](https://www.npmjs.com/package/format-number) to format a Numeric-Like value
 
 ```ts

package/lib/helper.d.ts

@@ -1,2 +1,11 @@
-import { NumericValue } from './numeric';
+import { Numeric, NumericValue } from './numeric';
+export interface RangeOptions {
+    includeMinimum?: boolean;
+    includeMaximum?: boolean;
+}
+export declare const isRange: (value: NumericValue, minimum: NumericValue, maximum: NumericValue, options?: RangeOptions) => boolean;
+export declare const tryParse: (value: NumericValue) => false | Numeric;
+export declare const isInteger: (value: NumericValue) => boolean;
+export declare const isUnsignedIntegerBits: (bits: bigint, value: NumericValue) => boolean;
+export declare const isSignedIntegerBits: (bits: bigint, value: NumericValue) => boolean;
 export declare const createArrayCompareFunction: (ascending?: boolean) => (left: NumericValue, right: NumericValue) => number;

package/lib/helper.js

@@ -1,7 +1,56 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createArrayCompareFunction = void 0;
+exports.createArrayCompareFunction = exports.isSignedIntegerBits = exports.isUnsignedIntegerBits = exports.isInteger = exports.tryParse = exports.isRange = void 0;
+const constants_1 = require("./constants.js");
 const numeric_1 = require("./numeric.js");
+const isRange = (value, minimum, maximum, options) => {
+    try {
+        const data = (0, numeric_1.toNumeric)(value);
+        const defaultOptions = { includeMaximum: true, includeMinimum: true };
+        const { includeMaximum, includeMinimum } = options ? Object.assign({}, defaultOptions, options) : defaultOptions;
+        const isOverLower = includeMinimum ? data.lessThan(minimum) : data.lessThanOrEqualTo(minimum);
+        const isOverUpper = includeMaximum ? data.greaterThan(maximum) : data.greaterThanOrEqualTo(maximum);
+        return !(isOverLower || isOverUpper);
+    }
+    catch (error) {
+        return false;
+    }
+};
+exports.isRange = isRange;
+const tryParse = (value) => {
+    try {
+        return (0, numeric_1.toNumeric)(value);
+    }
+    catch (error) {
+        return false;
+    }
+};
+exports.tryParse = tryParse;
+const isInteger = (value) => {
+    const data = (0, exports.tryParse)(value);
+    return false !== data && data.isInteger();
+};
+exports.isInteger = isInteger;
+const isUnsignedIntegerBits = (bits, value) => {
+    if (0n > bits || false === (0, exports.isInteger)(value)) {
+        return false;
+    }
+    const maximum = constants_1.Two.toPower(bits);
+    const minimum = constants_1.Zero;
+    const options = { includeMinimum: true, includeMaximum: false };
+    return (0, exports.isRange)(value, minimum, maximum, options);
+};
+exports.isUnsignedIntegerBits = isUnsignedIntegerBits;
+const isSignedIntegerBits = (bits, value) => {
+    if (0n > bits || false === (0, exports.isInteger)(value)) {
+        return false;
+    }
+    const maximum = constants_1.Two.toPower(bits - 1n);
+    const minimum = constants_1.NegativeOne.times(maximum);
+    const options = { includeMinimum: true, includeMaximum: false };
+    return (0, exports.isRange)(value, minimum, maximum, options);
+};
+exports.isSignedIntegerBits = isSignedIntegerBits;
 const createArrayCompareFunction = (ascending = true) => ascending
     ? (left, right) => numeric_1.Numeric.sub(left, right).toNumber()
     : (left, right) => numeric_1.Numeric.sub(right, left).toNumber();

package/lib/helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":";;;AAAA,0CAAkD;AAE3C,MAAM,0BAA0B,GAAG,CAAC,YAAqB,IAAI,EAAE,EAAE,CACtE,SAAS;IACP,CAAC,CAAC,CAAC,IAAkB,EAAE,KAAmB,EAAE,EAAE,CAAC,iBAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE;IAClF,CAAC,CAAC,CAAC,IAAkB,EAAE,KAAmB,EAAE,EAAE,CAAC,iBAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;AAH1E,QAAA,0BAA0B,8BAGgD"}
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"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"}

package/lib/helper.mjs

@@ -1,4 +1,48 @@
-import { Numeric } from "./numeric.mjs";
+import { NegativeOne, Two, Zero } from "./constants.mjs";
+import { Numeric, toNumeric } from "./numeric.mjs";
+export const isRange = (value, minimum, maximum, options) => {
+    try {
+        const data = toNumeric(value);
+        const defaultOptions = { includeMaximum: true, includeMinimum: true };
+        const { includeMaximum, includeMinimum } = options ? Object.assign({}, defaultOptions, options) : defaultOptions;
+        const isOverLower = includeMinimum ? data.lessThan(minimum) : data.lessThanOrEqualTo(minimum);
+        const isOverUpper = includeMaximum ? data.greaterThan(maximum) : data.greaterThanOrEqualTo(maximum);
+        return !(isOverLower || isOverUpper);
+    }
+    catch (error) {
+        return false;
+    }
+};
+export const tryParse = (value) => {
+    try {
+        return toNumeric(value);
+    }
+    catch (error) {
+        return false;
+    }
+};
+export const isInteger = (value) => {
+    const data = tryParse(value);
+    return false !== data && data.isInteger();
+};
+export const isUnsignedIntegerBits = (bits, value) => {
+    if (0n > bits || false === isInteger(value)) {
+        return false;
+    }
+    const maximum = Two.toPower(bits);
+    const minimum = Zero;
+    const options = { includeMinimum: true, includeMaximum: false };
+    return isRange(value, minimum, maximum, options);
+};
+export const isSignedIntegerBits = (bits, value) => {
+    if (0n > bits || false === isInteger(value)) {
+        return false;
+    }
+    const maximum = Two.toPower(bits - 1n);
+    const minimum = NegativeOne.times(maximum);
+    const options = { includeMinimum: true, includeMaximum: false };
+    return isRange(value, minimum, maximum, options);
+};
 export const createArrayCompareFunction = (ascending = true) => ascending
     ? (left, right) => Numeric.sub(left, right).toNumber()
     : (left, right) => Numeric.sub(right, left).toNumber();

package/lib/helper.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helper.mjs","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"OAAO,EAAE,OAAO,EAAgB;AAEhC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,YAAqB,IAAI,EAAE,EAAE,CACtE,SAAS;IACP,CAAC,CAAC,CAAC,IAAkB,EAAE,KAAmB,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE;IAClF,CAAC,CAAC,CAAC,IAAkB,EAAE,KAAmB,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"helper.mjs","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -4,7 +4,8 @@ export { formatValue } from './format';
 export type { IFormatNumberOptions } from './format';
 export { getNumericConfig, setupNumericConfig } from './config';
 export { MaxInt256, MaxUint256, MinInt256, NegativeOne, One, Two, WeiPerEther, Zero } from './constants';
-export { createArrayCompareFunction } from './helper';
+export { createArrayCompareFunction, isInteger, isRange, isSignedIntegerBits, isUnsignedIntegerBits, tryParse, } from './helper';
+export type { RangeOptions } from './helper';
 /**
  * - must use `@types/node@16` for Symbol typing
  * - must put `@types/bn.js` in dependencies section of package.json

package/lib/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createArrayCompareFunction = exports.Zero = exports.WeiPerEther = exports.Two = exports.One = exports.NegativeOne = exports.MinInt256 = exports.MaxUint256 = exports.MaxInt256 = exports.setupNumericConfig = exports.getNumericConfig = exports.formatValue = exports.toNumerics = exports.toNumeric = exports.toIntegerString = exports.toBN = exports.toBigNumber = exports.toBigInteger = exports.toBigInt = exports.Numeric = void 0;
+exports.tryParse = exports.isUnsignedIntegerBits = exports.isSignedIntegerBits = exports.isRange = exports.isInteger = exports.createArrayCompareFunction = exports.Zero = exports.WeiPerEther = exports.Two = exports.One = exports.NegativeOne = exports.MinInt256 = exports.MaxUint256 = exports.MaxInt256 = exports.setupNumericConfig = exports.getNumericConfig = exports.formatValue = exports.toNumerics = exports.toNumeric = exports.toIntegerString = exports.toBN = exports.toBigNumber = exports.toBigInteger = exports.toBigInt = exports.Numeric = void 0;
 var numeric_1 = require("./numeric.js");
 Object.defineProperty(exports, "Numeric", { enumerable: true, get: function () { return numeric_1.Numeric; } });
 Object.defineProperty(exports, "toBigInt", { enumerable: true, get: function () { return numeric_1.toBigInt; } });
@@ -26,6 +26,11 @@ Object.defineProperty(exports, "WeiPerEther", { enumerable: true, get: function
 Object.defineProperty(exports, "Zero", { enumerable: true, get: function () { return constants_1.Zero; } });
 var helper_1 = require("./helper.js");
 Object.defineProperty(exports, "createArrayCompareFunction", { enumerable: true, get: function () { return helper_1.createArrayCompareFunction; } });
+Object.defineProperty(exports, "isInteger", { enumerable: true, get: function () { return helper_1.isInteger; } });
+Object.defineProperty(exports, "isRange", { enumerable: true, get: function () { return helper_1.isRange; } });
+Object.defineProperty(exports, "isSignedIntegerBits", { enumerable: true, get: function () { return helper_1.isSignedIntegerBits; } });
+Object.defineProperty(exports, "isUnsignedIntegerBits", { enumerable: true, get: function () { return helper_1.isUnsignedIntegerBits; } });
+Object.defineProperty(exports, "tryParse", { enumerable: true, get: function () { return helper_1.tryParse; } });
 /**
  * - must use `@types/node@16` for Symbol typing
  * - must put `@types/bn.js` in dependencies section of package.json

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,wCAAuH;AAA9G,kGAAA,OAAO,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,+FAAA,IAAI,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,qGAAA,UAAU,OAAA;AAGnG,sCAAuC;AAA9B,qGAAA,WAAW,OAAA;AAGpB,sCAAgE;AAAvD,0GAAA,gBAAgB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAC7C,4CAAyG;AAAhG,sGAAA,SAAS,OAAA;AAAE,uGAAA,UAAU,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,gGAAA,GAAG,OAAA;AAAE,gGAAA,GAAG,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,iGAAA,IAAI,OAAA;AACnF,sCAAsD;AAA7C,oHAAA,0BAA0B,OAAA;AAEnC;;;;;KAKK"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,wCAAuH;AAA9G,kGAAA,OAAO,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,+FAAA,IAAI,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,qGAAA,UAAU,OAAA;AAGnG,sCAAuC;AAA9B,qGAAA,WAAW,OAAA;AAGpB,sCAAgE;AAAvD,0GAAA,gBAAgB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAC7C,4CAAyG;AAAhG,sGAAA,SAAS,OAAA;AAAE,uGAAA,UAAU,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,gGAAA,GAAG,OAAA;AAAE,gGAAA,GAAG,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,iGAAA,IAAI,OAAA;AAEnF,sCAOkB;AANhB,oHAAA,0BAA0B,OAAA;AAC1B,mGAAA,SAAS,OAAA;AACT,iGAAA,OAAO,OAAA;AACP,6GAAA,mBAAmB,OAAA;AACnB,+GAAA,qBAAqB,OAAA;AACrB,kGAAA,QAAQ,OAAA;AAIV;;;;;KAKK"}

package/lib/index.mjs

@@ -2,7 +2,7 @@ export { Numeric, toBigInt, toBigInteger, toBigNumber, toBN, toIntegerString, to
 export { formatValue } from "./format.mjs";
 export { getNumericConfig, setupNumericConfig } from "./config.mjs";
 export { MaxInt256, MaxUint256, MinInt256, NegativeOne, One, Two, WeiPerEther, Zero } from "./constants.mjs";
-export { createArrayCompareFunction } from "./helper.mjs";
+export { createArrayCompareFunction, isInteger, isRange, isSignedIntegerBits, isUnsignedIntegerBits, tryParse, } from "./helper.mjs";
 /**
  * - must use `@types/node@16` for Symbol typing
  * - must put `@types/bn.js` in dependencies section of package.json

package/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE;OAG9F,EAAE,WAAW,EAAE;OAGf,EAAE,gBAAgB,EAAE,kBAAkB,EAAE;OACxC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE;OAC9E,EAAE,0BAA0B,EAAE;AAErC;;;;;KAKK"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE;OAG9F,EAAE,WAAW,EAAE;OAGf,EAAE,gBAAgB,EAAE,kBAAkB,EAAE;OACxC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE;OAE9E,EACL,0BAA0B,EAC1B,SAAS,EACT,OAAO,EACP,mBAAmB,EACnB,qBAAqB,EACrB,QAAQ,GACT;AAGD;;;;;KAKK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agrozyme/numeric",
-  "version": "1.0.24",
+  "version": "1.0.25",
   "description": "",
   "main": "./lib/index.js",
   "module": "./lib/index.mjs",

package/src/helper.ts

@@ -1,4 +1,58 @@
-import { Numeric, NumericValue } from './numeric';
+import { NegativeOne, Two, Zero } from './constants';
+import { Numeric, NumericValue, toNumeric } from './numeric';
+
+export interface RangeOptions {
+  includeMinimum?: boolean;
+  includeMaximum?: boolean;
+}
+
+export const isRange = (value: NumericValue, minimum: NumericValue, maximum: NumericValue, options?: RangeOptions) => {
+  try {
+    const data = toNumeric(value);
+    const defaultOptions: Required<RangeOptions> = { includeMaximum: true, includeMinimum: true };
+    const { includeMaximum, includeMinimum } = options ? Object.assign({}, defaultOptions, options) : defaultOptions;
+    const isOverLower = includeMinimum ? data.lessThan(minimum) : data.lessThanOrEqualTo(minimum);
+    const isOverUpper = includeMaximum ? data.greaterThan(maximum) : data.greaterThanOrEqualTo(maximum);
+    return !(isOverLower || isOverUpper);
+  } catch (error) {
+    return false;
+  }
+};
+
+export const tryParse = (value: NumericValue) => {
+  try {
+    return toNumeric(value);
+  } catch (error) {
+    return false;
+  }
+};
+
+export const isInteger = (value: NumericValue) => {
+  const data = tryParse(value);
+  return false !== data && data.isInteger();
+};
+
+export const isUnsignedIntegerBits = (bits: bigint, value: NumericValue) => {
+  if (0n > bits || false === isInteger(value)) {
+    return false;
+  }
+
+  const maximum = Two.toPower(bits);
+  const minimum = Zero;
+  const options: RangeOptions = { includeMinimum: true, includeMaximum: false };
+  return isRange(value, minimum, maximum, options);
+};
+
+export const isSignedIntegerBits = (bits: bigint, value: NumericValue) => {
+  if (0n > bits || false === isInteger(value)) {
+    return false;
+  }
+
+  const maximum = Two.toPower(bits - 1n);
+  const minimum = NegativeOne.times(maximum);
+  const options: RangeOptions = { includeMinimum: true, includeMaximum: false };
+  return isRange(value, minimum, maximum, options);
+};
 
 export const createArrayCompareFunction = (ascending: boolean = true) =>
   ascending

package/src/index.ts

@@ -6,7 +6,16 @@ export type { IFormatNumberOptions } from './format';
 
 export { getNumericConfig, setupNumericConfig } from './config';
 export { MaxInt256, MaxUint256, MinInt256, NegativeOne, One, Two, WeiPerEther, Zero } from './constants';
-export { createArrayCompareFunction } from './helper';
+
+export {
+  createArrayCompareFunction,
+  isInteger,
+  isRange,
+  isSignedIntegerBits,
+  isUnsignedIntegerBits,
+  tryParse,
+} from './helper';
+export type { RangeOptions } from './helper';
 
 /**
  * - must use `@types/node@16` for Symbol typing