@pezkuwi/util 14.0.13 → 14.0.14

package/build-tsc-esm/is/object.js

@@ -1,18 +0,0 @@
-/**
- * @name isObject
- * @summary Tests for an `object`.
- * @description
- * Checks to see if the input value is a JavaScript object.
- * @example
- * <BR>
- *
- * ```javascript
- * import { isObject } from '@pezkuwi/util';
- *
- * isObject({}); // => true
- * isObject('something'); // => false
- * ```
- */
-export function isObject(value) {
-    return !!value && typeof value === 'object';
-}

package/build-tsc-esm/is/observable.js

@@ -1,16 +0,0 @@
-import { isOn } from './helpers.js';
-/**
- * @name isBObservable
- * @summary Tests for a `Observable` object instance.
- * @description
- * Checks to see if the input object is an instance of `BN` (bn.js).
- * @example
- * <BR>
- *
- * ```javascript
- * import { isObservable } from '@pezkuwi/util';
- *
- * console.log('isObservable', isObservable(...));
- * ```
- */
-export const isObservable = /*#__PURE__*/ isOn('next');

package/build-tsc-esm/is/promise.js

@@ -1,2 +0,0 @@
-import { isOnObject } from './helpers.js';
-export const isPromise = /*#__PURE__*/ isOnObject('catch', 'then');

package/build-tsc-esm/is/riscv.js

@@ -1,17 +0,0 @@
-import { u8aEq } from '../u8a/eq.js';
-import { isU8a } from './u8a.js';
-const ELF_MAGIC = new Uint8Array([0x7f, 0x45, 0x4c, 0x46]); // ELF magic bytes: 0x7f, 'E', 'L', 'F'
-const PVM_MAGIC = new Uint8Array([0x50, 0x56, 0x4d, 0x00]); // 'P', 'V', 'M', 0x00
-/**
- * @name isRiscV
- * @summary Tests if the input has a RISC-V header
- * @description
- * Checks to see if the input Uint8Array contains a valid RISC-V header
- */
-export function isRiscV(bytes) {
-    if (isU8a(bytes)) {
-        const start = bytes.subarray(0, 4);
-        return u8aEq(start, PVM_MAGIC) || u8aEq(start, ELF_MAGIC);
-    }
-    return false;
-}

package/build-tsc-esm/is/string.js

@@ -1,17 +0,0 @@
-/**
- * @name isString
- * @summary Tests for a string.
- * @description
- * Checks to see if the input value is a JavaScript string.
- * @example
- * <BR>
- *
- * ```javascript
- * import { isString } from '@pezkuwi/util';
- *
- * console.log('isString', isString('test')); // => true
- * ```
- */
-export function isString(value) {
-    return typeof value === 'string' || value instanceof String;
-}

package/build-tsc-esm/is/testChain.js

@@ -1,7 +0,0 @@
-const REGEX_DEV = /(Development|Local Testnet)$/;
-export function isTestChain(chain) {
-    if (!chain) {
-        return false;
-    }
-    return !!REGEX_DEV.test(chain.toString());
-}

package/build-tsc-esm/is/toBigInt.js

@@ -1,2 +0,0 @@
-import { isOn } from './helpers.js';
-export const isToBigInt = /*#__PURE__*/ isOn('toBigInt');

package/build-tsc-esm/is/toBn.js

@@ -1,2 +0,0 @@
-import { isOn } from './helpers.js';
-export const isToBn = /*#__PURE__*/ isOn('toBn');

package/build-tsc-esm/is/u8a.js

@@ -1,20 +0,0 @@
-/**
- * @name isU8a
- * @summary Tests for a `Uint8Array` object instance.
- * @description
- * Checks to see if the input object is an instance of `Uint8Array`.
- * @example
- * <BR>
- *
- * ```javascript
- * import { isUint8Array } from '@pezkuwi/util';
- *
- * console.log('isU8a', isU8a([])); // => false
- * ```
- */
-export function isU8a(value) {
-    // here we defer the instanceof check which is actually slightly
-    // slower than just checking the constrctor (direct instances)
-    return (((value && value.constructor) === Uint8Array) ||
-        value instanceof Uint8Array);
-}

package/build-tsc-esm/is/undefined.js

@@ -1,17 +0,0 @@
-/**
- * @name isUndefined
- * @summary Tests for a `undefined` values.
- * @description
- * Checks to see if the input value is `undefined`.
- * @example
- * <BR>
- *
- * ```javascript
- * import { isUndefined } from '@pezkuwi/util';
- *
- * console.log('isUndefined', isUndefined(void(0))); // => true
- * ```
- */
-export function isUndefined(value) {
-    return value === undefined;
-}

package/build-tsc-esm/is/utf8.js

@@ -1,197 +0,0 @@
-import { u8aToU8a } from '../u8a/toU8a.js';
-import { isString } from './string.js';
-/**
- * @name isUtf8
- * @summary Tests if the input is valid Utf8
- * @description
- * Checks to see if the input string or Uint8Array is valid Utf8
- */
-export function isUtf8(value) {
-    if (!value) {
-        return isString(value);
-    }
-    const u8a = u8aToU8a(value);
-    const len = u8a.length;
-    let i = 0;
-    while (i < len) {
-        if (u8a[i] <= 0x7F) /* 00..7F */ {
-            i += 1;
-        }
-        else if (u8a[i] >= 0xC2 && u8a[i] <= 0xDF) /* C2..DF 80..BF */ {
-            if (i + 1 < len) /* Expect a 2nd byte */ {
-                if (u8a[i + 1] < 0x80 || u8a[i + 1] > 0xBF) {
-                    // *message = "After a first byte between C2 and DF, expecting a 2nd byte between 80 and BF";
-                    // *faulty_bytes = 2;
-                    return false;
-                }
-            }
-            else {
-                // *message = "After a first byte between C2 and DF, expecting a 2nd byte.";
-                // *faulty_bytes = 1;
-                return false;
-            }
-            i += 2;
-        }
-        else if (u8a[i] === 0xE0) /* E0 A0..BF 80..BF */ {
-            if (i + 2 < len) /* Expect a 2nd and 3rd byte */ {
-                if (u8a[i + 1] < 0xA0 || u8a[i + 1] > 0xBF) {
-                    // *message = "After a first byte of E0, expecting a 2nd byte between A0 and BF.";
-                    // *faulty_bytes = 2;
-                    return false;
-                }
-                if (u8a[i + 2] < 0x80 || u8a[i + 2] > 0xBF) {
-                    // *message = "After a first byte of E0, expecting a 3nd byte between 80 and BF.";
-                    // *faulty_bytes = 3;
-                    return false;
-                }
-            }
-            else {
-                // *message = "After a first byte of E0, expecting two following bytes.";
-                // *faulty_bytes = 1;
-                return false;
-            }
-            i += 3;
-        }
-        else if (u8a[i] >= 0xE1 && u8a[i] <= 0xEC) /* E1..EC 80..BF 80..BF */ {
-            if (i + 2 < len) /* Expect a 2nd and 3rd byte */ {
-                if (u8a[i + 1] < 0x80 || u8a[i + 1] > 0xBF) {
-                    // *message = "After a first byte between E1 and EC, expecting the 2nd byte between 80 and BF.";
-                    // *faulty_bytes = 2;
-                    return false;
-                }
-                if (u8a[i + 2] < 0x80 || u8a[i + 2] > 0xBF) {
-                    // *message = "After a first byte between E1 and EC, expecting the 3rd byte between 80 and BF.";
-                    // *faulty_bytes = 3;
-                    return false;
-                }
-            }
-            else {
-                // *message = "After a first byte between E1 and EC, expecting two following bytes.";
-                // *faulty_bytes = 1;
-                return false;
-            }
-            i += 3;
-        }
-        else if (u8a[i] === 0xED) /* ED 80..9F 80..BF */ {
-            if (i + 2 < len) /* Expect a 2nd and 3rd byte */ {
-                if (u8a[i + 1] < 0x80 || u8a[i + 1] > 0x9F) {
-                    // *message = "After a first byte of ED, expecting 2nd byte between 80 and 9F.";
-                    // *faulty_bytes = 2;
-                    return false;
-                }
-                if (u8a[i + 2] < 0x80 || u8a[i + 2] > 0xBF) {
-                    // *message = "After a first byte of ED, expecting 3rd byte between 80 and BF.";
-                    // *faulty_bytes = 3;
-                    return false;
-                }
-            }
-            else {
-                // *message = "After a first byte of ED, expecting two following bytes.";
-                // *faulty_bytes = 1;
-                return false;
-            }
-            i += 3;
-        }
-        else if (u8a[i] >= 0xEE && u8a[i] <= 0xEF) /* EE..EF 80..BF 80..BF */ {
-            if (i + 2 < len) /* Expect a 2nd and 3rd byte */ {
-                if (u8a[i + 1] < 0x80 || u8a[i + 1] > 0xBF) {
-                    // *message = "After a first byte between EE and EF, expecting 2nd byte between 80 and BF.";
-                    // *faulty_bytes = 2;
-                    return false;
-                }
-                if (u8a[i + 2] < 0x80 || u8a[i + 2] > 0xBF) {
-                    // *message = "After a first byte between EE and EF, expecting 3rd byte between 80 and BF.";
-                    // *faulty_bytes = 3;
-                    return false;
-                }
-            }
-            else {
-                // *message = "After a first byte between EE and EF, two following bytes.";
-                // *faulty_bytes = 1;
-                return false;
-            }
-            i += 3;
-        }
-        else if (u8a[i] === 0xF0) /* F0 90..BF 80..BF 80..BF */ {
-            if (i + 3 < len) /* Expect a 2nd, 3rd 3th byte */ {
-                if (u8a[i + 1] < 0x90 || u8a[i + 1] > 0xBF) {
-                    // *message = "After a first byte of F0, expecting 2nd byte between 90 and BF.";
-                    // *faulty_bytes = 2;
-                    return false;
-                }
-                if (u8a[i + 2] < 0x80 || u8a[i + 2] > 0xBF) {
-                    // *message = "After a first byte of F0, expecting 3rd byte between 80 and BF.";
-                    // *faulty_bytes = 3;
-                    return false;
-                }
-                if (u8a[i + 3] < 0x80 || u8a[i + 3] > 0xBF) {
-                    // *message = "After a first byte of F0, expecting 4th byte between 80 and BF.";
-                    // *faulty_bytes = 4;
-                    return false;
-                }
-            }
-            else {
-                // *message = "After a first byte of F0, expecting three following bytes.";
-                // *faulty_bytes = 1;
-                return false;
-            }
-            i += 4;
-        }
-        else if (u8a[i] >= 0xF1 && u8a[i] <= 0xF3) /* F1..F3 80..BF 80..BF 80..BF */ {
-            if (i + 3 < len) /* Expect a 2nd, 3rd 3th byte */ {
-                if (u8a[i + 1] < 0x80 || u8a[i + 1] > 0xBF) {
-                    // *message = "After a first byte of F1, F2, or F3, expecting a 2nd byte between 80 and BF.";
-                    // *faulty_bytes = 2;
-                    return false;
-                }
-                if (u8a[i + 2] < 0x80 || u8a[i + 2] > 0xBF) {
-                    // *message = "After a first byte of F1, F2, or F3, expecting a 3rd byte between 80 and BF.";
-                    // *faulty_bytes = 3;
-                    return false;
-                }
-                if (u8a[i + 3] < 0x80 || u8a[i + 3] > 0xBF) {
-                    // *message = "After a first byte of F1, F2, or F3, expecting a 4th byte between 80 and BF.";
-                    // *faulty_bytes = 4;
-                    return false;
-                }
-            }
-            else {
-                // *message = "After a first byte of F1, F2, or F3, expecting three following bytes.";
-                // *faulty_bytes = 1;
-                return false;
-            }
-            i += 4;
-        }
-        else if (u8a[i] === 0xF4) /* F4 80..8F 80..BF 80..BF */ {
-            if (i + 3 < len) /* Expect a 2nd, 3rd 3th byte */ {
-                if (u8a[i + 1] < 0x80 || u8a[i + 1] > 0x8F) {
-                    // *message = "After a first byte of F4, expecting 2nd byte between 80 and 8F.";
-                    // *faulty_bytes = 2;
-                    return false;
-                }
-                if (u8a[i + 2] < 0x80 || u8a[i + 2] > 0xBF) {
-                    // *message = "After a first byte of F4, expecting 3rd byte between 80 and BF.";
-                    // *faulty_bytes = 3;
-                    return false;
-                }
-                if (u8a[i + 3] < 0x80 || u8a[i + 3] > 0xBF) {
-                    // *message = "After a first byte of F4, expecting 4th byte between 80 and BF.";
-                    // *faulty_bytes = 4;
-                    return false;
-                }
-            }
-            else {
-                // *message = "After a first byte of F4, expecting three following bytes.";
-                // *faulty_bytes = 1;
-                return false;
-            }
-            i += 4;
-        }
-        else {
-            // *message = "Expecting bytes in the following ranges: 00..7F C2..F4.";
-            // *faulty_bytes = 1;
-            return false;
-        }
-    }
-    return true;
-}

package/build-tsc-esm/is/wasm.js

@@ -1,12 +0,0 @@
-import { u8aEq } from '../u8a/eq.js';
-import { isU8a } from './u8a.js';
-const WASM_MAGIC = new Uint8Array([0, 97, 115, 109]); // \0asm
-/**
- * @name isWasm
- * @summary Tests if the input has a WASM header
- * @description
- * Checks to see if the input Uint8Array contains a valid WASM header
- */
-export function isWasm(value) {
-    return isU8a(value) && u8aEq(value.subarray(0, 4), WASM_MAGIC);
-}

package/build-tsc-esm/lazy.js

@@ -1,51 +0,0 @@
-/**
- * @name lazyMethod
- * @description
- * Creates a lazy, on-demand getter for the specific value. Upon get the value will be evaluated.
- */
-export function lazyMethod(result, item, creator, getName, index = 0) {
-    const name = getName
-        ? getName(item, index)
-        : item.toString();
-    let value;
-    Object.defineProperty(result, name, {
-        // This allows for re-configuration with the embedded defineProperty below
-        // and ensures that on tested browsers and Node, it _will_ be redefined
-        // and thus short-circuited for future access
-        configurable: true,
-        enumerable: true,
-        // Use a function here, we don't want to capture the outer this, i.e.
-        // don't use arrow functions in this context since we have a this inside
-        get: function () {
-            // This check should _always_ be false and unneeded, since we override
-            // with a value below ... however we ensure we are quire vigilant against
-            // all environment failures, so we are rather be safe than sorry
-            if (value === undefined) {
-                value = creator(item, index, this);
-                try {
-                    // re-define the property as a value, next time around this
-                    // getter will only return the computed value
-                    Object.defineProperty(this, name, { value });
-                }
-                catch {
-                    // ignore any errors, since this _should_ not happen due to
-                    // the "configurable" property above. But if it ever does
-                    // from here-on we will be the cached value the next time
-                    // around (with a very slight dip in performance)
-                }
-            }
-            return value;
-        }
-    });
-}
-/**
- * @name lazyMethods
- * @description
- * Creates lazy, on-demand getters for the specific values.
- */
-export function lazyMethods(result, items, creator, getName) {
-    for (let i = 0, count = items.length; i < count; i++) {
-        lazyMethod(result, items[i], creator, getName, i);
-    }
-    return result;
-}

package/build-tsc-esm/logger.js

@@ -1,118 +0,0 @@
-import { xglobal } from '@pezkuwi/x-global';
-import { formatDate } from './format/formatDate.js';
-import { isBn } from './is/bn.js';
-import { isBuffer } from './is/buffer.js';
-import { isFunction } from './is/function.js';
-import { isObject } from './is/object.js';
-import { isU8a } from './is/u8a.js';
-import { u8aToHex } from './u8a/toHex.js';
-import { u8aToU8a } from './u8a/toU8a.js';
-import { noop } from './noop.js';
-const logTo = {
-    debug: 'log',
-    error: 'error',
-    log: 'log',
-    warn: 'warn'
-};
-function formatOther(value) {
-    if (value && isObject(value) && value.constructor === Object) {
-        const result = {};
-        for (const [k, v] of Object.entries(value)) {
-            result[k] = loggerFormat(v);
-        }
-        return result;
-    }
-    return value;
-}
-export function loggerFormat(value) {
-    if (Array.isArray(value)) {
-        return value.map(loggerFormat);
-    }
-    else if (isBn(value)) {
-        return value.toString();
-    }
-    else if (isU8a(value) || isBuffer(value)) {
-        return u8aToHex(u8aToU8a(value));
-    }
-    return formatOther(value);
-}
-function formatWithLength(maxLength) {
-    return (v) => {
-        if (maxLength <= 0) {
-            return v;
-        }
-        const r = `${v}`;
-        return r.length < maxLength
-            ? v
-            : `${r.substring(0, maxLength)} ...`;
-    };
-}
-function apply(log, type, values, maxSize = -1) {
-    if (values.length === 1 && isFunction(values[0])) {
-        const fnResult = values[0]();
-        return apply(log, type, Array.isArray(fnResult) ? fnResult : [fnResult], maxSize);
-    }
-    console[logTo[log]](formatDate(new Date()), type, ...values
-        .map(loggerFormat)
-        .map(formatWithLength(maxSize)));
-}
-function isDebugOn(e, type) {
-    return !!e && (e === '*' ||
-        type === e ||
-        (e.endsWith('*') &&
-            type.startsWith(e.slice(0, -1))));
-}
-function isDebugOff(e, type) {
-    return !!e && (e.startsWith('-') &&
-        (type === e.slice(1) ||
-            (e.endsWith('*') &&
-                type.startsWith(e.slice(1, -1)))));
-}
-function getDebugFlag(env, type) {
-    let flag = false;
-    for (const e of env) {
-        if (isDebugOn(e, type)) {
-            flag = true;
-        }
-        else if (isDebugOff(e, type)) {
-            flag = false;
-        }
-    }
-    return flag;
-}
-function parseEnv(type) {
-    const maxSize = parseInt(xglobal.process?.env?.['DEBUG_MAX'] || '-1', 10);
-    return [
-        getDebugFlag((xglobal.process?.env?.['DEBUG'] || '').toLowerCase().split(','), type),
-        isNaN(maxSize)
-            ? -1
-            : maxSize
-    ];
-}
-/**
- * @name Logger
- * @summary Creates a consistent log interface for messages
- * @description
- * Returns a `Logger` that has `.log`, `.error`, `.warn` and `.debug` (controlled with environment `DEBUG=typeA,typeB`) methods. Logging is done with a consistent prefix (type of logger, date) followed by the actual message using the underlying console.
- * @example
- * <BR>
- *
- * ```javascript
- * import { logger } from '@pezkuwi/util';
- *
- * const l = logger('test');
- * ```
- */
-export function logger(origin) {
-    const type = `${origin.toUpperCase()}:`.padStart(16);
-    const [isDebug, maxSize] = parseEnv(origin.toLowerCase());
-    return {
-        debug: isDebug
-            ? (...values) => apply('debug', type, values, maxSize)
-            : noop,
-        error: (...values) => apply('error', type, values),
-        log: (...values) => apply('log', type, values),
-        noop,
-        warn: (...values) => apply('warn', type, values)
-    };
-}

package/build-tsc-esm/memoize.js

@@ -1,30 +0,0 @@
-import { stringify } from './stringify.js';
-function defaultGetId() {
-    return 'none';
-}
-/**
- * @name memoize
- * @description Memomize the function with a specific instanceId
- */
-export function memoize(fn, { getInstanceId = defaultGetId } = {}) {
-    const cache = {};
-    const memoized = (...args) => {
-        const stringParams = stringify(args);
-        const instanceId = getInstanceId();
-        if (!cache[instanceId]) {
-            cache[instanceId] = {};
-        }
-        if (cache[instanceId][stringParams] === undefined) {
-            cache[instanceId][stringParams] = fn(...args);
-        }
-        return cache[instanceId][stringParams];
-    };
-    memoized.unmemoize = (...args) => {
-        const stringParams = stringify(args);
-        const instanceId = getInstanceId();
-        if (cache[instanceId]?.[stringParams] !== undefined) {
-            delete cache[instanceId][stringParams];
-        }
-    };
-    return memoized;
-}

package/build-tsc-esm/nextTick.js

@@ -1,24 +0,0 @@
-/**
- * @name nextTick
- * @description Defer the operation to the queue for evaluation on the next tick
- */
-export function nextTick(onExec, onError) {
-    // While Promise.resolve().then(...) would defer to the nextTick, this
-    // actually does not play as nicely in browsers like the setTimeout(...)
-    // approach. So the safer, though less optimal approach is the one taken here
-    setTimeout(() => {
-        Promise
-            .resolve()
-            .then(() => {
-            onExec();
-        })
-            .catch((error) => {
-            if (onError) {
-                onError(error);
-            }
-            else {
-                console.error(error);
-            }
-        });
-    }, 0);
-}

package/build-tsc-esm/noop.js

@@ -1,12 +0,0 @@
-/**
- * A sharable identity function. Returns the input as-is with no transformation applied.
- */
-export function identity(value) {
-    return value;
-}
-/**
- * A sharable noop function. As the name suggests, does nothing
- */
-export function noop() {
-    // noop
-}

package/build-tsc-esm/number/index.js

@@ -1,5 +0,0 @@
-/**
- * @summary Utility methods to convert to and from `number` values
- */
-export { numberToHex } from './toHex.js';
-export { numberToU8a } from './toU8a.js';

package/build-tsc-esm/number/toHex.js

@@ -1,20 +0,0 @@
-import { hexFixLength } from '../hex/fixLength.js';
-/**
- * @name numberToHex
- * @summary Creates a hex value from a number.
- * @description
- * `null`/`undefined`/`NaN` inputs returns an empty `0x` result. `number` input values return the actual bytes value converted to a `hex`. With `bitLength` set, it converts the number to the equivalent size.
- * @example
- * <BR>
- *
- * ```javascript
- * import { numberToHex } from '@pezkuwi/util';
- *
- * numberToHex(0x1234); // => '0x1234'
- * numberToHex(0x1234, 32); // => 0x00001234
- * ```
- */
-export function numberToHex(value, bitLength = -1) {
-    const hex = (!value || Number.isNaN(value) ? 0 : value).toString(16);
-    return hexFixLength(hex.length % 2 ? `0${hex}` : hex, bitLength, true);
-}

package/build-tsc-esm/number/toU8a.js

@@ -1,19 +0,0 @@
-import { hexToU8a } from '../hex/toU8a.js';
-import { numberToHex } from './toHex.js';
-/**
- * @name numberToU8a
- * @summary Creates a Uint8Array object from a number.
- * @description
- * `null`/`undefined`/`NaN` inputs returns an empty `Uint8Array` result. `number` input values return the actual bytes value converted to a `Uint8Array`. With `bitLength`, it converts the value to the equivalent size.
- * @example
- * <BR>
- *
- * ```javascript
- * import { numberToU8a } from '@pezkuwi/util';
- *
- * numberToU8a(0x1234); // => [0x12, 0x34]
- * ```
- */
-export function numberToU8a(value, bitLength = -1) {
-    return hexToU8a(numberToHex(value, bitLength));
-}

package/build-tsc-esm/object/clear.js

@@ -1,11 +0,0 @@
-/**
- * @name objectClear
- * @summary Removes all the keys from the input object
- */
-export function objectClear(value) {
-    const keys = Object.keys(value);
-    for (let i = 0, count = keys.length; i < count; i++) {
-        delete value[keys[i]];
-    }
-    return value;
-}

package/build-tsc-esm/object/copy.js

@@ -1,8 +0,0 @@
-import { objectSpread } from './spread.js';
-/**
- * @name objectCopy
- * @summary Creates a shallow clone of the input object
- */
-export function objectCopy(source) {
-    return objectSpread({}, source);
-}

package/build-tsc-esm/object/entries.js

@@ -1,7 +0,0 @@
-/**
- * @name objectEntries
- * @summary A version of Object.entries that is typed for TS
- */
-export function objectEntries(obj) {
-    return Object.entries(obj);
-}

package/build-tsc-esm/object/index.js

@@ -1,7 +0,0 @@
-export { objectClear } from './clear.js';
-export { objectCopy } from './copy.js';
-export { objectEntries } from './entries.js';
-export { objectKeys } from './keys.js';
-export { objectProperties, objectProperty } from './property.js';
-export { objectSpread } from './spread.js';
-export { objectValues } from './values.js';