@pezkuwi/types-codec 16.5.8 → 16.5.9

package/build/cjs/abstract/Array.js

@@ -1,170 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractArray = void 0;
-const util_1 = require("@pezkuwi/util");
-const compareArray_js_1 = require("../utils/compareArray.js");
-/**
- * @name AbstractArray
- * @description
- * This manages codec arrays. It is an extension to Array, providing
- * specific encoding/decoding on top of the base type.
- * @noInheritDoc
- */
-class AbstractArray extends Array {
-    registry;
-    createdAtHash;
-    initialU8aLength;
-    isStorageFallback;
-    /**
-     * @description This ensures that operators such as clice, filter, map, etc. return
-     * new Array instances (without this we need to apply overrides)
-     */
-    static get [Symbol.species]() {
-        return Array;
-    }
-    constructor(registry, length) {
-        super(length);
-        this.registry = registry;
-    }
-    /**
-     * @description The length of the value when encoded as a Uint8Array
-     */
-    get encodedLength() {
-        // We need to loop through all entries since they may have a variable length themselves,
-        // e.g. when a Vec or Compact is contained withing, it has a variable length based on data
-        const count = this.length;
-        let total = (0, util_1.compactToU8a)(count).length;
-        for (let i = 0; i < count; i++) {
-            total += this[i].encodedLength;
-        }
-        return total;
-    }
-    /**
-     * @description returns a hash of the contents
-     */
-    get hash() {
-        return this.registry.hash(this.toU8a());
-    }
-    /**
-     * @description Checks if the value is an empty value
-     */
-    get isEmpty() {
-        return this.length === 0;
-    }
-    /**
-     * @description The length of the value
-     */
-    get length() {
-        // only included here since we ignore inherited docs
-        return super.length;
-    }
-    /**
-     * @description Compares the value of the input to see if there is a match
-     */
-    eq(other) {
-        return (0, compareArray_js_1.compareArray)(this, other);
-    }
-    /**
-     * @description Returns a breakdown of the hex encoding for this Codec
-     */
-    inspect() {
-        return {
-            inner: this.inspectInner(),
-            outer: [(0, util_1.compactToU8a)(this.length)]
-        };
-    }
-    /**
-     * @internal
-     * @description Internal per-item inspection of internal values
-     */
-    inspectInner() {
-        const count = this.length;
-        const inner = new Array(count);
-        for (let i = 0; i < count; i++) {
-            inner[i] = this[i].inspect();
-        }
-        return inner;
-    }
-    /**
-     * @description Converts the Object to an standard JavaScript Array
-     */
-    toArray() {
-        return Array.from(this);
-    }
-    /**
-     * @description Returns a hex string representation of the value
-     */
-    toHex() {
-        return (0, util_1.u8aToHex)(this.toU8a());
-    }
-    /**
-     * @description Converts the Object to to a human-friendly JSON, with additional fields, expansion and formatting of information
-     */
-    toHuman(isExtended, disableAscii) {
-        const count = this.length;
-        const result = new Array(count);
-        for (let i = 0; i < count; i++) {
-            result[i] = this[i] && this[i].toHuman(isExtended, disableAscii);
-        }
-        return result;
-    }
-    /**
-     * @description Converts the Object to JSON, typically used for RPC transfers
-     */
-    toJSON() {
-        const count = this.length;
-        const result = new Array(count);
-        for (let i = 0; i < count; i++) {
-            // We actually log inside the U8a decoding and use JSON.stringify(...), which
-            // means that the Vec may be partially populated (same applies to toHuman, same check)
-            result[i] = this[i] && this[i].toJSON();
-        }
-        return result;
-    }
-    /**
-     * @description Converts the value in a best-fit primitive form
-     */
-    toPrimitive(disableAscii) {
-        const count = this.length;
-        const result = new Array(count);
-        for (let i = 0; i < count; i++) {
-            result[i] = this[i] && this[i].toPrimitive(disableAscii);
-        }
-        return result;
-    }
-    /**
-     * @description Returns the string representation of the value
-     */
-    toString() {
-        const count = this.length;
-        const result = new Array(count);
-        for (let i = 0; i < count; i++) {
-            result[i] = this[i].toString();
-        }
-        return `[${result.join(', ')}]`;
-    }
-    /**
-     * @description Encodes the value as a Uint8Array as per the SCALE specifications
-     * @param isBare true when the value has none of the type-specific prefixes (internal)
-     */
-    toU8a(isBare) {
-        const encoded = this.toU8aInner();
-        return isBare
-            ? (0, util_1.u8aConcatStrict)(encoded)
-            : (0, util_1.u8aConcatStrict)([(0, util_1.compactToU8a)(this.length), ...encoded]);
-    }
-    /**
-     * @internal
-     * @description Internal per-item SCALE encoding of contained values
-     * @param isBare true when the value has none of the type-specific prefixes (internal)
-     */
-    toU8aInner(isBare) {
-        const count = this.length;
-        const encoded = new Array(count);
-        for (let i = 0; i < count; i++) {
-            encoded[i] = this[i].toU8a(isBare);
-        }
-        return encoded;
-    }
-}
-exports.AbstractArray = AbstractArray;

package/build/cjs/abstract/Base.d.ts

@@ -1,75 +0,0 @@
-import type { HexString } from '@pezkuwi/util/types';
-import type { AnyJson, BareOpts, Codec, Inspect, IU8a, Registry } from '../types/index.js';
-/**
- * @name Base
- * @description A type extends the Base class, when it holds a value
- */
-export declare abstract class AbstractBase<T extends Codec> implements Codec {
-    #private;
-    readonly registry: Registry;
-    createdAtHash?: IU8a | undefined;
-    initialU8aLength?: number | undefined;
-    isStorageFallback?: boolean;
-    protected constructor(registry: Registry, value: T, initialU8aLength?: number);
-    /**
-     * @description The length of the value when encoded as a Uint8Array
-     */
-    get encodedLength(): number;
-    /**
-     * @description returns a hash of the contents
-     */
-    get hash(): IU8a;
-    /**
-     * @description returns the inner (wrapped value)
-     */
-    get inner(): T;
-    /**
-     * @description Checks if the value is an empty value
-     */
-    get isEmpty(): boolean;
-    /**
-     * @description Compares the value of the input to see if there is a match
-     */
-    eq(other?: unknown): boolean;
-    /**
-     * @description Returns a breakdown of the hex encoding for this Codec
-     */
-    inspect(): Inspect;
-    /**
-     * @description Returns a hex string representation of the value. isLe returns a LE (number-only) representation
-     */
-    toHex(isLe?: boolean): HexString;
-    /**
-     * @description Converts the Object to to a human-friendly JSON, with additional fields, expansion and formatting of information
-     */
-    toHuman(isExtended?: boolean, disableAscii?: boolean): AnyJson;
-    /**
-     * @description Converts the Object to JSON, typically used for RPC transfers
-     */
-    toJSON(): AnyJson;
-    /**
-     * @description Converts the value in a best-fit primitive form
-     */
-    toPrimitive(disableAscii?: boolean): AnyJson;
-    /**
-     * @description Returns the string representation of the value
-     */
-    toString(): string;
-    /**
-     * @description Encodes the value as a Uint8Array as per the SCALE specifications
-     * @param isBare true when the value has none of the type-specific prefixes (internal)
-     */
-    toU8a(isBare?: BareOpts): Uint8Array;
-    /**
-     * @description Returns the base runtime type name for this instance
-     */
-    abstract toRawType(): string;
-    /**
-     * @description Returns the inner wrapped value (equivalent to valueOf)
-     */
-    unwrap(): T;
-    /**
-     * @description Returns the inner wrapped value
-     */
-    valueOf(): T;
-}

package/build/cjs/abstract/Base.js

@@ -1,105 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractBase = void 0;
-/**
- * @name Base
- * @description A type extends the Base class, when it holds a value
- */
-class AbstractBase {
-    registry;
-    createdAtHash;
-    initialU8aLength;
-    isStorageFallback;
-    #raw;
-    constructor(registry, value, initialU8aLength) {
-        this.initialU8aLength = initialU8aLength;
-        this.#raw = value;
-        this.registry = registry;
-    }
-    /**
-     * @description The length of the value when encoded as a Uint8Array
-     */
-    get encodedLength() {
-        return this.toU8a().length;
-    }
-    /**
-     * @description returns a hash of the contents
-     */
-    get hash() {
-        return this.registry.hash(this.toU8a());
-    }
-    /**
-     * @description returns the inner (wrapped value)
-     */
-    get inner() {
-        return this.#raw;
-    }
-    /**
-     * @description Checks if the value is an empty value
-     */
-    get isEmpty() {
-        return this.#raw.isEmpty;
-    }
-    /**
-     * @description Compares the value of the input to see if there is a match
-     */
-    eq(other) {
-        return this.#raw.eq(other);
-    }
-    /**
-     * @description Returns a breakdown of the hex encoding for this Codec
-     */
-    inspect() {
-        return this.#raw.inspect();
-    }
-    /**
-     * @description Returns a hex string representation of the value. isLe returns a LE (number-only) representation
-     */
-    toHex(isLe) {
-        return this.#raw.toHex(isLe);
-    }
-    /**
-     * @description Converts the Object to to a human-friendly JSON, with additional fields, expansion and formatting of information
-     */
-    toHuman(isExtended, disableAscii) {
-        return this.#raw.toHuman(isExtended, disableAscii);
-    }
-    /**
-     * @description Converts the Object to JSON, typically used for RPC transfers
-     */
-    toJSON() {
-        return this.#raw.toJSON();
-    }
-    /**
-     * @description Converts the value in a best-fit primitive form
-     */
-    toPrimitive(disableAscii) {
-        return this.#raw.toPrimitive(disableAscii);
-    }
-    /**
-     * @description Returns the string representation of the value
-     */
-    toString() {
-        return this.#raw.toString();
-    }
-    /**
-     * @description Encodes the value as a Uint8Array as per the SCALE specifications
-     * @param isBare true when the value has none of the type-specific prefixes (internal)
-     */
-    toU8a(isBare) {
-        return this.#raw.toU8a(isBare);
-    }
-    /**
-     * @description Returns the inner wrapped value (equivalent to valueOf)
-     */
-    unwrap() {
-        return this.#raw;
-    }
-    /**
-     * @description Returns the inner wrapped value
-     */
-    valueOf() {
-        return this.#raw;
-    }
-}
-exports.AbstractBase = AbstractBase;

package/build/cjs/abstract/Int.d.ts

@@ -1,80 +0,0 @@
-import type { HexString } from '@pezkuwi/util/types';
-import type { AnyNumber, Inspect, INumber, IU8a, Registry, UIntBitLength } from '../types/index.js';
-import { BN } from '@pezkuwi/util';
-export declare const DEFAULT_UINT_BITS = 64;
-/**
- * @name AbstractInt
- * @ignore
- * @noInheritDoc
- */
-export declare abstract class AbstractInt extends BN implements INumber {
-    #private;
-    readonly registry: Registry;
-    readonly encodedLength: number;
-    readonly isUnsigned: boolean;
-    createdAtHash?: IU8a;
-    initialU8aLength?: number;
-    isStorageFallback?: boolean;
-    constructor(registry: Registry, value?: AnyNumber | null, bitLength?: UIntBitLength, isSigned?: boolean);
-    /**
-     * @description returns a hash of the contents
-     */
-    get hash(): IU8a;
-    /**
-     * @description Checks if the value is a zero value (align elsewhere)
-     */
-    get isEmpty(): boolean;
-    /**
-     * @description Returns the number of bits in the value
-     */
-    bitLength(): number;
-    /**
-     * @description Compares the value of the input to see if there is a match
-     */
-    eq(other?: unknown): boolean;
-    /**
-     * @description Returns a breakdown of the hex encoding for this Codec
-     */
-    inspect(): Inspect;
-    /**
-     * @description True if this value is the max of the type
-     */
-    isMax(): boolean;
-    /**
-     * @description Returns a BigInt representation of the number
-     */
-    toBigInt(): bigint;
-    /**
-     * @description Returns the BN representation of the number. (Compatibility)
-     */
-    toBn(): BN;
-    /**
-     * @description Returns a hex string representation of the value
-     */
-    toHex(isLe?: boolean): HexString;
-    /**
-     * @description Converts the Object to to a human-friendly JSON, with additional fields, expansion and formatting of information
-     */
-    toHuman(_isExpanded?: boolean): string;
-    /**
-     * @description Converts the Object to JSON, typically used for RPC transfers
-     */
-    toJSON(onlyHex?: boolean): any;
-    /**
-     * @description Returns the value in a primitive form, either number when <= 52 bits, or string otherwise
-     */
-    toPrimitive(): number | string;
-    /**
-     * @description Returns the base runtime type name for this instance
-     */
-    toRawType(): string;
-    /**
-     * @description Returns the string representation of the value
-     * @param base The base to use for the conversion
-     */
-    toString(base?: number): string;
-    /**
-     * @description Encodes the value as a Uint8Array as per the SCALE specifications
-     */
-    toU8a(_isBare?: boolean): Uint8Array;
-}

package/build/cjs/abstract/Int.js

@@ -1,230 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractInt = exports.DEFAULT_UINT_BITS = void 0;
-const util_1 = require("@pezkuwi/util");
-exports.DEFAULT_UINT_BITS = 64;
-const MAX_NUMBER_BITS = 52;
-const MUL_P = new util_1.BN(1_00_00);
-const FORMATTERS = [
-    ['Perquintill', util_1.BN_QUINTILL],
-    ['Perbill', util_1.BN_BILLION],
-    ['Permill', util_1.BN_MILLION],
-    ['Percent', util_1.BN_HUNDRED]
-];
-function isToBn(value) {
-    return (0, util_1.isFunction)(value.toBn);
-}
-function toPercentage(value, divisor) {
-    return `${(value.mul(MUL_P).div(divisor).toNumber() / 100).toFixed(2)}%`;
-}
-/** @internal */
-function decodeAbstractInt(value, isNegative) {
-    if ((0, util_1.isNumber)(value)) {
-        if (!Number.isInteger(value) || value > Number.MAX_SAFE_INTEGER || value < Number.MIN_SAFE_INTEGER) {
-            throw new Error('Number needs to be an integer <= Number.MAX_SAFE_INTEGER, i.e. 2 ^ 53 - 1');
-        }
-        return value;
-    }
-    else if ((0, util_1.isString)(value)) {
-        if ((0, util_1.isHex)(value, -1, true)) {
-            return (0, util_1.hexToBn)(value, { isLe: false, isNegative }).toString();
-        }
-        if (value.includes('.') || value.includes(',') || value.includes('e')) {
-            throw new Error('String should not contain decimal points or scientific notation');
-        }
-        return value;
-    }
-    else if ((0, util_1.isBn)(value) || (0, util_1.isBigInt)(value)) {
-        return value.toString();
-    }
-    else if ((0, util_1.isObject)(value)) {
-        if (isToBn(value)) {
-            return value.toBn().toString();
-        }
-        // Allow the construction from an object with a single top-level key. This means that
-        // single key objects can be treated equivalently to numbers, assuming they meet the
-        // specific requirements. (This is useful in Weights 1.5 where Objects are compact)
-        const keys = Object.keys(value);
-        if (keys.length !== 1) {
-            throw new Error('Unable to construct number from multi-key object');
-        }
-        return decodeAbstractInt(value[keys[0]], isNegative);
-    }
-    else if (!value) {
-        return 0;
-    }
-    throw new Error(`Unable to create BN from unknown type ${typeof value}`);
-}
-/**
- * @name AbstractInt
- * @ignore
- * @noInheritDoc
- */
-class AbstractInt extends util_1.BN {
-    registry;
-    encodedLength;
-    isUnsigned;
-    createdAtHash;
-    initialU8aLength;
-    isStorageFallback;
-    #bitLength;
-    constructor(registry, value = 0, bitLength = exports.DEFAULT_UINT_BITS, isSigned = false) {
-        // Construct via a string/number, which will be passed in the BN constructor.
-        // It would be ideal to actually return a BN, but there is an issue:
-        // https://github.com/indutny/bn.js/issues/206
-        super(
-        // shortcut isU8a as used in SCALE decoding
-        (0, util_1.isU8a)(value)
-            ? bitLength <= 48
-                ? (0, util_1.u8aToNumber)(value.subarray(0, bitLength / 8), { isNegative: isSigned })
-                : (0, util_1.u8aToBn)(value.subarray(0, bitLength / 8), { isLe: true, isNegative: isSigned }).toString()
-            : decodeAbstractInt(value, isSigned));
-        this.registry = registry;
-        this.#bitLength = bitLength;
-        this.encodedLength = this.#bitLength / 8;
-        this.initialU8aLength = this.#bitLength / 8;
-        this.isUnsigned = !isSigned;
-        const isNegative = this.isNeg();
-        const maxBits = bitLength - (isSigned && !isNegative ? 1 : 0);
-        if (isNegative && !isSigned) {
-            throw new Error(`${this.toRawType()}: Negative number passed to unsigned type`);
-        }
-        else if (super.bitLength() > maxBits) {
-            throw new Error(`${this.toRawType()}: Input too large. Found input with ${super.bitLength()} bits, expected ${maxBits}`);
-        }
-    }
-    /**
-     * @description returns a hash of the contents
-     */
-    get hash() {
-        return this.registry.hash(this.toU8a());
-    }
-    /**
-     * @description Checks if the value is a zero value (align elsewhere)
-     */
-    get isEmpty() {
-        return this.isZero();
-    }
-    /**
-     * @description Returns the number of bits in the value
-     */
-    bitLength() {
-        return this.#bitLength;
-    }
-    /**
-     * @description Compares the value of the input to see if there is a match
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    eq(other) {
-        // Here we are actually overriding the built-in .eq to take care of both
-        // number and BN inputs (no `.eqn` needed) - numbers will be converted
-        return super.eq((0, util_1.isHex)(other)
-            ? (0, util_1.hexToBn)(other.toString(), { isLe: false, isNegative: !this.isUnsigned })
-            : (0, util_1.bnToBn)(other));
-    }
-    /**
-     * @description Returns a breakdown of the hex encoding for this Codec
-     */
-    inspect() {
-        return {
-            outer: [this.toU8a()]
-        };
-    }
-    /**
-     * @description True if this value is the max of the type
-     */
-    isMax() {
-        const u8a = this.toU8a().filter((b) => b === 0xff);
-        return u8a.length === (this.#bitLength / 8);
-    }
-    /**
-     * @description Returns a BigInt representation of the number
-     */
-    toBigInt() {
-        return BigInt(this.toString());
-    }
-    /**
-     * @description Returns the BN representation of the number. (Compatibility)
-     */
-    toBn() {
-        return this;
-    }
-    /**
-     * @description Returns a hex string representation of the value
-     */
-    toHex(isLe = false) {
-        // For display/JSON, this is BE, for compare, use isLe
-        return (0, util_1.bnToHex)(this, {
-            bitLength: this.bitLength(),
-            isLe,
-            isNegative: !this.isUnsigned
-        });
-    }
-    /**
-     * @description Converts the Object to to a human-friendly JSON, with additional fields, expansion and formatting of information
-     */
-    toHuman(_isExpanded) {
-        const rawType = this.toRawType();
-        if (rawType === 'Balance') {
-            return this.isMax()
-                ? 'everything'
-                // FIXME In the case of multiples we need some way of detecting which instance this belongs
-                // to. as it stands we will always format (incorrectly) against the first token defined
-                : (0, util_1.formatBalance)(this, { decimals: this.registry.chainDecimals[0], withSi: true, withUnit: this.registry.chainTokens[0] });
-        }
-        const [, divisor] = FORMATTERS.find(([type]) => type === rawType) || [];
-        return divisor
-            ? toPercentage(this, divisor)
-            : (0, util_1.formatNumber)(this);
-    }
-    /**
-     * @description Converts the Object to JSON, typically used for RPC transfers
-     */
-    toJSON(onlyHex = false) {
-        // FIXME this return type should by string | number, however BN returns string
-        // Options here are
-        //   - super.bitLength() - the actual used bits, use hex when close to MAX_SAFE_INTEGER
-        //   - this.#bitLength - the max used bits, use hex when larger than native Rust type
-        return onlyHex || (this.#bitLength > 128) || (super.bitLength() > MAX_NUMBER_BITS)
-            ? this.toHex()
-            : this.toNumber();
-    }
-    /**
-     * @description Returns the value in a primitive form, either number when <= 52 bits, or string otherwise
-     */
-    toPrimitive() {
-        return super.bitLength() > MAX_NUMBER_BITS
-            ? this.toString()
-            : this.toNumber();
-    }
-    /**
-     * @description Returns the base runtime type name for this instance
-     */
-    toRawType() {
-        // NOTE In the case of balances, which have a special meaning on the UI
-        // and can be interpreted differently, return a specific value for it so
-        // underlying it always matches (no matter which length it actually is)
-        return this instanceof this.registry.createClassUnsafe('Balance')
-            ? 'Balance'
-            : `${this.isUnsigned ? 'u' : 'i'}${this.bitLength()}`;
-    }
-    /**
-     * @description Returns the string representation of the value
-     * @param base The base to use for the conversion
-     */
-    toString(base) {
-        // only included here since we do not inherit docs
-        return super.toString(base);
-    }
-    /**
-     * @description Encodes the value as a Uint8Array as per the SCALE specifications
-     */
-    toU8a(_isBare) {
-        return (0, util_1.bnToU8a)(this, {
-            bitLength: this.bitLength(),
-            isLe: true,
-            isNegative: !this.isUnsigned
-        });
-    }
-}
-exports.AbstractInt = AbstractInt;